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

package/dist/timeline-compile.js

@@ -0,0 +1,60 @@
+import { EASINGS, resolveSpringConfig, } from './spring.js';
+import { estimateSpringDuration, resolveTimelinePosition, } from './timeline-position.js';
+import { createTimelineRuntime } from './timeline-runtime.js';
+export function compileTimeline(entries) {
+    const tracks = [];
+    const trackNames = new Set();
+    const callbacks = [];
+    const labels = new Map();
+    let prevStartMs = 0;
+    let prevEndMs = 0;
+    for (const entry of entries) {
+        const cursor = { prevStartMs, prevEndMs, labels };
+        if (entry.kind === 'label') {
+            labels.set(entry.name, prevEndMs);
+            continue;
+        }
+        if (entry.kind === 'call') {
+            callbacks.push({
+                name: entry.name,
+                atMs: resolveTimelinePosition(entry.position, cursor),
+            });
+            continue;
+        }
+        const startMs = resolveTimelinePosition(entry.position, cursor);
+        if (trackNames.has(entry.name)) {
+            throw new Error(`Timeline: duplicate track name "${entry.name}"`);
+        }
+        const resolved = resolveTrack(entry.name, entry.def, startMs);
+        trackNames.add(entry.name);
+        tracks.push(resolved);
+        prevStartMs = startMs;
+        prevEndMs = startMs + resolved.estimatedDurationMs;
+    }
+    return createTimelineRuntime(tracks, [...callbacks].sort((left, right) => left.atMs - right.atMs));
+}
+function resolveTrack(name, definition, startMs) {
+    if (definition.type === 'tween') {
+        return {
+            name,
+            startMs,
+            estimatedDurationMs: definition.duration,
+            trackType: 'tween',
+            from: definition.from,
+            to: definition.to,
+            tweenDuration: definition.duration,
+            tweenEase: definition.ease ?? EASINGS.easeOutCubic,
+        };
+    }
+    const springConfig = resolveSpringConfig(definition.spring);
+    return {
+        name,
+        startMs,
+        estimatedDurationMs: estimateSpringDuration(definition.from, definition.to, springConfig),
+        trackType: 'spring',
+        from: definition.from,
+        to: definition.to,
+        springConfig,
+    };
+}
+//# sourceMappingURL=timeline-compile.js.map

package/dist/timeline-compile.js.map

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

package/dist/timeline-contract.d.ts

