@visulima/tui 1.0.0-alpha.1 → 1.0.0-alpha.10

package/dist/ink/mouse/ansi-parser.d.ts

@@ -1,37 +0,0 @@
-/**
- * Ported from `\@zenobius/ink-mouse` (https://github.com/zenobi-us/ink-mouse)
- * Copyright Zeno Jiricek, licensed under Apache-2.0
- *
- * Rewritten to use a unified SGR 1006 parser with full button support.
- */
-import type { MouseButton } from "./mouse-context.d.ts";
-type SgrMouseEvent = {
-    action: "press" | "release";
-    button: MouseButton;
-    type: "click";
-    x: number;
-    y: number;
-} | {
-    action: "press" | "release";
-    button: MouseButton;
-    type: "drag";
-    x: number;
-    y: number;
-} | {
-    type: "move";
-    x: number;
-    y: number;
-} | {
-    direction: "scrolldown" | "scrollup";
-    type: "scroll";
-    x: number;
-    y: number;
-};
-/**
- * Parse an SGR 1006 mouse escape sequence into a structured event.
- *
- * Returns `undefined` if the input is not a valid SGR mouse sequence.
- */
-declare const parseSgrMouse: (input: string) => SgrMouseEvent | undefined;
-export { parseSgrMouse };
-export type { SgrMouseEvent };

package/dist/ink/mouse/constants.d.ts

@@ -1,59 +0,0 @@
-/**
- * Ported from `\@zenobius/ink-mouse` (https://github.com/zenobi-us/ink-mouse)
- * Copyright Zeno Jiricek, licensed under Apache-2.0
- */
-declare const ANSI_CODES: {
-    alternateScroll: {
-        off: string;
-        on: string;
-    };
-    mouseButton: {
-        off: string;
-        on: string;
-    };
-    mouseDrag: {
-        off: string;
-        on: string;
-    };
-    mouseFocus: {
-        off: string;
-        on: string;
-    };
-    mouseHighlight: {
-        off: string;
-        on: string;
-    };
-    mouseMotion: {
-        off: string;
-        on: string;
-    };
-    mouseMotionOthers: {
-        off: string;
-        on: string;
-    };
-    mousePixelMode: {
-        off: string;
-        on: string;
-    };
-    mouseSGR: {
-        off: string;
-        on: string;
-    };
-    mouseUtf8: {
-        off: string;
-        on: string;
-    };
-    mouseX10: {
-        off: string;
-        on: string;
-    };
-};
-/**
- * Unified SGR 1006 mouse sequence pattern.
- *
- * Captures: (buttonCode) (x) (y) (M|m)
- * - M = press/motion, m = release
- * - Button code includes modifier bits (shift=+4, meta=+8, ctrl=+16)
- */
-declare const SGR_MOUSE_PATTERN: RegExp;
-export { ANSI_CODES, SGR_MOUSE_PATTERN };

package/dist/ink/mouse/index.d.ts

@@ -1,20 +0,0 @@
-/**
- * Mouse tracking for terminal UIs.
- *
- * Ported from `\@zenobius/ink-mouse` (https://github.com/zenobi-us/ink-mouse)
- * Copyright Zeno Jiricek, licensed under Apache-2.0
- */
-export type { SgrMouseEvent } from "./ansi-parser.d.ts";
-export { parseSgrMouse } from "./ansi-parser.d.ts";
-export { default as Fullscreen } from "./Fullscreen.d.ts";
-export { default as isIntersecting } from "./is-intersecting.d.ts";
-export type { MouseAction, MouseButton, MouseClickAction, MouseContextShape, MouseDragAction, MouseEvents, MousePosition, MouseScrollAction, } from "./mouse-context.d.ts";
-export { default as MouseProvider } from "./MouseProvider.d.ts";
-export { useElementDimensions, useElementPosition } from "./use-element-position.d.ts";
-export { default as useMouseContext } from "./use-mouse.d.ts";
-export { default as useMouseAction } from "./use-mouse-action.d.ts";
-export { default as useMousePosition } from "./use-mouse-position.d.ts";
-export type { UseOnMouseClickOptions } from "./use-on-mouse-click.d.ts";
-export { useOnMouseClick } from "./use-on-mouse-click.d.ts";
-export { default as useOnMouseHover } from "./use-on-mouse-hover.d.ts";
-export { default as useOnMouseState } from "./use-on-mouse-state.d.ts";

