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

package/dist/timeline.js

@@ -1,333 +1,8 @@
 /**
- * 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 { springStep, createSpringState, resolveSpringConfig, tweenStep, createTweenState, resolveTweenConfig, EASINGS, } from './spring.js';
-// ---------------------------------------------------------------------------
-// Spring duration estimation
-// ---------------------------------------------------------------------------
-/**
- * Estimate how long a spring animation takes to settle by simulating it.
- *
- * @param from - Starting value.
- * @param to - Target value.
- * @param config - Spring physics configuration.
- * @returns Estimated duration in milliseconds (capped at 30 seconds).
- */
-function estimateSpringDuration(from, to, config) {
-    let state = createSpringState(from);
-    const dt = 1 / 60;
-    let steps = 0;
-    const maxSteps = 60 * 30; // 30 seconds max
-    while (!state.done && steps < maxSteps) {
-        state = springStep(state, to, config, dt);
-        steps++;
-    }
-    return steps * dt * 1000;
-}
-/**
- * Resolve a position specifier to an absolute time in milliseconds.
- *
- * @param pos - Position specifier (number, relative offset, or label reference).
- * @param cursor - Current cursor info with previous start/end and known labels.
- * @returns Absolute time in milliseconds.
- * @throws Error if the position references an unknown label or has invalid syntax.
- */
-function resolvePosition(pos, cursor) {
-    if (pos === undefined) {
-        // Default: after previous item ends
-        return cursor.prevEndMs;
-    }
-    if (typeof pos === 'number') {
-        return Math.max(0, pos);
-    }
-    if (pos === '<') {
-        return cursor.prevStartMs;
-    }
-    // '<+=N' — offset from previous start
-    const ltPlusMatch = /^<\+=(\d+(?:\.\d+)?)$/.exec(pos);
-    if (ltPlusMatch) {
-        return cursor.prevStartMs + parseFloat(must(ltPlusMatch[1]));
-    }
-    // '+=N' — offset from previous end
-    const plusMatch = /^\+=(\d+(?:\.\d+)?)$/.exec(pos);
-    if (plusMatch) {
-        return cursor.prevEndMs + parseFloat(must(plusMatch[1]));
-    }
-    // '-=N' — overlap with previous
-    const minusMatch = /^-=(\d+(?:\.\d+)?)$/.exec(pos);
-    if (minusMatch) {
-        return Math.max(0, cursor.prevEndMs - parseFloat(must(minusMatch[1])));
-    }
-    // '>N' or '>=N' — explicit offset from previous end
-    const gtMatch = /^>=?(\d+(?:\.\d+)?)$/.exec(pos);
-    if (gtMatch) {
-        return cursor.prevEndMs + parseFloat(must(gtMatch[1]));
-    }
-    // 'label' or 'label+=N'
-    const labelMatch = /^([a-zA-Z_]\w*)(?:\+=(\d+(?:\.\d+)?))?$/.exec(pos);
-    if (labelMatch) {
-        const labelName = must(labelMatch[1]);
-        const offset = labelMatch[2] === undefined ? 0 : parseFloat(labelMatch[2]);
-        const labelMs = cursor.labels.get(labelName);
-        if (labelMs === undefined) {
-            throw new Error(`Timeline: unknown label "${labelName}"`);
-        }
-        return labelMs + offset;
-    }
-    throw new Error(`Timeline: invalid position "${pos}"`);
-}
-function must(value) { if (value === undefined)
-    throw new Error('Timeline: missing state'); return value; }
-// ---------------------------------------------------------------------------
-// timeline() — entry point
-// ---------------------------------------------------------------------------
-/**
- * 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.
- */
-export function timeline() {
-    const entries = [];
-    const builder = {
-        add(name, def, position) {
-            entries.push({ kind: 'track', name, def, position });
-            return builder;
-        },
-        label(name) {
-            entries.push({ kind: 'label', name });
-            return builder;
-        },
-        call(name, position) {
-            entries.push({ kind: 'call', name, position });
-            return builder;
-        },
-        build() {
-            return compile(entries);
-        },
-    };
-    return builder;
-}
-// ---------------------------------------------------------------------------
-// Compilation: resolve positions, estimate durations
-// ---------------------------------------------------------------------------
-/**
- * Compile builder entries into an immutable Timeline object.
- *
- * Resolves all positions, estimates durations, and sorts callbacks.
- *
- * @param entries - Accumulated builder entries (tracks, labels, callbacks).
- * @returns Compiled Timeline with init, step, values, done, and firedCallbacks.
- * @throws Error if a position references an unknown label or has invalid syntax.
+ * Build a definition with `timeline()`, then advance its immutable state in a
+ * TEA update loop with `Timeline.step()`.
  */
