storyink 0.3.2 → 0.3.4

package/dist/core/index.js

@@ -10,12 +10,17 @@ import {
   MESSAGE_KINDS,
   PARTICIPANT_KINDS,
   STEP_BEAT,
+  STEP_MOVE,
   STORY_MOTIONS,
   StoryinkError,
   VERSION,
   animatedHeaderHeight,
   animatedSvg,
   autoStory,
+  beatChapters,
+  beatGroups,
+  beatStops,
+  beatTicks,
   beatTimes,
   cameraAt,
   cameraAtEnd,
@@ -30,6 +35,7 @@ import {
   exports_tokens,
   fitCamera,
   fitIsReadable,
+  flattenPath,
   followStep,
   fontCss,
   formatDiagnostic,
@@ -50,7 +56,10 @@ import {
   simplify,
   simplifyError,
   stepAt,
+  stepBoundary,
   stepFocus,
+  stepMoveSpeed,
+  stepMoveTarget,
   steppedIndex,
   steppedSchedule,
   steppedStop,
@@ -62,7 +71,7 @@ import {
   validate,
   wirePath,
   wrap
-} from "../chunks/index-n3gf4fyb.js";
+} from "../chunks/index-a1ae1dgw.js";
 export {
   ARROWS,
   CAMERA,
@@ -74,12 +83,17 @@ export {
   MESSAGE_KINDS,
   PARTICIPANT_KINDS,
   STEP_BEAT,
+  STEP_MOVE,
   STORY_MOTIONS,
   StoryinkError,
   VERSION,
   animatedHeaderHeight,
   animatedSvg,
   autoStory,
+  beatChapters,
+  beatGroups,
+  beatStops,
+  beatTicks,
   beatTimes,
   cameraAt,
   cameraAtEnd,
@@ -93,6 +107,7 @@ export {
   elbowPathV,
   fitCamera,
   fitIsReadable,
+  flattenPath,
   followStep,
   fontCss,
   formatDiagnostic,
@@ -113,7 +128,10 @@ export {
   simplify,
   simplifyError,
   stepAt,
+  stepBoundary,
   stepFocus,
+  stepMoveSpeed,
+  stepMoveTarget,
   steppedIndex,
   steppedSchedule,
   steppedStop,

package/dist/index.js

@@ -8,7 +8,7 @@ import {
   snapshot,
   writeAnimatedSvg,
   writeDiagram
-} from "./chunks/index-5qmjsg8w.js";
+} from "./chunks/index-8fj4y3qd.js";
 import {
   ARROWS,
   CAMERA,
@@ -20,12 +20,17 @@ import {
   MESSAGE_KINDS,
   PARTICIPANT_KINDS,
   STEP_BEAT,
+  STEP_MOVE,
   STORY_MOTIONS,
   StoryinkError,
   VERSION,
   animatedHeaderHeight,
   animatedSvg,
   autoStory,
+  beatChapters,
+  beatGroups,
+  beatStops,
+  beatTicks,
   beatTimes,
   cameraAt,
   cameraAtEnd,
@@ -40,6 +45,7 @@ import {
   exports_tokens,
   fitCamera,
   fitIsReadable,
+  flattenPath,
   followStep,
   fontCss,
   formatDiagnostic,
@@ -60,7 +66,10 @@ import {
   simplify,
   simplifyError,
   stepAt,
+  stepBoundary,
   stepFocus,
+  stepMoveSpeed,
+  stepMoveTarget,
   steppedIndex,
   steppedSchedule,
   steppedStop,
@@ -72,7 +81,7 @@ import {
   validate,
   wirePath,
   wrap
-} from "./chunks/index-n3gf4fyb.js";
+} from "./chunks/index-a1ae1dgw.js";
 // src/plugin.ts
 import fs2 from "node:fs";
 import path2 from "node:path";
@@ -373,12 +382,17 @@ export {
   PARTICIPANT_KINDS,
   PLUGIN_ID,
   STEP_BEAT,
+  STEP_MOVE,
   STORY_MOTIONS,
   StoryinkError,
   VERSION,
   animatedHeaderHeight,
   animatedSvg,
   autoStory,
+  beatChapters,
+  beatGroups,
+  beatStops,
+  beatTicks,
   beatTimes,
   cameraAt,
   cameraAtEnd,
@@ -394,6 +408,7 @@ export {
   findBrowser,
   fitCamera,
   fitIsReadable,
+  flattenPath,
   followStep,
   fontCss,
   formatDiagnostic,
@@ -417,7 +432,10 @@ export {
   simplifyError,
   snapshot,
   stepAt,
+  stepBoundary,
   stepFocus,
+  stepMoveSpeed,
+  stepMoveTarget,
   steppedIndex,
   steppedSchedule,
   steppedStop,

package/dist/node/index.js

@@ -10,8 +10,8 @@ import {
   snapshot,
   writeAnimatedSvg,
   writeDiagram
-} from "../chunks/index-5qmjsg8w.js";
-import"../chunks/index-n3gf4fyb.js";
+} from "../chunks/index-8fj4y3qd.js";
+import"../chunks/index-a1ae1dgw.js";
 export {
   browserVersion,
   findBrowser,

package/dist/types/core/index.d.ts

@@ -5,12 +5,12 @@ export * from "./spec.js";
 export type * from "./scene.js";
 export { validate, formatDiagnostic, type Diagnostic, type Severity, type ValidationResult } from "./validate.js";
 export { fromMermaid, detectMermaid, type MermaidResult, type MermaidFamily } from "./mermaid/index.js";
-export { layout, elbowPath, elbowPathV, roundedPolyline, wirePath, textWidth, wrap } from "./layout/index.js";
+export { layout, elbowPath, elbowPathV, flattenPath, roundedPolyline, wirePath, textWidth, wrap } from "./layout/index.js";
 export { renderSvg, renderHtml, toScene, fontCss, StoryinkError, type SvgOptions, type HtmlOptions } from "./render/index.js";
 export { parseHash, type HashParams } from "./render/App.js";
 export * as tokens from "../theme/tokens.js";
 export { VERSION } from "../generated/meta.js";
-export { storyState, restFrame, beatTimes, counterValue, steppedSchedule, steppedIndex, steppedStop, steppedTime, STEP_BEAT, type StateOptions, type SteppedStop } from "./story/state.js";
+export { storyState, restFrame, beatTimes, counterValue, steppedSchedule, steppedIndex, steppedStop, steppedTime, STEP_BEAT, STEP_MOVE, stepBoundary, stepMoveTarget, stepMoveSpeed, beatGroups, beatStops, beatChapters, beatTicks, type StateOptions, type SteppedStop } from "./story/state.js";
 export { CAMERA, cameraAt, cameraAtEnd, centreOn, clampCamera, deadZoneRect, fitCamera, fitIsReadable, followStep, inView, readableScale, stepAt, stepFocus, toScreen, type Camera, type Viewport } from "./story/camera.js";
 export { compileStory, resolveEdge, readTime, type CompileResult } from "./story/compile.js";
 export { autoStory } from "./story/auto.js";

package/dist/types/core/layout/index.d.ts

@@ -5,5 +5,5 @@ import { layoutSequence } from "./sequence.js";
 /** Pure, deterministic layout of a validated spec into absolute geometry. */
 export declare function layout(spec: Spec): Scene;
 export { layoutGraph, layoutSequence };
-export { elbowPath, elbowPathV, roundedPolyline, wirePath } from "./paths.js";
+export { elbowPath, elbowPathV, flattenPath, roundedPolyline, wirePath } from "./paths.js";
 export { textWidth, wrap } from "./measure.js";

package/dist/types/core/layout/paths.d.ts

@@ -19,3 +19,10 @@ export declare function dedupe(points: Pt[]): Pt[];
  * (radius 18); everything else the rounded polyline (radius 12).
  */
 export declare function wirePath(points: Pt[], elbowRadius: number, cornerRadius: number): string;
+/**
+ * Flatten a wire path (absolute `M L H V Q`, as the builders above emit) into a dense polyline
+ * that follows the drawn curve: each quadratic corner is sampled so the chord error stays well
+ * under 0.1 px. Pulse routes, trails and draw-on lengths use this, so everything animated along a
+ * wire lies on the same rounded geometry as the wire itself.
+ */
+export declare function flattenPath(d: string): Pt[];

package/dist/types/core/render/Story.d.ts

@@ -15,7 +15,19 @@ export interface StoryControls {
     toggle: () => void;
     seek: (t: number) => void;
     replay: () => void;
-    step: (dir: 1 | -1, chapters?: boolean) => void;
+    /**
+     * → / ←: full motion plays forward (1×) or backward (2×) to the next / previous step (or chapter)
+     * boundary and pauses; resolves when the move ends or is interrupted. Reduced motion jumps.
+     */
+    step: (dir: 1 | -1, chapters?: boolean) => Promise<void>;
+    /** The clock and mode now (the rendered `t` / `mode` can lag by a frame). */
+    now: () => number;
+    modeNow: () => Mode;
+    /** The running step move, if any. */
+    moving: () => {
+        dir: 1 | -1;
+        target: number;
+    } | null;
     ungate: () => void;
     /** Render synchronously at another time (for exporting a specific frame). */
     frameAt: (t: number) => Frame;

package/dist/types/core/story/state.d.ts

@@ -20,6 +20,15 @@ export declare function counterValue(c: Timeline["counters"][string], t: number,
  * for scrubbing, snapshots and beat sheets.
  */
 export declare function storyState(scene: Scene, tl: Timeline | undefined, t: number, opts?: StateOptions): Frame;
+/**
+ * The story's **beats**: consecutive step indices that read as one change. A step joins the next
+ * when the next starts with it (same `t0`), or is chained straight on ("+0", within 50 ms of this
+ * step's end) and either adds no chapter `stop` or caption of its own, or (without a `stop`)
+ * reveals the box this step's pulse arrives at. So a pulse and the reveal of its
+ * target are always one beat. One definition for step moves (→ / ←), stepped (reduced) playback,
+ * scrubber ticks and beat tiles (tiles may merge further to fit `MAX_BEATS`).
+ */
+export declare function beatGroups(tl: Timeline): number[][];
 /** Time of a beat tile: after the step lands, before the next one moves. */
 export interface Beat {
     id: string;
@@ -66,3 +75,39 @@ export declare function steppedStop(tl: Timeline, t: number): number;
  * Before the first step: 0. At or after the end: the duration (final frame).
  */
 export declare function steppedTime(tl: Timeline, t: number): number;
+/** Animated step moves (→ / ←): backward speed (story seconds per second) and the reverse ease (s). */
+export declare const STEP_MOVE: {
+    readonly back: 2;
+    readonly ease: 0.12;
+    readonly minSpeed: 0.3;
+};
+/** The next boundary strictly past `from` in direction `dir` (0 and `duration` are the ends). */
+export declare function stepBoundary(list: number[], from: number, dir: 1 | -1, duration: number): number;
+/**
+ * Target of an animated step move. A press in the direction of a running move extends it to the
+ * following boundary; otherwise (no move, or the opposite direction) it heads to the boundary
+ * adjacent to `now`.
+ */
+export declare function stepMoveTarget(list: number[], now: number, dir: 1 | -1, duration: number, current?: {
+    dir: 1 | -1;
+    target: number;
+}): number;
+/**
+ * Speed of a move at a moment: forward plays at 1×; backward at `STEP_MOVE.back`× with a short
+ * bounce-free ease in and out (never below `minSpeed` of full so it always arrives).
+ */
+export declare function stepMoveSpeed(dir: 1 | -1, elapsed: number, remaining: number): number;
+/**
+ * Step-move boundaries: every beat's settled stop time, then the end. → / ← land on these, so a
+ * move includes a pulse and the reveal, highlight, counter and caption it causes.
+ */
+export declare function beatStops(tl: Timeline): number[];
+/** Chapter boundaries (Shift+→ / ←): the settled stop of each beat holding a `stop`, and the end. */
+export declare function beatChapters(tl: Timeline): number[];
+/** Scrubber ticks: one per beat at its first step's start, labelled with its chapter stop if any. */
+export declare function beatTicks(tl: Timeline): {
+    id: string;
+    t: number;
+    label: string;
+    stop?: string;
+}[];

package/dist/types/generated/meta.d.ts

@@ -1 +1 @@
-export declare const VERSION = "0.3.2";
+export declare const VERSION = "0.3.4";