tuiuiu.js 0.1.1

package/dist/hooks/use-input.js

@@ -0,0 +1,352 @@
+/**
+ * useInput - Handle keyboard input
+ */
+import { addInputHandler, removeInputHandler, getHookState, getCurrentHookIndex, setHookState, getHookStateByIndex, } from './context.js';
+/**
+ * Key name mapping from escape sequences
+ * Supports xterm, gnome, rxvt, putty, cygwin terminals
+ */
+const KEY_NAME_MAP = {
+    // xterm/gnome ESC O letter
+    'OP': 'f1', 'OQ': 'f2', 'OR': 'f3', 'OS': 'f4',
+    // xterm/rxvt ESC [ number ~
+    '[11~': 'f1', '[12~': 'f2', '[13~': 'f3', '[14~': 'f4',
+    // Cygwin / libuv
+    '[[A': 'f1', '[[B': 'f2', '[[C': 'f3', '[[D': 'f4', '[[E': 'f5',
+    // Common function keys
+    '[15~': 'f5', '[17~': 'f6', '[18~': 'f7', '[19~': 'f8',
+    '[20~': 'f9', '[21~': 'f10', '[23~': 'f11', '[24~': 'f12',
+    // xterm ESC [ letter
+    '[A': 'up', '[B': 'down', '[C': 'right', '[D': 'left',
+    '[E': 'clear', '[F': 'end', '[H': 'home',
+    // xterm/gnome ESC O letter
+    'OA': 'up', 'OB': 'down', 'OC': 'right', 'OD': 'left',
+    'OE': 'clear', 'OF': 'end', 'OH': 'home',
+    // xterm/rxvt navigation
+    '[1~': 'home', '[2~': 'insert', '[3~': 'delete', '[4~': 'end',
+    '[5~': 'pageup', '[6~': 'pagedown',
+    // Putty
+    '[[5~': 'pageup', '[[6~': 'pagedown',
+    // rxvt
+    '[7~': 'home', '[8~': 'end',
+    // rxvt with Shift
+    '[a': 'up', '[b': 'down', '[c': 'right', '[d': 'left', '[e': 'clear',
+    '[2$': 'insert', '[3$': 'delete', '[5$': 'pageup', '[6$': 'pagedown',
+    '[7$': 'home', '[8$': 'end',
+    // rxvt with Ctrl
+    'Oa': 'up', 'Ob': 'down', 'Oc': 'right', 'Od': 'left', 'Oe': 'clear',
+    '[2^': 'insert', '[3^': 'delete', '[5^': 'pageup', '[6^': 'pagedown',
+    '[7^': 'home', '[8^': 'end',
+    // Shift+Tab
+    '[Z': 'tab',
+};
+// Sequences that indicate Shift modifier
+const SHIFT_CODES = new Set(['[a', '[b', '[c', '[d', '[e', '[2$', '[3$', '[5$', '[6$', '[7$', '[8$', '[Z']);
+// Sequences that indicate Ctrl modifier
+const CTRL_CODES = new Set(['Oa', 'Ob', 'Oc', 'Od', 'Oe', '[2^', '[3^', '[5^', '[6^', '[7^', '[8^']);
+// Regex to parse function key escape sequences with modifiers
+const FN_KEY_RE = /^(?:\x1b+)(O|N|\[|\[\[)(?:(\d+)(?:;(\d+))?([~^$])|(?:1;)?(\d+)?([a-zA-Z]))/;
+/**
+ * Apply key name to key object
+ */
+function applyKeyName(key, name) {
+    switch (name) {
+        case 'up':
+            key.upArrow = true;
+            break;
+        case 'down':
+            key.downArrow = true;
+            break;
+        case 'left':
+            key.leftArrow = true;
+            break;
+        case 'right':
+            key.rightArrow = true;
+            break;
+        case 'pageup':
+            key.pageUp = true;
+            break;
+        case 'pagedown':
+            key.pageDown = true;
+            break;
+        case 'home':
+            key.home = true;
+            break;
+        case 'end':
+            key.end = true;
+            break;
+        case 'insert':
+            key.insert = true;
+            break;
+        case 'delete':
+            key.delete = true;
+            break;
+        case 'clear':
+            key.clear = true;
+            break;
+        case 'tab':
+            key.tab = true;
+            break;
+        case 'f1':
+            key.f1 = true;
+            break;
+        case 'f2':
+            key.f2 = true;
+            break;
+        case 'f3':
+            key.f3 = true;
+            break;
+        case 'f4':
+            key.f4 = true;
+            break;
+        case 'f5':
+            key.f5 = true;
+            break;
+        case 'f6':
+            key.f6 = true;
+            break;
+        case 'f7':
+            key.f7 = true;
+            break;
+        case 'f8':
+            key.f8 = true;
+            break;
+        case 'f9':
+            key.f9 = true;
+            break;
+        case 'f10':
+            key.f10 = true;
+            break;
+        case 'f11':
+            key.f11 = true;
+            break;
+        case 'f12':
+            key.f12 = true;
+            break;
+    }
+}
+/**
+ * Parse raw input data into key info
+ * Supports multiple terminal types: xterm, gnome, rxvt, putty, cygwin
+ */
+export function parseKeypress(data) {
+    let str = data.toString();
+    // Handle high-bit meta prefix (some terminals)
+    let prefixLen = 0;
+    if (Buffer.isBuffer(data) && data[0] !== undefined && data[0] > 127 && data[1] === undefined) {
+        str = '\x1b' + String.fromCharCode(data[0] - 128);
+        prefixLen = 0; // The buffer was consumed, but length refers to chars in string or buffer?
+        // Let's assume we return length of chars consumed from 'str'.
+    }
+    const key = {
+        upArrow: false,
+        downArrow: false,
+        leftArrow: false,
+        rightArrow: false,
+        pageUp: false,
+        pageDown: false,
+        home: false,
+        end: false,
+        insert: false,
+        return: false,
+        escape: false,
+        tab: false,
+        backspace: false,
+        delete: false,
+        clear: false,
+        ctrl: false,
+        shift: false,
+        meta: false,
+        option: false,
+        f1: false, f2: false, f3: false, f4: false,
+        f5: false, f6: false, f7: false, f8: false,
+        f9: false, f10: false, f11: false, f12: false,
+    };
+    let input = '';
+    // Carriage return
+    if (str === '\r') {
+        key.return = true;
+        return { input, key, length: 1 };
+    }
+    // Enter/newline
+    if (str === '\n') {
+        key.return = true;
+        return { input, key, length: 1 };
+    }
+    // Tab
+    if (str === '\t') {
+        key.tab = true;
+        return { input, key, length: 1 };
+    }
+    // Backspace - most terminals send \x7f (DEL) for backspace key
+    // Some older terminals send \b (BS)
+    if (str === '\x7f' || str === '\b') {
+        key.backspace = true;
+        return { input, key, length: 1 };
+    }
+    if (str === '\x1b\x7f' || str === '\x1b\b') {
+        key.backspace = true;
+        key.meta = true;
+        return { input, key, length: 2 };
+    }
+    // Escape
+    if (str === '\x1b') {
+        key.escape = true;
+        return { input, key, length: 1 };
+    }
+    if (str === '\x1b\x1b') {
+        key.escape = true;
+        key.meta = true;
+        return { input, key, length: 2 };
+    }
+    // Space (with possible meta)
+    if (str === ' ') {
+        input = ' ';
+        return { input, key, length: 1 };
+    }
+    if (str === '\x1b ') {
+        key.meta = true;
+        input = ' ';
+        return { input, key, length: 2 };
+    }
+    // Ctrl+letter (0x01-0x1a)
+    if (str.length >= 1 && str.charCodeAt(0) <= 26) {
+        key.ctrl = true;
+        input = String.fromCharCode(str.charCodeAt(0) + 'a'.charCodeAt(0) - 1);
+        return { input, key, length: 1 };
+    }
+    // Function keys and special keys with escape sequences
+    // Try to match escape sequences first before single chars
+    const fnMatch = FN_KEY_RE.exec(str);
+    if (fnMatch && fnMatch.index === 0) {
+        // ... (keep existing)
+        // Check for option key (double escape at start)
+        const segs = [...str];
+        if (segs[0] === '\x1b' && segs[1] === '\x1b') {
+            key.option = true;
+        }
+        // Build key code from parts
+        const code = [fnMatch[1], fnMatch[2], fnMatch[4], fnMatch[6]]
+            .filter(Boolean)
+            .join('');
+        // Parse modifier bits (CSI 1;n format)
+        const modifier = (fnMatch[3] || fnMatch[5] || 1) - 1;
+        key.ctrl = !!(modifier & 4);
+        key.meta = !!(modifier & 10);
+        key.shift = !!(modifier & 1);
+        // Map to key name
+        const keyName = KEY_NAME_MAP[code];
+        if (keyName) {
+            applyKeyName(key, keyName);
+        }
+        // Check for shift/ctrl from code pattern
+        if (SHIFT_CODES.has(code))
+            key.shift = true;
+        if (CTRL_CODES.has(code))
+            key.ctrl = true;
+        return { input, key, length: fnMatch[0].length };
+    }
+    // Meta+character
+    const metaMatch = /^(?:\x1b)([a-zA-Z0-9])/.exec(str);
+    if (metaMatch) {
+        key.meta = true;
+        key.shift = /^[A-Z]$/.test(metaMatch[1]);
+        input = metaMatch[1].toLowerCase();
+        return { input, key, length: 2 };
+    }
+    // Single Uppercase letter (shift)
+    // Only if length is 1, to preserve old behavior of prioritizing single key logic?
+    // No, if we have "A", length is 1.
+    // If we have "AB", length is 2.
+    // If we want to support "AB" as a paste, we should return "AB".
+    // Consume chunk of regular text
+    // Match anything that is NOT a special char start
+    // Special start chars: \r, \n, \t, \b, \x7f, \x1b
+    // Also check for Ctrl chars (0x00-0x1a)
+    // Regex: Read until control char
+    const textMatch = /^[^\x00-\x1f\x7f]+/.exec(str);
+    if (textMatch) {
+        const text = textMatch[0];
+        // If exactly 1 char and uppercase, normalize it (legacy behavior)
+        if (text.length === 1 && text >= 'A' && text <= 'Z') {
+            key.shift = true;
+            input = text.toLowerCase();
+            return { input, key, length: 1 };
+        }
+        input = text;
+        return { input, key, length: text.length };
+    }
+    // If we are here, we might have a single control char that wasn't handled above?
+    // e.g. Ctrl+A (\x01).
+    // \x01 was handled by `Ctrl+letter` block earlier?
+    // Let's check where I put `Ctrl+letter`.
+    // I put it ABOVE `Function keys`.
+    // Wait, `Ctrl+letter` logic:
+    // if (str.length >= 1 && str.charCodeAt(0) <= 26)
+    // This matches \r (13), \n (10), \t (9), \b (8), \x1b (27 - wait 27 is > 26).
+    // But \r, \n, \t, \b are handled EXPLICITLY at the top.
+    // So `Ctrl+letter` handles the REST of 0-26.
+    // So `textMatch` handles 32+ (printable) and up.
+    return { input, key, length: str.length }; // Fallback
+}
+/**
+ * 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 function useInput(handler, options = {}) {
+    const { isActive = true } = options;
+    // Get or create hook state for this useInput call
+    const { value: hookData, isNew } = getHookState(null);
+    if (isNew || hookData === null) {
+        // First render - create wrapper and register
+        const wrapper = (input, key) => {
+            // Always call the latest handler (stored in hookData)
+            const data = getStoredHookData();
+            if (data && data.registered) {
+                data.handler(input, key);
+            }
+        };
+        const data = {
+            handler,
+            wrapper,
+            registered: isActive,
+        };
+        // Store the data
+        const hookIndex = getCurrentHookIndex();
+        setHookState(hookIndex, data);
+        // Helper to get stored data (closure over hookIndex)
+        function getStoredHookData() {
+            return getHookStateByIndex(hookIndex);
+        }
+        if (isActive) {
+            addInputHandler(wrapper);
+        }
+    }
+    else {
+        // Subsequent render - update handler reference and active state
+        const prevRegistered = hookData.registered;
+        hookData.handler = handler; // Update to latest handler
+        hookData.registered = isActive;
+        // Handle activation/deactivation
+        if (isActive && !prevRegistered) {
+            addInputHandler(hookData.wrapper);
+        }
+        else if (!isActive && prevRegistered) {
+            removeInputHandler(hookData.wrapper);
+        }
+    }
+}
+//# sourceMappingURL=use-input.js.map

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

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

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

@@ -0,0 +1,82 @@
+/**
+ * useMouse - Handle mouse input events
+ *
+ * Supports SGR mouse protocol with X10 fallback for legacy terminals.
+ * Works with xterm, iTerm2, Windows Terminal, Kitty, and most modern terminals.
+ */
+export type MouseButton = 'left' | 'right' | 'middle' | 'scroll-up' | 'scroll-down' | 'none';
+export type MouseAction = 'click' | 'double-click' | 'drag' | 'release' | 'move';
+export interface MouseEvent {
+    /** Column position (0-indexed) */
+    x: number;
+    /** Row position (0-indexed) */
+    y: number;
+    /** Which button was pressed/released */
+    button: MouseButton;
+    /** Type of mouse action */
+    action: MouseAction;
+    /** Modifier keys held during the event */
+    modifiers: {
+        ctrl: boolean;
+        shift: boolean;
+        alt: boolean;
+    };
+}
+export type MouseHandler = (event: MouseEvent) => void;
+export interface MouseOptions {
+    /** Only handle events when active (default: true) */
+    isActive?: boolean;
+    /** Enable mouse tracking globally when this hook mounts */
+    enableTracking?: boolean;
+}
+export interface MouseEventResult {
+    event: MouseEvent;
+    length: number;
+}
+/**
+ * Parse raw input and extract mouse event if present
+ */
+export declare function parseMouseEvent(data: string): MouseEventResult | null;
+/**
+ * Check if a string contains a mouse event sequence
+ */
+export declare function isMouseEvent(data: string): boolean;
+/**
+ * Enable mouse tracking in the terminal
+ */
+export declare function enableMouseTracking(): void;
+/**
+ * Disable mouse tracking in the terminal
+ */
+export declare function disableMouseTracking(): void;
+/**
+ * Force disable mouse tracking (cleanup)
+ */
+export declare function forceDisableMouseTracking(): void;
+/**
+ * Check if mouse tracking is currently enabled
+ */
+export declare function isMouseTrackingEnabled(): boolean;
+/**
+ * useMouse - Handle mouse input events
+ *
+ * @example
+ * useMouse((event) => {
+ *   if (event.action === 'click' && event.button === 'left') {
+ *     handleClick(event.x, event.y);
+ *   }
+ * });
+ *
+ * @example
+ * // With options
+ * useMouse(
+ *   (event) => {
+ *     if (event.action === 'drag') {
+ *       handleDrag(event.x, event.y);
+ *     }
+ *   },
+ *   { isActive: isDragging, enableTracking: true }
+ * );
+ */
+export declare function useMouse(handler: MouseHandler, options?: MouseOptions): void;
+//# sourceMappingURL=use-mouse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-mouse.d.ts","sourceRoot":"","sources":["../../src/hooks/use-mouse.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,GAAG,MAAM,CAAC;AAC7F,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAEjF,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,CAAC,EAAE,MAAM,CAAC;IACV,+BAA+B;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,wCAAwC;IACxC,MAAM,EAAE,WAAW,CAAC;IACpB,2BAA2B;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,0CAA0C;IAC1C,SAAS,EAAE;QACT,IAAI,EAAE,OAAO,CAAC;QACd,KAAK,EAAE,OAAO,CAAC;QACf,GAAG,EAAE,OAAO,CAAC;KACd,CAAC;CACH;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;AAEvD,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAgID,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAgBrE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAM1C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAM3C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAMhD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAoDD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,GAAE,YAAiB,GAAG,IAAI,CA2EhF"}