-function compile(entries) {
-    const tracks = [];
-    const callbacks = [];
-    const labels = new Map();
-    let prevStartMs = 0;
-    let prevEndMs = 0;
-    for (const entry of entries) {
-        const cursor = { prevStartMs, prevEndMs, labels };
-        switch (entry.kind) {
-            case 'label': {
-                labels.set(entry.name, prevEndMs);
-                break;
-            }
-            case 'call': {
-                const atMs = resolvePosition(entry.position, cursor);
-                callbacks.push({ name: entry.name, atMs });
-                // Callbacks don't move the cursor
-                break;
-            }
-            case 'track': {
-                const startMs = resolvePosition(entry.position, cursor);
-                const { def } = entry;
-                let resolved;
-                if (def.type === 'tween') {
-                    resolved = {
-                        name: entry.name,
-                        startMs,
-                        estimatedDurationMs: def.duration,
-                        trackType: 'tween',
-                        from: def.from,
-                        to: def.to,
-                        tweenDuration: def.duration,
-                        tweenEase: def.ease ?? EASINGS.easeOutCubic,
-                    };
-                }
-                else {
-                    const springConfig = resolveSpringConfig(def.spring);
-                    const estDuration = estimateSpringDuration(def.from, def.to, springConfig);
-                    resolved = {
-                        name: entry.name,
-                        startMs,
-                        estimatedDurationMs: estDuration,
-                        trackType: 'spring',
-                        from: def.from,
-                        to: def.to,
-                        springConfig,
-                    };
-                }
-                if (tracks.some(t => t.name === entry.name)) {
-                    throw new Error(`Timeline: duplicate track name "${entry.name}"`);
-                }
-                tracks.push(resolved);
-                prevStartMs = startMs;
-                prevEndMs = startMs + resolved.estimatedDurationMs;
-                break;
-            }
-        }
-    }
-    // Sort callbacks by time for efficient checking
-    const sortedCallbacks = [...callbacks].sort((a, b) => a.atMs - b.atMs);
-    const trackNames = tracks.map((t) => t.name);
-    const estimatedDurationMs = tracks.reduce((max, t) => Math.max(max, t.startMs + t.estimatedDurationMs), 0);
-    return {
-        estimatedDurationMs,
-        trackNames,
-        init() {
-            const trackStates = {};
-            for (const t of tracks) {
-                trackStates[t.name] = {
-                    type: t.trackType,
-                    started: false,
-                    currentValue: t.from,
-                    done: false,
-                };
-            }
-            return { elapsedMs: 0, tracks: trackStates };
-        },
-        step(state, dt) {
-            if (!Number.isFinite(dt) || dt < 0) {
-                throw new Error(`Timeline: dt must be a finite non-negative number, got ${String(dt)}`);
-            }
-            const dtMs = dt * 1000;
-            const elapsedMs = state.elapsedMs + dtMs;
-            const nextTracks = {};
-            for (const t of tracks) {
-                const prev = must(state.tracks[t.name]);
-                // Not started yet
-                if (elapsedMs < t.startMs) {
-                    nextTracks[t.name] = prev;
-                    continue;
-                }
-                // Already done
-                if (prev.done) {
-                    nextTracks[t.name] = prev;
-                    continue;
-                }
-                // First frame — initialize animation state
-                if (!prev.started) {
-                    if (t.trackType === 'spring') {
-                        const spring = createSpringState(t.from);
-                        const stepped = springStep(spring, t.to, must(t.springConfig), dt);
-                        nextTracks[t.name] = {
-                            type: 'spring',
-                            started: true,
-                            spring: stepped,
-                            currentValue: stepped.value,
-                            done: stepped.done,
-                        };
-                    }
-                    else {
-                        const tween = createTweenState(t.from);
-                        const config = resolveTweenConfig({
-                            from: t.from,
-                            to: t.to,
-                            duration: must(t.tweenDuration),
-                            ease: t.tweenEase,
-                        });
-                        const stepped = tweenStep(tween, config, dtMs);
-                        nextTracks[t.name] = {
-                            type: 'tween',
-                            started: true,
-                            tween: stepped,
-                            currentValue: stepped.value,
-                            done: stepped.done,
-                        };
-                    }
-                    continue;
-                }
-                // Ongoing — step the animation
-                if (t.trackType === 'spring') {
-                    const stepped = springStep(must(prev.spring), t.to, must(t.springConfig), dt);
-                    nextTracks[t.name] = {
-                        ...prev,
-                        spring: stepped,
-                        currentValue: stepped.value,
-                        done: stepped.done,
-                    };
-                }
-                else {
-                    const config = resolveTweenConfig({
-                        from: t.from,
-                        to: t.to,
-                        duration: must(t.tweenDuration),
-                        ease: t.tweenEase,
-                    });
-                    const stepped = tweenStep(must(prev.tween), config, dtMs);
-                    nextTracks[t.name] = {
-                        ...prev,
-                        tween: stepped,
-                        currentValue: stepped.value,
-                        done: stepped.done,
-                    };
-                }
-            }
-            return { elapsedMs, tracks: nextTracks };
-        },
-        values(state) {
-            const result = {};
-            for (const name of trackNames) {
-                result[name] = must(state.tracks[name]).currentValue;
-            }
-            return result;
-        },
-        done(state) {
-            return trackNames.every((name) => must(state.tracks[name]).done);
-        },
-        firedCallbacks(prev, next) {
-            const fired = [];
-            for (const cb of sortedCallbacks) {
-                // A callback fires when elapsed crosses its trigger point.
-                // For callbacks at time 0, fire on the first step (prev=0, next>0).
-                const prevBefore = cb.atMs === 0 ? prev.elapsedMs === 0 && next.elapsedMs > 0
-                    : prev.elapsedMs < cb.atMs && next.elapsedMs >= cb.atMs;
-                if (prevBefore) {
-                    fired.push(cb.name);
-                }
-            }
-            return fired;
-        },
-    };
-}
+export { timeline } from './timeline-builder.js';
 //# sourceMappingURL=timeline.js.map