package/dist/ink/mouse/is-intersecting.d.ts

@@ -1,18 +0,0 @@
-/**
- * Ported from `\@zenobius/ink-mouse` (https://github.com/zenobi-us/ink-mouse)
- * Copyright Zeno Jiricek, licensed under Apache-2.0
- */
-import type { MousePosition } from "./mouse-context.d.ts";
-/**
- * Determines if the mouse position is intersecting with the element's layout bounds.
- */
-declare const isIntersecting: ({ element, mouse: { x, y }, }: {
-    element: {
-        height: number;
-        left: number;
-        top: number;
-        width: number;
-    };
-    mouse: MousePosition;
-}) => boolean;
-export default isIntersecting;

package/dist/ink/mouse/mouse-context.d.ts

@@ -1,36 +0,0 @@
-/**
- * Ported from `\@zenobius/ink-mouse` (https://github.com/zenobi-us/ink-mouse)
- * Copyright Zeno Jiricek, licensed under Apache-2.0
- */
-import type { EventEmitter } from "node:events";
-import type { Context } from "react";
-type MousePosition = {
-    x: number;
-    y: number;
-};
-type MouseButton = "left" | "middle" | "right";
-type MouseClickAction = "press" | "release" | null;
-type MouseScrollAction = "scrolldown" | "scrollup" | null;
-type MouseDragAction = "dragging" | null;
-type MouseAction = MouseClickAction | MouseDragAction | MouseScrollAction;
-/**
- * Internal event emitter for mouse state changes.
- *
- * Events:
- * - "position" (position: MousePosition)
- * - "click" (position: MousePosition, action: MouseClickAction, button: MouseButton)
- * - "scroll" (position: MousePosition, direction: MouseScrollAction)
- * - "drag" (position: MousePosition, action: MouseDragAction, button: MouseButton)
- */
-type MouseEvents = EventEmitter;
-type MouseContextShape = {
-    readonly button: MouseButton | null;
-    readonly click: MouseClickAction;
-    readonly drag: MouseDragAction;
-    readonly events: MouseEvents;
-    readonly position: MousePosition;
-    readonly scroll: MouseScrollAction;
-};
-declare const MouseContext: Context<MouseContextShape | null>;
-export { MouseContext };
-export type { MouseAction, MouseButton, MouseClickAction, MouseContextShape, MouseDragAction, MouseEvents, MousePosition, MouseScrollAction };

package/dist/ink/mouse/use-element-position.d.ts

@@ -1,29 +0,0 @@
-/**
- * Ported from `\@zenobius/ink-mouse` (https://github.com/zenobi-us/ink-mouse)
- * Copyright Zeno Jiricek, licensed under Apache-2.0
- */
-import type { RefObject } from "react";
-import type { DOMElement } from "../dom.d.ts";
-declare const getElementPosition: (node: DOMElement | null) => {
-    left: number;
-    top: number;
-} | undefined;
-declare const getElementDimensions: (node: DOMElement | null) => {
-    height: number;
-    width: number;
-} | undefined;
-/**
- * Stateful hook to provide the absolute position of the referenced element.
- */
-declare const useElementPosition: (ref: RefObject<DOMElement | null>, deps?: unknown[]) => {
-    left: number;
-    top: number;
-};
-/**
- * Stateful hook to provide the dimensions of the referenced element.
- */
-declare const useElementDimensions: (ref: RefObject<DOMElement | null>, deps?: unknown[]) => {
-    height: number;
-    width: number;
-};
-export { getElementDimensions, getElementPosition, useElementDimensions, useElementPosition };

package/dist/ink/mouse/use-mouse-action.d.ts

