tuiuiu.js 0.1.1

package/dist/hooks/use-app.js

@@ -0,0 +1,179 @@
+/**
+ * useApp - Application context and lifecycle management
+ */
+import { batch } from '../primitives/signal.js';
+import { getAppContext, setAppContext, emitInput, clearInputHandlers, setFocusManager, } from './context.js';
+import { parseKeypress } from './use-input.js';
+import { parseMouseEvent, isMouseEvent } from './use-mouse.js';
+import { getHitTestRegistry } from '../core/hit-test.js';
+import { FocusManagerImpl } from './use-focus.js';
+/**
+ * useApp - Access app control
+ *
+ * @example
+ * const { exit } = useApp();
+ * if (done) exit();
+ */
+export function useApp() {
+    const appContext = getAppContext();
+    if (!appContext) {
+        throw new Error('useApp must be called within a Reck app');
+    }
+    return appContext;
+}
+/**
+ * Initialize app context and input handling
+ */
+export function initializeApp(stdin, stdout, options = {}) {
+    const { autoTabNavigation: initialAutoTab = true } = options;
+    const exitCallbacks = [];
+    let isExiting = false;
+    let autoTabNavigation = initialAutoTab;
+    // Raw mode reference counting
+    let rawModeEnabledCount = 0;
+    /**
+     * Set raw mode with reference counting
+     *
+     * Multiple components can request raw mode. Raw mode is enabled when
+     * count > 0 and disabled when count reaches 0.
+     */
+    const setRawMode = (enabled) => {
+        if (!stdin.isTTY || !stdin.setRawMode)
+            return;
+        if (enabled) {
+            rawModeEnabledCount++;
+            if (rawModeEnabledCount === 1) {
+                // First request - enable raw mode
+                stdin.setRawMode(true);
+            }
+        }
+        else {
+            rawModeEnabledCount = Math.max(0, rawModeEnabledCount - 1);
+            if (rawModeEnabledCount === 0) {
+                // Last release - disable raw mode
+                stdin.setRawMode(false);
+            }
+        }
+    };
+    const isRawModeEnabled = () => {
+        return rawModeEnabledCount > 0;
+    };
+    // Setup initial raw mode for input (count as 1 reference)
+    setRawMode(true);
+    stdin.resume();
+    // Initialize focus manager
+    const focusManager = new FocusManagerImpl();
+    setFocusManager(focusManager);
+    // Handle input
+    const handleData = (data) => {
+        let rawInput = data.toString();
+        // Loop through input to handle batched events (mouse + keys)
+        while (rawInput.length > 0) {
+            // Check for mouse events FIRST
+            if (isMouseEvent(rawInput)) {
+                const mouseResult = parseMouseEvent(rawInput);
+                if (mouseResult) {
+                    // Dispatch to hit-test registry
+                    batch(() => {
+                        getHitTestRegistry().handleMouseEvent(mouseResult.event);
+                    });
+                    // Consume and continue
+                    rawInput = rawInput.slice(mouseResult.length);
+                    continue;
+                }
+            }
+            // Not a mouse event, parse as key
+            const { input, key, length } = parseKeypress(rawInput);
+            // Consume processed part
+            const consumed = length > 0 ? length : 1; // Safety fallback
+            rawInput = rawInput.slice(consumed);
+            // Ctrl+C always exits
+            if (key.ctrl && input === 'c') {
+                exit();
+                return;
+            }
+            // Automatic Tab navigation
+            if (autoTabNavigation) {
+                if (key.tab && !key.shift) {
+                    // Tab - focus next
+                    batch(() => {
+                        focusManager.focusNext();
+                    });
+                    continue; // Don't propagate Tab to handlers
+                }
+                if (key.tab && key.shift) {
+                    // Shift+Tab - focus previous
+                    batch(() => {
+                        focusManager.focusPrevious();
+                    });
+                    continue; // Don't propagate Shift+Tab to handlers
+                }
+                if (key.escape) {
+                    // Escape - blur focus (only if something is focused)
+                    if (focusManager.getActiveId() !== undefined) {
+                        batch(() => {
+                            focusManager.blur();
+                        });
+                        continue; // Don't propagate Escape to handlers when blurring
+                    }
+                }
+            }
+            // Emit input event to all handlers (wrapped in batch for single re-render)
+            batch(() => {
+                emitInput(input, key);
+            });
+        }
+    };
+    stdin.on('data', handleData);
+    const exit = (error) => {
+        if (isExiting)
+            return;
+        isExiting = true;
+        // Cleanup
+        stdin.off('data', handleData);
+        // Force disable raw mode regardless of count
+        rawModeEnabledCount = 0;
+        if (stdin.isTTY && stdin.setRawMode) {
+            stdin.setRawMode(false);
+        }
+        // Call exit callbacks
+        for (const callback of exitCallbacks) {
+            callback();
+        }
+        // Exit process
+        if (error) {
+            console.error(error);
+            process.exit(1);
+        }
+        else {
+            process.exit(0);
+        }
+    };
+    // Store context
+    const appContext = {
+        exit,
+        stdin,
+        stdout,
+        onExit: (callback) => exitCallbacks.push(callback),
+        autoTabNavigation,
+        setAutoTabNavigation: (enabled) => {
+            autoTabNavigation = enabled;
+        },
+        setRawMode,
+        get rawModeEnabledCount() {
+            return rawModeEnabledCount;
+        },
+        isRawModeEnabled,
+    };
+    setAppContext(appContext);
+    return appContext;
+}
+/**
+ * Cleanup app context
+ */
+export function cleanupApp() {
+    clearInputHandlers();
+    setFocusManager(null);
+    setAppContext(null);
+}
+//# sourceMappingURL=use-app.js.map

