storyink 0.3.2 → 0.3.3

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.3.3
+
+- **Fix: `snapshot --camera follow` wasn't deterministic on real diagrams** (`follow-deterministic`
+  failed on OpenWick's 24- and 18-node architecture/data-flow diagrams). The DOM, camera and
+  transform were identical across runs; what varied was Chrome's paint history. Some runs painted a
+  frame at the fit transform before the followed camera was placed, which changed the canvas
+  raster (anti-aliasing of some node boxes and text). With `#camera=follow&t=` the canvas now stays
+  hidden until the followed camera has painted. `follow-deterministic` now re-captures every
+  `at` frame, not only the first.
+- **Arrow keys animate step moves.** → plays forward to the next step boundary and pauses (while
+  playing: advance one step); ← rewinds backwards at 2× to the previous boundary with a short
+  bounce-free ease. Shift goes by chapter, repeated presses extend the target, and the opposite key
+  reverses. Space pauses a move, the follow camera follows it (backwards too), and reduced motion
+  still jumps.
+  - `window.__storyink.step(dir, chapter?)` animates the same way and returns a Promise;
+    `stepAnimated()` is the running move. `state()` reads the clock/mode without render lag.
+  - Core: `stepBoundary`, `stepMoveTarget`, `stepMoveSpeed`, `STEP_MOVE`.
+- `verify:viewer` drives → / ← / Shift / Space with real key events (CDP `Input.dispatchKeyEvent`).
+
 ## 0.3.2
 
 - **Fix: clicking the transport's play/pause did nothing** (space worked). The stage's native

package/README.md

@@ -123,7 +123,8 @@ Add a `story` to play a diagram as a sequence of beats in the HTML viewer:
 
 `"story": "auto"` (or `--story auto`) derives the beats from the graph or message order. Playback
 has a click-to-play gate, play/pause, a tape-rewind replay and a scrubber with step and chapter
-ticks. Space, ←/→ and R control it.
+ticks. Space, ←/→ and R control it: → plays to the next step and pauses, ← rewinds at 2× to the
+previous one (Shift: by chapter; repeated presses extend the move).
 
 Motion is **full by default, even when the reader's system asks for reduced motion**. Authors can
 set `"story": { "motion": "reduced" }` (always step by step) or `"motion": "system"` (follow

package/dist/chunks/{index-5qmjsg8w.js → index-wpcz893s.js}

@@ -6,7 +6,7 @@ import {
   renderHtml,
   renderSvg,
   validate
-} from "./index-n3gf4fyb.js";
+} from "./index-xmj21twd.js";
 
 // src/node/index.ts
 import fs3 from "node:fs";
@@ -339,10 +339,15 @@ async function snapshot(htmlPath, opts = {}) {
     const same = sha256(a1) === sha256(a2);
     gates.push({ name: "deterministic", pass: same, detail: same ? `${first.theme} at t=${midT} captured twice: identical` : `${first.theme} at t=${midT} differs between runs` });
     if (follow) {
-      const f2 = path2.join(tmpRoot, "follow-2.png");
-      await shoot(`theme=${first.theme}&chrome=0${tq(first.at ?? "end")}${mq}${cq}`, f2, FW, Math.round(FW * 0.5625));
-      const ok = sha256(f2) === first.sha256;
-      gates.push({ name: "follow-deterministic", pass: ok, detail: ok ? `camera=follow at t=${first.at} captured twice: identical` : `camera=follow at t=${first.at} differs between runs` });
+      const diff = [];
+      for (const c of captures.filter((x) => x.theme === first.theme)) {
+        const f2 = path2.join(tmpRoot, `follow-${diff.length}-${String(c.at)}.png`);
+        await shoot(`theme=${c.theme}&chrome=0${tq(c.at ?? "end")}${mq}${cq}`, f2, FW, Math.round(FW * 0.5625));
+        if (sha256(f2) !== c.sha256)
+          diff.push(String(c.at));
+      }
+      const at = captures.filter((x) => x.theme === first.theme).map((x) => x.at).join(",");
+      gates.push({ name: "follow-deterministic", pass: !diff.length, detail: !diff.length ? `camera=follow at t=${at} captured twice: identical` : `camera=follow at t=${diff.join(",")} differs between runs` });
     }
     if (tl) {
       const stat = path2.join(tmpRoot, "static.png");