storyink 0.3.2 → 0.3.4

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # Changelog
 
+## 0.3.4
+
+- **Fix: → stopped before the next box was visible.** Step moves targeted the next step *start*,
+  and stories split a pulse and the reveal it causes into consecutive steps, so → stopped as the
+  dot arrived, before its target box appeared. → / ← now land on the next / previous **beat stop**:
+  a pulse and the reveal of its target are one beat, and the stop is where they (and the caption)
+  have settled. One definition, `beatGroups`, now drives step moves, stepped (reduced-motion)
+  playback, scrubber ticks and beat tiles. A reveal step that has its own caption now joins the
+  pulse whose target it reveals.
+  - Captions finish typing within their step (the last word no longer settles after the step ends).
+  - Step end times round up to the millisecond, so a stop is never a fraction of a millisecond
+    before its dot lands.
+- **Fix: sharp light-grey corners during animation.** The pulse trail and dot followed the route's
+  corner points (straight segments with sharp corners) instead of the rounded wire. Routes now use
+  `flattenPath(edge.d)`, the drawn curve sampled in core, in the HTML viewer and the SMIL animated
+  SVG. The draw-on dash length is the rounded wire's length, and multi-hop routes no longer cut the
+  corner of the next wire.
+- Core: `beatGroups`, `beatStops`, `beatChapters`, `beatTicks`, `flattenPath`.
+- `verify:viewer`: → from OpenWick beat stops ends with the dot's target box visible. Chrome is
+  always killed (exit, signals, uncaught errors, plus a watchdog if the runner is SIGKILLed; a
+  20 min cap), CDP calls time out after 30 s, and the run has a 15 min deadline.
+
+## 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-8fj4y3qd.js}

@@ -6,7 +6,7 @@ import {
   renderHtml,
   renderSvg,
   validate
-} from "./index-n3gf4fyb.js";
+} from "./index-a1ae1dgw.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");