@flyingrobots/bijou-tui 7.2.0 → 8.0.0-rc.1

package/dist/timeline-runtime.js

@@ -0,0 +1,63 @@
+import { stepTimelineTrack } from './timeline-track-step.js';
+import { must } from './timeline-utils.js';
+export function createTimelineRuntime(tracks, callbacks) {
+    const trackNames = tracks.map((track) => track.name);
+    return {
+        trackNames,
+        estimatedDurationMs: tracks.reduce((maximum, track) => Math.max(maximum, track.startMs + track.estimatedDurationMs), 0),
+        init() {
+            return initialTimelineState(tracks);
+        },
+        step(state, dt) {
+            return stepTimelineState(tracks, state, dt);
+        },
+        values(state) {
+            return timelineValues(trackNames, state);
+        },
+        done(state) {
+            return trackNames.every((name) => must(state.tracks[name], `track "${name}" state`).done);
+        },
+        firedCallbacks(previous, next) {
+            return firedTimelineCallbacks(callbacks, previous, next);
+        },
+    };
+}
+function initialTimelineState(tracks) {
+    const states = {};
+    for (const track of tracks) {
+        states[track.name] = {
+            type: track.trackType,
+            started: false,
+            currentValue: track.from,
+            done: false,
+        };
+    }
+    return { elapsedMs: 0, tracks: states };
+}
+function stepTimelineState(tracks, state, dt) {
+    if (!Number.isFinite(dt) || dt < 0) {
+        throw new Error(`Timeline: dt must be a finite non-negative number, got ${String(dt)}`);
+    }
+    const elapsedMs = state.elapsedMs + dt * 1000;
+    const states = {};
+    for (const track of tracks) {
+        states[track.name] = stepTimelineTrack(track, must(state.tracks[track.name], `track "${track.name}" state`), elapsedMs, dt);
+    }
+    return { elapsedMs, tracks: states };
+}
+function timelineValues(trackNames, state) {
+    const values = {};
+    for (const name of trackNames) {
+        values[name] = must(state.tracks[name], `track "${name}" state`).currentValue;
+    }
+    return values;
+}
+function firedTimelineCallbacks(callbacks, previous, next) {
+    return callbacks
+        .filter((callback) => callback.atMs === 0
+        ? previous.elapsedMs === 0 && next.elapsedMs > 0
+        : previous.elapsedMs < callback.atMs
+            && next.elapsedMs >= callback.atMs)
+        .map((callback) => callback.name);
+}
+//# sourceMappingURL=timeline-runtime.js.map

package/dist/timeline-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-runtime.js","sourceRoot":"","sources":["../src/timeline-runtime.ts"],"names":[],"mappings":"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"}

package/dist/timeline-track-step.d.ts

@@ -0,0 +1,3 @@
+import type { ResolvedTrack, TrackState } from './timeline-contract.js';
+export declare function stepTimelineTrack(track: ResolvedTrack, previous: TrackState, elapsedMs: number, dt: number): TrackState;
+//# sourceMappingURL=timeline-track-step.d.ts.map

package/dist/timeline-track-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-track-step.d.ts","sourceRoot":"","sources":["../src/timeline-track-step.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACX,MAAM,wBAAwB,CAAC;AAGhC,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,UAAU,EACpB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,GACT,UAAU,CAOZ"}

package/dist/timeline-track-step.js

