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

package/dist/animate.js

@@ -1,160 +1,3 @@
-/**
- * TEA-integrated animation commands.
- *
- * GSAP-style API: `animate()` returns a `Cmd` that fires `onFrame`
- * messages as the animation progresses, fitting naturally into the
- * TEA update cycle.
- *
- * Two animation modes:
- *   - **spring**: Physics-based (default). No fixed duration — runs until
- *     the spring settles. Use for organic, responsive motion.
- *   - **tween**: Duration-based with easing curves. Use for predictable,
- *     timed transitions.
- *
- * Both modes support `immediate: true` to skip animation and jump to
- * the target value in a single frame.
- */
-import { springStep, createSpringState, resolveSpringConfig, tweenStep, createTweenState, resolveTweenConfig, EASINGS, } from './spring.js';
-const DEFAULT_SPRING_FIXED_STEP_SECONDS = 1 / 120;
-const DEFAULT_SPRING_MAX_PULSE_SECONDS = 1 / 20;
-// ---------------------------------------------------------------------------
-// animate() — the main API
-// ---------------------------------------------------------------------------
-/**
- * Create a TEA command that drives an animation.
- *
- * Spring mode (default):
- * ```ts
- * animate({ from: 0, to: 100, spring: 'wobbly', onFrame: (v) => ({ type: 'scroll', y: v }) })
- * ```
- *
- * @template M - The message type emitted into the TEA update cycle.
- * @param options - Animation configuration (spring or tween).
- * @returns A TEA command that emits `onFrame` messages as the animation progresses.
- */
-export function animate(options) {
-    const { from, to, immediate = false, onFrame, onComplete } = options;
-    // Immediate mode — single frame, no physics
-    if (immediate) {
-        return async (emit) => {
-            emit(onFrame(to));
-            if (onComplete)
-                emit(onComplete());
-        };
-    }
-    if (options.type === 'tween') {
-        return createTweenCmd(from, to, options.duration, options.ease ?? EASINGS.easeOutCubic, onFrame, onComplete);
-    }
-    const config = resolveSpringConfig(options.spring);
-    return createSpringCmd(from, to, config, {
-        fixedStepSeconds: resolvePositiveSeconds(options.fixedStepSeconds, DEFAULT_SPRING_FIXED_STEP_SECONDS),
-        maxPulseSeconds: resolveMaxPulseSeconds(options.maxPulseSeconds, options.fixedStepSeconds),
-    }, onFrame, onComplete);
-}
-/**
- * Build a TEA command that advances a spring animation from runtime pulses.
- *
- * The command subscribes through `caps.onPulse`, caps each accepted pulse with
- * `maxPulseSeconds`, and accumulates that time into fixed-step spring physics
- * updates. Slow runtime pulses may delay progress, but they do not feed one
- * large raw delta into the spring integrator.
- *
- * @template M - The message type emitted into the TEA update cycle.
- * @param from        - Starting value.
- * @param to          - Target value.
- * @param config      - Resolved spring physics parameters.
- * @param integration - `fixedStepSeconds` and `maxPulseSeconds` integration policy.
- * @param onFrame     - Callback invoked after spring physics advances.
- * @param onComplete  - Optional callback invoked when the spring settles.
- * @returns A TEA command that resolves when the spring is done.
- */
-function createSpringCmd(from, to, config, integration, onFrame, onComplete) {
-    return (emit, caps) => new Promise((resolve) => {
-        let state = createSpringState(from);
-        let accumulatedSeconds = 0;
-        const handle = caps.onPulse((dt) => {
-            accumulatedSeconds = Math.min(integration.maxPulseSeconds, accumulatedSeconds + acceptedPulseSeconds(dt, integration.maxPulseSeconds));
-            let stepped = false;
-            while (accumulatedSeconds >= integration.fixedStepSeconds && !state.done) {
-                state = springStep(state, to, config, integration.fixedStepSeconds);
-                accumulatedSeconds -= integration.fixedStepSeconds;
-                stepped = true;
-            }
-            if (!stepped) {
-                return;
-            }
-            emit(onFrame(state.value));
-            if (state.done) {
-                handle.dispose();
-                if (onComplete)
-                    emit(onComplete());
-                resolve();
-            }
-        });
-    });
-}
-function resolveMaxPulseSeconds(maxPulseSeconds, fixedStepSeconds) {
-    return Math.max(resolvePositiveSeconds(maxPulseSeconds, DEFAULT_SPRING_MAX_PULSE_SECONDS), resolvePositiveSeconds(fixedStepSeconds, DEFAULT_SPRING_FIXED_STEP_SECONDS));
-}
-function resolvePositiveSeconds(value, fallback) {
-    return value != null && Number.isFinite(value) && value > 0 ? value : fallback;
-}
-function acceptedPulseSeconds(dt, maxPulseSeconds) {
-    if (!Number.isFinite(dt) || dt <= 0) {
-        return 0;
-    }
-    return Math.min(dt, maxPulseSeconds);
-}
-// ---------------------------------------------------------------------------
-// Internal: tween command
-// ---------------------------------------------------------------------------
-/**
- * Build a TEA command that advances a tween animation from runtime pulse `dt`.
- *
- * The command subscribes through `caps.onPulse`; each pulse supplies elapsed
- * seconds, which are converted to milliseconds before calling `tweenStep()`.
- *
- * @template M - The message type emitted into the TEA update cycle.
- * @param from       - Starting value.
- * @param to         - Target value.
- * @param duration   - Total animation duration in milliseconds.
- * @param ease       - Easing function applied to normalized progress.
- * @param onFrame    - Callback invoked after tween progress advances.
- * @param onComplete - Optional callback invoked when the tween completes.
- * @returns A TEA command that resolves when the tween is done.
- */
-function createTweenCmd(from, to, duration, ease, onFrame, onComplete) {
-    const config = resolveTweenConfig({ from, to, duration, ease });
-    return (emit, caps) => new Promise((resolve) => {
-        let state = createTweenState(from);
-        const handle = caps.onPulse((dt) => {
-            // tweenStep expects the pulse delta in milliseconds.
-            state = tweenStep(state, config, dt * 1000);
-            emit(onFrame(state.value));
-            if (state.done) {
-                handle.dispose();
-                if (onComplete)
-                    emit(onComplete());
-                resolve();
-            }
-        });
-    });
-}
-// ---------------------------------------------------------------------------
-// sequence() — chain animations like a GSAP timeline
-// ---------------------------------------------------------------------------
-/**
- * Run animations in sequence. Each animation completes before the next starts.
- *
- * @template M - The message type emitted into the TEA update cycle.
- * @param cmds - Ordered TEA commands (typically from {@link animate}) to chain.
- * @returns A single TEA command that runs all commands serially.
- */
-export function sequence(...cmds) {
-    return async (emit, caps) => {
-        for (const cmd of cmds) {
-            await cmd(emit, caps);
-        }
-    };
-}
+export { animate } from './animate.part01.js';
+export { sequence } from './animate.part03.js';
 //# sourceMappingURL=animate.js.map