@@ -1,7 +0,0 @@
-/**
- * Ported from `\@zenobius/ink-mouse` (https://github.com/zenobi-us/ink-mouse)
- * Copyright Zeno Jiricek, licensed under Apache-2.0
- */
-import type { MouseClickAction, MouseDragAction, MouseScrollAction } from "./mouse-context.d.ts";
-declare const useMouseAction: () => MouseClickAction | MouseDragAction | MouseScrollAction | null;
-export default useMouseAction;

package/dist/ink/mouse/use-mouse-position.d.ts

@@ -1,7 +0,0 @@
-/**
- * Ported from `\@zenobius/ink-mouse` (https://github.com/zenobi-us/ink-mouse)
- * Copyright Zeno Jiricek, licensed under Apache-2.0
- */
-import type { MousePosition } from "./mouse-context.d.ts";
-declare const useMousePosition: () => MousePosition;
-export default useMousePosition;

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

@@ -1,7 +0,0 @@
-/**
- * Ported from `\@zenobius/ink-mouse` (https://github.com/zenobi-us/ink-mouse)
- * Copyright Zeno Jiricek, licensed under Apache-2.0
- */
-import type { MouseContextShape } from "./mouse-context.d.ts";
-declare const useMouseContext: () => MouseContextShape;
-export default useMouseContext;

package/dist/ink/mouse/use-on-mouse-click.d.ts

@@ -1,14 +0,0 @@
-/**
- * Ported from `\@zenobius/ink-mouse` (https://github.com/zenobi-us/ink-mouse)
- * Copyright Zeno Jiricek, licensed under Apache-2.0
- */
-import type { RefObject } from "react";
-import type { DOMElement } from "../dom.d.ts";
-import type { MouseButton } from "./mouse-context.d.ts";
-type UseOnMouseClickOptions = {
-    /** Filter to only respond to a specific mouse button. Defaults to all buttons. */
-    button?: MouseButton;
-};
-declare const useOnMouseClick: (ref: RefObject<DOMElement | null>, onChange: (clicking: boolean, button?: MouseButton) => void, options?: UseOnMouseClickOptions) => void;
-export { useOnMouseClick };
-export type { UseOnMouseClickOptions };

package/dist/ink/mouse/use-on-mouse-hover.d.ts

@@ -1,8 +0,0 @@
-/**
- * Ported from `\@zenobius/ink-mouse` (https://github.com/zenobi-us/ink-mouse)
- * Copyright Zeno Jiricek, licensed under Apache-2.0
- */
-import type { RefObject } from "react";
-import type { DOMElement } from "../dom.d.ts";
-declare const useOnMouseHover: (ref: RefObject<DOMElement | null>, onChange: (event: boolean) => void) => void;
-export default useOnMouseHover;

package/dist/ink/mouse/use-on-mouse-state.d.ts

@@ -1,11 +0,0 @@
-/**
- * Ported from `\@zenobius/ink-mouse` (https://github.com/zenobi-us/ink-mouse)
- * Copyright Zeno Jiricek, licensed under Apache-2.0
- */
-import type { RefObject } from "react";
-import type { DOMElement } from "../dom.d.ts";
-declare const useOnMouseState: (ref: RefObject<DOMElement | null>) => {
-    clicking: boolean;
-    hovering: boolean;
-};
-export default useOnMouseState;

package/dist/ink/output.d.ts