@@ -0,0 +1,58 @@
+import { createSpringState, createTweenState, resolveTweenConfig, springStep, tweenStep, } from './spring.js';
+import { must } from './timeline-utils.js';
+export function stepTimelineTrack(track, previous, elapsedMs, dt) {
+    if (elapsedMs < track.startMs || previous.done)
+        return previous;
+    if (!previous.started) {
+        const activeMs = Math.min(elapsedMs - track.startMs, dt * 1000);
+        return startTrack(track, activeMs / 1000);
+    }
+    return continueTrack(track, previous, dt);
+}
+function startTrack(track, dt) {
+    if (track.trackType === 'spring') {
+        const stepped = springStep(createSpringState(track.from), track.to, must(track.springConfig, `spring config for track "${track.name}"`), dt);
+        return {
+            type: 'spring',
+            started: true,
+            spring: stepped,
+            currentValue: stepped.value,
+            done: stepped.done,
+        };
+    }
+    const stepped = tweenStep(createTweenState(track.from), tweenConfig(track), dt * 1000);
+    return {
+        type: 'tween',
+        started: true,
+        tween: stepped,
+        currentValue: stepped.value,
+        done: stepped.done,
+    };
+}
+function continueTrack(track, previous, dt) {
+    if (track.trackType === 'spring') {
+        const stepped = springStep(must(previous.spring, `spring state for track "${track.name}"`), track.to, must(track.springConfig, `spring config for track "${track.name}"`), dt);
+        return {
+            ...previous,
+            spring: stepped,
+            currentValue: stepped.value,
+            done: stepped.done,
+        };
+    }
+    const stepped = tweenStep(must(previous.tween, `tween state for track "${track.name}"`), tweenConfig(track), dt * 1000);
+    return {
+        ...previous,
+        tween: stepped,
+        currentValue: stepped.value,
+        done: stepped.done,
+    };
+}
+function tweenConfig(track) {
+    return resolveTweenConfig({
+        from: track.from,
+        to: track.to,
+        duration: must(track.tweenDuration, `tween duration for track "${track.name}"`),
+        ease: track.tweenEase,
+    });
+}
+//# sourceMappingURL=timeline-track-step.js.map

package/dist/timeline-track-step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-track-step.js","sourceRoot":"","sources":["../src/timeline-track-step.ts"],"names":[],"mappings":"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"}

package/dist/timeline-utils.d.ts

@@ -0,0 +1,2 @@
+export declare function must<T>(value: T | undefined, what?: string): T;
+//# sourceMappingURL=timeline-utils.d.ts.map

package/dist/timeline-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-utils.d.ts","sourceRoot":"","sources":["../src/timeline-utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,EAAE,IAAI,SAAU,GAAG,CAAC,CAG/D"}

package/dist/timeline-utils.js

@@ -0,0 +1,6 @@
+export function must(value, what = 'state') {
+    if (value === undefined)
+        throw new Error(`Timeline: missing ${what}`);
+    return value;
+}
+//# sourceMappingURL=timeline-utils.js.map

package/dist/timeline-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-utils.js","sourceRoot":"","sources":["../src/timeline-utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,IAAI,CAAI,KAAoB,EAAE,IAAI,GAAG,OAAO;IAC1D,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;IACtE,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/timeline.d.ts

