@mdxui/terminal 2.0.0

package/dist/interactive-D0JkWosD.d.ts

@@ -0,0 +1,217 @@
+/**
+ * @mdxui/terminal Interactive Renderer
+ *
+ * The Interactive renderer is the highest-capability tier providing:
+ * - Full TUI with keyboard navigation
+ * - Focus management and Tab cycling
+ * - Mouse click support
+ * - Cursor positioning
+ * - Real-time updates
+ * - Input field handling
+ * - Component state management
+ *
+ * @packageDocumentation
+ */
+/**
+ * Configuration options for creating an interactive renderer
+ */
+interface InteractiveRendererConfig {
+    /** Terminal width in columns */
+    width?: number;
+    /** Terminal height in rows */
+    height?: number;
+    /** Enable mouse support */
+    useMouse?: boolean;
+    /** Use alternate screen buffer */
+    useAlternateScreen?: boolean;
+    /** Wrap focus at boundaries */
+    wrapFocus?: boolean;
+    /** Enable vim-style key bindings */
+    vimBindings?: boolean;
+    /** Timeout for key sequences in ms */
+    sequenceTimeout?: number;
+    /** Target frames per second */
+    targetFps?: number;
+}
+/**
+ * Focusable element options
+ */
+interface FocusableOptions {
+    /** Tab order index */
+    tabIndex: number;
+    /** Focus group */
+    group?: string;
+    /** Callback when focused */
+    onFocus?: (event: {
+        id: string;
+    }) => void;
+    /** Callback when blurred */
+    onBlur?: (event: {
+        id: string;
+    }) => void;
+    /** Callback when activated */
+    onActivate?: (event: {
+        id: string;
+    }) => void;
+    /** Callback when toggled */
+    onToggle?: (event: {
+        id: string;
+    }) => void;
+    /** Whether element is disabled */
+    disabled?: boolean;
+    /** Column position for grid navigation */
+    column?: number;
+    /** Cursor position for input elements */
+    cursorPosition?: {
+        x: number;
+        y: number;
+    };
+    /** Whether to show cursor when focused */
+    showCursor?: boolean;
+}
+/**
+ * Clickable area options
+ */
+interface ClickableOptions {
+    /** X position */
+    x: number;
+    /** Y position */
+    y: number;
+    /** Width */
+    width: number;
+    /** Height */
+    height: number;
+    /** Z-index for layering */
+    zIndex?: number;
+    /** Whether clicking focuses the element */
+    focusable?: boolean;
+    /** Click handler */
+    onClick?: (event: {
+        x: number;
+        y: number;
+        id: string;
+    }) => void;
+    /** Double-click handler */
+    onDoubleClick?: () => void;
+    /** Right-click handler */
+    onRightClick?: () => void;
+}
+/**
+ * Input registration options
+ */
+interface InputOptions {
+    /** Current value */
+    value: string;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Input mask */
+    mask?: string;
+    /** Maximum length */
+    maxLength?: number;
+    /** Validation function */
+    validate?: (value: string) => boolean;
+    /** Whether multiline */
+    multiline?: boolean;
+    /** Current cursor index */
+    cursorIndex?: number;
+    /** Change handler */
+    onChange?: (value: string) => void;
+    /** Submit handler */
+    onSubmit?: (value: string) => void;
+}
+/**
+ * Component registration options
+ */
+interface ComponentOptions {
+    /** Component type */
+    type: string;
+    /** Additional options */
+    [key: string]: unknown;
+}
+/**
+ * Interactive renderer interface
+ */
+interface InteractiveRenderer {
+    width: number;
+    height: number;
+    start(): void;
+    stop(): void;
+    destroy(): void;
+    requestRender(): void;
+    focusNext(): void;
+    focusPrev(): void;
+    focusById(id: string): void;
+    getFocusedId(): string | null;
+    getFocusableIds(): string[];
+    registerFocusable(id: string, options: FocusableOptions): void;
+    unregisterFocusable(id: string): void;
+    setActiveGroup(group: string): void;
+    pushFocusTrap(group: string): void;
+    popFocusTrap(): void;
+    onKeyPress(key: string, handler: () => boolean | void, options?: {
+        priority?: number;
+    }): void;
+    offKeyPress(key: string, handler: () => boolean | void): void;
+    emitKey(key: string): void;
+    onKeySequence(sequence: string, handler: () => void): void;
+    getPendingSequence(): string;
+    onSearchMode(handler: () => void): void;
+    onCancel(handler: () => void): void;
+    getMode(): string;
+    onClick(handler: (event: {
+        x: number;
+        y: number;
+    }) => void): void;
+    offClick(handler: (event: {
+        x: number;
+        y: number;
+    }) => void): void;
+    emitClick(x: number, y: number, options?: {
+        clickCount?: number;
+        button?: string;
+    }): void;
+    registerClickable(id: string, options: ClickableOptions): void;
+    unregisterClickable(id: string): void;
+    getClickableAreas(): Array<{
+        id: string;
+    } & ClickableOptions>;
+    onScroll(handler: (event: {
+        deltaY: number;
+    }) => void): void;
+    emitScroll(x: number, y: number, options: {
+        deltaY: number;
+    }): void;
+    setCursorPosition(x: number, y: number): void;
+    getCursorPosition(): {
+        x: number;
+        y: number;
+    };
+    showCursor(): void;
+    hideCursor(): void;
+    isCursorVisible(): boolean;
+    setCursorStyle(style: 'block' | 'underline' | 'bar'): void;
+    getCursorStyle(): string;
+    setCursorBlink(blink: boolean): void;
+    isCursorBlinking(): boolean;
+    updateCursorPosition(id: string, position: {
+        x: number;
+        y: number;
+    }): void;
+    setState(key: string, value: unknown): void;
+    getState(key: string): unknown;
+    subscribe(key: string, subscriber: (newValue: unknown, oldValue: unknown) => void): () => void;
+    onRender(handler: () => void): void;
+    getTargetFps(): number;
+    registerInput(id: string, options: InputOptions): void;
+    getInputCursorIndex(id: string): number;
+    registerComponent(id: string, options: ComponentOptions): void;
+    unregisterComponent(id: string): void;
+    getComponent(id: string): ComponentOptions | undefined;
+    updateComponent(id: string, updates: Partial<ComponentOptions>): void;
+}
+/**
+ * Creates an interactive renderer instance.
+ */
+declare function createInteractiveRenderer(config?: InteractiveRendererConfig): Promise<InteractiveRenderer>;
+
+export { type ClickableOptions as C, type FocusableOptions as F, type InteractiveRenderer as I, type InteractiveRendererConfig as a, type InputOptions as b, createInteractiveRenderer as c, type ComponentOptions as d };

