storyink 0.3.2 → 0.3.3

package/dist/core/index.js

@@ -10,6 +10,7 @@ import {
   MESSAGE_KINDS,
   PARTICIPANT_KINDS,
   STEP_BEAT,
+  STEP_MOVE,
   STORY_MOTIONS,
   StoryinkError,
   VERSION,
@@ -50,7 +51,10 @@ import {
   simplify,
   simplifyError,
   stepAt,
+  stepBoundary,
   stepFocus,
+  stepMoveSpeed,
+  stepMoveTarget,
   steppedIndex,
   steppedSchedule,
   steppedStop,
@@ -62,7 +66,7 @@ import {
   validate,
   wirePath,
   wrap
-} from "../chunks/index-n3gf4fyb.js";
+} from "../chunks/index-xmj21twd.js";
 export {
   ARROWS,
   CAMERA,
@@ -74,6 +78,7 @@ export {
   MESSAGE_KINDS,
   PARTICIPANT_KINDS,
   STEP_BEAT,
+  STEP_MOVE,
   STORY_MOTIONS,
   StoryinkError,
   VERSION,
@@ -113,7 +118,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-wpcz893s.js";
 import {
   ARROWS,
   CAMERA,
@@ -20,6 +20,7 @@ import {
   MESSAGE_KINDS,
   PARTICIPANT_KINDS,
   STEP_BEAT,
+  STEP_MOVE,
   STORY_MOTIONS,
   StoryinkError,
   VERSION,
@@ -60,7 +61,10 @@ import {
   simplify,
   simplifyError,
   stepAt,
+  stepBoundary,
   stepFocus,
+  stepMoveSpeed,
+  stepMoveTarget,
   steppedIndex,
   steppedSchedule,
   steppedStop,
@@ -72,7 +76,7 @@ import {
   validate,
   wirePath,
   wrap
-} from "./chunks/index-n3gf4fyb.js";
+} from "./chunks/index-xmj21twd.js";
 // src/plugin.ts
 import fs2 from "node:fs";
 import path2 from "node:path";
@@ -373,6 +377,7 @@ export {
   PARTICIPANT_KINDS,
   PLUGIN_ID,
   STEP_BEAT,
+  STEP_MOVE,
   STORY_MOTIONS,
   StoryinkError,
   VERSION,
@@ -417,7 +422,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-wpcz893s.js";
+import"../chunks/index-xmj21twd.js";
 export {
   browserVersion,
   findBrowser,

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

@@ -10,7 +10,7 @@ export { renderSvg, renderHtml, toScene, fontCss, StoryinkError, type SvgOptions
 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, 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/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

@@ -66,3 +66,25 @@ 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;

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

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