storyink 0.3.3 → 0.3.5

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # Changelog
 
+## 0.3.5
+
+- **Fix: the diagram showed a hover tooltip** (the diagram title) wherever the cursor rested. The
+  SVG carried a `<title>`, which browsers show as a tooltip. It's gone from the viewer, static
+  `.svg` exports and the animated SVG; the accessible name stays as `role="img"` +
+  `aria-label` on the root. Toolbar and transport hints are unchanged.
+- **Reading holds.** Continuous playback now pauses after each beat so the reader can read it:
+  1 s + 0.3 s per word of the beat's caption, clamped to 1.5–6 s, or 0.8 s without a caption,
+  counted from when the beat is visually still (nothing changes during it; the caption stays up).
+  The animation speed is unchanged. Compiled into the timeline, so the viewer, scrubber, beat
+  sheets, snapshots and the animated SVG agree. Stepped (reduced-motion) playback holds each stop
+  for the same number; → / ← still stop at the settled beat without waiting.
+  - `story.pace` (multiplier, default 1; `0` = the 0.3.4 timing) and a per-step `hold` (seconds,
+    for the beat it ends); `render --pace`, tool `storyink_render` `pace`; core `readingHold`,
+    `compileStoryAuthored`.
+  - An absolute `at` is now a *minimum* start; relative `"+x"` steps shift.
+  - Stories run longer: OpenWick architecture 55 s → 176 s, data flow 29 s → 95 s, checkout
+    13 s → 30 s, OAuth 17 s → 57 s. The 60 s length warning counts the authored timing only.
+
+## 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`

package/README.md

@@ -126,6 +126,11 @@ has a click-to-play gate, play/pause, a tape-rewind replay and a scrubber with s
 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).
 
+Playback **pauses to read after each beat**: about 1 s + 0.3 s per word of its caption (1.5–6 s;
+0.8 s without one) once the beat is still, before the next beat starts. The animation speed is
+unchanged. Set `"story": { "pace": 1.5 }` (or `--pace`) to slow it further, `0` for none, or
+`"hold": 3` on a step for its beat.
+
 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
 `prefers-reduced-motion`); `--motion full|reduced|system` on `render` does the same, including