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

package/dist/driver.js

@@ -1,419 +1,5 @@
-import { isCmdCleanup, isResizeMsg, QUIT } from './types.js';
-import { createEventBus } from './eventbus.js';
-import { parseKey, parseMouse } from './keys.js';
-import { resolveClock, sleep } from '@flyingrobots/bijou';
-import { installBCSSResolver } from './css/install.js';
-import { normalizeViewOutput } from './view-output.js';
-class RuntimeState {
-    running = true;
-    tornDown = false;
-}
-// Implementation
-function isStopped(state) { return state.tornDown === true || state.running !== true; }
-function mouseMsg(button, action, col, row, options = {}) {
-    return {
-        type: 'mouse',
-        button,
-        action,
-        col,
-        row,
-        shift: options.shift ?? false,
-        alt: options.alt ?? false,
-        ctrl: options.ctrl ?? false,
-    };
-}
-function mouseScriptStep(mouse, delay) {
-    if (delay === undefined)
-        return { mouse };
-    return { mouse, delay };
-}
-/** Create a scripted mouse-move step for {@link runScript} or {@link TestHarness.run}. */
-export function mouseMove(col, row, options = {}) {
-    return mouseScriptStep(mouseMsg(options.button ?? 'none', 'move', col, row, options), options.delay);
-}
-/** Create a scripted mouse-press step for {@link runScript} or {@link TestHarness.run}. */
-export function mousePress(button, col, row, options = {}) {
-    return mouseScriptStep(mouseMsg(button, 'press', col, row, options), options.delay);
-}
-/** Create a scripted mouse-release step for {@link runScript} or {@link TestHarness.run}. */
-export function mouseRelease(button, col, row, options = {}) {
-    return mouseScriptStep(mouseMsg(button, 'release', col, row, options), options.delay);
-}
-/** Create a scripted mouse-wheel step for {@link runScript} or {@link TestHarness.run}. */
-export function mouseWheel(direction, col, row, options = {}) {
-    const action = direction === 'up' ? 'scroll-up' : 'scroll-down';
-    return mouseScriptStep(mouseMsg('none', action, col, row, options), options.delay);
-}
-/** Parse an SGR mouse escape sequence into a scripted mouse step. */
-export function sgrMouse(raw, delay) {
-    const mouse = parseMouse(raw);
-    if (mouse == null) {
-        throw new Error(`sgrMouse: invalid SGR mouse sequence: ${JSON.stringify(raw)}`);
-    }
-    return mouseScriptStep(mouse, delay);
-}
-function initialSize(ctx) {
-    return {
-        width: Math.max(0, Math.floor(ctx?.runtime.columns ?? 80)),
-        height: Math.max(0, Math.floor(ctx?.runtime.rows ?? 24)),
-    };
-}
-function normalizeFrame(app, model, size) {
-    return normalizeViewOutput(app.view(model), size).surface;
-}
-/**
- * Start a TEA app inside an inspectable test harness.
- *
- * The harness renders the initial frame, settles init commands, and then lets
- * callers feed steps one at a time while asserting against snapshots, handled
- * messages, command outcomes, and cleanup disposal.
- */
-export async function testRuntime(app, options) {
-    const clock = resolveClock(options?.ctx);
-    const start = clock.now();
-    const frames = [];
-    const snapshots = [];
-    const handledMessages = [];
-    const emittedMessages = [];
-    const commandRecords = [];
-    const bus = createEventBus({ clock });
-    const ctx = options?.ctx;
-    let commandId = 0;
-    const runtimeState = new RuntimeState();
-    let model;
-    let currentSize = initialSize(ctx);
-    if (ctx != null) {
-        installBCSSResolver(ctx, options?.css);
-    }
-    if (options?.pulseFps !== false) {
-        bus.startPulse(options?.pulseFps ?? ctx?.runtime.refreshRate ?? 60);
-    }
-    function latestSnapshot() {
-        const snapshot = snapshots.at(-1);
-        if (snapshot === undefined)
-            throw new Error('testRuntime: no snapshots captured');
-        return snapshot;
-    }
-    function captureSnapshot(cause, message) {
-        const frame = normalizeFrame(app, model, currentSize);
-        frames.push(frame);
-        options?.onFrame?.(frame, frames.length - 1);
-        const snapshot = {
-            index: snapshots.length,
-            cause,
-            message,
-            model,
-            frame,
-        };
-        snapshots.push(snapshot);
-        return snapshot;
-    }
-    function wrapCommand(cmd, source, triggerIndex) {
-        const record = {
-            id: commandId++,
-            source,
-            triggerIndex,
-            emitted: [],
-            resolution: 'pending',
-            cleanedUp: false,
-            settled: false,
-        };
-        commandRecords.push(record);
-        return async (emit, caps) => {
-            const trackedEmit = (msg) => {
-                record.emitted.push(msg);
-                emittedMessages.push(msg);
-                emit(msg);
-            };
-            try {
-                const result = await cmd(trackedEmit, caps);
-                record.settled = true;
-                if (isCmdCleanup(result)) {
-                    record.resolution = 'cleanup';
-                    record.result = result;
-                    if (typeof result === 'function') {
-                        return () => {
-                            record.cleanedUp = true;
-                            result();
-                        };
-                    }
-                    return {
-                        dispose() {
-                            record.cleanedUp = true;
-                            result.dispose();
-                        },
-                    };
-                }
-                if (result === QUIT) {
-                    record.resolution = 'quit';
-                    return result;
-                }
-                if (result !== undefined) {
-                    record.resolution = 'message';
-                    record.result = result;
-                    emittedMessages.push(result);
-                    return result;
-                }
-                record.resolution = 'void';
-                return undefined;
-            }
-            catch (error) {
-                record.settled = true;
-                record.resolution = 'rejected';
-                record.result = error;
-                throw error;
-            }
-        };
-    }
-    async function settle() {
-        await bus.drain();
-        return latestSnapshot();
-    }
-    async function processStep(step) {
-        if (isStopped(runtimeState))
-            return latestSnapshot();
-        if (step.delay && step.delay > 0) {
-            await sleep(clock, step.delay);
-        }
-        if (isStopped(runtimeState))
-            return latestSnapshot();
-        if ('key' in step) {
-            bus.emit(parseKey(step.key));
-        }
-        else if ('pulse' in step) {
-            bus.emit({ type: 'pulse', dt: step.pulse.dt });
-        }
-        else if ('resize' in step) {
-            const resizeMsg = {
-                type: 'resize',
-                columns: step.resize.columns,
-                rows: step.resize.rows,
-            };
-            bus.emit(resizeMsg);
-        }
-        else if ('mouse' in step) {
-            bus.emit(step.mouse);
-        }
-        else if ('msg' in step) {
-            bus.emit(step.msg);
-        }
-        else {
-            const _exhaustive = step;
-            throw new Error(`runScript: unhandled script step variant: ${JSON.stringify(_exhaustive)}`);
-        }
-        return settle();
-    }
-    async function teardown() {
-        if (runtimeState.tornDown)
-            return;
-        runtimeState.tornDown = true;
-        runtimeState.running = false;
-        bus.stopPulse();
-        bus.dispose();
-        await Promise.resolve();
-    }
-    bus.onQuit(() => {
-        runtimeState.running = false;
-    });
-    bus.on((msg) => {
-        if (!runtimeState.running)
-            return;
-        handledMessages.push(msg);
-        const [nextModel, cmds] = app.update(msg, model);
-        model = nextModel;
-        if (isResizeMsg(msg)) {
-            currentSize = {
-                width: Math.max(0, msg.columns),
-                height: Math.max(0, msg.rows),
-            };
-        }
-        captureSnapshot('update', msg);
-        const triggerIndex = handledMessages.length - 1;
-        for (const cmd of cmds) {
-            bus.runCmd(wrapCommand(cmd, 'update', triggerIndex));
-        }
-    });
-    try {
-        const [initModel, initCmds] = app.init();
-        model = initModel;
-        captureSnapshot('init');
-        for (const cmd of initCmds) {
-            bus.runCmd(wrapCommand(cmd, 'init', null));
-        }
-        await bus.drain();
-    }
-    catch (error) {
-        await teardown();
-        throw error;
-    }
-    return {
-        get model() {
-            return model;
-        },
-        get frame() {
-            return latestSnapshot().frame;
-        },
-        get frames() {
-            return frames;
-        },
-        get snapshots() {
-            return snapshots;
-        },
-        get messages() {
-            return handledMessages;
-        },
-        get emittedMessages() {
-            return emittedMessages;
-        },
-        get commands() {
-            return commandRecords;
-        },
-        get elapsed() {
-            return clock.now() - start;
-        },
-        get running() {
-            return runtimeState.running && !runtimeState.tornDown;
-        },
-        snapshot: latestSnapshot,
-        settle,
-        step: processStep,
-        async run(steps) {
-            for (const step of steps) {
-                if (isStopped(runtimeState))
-                    break;
-                await processStep(step);
-            }
-            return settle();
-        },
-        press(key, delay = 0) {
-            return processStep({ key, delay });
-        },
-        resize(columns, rows, delay = 0) {
-            return processStep({ resize: { columns, rows }, delay });
-        },
-        pulse(dt, delay = 0) {
-            return processStep({ pulse: { dt }, delay });
-        },
-        mouse(message, delay = 0) {
-            return processStep({ mouse: message, delay });
-        },
-        emit(msg, delay = 0) {
-            return processStep({ msg, delay });
-        },
-        teardown,
-    };
-}
-/**
- * Run a TEA app with a scripted key sequence.
- *
- * Internally creates an EventBus and feeds parsed keys from the script.
- * Captures all frames rendered via `view()`. Returns the final model
- * and all frames for assertion or GIF generation.
- *
- * The app quits when:
- * - A command returns QUIT
- * - All script steps are exhausted (auto-quits)
- *
- * Between steps the driver waits for the event bus to go idle, so command
- * chains settle deterministically without relying on microtask-only yields.
- *
- * @template Model - The application model type.
- * @template M     - The message (action) type for the TEA update cycle.
- * @param app     - The TEA application definition (init, update, view).
- * @param steps   - Ordered key events to feed into the app.
- * @param options - Optional callbacks and runtime configuration.
- * @returns The final model, all rendered frames, and elapsed time.
- */
-export async function runScript(app, steps, options) {
-    const clock = resolveClock(options?.ctx);
-    const start = clock.now();
-    const frames = [];
-    const bus = createEventBus({ clock });
-    const ctx = options?.ctx;
-    if (ctx != null) {
-        installBCSSResolver(ctx, options?.css);
-    }
-    const [initModel, initCmds] = app.init();
-    let model = initModel;
-    const runtimeState = new RuntimeState();
-    let currentSize = initialSize(ctx);
-    if (options?.pulseFps !== false) {
-        bus.startPulse(options?.pulseFps ?? ctx?.runtime.refreshRate ?? 60);
-    }
-    function shutdown() {
-        runtimeState.running = false;
-    }
-    bus.onQuit(shutdown);
-    bus.on((msg) => {
-        if (!runtimeState.running)
-            return;
-        const [newModel, cmds] = app.update(msg, model);
-        model = newModel;
-        if (isResizeMsg(msg)) {
-            currentSize = {
-                width: Math.max(0, msg.columns),
-                height: Math.max(0, msg.rows),
-            };
-        }
-        const frame = normalizeFrame(app, model, currentSize);
-        frames.push(frame);
-        options?.onFrame?.(frame, frames.length - 1);
-        for (const cmd of cmds) {
-            bus.runCmd(cmd);
-        }
-    });
-    try {
-        const initFrame = normalizeFrame(app, model, currentSize);
-        frames.push(initFrame);
-        options?.onFrame?.(initFrame, 0);
-        for (const cmd of initCmds) {
-            bus.runCmd(cmd);
-        }
-        await bus.drain();
-        for (const step of steps) {
-            if (isStopped(runtimeState))
-                break;
-            if (step.delay && step.delay > 0) {
-                await sleep(clock, step.delay);
-            }
-            if (isStopped(runtimeState))
-                break;
-            if ('key' in step) {
-                bus.emit(parseKey(step.key));
-            }
-            else if ('pulse' in step) {
-                bus.emit({ type: 'pulse', dt: step.pulse.dt });
-            }
-            else if ('resize' in step) {
-                const resizeMsg = {
-                    type: 'resize',
-                    columns: step.resize.columns,
-                    rows: step.resize.rows,
-                };
-                bus.emit(resizeMsg);
-            }
-            else if ('mouse' in step) {
-                bus.emit(step.mouse);
-            }
-            else if ('msg' in step) {
-                bus.emit(step.msg);
-            }
-            else {
-                const _exhaustive = step;
-                throw new Error(`runScript: unhandled script step variant: ${JSON.stringify(_exhaustive)}`);
-            }
-            await bus.drain();
-        }
-        await bus.drain();
-        return {
-            model,
-            frames,
-            elapsed: clock.now() - start,
-        };
-    }
-    finally {
-        bus.stopPulse();
-        bus.dispose();
-    }
-}
+/** Stable scripted-driver facade over focused interaction modules. */
+export { mouseMove, mousePress, mouseRelease, mouseWheel, sgrMouse, } from './driver-mouse.js';
+export { testRuntime } from './driver-harness.js';
+export { runScript } from './driver-script.js';
 //# sourceMappingURL=driver.js.map