@@ -1,190 +1,9 @@
 /**
- * GSAP-style Timeline — orchestrate multiple animations with position-based timing.
+ * Pure GSAP-style timeline state machine for position-based animation.
  *
- * The timeline is a **pure state machine**: build a timeline definition,
- * then step it forward in your TEA update function. No internal timers,
- * no mutation, fully testable.
- *
- * ```ts
- * const tl = timeline()
- *   .add('x',       { from: 0, to: 100, spring: 'wobbly' })
- *   .add('opacity', { type: 'tween', from: 0, to: 1, duration: 300 }, '<')
- *   .label('reveal')
- *   .add('y',       { from: 0, to: 50, spring: 'gentle' }, 'reveal')
- *   .call('onReveal', 'reveal+=100')
- *   .build();
- *
- * // TEA init:
- * const state = tl.init();
- *
- * // TEA update (on each animation frame):
- * const next = tl.step(state, 1/60);
- * const { x, opacity, y } = tl.values(next);
- * const fired = tl.firedCallbacks(state, next);
- * if (tl.done(next)) { ... }
- * ```
- */
-import { type SpringConfig, type SpringPreset, type SpringState, type EasingFn, type TweenState } from './spring.js';
-/** Position in the timeline — controls when a track/callback starts. */
-export type Position = number | '<' | `<+=${string}` | `+=${string}` | `-=${string}` | `>${string}` | (string & {});
-/** Spring track configuration. */
-export interface SpringTrackDef {
-    /** Animation type (defaults to `'spring'` when omitted). */
-    readonly type?: 'spring';
-    /** Starting value. */
-    readonly from: number;
-    /** Target value. */
-    readonly to: number;
-    /** Spring physics parameters or a named preset. */
-    readonly spring?: Partial<SpringConfig> | SpringPreset;
-}
-/** Tween track configuration. */
-export interface TweenTrackDef {
-    /** Animation type — must be `'tween'`. */
-    readonly type: 'tween';
-    /** Starting value. */
-    readonly from: number;
-    /** Target value. */
-    readonly to: number;
-    /** Duration in milliseconds. */
-    readonly duration: number;
-    /** Easing function (defaults to `easeOutCubic`). */
-    readonly ease?: EasingFn;
-}
-/** Discriminated union of spring and tween track definitions. */
-export type TrackDef = SpringTrackDef | TweenTrackDef;
-/** Opaque timeline state — pass between step() calls. */
-export interface TimelineState {
-    /** Elapsed time in milliseconds. */
-    readonly elapsedMs: number;
-    /** Per-track animation state. */
-    readonly tracks: Readonly<Record<string, TrackState>>;
-}
-/**
- * Per-track animation state stored inside `TimelineState`.
- * @internal
- */
-interface TrackState {
-    /** Animation engine type. */
-    readonly type: 'spring' | 'tween';
-    /** Whether the track has received its first step. */
-    readonly started: boolean;
-    /** Spring-specific simulation state (present when `type === 'spring'`). */
-    readonly spring?: SpringState;
-    /** Tween-specific simulation state (present when `type === 'tween'`). */
-    readonly tween?: TweenState;
-    /** Current interpolated value. */
-    readonly currentValue: number;
-    /** Whether the track has settled at its target. */
-    readonly done: boolean;
-}
-/** Fluent builder for constructing a timeline definition. */
-export interface TimelineBuilder {
-    /**
-     * Add an animation track.
-     *
-     * ```ts
-     * .add('x', { from: 0, to: 100, spring: 'wobbly' })
-     * .add('opacity', { type: 'tween', from: 0, to: 1, duration: 300 }, '<')
-     * ```
-     *
-     * @param name - Unique track identifier used to read values later.
-     * @param def - Spring or tween track definition.
-     * @param position - When the track starts (default: after previous item ends).
-     * @returns The builder for chaining.
-     * @throws Error (at build time) if a duplicate track name is added.
-     */
-    add(name: string, def: TrackDef, position?: Position): TimelineBuilder;
-    /**
-     * Add a named label at the current position (end of previous item).
-     *
-     * ```ts
-     * .label('reveal')
-     * .add('scale', { type: 'tween', from: 0, to: 1, duration: 200 }, 'reveal')
-     * ```
-     *
-     * @param name - Label identifier, referenced by later position specifiers.
-     * @returns The builder for chaining.
-     */
-    label(name: string): TimelineBuilder;
-    /**
-     * Add a named callback trigger at a position.
-     *
-     * ```ts
-     * .call('onHalfway', '+=500')
-     * ```
-     *
-     * @param name - Callback identifier returned by `firedCallbacks()`.
-     * @param position - When the callback fires (default: after previous item ends).
-     * @returns The builder for chaining.
-     */
-    call(name: string, position?: Position): TimelineBuilder;
-    /**
-     * Compile the timeline into an immutable Timeline object.
-     *
-     * @returns Compiled {@link Timeline} ready for stepping.
-     * @throws Error if a position references an unknown label or has invalid syntax.
-     */
-    build(): Timeline;
-}
-/** Compiled timeline — step forward, read values, check completion. */
-export interface Timeline {
-    /**
-     * Create the initial timeline state.
-     *
-     * @returns Fresh timeline state with all tracks at their starting values.
-     */
-    init(): TimelineState;
-    /**
-     * Advance the timeline by `dt` seconds.
-     * Returns a new state (pure — no mutation).
-     *
-     * @param state - Current timeline state.
-     * @param dt - Time step in seconds (e.g. 1/60 for 60 fps). Must be finite and non-negative.
-     * @returns Updated timeline state with all active tracks advanced.
-     * @throws Error if `dt` is negative, `NaN`, or infinite.
-     */
-    step(state: TimelineState, dt: number): TimelineState;
-    /**
-     * Read all current track values as a name-to-number record.
-     *
-     * @param state - Current timeline state.
-     * @returns Record mapping each track name to its current value.
-     */
-    values(state: TimelineState): Record<string, number>;
-    /**
-     * True when every track has settled.
-     *
-     * @param state - Current timeline state.
-     * @returns Whether all tracks have reached their target values.
-     */
-    done(state: TimelineState): boolean;
-    /**
-     * Return callback names that fired between `prev` and `next` states.
-     * A callback fires when the timeline's elapsed time crosses its trigger point.
-     *
-     * @param prev - Timeline state before the step.
-     * @param next - Timeline state after the step.
-     * @returns Array of callback names that fired during the interval.
-     */
-    firedCallbacks(prev: TimelineState, next: TimelineState): string[];
-    /** Total estimated duration in milliseconds. */
-    readonly estimatedDurationMs: number;
-    /** All track names in the timeline. */
-    readonly trackNames: readonly string[];
-}
-/**
- * Create a new timeline builder.
- *
- * ```ts
- * const tl = timeline()
- *   .add('x', { from: 0, to: 100, spring: 'wobbly' })
- *   .add('opacity', { type: 'tween', from: 0, to: 1, duration: 300 }, '<')
- *   .build();
- * ```
- *
- * @returns A new {@link TimelineBuilder} for fluent timeline construction.
+ * Build a definition with `timeline()`, then advance its immutable state in a
+ * TEA update loop with `Timeline.step()`.
  */