package/dist/hooks/use-app.js.map

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

package/dist/hooks/use-effect.d.ts

@@ -0,0 +1,20 @@
+/**
+ * useEffect - Run side effects reactively
+ *
+ * Uses hook state persistence to avoid creating duplicate effects
+ * across re-renders.
+ */
+/**
+ * useEffect - Run side effects reactively
+ *
+ * The effect will re-run whenever any signals read inside it change.
+ * Only one effect is created per useEffect call, persisted across re-renders.
+ *
+ * @example
+ * useEffect(() => {
+ *   console.log('Count changed:', count());
+ *   return () => console.log('Cleanup');
+ * });
+ */
+export declare function useEffect(fn: () => void | (() => void)): () => void;
+//# sourceMappingURL=use-effect.d.ts.map

package/dist/hooks/use-effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-effect.d.ts","sourceRoot":"","sources":["../../src/hooks/use-effect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,MAAM,IAAI,CAuCnE"}

package/dist/hooks/use-effect.js

@@ -0,0 +1,55 @@
+/**
+ * useEffect - Run side effects reactively
+ *
+ * Uses hook state persistence to avoid creating duplicate effects
+ * across re-renders.
+ */
+import { Effect } from '../primitives/signal.js';
+import { getHookState, getCurrentHookIndex, setHookState, getHookStateByIndex, } from './context.js';
+/**
+ * useEffect - Run side effects reactively
+ *
+ * The effect will re-run whenever any signals read inside it change.
+ * Only one effect is created per useEffect call, persisted across re-renders.
+ *
+ * @example
+ * useEffect(() => {
+ *   console.log('Count changed:', count());
+ *   return () => console.log('Cleanup');
+ * });
+ */
+export function useEffect(fn) {
+    // Get or create hook state for this useEffect call
+    const { value: hookData, isNew } = getHookState(null);
+    if (isNew || hookData === null) {
+        // First render - create the effect
+        const hookIndex = getCurrentHookIndex();
+        // Pre-create the data object so the effect wrapper can access it
+        const data = {
+            effect: null, // Will be set below
+            fn,
+            dispose: null, // Will be set below
+        };
+        // Store data BEFORE creating effect, so the wrapper can access it
+        setHookState(hookIndex, data);
+        // Create wrapper that always calls the latest fn
+        const effect = new Effect(() => {
+            const storedData = getHookStateByIndex(hookIndex);
+            if (storedData) {
+                return storedData.fn();
+            }
+        });
+        const dispose = () => effect.dispose();
+        // Update the data with actual effect and dispose
+        data.effect = effect;
+        data.dispose = dispose;
+        return dispose;
+    }
+    else {
+        // Subsequent render - update fn reference
+        // The effect will use the new fn on next run
+        hookData.fn = fn;
+        return hookData.dispose;
+    }
+}
+//# sourceMappingURL=use-effect.js.map

