@flyingrobots/bijou-tui 0.1.0 → 0.2.0

package/dist/eventbus.js

@@ -0,0 +1,120 @@
+/**
+ * Centralized event bus for TUI applications.
+ *
+ * Unifies all input sources (keyboard, resize, commands, custom) into
+ * a single typed event stream. The TEA runtime subscribes to the bus
+ * instead of manually wiring callbacks.
+ *
+ * ```ts
+ * const bus = createEventBus<Msg>();
+ *
+ * // Connect I/O sources (keyboard + resize)
+ * bus.connectIO(ctx.io);
+ *
+ * // Subscribe to all events
+ * bus.on((msg) => {
+ *   const [model, cmds] = app.update(msg, model);
+ *   cmds.forEach(cmd => bus.runCmd(cmd));
+ * });
+ *
+ * // Emit custom events
+ * bus.emit({ type: 'tick' });
+ *
+ * // In tests — emit directly, no I/O needed
+ * bus.emit({ type: 'key', key: 'a', ctrl: false, alt: false, shift: false });
+ * ```
+ */
+import { QUIT } from './types.js';
+import { parseKey } from './keys.js';
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+export function createEventBus() {
+    const subscribers = new Set();
+    const quitHandlers = new Set();
+    const disposables = [];
+    let disposed = false;
+    function emit(msg) {
+        if (disposed)
+            return;
+        for (const handler of subscribers) {
+            handler(msg);
+        }
+    }
+    return {
+        on(handler) {
+            subscribers.add(handler);
+            return {
+                dispose() {
+                    subscribers.delete(handler);
+                },
+            };
+        },
+        emit,
+        connectIO(io) {
+            // Keyboard input
+            const inputHandle = io.rawInput((raw) => {
+                if (disposed)
+                    return;
+                const keyMsg = parseKey(raw);
+                // Skip unknown sequences (mouse events, etc.)
+                if (keyMsg.key === 'unknown')
+                    return;
+                emit(keyMsg);
+            });
+            // Resize events
+            const resizeHandle = io.onResize((columns, rows) => {
+                if (disposed)
+                    return;
+                const msg = { type: 'resize', columns, rows };
+                emit(msg);
+            });
+            const handle = {
+                dispose() {
+                    inputHandle.dispose();
+                    resizeHandle.dispose();
+                },
+            };
+            disposables.push(handle);
+            return handle;
+        },
+        runCmd(cmd) {
+            if (disposed)
+                return;
+            void cmd(emit).then((result) => {
+                if (disposed)
+                    return;
+                if (result === QUIT) {
+                    for (const handler of quitHandlers) {
+                        handler();
+                    }
+                    return;
+                }
+                if (result !== undefined) {
+                    emit(result);
+                }
+            }).catch((err) => {
+                // Surface command rejections instead of leaving unhandled promise rejections.
+                console.error('[EventBus] Command rejected:', err);
+            });
+        },
+        onQuit(handler) {
+            quitHandlers.add(handler);
+            return {
+                dispose() {
+                    quitHandlers.delete(handler);
+                },
+            };
+        },
+        dispose() {
+            disposed = true;
+            for (const d of disposables) {
+                d.dispose();
+            }
+            disposables.length = 0;
+            subscribers.clear();
+            quitHandlers.clear();
+        },
+    };
+}
+//# sourceMappingURL=eventbus.js.map

package/dist/eventbus.js.map

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