package/dist/timeline.js.map

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

package/dist/types.d.ts

@@ -3,124 +3,8 @@ import type { Middleware } from './eventbus.js';
 import type { RenderPipeline } from './pipeline/pipeline.js';
 import type { SurfaceBudgetThresholds } from './surface-budget.js';
 import type { ViewOutput } from './view-output.js';
-/** Represent a keyboard input event with key name and modifier flags. */
-export interface KeyMsg {
-    /** Discriminant tag identifying this as a keyboard message. */
-    readonly type: 'key';
-    /** Key name (e.g. `"a"`, `"enter"`, `"up"`, `"space"`). */
-    readonly key: string;
-    /** Whether the Ctrl modifier was held. */
-    readonly ctrl: boolean;
-    /** Whether the Alt/Option modifier was held. */
-    readonly alt: boolean;
-    /** Whether the Shift modifier was held. */
-    readonly shift: boolean;
-}
-/** Represent a terminal resize event with new dimensions. */
-export interface ResizeMsg {
-    /** Discriminant tag identifying this as a resize message. */
-    readonly type: 'resize';
-    /** New terminal width in columns. */
-    readonly columns: number;
-    /** New terminal height in rows. */
-    readonly rows: number;
-}
-/** Represent a system animation pulse event. */
-export interface PulseMsg {
-    /** Discriminant tag identifying this as a pulse message. */
-    readonly type: 'pulse';
-    /** Time delta in seconds since the last pulse. */
-    readonly dt: number;
-}
-/** Mouse button; `"none"` covers scroll and unbuttoned motion. */
-export type MouseButton = 'left' | 'middle' | 'right' | 'none';
-/** Mouse action. */
-export type MouseAction = 'press' | 'release' | 'move' | 'scroll-up' | 'scroll-down';
-/** SGR mouse tracking mode. */
-export type MouseTrackingMode = 'press' | 'drag' | 'any';
-/** Mouse input event. */
-export interface MouseMsg {
-    /** Discriminant tag identifying this as a mouse message. */
-    readonly type: 'mouse';
-    /** Which mouse button is involved (or `"none"` for scroll/motion). */
-    readonly button: MouseButton;
-    /** The mouse action performed. */
-    readonly action: MouseAction;
-    /** 0-based column position. */
-    readonly col: number;
-    /** 0-based row position. */
-    readonly row: number;
-    /** Whether the Shift modifier was held. */
-    readonly shift: boolean;
-    /** Whether the Alt/Option modifier was held. */
-    readonly alt: boolean;
-    /** Whether the Ctrl modifier was held. */
-    readonly ctrl: boolean;
-}
-export declare function isKeyMsg(msg: unknown): msg is KeyMsg;
-export declare function isResizeMsg(msg: unknown): msg is ResizeMsg;
-export declare function isPulseMsg(msg: unknown): msg is PulseMsg;
-export declare function isMouseMsg(msg: unknown): msg is MouseMsg;
-/** Sentinel symbol signaling that the application should quit. */
-export declare const QUIT: unique symbol;
-/** The type of the {@link QUIT} sentinel symbol. */
-export type QuitSignal = typeof QUIT;
-/** Disposable cleanup handle returned by long-lived command effects. */
-export interface CmdDisposable {
-    dispose(): void;
-}
-/** Cleanup forms a command may return after installing a long-lived effect. */
-export type CmdCleanup = CmdDisposable | (() => void);
-/** Final output a command may resolve to. */
-export type CmdResult<M> = M | QuitSignal | CmdCleanup | undefined;
-/** Narrow an unknown value to a disposable command handle. */
-export declare function isCmdDisposable(value: unknown): value is CmdDisposable;
-/** Narrow an unknown value to a supported command cleanup form. */
-export declare function isCmdCleanup(value: unknown): value is CmdCleanup;
-/**
- * A side-effect function that can emit messages back to the application.
- *
- * Receive an `emit` callback for dispatching intermediate messages during
- * execution. It may resolve synchronously or asynchronously to:
- * - a final message
- * - a {@link QuitSignal}
- * - a cleanup handle/function for a long-lived effect
- * - `void`
- *
- * @template M - Application message type.
- */
-export type Cmd<M> = (emit: (msg: M) => void, capabilities: CmdCapabilities) => CmdResult<M> | Promise<CmdResult<M>>;
-/** Capabilities provided to commands by the runtime. */
-export interface CmdCapabilities {
-    /**
-     * Subscribe to the system animation pulse.
-     * Returns a dispose function.
-     */
-    onPulse(handler: (dt: number) => void): CmdDisposable;
-    /** Sleep for a bounded amount of time using the runtime clock. */
-    sleep?(ms: number): Promise<void>;
-    /** Yield to the next microtask using the runtime clock. */
-    defer?(): Promise<void>;
-    /** Read the current wall-clock time from the runtime clock. */
-    now?(): number;
-}
-/** Severity of a runtime issue surfaced by the framework itself. */
-export type RuntimeIssueLevel = 'warning' | 'error';
-/** Origin of a runtime issue surfaced by the framework itself. */
-export type RuntimeIssueSource = 'command' | 'eventbus' | 'runtime';
-/** Framework-level issue routed alongside normal app messages when supported. */
-export interface RuntimeIssue {
-    /** Warning or error severity. */
-    readonly level: RuntimeIssueLevel;
-    /** Subsystem that surfaced the issue. */
-    readonly source: RuntimeIssueSource;
-    /** Human-readable issue text. */
-    readonly message: string;
-    /** Runtime clock timestamp for deterministic routing. */
-    readonly atMs: number;
-    /** Original thrown value when available. */
-    readonly error?: unknown;
-}
+import type { KeyMsg, MouseMsg, MouseTrackingMode, PulseMsg, ResizeMsg } from './runtime-messages.js';
+import type { Cmd, RuntimeIssue } from './runtime-commands.js';
 /**
  * TEA (The Elm Architecture) application interface.
  *
@@ -186,4 +70,6 @@ export interface RunOptions<M = unknown> {
     /** Optional BCSS stylesheet string. */
     css?: string;
 }
