@visulima/tui-kit 1.0.0 → 1.0.2

package/dist/image.d.ts

@@ -4,23 +4,20 @@ import { LiteralUnion } from 'type-fest';
 type Pixel = LiteralUnion<AnsiColors, string> | undefined;
 type Props = {
   /**
-  * Character drawn for a transparent (undefined) pixel; defaults to a space.
-  */
+   * Character drawn for a transparent (undefined) pixel; defaults to a space.
+   */
   readonly emptyChar?: string;
   /**
-  * A row-major grid of colors, one entry per pixel. `undefined` is treated
-  * as transparent. Two vertical pixels share one character cell via the
-  * upper-half-block technique, so the rendered height is `ceil(rows / 2)`.
-  */
+   * A row-major grid of colors, one entry per pixel. `undefined` is treated
+   * as transparent. Two vertical pixels share one character cell via the
+   * upper-half-block technique, so the rendered height is `ceil(rows / 2)`.
+   */
   readonly pixels: ReadonlyArray<ReadonlyArray<Pixel>>;
 };
 /**
-* Render a small pixel grid using the upper-half-block technique: each text
-* cell packs two vertical pixels — the top pixel as the glyph's foreground and
-* the bottom pixel as its background — doubling vertical resolution.
-*/
-declare function Image({
-  emptyChar,
-  pixels
-}: Props): ReactElement;
+ * Render a small pixel grid using the upper-half-block technique: each text
+ * cell packs two vertical pixels — the top pixel as the glyph's foreground and
+ * the bottom pixel as its background — doubling vertical resolution.
+ */
+declare function Image({ emptyChar, pixels }: Props): ReactElement;
 export { Image, type Props as ImageProps, Props, Image as default };

package/dist/index.d.ts

@@ -32,7 +32,7 @@ export { type DirectoryNode, DirectoryTree, type DirectoryTreeProps } from "./di
 export { Divider, type DividerProps } from "./divider.js";
 export { Drawer, type DrawerProps } from "./drawer.js";
 export { FileChange, type FileChangeProps, type FileChangeStatus } from "./file-change.js";
-export { type F as FileEntry, a as FilePicker, type b as FilePickerFilter, type P as FilePickerProps } from "./packem_shared/file-picker.d-Cie6aAMD.js";
+export { type F as FileEntry, a as FilePicker, type b as FilePickerFilter, type P as FilePickerProps } from "./packem_shared/file-picker.d-CH7pccC7.js";
 export { Form, FormField, type FormFieldProps, type FormProps } from "./form.js";
 export { Gauge, type GaugeProps, type GaugeSize, type GaugeThreshold } from "./gauge.js";
 export { Gradient, type GradientColors, type GradientName, type GradientProps } from "./gradient.js";
@@ -72,11 +72,11 @@ export { ProgressCircle, type ProgressCircleProps } from "./progress-circle.js";
 export { QrCode, type Props as QrCodeProps } from "./qr-code.js";
 export { RadioGroup, type Props as RadioGroupProps, type RadioOption } from "./radio-group.js";
 export { ScatterPlot, type Props as ScatterPlotProps } from "./scatter-plot.js";
-export { C as ControlledScrollView, type a as ControlledScrollViewProps, type b as ControlledScrollViewRef } from "./packem_shared/controlled-scroll-view.d-vF4wevEJ.js";
+export { C as ControlledScrollView, type a as ControlledScrollViewProps, type b as ControlledScrollViewRef } from "./packem_shared/controlled-scroll-view.d-D3kZZzjI.js";
 export { S as ScrollBar, type a as ScrollBarPlacement, type b as ScrollBarProps, type c as ScrollBarStyle } from "./packem_shared/scroll-bar.d-B4sD1hBR.js";
