@flyingrobots/bijou-tui 0.1.0 → 0.2.0

package/dist/runtime.js

@@ -1,7 +1,6 @@
 import { getDefaultContext } from '@flyingrobots/bijou';
-import { QUIT } from './types.js';
-import { parseKey } from './keys.js';
 import { enterScreen, exitScreen, renderFrame } from './screen.js';
+import { createEventBus } from './eventbus.js';
 /**
  * Disable mouse reporting sequences that terminals may send.
  * Some terminals auto-enable mouse tracking in alt screen mode.
@@ -13,6 +12,9 @@ const DISABLE_MOUSE = '\x1b[?1000l\x1b[?1002l\x1b[?1003l\x1b[?1006l';
  * In non-interactive modes (pipe/static/accessible), renders the initial view
  * once and exits. In interactive mode, enters the alt screen, starts the
  * keyboard event loop, and drives the model/update/view cycle.
+ *
+ * All input sources (keyboard, resize, commands) are unified through an
+ * internal EventBus — a single subscription drives the update cycle.
  */
 export async function run(app, options) {
     const ctx = options?.ctx ?? getDefaultContext();
@@ -29,6 +31,7 @@ export async function run(app, options) {
     let running = true;
     let lastCtrlC = 0;
     let resolveQuit = null;
+    const bus = createEventBus();
     function shutdown() {
         if (!running)
             return;
@@ -40,7 +43,6 @@ export async function run(app, options) {
     if (useAltScreen || useHideCursor) {
         enterScreen(ctx.io);
     }
-    // Disable mouse reporting to avoid garbage from mouse events
     ctx.io.write(DISABLE_MOUSE);
     // Render helper
     function render() {
@@ -48,43 +50,23 @@ export async function run(app, options) {
             return;
         renderFrame(ctx.io, app.view(model));
     }
-    // Message handler
-    function handleMsg(msg) {
-        if (!running)
-            return;
-        const [newModel, cmds] = app.update(msg, model);
-        model = newModel;
-        render();
-        executeCommands(cmds);
-    }
-    // Execute commands, feeding results back as messages
+    // Execute commands through the bus
     function executeCommands(cmds) {
         for (const cmd of cmds) {
-            void cmd().then((result) => {
-                if (result === QUIT) {
-                    shutdown();
-                    return;
-                }
-                if (result !== undefined) {
-                    handleMsg(result);
-                }
-            });
+            bus.runCmd(cmd);
         }
     }
-    // Initial render
-    render();
-    // Execute startup commands
-    executeCommands(initCmds);
-    // Start keyboard listener
-    const inputHandle = ctx.io.rawInput((raw) => {
+    // Connect I/O sources — keyboard + resize, parsed and unified
+    bus.connectIO(ctx.io);
+    // Handle quit signals from commands
+    bus.onQuit(shutdown);
+    // Single subscription drives the entire update cycle
+    bus.on((msg) => {
         if (!running)
             return;
-        const keyMsg = parseKey(raw);
-        // Skip unknown sequences (mouse events, etc.)
-        if (keyMsg.key === 'unknown')
-            return;
         // Double Ctrl+C force-quit
-        if (keyMsg.key === 'c' && keyMsg.ctrl) {
+        const keyMsg = msg;
+        if (keyMsg.type === 'key' && keyMsg.key === 'c' && keyMsg.ctrl) {
             const now = Date.now();
             if (now - lastCtrlC < 1000) {
                 shutdown();
@@ -92,17 +74,22 @@ export async function run(app, options) {
             }
             lastCtrlC = now;
         }
-        handleMsg(keyMsg);
+        const [newModel, cmds] = app.update(msg, model);
+        model = newModel;
+        render();
+        executeCommands(cmds);
     });
+    // Initial render + startup commands
+    render();
+    executeCommands(initCmds);
     // Wait for quit signal
     await new Promise((resolve) => {
         resolveQuit = resolve;
-        // In case shutdown was already called before we got here
         if (!running)
             resolve();
     });
-    // Cleanup
-    inputHandle.dispose();
+    // Cleanup — bus disposes all I/O connections
+    bus.dispose();
     if (useAltScreen || useHideCursor) {
         exitScreen(ctx.io);
     }

package/dist/runtime.js.map

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

package/dist/screen.d.ts

@@ -3,19 +3,25 @@ export declare const ENTER_ALT_SCREEN = "\u001B[?1049h";
 export declare const EXIT_ALT_SCREEN = "\u001B[?1049l";
 export declare const HIDE_CURSOR = "\u001B[?25l";
 export declare const SHOW_CURSOR = "\u001B[?25h";
+export declare const WRAP_DISABLE = "\u001B[?7l";
+export declare const WRAP_ENABLE = "\u001B[?7h";
 export declare const CLEAR_SCREEN = "\u001B[2J";
 export declare const CLEAR_TO_END = "\u001B[J";
+export declare const CLEAR_LINE_TO_END = "\u001B[K";
 export declare const HOME = "\u001B[H";
 export declare const CLEAR_LINE = "\u001B[2K";
-/** Enter alt screen buffer, hide cursor, and clear screen. */
+/** Enter alt screen buffer, hide cursor, disable wrap, and clear screen. */
 export declare function enterScreen(io: IOPort): void;
-/** Show cursor and exit alt screen buffer. */
+/** Show cursor, enable wrap, and exit alt screen buffer. */
 export declare function exitScreen(io: IOPort): void;
 /** Clear screen and move cursor to home position. */
 export declare function clearAndHome(io: IOPort): void;
 /**
- * Flicker-free render: move cursor home, write content line-by-line
- * (clearing each line first), then erase everything below.
+ * Flicker-free render: move cursor home, write content line-by-line,
+ * clearing from the end of each line to the terminal edge.
+ *
+ * Disabling wrap in enterScreen() ensures the terminal won't scroll
+ * if we write to the bottom-right cell.
  */
 export declare function renderFrame(io: IOPort, content: string): void;
 //# sourceMappingURL=screen.d.ts.map

package/dist/screen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../src/screen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,eAAO,MAAM,gBAAgB,kBAAgB,CAAC;AAC9C,eAAO,MAAM,eAAe,kBAAgB,CAAC;AAC7C,eAAO,MAAM,WAAW,gBAAc,CAAC;AACvC,eAAO,MAAM,WAAW,gBAAc,CAAC;AACvC,eAAO,MAAM,YAAY,cAAY,CAAC;AACtC,eAAO,MAAM,YAAY,aAAW,CAAC;AACrC,eAAO,MAAM,IAAI,aAAW,CAAC;AAC7B,eAAO,MAAM,UAAU,cAAY,CAAC;AAEpC,8DAA8D;AAC9D,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE5C;AAED,8CAA8C;AAC9C,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAQ7D"}
+{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../src/screen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,eAAO,MAAM,gBAAgB,kBAAgB,CAAC;AAC9C,eAAO,MAAM,eAAe,kBAAgB,CAAC;AAC7C,eAAO,MAAM,WAAW,gBAAc,CAAC;AACvC,eAAO,MAAM,WAAW,gBAAc,CAAC;AACvC,eAAO,MAAM,YAAY,eAAa,CAAC;AACvC,eAAO,MAAM,WAAW,eAAa,CAAC;AACtC,eAAO,MAAM,YAAY,cAAY,CAAC;AACtC,eAAO,MAAM,YAAY,aAAW,CAAC;AACrC,eAAO,MAAM,iBAAiB,aAAW,CAAC;AAC1C,eAAO,MAAM,IAAI,aAAW,CAAC;AAC7B,eAAO,MAAM,UAAU,cAAY,CAAC;AAEpC,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE5C;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAI7D"}

package/dist/screen.js

@@ -2,33 +2,35 @@ export const ENTER_ALT_SCREEN = '\x1b[?1049h';
 export const EXIT_ALT_SCREEN = '\x1b[?1049l';
 export const HIDE_CURSOR = '\x1b[?25l';
 export const SHOW_CURSOR = '\x1b[?25h';
+export const WRAP_DISABLE = '\x1b[?7l';
+export const WRAP_ENABLE = '\x1b[?7h';
 export const CLEAR_SCREEN = '\x1b[2J';
 export const CLEAR_TO_END = '\x1b[J';
+export const CLEAR_LINE_TO_END = '\x1b[K';
 export const HOME = '\x1b[H';
 export const CLEAR_LINE = '\x1b[2K';
-/** Enter alt screen buffer, hide cursor, and clear screen. */
+/** Enter alt screen buffer, hide cursor, disable wrap, and clear screen. */
 export function enterScreen(io) {
-    io.write(ENTER_ALT_SCREEN + HIDE_CURSOR + CLEAR_SCREEN + HOME);
+    io.write(ENTER_ALT_SCREEN + HIDE_CURSOR + WRAP_DISABLE + CLEAR_SCREEN + HOME);
 }
-/** Show cursor and exit alt screen buffer. */
+/** Show cursor, enable wrap, and exit alt screen buffer. */
 export function exitScreen(io) {
-    io.write(SHOW_CURSOR + EXIT_ALT_SCREEN);
+    io.write(SHOW_CURSOR + WRAP_ENABLE + EXIT_ALT_SCREEN);
 }
 /** Clear screen and move cursor to home position. */
 export function clearAndHome(io) {
     io.write(CLEAR_SCREEN + HOME);
 }
 /**
- * Flicker-free render: move cursor home, write content line-by-line
- * (clearing each line first), then erase everything below.
+ * Flicker-free render: move cursor home, write content line-by-line,
+ * clearing from the end of each line to the terminal edge.
+ *
+ * Disabling wrap in enterScreen() ensures the terminal won't scroll
+ * if we write to the bottom-right cell.
  */
 export function renderFrame(io, content) {
     const lines = content.split('\n');
-    let frame = HOME;
-    for (const line of lines) {
-        frame += CLEAR_LINE + line + '\n';
-    }
-    frame += CLEAR_TO_END;
+    const frame = HOME + lines.map((line) => line + CLEAR_LINE_TO_END).join('\n') + CLEAR_TO_END;
     io.write(frame);
 }
 //# sourceMappingURL=screen.js.map

package/dist/screen.js.map

@@ -1 +1 @@
-{"version":3,"file":"screen.js","sourceRoot":"","sources":["../src/screen.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAC9C,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;AAC7C,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC;AACvC,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC;AACvC,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAC;AACtC,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC;AACrC,MAAM,CAAC,MAAM,IAAI,GAAG,QAAQ,CAAC;AAC7B,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC;AAEpC,8DAA8D;AAC9D,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,EAAE,CAAC,KAAK,CAAC,gBAAgB,GAAG,WAAW,GAAG,YAAY,GAAG,IAAI,CAAC,CAAC;AACjE,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,EAAE,CAAC,KAAK,CAAC,WAAW,GAAG,eAAe,CAAC,CAAC;AAC1C,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,EAAE,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,EAAU,EAAE,OAAe;IACrD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,KAAK,GAAG,IAAI,CAAC;IACjB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,IAAI,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC;IACpC,CAAC;IACD,KAAK,IAAI,YAAY,CAAC;IACtB,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAClB,CAAC"}
+{"version":3,"file":"screen.js","sourceRoot":"","sources":["../src/screen.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAC9C,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;AAC7C,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC;AACvC,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC;AACvC,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;AACvC,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AACtC,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAC;AACtC,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AAC1C,MAAM,CAAC,MAAM,IAAI,GAAG,QAAQ,CAAC;AAC7B,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC;AAEpC,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,EAAE,CAAC,KAAK,CAAC,gBAAgB,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,IAAI,CAAC,CAAC;AAChF,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,EAAE,CAAC,KAAK,CAAC,WAAW,GAAG,WAAW,GAAG,eAAe,CAAC,CAAC;AACxD,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,EAAE,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,EAAU,EAAE,OAAe;IACrD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC;IAC7F,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAClB,CAAC"}

package/dist/spring.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Physics-based spring animation engine.
+ *
+ * Uses a damped harmonic oscillator model:
+ *   F = -stiffness * displacement - damping * velocity
+ *   acceleration = F / mass
+ *
+ * Inspired by react-spring and GSAP spring physics.
+ */
+export interface SpringConfig {
+    /** Spring stiffness (tension). Higher = snappier. Default: 170 */
+    readonly stiffness: number;
+    /** Damping (friction). Higher = less oscillation. Default: 26 */
+    readonly damping: number;
+    /** Mass of the object. Higher = more inertia. Default: 1 */
+    readonly mass: number;
+    /** Value threshold to consider the spring settled. Default: 0.01 */
+    readonly precision: number;
+}
+export declare const SPRING_PRESETS: {
+    /** Balanced default — smooth with a hint of bounce */
+    readonly default: {
+        readonly stiffness: 170;
+        readonly damping: 26;
+        readonly mass: 1;
+        readonly precision: 0.01;
+    };
+    /** Soft entrance — slow start, gentle settle */
+    readonly gentle: {
+        readonly stiffness: 120;
+        readonly damping: 14;
+        readonly mass: 1;
+        readonly precision: 0.01;
+    };
+    /** Playful — noticeable overshoot and bounce */
+    readonly wobbly: {
+        readonly stiffness: 180;
+        readonly damping: 12;
+        readonly mass: 1;
+        readonly precision: 0.01;
+    };
+    /** Quick snap — fast with minimal overshoot */
+    readonly stiff: {
+        readonly stiffness: 210;
+        readonly damping: 20;
+        readonly mass: 1;
+        readonly precision: 0.01;
+    };
+    /** Heavy — deliberate, weighty motion */
+    readonly slow: {
+        readonly stiffness: 280;
+        readonly damping: 60;
+        readonly mass: 1;
+        readonly precision: 0.01;
+    };
+    /** Very heavy — thick, viscous feel */
+    readonly molasses: {
+        readonly stiffness: 280;
+        readonly damping: 120;
+        readonly mass: 1;
+        readonly precision: 0.01;
+    };
+};
+export type SpringPreset = keyof typeof SPRING_PRESETS;
+export interface SpringState {
+    /** Current animated value */
+    readonly value: number;
+    /** Current velocity */
+    readonly velocity: number;
+    /** Whether the spring has settled at the target */
+    readonly done: boolean;
+}
+/**
+ * Advance a spring by one time step using semi-implicit Euler integration.
+ *
+ * @param state  Current spring state
+ * @param target Target value the spring is approaching
+ * @param config Spring physics parameters
+ * @param dt     Time step in seconds (e.g. 1/60 for 60fps)
+ */
+export declare function springStep(state: SpringState, target: number, config: SpringConfig, dt: number): SpringState;
+/**
+ * Create a fresh spring state at a given starting value.
+ */
+export declare function createSpringState(value: number): SpringState;
+/**
+ * Resolve a preset name or config object to a full SpringConfig.
+ */
+export declare function resolveSpringConfig(config?: Partial<SpringConfig> | SpringPreset): SpringConfig;
+export type EasingFn = (t: number) => number;
+export declare const EASINGS: {
+    readonly linear: (t: number) => number;
+    readonly easeIn: (t: number) => number;
+    readonly easeOut: (t: number) => number;
+    readonly easeInOut: (t: number) => number;
+    readonly easeInCubic: (t: number) => number;
+    readonly easeOutCubic: (t: number) => number;
+    readonly easeInOutCubic: (t: number) => number;
+    readonly easeInQuart: (t: number) => number;
+    readonly easeOutQuart: (t: number) => number;
+    readonly easeInOutQuart: (t: number) => number;
+};
+export interface TweenConfig {
+    /** Start value. Default: 0 */
+    readonly from: number;
+    /** End value. Default: 1 */
+    readonly to: number;
+    /** Duration in milliseconds */
+    readonly duration: number;
+    /** Easing function. Default: easeOutCubic */
+    readonly ease: EasingFn;
+}
+export interface TweenState {
+    /** Current animated value */
+    readonly value: number;
+    /** Elapsed time in milliseconds */
+    readonly elapsed: number;
+    /** Whether the tween has completed */
+    readonly done: boolean;
+}
+/**
+ * Advance a tween by a time step.
+ *
+ * @param state  Current tween state
+ * @param config Tween parameters
+ * @param dtMs   Time step in milliseconds
+ */
+export declare function tweenStep(state: TweenState, config: TweenConfig, dtMs: number): TweenState;
+/**
+ * Create a fresh tween state.
+ */
+export declare function createTweenState(from: number): TweenState;
+/**
+ * Resolve partial tween config to full config with defaults.
+ */
+export declare function resolveTweenConfig(config: Partial<TweenConfig> & {
+    duration: number;
+}): TweenConfig;
+//# sourceMappingURL=spring.d.ts.map

package/dist/spring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spring.d.ts","sourceRoot":"","sources":["../src/spring.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,cAAc;IACzB,sDAAsD;;;;;;;IAEtD,gDAAgD;;;;;;;IAEhD,gDAAgD;;;;;;;IAEhD,+CAA+C;;;;;;;IAE/C,yCAAyC;;;;;;;IAEzC,uCAAuC;;;;;;;CAEQ,CAAC;AAElD,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,cAAc,CAAC;AAMvD,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uBAAuB;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAMD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,EACpB,EAAE,EAAE,MAAM,GACT,WAAW,CAeb;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAE5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,GAC5C,YAAY,CAId;AAMD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAE7C,eAAO,MAAM,OAAO;yBACN,MAAM;yBAEN,MAAM;0BACL,MAAM;4BACJ,MAAM;8BAEJ,MAAM;+BACL,MAAM;iCACJ,MAAM;8BAGT,MAAM;+BACL,MAAM;iCACJ,MAAM;CAEiB,CAAC;AAM9C,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,GACX,UAAU,CAQZ;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAEzD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAClD,WAAW,CAOb"}

package/dist/spring.js

@@ -0,0 +1,106 @@
+/**
+ * Physics-based spring animation engine.
+ *
+ * Uses a damped harmonic oscillator model:
+ *   F = -stiffness * displacement - damping * velocity
+ *   acceleration = F / mass
+ *
+ * Inspired by react-spring and GSAP spring physics.
+ */
+export const SPRING_PRESETS = {
+    /** Balanced default — smooth with a hint of bounce */
+    default: { stiffness: 170, damping: 26, mass: 1, precision: 0.01 },
+    /** Soft entrance — slow start, gentle settle */
+    gentle: { stiffness: 120, damping: 14, mass: 1, precision: 0.01 },
+    /** Playful — noticeable overshoot and bounce */
+    wobbly: { stiffness: 180, damping: 12, mass: 1, precision: 0.01 },
+    /** Quick snap — fast with minimal overshoot */
+    stiff: { stiffness: 210, damping: 20, mass: 1, precision: 0.01 },
+    /** Heavy — deliberate, weighty motion */
+    slow: { stiffness: 280, damping: 60, mass: 1, precision: 0.01 },
+    /** Very heavy — thick, viscous feel */
+    molasses: { stiffness: 280, damping: 120, mass: 1, precision: 0.01 },
+};
+// ---------------------------------------------------------------------------
+// Core simulation
+// ---------------------------------------------------------------------------
+/**
+ * Advance a spring by one time step using semi-implicit Euler integration.
+ *
+ * @param state  Current spring state
+ * @param target Target value the spring is approaching
+ * @param config Spring physics parameters
+ * @param dt     Time step in seconds (e.g. 1/60 for 60fps)
+ */
+export function springStep(state, target, config, dt) {
+    const { stiffness, damping, mass, precision } = config;
+    const displacement = state.value - target;
+    const springForce = -stiffness * displacement;
+    const dampingForce = -damping * state.velocity;
+    const acceleration = (springForce + dampingForce) / mass;
+    const velocity = state.velocity + acceleration * dt;
+    const value = state.value + velocity * dt;
+    const done = Math.abs(velocity) < precision && Math.abs(value - target) < precision;
+    return { value: done ? target : value, velocity: done ? 0 : velocity, done };
+}
+/**
+ * Create a fresh spring state at a given starting value.
+ */
+export function createSpringState(value) {
+    return { value, velocity: 0, done: false };
+}
+/**
+ * Resolve a preset name or config object to a full SpringConfig.
+ */
+export function resolveSpringConfig(config) {
+    if (config === undefined)
+        return SPRING_PRESETS.default;
+    if (typeof config === 'string')
+        return SPRING_PRESETS[config];
+    return { ...SPRING_PRESETS.default, ...config };
+}
+export const EASINGS = {
+    linear: (t) => t,
+    easeIn: (t) => t * t,
+    easeOut: (t) => t * (2 - t),
+    easeInOut: (t) => (t < 0.5 ? 2 * t * t : -1 + (4 - 2 * t) * t),
+    easeInCubic: (t) => t * t * t,
+    easeOutCubic: (t) => --t * t * t + 1,
+    easeInOutCubic: (t) => t < 0.5 ? 4 * t * t * t : (t - 1) * (2 * t - 2) * (2 * t - 2) + 1,
+    easeInQuart: (t) => t * t * t * t,
+    easeOutQuart: (t) => 1 - --t * t * t * t,
+    easeInOutQuart: (t) => t < 0.5 ? 8 * t * t * t * t : 1 - 8 * --t * t * t * t,
+};
+/**
+ * Advance a tween by a time step.
+ *
+ * @param state  Current tween state
+ * @param config Tween parameters
+ * @param dtMs   Time step in milliseconds
+ */
+export function tweenStep(state, config, dtMs) {
+    const elapsed = Math.min(state.elapsed + dtMs, config.duration);
+    const t = config.duration > 0 ? elapsed / config.duration : 1;
+    const eased = config.ease(t);
+    const value = config.from + (config.to - config.from) * eased;
+    const done = elapsed >= config.duration;
+    return { value: done ? config.to : value, elapsed, done };
+}
+/**
+ * Create a fresh tween state.
+ */
+export function createTweenState(from) {
+    return { value: from, elapsed: 0, done: false };
+}
+/**
+ * Resolve partial tween config to full config with defaults.
+ */
+export function resolveTweenConfig(config) {
+    return {
+        from: config.from ?? 0,
+        to: config.to ?? 1,
+        duration: config.duration,
+        ease: config.ease ?? EASINGS.easeOutCubic,
+    };
+}
+//# sourceMappingURL=spring.js.map

package/dist/spring.js.map

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

package/dist/timeline.d.ts

@@ -0,0 +1,127 @@
+/**
+ * GSAP-style Timeline — orchestrate multiple animations with position-based timing.
+ *
+ * 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 {
+    readonly type?: 'spring';
+    readonly from: number;
+    readonly to: number;
+    readonly spring?: Partial<SpringConfig> | SpringPreset;
+}
+/** Tween track configuration. */
+export interface TweenTrackDef {
+    readonly type: 'tween';
+    readonly from: number;
+    readonly to: number;
+    readonly duration: number;
+    readonly ease?: EasingFn;
+}
+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>>;
+}
+/** @internal */
+interface TrackState {
+    readonly type: 'spring' | 'tween';
+    readonly started: boolean;
+    readonly spring?: SpringState;
+    readonly tween?: TweenState;
+    readonly currentValue: number;
+    readonly done: boolean;
+}
+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 }, '<')
+     * ```
+     */
+    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')
+     * ```
+     */
+    label(name: string): TimelineBuilder;
+    /**
+     * Add a named callback trigger at a position.
+     *
+     * ```ts
+     * .call('onHalfway', '+=500')
+     * ```
+     */
+    call(name: string, position?: Position): TimelineBuilder;
+    /** Compile the timeline into an immutable Timeline object. */
+    build(): Timeline;
+}
+/** Compiled timeline — step forward, read values, check completion. */
+export interface Timeline {
+    /** Create the initial timeline state. */
+    init(): TimelineState;
+    /**
+     * Advance the timeline by `dt` seconds.
+     * Returns a new state (pure — no mutation).
+     */
+    step(state: TimelineState, dt: number): TimelineState;
+    /** Read all current track values as a name→number record. */
+    values(state: TimelineState): Record<string, number>;
+    /** True when every track has settled. */
+    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.
+     */
+    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();
+ * ```
+ */
+export declare function timeline(): TimelineBuilder;
+export {};
+//# sourceMappingURL=timeline.d.ts.map

package/dist/timeline.d.ts.map

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