@visulima/tui 2.0.0 → 3.0.0

package/dist/react/index.d.ts

@@ -1,15 +1,12 @@
 import React, { Context, RefObject, ReactNode } from 'react';
-import { M as MouseEvent, T as TuiApp, c as InputParser, a as InlineOptions } from "../packem_shared/input.d-D-Yxqha8.js";
+import { M as MouseEvent, T as TuiApp, c as InputParser, a as InlineOptions } from "../packem_shared/input.d-CL_4MfL-.js";
 import Yoga from 'yoga-layout';
 interface DevToolsProps {
   children: React.ReactNode;
   /** Show/hide the HUD without unmounting (default: true) */
   enabled?: boolean;
 }
-declare const DevTools: ({
-  children,
-  enabled
-}: DevToolsProps) => React.ReactElement;
+declare const DevTools: ({ children, enabled }: DevToolsProps) => React.ReactElement;
 type FocusContextProps = {
   activate: (id: string) => void;
   activeId: string | undefined;
@@ -37,11 +34,7 @@ type UseFocusResult = {
   focus: (id: string) => void;
   isFocused: boolean;
 };
-declare const useFocus: ({
-  autoFocus,
-  id: customId,
-  isActive
-}?: UseFocusOptions) => UseFocusResult;
+declare const useFocus: ({ autoFocus, id: customId, isActive }?: UseFocusOptions) => UseFocusResult;
 type UseFocusManagerResult = {
   activeId: string | undefined;
   disableFocus: () => void;
@@ -71,13 +64,13 @@ declare class LayoutNode {
   remove(): void;
   removeChild(child: LayoutNode): void;
   /**
-  * Free this node's Yoga allocation. Called via detachDeletedInstance
-  * in the reconciler after React has permanently removed this node.
-  *
-  * Does NOT recurse — React calls detachDeletedInstance on every node
-  * in a deleted subtree individually, so each node frees only itself.
-  * The _destroyed guard prevents double-free if free() is also called.
-  */
+   * Free this node's Yoga allocation. Called via detachDeletedInstance
+   * in the reconciler after React has permanently removed this node.
+   *
+   * Does NOT recurse — React calls detachDeletedInstance on every node
+   * in a deleted subtree individually, so each node frees only itself.
+   * The _destroyed guard prevents double-free if free() is also called.
+   */
   destroy(): void;
   calculateLayout(width: number, height: number): void;
   getLayout(): ReturnType<YogaNode$1["getComputedLayout"]>;
@@ -109,54 +102,54 @@ interface Key {
 }
 type InputHandler = (input: string, key: Key) => void;
 /**
-* Subscribes to keyboard input. Uses a stable ref so the effect runs
-* exactly once (on mount) regardless of how often the component re-renders.
-* Always invokes the latest handler passed by the caller.
-*/
+ * Subscribes to keyboard input. Uses a stable ref so the effect runs
+ * exactly once (on mount) regardless of how often the component re-renders.
+ * Always invokes the latest handler passed by the caller.
+ */
 declare const useInput: (handler: InputHandler) => void;
 interface UsePasteOptions {
   /**
-  * Enable or disable capturing pasted text.
-  * Useful when multiple components use usePaste and only one should be active.
-  * @default true
-  */
+   * Enable or disable capturing pasted text.
+   * Useful when multiple components use usePaste and only one should be active.
+   * @default true
+   */
   isActive?: boolean;
 }
 type PasteHandler = (text: string) => void;
 /**
-* Subscribe to bracketed paste events.
-*
-* `usePaste` and `useInput` can be used together. Paste content is delivered
-* through this hook and not forwarded to useInput while at least one paste
-* listener is active.
-*/
+ * Subscribe to bracketed paste events.
+ *
+ * `usePaste` and `useInput` can be used together. Paste content is delivered
+ * through this hook and not forwarded to useInput while at least one paste
+ * listener is active.
+ */
 declare const usePaste: (handler: PasteHandler, options?: UsePasteOptions) => void;
 /**
-* Raw access to the TuiContext — app instance + input parser.
-* Useful for advanced integrations (e.g. DevTools, custom hooks).
-*/
+ * Raw access to the TuiContext — app instance + input parser.
+ * Useful for advanced integrations (e.g. DevTools, custom hooks).
+ */
 declare const useTuiContext: () => TuiContextProps;
 /**
-* Access app controls. Returns { exit } for Ink compatibility.
-* exit() triggers a clean shutdown (restores terminal, stops input, exits process).
-*/
+ * Access app controls. Returns { exit } for Ink compatibility.
+ * exit() triggers a clean shutdown (restores terminal, stops input, exits process).
+ */
 declare const useApp: () => {
   exit: () => void;
   quit: () => void;
 };
 /**
-* Returns current terminal dimensions and re-renders on resize (SIGWINCH).
-* Ink-compatible: const { columns, rows } = useWindowSize()
-*/
+ * Returns current terminal dimensions and re-renders on resize (SIGWINCH).
+ * Ink-compatible: const { columns, rows } = useWindowSize()
+ */
 declare const useWindowSize: () => {
   columns: number;
   rows: number;
 };
 /**
-* Write to stdout without disturbing the TUI.
-* Ink-compatible: const { write, stdout } = useStdout()
-* Output is buffered while the alternate screen is active and flushed on exit.
-*/
+ * Write to stdout without disturbing the TUI.
+ * Ink-compatible: const { write, stdout } = useStdout()
+ * Output is buffered while the alternate screen is active and flushed on exit.
+ */
 declare const useStdout: () => {
   stdout: NodeJS.WriteStream & {
     fd: 1;
@@ -164,10 +157,10 @@ declare const useStdout: () => {
   write: (text: string) => void;
 };
 /**
-* Write to stderr without disturbing the TUI.
-* Ink-compatible: const { write, stderr } = useStderr()
-* Output is buffered while the alternate screen is active and flushed on exit.
-*/
+ * Write to stderr without disturbing the TUI.
+ * Ink-compatible: const { write, stderr } = useStderr()
+ * Output is buffered while the alternate screen is active and flushed on exit.
+ */
 declare const useStderr: () => {
   stderr: NodeJS.WriteStream & {
     fd: 2;
@@ -175,9 +168,9 @@ declare const useStderr: () => {
   write: (text: string) => void;
 };
 /**
-* Access raw stdin stream and raw mode controls.
-* Ink-compatible: const { stdin, setRawMode, isRawModeSupported } = useStdin()
-*/
+ * Access raw stdin stream and raw mode controls.
+ * Ink-compatible: const { stdin, setRawMode, isRawModeSupported } = useStdin()
+ */
 declare const useStdin: () => {
   isRawModeSupported: boolean;
   setRawMode: (value: boolean) => void;
@@ -186,11 +179,11 @@ declare const useStdin: () => {
   };
 };
 /**
-* Measure the dimensions of a Box element.
-* Returns { width, height } after layout has been calculated.
-* Returns { width: 0, height: 0 } when called during render (before layout).
-* Ink-compatible: measureElement(ref.current)
-*/
+ * Measure the dimensions of a Box element.
+ * Returns { width, height } after layout has been calculated.
+ * Returns { width: 0, height: 0 } when called during render (before layout).
+ * Ink-compatible: measureElement(ref.current)
+ */
 declare const measureElement: (node: LayoutNode | null) => {
   height: number;
   width: number;
@@ -205,23 +198,23 @@ interface UseBoxMetricsResult extends BoxMetrics {
   readonly hasMeasured: boolean;
 }
 /**
-* Returns the current layout metrics for a Box ref, updating on every render
-* and on terminal resize.
-* Ink-compatible: const { width, height, left, top, hasMeasured } = useBoxMetrics(ref)
-*/
+ * Returns the current layout metrics for a Box ref, updating on every render
+ * and on terminal resize.
+ * Ink-compatible: const { width, height, left, top, hasMeasured } = useBoxMetrics(ref)
+ */
 declare const useBoxMetrics: (ref: RefObject<LayoutNode | null>) => UseBoxMetricsResult;
 /**
-* Returns whether a screen reader is enabled.
-* Stub: always returns false — no screen reader support.
-* Ink-compatible: const isEnabled = useIsScreenReaderEnabled()
-*/
+ * Returns whether a screen reader is enabled.
+ * Stub: always returns false — no screen reader support.
+ * Ink-compatible: const isEnabled = useIsScreenReaderEnabled()
+ */
 declare const useIsScreenReaderEnabled: () => boolean;
 /**
-* Returns cursor positioning controls.
-* Stub: the native renderer hides the cursor during rendering (alternate screen).
-* setCursorPosition is a no-op — provided for Ink API compatibility only.
-* Ink-compatible: const { setCursorPosition } = useCursor()
-*/
+ * Returns cursor positioning controls.
+ * Stub: the native renderer hides the cursor during rendering (alternate screen).
+ * setCursorPosition is a no-op — provided for Ink API compatibility only.
+ * Ink-compatible: const { setCursorPosition } = useCursor()
+ */
 declare const useCursor: () => {
   setCursorPosition: (position: {
     x: number;
@@ -229,22 +222,22 @@ declare const useCursor: () => {
   } | undefined) => void;
 };
 /**
-* Scroll state for a fixed-height viewport over variable-height content.
-*
-* Usage:
-*   const scroll = useScrollable({ viewportHeight: 20, contentHeight: totalRows })
-*
-*   &lt;Box height={20}>
-*     &lt;Box marginTop={-scroll.offset}>
-*       {items}
-*     &lt;/Box>
-*   &lt;/Box>
-*
-* contentHeight can be updated as content grows. The offset is automatically
-* clamped so it never scrolls past the end.
-*
-* scrollToBottom() is idempotent — safe to call on every new message append.
-*/
+ * Scroll state for a fixed-height viewport over variable-height content.
+ *
+ * Usage:
+ *   const scroll = useScrollable({ viewportHeight: 20, contentHeight: totalRows })
+ *
+ *   &lt;Box height={20}>
+ *     &lt;Box marginTop={-scroll.offset}>
+ *       {items}
+ *     &lt;/Box>
+ *   &lt;/Box>
+ *
+ * contentHeight can be updated as content grows. The offset is automatically
+ * clamped so it never scrolls past the end.
+ *
+ * scrollToBottom() is idempotent — safe to call on every new message append.
+ */
 interface UseScrollableOptions {
   /** Total height of the content in rows — update as content grows */
   contentHeight: number;
@@ -269,24 +262,21 @@ interface UseScrollableResult {
   /** Scroll up one row */
   scrollUp: () => void;
 }
-declare const useScrollable: ({
-  contentHeight,
-  viewportHeight
-}: UseScrollableOptions) => UseScrollableResult;
+declare const useScrollable: ({ contentHeight, viewportHeight }: UseScrollableOptions) => UseScrollableResult;
 type MouseHandler = (event: MouseEvent) => void;
 /**
-* Subscribe to mouse events. Requires mouse tracking to be enabled (it is by
-* default — TerminalGuard enables SGR 1006 mouse tracking on start).
-*
-* Usage:
-*   useMouse((event) => {
-*     if (event.button === 'left') { ... }
-*     if (event.button === 'scrollUp') { ... }
-*     // event: { x, y, button, shift, ctrl, meta }
-*   })
-*
-* button values: 'left' | 'right' | 'middle' | 'scrollUp' | 'scrollDown'
-*/
+ * Subscribe to mouse events. Requires mouse tracking to be enabled (it is by
+ * default — TerminalGuard enables SGR 1006 mouse tracking on start).
+ *
+ * Usage:
+ *   useMouse((event) => {
+ *     if (event.button === 'left') { ... }
+ *     if (event.button === 'scrollUp') { ... }
+ *     // event: { x, y, button, shift, ctrl, meta }
+ *   })
+ *
+ * button values: 'left' | 'right' | 'middle' | 'scrollUp' | 'scrollDown'
+ */
 declare const useMouse: (handler: MouseHandler) => void;
 interface UseTextInputOptions {
   /** Initial value (default: '') */
@@ -309,22 +299,17 @@ interface UseTextInputResult {
   value: string;
 }
 /**
-* Managed text input with cursor, backspace, delete, left/right navigation,
-* home/end, bracketed paste, and submit on Enter.
-*
-* Usage:
-*   const { value, cursor } = useTextInput({ onSubmit: (v) => console.log(v) })
-*   &lt;Text>{value.slice(0, cursor)}&lt;Text inverse> &lt;/Text>{value.slice(cursor)}&lt;/Text>
-*
-* Renders a block cursor by inverting the character at cursor position.
-* When cursor is at end, renders a trailing space as the cursor block.
-*/
-declare const useTextInput: ({
-  initialValue,
-  isActive,
-  onChange,
-  onSubmit
-}?: UseTextInputOptions) => UseTextInputResult;
+ * Managed text input with cursor, backspace, delete, left/right navigation,
+ * home/end, bracketed paste, and submit on Enter.
+ *
+ * Usage:
+ *   const { value, cursor } = useTextInput({ onSubmit: (v) => console.log(v) })
+ *   &lt;Text>{value.slice(0, cursor)}&lt;Text inverse> &lt;/Text>{value.slice(cursor)}&lt;/Text>
+ *
+ * Renders a block cursor by inverting the character at cursor position.
+ * When cursor is at end, renders a trailing space as the cursor block.
+ */
+declare const useTextInput: ({ initialValue, isActive, onChange, onSubmit }?: UseTextInputOptions) => UseTextInputResult;
 /** Ink-compat render options */
 interface RenderOptions {
   /** Ignored — the native renderer is always concurrent */
@@ -358,18 +343,18 @@ interface InlineInstance {
   waitUntilExit: () => Promise<void>;
 }
 /**
-* Render a React element inline — no alternate screen. The UI appears
-* directly below the current shell prompt and stays in terminal scrollback
-* on exit (or is destroyed if `onExit: 'destroy'` is set).
-*
-* The root Box is sized to `cols × rows`. Use `useInput` and `useApp`
-* exactly as in a full-screen render.
-* @example
-* ```tsx
-* const { waitUntilExit } = renderInline(<Picker />, { rows: 12, onExit: 'destroy' })
-* await waitUntilExit()
-* ```
-*/
+ * Render a React element inline — no alternate screen. The UI appears
+ * directly below the current shell prompt and stays in terminal scrollback
+ * on exit (or is destroyed if `onExit: 'destroy'` is set).
+ *
+ * The root Box is sized to `cols × rows`. Use `useInput` and `useApp`
+ * exactly as in a full-screen render.
+ * @example
+ * ```tsx
+ * const { waitUntilExit } = renderInline(<Picker />, { rows: 12, onExit: 'destroy' })
+ * await waitUntilExit()
+ * ```
+ */
 declare function renderInline(element: React.ReactElement, options?: InlineOptions & {
   maxFps?: number;
 }): InlineInstance;
@@ -380,27 +365,27 @@ interface RenderToStringOptions {
   rows?: number;
 }
 /**
-* Render a React element to a plain string synchronously.
-* No TTY, no stdin, no alternate screen — pure layout + buffer read-back.
-*
-* Useful for testing, documentation generation, and any scenario where
-* you need rendered output as a string without a live terminal.
-*
-* Notes:
-* - Terminal hooks (useInput, useApp, useStdin, useStdout, useStderr,
-*   useFocus, useFocusManager) return safe no-op defaults — they do not throw.
-* - useEffect callbacks run but state updates they trigger do not affect output.
-* - useLayoutEffect callbacks fire synchronously and DO affect output.
-*/
+ * Render a React element to a plain string synchronously.
+ * No TTY, no stdin, no alternate screen — pure layout + buffer read-back.
+ *
+ * Useful for testing, documentation generation, and any scenario where
+ * you need rendered output as a string without a live terminal.
+ *
+ * Notes:
+ * - Terminal hooks (useInput, useApp, useStdin, useStdout, useStderr,
+ *   useFocus, useFocusManager) return safe no-op defaults — they do not throw.
+ * - useEffect callbacks run but state updates they trigger do not affect output.
+ * - useLayoutEffect callbacks fire synchronously and DO affect output.
+ */
 declare function renderToString(element: React.ReactElement, options?: RenderToStringOptions): string;
 declare function renderTreeToBuffer(root: LayoutNode, buffer: Uint32Array, cols: number, rows: number): void;
 type YogaNode = ReturnType<typeof Yoga.Node.create>;
 declare const NAMED_COLORS: Record<string, number>;
 /**
-* Resolve a color value to an ANSI 256-color index.
-* Accepts: number (pass-through), string name ("green"), hex ("#FF8800"),
-* rgb() ("rgb(255,136,0)"), ansi256() ("ansi256(42)"), or undefined (→ 255 = terminal default).
-*/
+ * Resolve a color value to an ANSI 256-color index.
+ * Accepts: number (pass-through), string name ("green"), hex ("#FF8800"),
+ * rgb() ("rgb(255,136,0)"), ansi256() ("ansi256(42)"), or undefined (→ 255 = terminal default).
+ */
 declare function resolveColor(color: number | string | undefined): number;
 type Styles = {
   alignContent?: "flex-start" | "flex-end" | "center" | "stretch" | "space-between" | "space-around";
@@ -432,7 +417,8 @@ type Styles = {
   flexShrink?: number;
   flexWrap?: "nowrap" | "wrap" | "wrap-reverse";
   gap?: number;
-  height?: number | string; /** Internal flag for sticky header alternate nodes */
+  height?: number | string;
+  /** Internal flag for sticky header alternate nodes */
   internalStickyAlternate?: boolean;
   inverse?: boolean;
   italic?: boolean;
@@ -476,43 +462,39 @@ type Styles = {
 declare const applyStyles: (node: YogaNode, style?: Styles, currentStyle?: Styles) => void;
 type StaticProps<T> = {
   /**
-  * Render function called for each item. Must assign a unique `key` to the
-  * root element returned.
-  */
+   * Render function called for each item. Must assign a unique `key` to the
+   * root element returned.
+   */
   readonly children: (item: T, index: number) => ReactNode;
   /**
-  * Array of items to render. Only newly-added items are rendered into the layout —
-  * previously rendered items are frozen (never re-rendered or cleared).
-  * Ideal for streaming output: completed tasks, log lines, test results.
-  */
+   * Array of items to render. Only newly-added items are rendered into the layout —
+   * previously rendered items are frozen (never re-rendered or cleared).
+   * Ideal for streaming output: completed tasks, log lines, test results.
+   */
   readonly items: T[];
   /**
-  * Optional styles for the static container Box.
-  */
+   * Optional styles for the static container Box.
+   */
   readonly style?: Record<string, unknown>;
 };
 /**
-* `&lt;Static>` permanently renders its output above the dynamic UI.
-*
-* Items are rendered once and frozen — they are never re-rendered or cleared.
-* New items appended to `items` are rendered incrementally and accumulate
-* in the layout above the dynamic content.
-*
-* Matches the Ink `&lt;Static>` API exactly.
-* @example
-* ```tsx
-* <Static items={completedTasks}>
-*   {task => (
-*     <Box key={task.id}>
-*       <Text color="green">✔ {task.title}</Text>
-*     </Box>
-*   )}
-* </Static>
-* ```
-*/
-declare function Static<T>({
-  children: renderItem,
-  items,
-  style
-}: StaticProps<T>): React.ReactElement;
+ * `&lt;Static>` permanently renders its output above the dynamic UI.
+ *
+ * Items are rendered once and frozen — they are never re-rendered or cleared.
+ * New items appended to `items` are rendered incrementally and accumulate
+ * in the layout above the dynamic content.
+ *
+ * Matches the Ink `&lt;Static>` API exactly.
+ * @example
+ * ```tsx
+ * <Static items={completedTasks}>
+ *   {task => (
+ *     <Box key={task.id}>
+ *       <Text color="green">✔ {task.title}</Text>
+ *     </Box>
+ *   )}
+ * </Static>
+ * ```
+ */
+declare function Static<T>({ children: renderItem, items, style }: StaticProps<T>): React.ReactElement;
 export { BoxMetrics, DevTools, DevToolsProps, FocusContext, FocusContextProps, FocusProvider, type InlineInstance, InputHandler, type Instance, Key, LayoutNode, MouseHandler, NAMED_COLORS, PasteHandler, type RenderOptions, RenderToStringOptions, Static, StaticProps, Styles, TuiContext, TuiContextProps, UseBoxMetricsResult, UseFocusManagerResult, UseFocusOptions, UseFocusResult, UsePasteOptions, UseScrollableOptions, UseScrollableResult, UseTextInputOptions, UseTextInputResult, applyStyles, measureElement, render, renderInline, renderToString, renderTreeToBuffer, resolveColor, useApp, useBoxMetrics, useCursor, useFocus, useFocusManager, useInput, useIsScreenReaderEnabled, useMouse, usePaste, useScrollable, useStderr, useStdin, useStdout, useTextInput, useTuiContext, useWindowSize };

package/dist/react/index.js

@@ -1 +1 @@
-import{DevTools as o}from"../packem_shared/DevTools-D9tfChBc.js";import{FocusContext as u,FocusProvider as s,useFocus as n,useFocusManager as p}from"../packem_shared/FocusContext-C2Sosxa4.js";import{TuiContext as d,measureElement as f,useApp as l,useBoxMetrics as m,useCursor as a,useInput as i,useIsScreenReaderEnabled as S,useMouse as c,usePaste as T,useScrollable as C,useStderr as F,useStdin as I,useStdout as M,useTextInput as v,useTuiContext as y,useWindowSize as E}from"../packem_shared/TuiContext-BNmP0lMY.js";import{render as g,renderInline as A}from"../packem_shared/render-DMcWfI6-.js";import{renderToString as D}from"../packem_shared/renderToString-DkTmJPaS.js";import{Static as N}from"../packem_shared/Static-DSzsElz4.js";import{LayoutNode as P}from"../packem_shared/LayoutNode-LPYsuzBg.js";import{NAMED_COLORS as w,applyStyles as z,resolveColor as W}from"../packem_shared/NAMED_COLORS-82DpREQV.js";import{renderTreeToBuffer as h}from"../packem_shared/renderTreeToBuffer-BpSD0sBJ.js";export{o as DevTools,u as FocusContext,s as FocusProvider,P as LayoutNode,w as NAMED_COLORS,N as Static,d as TuiContext,z as applyStyles,f as measureElement,g as render,A as renderInline,D as renderToString,h as renderTreeToBuffer,W as resolveColor,l as useApp,m as useBoxMetrics,a as useCursor,n as useFocus,p as useFocusManager,i as useInput,S as useIsScreenReaderEnabled,c as useMouse,T as usePaste,C as useScrollable,F as useStderr,I as useStdin,M as useStdout,v as useTextInput,y as useTuiContext,E as useWindowSize};
+import{DevTools as o}from"../packem_shared/DevTools-CZ-O0Ckm.js";import{FocusContext as u,FocusProvider as s,useFocus as n,useFocusManager as p}from"../packem_shared/FocusContext-BWFqf9kb.js";import{TuiContext as d,measureElement as f,useApp as l,useBoxMetrics as m,useCursor as a,useInput as i,useIsScreenReaderEnabled as S,useMouse as c,usePaste as T,useScrollable as C,useStderr as F,useStdin as I,useStdout as M,useTextInput as v,useTuiContext as y,useWindowSize as E}from"../packem_shared/TuiContext-BNmP0lMY.js";import{render as g,renderInline as A}from"../packem_shared/render-CPVY5vpQ.js";import{renderToString as D}from"../packem_shared/renderToString-Df6HST7u.js";import{Static as N}from"../packem_shared/Static-DSzsElz4.js";import{LayoutNode as P}from"../packem_shared/LayoutNode-LPYsuzBg.js";import{NAMED_COLORS as w,applyStyles as z,resolveColor as W}from"../packem_shared/NAMED_COLORS-82DpREQV.js";import{renderTreeToBuffer as h}from"../packem_shared/renderTreeToBuffer-BpSD0sBJ.js";export{o as DevTools,u as FocusContext,s as FocusProvider,P as LayoutNode,w as NAMED_COLORS,N as Static,d as TuiContext,z as applyStyles,f as measureElement,g as render,A as renderInline,D as renderToString,h as renderTreeToBuffer,W as resolveColor,l as useApp,m as useBoxMetrics,a as useCursor,n as useFocus,p as useFocusManager,i as useInput,S as useIsScreenReaderEnabled,c as useMouse,T as usePaste,C as useScrollable,F as useStderr,I as useStdin,M as useStdout,v as useTextInput,y as useTuiContext,E as useWindowSize};