package/dist/driver.js.map

@@ -1 +1 @@
-{"version":3,"file":"driver.js","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,EACL,SAAS,EACT,UAAU,EACV,YAAY,EACZ,UAAU,EACV,QAAQ,GACT,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/eventbus-command.d.ts

@@ -0,0 +1,6 @@
+import type { Cmd } from './types.js';
+import type { EventBusDisposable } from './eventbus-contract.js';
+import type { EventBusState } from './eventbus-state.js';
+export declare function runCommand<M>(state: EventBusState<M>, cmd: Cmd<M>, onPulse: (handler: (dt: number) => void) => EventBusDisposable): void;
+export declare function drainCommands<M>(state: EventBusState<M>): Promise<void>;
+//# sourceMappingURL=eventbus-command.d.ts.map

package/dist/eventbus-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventbus-command.d.ts","sourceRoot":"","sources":["../src/eventbus-command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,GAAG,EAIJ,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAU,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQzD,wBAAgB,UAAU,CAAC,CAAC,EAC1B,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EACX,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,KAAK,kBAAkB,GAC7D,IAAI,CAiCN;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAOvE"}

package/dist/eventbus-command.js

@@ -0,0 +1,94 @@
+import { defer, sleep } from '@flyingrobots/bijou';
+import { isCmdCleanup, QUIT } from './types.js';
+import { emitMessage, reportBackpressureIfNeeded, resolveIdleIfNeeded, } from './eventbus-state.js';
+import { invokeSubscribers, safeReport } from './eventbus-report.js';
+export function runCommand(state, cmd, onPulse) {
+    if (state.disposed)
+        return;
+    state.pendingCommands += 1;
+    reportBackpressureIfNeeded(state);
+    const emit = (message) => {
+        emitMessage(state, message);
+    };
+    const caps = {
+        onPulse,
+        sleep: (ms) => sleep(state.clock, ms),
+        defer: () => defer(state.clock),
+        now: () => state.clock.now(),
+    };
+    let commandPromise;
+    try {
+        commandPromise = Promise.resolve(cmd(emit, caps));
+    }
+    catch (error) {
+        commandPromise = Promise.reject(error instanceof Error ? error : new Error(String(error)));
+    }
+    commandPromise
+        .then((result) => {
+        resolveCommandResult(state, result);
+    })
+        .catch((error) => {
+        reportCommandRejection(state, error);
+    })
+        .finally(() => {
+        settleCommand(state);
+    });
+}
+export function drainCommands(state) {
+    if (state.disposed || state.pendingCommands === 0) {
+        return Promise.resolve();
+    }
+    return new Promise((resolve) => {
+        state.idleResolvers.add(resolve);
+    });
+}
+function resolveCommandResult(state, result) {
+    if (isCmdCleanup(result)) {
+        const cleanup = normalizeCleanup(result);
+        if (state.disposed)
+            cleanup.dispose();
+        else
+            state.activeCommandCleanups.add(cleanup);
+        return;
+    }
+    if (state.disposed)
+        return;
+    if (result === QUIT) {
+        invokeSubscribers(state, state.quitHandlers, '[EventBus] Quit subscriber threw:', (handler) => {
+            handler();
+        });
+    }
+    else if (result !== undefined) {
+        emitMessage(state, result);
+    }
+}
+function reportCommandRejection(state, error) {
+    if (state.disposed)
+        return;
+    try {
+        if (state.options?.onCommandRejected != null) {
+            state.options.onCommandRejected(error);
+        }
+        else {
+            safeReport(state, '[EventBus] Command rejected:', error);
+        }
+    }
+    catch (reportError) {
+        safeReport(state, state.options?.onCommandRejected != null
+            ? '[EventBus] onCommandRejected handler threw:'
+            : '[EventBus] onError handler threw while reporting a command rejection:', reportError);
+        safeReport(state, '[EventBus] Original command rejection:', error);
+    }
+}
+function settleCommand(state) {
+    state.pendingCommands = Math.max(0, state.pendingCommands - 1);
+    if (state.pendingCommands < state.backpressureThreshold) {
+        state.backpressureReported = false;
+    }
+    if (!state.disposed)
+        resolveIdleIfNeeded(state);
+}
+function normalizeCleanup(cleanup) {
+    return typeof cleanup === 'function' ? { dispose: cleanup } : cleanup;
+}
+//# sourceMappingURL=eventbus-command.js.map

package/dist/eventbus-command.js.map

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

package/dist/eventbus-contract.d.ts

@@ -0,0 +1,41 @@
+import type { IOPort } from '@flyingrobots/bijou';
+import type { Cmd, KeyMsg, MouseMsg, PulseMsg, ResizeMsg } from './types.js';
+import type { CommandQueueDiagnostics } from './eventbus-options.js';
+/** Built-in input messages plus an application-defined message type. */
+export type BusMsg<M> = KeyMsg | ResizeMsg | MouseMsg | PulseMsg | M;
+/** Intercepts a message and may continue the chain with `next`. */
+export type Middleware<M> = (msg: BusMsg<M>, next: (msg: BusMsg<M>) => void) => void;
+/** Internal disposable shared by public event-bus operations. */
+export interface EventBusDisposable {
+    dispose(): void;
+}
+/** Central typed event stream for TUI applications. */
+export interface EventBus<M> {
+    /** Subscribe to every emitted message. */
+    on(handler: (msg: BusMsg<M>) => void): EventBusDisposable;
+    /** Emit one message through middleware to all subscribers. */
+    emit(msg: BusMsg<M>): void;
+    /** Connect raw input, resize, and optional data sources. */
+    connectIO(io: IOPort, options?: {
+        mouse?: boolean;
+    }): EventBusDisposable;
+    /** Run one command and route its result back through the bus. */
+    runCmd(cmd: Cmd<M>): void;
+    /** Subscribe to the command quit signal. */
+    onQuit(handler: () => void): EventBusDisposable;
+    /** Start the animation heartbeat. */
+    startPulse(fps?: number): void;
+    /** Stop the animation heartbeat. */
+    stopPulse(): void;
+    /** Subscribe to heartbeat deltas. */
+    onPulse(handler: (dt: number) => void): EventBusDisposable;
+    /** Add one ordered message middleware. */
+    use(middleware: Middleware<M>): EventBusDisposable;
+    /** Resolve once all in-flight commands settle. */
+    drain(): Promise<void>;
+    /** Read current command queue diagnostics. */
+    getCommandDiagnostics(): CommandQueueDiagnostics;
+    /** Disconnect sources and release retained resources. */
+    dispose(): void;
+}
+//# sourceMappingURL=eventbus-contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"eventbus-contract.d.ts","sourceRoot":"","sources":["../src/eventbus-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EACV,GAAG,EACH,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,SAAS,EACV,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAE/B,wEAAwE;AACxE,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,CAAC,CAAC;AAErE,mEAAmE;AACnE,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAC1B,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,EACd,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,KAC3B,IAAI,CAAC;AAEV,iEAAiE;AACjE,MAAM,WAAW,kBAAkB;IACjC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,uDAAuD;AACvD,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,0CAA0C;IAC1C,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,kBAAkB,CAAC;IAE1D,8DAA8D;IAC9D,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAE3B,4DAA4D;IAC5D,SAAS,CACP,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAC5B,kBAAkB,CAAC;IAEtB,iEAAiE;IACjE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAE1B,4CAA4C;IAC5C,MAAM,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,kBAAkB,CAAC;IAEhD,qCAAqC;IACrC,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B,oCAAoC;IACpC,SAAS,IAAI,IAAI,CAAC;IAElB,qCAAqC;IACrC,OAAO,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,kBAAkB,CAAC;IAE3D,0CAA0C;IAC1C,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC;IAEnD,kDAAkD;IAClD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,8CAA8C;IAC9C,qBAAqB,IAAI,uBAAuB,CAAC;IAEjD,yDAAyD;IACzD,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/eventbus-contract.js

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

package/dist/eventbus-contract.js.map

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

package/dist/eventbus-create.d.ts

@@ -0,0 +1,5 @@
+import type { EventBus } from './eventbus-contract.js';
+import type { CreateEventBusOptions } from './eventbus-options.js';
+/** Create a typed event bus for one TUI runtime. */
+export declare function createEventBus<M>(options?: CreateEventBusOptions): EventBus<M>;
+//# sourceMappingURL=eventbus-create.d.ts.map

package/dist/eventbus-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventbus-create.d.ts","sourceRoot":"","sources":["../src/eventbus-create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,QAAQ,EAGT,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAenE,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,QAAQ,CAAC,CAAC,CAAC,CAgDb"}