package/dist/animate.js.map

@@ -1 +1 @@
-{"version":3,"file":"animate.js","sourceRoot":"","sources":["../src/animate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"animate.js","sourceRoot":"","sources":["../src/animate.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/animate.part01.d.ts

@@ -0,0 +1,83 @@
+/**
+ * TEA-integrated animation commands.
+ *
+ * GSAP-style API: `animate()` returns a `Cmd` that fires `onFrame`
+ * messages as the animation progresses, fitting naturally into the
+ * TEA update cycle.
+ *
+ * Two animation modes:
+ *   - **spring**: Physics-based (default). No fixed duration — runs until
+ *     the spring settles. Use for organic, responsive motion.
+ *   - **tween**: Duration-based with easing curves. Use for predictable,
+ *     timed transitions.
+ *
+ * Both modes support `immediate: true` to skip animation and jump to
+ * the target value in a single frame.
+ */
+import type { Cmd } from './types.js';
+import { type SpringConfig, type SpringPreset, type EasingFn } from './spring.js';
+/**
+ * Shared options for both spring and tween animations.
+ *
+ * @template M - The message type emitted into the TEA update cycle.
+ */
+export interface AnimateBase<M> {
+    /** Starting value. */
+    readonly from: number;
+    /** Target value. */
+    readonly to: number;
+    /** Skip animation — jump to target in one frame. Default: false. */
+    readonly immediate?: boolean;
+    /** Called each frame with the interpolated value. Return a message for TEA. */
+    readonly onFrame: (value: number) => M;
+    /** Optional message to emit when the animation is fully complete. */
+    readonly onComplete?: () => M;
+}
+/**
+ * Options for a spring-based animation (the default mode).
+ *
+ * @template M - The message type emitted into the TEA update cycle.
+ */
+export interface SpringAnimateOptions<M> extends AnimateBase<M> {
+    /** Animation mode discriminator. Omit or set to `'spring'` for spring physics. */
+    readonly type?: 'spring';
+    /** Spring config — preset name or custom values. */
+    readonly spring?: Partial<SpringConfig> | SpringPreset;
+    /** Integration step in seconds. Defaults to 1/120 for stable spring physics. */
+    readonly fixedStepSeconds?: number;
+    /** Maximum pulse time accepted in one runtime pulse. Defaults to 1/20. */
+    readonly maxPulseSeconds?: number;
+}
+/**
+ * Options for a duration-based tween animation.
+ *
+ * @template M - The message type emitted into the TEA update cycle.
+ */
+export interface TweenAnimateOptions<M> extends AnimateBase<M> {
+    /** Animation mode discriminator. Must be `'tween'` for tween mode. */
+    readonly type: 'tween';
+    /** Duration in milliseconds. */
+    readonly duration: number;
+    /** Easing function. Default: easeOutCubic. */
+    readonly ease?: EasingFn;
+}
+/**
+ * Discriminated union of spring and tween animation options.
+ *
+ * @template M - The message type emitted into the TEA update cycle.
+ */
+export type AnimateOptions<M> = SpringAnimateOptions<M> | TweenAnimateOptions<M>;
+/**
+ * Create a TEA command that drives an animation.
+ *
+ * Spring mode (default):
+ * ```ts
+ * animate({ from: 0, to: 100, spring: 'wobbly', onFrame: (v) => ({ type: 'scroll', y: v }) })
+ * ```
+ *
+ * @template M - The message type emitted into the TEA update cycle.
+ * @param options - Animation configuration (spring or tween).
+ * @returns A TEA command that emits `onFrame` messages as the animation progresses.
+ */
+export declare function animate<M>(options: AnimateOptions<M>): Cmd<M>;
+//# sourceMappingURL=animate.part01.d.ts.map

package/dist/animate.part01.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animate.part01.d.ts","sourceRoot":"","sources":["../src/animate.part01.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,QAAQ,EAGd,MAAM,aAAa,CAAC;AAarB;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,CAAC;IACvC,qEAAqE;IACrE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;CAC/B;AACD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IAC7D,kFAAkF;IAClF,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IACzB,oDAAoD;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;IACvD,gFAAgF;IAChF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AACD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IAC5D,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;CAC1B;AACD;;;;GAIG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAC1B,oBAAoB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAKnD;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAyC7D"}

package/dist/animate.part01.js

@@ -0,0 +1,40 @@
+import { resolveSpringConfig, EASINGS, } from './spring.js';
+import { createSpringCmd, resolveMaxPulseSeconds, resolvePositiveSeconds, } from './animate.part02.js';
+import { createTweenCmd } from './animate.part03.js';
+import { DEFAULT_SPRING_FIXED_STEP_SECONDS } from './animate-constants.js';
+// ---------------------------------------------------------------------------
+// animate() — the main API
+// ---------------------------------------------------------------------------
+/**
+ * Create a TEA command that drives an animation.
+ *
+ * Spring mode (default):
+ * ```ts
+ * animate({ from: 0, to: 100, spring: 'wobbly', onFrame: (v) => ({ type: 'scroll', y: v }) })
+ * ```
+ *
+ * @template M - The message type emitted into the TEA update cycle.
+ * @param options - Animation configuration (spring or tween).
+ * @returns A TEA command that emits `onFrame` messages as the animation progresses.
+ */
+export function animate(options) {
+    const { from, to, immediate = false, onFrame, onComplete } = options;
+    // Immediate mode — single frame, no physics
+    if (immediate) {
+        return (emit) => {
+            emit(onFrame(to));
+            if (onComplete)
+                emit(onComplete());
+            return undefined;
+        };
+    }
+    if (options.type === 'tween') {
+        return createTweenCmd(from, to, options.duration, options.ease ?? EASINGS.easeOutCubic, onFrame, onComplete);
+    }
+    const config = resolveSpringConfig(options.spring);
+    return createSpringCmd(from, to, config, {
+        fixedStepSeconds: resolvePositiveSeconds(options.fixedStepSeconds, DEFAULT_SPRING_FIXED_STEP_SECONDS),
+        maxPulseSeconds: resolveMaxPulseSeconds(options.maxPulseSeconds, options.fixedStepSeconds),
+    }, onFrame, onComplete);
+}
+//# sourceMappingURL=animate.part01.js.map

package/dist/animate.part01.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"animate.part01.js","sourceRoot":"","sources":["../src/animate.part01.ts"],"names":[],"mappings":"AAiBA,OAAO,EAIL,mBAAmB,EACnB,OAAO,GACR,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,iCAAiC,EAAE,MAAM,wBAAwB,CAAC;AA0D3E,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,OAAO,CAAI,OAA0B;IACnD,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,GAAG,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAErE,4CAA4C;IAC5C,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,IAAI,EAAE,EAAE;YACd,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;YAClB,IAAI,UAAU;gBAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;YACnC,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC7B,OAAO,cAAc,CACnB,IAAI,EACJ,EAAE,EACF,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,YAAY,EACpC,OAAO,EACP,UAAU,CACX,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,OAAO,eAAe,CACpB,IAAI,EACJ,EAAE,EACF,MAAM,EACN;QACE,gBAAgB,EAAE,sBAAsB,CACtC,OAAO,CAAC,gBAAgB,EACxB,iCAAiC,CAClC;QACD,eAAe,EAAE,sBAAsB,CACrC,OAAO,CAAC,eAAe,EACvB,OAAO,CAAC,gBAAgB,CACzB;KACF,EACD,OAAO,EACP,UAAU,CACX,CAAC;AACJ,CAAC"}

package/dist/animate.part02.d.ts

@@ -0,0 +1,44 @@
+/**
+ * TEA-integrated animation commands.
+ *
+ * GSAP-style API: `animate()` returns a `Cmd` that fires `onFrame`
+ * messages as the animation progresses, fitting naturally into the
+ * TEA update cycle.
+ *
+ * Two animation modes:
+ *   - **spring**: Physics-based (default). No fixed duration — runs until
+ *     the spring settles. Use for organic, responsive motion.
+ *   - **tween**: Duration-based with easing curves. Use for predictable,
+ *     timed transitions.
+ *
+ * Both modes support `immediate: true` to skip animation and jump to
+ * the target value in a single frame.
+ */
+import type { Cmd } from './types.js';
+import { type SpringConfig } from './spring.js';
+export interface SpringIntegrationOptions {
+    readonly fixedStepSeconds: number;
+    readonly maxPulseSeconds: number;
+}
+/**
+ * Build a TEA command that advances a spring animation from runtime pulses.
+ *
+ * The command subscribes through `caps.onPulse`, caps each accepted pulse with
+ * `maxPulseSeconds`, and accumulates that time into fixed-step spring physics
+ * updates. Slow runtime pulses may delay progress, but they do not feed one
+ * large raw delta into the spring integrator.
+ *
+ * @template M - The message type emitted into the TEA update cycle.
+ * @param from        - Starting value.
+ * @param to          - Target value.
+ * @param config      - Resolved spring physics parameters.
+ * @param integration - `fixedStepSeconds` and `maxPulseSeconds` integration policy.
+ * @param onFrame     - Callback invoked after spring physics advances.
+ * @param onComplete  - Optional callback invoked when the spring settles.
+ * @returns A TEA command that resolves when the spring is done.
+ */
+export declare function createSpringCmd<M>(from: number, to: number, config: SpringConfig, integration: SpringIntegrationOptions, onFrame: (value: number) => M, onComplete?: () => M): Cmd<M>;
+export declare function resolveMaxPulseSeconds(maxPulseSeconds: number | undefined, fixedStepSeconds: number | undefined): number;
+export declare function resolvePositiveSeconds(value: number | undefined, fallback: number): number;
+export declare function acceptedPulseSeconds(dt: number, maxPulseSeconds: number): number;
+//# sourceMappingURL=animate.part02.d.ts.map

package/dist/animate.part02.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animate.part02.d.ts","sourceRoot":"","sources":["../src/animate.part02.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,KAAK,YAAY,EAAiC,MAAM,aAAa,CAAC;AAU/E,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AACD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,wBAAwB,EACrC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,EAC7B,UAAU,CAAC,EAAE,MAAM,CAAC,GACnB,GAAG,CAAC,CAAC,CAAC,CAmCR;AACD,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,gBAAgB,EAAE,MAAM,GAAG,SAAS,GACnC,MAAM,CAKR;AACD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,MAAM,GACf,MAAM,CAIR;AACD,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,MAAM,EACV,eAAe,EAAE,MAAM,GACtB,MAAM,CAKR"}

package/dist/animate.part02.js

@@ -0,0 +1,61 @@
+import { springStep, createSpringState } from './spring.js';
+import { DEFAULT_SPRING_FIXED_STEP_SECONDS, DEFAULT_SPRING_MAX_PULSE_SECONDS, } from './animate-constants.js';
+/**
+ * Build a TEA command that advances a spring animation from runtime pulses.
+ *
+ * The command subscribes through `caps.onPulse`, caps each accepted pulse with
+ * `maxPulseSeconds`, and accumulates that time into fixed-step spring physics
+ * updates. Slow runtime pulses may delay progress, but they do not feed one
+ * large raw delta into the spring integrator.
+ *
+ * @template M - The message type emitted into the TEA update cycle.
+ * @param from        - Starting value.
+ * @param to          - Target value.
+ * @param config      - Resolved spring physics parameters.
+ * @param integration - `fixedStepSeconds` and `maxPulseSeconds` integration policy.
+ * @param onFrame     - Callback invoked after spring physics advances.
+ * @param onComplete  - Optional callback invoked when the spring settles.
+ * @returns A TEA command that resolves when the spring is done.
+ */
+export function createSpringCmd(from, to, config, integration, onFrame, onComplete) {
+    return (emit, caps) => new Promise((resolve) => {
+        let state = createSpringState(from);
+        let accumulatedSeconds = 0;
+        const handle = caps.onPulse((dt) => {
+            accumulatedSeconds = Math.min(integration.maxPulseSeconds, accumulatedSeconds +
+                acceptedPulseSeconds(dt, integration.maxPulseSeconds));
+            let stepped = false;
+            while (accumulatedSeconds >= integration.fixedStepSeconds &&
+                !state.done) {
+                state = springStep(state, to, config, integration.fixedStepSeconds);
+                accumulatedSeconds -= integration.fixedStepSeconds;
+                stepped = true;
+            }
+            if (!stepped) {
+                return;
+            }
+            emit(onFrame(state.value));
+            if (state.done) {
+                handle.dispose();
+                if (onComplete)
+                    emit(onComplete());
+                resolve(undefined);
+            }
+        });
+    });
+}
+export function resolveMaxPulseSeconds(maxPulseSeconds, fixedStepSeconds) {
+    return Math.max(resolvePositiveSeconds(maxPulseSeconds, DEFAULT_SPRING_MAX_PULSE_SECONDS), resolvePositiveSeconds(fixedStepSeconds, DEFAULT_SPRING_FIXED_STEP_SECONDS));
+}
+export function resolvePositiveSeconds(value, fallback) {
+    return value != null && Number.isFinite(value) && value > 0
+        ? value
+        : fallback;
+}
+export function acceptedPulseSeconds(dt, maxPulseSeconds) {
+    if (!Number.isFinite(dt) || dt <= 0) {
+        return 0;
+    }
+    return Math.min(dt, maxPulseSeconds);
+}
+//# sourceMappingURL=animate.part02.js.map

package/dist/animate.part02.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"animate.part02.js","sourceRoot":"","sources":["../src/animate.part02.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAqB,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EACL,iCAAiC,EACjC,gCAAgC,GACjC,MAAM,wBAAwB,CAAC;AAUhC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,EAAU,EACV,MAAoB,EACpB,WAAqC,EACrC,OAA6B,EAC7B,UAAoB;IAEpB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CACpB,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,EAAE;QACjC,IAAI,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,kBAAkB,GAAG,CAAC,CAAC;QAE3B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;YACjC,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAC3B,WAAW,CAAC,eAAe,EAC3B,kBAAkB;gBAChB,oBAAoB,CAAC,EAAE,EAAE,WAAW,CAAC,eAAe,CAAC,CACxD,CAAC;YACF,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,OACE,kBAAkB,IAAI,WAAW,CAAC,gBAAgB;gBAClD,CAAC,KAAK,CAAC,IAAI,EACX,CAAC;gBACD,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,gBAAgB,CAAC,CAAC;gBACpE,kBAAkB,IAAI,WAAW,CAAC,gBAAgB,CAAC;gBACnD,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;YAED,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO;YACT,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YAE3B,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBACf,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,IAAI,UAAU;oBAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;gBACnC,OAAO,CAAC,SAAS,CAAC,CAAC;YACrB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC;AACD,MAAM,UAAU,sBAAsB,CACpC,eAAmC,EACnC,gBAAoC;IAEpC,OAAO,IAAI,CAAC,GAAG,CACb,sBAAsB,CAAC,eAAe,EAAE,gCAAgC,CAAC,EACzE,sBAAsB,CAAC,gBAAgB,EAAE,iCAAiC,CAAC,CAC5E,CAAC;AACJ,CAAC;AACD,MAAM,UAAU,sBAAsB,CACpC,KAAyB,EACzB,QAAgB;IAEhB,OAAO,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QACzD,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,QAAQ,CAAC;AACf,CAAC;AACD,MAAM,UAAU,oBAAoB,CAClC,EAAU,EACV,eAAuB;IAEvB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;AACvC,CAAC"}

package/dist/animate.part03.d.ts

@@ -0,0 +1,43 @@
+/**
+ * TEA-integrated animation commands.
+ *
+ * GSAP-style API: `animate()` returns a `Cmd` that fires `onFrame`
+ * messages as the animation progresses, fitting naturally into the
+ * TEA update cycle.
+ *
+ * Two animation modes:
+ *   - **spring**: Physics-based (default). No fixed duration — runs until
+ *     the spring settles. Use for organic, responsive motion.
+ *   - **tween**: Duration-based with easing curves. Use for predictable,
+ *     timed transitions.
+ *
+ * Both modes support `immediate: true` to skip animation and jump to
+ * the target value in a single frame.
+ */
+import type { Cmd } from './types.js';
+import { type EasingFn } from './spring.js';
+/**
+ * Build a TEA command that advances a tween animation from runtime pulse `dt`.
+ *
+ * The command subscribes through `caps.onPulse`; each pulse supplies elapsed
+ * seconds, which are converted to milliseconds before calling `tweenStep()`.
+ *
+ * @template M - The message type emitted into the TEA update cycle.
+ * @param from       - Starting value.
+ * @param to         - Target value.
+ * @param duration   - Total animation duration in milliseconds.
+ * @param ease       - Easing function applied to normalized progress.
+ * @param onFrame    - Callback invoked after tween progress advances.
+ * @param onComplete - Optional callback invoked when the tween completes.
+ * @returns A TEA command that resolves when the tween is done.
+ */
+export declare function createTweenCmd<M>(from: number, to: number, duration: number, ease: EasingFn, onFrame: (value: number) => M, onComplete?: () => M): Cmd<M>;
+/**
+ * Run animations in sequence. Each animation completes before the next starts.
+ *
+ * @template M - The message type emitted into the TEA update cycle.
+ * @param cmds - Ordered TEA commands (typically from {@link animate}) to chain.
+ * @returns A single TEA command that runs all commands serially.
+ */
+export declare function sequence<M>(...cmds: Cmd<M>[]): Cmd<M>;
+//# sourceMappingURL=animate.part03.d.ts.map

package/dist/animate.part03.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animate.part03.d.ts","sourceRoot":"","sources":["../src/animate.part03.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EACL,KAAK,QAAQ,EAId,MAAM,aAAa,CAAC;AAMrB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,EAC7B,UAAU,CAAC,EAAE,MAAM,CAAC,GACnB,GAAG,CAAC,CAAC,CAAC,CAmBR;AACD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAOrD"}

package/dist/animate.part03.js

@@ -0,0 +1,52 @@
+import { tweenStep, createTweenState, resolveTweenConfig, } from './spring.js';
+// ---------------------------------------------------------------------------
+// Internal: tween command
+// ---------------------------------------------------------------------------
+/**
+ * Build a TEA command that advances a tween animation from runtime pulse `dt`.
+ *
+ * The command subscribes through `caps.onPulse`; each pulse supplies elapsed
+ * seconds, which are converted to milliseconds before calling `tweenStep()`.
+ *
+ * @template M - The message type emitted into the TEA update cycle.
+ * @param from       - Starting value.
+ * @param to         - Target value.
+ * @param duration   - Total animation duration in milliseconds.
+ * @param ease       - Easing function applied to normalized progress.
+ * @param onFrame    - Callback invoked after tween progress advances.
+ * @param onComplete - Optional callback invoked when the tween completes.
+ * @returns A TEA command that resolves when the tween is done.
+ */
+export function createTweenCmd(from, to, duration, ease, onFrame, onComplete) {
+    const config = resolveTweenConfig({ from, to, duration, ease });
+    return (emit, caps) => new Promise((resolve) => {
+        let state = createTweenState(from);
+        const handle = caps.onPulse((dt) => {
+            // tweenStep expects the pulse delta in milliseconds.
+            state = tweenStep(state, config, dt * 1000);
+            emit(onFrame(state.value));
+            if (state.done) {
+                handle.dispose();
+                if (onComplete)
+                    emit(onComplete());
+                resolve(undefined);
+            }
+        });
+    });
+}
+/**
+ * Run animations in sequence. Each animation completes before the next starts.
+ *
+ * @template M - The message type emitted into the TEA update cycle.
+ * @param cmds - Ordered TEA commands (typically from {@link animate}) to chain.
+ * @returns A single TEA command that runs all commands serially.
+ */
+export function sequence(...cmds) {
+    return async (emit, caps) => {
+        for (const cmd of cmds) {
+            await cmd(emit, caps);
+        }
+        return undefined;
+    };
+}
+//# sourceMappingURL=animate.part03.js.map

package/dist/animate.part03.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"animate.part03.js","sourceRoot":"","sources":["../src/animate.part03.ts"],"names":[],"mappings":"AAiBA,OAAO,EAEL,SAAS,EACT,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,EAAU,EACV,QAAgB,EAChB,IAAc,EACd,OAA6B,EAC7B,UAAoB;IAEpB,MAAM,MAAM,GAAG,kBAAkB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CACpB,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,EAAE;QACjC,IAAI,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAEnC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;YACjC,qDAAqD;YACrD,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;YAC5C,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YAE3B,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBACf,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,IAAI,UAAU;oBAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;gBACnC,OAAO,CAAC,SAAS,CAAC,CAAC;YACrB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC;AACD;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAI,GAAG,IAAc;IAC3C,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QAC1B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;AACJ,CAAC"}