@@ -1,74 +0,0 @@
-import type { OutputTransformer } from "./render-node-to-output.d.ts";
-import { StyledLine } from "./styled-line.d.ts";
-/**
- * "Virtual" output class — immediate-write model.
- *
- * Writes go directly to the StyledLine grid instead of being queued
- * as operations and replayed later. This eliminates the operation queue
- * allocation and iteration overhead.
- */
-type Options = {
-    caches?: OutputCaches;
-    height: number;
-    width: number;
-};
-type Clip = {
-    x1: number | undefined;
-    x2: number | undefined;
-    y1: number | undefined;
-    y2: number | undefined;
-};
-type OutputCachesOptions = {
-    maxEntries?: number;
-    pruneToFactor?: number;
-};
-export declare class OutputCaches {
-    widths: Map<string, number>;
-    blockWidths: Map<string, number>;
-    styledLines: Map<string, StyledLine>;
-    lines: Map<string, string[]>;
-    private readonly maxEntries;
-    private readonly pruneToFactor;
-    constructor(options?: OutputCachesOptions);
-    getStyledLine(line: string): StyledLine;
-    getStringWidth(text: string): number;
-    getWidestLine(text: string): number;
-    getLines(text: string): string[];
-    private hasAnsiControlMarker;
-    private setCacheEntry;
-    private pruneCache;
-}
-export default class Output {
-    width: number;
-    height: number;
-    private readonly caches;
-    private grid;
-    private readonly clipStack;
-    private readonly previousLines;
-    private readonly previousRenderedLines;
-    private lineMemoizationEnabled;
-    private memoizationProbeCountdown;
-    constructor(options: Options);
-    reset(width: number, height: number): void;
-    startChildRegion(absX: number, absY: number, width: number, height: number): void;
-    endChildRegion(): void;
-    write(x: number, y: number, text: string, options: {
-        transformers: OutputTransformer[];
-    }): void;
-    writeStyledLine(x: number, y: number, line: StyledLine): void;
-    getRootLines(): ReadonlyArray<StyledLine>;
-    getCurrentClip(): Clip | undefined;
-    addRegionTree(region: import("./region").Region, x: number, y: number): void;
-    private writeStyledLineToRow;
-    get(): {
-        height: number;
-        output: string;
-    };
-    getBuffer(): {
-        buffer: Uint32Array;
-        height: number;
-    };
-    private createGrid;
-    private disableLineMemoization;
-}
-export {};

package/dist/ink/parse-keypress.d.ts

@@ -1,22 +0,0 @@
-import { Buffer } from "node:buffer";
-export declare const nonAlphanumericKeys: string[];
-type ParsedKey = {
-    capsLock?: boolean;
-    code?: string;
-    ctrl: boolean;
-    eventType?: "press" | "repeat" | "release";
-    hyper?: boolean;
-    isKittyProtocol?: boolean;
-    isPrintable?: boolean;
-    meta: boolean;
-    name: string;
-    numLock?: boolean;
-    option: boolean;
-    raw: string | undefined;
-    sequence: string;
-    shift: boolean;
-    super?: boolean;
-    text?: string;
-};
-declare const parseKeypress: (s?: Buffer | string) => ParsedKey;
-export default parseKeypress;

package/dist/ink/reconciler.d.ts

@@ -1,3 +0,0 @@
-import createReconciler from "react-reconciler";
-declare const reconcilerInstance: ReturnType<typeof createReconciler>;
-export default reconcilerInstance;

package/dist/ink/region.d.ts