-export { S as ScrollBarBox, type a as ScrollBarBoxProps } from "./packem_shared/scroll-bar-box.d-DSBbBsRc.js";
-export { type S as ScrollAlignment, a as ScrollList, type b as ScrollListProps, type c as ScrollListRef } from "./packem_shared/scroll-list.d-BP0UZSY4.js";
-export { S as ScrollView, type a as ScrollViewProps, type b as ScrollViewRef } from "./packem_shared/scroll-view.d-BqKpI-F-.js";
+export { S as ScrollBarBox, type a as ScrollBarBoxProps } from "./packem_shared/scroll-bar-box.d-CpTYEcTZ.js";
+export { type S as ScrollAlignment, a as ScrollList, type b as ScrollListProps, type c as ScrollListRef } from "./packem_shared/scroll-list.d-CPCF0RwC.js";
+export { S as ScrollView, type a as ScrollViewProps, type b as ScrollViewRef } from "./packem_shared/scroll-view.d-GZcgAHl4.js";
 export { SearchInput, type Props as SearchInputProps } from "./search-input.js";
 export { SelectInput, type SelectInputEntry, type Item as SelectInputItemType, type Props as SelectInputProps, type SelectInputSeparator } from "./select-input.js";
 export { SelectInputIndicator, type Props as SelectInputIndicatorProps } from "./select-input-indicator.js";
@@ -108,7 +108,7 @@ export { ToolCall, type Props as ToolCallProps, type ToolCallStatus } from "./to
 export { Tooltip, type TooltipPlacement, type Props as TooltipProps } from "./tooltip.js";
 export { default as Transition, type TransitionPhase, type TransitionPreset, type Props as TransitionProps } from "./transition.js";
 export { TreeSelect, type TreeSelectNode, type Props as TreeSelectProps } from "./tree-select.js";
-export { type A as AsyncChildrenFunction, type F as FlatNode, type S as SelectionMode, type T as TreeNode, a as TreeNodeMap, type b as TreeNodeRendererProps, type c as TreeNodeState, d as TreeView, type P as TreeViewProps, type e as TreeViewState, type f as TreeViewTheme, type U as UseTreeViewProps, type g as UseTreeViewStateProps, t as treeViewTheme, u as useTreeView, h as useTreeViewState } from "./packem_shared/use-tree-view.d-dXTKoDPM.js";
+export { type A as AsyncChildrenFunction, type F as FlatNode, type S as SelectionMode, type T as TreeNode, a as TreeNodeMap, type b as TreeNodeRendererProps, type c as TreeNodeState, d as TreeView, type P as TreeViewProps, type e as TreeViewState, type f as TreeViewTheme, type U as UseTreeViewProps, type g as UseTreeViewStateProps, t as treeViewTheme, u as useTreeView, h as useTreeViewState } from "./packem_shared/use-tree-view.d-DeMQ6G2r.js";
 export { UnorderedList, type UnorderedListEntry, type Props as UnorderedListProps } from "./unordered-list.js";
 import '@visulima/colorize';
 import 'react';

package/dist/json.d.ts

@@ -12,47 +12,40 @@ type JsonTheme = {
 };
 type Props = {
   /**
-  * Accent color for the focused row.
-  * @default "blue"
-  */
+   * Accent color for the focused row.
+   * @default "blue"
+   */
   readonly accentColor?: Color;
   /**
-  * Auto-focus for keyboard navigation.
-  */
+   * Auto-focus for keyboard navigation.
+   */
   readonly autoFocus?: boolean;
   /**
-  * Depth at which nested containers start collapsed. `0` collapses
-  * everything below the root; `Infinity` expands all.
-  * @default Infinity
-  */
+   * Depth at which nested containers start collapsed. `0` collapses
+   * everything below the root; `Infinity` expands all.
+   * @default Infinity
+   */
   readonly collapseDepth?: number;
   /**
-  * The value to render.
-  */
+   * The value to render.
+   */
   readonly data: unknown;
   /**
-  * When true, arrow keys move a cursor and Space toggles the focused
-  * container. When false, the tree renders statically fully expanded down to
-  * `collapseDepth`.
-  * @default true
-  */
+   * When true, arrow keys move a cursor and Space toggles the focused
+   * container. When false, the tree renders statically fully expanded down to
+   * `collapseDepth`.
+   * @default true
+   */
   readonly interactive?: boolean;
   /**
-  * Color theme for the different JSON token kinds.
-  */
+   * Color theme for the different JSON token kinds.
+   */
   readonly theme?: Partial<JsonTheme>;
 };
 /**
-* A collapsible JSON viewer. Objects and arrays can be folded; when
-* `interactive`, arrow keys move a cursor and Space toggles the focused
-* container. Values are colored by type.
-*/
-declare function Json({
-  accentColor,
-  autoFocus,
-  collapseDepth,
-  data,
-  interactive,
-  theme
-}: Props): ReactElement;
+ * A collapsible JSON viewer. Objects and arrays can be folded; when
+ * `interactive`, arrow keys move a cursor and Space toggles the focused
+ * container. Values are colored by type.
+ */
+declare function Json({ accentColor, autoFocus, collapseDepth, data, interactive, theme }: Props): ReactElement;
 export { Json, type Props as JsonProps, JsonTheme, Props, Json as default };

