storyink 0.3.4 → 0.3.6

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## 0.3.6
+
+- **Default `story.pace` is 0.6** (was 1): shorter reading holds after each beat. `pace: 1` gives
+  the 0.3.5 holds, `pace: 0` the pre-0.3.5 timing. Applies to the viewer, `render` (and
+  `--pace`), the plugin and animated SVGs (built with their pace). Durations: OpenWick
+  architecture 176 s → 135 s, data flow 95 s → 78 s, checkout 30 s → 26 s, OAuth 57 s → 47 s.
+- **Pauses in the viewer**, changeable after the build: a toolbar button (`Pauses: Normal`)
+  cycles None (0) · Short (0.3) · Normal (0.6) · Long (1.0) · Longer (1.5); `[` / `]` step down /
+  up; the choice is remembered (`localStorage["storyink-pace"]`); `#pace=<n>` wins. The HTML
+  embeds a small `timeline.source` and the viewer recompiles the timeline in the browser with the
+  same compiler (`recompilePace`, byte-identical to `render --pace`). The reader keeps their place
+  (same beat, same progress; `mapStoryTime`) and playback continues; duration, ticks, → / ← stops,
+  stepped holds and the follow camera follow the new timeline. Page contract: `pace()`,
+  `setPace(n)`. Viewer bundle +16.5 KiB (388.5 → 405.0 KiB).
+- `storyink snapshot --pace N` (tool `storyink_snapshot` `pace`) pins the pace for every capture;
+  by default snapshots use the author pace.
+- **→ / ← no longer wait for the text.** Step moves animate the graph only: → plays to the end
+  of the next beat's graph motion (pulses arrived, reveals and draw-ons done; not caption typing,
+  glows, trail cooling, rings or the reading hold; `beatMotionEnds`) and pauses; pressed during a
+  reading hold (or right after a stop) it starts the next beat at once. ← rewinds the graph at 2×
+  to the previous beat's motion end. The beat's caption shows whole and instantly as the move
+  starts (← shows the target beat's) and stays at the stop (`storyState(…, { captionBeat })`).
+  Continuous play, stepped playback, the scrubber and the default `storyState` are unchanged.
+- Stepped (reduced-motion) stops last at least 0.8 s (the bare-beat hold).
+- Fix: clicking a toolbar button while the play gate showed also started the story.
+
+## 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*,

package/README.md

@@ -126,6 +126,13 @@ 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. The default `pace` is 0.6; set `"story": { "pace": 1.5 }` (or `--pace`) to slow it,
+`0` for none, or `"hold": 3` on a step for its beat. Readers change it on the page with
+**Pauses** in the toolbar (None · Short · Normal · Long · Longer, `[` / `]`, remembered;
+`#pace=` in the URL); the viewer recompiles the timeline in the browser and keeps their place.
+
 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