+export * from './runtime-commands.js';
+export * from './runtime-messages.js';
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EACV,MAAM,EACN,QAAQ,EACR,iBAAiB,EACjB,QAAQ,EACR,SAAS,EACV,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAI/D;;;;;;;;GAQG;AACH,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,KAAK;IACnC;;;;OAIG;IACH,IAAI,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAE1B;;;;;;OAMG;IACH,MAAM,CACJ,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,CAAC,EACjD,KAAK,EAAE,KAAK,GACX,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAErB;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,CAAC;IAE/B;;;;;OAKG;IACH,iBAAiB,CAAC,CAAC,KAAK,EAAE,YAAY,GAAG,CAAC,GAAG,SAAS,CAAC;CACxD;AAID,2BAA2B;AAC3B,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,oDAAoD;IACpD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kCAAkC;IAClC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qDAAqD;IACrD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qEAAqE;IACrE,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,qDAAqD;IACrD,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9B,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IACvD,0EAA0E;IAC1E,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC;;;OAGG;IACH,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}

package/dist/types.js

@@ -1,33 +1,3 @@
-// --- Type guards ---
-export function isKeyMsg(msg) {
-    return messageType(msg) === 'key';
-}
-export function isResizeMsg(msg) {
-    return messageType(msg) === 'resize';
-}
-export function isPulseMsg(msg) {
-    return messageType(msg) === 'pulse';
-}
-export function isMouseMsg(msg) {
-    return messageType(msg) === 'mouse';
-}
-function messageType(msg) {
-    if (typeof msg !== 'object' || msg === null || !('type' in msg))
-        return undefined;
-    return msg.type;
-}
-// --- Commands ---
-/** Sentinel symbol signaling that the application should quit. */
-export const QUIT = Symbol('QUIT');
-/** Narrow an unknown value to a disposable command handle. */
-export function isCmdDisposable(value) {
-    return typeof value === 'object'
-        && value !== null
-        && 'dispose' in value
-        && typeof value.dispose === 'function';
-}
-/** Narrow an unknown value to a supported command cleanup form. */
-export function isCmdCleanup(value) {
-    return typeof value === 'function' || isCmdDisposable(value);
-}
+export * from './runtime-commands.js';
+export * from './runtime-messages.js';
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAsEA,sBAAsB;AAEtB,MAAM,UAAU,QAAQ,CAAC,GAAY;IACnC,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC;AACtC,CAAC;AAED,SAAS,WAAW,CAAC,GAAY;IAC/B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAClF,OAAO,GAAG,CAAC,IAAI,CAAC;AAClB,CAAC;AAED,mBAAmB;AAEnB,kEAAkE;AAClE,MAAM,CAAC,MAAM,IAAI,GAAkB,MAAM,CAAC,MAAM,CAAC,CAAC;AAgBlD,8DAA8D;AAC9D,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ;WAC3B,KAAK,KAAK,IAAI;WACd,SAAS,IAAI,KAAK;WAClB,OAAO,KAAK,CAAC,OAAO,KAAK,UAAU,CAAC;AAC3C,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,UAAU,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA2FA,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flyingrobots/bijou-tui",
-  "version": "7.2.0",
+  "version": "8.0.0-rc.1",
   "description": "TEA runtime for terminal UIs — model/update/view with keyboard input, alt screen, and layout helpers.",
   "type": "module",
   "sideEffects": false,
@@ -24,10 +24,10 @@
     "lint": "tsc --noEmit"
   },
   "dependencies": {
-    "@flyingrobots/bijou-i18n": "7.2.0"
+    "@flyingrobots/bijou-i18n": "8.0.0-rc.1"
   },
   "peerDependencies": {
-    "@flyingrobots/bijou": "7.2.0"
+    "@flyingrobots/bijou": "8.0.0-rc.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",