package/dist/flex.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Flexbox-style layout for terminal UIs.
+ *
+ * Distributes available space among children using flex-grow factors,
+ * fixed basis sizes, and min/max constraints. Children can be static
+ * strings or render functions that receive their allocated dimensions.
+ *
+ * ```ts
+ * flex({ direction: 'row', width: 80, height: 24 },
+ *   { basis: 20, content: sidebar },
+ *   { flex: 1, content: (w, h) => viewport({ width: w, height: h, content: body }) },
+ * )
+ * ```
+ */
+export interface FlexOptions {
+    /** Layout direction. Default: 'row'. */
+    readonly direction?: 'row' | 'column';
+    /** Available width in columns. */
+    readonly width: number;
+    /** Available height in rows. */
+    readonly height: number;
+    /** Gap between children (in the main axis). Default: 0. */
+    readonly gap?: number;
+}
+export interface FlexChild {
+    /**
+     * Content to render. Either a static string, or a function that
+     * receives the allocated (width, height) and returns a string.
+     */
+    readonly content: string | ((width: number, height: number) => string);
+    /** Flex-grow factor. Children with flex > 0 share remaining space. Default: 0. */
+    readonly flex?: number;
+    /** Fixed size along the main axis (columns for row, rows for column). */
+    readonly basis?: number;
+    /** Minimum size along the main axis. */
+    readonly minSize?: number;
+    /** Maximum size along the main axis. */
+    readonly maxSize?: number;
+    /** Cross-axis alignment. Default: 'start'. */
+    readonly align?: 'start' | 'center' | 'end';
+}
+/**
+ * Lay out children using flexbox-style rules.
+ *
+ * Row direction: children are placed side-by-side horizontally.
+ * Column direction: children are stacked vertically.
+ *
+ * ```ts
+ * // Sidebar + main content
+ * flex({ direction: 'row', width: 80, height: 24, gap: 1 },
+ *   { basis: 20, content: sidebarContent },
+ *   { flex: 1, content: (w, h) => renderMain(w, h) },
+ * )
+ *
+ * // Header + body + footer
+ * flex({ direction: 'column', width: 80, height: 24 },
+ *   { basis: 1, content: headerLine },
+ *   { flex: 1, content: (w, h) => renderBody(w, h) },
+ *   { basis: 1, content: statusLine },
+ * )
+ * ```
+ */
+export declare function flex(options: FlexOptions, ...children: FlexChild[]): string;
+//# sourceMappingURL=flex.d.ts.map

package/dist/flex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flex.d.ts","sourceRoot":"","sources":["../src/flex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IACtC,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IACvE,kFAAkF;IAClF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;CAC7C;AAoND;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM,CAkB3E"}

package/dist/flex.js