-export declare function timeline(): TimelineBuilder;
-export {};
+export { timeline } from './timeline-builder.js';
+export type { Position, SpringTrackDef, Timeline, TimelineBuilder, TimelineState, TrackDef, TweenTrackDef, } from './timeline-contract.js';
 //# sourceMappingURL=timeline.d.ts.map

package/dist/timeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../src/timeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,QAAQ,EAQb,KAAK,UAAU,EAChB,MAAM,aAAa,CAAC;AAMrB,wEAAwE;AACxE,MAAM,MAAM,QAAQ,GAClB,MAAM,GAAG,GAAG,GAAG,MAAM,MAAM,EAAE,GAAG,KAAK,MAAM,EAAE,GAAG,KAAK,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE/F,kCAAkC;AAClC,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IACzB,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;CACxD;AAED,iCAAiC;AACjC,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;CAC1B;AAED,iEAAiE;AACjE,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG,aAAa,CAAC;AAEtD,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;CACvD;AAED;;;GAGG;AACH,UAAU,UAAU;IAClB,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IAClC,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,kCAAkC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAsKD,6DAA6D;AAC7D,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;;;;OAaG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,eAAe,CAAC;IAEvE;;;;;;;;;;OAUG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAAC;IAErC;;;;;;;;;;OAUG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,eAAe,CAAC;IAEzD;;;;;OAKG;IACH,KAAK,IAAI,QAAQ,CAAC;CACnB;AAED,uEAAuE;AACvE,MAAM,WAAW,QAAQ;IACvB;;;;OAIG;IACH,IAAI,IAAI,aAAa,CAAC;IAEtB;;;;;;;;OAQG;IACH,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,CAAC;IAEtD;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErD;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC;IAEpC;;;;;;;OAOG;IACH,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,EAAE,CAAC;IAEnE,gDAAgD;IAChD,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IAErC,uCAAuC;IACvC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,IAAI,eAAe,CAsB1C"}
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../src/timeline.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,YAAY,EACV,QAAQ,EACR,cAAc,EACd,QAAQ,EACR,eAAe,EACf,aAAa,EACb,QAAQ,EACR,aAAa,GACd,MAAM,wBAAwB,CAAC"}