IDE pictures in both themes and as SVG, a button bar on every figure, and the BETA 1005 re-check

.gitattributes

@@ -26,6 +26,10 @@ add-in/Resources/** -text
 bugs/** -text
 *.twinproj binary
 
+# The twinBASIC program in scripts/imagestrip/ is laid out as a reproducer is, and is
+# checked out byte for byte for the same reason: its .twinproj is packed from its src/.
+scripts/imagestrip/** -text
+
 # The VB6 template `bug_repro.mjs new --with-vb6` copies into a reproducer's vb6/
 # is CRLF in every checkout, as the bugs/** files it becomes are, and VB6 needs it.
 test/repro-templates/vb6/** -text

.github/actions/run-gates/action.yml

@@ -16,6 +16,28 @@ description: The gate steps both workflows share, checked against test.bat and c
 runs:
   using: composite
   steps:
+    # check_a11y runs FIRST. The deploy workflow backgrounds the book PDF
+    # render just before this composite action and joins it after, so the
+    # 24 non-a11y gates below mostly run in parallel with the book: they are
+    # Node scripts, CPU-bound, and the only two Chromium workloads (axe here
+    # and paged.js in the book render) overlap for just the ~40 s a11y
+    # takes, at the START of the run. a11y last would mean the two Chromiums
+    # fought over the runner's 2 vCPUs at the END, when the book render
+    # cannot amortise the slowdown.
+    #
+    # In check.bat, check_a11y now sits right after check_tree_fresh and
+    # before check_dot_fit / pick_a11y_sample --- the gate roster check
+    # requires check.bat's order to match the composite action's order after
+    # filtering to the gates both have.
+    #
+    # Matches check.bat: the build's own link check gates this, and a link
+    # failure short-circuits before the (slower) browser scan runs. Scans
+    # _site-offline/, whose relative asset paths actually resolve -- _site/
+    # uses root-absolute URLs that render unstyled here, making every
+    # colour-contrast result meaningless.
+    - name: Accessibility check (check_a11y.mjs)
+      shell: bash
+      run: node scripts/check_a11y.mjs
     # The build is the only pass over the site's HTML. This step is NOT a
     # second one: it runs the differential harness against a nine-file
     # synthetic tree that carries one fault of every kind, so
@@ -90,6 +112,21 @@ runs:
     - name: Unit-test the bug reproducers' pictures (test/png.test.mjs)
       shell: bash
       run: node --test test/png.test.mjs
+    # What an embedded image keeps (scripts/lib/compact-image.mjs's
+    # compactImage): an editor's metadata goes, and a notice of whose the
+    # picture is and on what terms stays, over images built in the test. The
+    # half that runs scripts/imagestrip/ needs its exe and Windows, which CI
+    # has not, and is skipped. No browser, no built tree, well under a second.
+    - name: Unit-test what an embedded image keeps (test/compact-image.test.mjs)
+      shell: bash
+      run: node --test test/compact-image.test.mjs
+    # An SVG screenshot is written on one line (scripts/svgshot/snapshot-svg.mjs's
+    # oneLine), so that a CRLF checkout changes only its last line ending. What
+    # it keeps of an image it embeds is test/compact-image.test.mjs's, above.
+    # No browser, no built tree, well under a second.
+    - name: Unit-test that SVG screenshots are one line (test/svgshot.test.mjs)
+      shell: bash
+      run: node --test test/svgshot.test.mjs
     # check_examples.mjs's probes: batching, crash isolation through a fake
     # lane, the canaries and the fence classifier. check_examples.mjs needs a
     # twinBASIC install, which CI has not; its probes need none.
@@ -258,11 +295,3 @@ runs:
     - name: Verify a11y sample coverage (pick_a11y_sample.mjs)
       shell: bash
       run: node scripts/pick_a11y_sample.mjs --check
-    # Matches check.bat: the build's own link check gates this, and a link
-    # failure short-circuits before the (slower) browser scan runs. Scans
-    # _site-offline/, whose relative asset paths actually resolve -- _site/
-    # uses root-absolute URLs that render unstyled here, making every
-    # colour-contrast result meaningless.
-    - name: Accessibility check (check_a11y.mjs)
-      shell: bash
-      run: node scripts/check_a11y.mjs

.github/workflows/checks.yml

@@ -106,7 +106,11 @@ jobs:
       # The gates both workflows run, in one list: see
       # .github/actions/run-gates/action.yml, which check_ci_workflows.mjs
       # checks against test.bat and check.bat. Each gate is its own group in
-      # this step's log.
+      # this step's log. check_a11y.mjs is the FIRST step inside the
+      # composite action -- the deploy workflow backgrounds the book PDF
+      # render just before it, and a11y running first means the two Chromium
+      # workloads overlap for ~40 s at the start instead of fighting at the
+      # end over the book's PDF-generation phase.
       - name: Run the gates
         uses: ./.github/actions/run-gates
       # The action's first step compares the standalone link checker's two

.github/workflows/tbdocs-gh-pages.yml

@@ -98,19 +98,78 @@ jobs:
         # offers. Never pass --no-help-archive here: the download would lose
         # the archive (check_ci_workflows.mjs refuses the flag).
         run: node builder/tbdocs.mjs --src docs --url '${{ steps.pages.outputs.origin }}' --baseurl '${{ steps.pages.outputs.base_path }}' --no-fetch-assets --check-audit-index
+      # The book PDF render runs in parallel with the gates. This step starts
+      # it in the background and returns as soon as the process is up, so the
+      # gates begin immediately; the "Wait for the book PDF render" step
+      # below joins the backgrounded process, prints its captured output,
+      # and exits with its code. On the deploy workflow this saves ~90 s
+      # against the previous sequential layout (the book render takes about
+      # as long as the gates). checks.yml is unaffected -- it has no PDF to
+      # render -- and the gates' composite-action rendering stays as it was.
+      #
+      # nohup makes the child ignore SIGHUP and redirected stdio decouples
+      # it from this step's shell; together they keep the child alive after
+      # the shell exits -- the runner reparents it and leaves it running
+      # until the join step reads /tmp/book-render.log and
+      # /tmp/book-render.exit.
+      #
+      # No `setsid`: when bash backgrounds `setsid cmd`, the backgrounded
+      # setsid is a process-group leader and forks, the parent exits, and
+      # the real command runs under the child's PID -- so `$!` captures a
+      # dead PID and the join step's `kill -0` returns false in ~0 s,
+      # usually before the render has finished. nohup does not fork; `$!`
+      # captures the real PID, which stays live until the render completes.
+      - name: Start the book PDF render in the background
+        working-directory: ./docs
+        run: |
+          mkdir -p _pdf
+          nohup bash -c '
+            node ../book/render-book.mjs _site-pdf/book.html -o "_pdf/twinBASIC Book.pdf" --outline-tags h1,h2,h3,h4 --additional-script ../perf/detach-pages.js
+            echo $? > /tmp/book-render.exit
+          ' >/tmp/book-render.log 2>&1 </dev/null &
+          BOOK_PID=$!
+          echo "$BOOK_PID" > /tmp/book-render.pid
+          echo "started book render as PID $BOOK_PID"
       # The gates both workflows run, in one list: see
       # .github/actions/run-gates/action.yml, which check_ci_workflows.mjs
       # checks against test.bat and check.bat. checks.yml runs only on pull
       # requests, so this is the one place a change pushed straight to
       # `staging`, or a manual dispatch, meets them. Each gate is its own
-      # group in this step's log.
+      # step in the composite action's rendering, with its own duration.
+      #
+      # check_a11y.mjs is the FIRST step of the composite action, so its
+      # Chromium work overlaps with the backgrounded book render's early
+      # Chromium-heavy phase for ~40 s. The 24 Node gates below it are
+      # CPU-bound, so they run through the rest of the book render without
+      # Chromium contention.
       - name: Run the gates
         uses: ./.github/actions/run-gates
-      - name: Render book PDF
+      # Join the backgrounded book render, print its output, and exit with
+      # its code. This step's own duration shows how much the book overlapped
+      # with the gates: 0 s if the book finished during them, or
+      # book_time - gates_time if the gates finished first. The 15-minute
+      # step timeout is a backstop against a wedged render; a missing PID
+      # or exit file aborts rather than hanging.
+      - name: Wait for the book PDF render
+        timeout-minutes: 15
         run: |
-          mkdir -p _pdf
-          node ../book/render-book.mjs _site-pdf/book.html -o "_pdf/twinBASIC Book.pdf" --outline-tags h1,h2,h3,h4 --additional-script ../perf/detach-pages.js
-        working-directory: ./docs
+          if [ ! -f /tmp/book-render.pid ]; then
+            echo "::error::no PID file; the start step did not run"
+            exit 2
+          fi
+          BOOK_PID=$(cat /tmp/book-render.pid)
+          echo "waiting for book render PID $BOOK_PID"
+          while kill -0 "$BOOK_PID" 2>/dev/null; do
+            sleep 2
+          done
+          cat /tmp/book-render.log
+          if [ ! -f /tmp/book-render.exit ]; then
+            echo "::error::the book render process ended without writing its exit status"
+            exit 1
+          fi
+          BOOK_EXIT=$(cat /tmp/book-render.exit)
+          echo "book render exit code: $BOOK_EXIT"
+          exit "$BOOK_EXIT"
       - name: Upload Pages artifact
         uses: actions/upload-pages-artifact@v5
         with:

.gitignore

@@ -36,3 +36,10 @@ indexer/.packages/
 # A bug reproducer's zip is only for attaching to its GitHub issue (see
 # BUGS-TO-REPORT.md); the .twinproj beside it is committed.
 /bugs/**/*.zip
+
+# The IDE builds scripts/imagestrip/imagestrip.twinproj into Build\ beside it.
+/scripts/imagestrip/Build/
+
+# shoot_docs.mjs --svg: each picture's bundle (scripts/svgshot/bundle.mjs), what its SVG
+# is drawn from, for scripts/svgshot/replay.mjs. Bundles hold the Windows user name.
+/.svgshot-bundles/