tuiuiu.js 0.1.1

package/dist/hooks/use-mouse.js

@@ -0,0 +1,328 @@
+/**
+ * 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.
+ */
+import { addInputHandler, removeInputHandler, getHookState, getCurrentHookIndex, setHookState, getHookStateByIndex, } from './context.js';
+// =============================================================================
+// Mouse Protocol Constants
+// =============================================================================
+/** Enable SGR extended mouse mode (most modern terminals) */
+const SGR_MOUSE_ENABLE = '\x1b[?1000h\x1b[?1002h\x1b[?1006h';
+/** Disable SGR extended mouse mode */
+const SGR_MOUSE_DISABLE = '\x1b[?1000l\x1b[?1002l\x1b[?1006l';
+/** Enable basic X10 mouse mode (legacy fallback) */
+const X10_MOUSE_ENABLE = '\x1b[?1000h';
+/** Disable basic X10 mouse mode */
+const X10_MOUSE_DISABLE = '\x1b[?1000l';
+// Track if mouse is globally enabled to avoid multiple enable/disable
+let mouseTrackingEnabled = false;
+let mouseTrackingRefCount = 0;
+// =============================================================================
+// Mouse Event Parsing
+// =============================================================================
+/**
+ * SGR mouse event format: \x1b[<button;x;yM (press) or \x1b[<button;x;ym (release)
+ * Button encoding:
+ *   0 = left, 1 = middle, 2 = right
+ *   +4 = shift, +8 = meta/alt, +16 = ctrl
+ *   +32 = motion (drag)
+ *   64 = scroll up, 65 = scroll down
+ */
+const SGR_MOUSE_RE = /^\x1b\[<(\d+);(\d+);(\d+)([Mm])/;
+/**
+ * X10 mouse event format: \x1b[M<button><x><y>
+ * Coordinates are encoded as character codes starting at 33 (!)
+ */
+const X10_MOUSE_RE = /^\x1b\[M([\x00-\xff])([\x00-\xff])([\x00-\xff])/;
+/**
+ * Parse SGR mouse event
+ */
+function parseSGRMouse(match) {
+    const buttonCode = parseInt(match[1], 10);
+    const x = parseInt(match[2], 10) - 1; // Convert to 0-indexed
+    const y = parseInt(match[3], 10) - 1;
+    const isRelease = match[4] === 'm';
+    // Decode modifiers
+    const modifiers = {
+        shift: !!(buttonCode & 4),
+        alt: !!(buttonCode & 8),
+        ctrl: !!(buttonCode & 16),
+    };
+    // Decode button (lower 2 bits, but also check for scroll)
+    const baseButton = buttonCode & 3;
+    const isMotion = !!(buttonCode & 32);
+    const isScroll = buttonCode >= 64 && buttonCode <= 67;
+    let button;
+    let action;
+    if (isScroll) {
+        button = (buttonCode & 1) ? 'scroll-down' : 'scroll-up';
+        action = 'click';
+    }
+    else {
+        switch (baseButton) {
+            case 0:
+                button = 'left';
+                break;
+            case 1:
+                button = 'middle';
+                break;
+            case 2:
+                button = 'right';
+                break;
+            default:
+                button = 'none';
+                break;
+        }
+        if (isRelease) {
+            action = 'release';
+        }
+        else if (isMotion) {
+            action = 'drag';
+        }
+        else {
+            action = 'click';
+        }
+    }
+    return { x, y, button, action, modifiers };
+}
+/**
+ * Parse X10 mouse event (legacy format)
+ */
+function parseX10Mouse(match) {
+    const buttonByte = match[1].charCodeAt(0);
+    const x = match[2].charCodeAt(0) - 33; // 33 = '!'
+    const y = match[3].charCodeAt(0) - 33;
+    // Decode modifiers
+    const modifiers = {
+        shift: !!(buttonByte & 4),
+        alt: !!(buttonByte & 8),
+        ctrl: !!(buttonByte & 16),
+    };
+    // Decode button
+    const baseButton = buttonByte & 3;
+    const isMotion = !!(buttonByte & 32);
+    const isRelease = baseButton === 3;
+    let button;
+    let action;
+    if (isRelease) {
+        button = 'none';
+        action = 'release';
+    }
+    else {
+        switch (baseButton) {
+            case 0:
+                button = 'left';
+                break;
+            case 1:
+                button = 'middle';
+                break;
+            case 2:
+                button = 'right';
+                break;
+            default:
+                button = 'none';
+                break;
+        }
+        action = isMotion ? 'drag' : 'click';
+    }
+    return { x, y, button, action, modifiers };
+}
+/**
+ * Parse raw input and extract mouse event if present
+ */
+export function parseMouseEvent(data) {
+    // Try SGR format first (more precise)
+    const sgrMatch = SGR_MOUSE_RE.exec(data);
+    if (sgrMatch) {
+        const event = parseSGRMouse(sgrMatch);
+        return event ? { event, length: sgrMatch[0].length } : null;
+    }
+    // Fall back to X10 format
+    const x10Match = X10_MOUSE_RE.exec(data);
+    if (x10Match) {
+        const event = parseX10Mouse(x10Match);
+        return event ? { event, length: x10Match[0].length } : null;
+    }
+    return null;
+}
+/**
+ * Check if a string contains a mouse event sequence
+ */
+export function isMouseEvent(data) {
+    return SGR_MOUSE_RE.test(data) || X10_MOUSE_RE.test(data);
+}
+// =============================================================================
+// Mouse Tracking Control
+// =============================================================================
+/**
+ * Enable mouse tracking in the terminal
+ */
+export function enableMouseTracking() {
+    mouseTrackingRefCount++;
+    if (!mouseTrackingEnabled) {
+        mouseTrackingEnabled = true;
+        process.stdout.write(SGR_MOUSE_ENABLE);
+    }
+}
+/**
+ * Disable mouse tracking in the terminal
+ */
+export function disableMouseTracking() {
+    mouseTrackingRefCount = Math.max(0, mouseTrackingRefCount - 1);
+    if (mouseTrackingRefCount === 0 && mouseTrackingEnabled) {
+        mouseTrackingEnabled = false;
+        process.stdout.write(SGR_MOUSE_DISABLE);
+    }
+}
+/**
+ * Force disable mouse tracking (cleanup)
+ */
+export function forceDisableMouseTracking() {
+    mouseTrackingRefCount = 0;
+    if (mouseTrackingEnabled) {
+        mouseTrackingEnabled = false;
+        process.stdout.write(SGR_MOUSE_DISABLE);
+    }
+}
+/**
+ * Check if mouse tracking is currently enabled
+ */
+export function isMouseTrackingEnabled() {
+    return mouseTrackingEnabled;
+}
+const clickState = { lastClick: null };
+const DOUBLE_CLICK_THRESHOLD = 300; // ms
+const DOUBLE_CLICK_DISTANCE = 2; // pixels
+/**
+ * Detect double-click by comparing with last click
+ */
+function detectDoubleClick(event) {
+    if (event.action !== 'click') {
+        return event;
+    }
+    const now = Date.now();
+    const last = clickState.lastClick;
+    if (last &&
+        last.button === event.button &&
+        now - last.time < DOUBLE_CLICK_THRESHOLD &&
+        Math.abs(event.x - last.x) <= DOUBLE_CLICK_DISTANCE &&
+        Math.abs(event.y - last.y) <= DOUBLE_CLICK_DISTANCE) {
+        // Double-click detected
+        clickState.lastClick = null;
+        return { ...event, action: 'double-click' };
+    }
+    // Store this click for potential double-click
+    clickState.lastClick = {
+        x: event.x,
+        y: event.y,
+        time: now,
+        button: event.button,
+    };
+    return event;
+}
+// =============================================================================
+// useMouse Hook
+// =============================================================================
+/**
+ * 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 function useMouse(handler, options = {}) {
+    const { isActive = true, enableTracking = true } = options;
+    // Get or create hook state for this useMouse call
+    const { value: hookData, isNew } = getHookState(null);
+    if (isNew || hookData === null) {
+        // First render - create wrapper and register
+        const inputWrapper = (input, _key) => {
+            // Check if this is a mouse event
+            const result = parseMouseEvent(input);
+            if (result) {
+                const data = getStoredHookData();
+                if (data && data.registered) {
+                    // Detect double-clicks
+                    const processedEvent = detectDoubleClick(result.event);
+                    data.handler(processedEvent);
+                }
+            }
+        };
+        const data = {
+            handler,
+            inputWrapper,
+            registered: isActive,
+            trackingEnabled: false,
+        };
+        // 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(inputWrapper);
+        }
+        if (enableTracking && isActive) {
+            enableMouseTracking();
+            data.trackingEnabled = true;
+        }
+    }
+    else {
+        // Subsequent render - update handler reference and active state
+        const prevRegistered = hookData.registered;
+        const prevTrackingEnabled = hookData.trackingEnabled;
+        hookData.handler = handler; // Update to latest handler
+        hookData.registered = isActive;
+        // Handle activation/deactivation
+        if (isActive && !prevRegistered) {
+            addInputHandler(hookData.inputWrapper);
+        }
+        else if (!isActive && prevRegistered) {
+            removeInputHandler(hookData.inputWrapper);
+        }
+        // Handle mouse tracking
+        const shouldTrack = enableTracking && isActive;
+        if (shouldTrack && !prevTrackingEnabled) {
+            enableMouseTracking();
+            hookData.trackingEnabled = true;
+        }
+        else if (!shouldTrack && prevTrackingEnabled) {
+            disableMouseTracking();
+            hookData.trackingEnabled = false;
+        }
+    }
+}
+// =============================================================================
+// Cleanup on process exit
+// =============================================================================
+// Ensure mouse tracking is disabled when the process exits
+process.on('exit', () => {
+    forceDisableMouseTracking();
+});
+process.on('SIGINT', () => {
+    forceDisableMouseTracking();
+    process.exit(0);
+});
+process.on('SIGTERM', () => {
+    forceDisableMouseTracking();
+    process.exit(0);
+});
+//# sourceMappingURL=use-mouse.js.map

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

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

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

@@ -0,0 +1,206 @@
+/**
+ * Linked Navigation - Slide navigation system
+ *
+ * Provides a doubly-linked list navigation system for slides,
+ * wizards, onboarding flows, and paginated content.
+ *
+ * Features:
+ * - O(1) next/prev navigation
+ * - Jump to first/last
+ * - Jump by index
+ * - History tracking
+ * - Transition callbacks
+ *
+ * @example
+ * ```typescript
+ * import { createLinkedNavigation, useNavigation } from 'tuiuiu.js';
+ *
+ * // Create navigation from items
+ * const nav = createLinkedNavigation([
+ *   { id: 'intro', content: 'Welcome!' },
+ *   { id: 'step1', content: 'Step 1' },
+ *   { id: 'step2', content: 'Step 2' },
+ *   { id: 'complete', content: 'Done!' },
+ * ]);
+ *
+ * // Navigate
+ * nav.next();     // Go to step1
+ * nav.prev();     // Go back to intro
+ * nav.goTo(3);    // Jump to complete
+ * nav.first();    // Go to intro
+ * nav.last();     // Go to complete
+ *
+ * // Get current
+ * const current = nav.current();
+ * console.log(current.data.content); // 'Complete!'
+ * ```
+ */
+export interface LinkedNode<T> {
+    /** Node data */
+    data: T;
+    /** Index in the list */
+    index: number;
+    /** Previous node */
+    prev: LinkedNode<T> | null;
+    /** Next node */
+    next: LinkedNode<T> | null;
+}
+export interface NavigationState<T> {
+    /** Get current node */
+    current: () => LinkedNode<T>;
+    /** Get current index (0-based) */
+    currentIndex: () => number;
+    /** Get total count */
+    count: () => number;
+    /** Check if at first item */
+    isFirst: () => boolean;
+    /** Check if at last item */
+    isLast: () => boolean;
+    /** Check if can go next */
+    canNext: () => boolean;
+    /** Check if can go prev */
+    canPrev: () => boolean;
+    /** Go to next item */
+    next: () => LinkedNode<T> | null;
+    /** Go to previous item */
+    prev: () => LinkedNode<T> | null;
+    /** Go to first item */
+    first: () => LinkedNode<T>;
+    /** Go to last item */
+    last: () => LinkedNode<T>;
+    /** Go to specific index */
+    goTo: (index: number) => LinkedNode<T> | null;
+    /** Go forward N items */
+    forward: (n: number) => LinkedNode<T>;
+    /** Go backward N items */
+    backward: (n: number) => LinkedNode<T>;
+    /** Get node at index */
+    at: (index: number) => LinkedNode<T> | null;
+    /** Get all nodes as array */
+    toArray: () => LinkedNode<T>[];
+    /** Map over all nodes */
+    map: <U>(fn: (node: LinkedNode<T>, index: number) => U) => U[];
+    /** Find node by predicate */
+    find: (predicate: (node: LinkedNode<T>) => boolean) => LinkedNode<T> | null;
+    /** Get navigation history */
+    history: () => number[];
+    /** Go back in history */
+    back: () => LinkedNode<T> | null;
+    /** Clear history */
+    clearHistory: () => void;
+}
+export interface NavigationOptions<T> {
+    /** Initial index (default: 0) */
+    initialIndex?: number;
+    /** Callback when navigation changes */
+    onChange?: (current: LinkedNode<T>, previous: LinkedNode<T> | null, direction: 'next' | 'prev' | 'jump') => void;
+    /** Callback before navigation (return false to cancel) */
+    beforeChange?: (current: LinkedNode<T>, target: LinkedNode<T>, direction: 'next' | 'prev' | 'jump') => boolean;
+    /** Enable looping (last → first, first → last) */
+    loop?: boolean;
+    /** Track navigation history */
+    trackHistory?: boolean;
+    /** Maximum history length */
+    maxHistory?: number;
+}
+/**
+ * Create a linked navigation system from array of items
+ */
+export declare function createLinkedNavigation<T>(items: T[], options?: NavigationOptions<T>): NavigationState<T>;
+/**
+ * Navigation hook for use in components
+ *
+ * @example
+ * ```typescript
+ * function Wizard() {
+ *   const nav = useNavigation([
+ *     { title: 'Step 1', component: Step1 },
+ *     { title: 'Step 2', component: Step2 },
+ *     { title: 'Step 3', component: Step3 },
+ *   ]);
+ *
+ *   useInput((_, key) => {
+ *     if (key.rightArrow) nav.next();
+ *     if (key.leftArrow) nav.prev();
+ *   });
+ *
+ *   const step = nav.current();
+ *   return step.data.component();
+ * }
+ * ```
+ */
+export declare function useNavigation<T>(items: T[], options?: NavigationOptions<T>): NavigationState<T>;
+export interface WizardStep<T = unknown> {
+    /** Step ID */
+    id: string;
+    /** Step title */
+    title: string;
+    /** Step description */
+    description?: string;
+    /** Step data */
+    data?: T;
+    /** Whether step can be skipped */
+    skippable?: boolean;
+    /** Validation function */
+    validate?: () => boolean | Promise<boolean>;
+}
+export interface WizardState<T = unknown> extends NavigationState<WizardStep<T>> {
+    /** Get step by ID */
+    getStep: (id: string) => LinkedNode<WizardStep<T>> | null;
+    /** Go to step by ID */
+    goToStep: (id: string) => LinkedNode<WizardStep<T>> | null;
+    /** Check if step is completed */
+    isCompleted: (index: number) => boolean;
+    /** Mark step as completed */
+    markCompleted: (index: number) => void;
+    /** Get all completed steps */
+    completedSteps: () => number[];
+    /** Get progress (0-1) */
+    progress: () => number;
+    /** Validate current step */
+    validateCurrent: () => Promise<boolean>;
+}
+/**
+ * Create a wizard navigation with validation and progress tracking
+ */
+export declare function createWizard<T = unknown>(steps: WizardStep<T>[], options?: NavigationOptions<WizardStep<T>>): WizardState<T>;
+export interface PageInfo {
+    /** Current page (1-based) */
+    page: number;
+    /** Total pages */
+    totalPages: number;
+    /** Items per page */
+    perPage: number;
+    /** Total items */
+    totalItems: number;
+    /** First item index on current page */
+    firstItem: number;
+    /** Last item index on current page */
+    lastItem: number;
+}
+export interface PaginationState<T> extends NavigationState<T[]> {
+    /** Get page info */
+    pageInfo: () => PageInfo;
+    /** Get items on current page */
+    items: () => T[];
+    /** Go to specific page (1-based) */
+    goToPage: (page: number) => T[] | null;
+}
+/**
+ * Create pagination from a flat array
+ *
+ * @example
+ * ```typescript
+ * const items = ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j'];
+ * const pagination = createPagination(items, { perPage: 3 });
+ *
+ * pagination.items();     // ['a', 'b', 'c']
+ * pagination.next();
+ * pagination.items();     // ['d', 'e', 'f']
+ * pagination.pageInfo();  // { page: 2, totalPages: 4, ... }
+ * ```
+ */
+export declare function createPagination<T>(items: T[], options?: NavigationOptions<T[]> & {
+    perPage?: number;
+}): PaginationState<T>;
+//# sourceMappingURL=use-navigation.d.ts.map

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

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