package/dist/kbd.d.ts

@@ -3,29 +3,25 @@ import { ReactNode, ReactElement } from 'react';
 import { LiteralUnion } from 'type-fest';
 type Props = {
   /**
-  * Key cap content.
-  */
+   * Key cap content.
+   */
   readonly children: ReactNode;
   /**
-  * Background color of the key cap.
-  * @default "gray"
-  */
+   * Background color of the key cap.
+   * @default "gray"
+   */
   readonly color?: LiteralUnion<AnsiColors, string>;
   /**
-  * Visual style.
-  * - `solid` (default): background filled
-  * - `outline`: border only
-  * - `bare`: no decoration, just dimmed text
-  */
+   * Visual style.
+   * - `solid` (default): background filled
+   * - `outline`: border only
+   * - `bare`: no decoration, just dimmed text
+   */
   readonly variant?: "bare" | "outline" | "solid";
 };
 /**
-* Render a keyboard key (e.g. `&lt;Kbd>Enter&lt;/Kbd>`).
-* @returns A `ReactElement` styled as a key cap (solid / outline / bare).
-*/
-declare function Kbd({
-  children,
-  color,
-  variant
-}: Props): ReactElement;
+ * Render a keyboard key (e.g. `&lt;Kbd>Enter&lt;/Kbd>`).
+ * @returns A `ReactElement` styled as a key cap (solid / outline / bare).
+ */
+declare function Kbd({ children, color, variant }: Props): ReactElement;
 export { Kbd, type Props as KbdProps, Props, Kbd as default };

package/dist/line-chart.d.ts