@@ -1,99 +0,0 @@
-/**
- * Region-based hierarchical output model.
- *
- * A Region represents a rectangular area of terminal output with its own
- * line buffer, scroll state, and child regions. Regions form a tree that
- * is composited into the final screen buffer via flattenRegion().
- *
- * This enables:
- * - Incremental rendering (only changed regions are re-composited)
- * - Render caching (cachedRender stores a Region for unchanged subtrees)
- * - Dirty tracking (terminal buffer only writes changed lines)
- *
- * Ported from jacob314/ink (Google LLC, Apache-2.0).
- */
-import type { StyledLine } from "./styled-line.d.ts";
-export type Region = {
-    backgroundColor?: string;
-    borderBottom?: number;
-    borderTop?: number;
-    cachedStickyHeaders?: StickyHeader[];
-    /** Child regions (nested content areas) */
-    children: Region[];
-    /** Cursor position within this region */
-    cursorPosition?: {
-        col: number;
-        row: number;
-    };
-    height: number;
-    /** Unique identifier for this region (used for dirty tracking) */
-    id: number | string;
-    isHorizontallyScrollable?: boolean;
-    /** Whether this region supports scrolling */
-    isScrollable: boolean;
-    isVerticallyScrollable?: boolean;
-    /** Content buffer — StyledLine per row, relative to (0,0) of this region */
-    readonly lines: ReadonlyArray<StyledLine>;
-    marginBottom?: number;
-    marginRight?: number;
-    /** DOM node reference for debugging/caching */
-    nodeId?: number;
-    opaque?: boolean;
-    /** Layout properties */
-    overflowToBackbuffer?: boolean;
-    scrollbarThumbColor?: string;
-    scrollbarVisible?: boolean;
-    scrollHeight?: number;
-    scrollLeft?: number;
-    /** Scroll state */
-    scrollTop?: number;
-    scrollWidth?: number;
-    /** Selectable text spans for text selection */
-    selectableSpans: SelectableSpan[];
-    selectableText?: string;
-    /** Whether the scrollback position is stable */
-    stableScrollback?: boolean;
-    /** Sticky headers for this region */
-    stickyHeaders: StickyHeader[];
-    /** Trimmed output (trailing spaces removed) for final rendering */
-    readonly styledOutput: ReadonlyArray<StyledLine>;
-    /** Dimensions */
-    width: number;
-    /** Position relative to parent region */
-    x: number;
-    y: number;
-};
-export type SelectableSpan = {
-    endX: number;
-    startX: number;
-    text: string;
-    y: number;
-};
-export type StickyHeader = {
-    /** Lines in the natural (scrolling) position */
-    lines: ReadonlyArray<StyledLine>;
-    /** Height of the header in lines */
-    maxHeaderHeight: number;
-    /** Natural row offset relative to content start */
-    naturalRow: number;
-    /** Node ID for identification */
-    nodeId: number;
-    /** Lines in the stuck (fixed) position */
-    stuckLines?: ReadonlyArray<StyledLine>;
-    /** Stuck X position relative to region */
-    x: number;
-    /** Stuck Y position relative to region */
-    y: number;
-};
-export type RegionNode = {
-    children: RegionNode[];
-    id: number | string;
-};
-/**
- * Compare two region trees for structural equality (same IDs in same order).
- */
-export declare const treesEqual: (a: RegionNode, b: RegionNode) => boolean;
-/**
- * Extract selectable text from a list of selectable spans.
- */
-export declare const extractSelectableText: (spans: ReadonlyArray<SelectableSpan>) => string;

package/dist/ink/render-background.d.ts

@@ -1,4 +0,0 @@
-import type { DOMNode } from "./dom.d.ts";
-import type Output from "./output.d.ts";
-declare const renderBackground: (x: number, y: number, node: DOMNode, output: Output) => void;
-export default renderBackground;

package/dist/ink/render-border.d.ts

@@ -1,4 +0,0 @@
-import type { DOMNode } from "./dom.d.ts";
-import type Output from "./output.d.ts";
-declare const renderBorder: (x: number, y: number, node: DOMNode, output: Output) => void;
-export default renderBorder;

package/dist/ink/render-node-to-output.d.ts

@@ -1,38 +0,0 @@
-import type { DOMElement, DOMNode } from "./dom.d.ts";
-import Output from "./output.d.ts";
-export type OutputTransformer = (s: string, index: number) => string;
-export type CursorOutputPosition = {
-    x: number;
-    y: number;
-};
-export type RenderState = {
-    cursorPosition: CursorOutputPosition | undefined;
-    cursorRequested: boolean;
-    lastTextWriteEnd?: CursorOutputPosition;
-};
-export declare const renderNodeToScreenReaderOutput: (node: DOMElement, options?: {
-    parentRole?: string;
-    skipStaticElements?: boolean;
-}) => string;
-declare const renderNodeToOutput: (node: DOMElement, output: Output, options: {
-    absoluteOffsetX?: number;
-    absoluteOffsetY?: number;
-    offsetX?: number;
-    offsetY?: number;
-    renderState?: RenderState;
-    selectionMap?: Map<DOMNode, {
-        end: number;
-        start: number;
-    }>;
-    skipStaticElements: boolean;
-    transformers?: OutputTransformer[];
-}) => void;
-export default renderNodeToOutput;
-/**
- * Render a DOM subtree into a cached Region.
- * Used by StaticRender to pre-render content once and cache it.
- */
-export declare const renderToStatic: (node: DOMElement, options?: {
-    skipStaticElements?: boolean;
-    trackSelection?: boolean;
-}) => void;

