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

package/dist/ink/index.d.ts

@@ -1,159 +1,398 @@
-export type { ClipboardTarget } from "./clipboard.d.ts";
-export { clearOsc52, isOsc52Supported, writeOsc52 } from "./clipboard.d.ts";
-export type { ColorBlindnessType, ColorMatrix } from "./color-matrix.d.ts";
-export { applyColorMatrix, COLOR_BLINDNESS_COMPENSATION, COLOR_BLINDNESS_SIMULATION, hexToRgb, IDENTITY_MATRIX, rgbToHex, transformHexColor, } from "./color-matrix.d.ts";
-export type { Props as AlertProps, AlertVariant } from "./components/Alert.d.ts";
-export { default as Alert } from "./components/Alert.d.ts";
-export type { Props as AppProps } from "./components/AppContext.d.ts";
-export type { Props as BadgeProps } from "./components/Badge.d.ts";
-export { default as Badge } from "./components/Badge.d.ts";
-export type { Align as BigTextAlign, BackgroundColor as BigTextBackgroundColor, Font as BigTextFont, Props as BigTextProps } from "./components/BigText.d.ts";
-export { default as BigText } from "./components/BigText.d.ts";
-export type { Props as BoxProps } from "./components/Box.d.ts";
-export { default as Box } from "./components/Box.d.ts";
-export type { Props as CodeProps } from "./components/Code.d.ts";
-export { default as Code } from "./components/Code.d.ts";
-export type { Props as ConfirmInputProps } from "./components/ConfirmInput.d.ts";
-export { default as ConfirmInput } from "./components/ConfirmInput.d.ts";
-export type { ConsoleOverlayDock, Props as ConsoleOverlayProps } from "./components/ConsoleOverlay.d.ts";
-export { default as ConsoleOverlay } from "./components/ConsoleOverlay.d.ts";
-export type { Props as CursorProps } from "./components/Cursor.d.ts";
-export { default as Cursor } from "./components/Cursor.d.ts";
-export type { Props as DialogProps } from "./components/Dialog.d.ts";
-export { default as Dialog } from "./components/Dialog.d.ts";
-export type { FileEntry, FilePickerFilter, FilePickerProps } from "./components/index.d.ts";
-export { FilePicker } from "./components/index.d.ts";
-export type { DiffViewMode, Props as DiffViewProps, InlineDiffMode } from "./components/DiffView.d.ts";
-export { default as DiffView } from "./components/DiffView.d.ts";
-export type { GradientColors, GradientName, Props as GradientProps } from "./components/Gradient.d.ts";
-export { default as Gradient } from "./components/Gradient.d.ts";
-export type { Props as HelpProps } from "./components/Help.d.ts";
-export { default as Help } from "./components/Help.d.ts";
-export type { Props as LinkProps } from "./components/Link.d.ts";
-export { default as Link } from "./components/Link.d.ts";
-export type { Props as MarkdownProps } from "./components/Markdown.d.ts";
-export { default as Markdown } from "./components/Markdown.d.ts";
-export type { MultiSelectOption, Props as MultiSelectProps } from "./components/MultiSelect.d.ts";
-export { default as MultiSelect } from "./components/MultiSelect.d.ts";
-export type { Props as NewlineProps } from "./components/Newline.d.ts";
-export { default as Newline } from "./components/Newline.d.ts";
-export type { PageMeta, Props as PaginatorProps } from "./components/Paginator.d.ts";
-export { default as Paginator } from "./components/Paginator.d.ts";
-export type { OrderedListEntry, Props as OrderedListProps } from "./components/OrderedList.d.ts";
-export { default as OrderedList } from "./components/OrderedList.d.ts";
-export type { Props as ProgressBarProps } from "./components/ProgressBar.d.ts";
-export { default as ProgressBar } from "./components/ProgressBar.d.ts";
-export type { ControlledScrollViewProps, ControlledScrollViewRef, ScrollAlignment, ScrollBarBoxProps, ScrollBarPlacement, ScrollBarProps, ScrollBarStyle, ScrollListProps, ScrollListRef, ScrollViewProps, ScrollViewRef, } from "./components/index.d.ts";
-export { ControlledScrollView, ScrollBar, ScrollBarBox, ScrollList, ScrollView } from "./components/index.d.ts";
-export type { SelectInputEntry, Item as SelectInputItemType, Props as SelectInputProps, SeparatorItem as SelectInputSeparator } from "./components/SelectInput.d.ts";
-export { default as SelectInput } from "./components/SelectInput.d.ts";
-export type { Props as SelectInputIndicatorProps } from "./components/SelectInputIndicator.d.ts";
-export { default as SelectInputIndicator } from "./components/SelectInputIndicator.d.ts";
-export type { Props as SelectInputItemProps } from "./components/SelectInputItem.d.ts";
-export { default as SelectInputItem } from "./components/SelectInputItem.d.ts";
-export type { Props as SliderProps } from "./components/Slider.d.ts";
-export { default as Slider } from "./components/Slider.d.ts";
-export { default as Spacer } from "./components/Spacer.d.ts";
-export type { Props as SpinnerProps } from "./components/Spinner.d.ts";
-export { default as Spinner } from "./components/Spinner.d.ts";
-export type { Props as StaticProps } from "./components/Static.d.ts";
-export { default as Static } from "./components/Static.d.ts";
-export type { Props as StaticRenderProps } from "./components/StaticRender.d.ts";
-export { default as StaticRender } from "./components/StaticRender.d.ts";
-export type { Props as StatusMessageProps, StatusMessageVariant } from "./components/StatusMessage.d.ts";
-export { default as StatusMessage } from "./components/StatusMessage.d.ts";
-export type { Props as StopwatchProps, StopwatchRef } from "./components/Stopwatch.d.ts";
-export { default as Stopwatch } from "./components/Stopwatch.d.ts";
-export type { Props as StderrProps } from "./components/StderrContext.d.ts";
-export type { PublicProps as StdinProps } from "./components/StdinContext.d.ts";
-export type { Props as StdoutProps } from "./components/StdoutContext.d.ts";
-export type { Props as TabProps } from "./components/Tab.d.ts";
-export { default as Tab } from "./components/Tab.d.ts";
-export type { ColumnConfig as TableColumnConfig, Props as TableProps, Scalar as TableScalar, ScalarDict as TableScalarDict } from "./components/Table.d.ts";
-export { default as Table } from "./components/Table.d.ts";
-export type { TabColors, KeyMap as TabsKeyMap, Props as TabsProps } from "./components/Tabs.d.ts";
-export { default as Tabs } from "./components/Tabs.d.ts";
-export type { Props as TextProps } from "./components/Text.d.ts";
-export { default as Text } from "./components/Text.d.ts";
-export type { Props as TimerProps, TimerRef } from "./components/Timer.d.ts";
-export { default as Timer } from "./components/Timer.d.ts";
-export type { Props as TextareaProps } from "./components/Textarea.d.ts";
-export { default as Textarea } from "./components/Textarea.d.ts";
-export type { Props as TextInputProps } from "./components/TextInput.d.ts";
-export { default as TextInput } from "./components/TextInput.d.ts";
-export type { Props as TransformProps } from "./components/Transform.d.ts";
-export { default as Transform } from "./components/Transform.d.ts";
-export type { AsyncChildrenFunction, FlatNode, SelectionMode, TreeNode, TreeNodeRendererProps, TreeNodeState, TreeViewProps, TreeViewState, TreeViewTheme, UseTreeViewProps, UseTreeViewStateProps, } from "./components/index.d.ts";
-export { TreeNodeMap, TreeView, treeViewTheme, useTreeView, useTreeViewState } from "./components/index.d.ts";
-export type { UnorderedListEntry, Props as UnorderedListProps } from "./components/UnorderedList.d.ts";
-export { default as UnorderedList } from "./components/UnorderedList.d.ts";
-export type { DOMElement, StickyHeader } from "./dom.d.ts";
-export { getPathToRoot, isNodeSelectable } from "./dom.d.ts";
-export type { AnimationResult } from "./hooks/use-animation.d.ts";
-export { default as useAnimation } from "./hooks/use-animation.d.ts";
-export { default as useApp } from "./hooks/use-app.d.ts";
-export type { BoxMetrics, UseBoxMetricsResult } from "./hooks/use-box-metrics.d.ts";
-export { default as useBoxMetrics } from "./hooks/use-box-metrics.d.ts";
-export type { UseClipboardOptions, UseClipboardResult } from "./hooks/use-clipboard.d.ts";
-export { default as useClipboard } from "./hooks/use-clipboard.d.ts";
-export type { UseColorBlindnessOptions, UseColorBlindnessResult } from "./hooks/use-color-blindness.d.ts";
-export { default as useColorBlindness } from "./hooks/use-color-blindness.d.ts";
-export type { ConsoleEntry, ConsoleLevel, UseConsoleCaptureOptions, UseConsoleCaptureResult } from "./hooks/use-console-capture.d.ts";
-export { default as useConsoleCapture } from "./hooks/use-console-capture.d.ts";
-export { default as useCursor } from "./hooks/use-cursor.d.ts";
-export { default as useFocus } from "./hooks/use-focus.d.ts";
-export { default as useFocusManager } from "./hooks/use-focus-manager.d.ts";
-export type { Key } from "./hooks/use-input.d.ts";
-export { default as useInput } from "./hooks/use-input.d.ts";
-export type { KeyBinding, KeyBindingHandler } from "./hooks/use-key-bindings.d.ts";
-export { default as useKeyBindings } from "./hooks/use-key-bindings.d.ts";
-export { default as useIsScreenReaderEnabled } from "./hooks/use-is-screen-reader-enabled.d.ts";
-export type { LinkedScrollGroup, UseLinkedScrollReturn } from "./hooks/use-linked-scroll.d.ts";
-export { default as createLinkedScrollGroup } from "./hooks/use-linked-scroll.d.ts";
-export { default as usePaste } from "./hooks/use-paste.d.ts";
-export type { UseScrollAccelerationOptions, UseScrollAccelerationResult } from "./hooks/use-scroll-acceleration.d.ts";
-export { default as useScrollAcceleration } from "./hooks/use-scroll-acceleration.d.ts";
-export type { UseScrollInputOptions, UseScrollInputReturn } from "./hooks/use-scroll-input.d.ts";
-export { default as useScrollInput } from "./hooks/use-scroll-input.d.ts";
-export type { UseStopwatchOptions, UseStopwatchResult } from "./hooks/use-stopwatch.d.ts";
-export { default as useStopwatch } from "./hooks/use-stopwatch.d.ts";
-export { default as useStderr } from "./hooks/use-stderr.d.ts";
-export { default as useStdin } from "./hooks/use-stdin.d.ts";
-export { default as useStdout } from "./hooks/use-stdout.d.ts";
-export type { UseTimerOptions, UseTimerResult } from "./hooks/use-timer.d.ts";
-export { default as useTimer } from "./hooks/use-timer.d.ts";
-export type { UseTerminalPaletteResult } from "./hooks/use-terminal-palette.d.ts";
-export { default as useTerminalPalette } from "./hooks/use-terminal-palette.d.ts";
-export type { CursorPosition as TextBufferCursorPosition, TextBufferState, UseTextBufferResult } from "./hooks/use-text-buffer.d.ts";
-export { default as useTextBuffer } from "./hooks/use-text-buffer.d.ts";
-export type { UseTextSelectionOptions, UseTextSelectionResult } from "./hooks/use-text-selection.d.ts";
-export { default as useTextSelection } from "./hooks/use-text-selection.d.ts";
-export type { WindowSize } from "./hooks/use-window-size.d.ts";
-export { default as useWindowSize } from "./hooks/use-window-size.d.ts";
-export { IMECompositionBuffer, isIMEInput } from "./ime-utils.d.ts";
-export type { KittyFlagName, KittyKeyboardOptions } from "./kitty-keyboard.d.ts";
-export { kittyFlags, kittyModifiers } from "./kitty-keyboard.d.ts";
-export type { LayoutCallbacks } from "./layout.d.ts";
-export { processLayout } from "./layout.d.ts";
-export type { CursorPosition } from "./log-update.d.ts";
-export type { ScrollbarBoundingBox, TextFragment } from "./measure-element.d.ts";
-export { default as measureElement } from "./measure-element.d.ts";
-export { calculateScrollbarLayout, calculateScrollbarThumb, collectSortedFragments, getAddedScrollHeight, getBoundingBox, getHorizontalScrollbarBoundingBox, getInnerHeight, getInnerWidth, getRelativeLeft, getRelativeTop, getText, getVerticalScrollbarBoundingBox, } from "./measure-element.d.ts";
-export type { StringWidthFunction } from "./measure-text.d.ts";
-export { clearStringWidthCache, clearStyledLineCache, inkCharacterWidth, setEnableStyledLineCache, setStringWidthFunction, toStyledLine } from "./measure-text.d.ts";
-export type { MouseAction, MouseButton, MouseClickAction, MouseContextShape, MouseDragAction, MouseEvents, MousePosition, MouseScrollAction, SgrMouseEvent, UseOnMouseClickOptions, } from "./index.d.ts";
-export { Fullscreen, isIntersecting, MouseProvider, parseSgrMouse, useElementDimensions, useElementPosition, useMouseAction, useMouseContext, useMousePosition, useOnMouseClick, useOnMouseHover, useOnMouseState, } from "./index.d.ts";
-export type { Instance, RenderOptions } from "./render.d.ts";
-export { default as render } from "./render.d.ts";
-export type { RenderToStringOptions } from "./render-to-string.d.ts";
-export { default as renderToString } from "./render-to-string.d.ts";
-export type { ResizeObserverCallback } from "./resize-observer.d.ts";
-export { default as ResizeObserver, ResizeObserverEntry } from "./resize-observer.d.ts";
-export type { ScrollState } from "./scroll.d.ts";
-export { calculateScroll, getScrollHeight, getScrollLeft, getScrollTop, getScrollWidth } from "./scroll.d.ts";
-export { applySelectionToStyledLine, comparePoints, Range, Selection } from "./selection.d.ts";
-export type { CharOffsetMap, CharOffsetRange } from "./squash-text-nodes.d.ts";
-export { squashTextNodesWithMap } from "./squash-text-nodes.d.ts";
-export type { TerminalPalette } from "./terminal-palette.d.ts";
-export { isTerminalPaletteQuerySupported, queryTerminalPalette } from "./terminal-palette.d.ts";
-export { wrapOrTruncateStyledLine } from "./text-wrap.d.ts";
+export { type C as ClipboardTarget, c as clearOsc52, i as isOsc52Supported, w as writeOsc52 } from "../packem_shared/clipboard.d-D6lZTQ21.js";
+export { b as COLOR_BLINDNESS_COMPENSATION, c as COLOR_BLINDNESS_SIMULATION, type C as ColorBlindnessType, type a as ColorMatrix, I as IDENTITY_MATRIX, d as applyColorMatrix, h as hexToRgb, r as rgbToHex, t as transformHexColor } from "../packem_shared/color-matrix.d-DSXLsB64.js";
+import { D as DOMElement, a as DOMNode, S as StyledLine } from "../packem_shared/dom.d-C1IxuLJ9.js";
+export { R as ResizeObserver, type b as ResizeObserverCallback, c as ResizeObserverEntry, type d as ScrollState, type e as StickyHeader, f as calculateScroll, g as getPathToRoot, h as getScrollHeight, i as getScrollLeft, j as getScrollTop, k as getScrollWidth, l as isNodeSelectable } from "../packem_shared/dom.d-C1IxuLJ9.js";
+export { type I as Instance, type K as KittyFlagName, type a as KittyKeyboardOptions, type R as RenderOptions, k as kittyFlags, b as kittyModifiers, r as render } from "../packem_shared/render.d-DuyG0zip.js";
+import 'node:stream';
+export { type a as CursorPosition } from "../packem_shared/cursor-helpers.d-BONB9tky.js";
+import { EventEmitter } from 'node:events';
+import React, { PropsWithChildren, RefObject, ReactNode } from 'react';
+export { R as Range, S as Selection, a as applySelectionToStyledLine, c as comparePoints } from "../packem_shared/selection.d-Dbha5bMS.js";
+export { type T as TerminalPalette, i as isTerminalPaletteQuerySupported, q as queryTerminalPalette } from "../packem_shared/terminal-palette.d-D2SQjfn-.js";
+import 'yoga-layout';
+import '@visulima/colorize';
+import 'cli-boxes';
+import "../packem_shared/styles.d-cMo36xQz.js";
+import 'type-fest';
+/**
+* Detect whether a string contains non-ASCII characters that are likely
+* IME (Input Method Editor) composition input — CJK ideographs, Hangul,
+* Thai, Vietnamese diacritics, etc.
+*/
+declare const isIMEInput: (data: string) => boolean;
+type IMECompositionBufferOptions = {
+  onFlush: (text: string) => void;
+  timeout: number;
+};
+/**
+* Buffers rapid multi-byte character input from IME and flushes the
+* accumulated text after a configurable timeout.
+*/
+declare class IMECompositionBuffer {
+  private buffer;
+  private timer;
+  private readonly onFlush;
+  private readonly timeout;
+  constructor({
+    onFlush,
+    timeout
+  }: IMECompositionBufferOptions);
+  add(text: string): void;
+  flush(): void;
+  destroy(): void;
+}
+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;
+/**
+* Get an element's inner width (excluding borders).
+*/
+declare const getInnerWidth: (node: DOMElement) => number;
+/**
+* Get an element's inner height (excluding borders).
+*/
+declare const getInnerHeight: (node: DOMElement) => number;
+/**
+* Get an element's position and dimensions relative to the root,
+* accounting for scroll offsets of ancestor elements.
+*/
+declare const getBoundingBox: (node: DOMElement) => {
+  height: number;
+  width: number;
+  x: number;
+  y: number;
+};
+/**
+* Get how much scroll height was added by stableScrollback.
+*/
+declare const getAddedScrollHeight: (node: DOMElement) => number;
+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;
+};
+declare const calculateScrollbarThumb: (options: {
+  axis: "horizontal" | "vertical";
+  clientDimension: number;
+  scrollbarDimension: number;
+  scrollDimension: number;
+  scrollPosition: number;
+}) => {
+  endIndex: number;
+  startIndex: number;
+  thumbEndHalf: number;
+  thumbStartHalf: number;
+};
+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.
+*/
+declare const getVerticalScrollbarBoundingBox: (node: DOMElement, offset?: {
+  x: number;
+  y: number;
+}) => ScrollbarBoundingBox | undefined;
+/**
+* Get the bounding box of the horizontal scrollbar.
+*/
+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).
+*/
+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).
+*/
+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).
+*/
+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).
+*/
+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).
+*/
+declare const collectSortedFragments: (node: DOMNode) => {
+  fragments: TextFragment[];
+  removedHorizontal: number;
+  removedVertical: number;
+};
+/**
+* Generic layout tree walker with callbacks for text, newline, and space events.
+* Used by selection.ts for extracting text from the DOM tree with proper layout positioning.
+*
+* Ported from jacob314/ink fork (Google LLC, Apache-2.0).
+*/
+type LayoutCallbacks<T> = {
+  initialState: () => T;
+  onNewline: (count: number, state: T) => void;
+  onSpace: (count: number, state: T) => void;
+  onText: (fragment: TextFragment, state: T) => void;
+};
+declare const processLayout: <T>(node: DOMNode, callbacks: LayoutCallbacks<T>) => {
+  lineBottom: number;
+  state: T;
+};
+type StringWidthFunction = (text: string) => number;
+/**
+* Enable or disable the StyledLine tokenization cache at runtime.
+* Disabling clears the existing cache.
+*/
+declare const setEnableStyledLineCache: (enabled: boolean) => void;
+/**
+* Clear only the StyledLine tokenization cache.
+*/
+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.
+*/
+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.
+*/
+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).
+*/
+declare const inkCharacterWidth: (text: string) => number;
+/**
+* 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.
+*/
+declare const toStyledLine: (text: string) => StyledLine;
+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;
+};
+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;
+declare const Fullscreen: ({
+  children
+}: PropsWithChildren) => React.JSX.Element;
+/**
+* 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;
+declare const MouseProvider: ({
+  children
+}: PropsWithChildren) => React.JSX.Element;
+/**
+* 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;
+};
+declare const useMouseContext: () => MouseContextShape;
+declare const useMouseAction: () => MouseClickAction | MouseDragAction | MouseScrollAction | null;
+declare const useMousePosition: () => MousePosition;
+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;
+declare const useOnMouseHover: (ref: RefObject<DOMElement | null>, onChange: (event: boolean) => void) => void;
+declare const useOnMouseState: (ref: RefObject<DOMElement | null>) => {
+  clicking: boolean;
+  hovering: boolean;
+};
+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} from '@visulima/tui';
+import {Box} from '@visulima/tui/components/box';
+import {Text} from '@visulima/tui/components/text';
+
+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;
+type CharOffsetRange = {
+  end: number;
+  start: number;
+};
+type CharOffsetMap = Map<DOMNode, CharOffsetRange>;
+/**
+* Squash text nodes while building a character offset map.
+* Each DOM node is mapped to its start/end character offsets in the resulting string.
+* Used for selection text extraction and cursor position calculation.
+*
+* Ported from jacob314/ink fork (Google LLC, Apache-2.0).
+*/
+declare const squashTextNodesWithMap: (node: DOMElement, map: CharOffsetMap, offsetRef: {
+  current: number;
+}) => string;
+declare const wrapOrTruncateStyledLine: (line: StyledLine, maxWidth: number, textWrap?: string) => StyledLine[];
+export { type CharOffsetMap, type CharOffsetRange, type DOMElement, Fullscreen, IMECompositionBuffer, type LayoutCallbacks, type MouseAction, type MouseButton, type MouseClickAction, type MouseContextShape, type MouseDragAction, type MouseEvents, type MousePosition, MouseProvider, type MouseScrollAction, type RenderToStringOptions, type ScrollbarBoundingBox, type SgrMouseEvent, type StringWidthFunction, type TextFragment, type UseOnMouseClickOptions, calculateScrollbarLayout, calculateScrollbarThumb, clearStringWidthCache, clearStyledLineCache, collectSortedFragments, getAddedScrollHeight, getBoundingBox, getHorizontalScrollbarBoundingBox, getInnerHeight, getInnerWidth, getRelativeLeft, getRelativeTop, getText, getVerticalScrollbarBoundingBox, inkCharacterWidth, isIMEInput, isIntersecting, measureElement, parseSgrMouse, processLayout, renderToString, setEnableStyledLineCache, setStringWidthFunction, squashTextNodesWithMap, toStyledLine, useElementDimensions, useElementPosition, useMouseAction, useMouseContext, useMousePosition, useOnMouseClick, useOnMouseHover, useOnMouseState, wrapOrTruncateStyledLine };