@@ -3,67 +3,67 @@ import { CanvasContext } from '@visulima/tui/canvas';
 import { ReactElement } from 'react';
 import { LiteralUnion } from 'type-fest';
 /**
-* A single 2D data point.
-*/
+ * A single 2D data point.
+ */
 type Point = {
   readonly x: number;
   readonly y: number;
 };
 type LineSeries = {
   /**
-  * Per-series color override. Falls back to the chart-level palette.
-  */
+   * Per-series color override. Falls back to the chart-level palette.
+   */
   readonly color?: LiteralUnion<AnsiColors, string>;
   /**
-  * Numeric samples to plot. Pass either a list of y-values (x is the
-  * index) or {x, y} tuples.
-  */
+   * Numeric samples to plot. Pass either a list of y-values (x is the
+   * index) or {x, y} tuples.
+   */
   readonly data: ReadonlyArray<number> | ReadonlyArray<{
     readonly x: number;
     readonly y: number;
   }>;
   /**
-  * Optional label shown in the legend.
-  */
+   * Optional label shown in the legend.
+   */
   readonly label?: string;
 };
 type LineChartProps = {
   /**
-  * Color for axis ticks / labels.
-  * @default "gray"
-  */
+   * Color for axis ticks / labels.
+   * @default "gray"
+   */
   readonly axisColor?: LiteralUnion<AnsiColors, string>;
   /**
-  * Chart body height in character rows.
-  * @default 10
-  */
+   * Chart body height in character rows.
+   * @default 10
+   */
   readonly height?: number;
   /**
-  * Upper bound for the y-axis. When omitted the chart auto-scales.
-  */
+   * Upper bound for the y-axis. When omitted the chart auto-scales.
+   */
   readonly maxY?: number;
   /**
-  * Lower bound for the y-axis. When omitted the chart auto-scales.
-  */
+   * Lower bound for the y-axis. When omitted the chart auto-scales.
+   */
   readonly minY?: number;
   /**
-  * Fallback palette cycled through when a series does not set `color`.
-  * @default ["cyan", "magenta", "yellow", "green", "blue", "red"]
-  */
+   * Fallback palette cycled through when a series does not set `color`.
+   * @default ["cyan", "magenta", "yellow", "green", "blue", "red"]
+   */
   readonly palette?: ReadonlyArray<LiteralUnion<AnsiColors, string>>;
   /**
-  * One or more line series.
-  */
+   * One or more line series.
+   */
   readonly series: ReadonlyArray<LineSeries>;
   /**
-  * Render the legend row under the plot.
-  * @default true
-  */
+   * Render the legend row under the plot.
+   * @default true
+   */
   readonly showLegend?: boolean;
   /**
-  * Chart body width in character columns.
-  * @default 40
-  */
+   * Chart body width in character columns.
+   * @default 40
+   */
   readonly width?: number;
 };
 type RenderConfig = {
@@ -80,30 +80,21 @@ type RenderConfig = {
   readonly yMin: number;
 };
 /**
-* Project an (x, y) data point into pixel-grid coordinates for the given
-* canvas size. Used by every chart that paints on top of a braille grid.
-*/
+ * Project an (x, y) data point into pixel-grid coordinates for the given
+ * canvas size. Used by every chart that paints on top of a braille grid.
+ */
 declare const projectPoint: (point: Point, config: Pick<RenderConfig, "xMax" | "xMin" | "yMax" | "yMin">, pixelWidth: number, pixelHeight: number) => {
   px: number;
   py: number;
 };
 /**
-* Shared drawing path used by LineChart and ScatterPlot. AreaChart wraps
-* this with a fill pass.
-*/
+ * Shared drawing path used by LineChart and ScatterPlot. AreaChart wraps
+ * this with a fill pass.
+ */
 declare const drawSeriesOnCanvas: (context: CanvasContext, mode: "line" | "scatter", config: RenderConfig) => void;
 /**
-* Smooth multi-series line chart rendered at 2x4 sub-cell resolution using
-* Unicode braille patterns. Auto-scales both axes by default.
-*/
-declare function LineChart({
-  axisColor,
-  height,
-  maxY,
-  minY,
-  palette,
-  series,
-  showLegend,
-  width
-}: LineChartProps): ReactElement;
+ * Smooth multi-series line chart rendered at 2x4 sub-cell resolution using
+ * Unicode braille patterns. Auto-scales both axes by default.
+ */
+declare function LineChart({ axisColor, height, maxY, minY, palette, series, showLegend, width }: LineChartProps): ReactElement;
 export { LineChart, LineChartProps, type RenderConfig as LineChartRenderConfig, LineSeries, LineChart as default, drawSeriesOnCanvas, projectPoint };

package/dist/link.d.ts

@@ -2,37 +2,33 @@ import { ReactNode, ReactElement } from 'react';
 type Props = {
   readonly children: ReactNode;
   /**
-  * Determines whether the URL should be printed for unsupported terminals.
-  *
-  * - `true` (default): appends the URL after the text, e.g. `"My website https://example.com"`
-  * - `false`: renders just the text with no URL
-  * - `function`: custom fallback formatting, e.g. `(text, url) => \`[\${text}](\${url})\``
-  * @default true
-  */
+   * Determines whether the URL should be printed for unsupported terminals.
+   *
+   * - `true` (default): appends the URL after the text, e.g. `"My website https://example.com"`
+   * - `false`: renders just the text with no URL
+   * - `function`: custom fallback formatting, e.g. `(text, url) => \`[\${text}](\${url})\``
+   * @default true
+   */
   readonly fallback?: ((text: string, url: string) => string) | boolean;
   /**
-  * The URL to link to.
-  */
+   * The URL to link to.
+   */
   readonly url: string;
 };
 /**
-* An Ink component that creates clickable links in the terminal using OSC 8 hyperlink sequences.
-*
-* [Supported terminals.](https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda)
-*
-* For unsupported terminals, the link will be printed after the text: `My website https://example.com`.
-*
-* ```tsx
-* import { Link, Text } from "@visulima/tui/ink";
-*
-* <Link url="https://example.com">
-*     <Text color="cyan">My Website</Text>
-* </Link>
-* ```
-*/
-declare function Link({
-  children,
-  fallback,
-  url
-}: Props): ReactElement;
+ * An Ink component that creates clickable links in the terminal using OSC 8 hyperlink sequences.
+ *
+ * [Supported terminals.](https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda)
+ *
+ * For unsupported terminals, the link will be printed after the text: `My website https://example.com`.
+ *
+ * ```tsx
+ * import { Link, Text } from "@visulima/tui/ink";
+ *
+ * <Link url="https://example.com">
+ *     <Text color="cyan">My Website</Text>
+ * </Link>
+ * ```
+ */
+declare function Link({ children, fallback, url }: Props): ReactElement;
 export { Link, type Props as LinkProps, type Props, Link as default };

package/dist/loading-indicator.d.ts

@@ -4,26 +4,22 @@ import { ReactNode, ReactElement } from 'react';
 import { LiteralUnion } from 'type-fest';
 type Props = {
   /**
-  * Optional message rendered after the spinner.
-  */
+   * Optional message rendered after the spinner.
+   */
   readonly children?: ReactNode;
   /**
-  * Color used for the spinner and label.
-  * @default "cyan"
-  */
+   * Color used for the spinner and label.
+   * @default "cyan"
+   */
   readonly color?: LiteralUnion<AnsiColors, string>;
   /**
-  * Spinner preset.
-  * @default "dots"
-  */
+   * Spinner preset.
+   * @default "dots"
+   */
   readonly type?: SpinnerName;
 };
 /**
-* Compact spinner + label for loading states.
-*/
-declare function LoadingIndicator({
-  children,
-  color,
-  type
-}: Props): ReactElement;
+ * Compact spinner + label for loading states.
+ */
+declare function LoadingIndicator({ children, color, type }: Props): ReactElement;
 export { LoadingIndicator, type Props as LoadingIndicatorProps, Props, LoadingIndicator as default };

package/dist/log.d.ts

@@ -7,32 +7,27 @@ type LogEntry = {
 };
 type Props = {
   /**
-  * The log entries, oldest first.
-  */
+   * The log entries, oldest first.
+   */
   readonly entries: ReadonlyArray<LogEntry>;
   /**
-  * Keep only the last N entries (tail). Omit to render all.
-  */
+   * Keep only the last N entries (tail). Omit to render all.
+   */
   readonly maxLines?: number;
   /**
-  * Render the `[LEVEL]` badge before each message.
-  * @default true
-  */
+   * Render the `[LEVEL]` badge before each message.
+   * @default true
+   */
   readonly showLevel?: boolean;
   /**
-  * Render each entry's timestamp, when present.
-  * @default true
-  */
+   * Render each entry's timestamp, when present.
+   * @default true
+   */
   readonly showTimestamp?: boolean;
 };
 /**
-* A leveled log view. Renders entries with a colored level badge and optional
-* timestamp; `maxLines` tails the buffer to the most recent entries.
-*/
-declare function Log({
-  entries,
-  maxLines,
-  showLevel,
-  showTimestamp
-}: Props): ReactElement;
+ * A leveled log view. Renders entries with a colored level badge and optional
+ * timestamp; `maxLines` tails the buffer to the most recent entries.
+ */
+declare function Log({ entries, maxLines, showLevel, showTimestamp }: Props): ReactElement;
 export { Log, LogEntry, LogLevel, type Props as LogProps, Props, Log as default };

package/dist/markdown.d.ts

@@ -1,40 +1,35 @@
 import { ReactElement } from 'react';
 type Props = {
   /**
-  * The Markdown source string.
-  */
+   * The Markdown source string.
+   */
   readonly children: string;
   /**
-  * Shiki theme for code block syntax highlighting.
-  * @default "github-dark-default"
-  */
+   * Shiki theme for code block syntax highlighting.
+   * @default "github-dark-default"
+   */
   readonly codeTheme?: string;
   /**
-  * Maximum width for text wrapping. Defaults to terminal width.
-  */
+   * Maximum width for text wrapping. Defaults to terminal width.
+   */
   readonly maxWidth?: number;
   /**
-  * Enable streaming mode for progressive rendering.
-  * When true, the component re-renders on every prop change and handles
-  * incomplete Markdown gracefully (e.g., unclosed code fences, partial lists).
-  * Useful for rendering AI-generated text arriving token-by-token.
-  * @default false
-  */
+   * Enable streaming mode for progressive rendering.
+   * When true, the component re-renders on every prop change and handles
+   * incomplete Markdown gracefully (e.g., unclosed code fences, partial lists).
+   * Useful for rendering AI-generated text arriving token-by-token.
+   * @default false
+   */
   readonly streaming?: boolean;
 };
 /**
-* Render Markdown content as Ink terminal UI elements.
-*
-* ```tsx
-* <Markdown>{"# Hello\n\nThis is **bold** and *italic*."}</Markdown>
-* <Markdown codeTheme="github-dark-default">{"```js\nconst x = 1;\n```"}</Markdown>
-* <Markdown streaming>{"# Streaming\n\nText arriving..."}</Markdown>
-* ```
-*/
-declare function Markdown({
-  children,
-  codeTheme,
-  maxWidth: maxWidthProp,
-  streaming
-}: Props): ReactElement;
+ * Render Markdown content as Ink terminal UI elements.
+ *
+ * ```tsx
+ * <Markdown>{"# Hello\n\nThis is **bold** and *italic*."}</Markdown>
+ * <Markdown codeTheme="github-dark-default">{"```js\nconst x = 1;\n```"}</Markdown>
+ * <Markdown streaming>{"# Streaming\n\nText arriving..."}</Markdown>
+ * ```
+ */
+declare function Markdown({ children, codeTheme, maxWidth: maxWidthProp, streaming }: Props): ReactElement;
 export { Markdown, type Props as MarkdownProps, Props, Markdown as default };

package/dist/masked-input.d.ts

@@ -1,50 +1,42 @@
 import { ReactElement } from 'react';
 type Props = {
   /**
-  * Initial raw value (digits/characters only, without mask symbols).
-  */
+   * Initial raw value (digits/characters only, without mask symbols).
+   */
   readonly defaultValue?: string;
   /**
-  * Disable input and dim the display.
-  */
+   * Disable input and dim the display.
+   */
   readonly isDisabled?: boolean;
   /**
-  * Mask definition. Each `#` is replaced with a user character; any other
-  * character is rendered literally. Example: `(###) ###-####`.
-  */
+   * Mask definition. Each `#` is replaced with a user character; any other
+   * character is rendered literally. Example: `(###) ###-####`.
+   */
   readonly mask: string;
   /**
-  * Called whenever the underlying raw value changes.
-  */
+   * Called whenever the underlying raw value changes.
+   */
   readonly onChange?: (value: string) => void;
   /**
-  * Called when the user presses Enter with the current raw value.
-  */
+   * Called when the user presses Enter with the current raw value.
+   */
   readonly onSubmit?: (value: string) => void;
   /**
-  * Placeholder character used in the mask for empty positions.
-  * @default "_"
-  */
+   * Placeholder character used in the mask for empty positions.
+   * @default "_"
+   */
   readonly placeholderChar?: string;
   /**
-  * Sentinel character in the mask string used to mark editable positions.
-  * @default "#" (hash)
-  */
+   * Sentinel character in the mask string used to mark editable positions.
+   * @default "#" (hash)
+   */
   readonly token?: string;
 };
 /**
-* Input with a fixed-width mask. The mask token (`#` by default) marks
-* positions where the user can type; every other character is preserved.
-* Supports ←/→ to move within the mask, Home/End to jump, and
-* Backspace/Delete to clear characters.
-*/
-declare function MaskedInput({
-  defaultValue,
-  isDisabled,
-  mask,
-  onChange,
-  onSubmit,
-  placeholderChar,
-  token
-}: Props): ReactElement;
+ * Input with a fixed-width mask. The mask token (`#` by default) marks
+ * positions where the user can type; every other character is preserved.
+ * Supports ←/→ to move within the mask, Home/End to jump, and
+ * Backspace/Delete to clear characters.
+ */
+declare function MaskedInput({ defaultValue, isDisabled, mask, onChange, onSubmit, placeholderChar, token }: Props): ReactElement;
 export { MaskedInput, type Props as MaskedInputProps, Props, MaskedInput as default };