package/dist/ink/render-scrollbar.d.ts

@@ -1,9 +0,0 @@
-import type { ScrollbarBoundingBox } from "./measure-element.d.ts";
-import type Output from "./output.d.ts";
-export type RenderScrollbarOptions = {
-    axis: "horizontal" | "vertical";
-    color?: string;
-    layout: ScrollbarBoundingBox;
-    output: Output;
-};
-export declare const renderScrollbar: ({ axis, color, layout, output }: RenderScrollbarOptions) => void;

package/dist/ink/render-sticky.d.ts

@@ -1,44 +0,0 @@
-import type { DOMElement } from "./dom.d.ts";
-import type Output from "./output.d.ts";
-import type { OutputTransformer } from "./render-node-to-output.d.ts";
-export type StickyNodeInfo = {
-    node: DOMElement;
-    type: "top" | "bottom";
-};
-/**
- * Factory function type for creating Output instances.
- * Passed as a parameter to avoid circular dependency between render-sticky and output.
- */
-export type OutputFactory = (options: {
-    height: number;
-    width: number;
-}) => Output;
-/**
- * Walk the DOM tree under `node` to find all sticky descendants.
- * Stops at scroll boundaries (nested scrollable containers own their sticky nodes).
- */
-export declare const getStickyDescendants: (node: DOMElement, result?: StickyNodeInfo[]) => StickyNodeInfo[];
-/**
- * Identify which sticky nodes are currently active (should be pinned)
- * based on the scroll position and viewport.
- */
-export declare const identifyActiveStickyNodes: (stickyNodes: StickyNodeInfo[], node: DOMElement, scrollTop: number, viewportBottom: number) => {
-    nextStickyNodeInfo?: StickyNodeInfo;
-    stickyNode: DOMElement;
-    type: "top" | "bottom";
-}[];
-/**
- * Render active sticky headers and write them to the output at their stuck positions.
- * Called during the rendering of a scrollable container.
- * @param createOutput Factory function for creating Output instances (avoids circular imports).
- */
-export declare const renderActiveStickyNodes: (activeStickyNodes: {
-    nextStickyNodeInfo?: StickyNodeInfo;
-    stickyNode: DOMElement;
-    type: "top" | "bottom";
-}[], node: DOMElement, output: Output, createOutput: OutputFactory, options: {
-    newTransformers: OutputTransformer[];
-    skipStaticElements: boolean;
-    x: number;
-    y: number;
-}) => void;

package/dist/ink/render-to-string.d.ts

@@ -1,37 +0,0 @@
-import type { ReactNode } from "react";
-export type RenderToStringOptions = {
-    /**
-     * Width of the virtual terminal in columns.
-     * @default 80
-     */
-    columns?: number;
-};
-/**
- * Render a React element to a string synchronously. Unlike `render()`, this function does not write to stdout, does not set up any terminal event listeners, and returns the rendered output as a string.
- *
- * Useful for generating documentation, writing output to files, testing, or any scenario where you need the rendered output as a string without starting a persistent terminal application.
- *
- *Notes:**
- *
- * - Terminal-specific hooks (`useInput`, `useStdin`, `useStdout`, `useStderr`, `useApp`, `useFocus`, `useFocusManager`) return default no-op values since there is no terminal session. They will not throw, but they will not function as in a live terminal.
- * - `useEffect` callbacks will execute during rendering (due to synchronous rendering mode), but state updates they trigger will not affect the returned output, which reflects the initial render.
- * - `useLayoutEffect` callbacks fire synchronously during commit, so state updates they trigger **will** be reflected in the output.
-- The `<Static>` component is supported — its output is prepended to the dynamic output.
-- If a component throws during rendering, the error is propagated to the caller after cleanup.
- 
-@example
-```
-import {renderToString, Text, Box} from 'ink';
- 
-const output = renderToString(
-    <Box padding={1}>
-        <Text color="green">Hello World</Text>
-    </Box>,
-    {columns: 40}
-);
- 
-console.log(output);
-```
- */
-declare const renderToString: (node: ReactNode, options?: RenderToStringOptions) => string;
-export default renderToString;