package/dist/hooks/use-effect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-effect.js","sourceRoot":"","sources":["../../src/hooks/use-effect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAgB,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAQtB;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,EAA6B;IACrD,mDAAmD;IACnD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,YAAY,CAAwB,IAAI,CAAC,CAAC;IAE7E,IAAI,KAAK,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC/B,mCAAmC;QACnC,MAAM,SAAS,GAAG,mBAAmB,EAAE,CAAC;QAExC,iEAAiE;QACjE,MAAM,IAAI,GAAmB;YAC3B,MAAM,EAAE,IAAW,EAAE,oBAAoB;YACzC,EAAE;YACF,OAAO,EAAE,IAAW,EAAE,oBAAoB;SAC3C,CAAC;QAEF,kEAAkE;QAClE,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAE9B,iDAAiD;QACjD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,GAAG,EAAE;YAC7B,MAAM,UAAU,GAAG,mBAAmB,CAAC,SAAS,CAA0B,CAAC;YAC3E,IAAI,UAAU,EAAE,CAAC;gBACf,OAAO,UAAU,CAAC,EAAE,EAAE,CAAC;YACzB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAEvC,iDAAiD;QACjD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,OAAO,OAAO,CAAC;IACjB,CAAC;SAAM,CAAC;QACN,0CAA0C;QAC1C,6CAA6C;QAC7C,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;QACjB,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/hooks/use-focus.d.ts

@@ -0,0 +1,48 @@
+/**
+ * useFocus - Focus management hooks
+ */
+import type { FocusOptions, FocusResult, FocusManager } from './types.js';
+export type { FocusOptions, FocusResult, FocusManager };
+/**
+ * Focus Manager - Manages focus between components
+ */
+export declare class FocusManagerImpl implements FocusManager {
+    private items;
+    private order;
+    private currentIndex;
+    register(id: string, setFocused: (focused: boolean) => void): void;
+    unregister(id: string): void;
+    focus(id: string): void;
+    focusNext(): void;
+    focusPrevious(): void;
+    blur(): void;
+    getActiveId(): string | undefined;
+    private setFocusIndex;
+}
+/**
+ * Create and initialize a focus manager
+ */
+export declare function createFocusManager(): FocusManager;
+/**
+ * useFocus - Focus management for the component
+ *
+ * @example
+ * const { isFocused, focus } = useFocus({ autoFocus: true });
+ */
+export declare function useFocus(options?: FocusOptions): FocusResult;
+/**
+ * useFocusManager - Control focus programmatically
+ *
+ * @example
+ * const { focusNext, focusPrevious, blur } = useFocusManager();
+ * if (key.tab) focusNext();
+ * if (key.escape) blur();
+ */
+export declare function useFocusManager(): {
+    focusNext: () => void;
+    focusPrevious: () => void;
+    focus: (id: string) => void;
+    blur: () => void;
+    getActiveId: () => string | undefined;
+};
+//# sourceMappingURL=use-focus.d.ts.map

package/dist/hooks/use-focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-focus.d.ts","sourceRoot":"","sources":["../../src/hooks/use-focus.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAiB1E,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;AAExD;;GAEG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,KAAK,CAAsD;IACnE,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,YAAY,CAAM;IAE1B,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAKlE,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAW5B,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAOvB,SAAS,IAAI,IAAI;IAKjB,aAAa,IAAI,IAAI;IAKrB,IAAI,IAAI,IAAI;IAUZ,WAAW,IAAI,MAAM,GAAG,SAAS;IAOjC,OAAO,CAAC,aAAa;CAgBtB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAIjD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,GAAE,YAAiB,GAAG,WAAW,CA6BhE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,IAAI;IACjC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,WAAW,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CACvC,CAaA"}

package/dist/hooks/use-focus.js

