@visulima/tui 1.0.0-alpha.2 → 1.0.0-alpha.20

package/dist/ink/measure-element.d.ts

@@ -1,147 +0,0 @@
-import type { DOMElement, DOMNode } from "./dom.d.ts";
-type Output = {
-    /**
-     * Element height.
-     */
-    height: number;
-    /**
-     * Element width.
-     */
-    width: number;
-    /**
-     * Element X position relative to Ink output origin.
-     */
-    x: number;
-    /**
-     * Element Y position relative to Ink output origin.
-     */
-    y: number;
-};
-/**
- * Measure the dimensions of a particular `<Box>` element.
- * Returns an object with `x`, `y`, `width` and `height` properties.
- */
-declare const measureElement: (node: DOMElement) => Output;
-export default measureElement;
-/**
- * Get an element's inner width (excluding borders).
- */
-export declare const getInnerWidth: (node: DOMElement) => number;
-/**
- * Get an element's inner height (excluding borders).
- */
-export declare const getInnerHeight: (node: DOMElement) => number;
-/**
- * Get an element's position and dimensions relative to the root,
- * accounting for scroll offsets of ancestor elements.
- */
-export declare const getBoundingBox: (node: DOMElement) => {
-    height: number;
-    width: number;
-    x: number;
-    y: number;
-};
-/**
- * Get how much scroll height was added by stableScrollback.
- */
-export declare const getAddedScrollHeight: (node: DOMElement) => number;
-export type ScrollbarBoundingBox = {
-    height: number;
-    thumb: {
-        end: number;
-        endHalf: number;
-        height: number;
-        start: number;
-        startHalf: number;
-        width: number;
-        x: number;
-        y: number;
-    };
-    width: number;
-    x: number;
-    y: number;
-};
-export declare const calculateScrollbarThumb: (options: {
-    axis: "horizontal" | "vertical";
-    clientDimension: number;
-    scrollbarDimension: number;
-    scrollDimension: number;
-    scrollPosition: number;
-}) => {
-    endIndex: number;
-    startIndex: number;
-    thumbEndHalf: number;
-    thumbStartHalf: number;
-};
-export declare const calculateScrollbarLayout: (options: {
-    axis: "horizontal" | "vertical";
-    clientDimension: number;
-    hasOppositeScrollbar: boolean;
-    height: number;
-    marginBottom: number;
-    marginRight: number;
-    scrollDimension: number;
-    scrollPosition: number;
-    width: number;
-    x: number;
-    y: number;
-}) => ScrollbarBoundingBox | undefined;
-/**
- * Get the bounding box of the vertical scrollbar.
- */
-export declare const getVerticalScrollbarBoundingBox: (node: DOMElement, offset?: {
-    x: number;
-    y: number;
-}) => ScrollbarBoundingBox | undefined;
-/**
- * Get the bounding box of the horizontal scrollbar.
- */
-export declare const getHorizontalScrollbarBoundingBox: (node: DOMElement, offset?: {
-    x: number;
-    y: number;
-}) => ScrollbarBoundingBox | undefined;
-/**
- * Get the top position of a node relative to a given ancestor.
- * Returns undefined if the ancestor is not in the node's parent chain.
- *
- * Ported from jacob314/ink fork (Google LLC, Apache-2.0).
- */
-export declare const getRelativeTop: (node: DOMElement, ancestor?: DOMElement) => number | undefined;
-/**
- * Get the left position of a node relative to a given ancestor.
- * Returns undefined if the ancestor is not in the node's parent chain.
- *
- * Ported from jacob314/ink fork (Google LLC, Apache-2.0).
- */
-export declare const getRelativeLeft: (node: DOMElement, ancestor?: DOMElement) => number | undefined;
-/**
- * A text fragment from the layout tree with its position and dimensions.
- * Used by `processLayout` for text extraction and selection.
- *
- * Ported from jacob314/ink fork (Google LLC, Apache-2.0).
- */
-export type TextFragment = {
-    height: number;
-    node: DOMElement;
-    text: string;
-    visualX: number;
-    visualY: number;
-    width: number;
-    x: number;
-    y: number;
-};
-/**
- * Get the text content of a DOM node (text node value or squashed children).
- */
-export declare const getText: (node: DOMNode) => string;
-/**
- * Walk the layout tree to collect all text fragments in document order,
- * with their positions adjusted for borders and flex layout.
- *
- * Ported from jacob314/ink fork (Google LLC, Apache-2.0).
- */
-export declare const collectSortedFragments: (node: DOMNode) => {
-    fragments: TextFragment[];
-    removedHorizontal: number;
-    removedVertical: number;
-};

package/dist/ink/measure-text.d.ts

@@ -1,56 +0,0 @@
-import { StyledLine } from "./styled-line.d.ts";
-export type StringWidthFunction = (text: string) => number;
-type Output = {
-    height: number;
-    width: number;
-};
-/**
- * Enable or disable the StyledLine tokenization cache at runtime.
- * Disabling clears the existing cache.
- */
-export declare const setEnableStyledLineCache: (enabled: boolean) => void;
-/**
- * Clear only the StyledLine tokenization cache.
- */
-export declare const clearStyledLineCache: () => void;
-/**
- * Replace the string width function used for text measurement.
- * Useful for terminals with non-standard character widths.
- * Clears the measurement cache when called.
- */
-export declare const setStringWidthFunction: (function_: StringWidthFunction) => void;
-/**
- * Clear the string width measurement cache. Call this if the terminal
- * environment changes in a way that affects character widths.
- */
-export declare const clearStringWidthCache: () => void;
-/**
- * Get the visual width of a single character, with caching and error handling.
- *
- * Ported from jacob314/ink fork (Google LLC, Apache-2.0).
- */
-export declare const inkCharacterWidth: (text: string) => number;
-declare const measureText: (text: string) => Output;
-export default measureText;
-/**
- * Convert a text string to a StyledLine, with caching.
- * Uses the direct text → StyledLine pipeline (handles combining chars,
- * tabs, regional indicators, ANSI codes, etc.) without intermediate
- * StyledChar objects.
- */
-export declare const toStyledLine: (text: string) => StyledLine;
-/**
- * Get the total visual width of a StyledLine.
- */
-export declare const styledLineWidth: (line: StyledLine) => number;
-/**
- * Split a StyledLine by newline characters into multiple StyledLines.
- */
-export declare const splitStyledLineByNewline: (line: StyledLine) => StyledLine[];
-/**
- * Measure the dimensions of a StyledLine (width of widest line, height in lines).
- */
-export declare const measureStyledLine: (line: StyledLine) => {
-    height: number;
-    width: number;
-};

package/dist/ink/mouse/Fullscreen.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 { PropsWithChildren } from "react";
-import React from "react";
-declare const Fullscreen: ({ children }: PropsWithChildren) => React.JSX.Element;
-export default Fullscreen;

package/dist/ink/mouse/MouseProvider.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
- *
- * Rewritten to integrate with the ink input pipeline instead of
- * listening on process.stdin directly.
- */
-import type { PropsWithChildren } from "react";
-import React from "react";
-declare const MouseProvider: ({ children }: PropsWithChildren) => React.JSX.Element;
-export default MouseProvider;

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;