@@ -0,0 +1,102 @@
+import type { EasingFn, SpringConfig, SpringPreset, SpringState, TweenState } from './spring.js';
+/** Position in the timeline controlling when an entry starts. */
+export type Position = number | '<' | `<+=${string}` | `+=${string}` | `-=${string}` | `>${string}` | (string & {});
+/** Spring track configuration. */
+export interface SpringTrackDef {
+    /** Animation type; omitted values select spring behavior. */
+    readonly type?: 'spring';
+    /** Starting value. */
+    readonly from: number;
+    /** Target value. */
+    readonly to: number;
+    /** Spring physics parameters or named preset. */
+    readonly spring?: Partial<SpringConfig> | SpringPreset;
+}
+/** Tween track configuration. */
+export interface TweenTrackDef {
+    /** Animation type. */
+    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 supported track definitions. */
+export type TrackDef = SpringTrackDef | TweenTrackDef;
+/** Opaque immutable state passed between timeline steps. */
+export interface TimelineState {
+    /** Elapsed timeline time in milliseconds. */
+    readonly elapsedMs: number;
+    /** Per-track engine state. */
+    readonly tracks: Readonly<Record<string, TrackState>>;
+}
+/** Fluent builder for position-based tracks, labels, and callbacks. */
+export interface TimelineBuilder {
+    /** Add a uniquely named animation track. */
+    add(name: string, def: TrackDef, position?: Position): TimelineBuilder;
+    /** Add a label at the current timeline cursor. */
+    label(name: string): TimelineBuilder;
+    /** Add a named callback trigger. */
+    call(name: string, position?: Position): TimelineBuilder;
+    /** Compile the accumulated definition into an immutable state machine. */
+    build(): Timeline;
+}
+/** Compiled timeline state machine. */
+export interface Timeline {
+    /** Create an initial state with every track at its starting value. */
+    init(): TimelineState;
+    /** Advance state by a finite, non-negative duration in seconds. */
+    step(state: TimelineState, dt: number): TimelineState;
+    /** Read current values keyed by track name. */
+    values(state: TimelineState): Record<string, number>;
+    /** Report whether every track has settled. */
+    done(state: TimelineState): boolean;
+    /** Return callbacks crossed between two states. */
+    firedCallbacks(prev: TimelineState, next: TimelineState): string[];
+    /** Estimated total duration in milliseconds. */
+    readonly estimatedDurationMs: number;
+    /** Track names in definition order. */
+    readonly trackNames: readonly string[];
+}
+/** Internal per-track engine state retained by `TimelineState`. */
+export interface TrackState {
+    readonly type: 'spring' | 'tween';
+    readonly started: boolean;
+    readonly spring?: SpringState;
+    readonly tween?: TweenState;
+    readonly currentValue: number;
+    readonly done: boolean;
+}
+export interface ResolvedTrack {
+    readonly name: string;
+    readonly startMs: number;
+    readonly estimatedDurationMs: number;
+    readonly trackType: 'spring' | 'tween';
+    readonly from: number;
+    readonly to: number;
+    readonly springConfig?: SpringConfig;
+    readonly tweenDuration?: number;
+    readonly tweenEase?: EasingFn;
+}
+export interface ResolvedCallback {
+    readonly name: string;
+    readonly atMs: number;
+}
+export type BuilderEntry = {
+    readonly kind: 'track';
+    readonly name: string;
+    readonly def: TrackDef;
+    readonly position?: Position;
+} | {
+    readonly kind: 'label';
+    readonly name: string;
+} | {
+    readonly kind: 'call';
+    readonly name: string;
+    readonly position?: Position;
+};
+//# sourceMappingURL=timeline-contract.d.ts.map

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

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

package/dist/timeline-contract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=timeline-contract.js.map

package/dist/timeline-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-contract.js","sourceRoot":"","sources":["../src/timeline-contract.ts"],"names":[],"mappings":""}

package/dist/timeline-position.d.ts

@@ -0,0 +1,10 @@
+import { type SpringConfig } from './spring.js';
+import type { Position } from './timeline-contract.js';
+export interface TimelineCursor {
+    readonly prevStartMs: number;
+    readonly prevEndMs: number;
+    readonly labels: ReadonlyMap<string, number>;
+}
+export declare function estimateSpringDuration(from: number, to: number, config: SpringConfig): number;
+export declare function resolveTimelinePosition(position: Position | undefined, cursor: TimelineCursor): number;
+//# sourceMappingURL=timeline-position.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-position.d.ts","sourceRoot":"","sources":["../src/timeline-position.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGvD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9C;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,YAAY,GACnB,MAAM,CAUR;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAC9B,MAAM,EAAE,cAAc,GACrB,MAAM,CA0CR"}

package/dist/timeline-position.js

@@ -0,0 +1,55 @@
+import { createSpringState, springStep, } from './spring.js';
+import { must } from './timeline-utils.js';
+export function estimateSpringDuration(from, to, config) {
+    let state = createSpringState(from);
+    const dt = 1 / 60;
+    let steps = 0;
+    const maxSteps = 60 * 30;
+    while (!state.done && steps < maxSteps) {
+        state = springStep(state, to, config, dt);
+        steps += 1;
+    }
+    return steps * dt * 1000;
+}
+export function resolveTimelinePosition(position, cursor) {
+    if (position === undefined)
+        return cursor.prevEndMs;
+    if (typeof position === 'number')
+        return Math.max(0, position);
+    if (position === '<')
+        return cursor.prevStartMs;
+    const fromPreviousStart = /^<\+=(\d+(?:\.\d+)?)$/.exec(position);
+    if (fromPreviousStart !== null) {
+        return cursor.prevStartMs
+            + parseFloat(must(fromPreviousStart[1], 'position offset'));
+    }
+    const afterPreviousEnd = /^\+=(\d+(?:\.\d+)?)$/.exec(position);
+    if (afterPreviousEnd !== null) {
+        return cursor.prevEndMs
+            + parseFloat(must(afterPreviousEnd[1], 'position offset'));
+    }
+    const beforePreviousEnd = /^-=(\d+(?:\.\d+)?)$/.exec(position);
+    if (beforePreviousEnd !== null) {
+        return Math.max(0, cursor.prevEndMs
+            - parseFloat(must(beforePreviousEnd[1], 'position offset')));
+    }
+    const fromPreviousEnd = /^>=?(\d+(?:\.\d+)?)$/.exec(position);
+    if (fromPreviousEnd !== null) {
+        return cursor.prevEndMs
+            + parseFloat(must(fromPreviousEnd[1], 'position offset'));
+    }
+    const fromLabel = /^([a-zA-Z_]\w*)(?:\+=(\d+(?:\.\d+)?))?$/.exec(position);
+    if (fromLabel !== null) {
+        const label = must(fromLabel[1], 'label name');
+        const offset = fromLabel[2] === undefined
+            ? 0
+            : parseFloat(fromLabel[2]);
+        const labelMs = cursor.labels.get(label);
+        if (labelMs === undefined) {
+            throw new Error(`Timeline: unknown label "${label}"`);
+        }
+        return labelMs + offset;
+    }
+    throw new Error(`Timeline: invalid position "${position}"`);
+}
+//# sourceMappingURL=timeline-position.js.map

package/dist/timeline-position.js.map

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

package/dist/timeline-runtime.d.ts

@@ -0,0 +1,3 @@
+import type { ResolvedCallback, ResolvedTrack, Timeline } from './timeline-contract.js';
+export declare function createTimelineRuntime(tracks: readonly ResolvedTrack[], callbacks: readonly ResolvedCallback[]): Timeline;
+//# sourceMappingURL=timeline-runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-runtime.d.ts","sourceRoot":"","sources":["../src/timeline-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,QAAQ,EAGT,MAAM,wBAAwB,CAAC;AAIhC,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,SAAS,EAAE,SAAS,gBAAgB,EAAE,GACrC,QAAQ,CA6BV"}

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":"AAAA,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,SAAS,GACV,MAAM,aAAa,CAAC;AAKrB,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3C,MAAM,UAAU,iBAAiB,CAC/B,KAAoB,EACpB,QAAoB,EACpB,SAAiB,EACjB,EAAU;IAEV,IAAI,SAAS,GAAG,KAAK,CAAC,OAAO,IAAI,QAAQ,CAAC,IAAI;QAAE,OAAO,QAAQ,CAAC;IAChE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QAChE,OAAO,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,UAAU,CAAC,KAAoB,EAAE,EAAU;IAClD,IAAI,KAAK,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,UAAU,CACxB,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,EAC7B,KAAK,CAAC,EAAE,EACR,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,4BAA4B,KAAK,CAAC,IAAI,GAAG,CAAC,EACnE,EAAE,CACH,CAAC;QACF,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,OAAO;YACf,YAAY,EAAE,OAAO,CAAC,KAAK;YAC3B,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,SAAS,CACvB,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,EAC5B,WAAW,CAAC,KAAK,CAAC,EAClB,EAAE,GAAG,IAAI,CACV,CAAC;IACF,OAAO;QACL,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,OAAO;QACd,YAAY,EAAE,OAAO,CAAC,KAAK;QAC3B,IAAI,EAAE,OAAO,CAAC,IAAI;KACnB,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CACpB,KAAoB,EACpB,QAAoB,EACpB,EAAU;IAEV,IAAI,KAAK,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,UAAU,CACxB,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,2BAA2B,KAAK,CAAC,IAAI,GAAG,CAAC,EAC/D,KAAK,CAAC,EAAE,EACR,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,4BAA4B,KAAK,CAAC,IAAI,GAAG,CAAC,EACnE,EAAE,CACH,CAAC;QACF,OAAO;YACL,GAAG,QAAQ;YACX,MAAM,EAAE,OAAO;YACf,YAAY,EAAE,OAAO,CAAC,KAAK;YAC3B,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,SAAS,CACvB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,0BAA0B,KAAK,CAAC,IAAI,GAAG,CAAC,EAC7D,WAAW,CAAC,KAAK,CAAC,EAClB,EAAE,GAAG,IAAI,CACV,CAAC;IACF,OAAO;QACL,GAAG,QAAQ;QACX,KAAK,EAAE,OAAO;QACd,YAAY,EAAE,OAAO,CAAC,KAAK;QAC3B,IAAI,EAAE,OAAO,CAAC,IAAI;KACnB,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAAoB;IACvC,OAAO,kBAAkB,CAAC;QACxB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,QAAQ,EAAE,IAAI,CACZ,KAAK,CAAC,aAAa,EACnB,6BAA6B,KAAK,CAAC,IAAI,GAAG,CAC3C;QACD,IAAI,EAAE,KAAK,CAAC,SAAS;KACtB,CAAC,CAAC;AACL,CAAC"}

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":"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"}
+{"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"}