@@ -0,0 +1,152 @@
+/**
+ * useFocus - Focus management hooks
+ */
+import { createEffect } from '../primitives/signal.js';
+import { getFocusManager, setFocusManager } from './context.js';
+import { hasContext } from '../primitives/context.js';
+import { FocusContext } from './focus-context.js';
+import { useState } from './use-state.js';
+/**
+ * Get FocusManager from Context or global fallback
+ *
+ * Prefers FocusContext if available, otherwise uses global module state.
+ * This allows gradual migration to Context-based focus management.
+ */
+function getActiveFocusManager() {
+    // Check Context first
+    if (hasContext(FocusContext) && FocusContext._currentValue !== null) {
+        return FocusContext._currentValue;
+    }
+    // Fall back to global
+    return getFocusManager();
+}
+/**
+ * Focus Manager - Manages focus between components
+ */
+export class FocusManagerImpl {
+    items = new Map();
+    order = [];
+    currentIndex = -1;
+    register(id, setFocused) {
+        this.items.set(id, setFocused);
+        this.order.push(id);
+    }
+    unregister(id) {
+        this.items.delete(id);
+        const index = this.order.indexOf(id);
+        if (index >= 0) {
+            this.order.splice(index, 1);
+            if (this.currentIndex >= index && this.currentIndex > 0) {
+                this.currentIndex--;
+            }
+        }
+    }
+    focus(id) {
+        const index = this.order.indexOf(id);
+        if (index >= 0) {
+            this.setFocusIndex(index);
+        }
+    }
+    focusNext() {
+        if (this.order.length === 0)
+            return;
+        this.setFocusIndex((this.currentIndex + 1) % this.order.length);
+    }
+    focusPrevious() {
+        if (this.order.length === 0)
+            return;
+        this.setFocusIndex((this.currentIndex - 1 + this.order.length) % this.order.length);
+    }
+    blur() {
+        // Unfocus current without focusing another
+        if (this.currentIndex >= 0 && this.currentIndex < this.order.length) {
+            const currentId = this.order[this.currentIndex];
+            const handler = this.items.get(currentId);
+            handler?.(false);
+        }
+        this.currentIndex = -1;
+    }
+    getActiveId() {
+        if (this.currentIndex >= 0 && this.currentIndex < this.order.length) {
+            return this.order[this.currentIndex];
+        }
+        return undefined;
+    }
+    setFocusIndex(index) {
+        // Unfocus current
+        if (this.currentIndex >= 0 && this.currentIndex < this.order.length) {
+            const currentId = this.order[this.currentIndex];
+            const handler = this.items.get(currentId);
+            handler?.(false);
+        }
+        // Focus new
+        this.currentIndex = index;
+        if (index >= 0 && index < this.order.length) {
+            const newId = this.order[index];
+            const handler = this.items.get(newId);
+            handler?.(true);
+        }
+    }
+}
+/**
+ * Create and initialize a focus manager
+ */
+export function createFocusManager() {
+    const fm = new FocusManagerImpl();
+    setFocusManager(fm);
+    return fm;
+}
+/**
+ * useFocus - Focus management for the component
+ *
+ * @example
+ * const { isFocused, focus } = useFocus({ autoFocus: true });
+ */
+export function useFocus(options = {}) {
+    const { autoFocus = false, isActive = true, id } = options;
+    const [isFocused, setIsFocused] = useState(false);
+    createEffect(() => {
+        const focusManager = getActiveFocusManager();
+        if (!focusManager || !isActive)
+            return;
+        const focusId = id ?? Math.random().toString(36).slice(2);
+        focusManager.register(focusId, setIsFocused);
+        if (autoFocus) {
+            focusManager.focus(focusId);
+        }
+        return () => {
+            getActiveFocusManager()?.unregister(focusId);
+        };
+    });
+    return {
+        isFocused: isFocused(),
+        focus: () => {
+            const focusManager = getActiveFocusManager();
+            if (focusManager && id) {
+                focusManager.focus(id);
+            }
+        },
+    };
+}
+/**
+ * useFocusManager - Control focus programmatically
+ *
+ * @example
+ * const { focusNext, focusPrevious, blur } = useFocusManager();
+ * if (key.tab) focusNext();
+ * if (key.escape) blur();
+ */
+export function useFocusManager() {
+    const focusManager = getActiveFocusManager();
+    if (!focusManager) {
+        throw new Error('useFocusManager must be called within a Reck app');
+    }
+    return {
+        focusNext: () => getActiveFocusManager().focusNext(),
+        focusPrevious: () => getActiveFocusManager().focusPrevious(),
+        focus: (id) => getActiveFocusManager().focus(id),
+        blur: () => getActiveFocusManager().blur(),
+        getActiveId: () => getActiveFocusManager().getActiveId(),
+    };
+}
+//# sourceMappingURL=use-focus.js.map

