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

package/CHANGELOG.md

@@ -1,3 +1,56 @@
+## @visulima/tui [1.0.0-alpha.3](https://github.com/visulima/visulima/compare/@visulima/tui@1.0.0-alpha.2...@visulima/tui@1.0.0-alpha.3) (2026-04-22)
+
+### Features
+
+* Add comprehensive Ink UI component library with 40+ components ([#614](https://github.com/visulima/visulima/issues/614)) ([24b00a8](https://github.com/visulima/visulima/commit/24b00a8855b1ddb509b85c4a3e0f9f3d76323f76))
+* **tui:** port ink upstream PR 115/119/123/125 ([2232485](https://github.com/visulima/visulima/commit/22324855fbcca38bc263d46194ccf30522ecc599))
+
+### Bug Fixes
+
+* **ci:** always run native build job so artifacts are available ([51f3428](https://github.com/visulima/visulima/commit/51f34285bc04a0f6347609db240814862646c1cc))
+* **ci:** publish native addons via local semantic-release plugin ([974beb2](https://github.com/visulima/visulima/commit/974beb2d021e7b2afc86b958bd2137be88d2f464))
+* Remove JSR configuration generation script and generated jsr.json files ([#616](https://github.com/visulima/visulima/issues/616)) ([533744b](https://github.com/visulima/visulima/commit/533744b103b74896941db5b727173e617a27a63b))
+* Replace resetTerminal with clearScreenAndHomeCursor to preserve scrollback ([#605](https://github.com/visulima/visulima/issues/605)) ([6a79e4d](https://github.com/visulima/visulima/commit/6a79e4d8350b90ec553ad5fbcf825d9ac30ece66))
+* **terminal:** resolve eslint and formatting issues ([8f30389](https://github.com/visulima/visulima/commit/8f30389deb9ff81e7afce0aa064ef11fcb179f23))
+* **tui:** declare static props on Form/Transition for isolatedDeclarations ([c30b9f1](https://github.com/visulima/visulima/commit/c30b9f148cf4ea75e54a9e358fea085a34f680e8))
+* **tui:** fixed types ([abe7106](https://github.com/visulima/visulima/commit/abe7106aa1f55340d1b218f4b338709a0317c671))
+* **tui:** floor text node width when calling wrapOrTruncateStyledChars ([1d06086](https://github.com/visulima/visulima/commit/1d06086404c54b46baec8f688fc1e39228a0ab75))
+* **tui:** inline component and hook barrel exports in ink entry ([1cf8dd2](https://github.com/visulima/visulima/commit/1cf8dd25c91a2001268fb9d964d95df649bf7832))
+* **tui:** narrow ANSI_CODES type and cast yoga Node remove call ([87b2c67](https://github.com/visulima/visulima/commit/87b2c6787d44ae630a0eece56b3b2df395a7c63b))
+* **tui:** rename components to kebab-case, fix broken test assertions, protect fixtures from auto-format ([caa2e86](https://github.com/visulima/visulima/commit/caa2e86f7500467e56c89b3671d0e33b6b5d0173))
+* **tui:** type histogram bucket counts as number[] ([883eca4](https://github.com/visulima/visulima/commit/883eca42cf74df3db8409a5f921d75371ba79070))
+
+### Miscellaneous Chores
+
+* bump engines.node to ^22.14.0 || >=24.10.0 ([c3d0931](https://github.com/visulima/visulima/commit/c3d0931d1504e4f21ebf50ea680cfa7ce4ba15ce))
+* fixed jsr.json ([5d85e51](https://github.com/visulima/visulima/commit/5d85e5179de38e284ec433b14d77c71a1619c8d6))
+* remove unused deprecated aliases ([#612](https://github.com/visulima/visulima/issues/612)) ([24ee546](https://github.com/visulima/visulima/commit/24ee546bcb2c17b8915622e4878797c00aa1d813))
+* **tui:** apply formatter and lint fixes ([e70da36](https://github.com/visulima/visulima/commit/e70da3672d1c06cbbe2a6294c86535d770dc04bf))
+* **tui:** apply pending changes ([f432dc8](https://github.com/visulima/visulima/commit/f432dc8aae2c4f26b43132d956067b770d4a9548))
+* **tui:** apply pending lint and source updates ([7fe85fe](https://github.com/visulima/visulima/commit/7fe85fe0261d2d792762971c56a98fe1c03040a6))
+* **tui:** enforce curly braces and apply lint fixes ([ffab48f](https://github.com/visulima/visulima/commit/ffab48f89720a8e906d863bb3539c86bee9783a5))
+
+### Code Refactoring
+
+* replace inline import() types with top-level imports ([4569a4c](https://github.com/visulima/visulima/commit/4569a4ca04723da069f985855dcfab292f7347e1))
+* **tui:** switch spinner to @visulima/spinner ([0c2e2f4](https://github.com/visulima/visulima/commit/0c2e2f498e8c2f4bee46b257dfc1f61d5924a012))
+
+### Tests
+
+* **secret-scanner:** add per-file JIT warmup and extended timeouts ([3255e63](https://github.com/visulima/visulima/commit/3255e636cb554e3bfb40e8c4cafd6108034f9acf))
+* **tui, dev-toolbar:** fix expect.assertions counts on looped assertions ([898bc59](https://github.com/visulima/visulima/commit/898bc59ef217f7c8ee2aa7fdf7da3d355c028b13))
+* **tui:** fix 15 broken ink component tests ([c1e25a0](https://github.com/visulima/visulima/commit/c1e25a00d0fbd4532df0802a07452dc803e93f79))
+* **tui:** move expect.assertions past platform-guard early returns ([f3ce2e3](https://github.com/visulima/visulima/commit/f3ce2e3eecac57192f4b91582ca990e4256b4538))
+* **tui:** move remaining expect.assertions past platform guards ([c227075](https://github.com/visulima/visulima/commit/c2270756cfdc87fa083ea1f8f90d6ece76951540))
+* **tui:** stabilize flaky ink input and chart tests ([183be7b](https://github.com/visulima/visulima/commit/183be7b2a1cfcdf4fa6f57f6ee02b5b8d62b29a4))
+* **tui:** stabilize flaky ink input tests and remove native guard ([445abd8](https://github.com/visulima/visulima/commit/445abd85a0b44707f28122e8b1921564af728f33))
+
+
+### Dependencies
+
+* **@visulima/boxen:** upgraded to 3.0.0-alpha.10
+* **@visulima/spinner:** upgraded to 1.0.0-alpha.1
+
 ## @visulima/tui [1.0.0-alpha.2](https://github.com/visulima/visulima/compare/@visulima/tui@1.0.0-alpha.1...@visulima/tui@1.0.0-alpha.2) (2026-04-09)
 
 ### Features

package/LICENSE.md

@@ -71,27 +71,81 @@ The published @visulima/tui artifact additionally contains code with the followi
 ISC, MIT
 
 # Bundled dependencies:
-## cli-boxes
+## @visulima/spinner
 License: MIT
-By: Sindre Sorhus
-Repository: sindresorhus/cli-boxes
+By: Daniel Bannert
+Repository: git+https://github.com/visulima/visulima.git
 
 > MIT License
 >
-> Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
+> Copyright (c) 2026 visulima
 >
-> Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+> Permission is hereby granted, free of charge, to any person obtaining a copy
+> of this software and associated documentation files (the "Software"), to deal
+> in the Software without restriction, including without limitation the rights
+> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+> copies of the Software, and to permit persons to whom the Software is
+> furnished to do so, subject to the following conditions:
 >
-> The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+> The above copyright notice and this permission notice shall be included in all
+> copies or substantial portions of the Software.
 >
-> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+> SOFTWARE.
+>
+> ---
+>
+> ## Acknowledgments
+>
+> This project includes spinner animations inspired by and adapted from the following open-source libraries, all licensed under the MIT License:
+>
+> ### Rattles
+>
+> - **Source:** https://github.com/vyfor/rattles
+> - **Author:** vyfor
+> - **License:** MIT
+> - **Description:** A minimal terminal spinner library for Rust that inspired additional braille-based spinner animations.
+>
+> ### unicode-animations
+>
+> - **Source:** https://github.com/gunnargray-dev/unicode-animations
+> - **Author:** gunnar gray
+> - **License:** MIT
+> - **Description:** Provides Unicode-based braille animations that were adapted for additional visual effects.
+>
+>
+>
+> # Licenses of bundled dependencies
+> The published @visulima/spinner artifact additionally contains code with the following licenses:
+> MIT
+>
+> # Bundled dependencies:
+> ## cli-spinners
+> License: MIT
+> By: Sindre Sorhus
+> Repository: sindresorhus/cli-spinners
+>
+> > MIT License
+> >
+> > Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
+> >
+> > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+> >
+> > The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+> >
+> > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 ---------------------------------------
 
-## cli-spinners
+## cli-boxes
 License: MIT
 By: Sindre Sorhus
-Repository: sindresorhus/cli-spinners
+Repository: sindresorhus/cli-boxes
 
 > MIT License
 >

package/README.md

@@ -97,9 +97,9 @@ const Spinner = () => {
 };
 ```
 
-| Option     | Type      | Default | Description                                                                                                                |
-| ---------- | --------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
-| `interval` | `number`  | `100`   | Time between ticks in milliseconds.                                                                                        |
+| Option     | Type      | Default | Description                                                                                                                 |
+| ---------- | --------- | ------- | --------------------------------------------------------------------------------------------------------------------------- |
+| `interval` | `number`  | `100`   | Time between ticks in milliseconds.                                                                                         |
 | `isActive` | `boolean` | `true`  | Whether the animation is running. When set to `false`, the animation stops. When toggled back to `true`, values reset to 0. |
 
 Returns `{ frame, time, delta, reset }`. See the [full hooks reference](https://visulima.com/packages/tui/hooks#useanimation) for detailed return values, more examples (sine waves, physics, pausable, reset), and `maxFps` interaction.

package/dist/core/index.js

@@ -1,5 +1,5 @@
-export { TuiApp } from '../packem_shared/TuiApp-DfxOnXqi.js';
+export { TuiApp } from '../packem_shared/TuiApp-DtdgNRWa.js';
 export { Cell, StyleMasks } from '../packem_shared/Cell-DCg1kJY-.js';
-export { createInlineLoop } from '../packem_shared/createInlineLoop-BxMmcq9D.js';
-export { InputParser } from '../packem_shared/InputParser-BKHpWfvN.js';
+export { createInlineLoop } from '../packem_shared/createInlineLoop-Dnfm1ZSJ.js';
+export { InputParser } from '../packem_shared/InputParser-BlsfeY9J.js';
 export { Renderer, TerminalGuard, terminalSize } from '../packem_shared/Renderer-zZ5O3vxc.js';

package/dist/ink/canvas/braille.d.ts

@@ -0,0 +1,22 @@
+import type { CanvasContext, CellStyle } from "./buffer.d.ts";
+export type BrailleGrid = {
+    readonly cellHeight: number;
+    readonly cellWidth: number;
+    readonly clear: () => void;
+    /**
+     * Flush the accumulated pixels into the canvas, one braille character per
+     * dirtied cell. Pass a color via `style` to apply it uniformly (mixing
+     * colors across overlapping series requires a separate grid per series).
+     */
+    readonly flush: (context: CanvasContext, style?: CellStyle) => void;
+    readonly pixelHeight: number;
+    readonly pixelWidth: number;
+    readonly plotLine: (x0: number, y0: number, x1: number, y1: number) => void;
+    readonly plotPoint: (x: number, y: number) => void;
+};
+/**
+ * Accumulator for braille-rendered charts. Tracks which sub-pixels are lit
+ * and emits a braille character per dirtied cell on `flush`. Designed to be
+ * allocated per chart render and thrown away.
+ */
+export declare const createBrailleGrid: (cellWidth: number, cellHeight: number) => BrailleGrid;

package/dist/ink/canvas/buffer.d.ts

@@ -0,0 +1,67 @@
+export type CanvasColor = number | string | undefined;
+export type CellStyle = {
+    readonly background?: CanvasColor;
+    readonly bold?: boolean;
+    readonly color?: CanvasColor;
+    readonly dim?: boolean;
+};
+/**
+ * Reverse of the encoder. 0 → undefined; any other id returns the original
+ * CanvasColor (preserving number vs string distinction).
+ */
+type ColorDecoder = (id: number) => CanvasColor;
+export type CanvasContext = {
+    /**
+     * Clear every cell back to space + default style.
+     */
+    readonly clear: () => void;
+    /**
+     * Draw a horizontal bar using fractional block glyphs (▏▎▍▌▋▊▉█).
+     * `fillRatio` in [0, 1] determines the filled portion.
+     */
+    readonly drawHBar: (x: number, y: number, w: number, fillRatio: number, style?: CellStyle) => void;
+    /**
+     * Draw a filled rectangle using a single character.
+     */
+    readonly drawRect: (x: number, y: number, w: number, h: number, char: number | string, style?: CellStyle) => void;
+    /**
+     * Render a string left-to-right starting at (x, y). Non-printable or
+     * multi-byte codepoints are preserved but advance the cursor by 1 cell.
+     */
+    readonly drawText: (x: number, y: number, text: string, style?: CellStyle) => void;
+    /**
+     * Draw a vertical bar using fractional block glyphs (▁▂▃▄▅▆▇█).
+     * `fillRatio` in [0, 1] determines the filled portion.
+     */
+    readonly drawVBar: (x: number, y: number, h: number, fillRatio: number, style?: CellStyle) => void;
+    readonly height: number;
+    /**
+     * Set a single cell at (x, y). Out-of-bounds writes are silently ignored.
+     */
+    readonly setCell: (x: number, y: number, char: number | string, style?: CellStyle) => void;
+    readonly width: number;
+};
+export type CanvasBuffer = {
+    readonly bg: Int32Array;
+    readonly chars: Uint32Array;
+    readonly colorDecoder: ColorDecoder;
+    readonly context: CanvasContext;
+    readonly dirty: Uint8Array;
+    readonly fg: Int32Array;
+    readonly height: number;
+    readonly styles: Uint32Array;
+    readonly width: number;
+};
+/**
+ * Allocate a canvas buffer and return a context that mutates it in place.
+ * The buffer is typed-array backed; all mutations O(1) per cell with no
+ * object allocation.
+ */
+export declare const createCanvasBuffer: (width: number, height: number) => CanvasBuffer;
+/**
+ * Serialize a buffer row into an ANSI string, coalescing adjacent cells that
+ * share the same style. Call directly when you need to re-emit rows; row
+ * caching lives one level up in Canvas.tsx.
+ */
+export declare const serializeRow: (buffer: CanvasBuffer, row: number) => string;
+export {};

package/dist/ink/components/accordion.d.ts

@@ -0,0 +1,52 @@
+import type { AnsiColors } from "@visulima/colorize";
+import type { ReactElement, ReactNode } from "react";
+import type { LiteralUnion } from "type-fest";
+export type AccordionItem = {
+    /**
+     * Content rendered when the item is expanded.
+     */
+    readonly content: ReactNode;
+    /**
+     * Unique identifier.
+     */
+    readonly id: string;
+    /**
+     * Header label.
+     */
+    readonly title: ReactNode;
+};
+export type Props = {
+    /**
+     * Accent color for the focused header.
+     * @default "blue"
+     */
+    readonly accentColor?: LiteralUnion<AnsiColors, string>;
+    /**
+     * When true, multiple panels can be open at once.
+     * @default false
+     */
+    readonly allowMultiple?: boolean;
+    /**
+     * Auto-focus the first item on mount.
+     */
+    readonly autoFocus?: boolean;
+    /**
+     * Initially open item ids.
+     */
+    readonly defaultExpanded?: ReadonlyArray<string>;
+    /**
+     * Disable interaction.
+     */
+    readonly isDisabled?: boolean;
+    /**
+     * List of panels.
+     */
+    readonly items: ReadonlyArray<AccordionItem>;
+};
+/**
+ * Keyboard-navigable accordion. Use arrow keys to move between panels and
+ * Enter / Space to toggle.
+ * @param props See {@link Props}.
+ * @returns A `ReactElement` rendering the accordion column.
+ */
+export default function Accordion({ accentColor, allowMultiple, autoFocus, defaultExpanded, isDisabled, items, }: Props): ReactElement;

package/dist/ink/components/animate-presence.d.ts

@@ -0,0 +1,15 @@
+import type { ReactElement, ReactNode } from "react";
+export type Props = {
+    /**
+     * Keyed children. Any child that accepts a `show: boolean` prop and calls
+     * `onExit` when its exit transition finishes (such as `<Transition />`) is
+     * orchestrated automatically. Other children render as-is.
+     */
+    readonly children: ReactNode;
+};
+/**
+ * Orchestrates enter / exit animations for keyed children. Wrap a dynamic
+ * list of `<Transition />` (or any component accepting `show` + `onExit`) to
+ * keep outgoing children mounted until their exit animation finishes.
+ */
+export default function AnimatePresence({ children }: Props): ReactElement;

package/dist/ink/components/approval-prompt.d.ts

@@ -0,0 +1,55 @@
+import type { AnsiColors } from "@visulima/colorize";
+import type { ReactElement, ReactNode } from "react";
+import type { LiteralUnion } from "type-fest";
+export type ApprovalRisk = "high" | "low" | "medium";
+export type ApprovalDecision = "allow-always" | "allow-once" | "deny";
+export type Props = {
+    /**
+     * Accent color for the highlighted option letters. Overrides the risk color.
+     */
+    readonly accentColor?: LiteralUnion<AnsiColors, string>;
+    /**
+     * Auto-focus the prompt on mount. Set to `false` if a parent already
+     * owns focus and routes input to this component.
+     * @default true
+     */
+    readonly autoFocus?: boolean;
+    /**
+     * Optional body rendered between the header and the prompt line (e.g. a
+     * rendered diff or command preview).
+     */
+    readonly children?: ReactNode;
+    /**
+     * Accessible description of what approving will do.
+     */
+    readonly description?: string;
+    /**
+     * Disable input; use when a parent manages focus and input routing.
+     */
+    readonly isDisabled?: boolean;
+    /**
+     * Resolution callback. Called once the user answers.
+     */
+    readonly onDecision: (decision: ApprovalDecision) => void;
+    /**
+     * Params shown as a compact key=value preview.
+     */
+    readonly params?: Readonly<Record<string, unknown>>;
+    /**
+     * Severity badge; controls the border color.
+     * @default "medium"
+     */
+    readonly risk?: ApprovalRisk;
+    /**
+     * Name of the tool / action under review.
+     */
+    readonly tool: string;
+};
+/**
+ * Three-way approval prompt for tool calls. Resolves via `onDecision`:
+ * `y` / Enter → allow-once, `a` → allow-always, `n` / Esc → deny.
+ * @param props See {@link Props}.
+ * @returns A bordered `ReactElement` containing the risk banner, params
+ * preview, optional body, and the prompt line.
+ */
+export default function ApprovalPrompt({ accentColor, autoFocus, children, description, isDisabled, onDecision, params, risk, tool, }: Props): ReactElement;

package/dist/ink/components/area-chart.d.ts

@@ -0,0 +1,54 @@
+import type { AnsiColors } from "@visulima/colorize";
+import type { ReactElement } from "react";
+import type { LiteralUnion } from "type-fest";
+import type { LineSeries } from "./line-chart.d.ts";
+export type Props = {
+    /**
+     * Axis label color.
+     * @default "gray"
+     */
+    readonly axisColor?: LiteralUnion<AnsiColors, string>;
+    /**
+     * Density of the shaded fill below each line.
+     * - `light` → `░`
+     * - `medium` → `▒` (default)
+     * - `heavy` → `▓`
+     */
+    readonly fillDensity?: "heavy" | "light" | "medium";
+    /**
+     * Chart body height in character rows.
+     * @default 10
+     */
+    readonly height?: number;
+    /**
+     * Upper bound for the y-axis.
+     */
+    readonly maxY?: number;
+    /**
+     * Lower bound for the y-axis.
+     */
+    readonly minY?: number;
+    /**
+     * Fallback palette.
+     */
+    readonly palette?: ReadonlyArray<LiteralUnion<AnsiColors, string>>;
+    /**
+     * Series to plot.
+     */
+    readonly series: ReadonlyArray<LineSeries>;
+    /**
+     * Render the legend below the plot.
+     * @default true
+     */
+    readonly showLegend?: boolean;
+    /**
+     * Chart body width in character columns.
+     * @default 40
+     */
+    readonly width?: number;
+};
+/**
+ * Area chart: line chart with the area between the line and the baseline
+ * filled with shaded blocks.
+ */
+export default function AreaChart({ axisColor, fillDensity, height, maxY, minY, palette, series, showLegend, width, }: Props): ReactElement;

package/dist/ink/components/bar-chart.d.ts

@@ -0,0 +1,57 @@
+import type { AnsiColors } from "@visulima/colorize";
+import type { ReactElement } from "react";
+import type { LiteralUnion } from "type-fest";
+export type BarDatum = {
+    /**
+     * Per-bar color override. Falls back to the chart-level palette.
+     */
+    readonly color?: LiteralUnion<AnsiColors, string>;
+    readonly label?: string;
+    readonly value: number;
+};
+export type Props = {
+    /**
+     * Bars to render.
+     */
+    readonly data: ReadonlyArray<BarDatum>;
+    /**
+     * Total height of the plot area in character rows.
+     * @default 10
+     */
+    readonly height?: number;
+    /**
+     * Optional upper bound for the axis. When omitted the chart uses the
+     * largest value in `data`.
+     */
+    readonly max?: number;
+    /**
+     * Orientation of the bars.
+     * @default "vertical"
+     */
+    readonly orientation?: "horizontal" | "vertical";
+    /**
+     * Fallback palette cycled through when a bar does not provide its own color.
+     * @default ["cyan", "magenta", "yellow", "green", "blue", "red"]
+     */
+    readonly palette?: ReadonlyArray<LiteralUnion<AnsiColors, string>>;
+    /**
+     * Render labels underneath vertical bars (or to the left of horizontal bars).
+     * @default true
+     */
+    readonly showLabels?: boolean;
+    /**
+     * Render numeric values next to each bar.
+     * @default false
+     */
+    readonly showValues?: boolean;
+    /**
+     * Total width of the plot area in character columns. Defaults to
+     * `data.length * 3` for vertical charts, or `24` for horizontal.
+     */
+    readonly width?: number;
+};
+/**
+ * Bar chart rendered on top of `Canvas`. Uses fractional block glyphs for
+ * sub-cell precision (▁▂▃▄▅▆▇█ vertical, ▏▎▍▌▋▊▉█ horizontal).
+ */
+export default function BarChart({ data, height, max: maxOverride, orientation, palette, showLabels, showValues, width: widthOverride, }: Props): ReactElement;

package/dist/ink/components/blink-dot.d.ts

@@ -0,0 +1,30 @@
+import type { AnsiColors } from "@visulima/colorize";
+import type { ReactElement } from "react";
+import type { LiteralUnion } from "type-fest";
+export type Props = {
+    /**
+     * Dot character.
+     * @default "●"
+     */
+    readonly character?: string;
+    /**
+     * Dot color.
+     * @default "red"
+     */
+    readonly color?: LiteralUnion<AnsiColors, string>;
+    /**
+     * Milliseconds per blink cycle. The dot is visible for half the cycle.
+     * @default 800
+     */
+    readonly interval?: number;
+    /**
+     * When false, the dot stays solid (no animation).
+     * @default true
+     */
+    readonly isActive?: boolean;
+};
+/**
+ * Steady or blinking indicator dot. Pair with `StatusLine` or next to a
+ * label to show a "live" / "recording" status.
+ */
+export default function BlinkDot({ character, color, interval, isActive }: Props): ReactElement;

package/dist/ink/components/breadcrumb.d.ts

@@ -0,0 +1,28 @@
+import type { AnsiColors } from "@visulima/colorize";
+import type { ReactElement, ReactNode } from "react";
+import type { LiteralUnion } from "type-fest";
+export type BreadcrumbItem = {
+    readonly icon?: ReactNode;
+    readonly key?: string;
+    readonly label: string;
+};
+export type Props = {
+    /**
+     * Color applied to the trailing (current) item.
+     * @default "blue"
+     */
+    readonly currentColor?: LiteralUnion<AnsiColors, string>;
+    /**
+     * Items to display from root to current page.
+     */
+    readonly items: ReadonlyArray<BreadcrumbItem>;
+    /**
+     * Separator between items.
+     * @default "›"
+     */
+    readonly separator?: string;
+};
+/**
+ * Render a breadcrumb trail (last item is highlighted).
+ */
+export default function Breadcrumb({ currentColor, items, separator }: Props): ReactElement;

package/dist/ink/components/button.d.ts

@@ -0,0 +1,38 @@
+import type { AnsiColors } from "@visulima/colorize";
+import type { ReactElement, ReactNode } from "react";
+import type { LiteralUnion } from "type-fest";
+export type ButtonVariant = "ghost" | "outline" | "primary" | "secondary";
+export type Props = {
+    /**
+     * Accent color used when the button is focused.
+     * @default "blue"
+     */
+    readonly accentColor?: LiteralUnion<AnsiColors, string>;
+    /**
+     * Focus this button when mounted if nothing else is focused.
+     */
+    readonly autoFocus?: boolean;
+    /**
+     * Button label.
+     */
+    readonly children: ReactNode;
+    /**
+     * When true, the button ignores input and is rendered dim.
+     */
+    readonly isDisabled?: boolean;
+    /**
+     * Called when the user presses Enter or Space while the button has focus.
+     */
+    readonly onPress?: () => void;
+    /**
+     * Visual style.
+     * @default "primary"
+     */
+    readonly variant?: ButtonVariant;
+};
+/**
+ * Focusable button. Triggers `onPress` on Enter / Space.
+ * @param props See {@link Props}.
+ * @returns A `ReactElement` rendering the button (bordered or ghost variant).
+ */
+export default function Button({ accentColor, autoFocus, children, isDisabled, onPress, variant }: Props): ReactElement;

package/dist/ink/components/calendar.d.ts

@@ -0,0 +1,60 @@
+import type { AnsiColors } from "@visulima/colorize";
+import type { ReactElement } from "react";
+import type { LiteralUnion } from "type-fest";
+export type Props = {
+    /**
+     * Accent color for today / the focused cell.
+     * @default "blue"
+     */
+    readonly accentColor?: LiteralUnion<AnsiColors, string>;
+    /**
+     * Auto-focus the grid on mount.
+     */
+    readonly autoFocus?: boolean;
+    /**
+     * Initial focused day when uncontrolled. Defaults to `value` or today.
+     */
+    readonly defaultValue?: Date;
+    /**
+     * First day of the week: 0 = Sunday, 1 = Monday.
+     * @default 1
+     */
+    readonly firstDayOfWeek?: 0 | 1;
+    /**
+     * When true, disable input and render the grid dim.
+     */
+    readonly isDisabled?: boolean;
+    /**
+     * Upper bound; days after `maxDate` cannot be selected.
+     */
+    readonly maxDate?: Date;
+    /**
+     * Lower bound; days before `minDate` cannot be selected.
+     */
+    readonly minDate?: Date;
+    /**
+     * Called whenever the user navigates or selects a day.
+     */
+    readonly onChange?: (date: Date) => void;
+    /**
+     * Called when the user presses Enter.
+     */
+    readonly onSubmit?: (date: Date) => void;
+    /**
+     * Color used to mark the currently selected day.
+     * @default "green"
+     */
+    readonly selectedColor?: LiteralUnion<AnsiColors, string>;
+    /**
+     * Controlled selected date.
+     */
+    readonly value?: Date;
+};
+/**
+ * Month-grid date picker. Arrow keys move focus by one day, page up/down move
+ * by month. Enter submits; Space or Enter selects.
+ * @param props See {@link Props}.
+ * @returns A bordered `ReactElement` containing the month header, weekday
+ * labels, and the day grid.
+ */
+export default function Calendar({ accentColor, autoFocus, defaultValue, firstDayOfWeek, isDisabled, maxDate, minDate, onChange, onSubmit, selectedColor, value, }: Props): ReactElement;