package/dist/keyboard/index.d.ts

@@ -0,0 +1,2 @@
+export { h as ARROW_BINDINGS, A as ActionContext, c as ActionHandler, y as AttachKeyboardOptions, C as COMMON_BINDINGS, D as DetachKeyboard, E as EMACS_BINDINGS, r as FocusContext, k as FocusManagerState, x as FocusProvider, q as FocusProviderProps, F as FocusableElement, f as KEY, b as KeyBindings, K as KeyModifiers, a as KeyboardAction, e as KeyboardManager, d as KeyboardManagerOptions, N as NormalizedKey, O as OpenTUIKeyEvent, R as ReadlineKey, j as UseFocusOptions, U as UseKeyboardOptions, i as UseKeyboardResult, o as UseNavigableGridOptions, p as UseNavigableGridResult, l as UseNavigableListOptions, n as UseNavigableListResult, V as VIM_BINDINGS, G as attachKeyboardManager, g as createKeyboardManager, I as createOpenTUIKeyHandler, B as keyToBindingString, m as matchKey, H as normalizeOpenTUIKey, z as normalizeReadlineKey, s as useFocus, t as useFocusManager, u as useKeyboard, w as useNavigableGrid, v as useNavigableList } from '../index-CQRFZntR.js';
+import 'react';

package/dist/keyboard/index.js

@@ -0,0 +1,43 @@
+import {
+  ARROW_BINDINGS,
+  COMMON_BINDINGS,
+  EMACS_BINDINGS,
+  FocusContext,
+  FocusProvider,
+  KEY,
+  VIM_BINDINGS,
+  attachKeyboardManager,
+  createKeyboardManager,
+  createOpenTUIKeyHandler,
+  keyToBindingString,
+  matchKey,
+  normalizeOpenTUIKey,
+  normalizeReadlineKey,
+  useFocus,
+  useFocusManager,
+  useKeyboard,
+  useNavigableGrid,
+  useNavigableList
+} from "../chunk-GBQ6UD6I.js";
+import "../chunk-3RG5ZIWI.js";
+export {
+  ARROW_BINDINGS,
+  COMMON_BINDINGS,
+  EMACS_BINDINGS,
+  FocusContext,
+  FocusProvider,
+  KEY,
+  VIM_BINDINGS,
+  attachKeyboardManager,
+  createKeyboardManager,
+  createOpenTUIKeyHandler,
+  keyToBindingString,
+  matchKey,
+  normalizeOpenTUIKey,
+  normalizeReadlineKey,
+  useFocus,
+  useFocusManager,
+  useKeyboard,
+  useNavigableGrid,
+  useNavigableList
+};