package/dist/hooks/use-focus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-focus.js","sourceRoot":"","sources":["../../src/hooks/use-focus.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C;;;;;GAKG;AACH,SAAS,qBAAqB;IAC5B,sBAAsB;IACtB,IAAI,UAAU,CAAC,YAAY,CAAC,IAAI,YAAY,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;QACpE,OAAO,YAAY,CAAC,aAAa,CAAC;IACpC,CAAC;IACD,sBAAsB;IACtB,OAAO,eAAe,EAAE,CAAC;AAC3B,CAAC;AAID;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACnB,KAAK,GAA4C,IAAI,GAAG,EAAE,CAAC;IAC3D,KAAK,GAAa,EAAE,CAAC;IACrB,YAAY,GAAG,CAAC,CAAC,CAAC;IAE1B,QAAQ,CAAC,EAAU,EAAE,UAAsC;QACzD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC;IAED,UAAU,CAAC,EAAU;QACnB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC5B,IAAI,IAAI,CAAC,YAAY,IAAI,KAAK,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;gBACxD,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,EAAU;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,SAAS;QACP,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACpC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,aAAa;QACX,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACpC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACtF,CAAC;IAED,IAAI;QACF,2CAA2C;QAC3C,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACpE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAChD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAU,CAAC,CAAC;YAC3C,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;IACzB,CAAC;IAED,WAAW;QACT,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACpE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,aAAa,CAAC,KAAa;QACjC,kBAAkB;QAClB,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACpE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAChD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAU,CAAC,CAAC;YAC3C,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;QAED,YAAY;QACZ,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAChC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAM,CAAC,CAAC;YACvC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,EAAE,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAClC,eAAe,CAAC,EAAE,CAAC,CAAC;IACpB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,UAAwB,EAAE;IACjD,MAAM,EAAE,SAAS,GAAG,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;IAC3D,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAElD,YAAY,CAAC,GAAG,EAAE;QAChB,MAAM,YAAY,GAAG,qBAAqB,EAAE,CAAC;QAC7C,IAAI,CAAC,YAAY,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEvC,MAAM,OAAO,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1D,YAAY,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAE7C,IAAI,SAAS,EAAE,CAAC;YACd,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO,GAAG,EAAE;YACV,qBAAqB,EAAE,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;QAC/C,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,SAAS,EAAE,SAAS,EAAE;QACtB,KAAK,EAAE,GAAG,EAAE;YACV,MAAM,YAAY,GAAG,qBAAqB,EAAE,CAAC;YAC7C,IAAI,YAAY,IAAI,EAAE,EAAE,CAAC;gBACvB,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe;IAO7B,MAAM,YAAY,GAAG,qBAAqB,EAAE,CAAC;IAC7C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,OAAO;QACL,SAAS,EAAE,GAAG,EAAE,CAAC,qBAAqB,EAAG,CAAC,SAAS,EAAE;QACrD,aAAa,EAAE,GAAG,EAAE,CAAC,qBAAqB,EAAG,CAAC,aAAa,EAAE;QAC7D,KAAK,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,qBAAqB,EAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,IAAI,EAAE,GAAG,EAAE,CAAC,qBAAqB,EAAG,CAAC,IAAI,EAAE;QAC3C,WAAW,EAAE,GAAG,EAAE,CAAC,qBAAqB,EAAG,CAAC,WAAW,EAAE;KAC1D,CAAC;AACJ,CAAC"}

package/dist/hooks/use-input.d.ts

@@ -0,0 +1,35 @@
+/**
+ * useInput - Handle keyboard input
+ */
+import type { Key, InputHandler } from './types.js';
+export type { Key, InputHandler };
+/**
+ * Parse raw input data into key info
+ * Supports multiple terminal types: xterm, gnome, rxvt, putty, cygwin
+ */
+export declare function parseKeypress(data: Buffer | string): {
+    input: string;
+    key: Key;
+    length: number;
+};
+/**
+ * useInput - Handle keyboard input
+ *
+ * Uses hook state persistence to avoid registering duplicate handlers
+ * across re-renders.
+ *
+ * @example
+ * useInput((input, key) => {
+ *   if (key.return) {
+ *     submit();
+ *   } else if (key.escape) {
+ *     cancel();
+ *   } else {
+ *     setInput(prev => prev + input);
+ *   }
+ * });
+ */
+export declare function useInput(handler: InputHandler, options?: {
+    isActive?: boolean;
+}): void;
+//# sourceMappingURL=use-input.d.ts.map

package/dist/hooks/use-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-input.d.ts","sourceRoot":"","sources":["../../src/hooks/use-input.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEpD,YAAY,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC;AAkFlC;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA2LhG;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,IAAI,CAmD1F"}