@@ -0,0 +1,261 @@
+/**
+ * Flexbox-style layout for terminal UIs.
+ *
+ * Distributes available space among children using flex-grow factors,
+ * fixed basis sizes, and min/max constraints. Children can be static
+ * strings or render functions that receive their allocated dimensions.
+ *
+ * ```ts
+ * flex({ direction: 'row', width: 80, height: 24 },
+ *   { basis: 20, content: sidebar },
+ *   { flex: 1, content: (w, h) => viewport({ width: w, height: h, content: body }) },
+ * )
+ * ```
+ */
+// ---------------------------------------------------------------------------
+// ANSI helpers
+// ---------------------------------------------------------------------------
+const ANSI_RE = /\x1b\[[0-9;]*m/g;
+function visualWidth(s) {
+    return s.replace(ANSI_RE, '').length;
+}
+function computeSizes(children, mainAxisTotal, crossAxisTotal, gap, isRow) {
+    if (children.length === 0)
+        return [];
+    const totalGaps = gap * (children.length - 1);
+    const available = Math.max(0, mainAxisTotal - totalGaps);
+    // First pass: allocate fixed-size children (basis or content measurement)
+    const sizes = [];
+    let usedByFixed = 0;
+    let totalFlex = 0;
+    for (const child of children) {
+        const flexGrow = child.flex ?? 0;
+        if (flexGrow > 0) {
+            sizes.push(0); // placeholder
+            totalFlex += flexGrow;
+        }
+        else if (child.basis !== undefined) {
+            const clamped = clampSize(child.basis, child.minSize, child.maxSize);
+            sizes.push(clamped);
+            usedByFixed += clamped;
+        }
+        else {
+            // Auto-size from content
+            const measured = measureContent(child.content, isRow);
+            const clamped = clampSize(measured, child.minSize, child.maxSize);
+            sizes.push(clamped);
+            usedByFixed += clamped;
+        }
+    }
+    // Second pass: distribute remaining space to flex children
+    const remaining = Math.max(0, available - usedByFixed);
+    for (let i = 0; i < children.length; i++) {
+        const flexGrow = children[i].flex ?? 0;
+        if (flexGrow > 0) {
+            const raw = totalFlex > 0 ? Math.floor((flexGrow / totalFlex) * remaining) : 0;
+            sizes[i] = clampSize(raw, children[i].minSize, children[i].maxSize);
+        }
+    }
+    return children.map((child, i) => ({
+        allocatedSize: sizes[i],
+        crossSize: crossAxisTotal,
+        child,
+    }));
+}
+function clampSize(size, min, max) {
+    let result = size;
+    if (min !== undefined)
+        result = Math.max(result, min);
+    if (max !== undefined)
+        result = Math.min(result, max);
+    return Math.max(0, result);
+}
+function measureContent(content, isRow) {
+    if (typeof content === 'function') {
+        // Can't measure a render function — treat as 0 (must use flex or basis)
+        return 0;
+    }
+    const lines = content.split('\n');
+    if (isRow) {
+        // Width = max visible line width
+        return Math.max(0, ...lines.map(visualWidth));
+    }
+    // Height = number of lines
+    return lines.length;
+}
+// ---------------------------------------------------------------------------
+// Rendering
+// ---------------------------------------------------------------------------
+function renderContent(child, width, height) {
+    if (typeof child.content === 'function') {
+        return child.content(width, height);
+    }
+    return child.content;
+}
+/**
+ * Clip/pad each content line to exact width. Does NOT pad height —
+ * that's handled by alignCross.
+ */
+function fitWidth(content, width, align = 'start') {
+    const lines = content.split('\n');
+    return lines.map((line) => {
+        const vis = visualWidth(line);
+        if (vis > width) {
+            return clipToWidth(line, width);
+        }
+        const padding = Math.max(0, width - vis);
+        switch (align) {
+            case 'start':
+                return line + ' '.repeat(padding);
+            case 'end':
+                return ' '.repeat(padding) + line;
+            case 'center': {
+                const before = Math.floor(padding / 2);
+                const after = padding - before;
+                return ' '.repeat(before) + line + ' '.repeat(after);
+            }
+            default: {
+                const _exhaustive = align;
+                throw new Error(`Unknown alignment: ${_exhaustive}`);
+            }
+        }
+    });
+}
+function clipToWidth(str, maxWidth) {
+    let visible = 0;
+    let result = '';
+    let inEscape = false;
+    for (let i = 0; i < str.length; i++) {
+        const ch = str[i];
+        if (ch === '\x1b') {
+            inEscape = true;
+            result += ch;
+            continue;
+        }
+        if (inEscape) {
+            result += ch;
+            if (ch === 'm')
+                inEscape = false;
+            continue;
+        }
+        if (visible >= maxWidth) {
+            result += '\x1b[0m';
+            break;
+        }
+        result += ch;
+        visible++;
+    }
+    return result;
+}
+/**
+ * Align content lines along the cross axis.
+ */
+function alignCross(lines, totalCrossSize, align, width) {
+    if (lines.length >= totalCrossSize)
+        return lines.slice(0, totalCrossSize);
+    const emptyLine = ' '.repeat(Math.max(0, width));
+    const padding = totalCrossSize - lines.length;
+    switch (align) {
+        case 'start':
+            return [...lines, ...Array.from({ length: padding }).fill(emptyLine)];
+        case 'end':
+            return [...Array.from({ length: padding }).fill(emptyLine), ...lines];
+        case 'center': {
+            const before = Math.floor(padding / 2);
+            const after = padding - before;
+            return [
+                ...Array.from({ length: before }).fill(emptyLine),
+                ...lines,
+                ...Array.from({ length: after }).fill(emptyLine),
+            ];
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// flex() — main API
+// ---------------------------------------------------------------------------
+/**
+ * Lay out children using flexbox-style rules.
+ *
+ * Row direction: children are placed side-by-side horizontally.
+ * Column direction: children are stacked vertically.
+ *
+ * ```ts
+ * // Sidebar + main content
+ * flex({ direction: 'row', width: 80, height: 24, gap: 1 },
+ *   { basis: 20, content: sidebarContent },
+ *   { flex: 1, content: (w, h) => renderMain(w, h) },
+ * )
+ *
+ * // Header + body + footer
+ * flex({ direction: 'column', width: 80, height: 24 },
+ *   { basis: 1, content: headerLine },
+ *   { flex: 1, content: (w, h) => renderBody(w, h) },
+ *   { basis: 1, content: statusLine },
+ * )
+ * ```
+ */
+export function flex(options, ...children) {
+    const { direction = 'row' } = options;
+    const width = Math.max(0, Math.floor(options.width));
+    const height = Math.max(0, Math.floor(options.height));
+    const gap = Math.max(0, Math.floor(options.gap ?? 0));
+    const isRow = direction === 'row';
+    const mainAxisTotal = isRow ? width : height;
+    const crossAxisTotal = isRow ? height : width;
+    if (children.length === 0)
+        return '';
+    const resolved = computeSizes(children, mainAxisTotal, crossAxisTotal, gap, isRow);
+    if (isRow) {
+        return renderRow(resolved, height, gap);
+    }
+    return renderColumn(resolved, width, height, gap);
+}
+function renderRow(items, totalHeight, gap) {
+    // Render each child into a column of lines
+    const columns = [];
+    for (const item of items) {
+        const childWidth = item.allocatedSize;
+        const rendered = renderContent(item.child, childWidth, totalHeight);
+        // In row mode, fitWidth always uses 'start' — align controls cross-axis (vertical) only
+        const widthFitted = fitWidth(rendered, childWidth);
+        const aligned = alignCross(widthFitted, totalHeight, item.child.align ?? 'start', childWidth);
+        columns.push(aligned);
+    }
+    // Compose columns side-by-side
+    const spacer = ' '.repeat(Math.max(0, gap));
+    const rows = [];
+    for (let r = 0; r < totalHeight; r++) {
+        const parts = [];
+        for (let c = 0; c < columns.length; c++) {
+            parts.push(columns[c][r]);
+        }
+        rows.push(parts.join(spacer));
+    }
+    return rows.join('\n');
+}
+function renderColumn(items, totalWidth, totalHeight, gap) {
+    const lines = [];
+    for (let i = 0; i < items.length; i++) {
+        const item = items[i];
+        const childHeight = item.allocatedSize;
+        const rendered = renderContent(item.child, totalWidth, childHeight);
+        const widthFitted = fitWidth(rendered, totalWidth, item.child.align ?? 'start');
+        const aligned = alignCross(widthFitted, childHeight, 'start', totalWidth);
+        lines.push(...aligned);
+        // Add gap between items
+        if (i < items.length - 1 && gap > 0) {
+            const spacer = ' '.repeat(Math.max(0, totalWidth));
+            for (let g = 0; g < gap; g++) {
+                lines.push(spacer);
+            }
+        }
+    }
+    // Pad to fill totalHeight if needed
+    const emptyLine = ' '.repeat(Math.max(0, totalWidth));
+    while (lines.length < totalHeight) {
+        lines.push(emptyLine);
+    }
+    return lines.slice(0, totalHeight).join('\n');
+}
+//# sourceMappingURL=flex.js.map

package/dist/flex.js.map

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

package/dist/help.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Auto-generate help views from registered keybindings.
+ *
+ * ```ts
+ * const kb = createKeyMap<Msg>()
+ *   .bind('q', 'Quit', quitMsg)
+ *   .group('Navigation', g => g
+ *     .bind('j', 'Down', downMsg)
+ *     .bind('k', 'Up', upMsg)
+ *   );
+ *
+ * helpView(kb)          // full grouped help
+ * helpShort(kb)         // single-line summary
+ * helpFor(kb, 'Nav')    // filter by group prefix
+ * ```
+ */
+import type { BindingInfo } from './keybindings.js';
+/** Anything that can list its bindings (satisfied by KeyMap). */
+export interface BindingSource {
+    bindings(): readonly BindingInfo[];
+}
+export interface HelpOptions {
+    /** Only show enabled bindings (default: true). */
+    enabledOnly?: boolean;
+    /** Filter to bindings in groups matching this prefix. */
+    groupFilter?: string;
+    /** Separator between key and description (default: "  "). */
+    separator?: string;
+    /** Title shown at the top (default: none). */
+    title?: string;
+}
+/**
+ * Full help view — grouped, multi-line.
+ *
+ * ```
+ * Navigation
+ *   j  Down
+ *   k  Up
+ *
+ * General
+ *   q  Quit
+ *   ?  Toggle help
+ * ```
+ */
+export declare function helpView(keymap: BindingSource, options?: HelpOptions): string;
+/**
+ * Short, single-line help — keys only, no groups.
+ *
+ * ```
+ * q Quit • j Down • k Up • ? Help
+ * ```
+ */
+export declare function helpShort(keymap: BindingSource, options?: Pick<HelpOptions, 'enabledOnly' | 'groupFilter'>): string;
+/**
+ * Filter help to a specific group (convenience wrapper).
+ */
+export declare function helpFor(keymap: BindingSource, groupPrefix: string, options?: HelpOptions): string;
+//# sourceMappingURL=help.d.ts.map

package/dist/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,QAAQ,IAAI,SAAS,WAAW,EAAE,CAAC;CACpC;AAMD,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,CAoD7E;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,GAAG,aAAa,CAAC,GAAG,MAAM,CAenH;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,CAEjG"}

package/dist/help.js

@@ -0,0 +1,104 @@
+/**
+ * Auto-generate help views from registered keybindings.
+ *
+ * ```ts
+ * const kb = createKeyMap<Msg>()
+ *   .bind('q', 'Quit', quitMsg)
+ *   .group('Navigation', g => g
+ *     .bind('j', 'Down', downMsg)
+ *     .bind('k', 'Up', upMsg)
+ *   );
+ *
+ * helpView(kb)          // full grouped help
+ * helpShort(kb)         // single-line summary
+ * helpFor(kb, 'Nav')    // filter by group prefix
+ * ```
+ */
+import { formatKeyCombo } from './keybindings.js';
+// ---------------------------------------------------------------------------
+// Help views
+// ---------------------------------------------------------------------------
+/**
+ * Full help view — grouped, multi-line.
+ *
+ * ```
+ * Navigation
+ *   j  Down
+ *   k  Up
+ *
+ * General
+ *   q  Quit
+ *   ?  Toggle help
+ * ```
+ */
+export function helpView(keymap, options) {
+    const enabledOnly = options?.enabledOnly ?? true;
+    const sep = options?.separator ?? '  ';
+    const groupFilter = options?.groupFilter;
+    let all = keymap.bindings();
+    if (enabledOnly)
+        all = all.filter((b) => b.enabled);
+    if (groupFilter !== undefined) {
+        all = all.filter((b) => b.group.toLowerCase().startsWith(groupFilter.toLowerCase()));
+    }
+    if (all.length === 0)
+        return '';
+    // Group by group name
+    const groups = new Map();
+    for (const b of all) {
+        const group = b.group || 'General';
+        let list = groups.get(group);
+        if (!list) {
+            list = [];
+            groups.set(group, list);
+        }
+        list.push(b);
+    }
+    // Find max key width for alignment
+    const allFormatted = all.map((b) => formatKeyCombo(b.combo));
+    const maxKeyLen = Math.max(...allFormatted.map((k) => k.length));
+    const lines = [];
+    if (options?.title) {
+        lines.push(options.title);
+        lines.push('');
+    }
+    let first = true;
+    for (const [groupName, bindings] of groups) {
+        if (!first)
+            lines.push('');
+        first = false;
+        lines.push(groupName);
+        for (const b of bindings) {
+            const key = formatKeyCombo(b.combo).padEnd(maxKeyLen);
+            lines.push(`  ${key}${sep}${b.description}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Short, single-line help — keys only, no groups.
+ *
+ * ```
+ * q Quit • j Down • k Up • ? Help
+ * ```
+ */
+export function helpShort(keymap, options) {
+    const enabledOnly = options?.enabledOnly ?? true;
+    const groupFilter = options?.groupFilter;
+    let all = keymap.bindings();
+    if (enabledOnly)
+        all = all.filter((b) => b.enabled);
+    if (groupFilter !== undefined) {
+        all = all.filter((b) => b.group.toLowerCase().startsWith(groupFilter.toLowerCase()));
+    }
+    return all
+        .map((b) => `${formatKeyCombo(b.combo)} ${b.description}`)
+        .join(' • ');
+}
+/**
+ * Filter help to a specific group (convenience wrapper).
+ */
+export function helpFor(keymap, groupPrefix, options) {
+    return helpView(keymap, { ...options, groupFilter: groupPrefix });
+}
+//# sourceMappingURL=help.js.map

package/dist/help.js.map

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

package/dist/index.d.ts

@@ -1,8 +1,17 @@
-export type { App, Cmd, KeyMsg, QuitSignal, RunOptions } from './types.js';
+export type { App, Cmd, KeyMsg, ResizeMsg, QuitSignal, RunOptions } from './types.js';
 export { QUIT } from './types.js';
 export { parseKey } from './keys.js';
-export { enterScreen, exitScreen, clearAndHome, renderFrame, ENTER_ALT_SCREEN, EXIT_ALT_SCREEN, HIDE_CURSOR, SHOW_CURSOR, CLEAR_SCREEN, CLEAR_TO_END, CLEAR_LINE, HOME, } from './screen.js';
+export { enterScreen, exitScreen, clearAndHome, renderFrame, ENTER_ALT_SCREEN, EXIT_ALT_SCREEN, HIDE_CURSOR, SHOW_CURSOR, WRAP_DISABLE, WRAP_ENABLE, CLEAR_SCREEN, CLEAR_TO_END, CLEAR_LINE_TO_END, CLEAR_LINE, HOME, } from './screen.js';
 export { quit, tick, batch } from './commands.js';
 export { run } from './runtime.js';
+export { type BusMsg, type EventBus, createEventBus, } from './eventbus.js';
 export { vstack, hstack } from './layout.js';
+export { type SpringConfig, type SpringPreset, type SpringState, SPRING_PRESETS, springStep, createSpringState, resolveSpringConfig, type EasingFn, EASINGS, type TweenConfig, type TweenState, tweenStep, createTweenState, resolveTweenConfig, } from './spring.js';
+export { type SpringAnimateOptions, type TweenAnimateOptions, type AnimateOptions, animate, sequence, } from './animate.js';
+export { type ViewportOptions, type ScrollState, viewport, createScrollState, scrollBy, scrollTo, scrollToTop, scrollToBottom, pageDown, pageUp, } from './viewport.js';
+export { type Position, type SpringTrackDef, type TweenTrackDef, type TrackDef, type TimelineState, type TimelineBuilder, type Timeline, timeline, } from './timeline.js';
+export { type FlexOptions, type FlexChild, flex, } from './flex.js';
+export { type KeyCombo, type BindingInfo, type KeyMap, type KeyMapGroup, createKeyMap, parseKeyCombo, formatKeyCombo, } from './keybindings.js';
+export { type BindingSource, type HelpOptions, helpView, helpShort, helpFor, } from './help.js';
+export { type InputHandler, type LayerOptions, type LayerInfo, type InputStack, createInputStack, } from './inputstack.js';
 //# sourceMappingURL=index.d.ts.map