@visulima/tui 1.0.0-alpha.4 → 1.0.0-alpha.5

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

@@ -1,70 +0,0 @@
-import type { AnsiColors } from "@visulima/colorize";
-import type { ReactElement, ReactNode } from "react";
-import type { LiteralUnion } from "type-fest";
-export type MenuItem = {
-    /**
-     * Optional hotkey rendered on the right side of the row (e.g. `"Ctrl+S"`).
-     */
-    readonly hotkey?: string;
-    /**
-     * Optional icon rendered before the label.
-     */
-    readonly icon?: ReactNode;
-    /**
-     * Identifier returned by `onSelect`.
-     */
-    readonly id: string;
-    /**
-     * When true, renders the item dimmed and skips it during navigation.
-     */
-    readonly isDisabled?: boolean;
-    /**
-     * Human-readable label.
-     */
-    readonly label: ReactNode;
-};
-export type MenuSection = {
-    readonly id: string;
-    readonly items: ReadonlyArray<MenuItem>;
-    readonly title?: string;
-};
-export type Props = {
-    /**
-     * Accent color for the focused item.
-     * @default "blue"
-     */
-    readonly accentColor?: LiteralUnion<AnsiColors, string>;
-    /**
-     * Auto-focus the menu on mount.
-     */
-    readonly autoFocus?: boolean;
-    /**
-     * Render a border around the menu.
-     * @default true
-     */
-    readonly bordered?: boolean;
-    /**
-     * Flat list of items. Ignored if `sections` is provided.
-     */
-    readonly items?: ReadonlyArray<MenuItem>;
-    /**
-     * Called with the item id when the user presses Enter.
-     */
-    readonly onSelect: (id: string) => void;
-    /**
-     * Grouped items. Takes precedence over `items`.
-     */
-    readonly sections?: ReadonlyArray<MenuSection>;
-    /**
-     * Optional title rendered at the top of the menu.
-     */
-    readonly title?: string;
-};
-/**
- * Dropdown / context menu with optional sections and disabled items.
- * Keyboard: ↑/↓ (or j/k) to navigate, Enter to select, Esc to cancel.
- * @param props See {@link Props}.
- * @returns A `ReactElement` rendering the menu, optionally wrapped in a
- * rounded border when `bordered` is true.
- */
-export default function Menu({ accentColor, autoFocus, bordered, items, onSelect, sections, title }: Props): ReactElement;

package/dist/ink/components/message-bubble.d.ts

@@ -1,35 +0,0 @@
-import type { AnsiColors } from "@visulima/colorize";
-import type { ReactElement, ReactNode } from "react";
-import type { LiteralUnion } from "type-fest";
-export type MessageRole = "assistant" | "system" | "tool" | "user";
-export type Props = {
-    /**
-     * Bubble body.
-     */
-    readonly children: ReactNode;
-    /**
-     * Color override.
-     */
-    readonly color?: LiteralUnion<AnsiColors, string>;
-    /**
-     * When true, draws the bubble without a border.
-     */
-    readonly flat?: boolean;
-    /**
-     * Text rendered above the bubble (name, model, etc.).
-     */
-    readonly label?: string;
-    /**
-     * Optional metadata rendered next to the label (e.g. timestamp).
-     */
-    readonly meta?: string;
-    /**
-     * Determines the alignment, color, and icon of the bubble.
-     * @default "assistant"
-     */
-    readonly role?: MessageRole;
-};
-/**
- * Chat-style message bubble for AI agent UIs.
- */
-export default function MessageBubble({ children, color, flat, label, meta, role }: Props): ReactElement;

package/dist/ink/components/model-badge.d.ts

@@ -1,32 +0,0 @@
-import type { AnsiColors } from "@visulima/colorize";
-import type { ReactElement, ReactNode } from "react";
-import type { LiteralUnion } from "type-fest";
-export type Props = {
-    /**
-     * Background color of the badge.
-     * @default "magenta"
-     */
-    readonly color?: LiteralUnion<AnsiColors, string>;
-    /**
-     * Optional icon/symbol (e.g. `✨`, `◈`) shown before the label.
-     */
-    readonly icon?: ReactNode;
-    /**
-     * Short model identifier, e.g. `claude-opus-4.6`.
-     */
-    readonly model: string;
-    /**
-     * Optional provider name rendered as a separate chip before the model.
-     */
-    readonly provider?: string;
-    /**
-     * Visual style.
-     * @default "solid"
-     */
-    readonly variant?: "outline" | "solid" | "subtle";
-};
-/**
- * Pill-shaped chip identifying the active model / provider. Pair with
- * `MessageBubble` to label assistant output.
- */
-export default function ModelBadge({ color, icon, model, provider, variant }: Props): ReactElement;

package/dist/ink/components/multi-select.d.ts

@@ -1,63 +0,0 @@
-/**
- * Multi-select input component for Ink.
- *
- * Inspired by ink-ui MultiSelect by Vadim Demedes.
- * @see https://github.com/vadimdemedes/ink-ui
- *
- * MIT License
- * Copyright (c) Vadym Demedes (github.com/vadimdemedes)
- */
-import type { AnsiColors } from "@visulima/colorize";
-import type { ReactElement } from "react";
-import type { LiteralUnion } from "type-fest";
-export type MultiSelectOption = {
-    readonly key?: string;
-    readonly label: string;
-    readonly value: string;
-};
-export type Props = {
-    /**
-     * Color for the focused item indicator and selected checkmarks.
-     * @default "blue"
-     */
-    readonly accentColor?: LiteralUnion<AnsiColors, string>;
-    /**
-     * Color for unselected, unfocused option labels.
-     */
-    readonly defaultColor?: LiteralUnion<AnsiColors, string>;
-    /**
-     * Initially selected values.
-     */
-    readonly defaultValue?: ReadonlyArray<string>;
-    /**
-     * When true, all input is ignored and labels are dimmed.
-     * @default false
-     */
-    readonly isDisabled?: boolean;
-    /**
-     * Whether the parent has focus. When false, indicators are dimmed.
-     * @default true
-     */
-    readonly isFocused?: boolean;
-    /**
-     * Number of visible options before scrolling.
-     * When omitted, auto-limits to terminal height.
-     */
-    readonly limit?: number;
-    /**
-     * Fires when the set of selected values changes (space to toggle).
-     */
-    readonly onChange?: (values: ReadonlyArray<string>) => void;
-    /**
-     * Fires when the user presses Enter to submit.
-     */
-    readonly onSubmit?: (values: ReadonlyArray<string>) => void;
-    /**
-     * Available choices to pick from.
-     */
-    readonly options: ReadonlyArray<MultiSelectOption>;
-};
-/**
- * Renders a multi-choice selection list with checkboxes and keyboard navigation.
- */
-export default function MultiSelect({ accentColor, defaultColor, defaultValue, isDisabled, isFocused, limit: customLimit, onChange, onSubmit, options, }: Props): ReactElement;

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

@@ -1,12 +0,0 @@
-import type { ReactElement } from "react";
-export type Props = {
-    /**
-     * Number of newlines to insert.
-     * @default 1
-     */
-    readonly count?: number;
-};
-/**
- * Adds one or more newline (`\n`) characters. Must be used within `<Text>` components.
- */
-export default function Newline({ count }: Props): ReactElement;

package/dist/ink/components/operation-tree.d.ts

@@ -1,46 +0,0 @@
-import type { ReactElement, ReactNode } from "react";
-export type OperationStatus = "completed" | "error" | "pending" | "running" | "skipped";
-export type OperationNode = {
-    /**
-     * Nested child operations rendered beneath this node.
-     */
-    readonly children?: ReadonlyArray<OperationNode>;
-    /**
-     * Optional supplementary info rendered on the next line (dimmed).
-     */
-    readonly details?: ReactNode;
-    /**
-     * Wall-clock duration in ms, displayed right-aligned.
-     */
-    readonly durationMs?: number;
-    /**
-     * Unique identifier within the tree.
-     */
-    readonly id: string;
-    /**
-     * Human-readable label.
-     */
-    readonly label: ReactNode;
-    /**
-     * Lifecycle state controlling icon + color.
-     */
-    readonly status: OperationStatus;
-};
-export type Props = {
-    /**
-     * Tree of operations. Each node can have its own children.
-     */
-    readonly nodes: ReadonlyArray<OperationNode>;
-    /**
-     * When true, runs the running-spinner animation.
-     * @default true
-     */
-    readonly showSpinner?: boolean;
-};
-/**
- * Renders a tree of operations with per-node status. Perfect for agent
- * progress panels (reading → editing → running tests → done).
- * @param props See {@link Props}.
- * @returns A `ReactElement` rendering the nested tree of operation rows.
- */
-export default function OperationTree({ nodes, showSpinner }: Props): ReactElement;

package/dist/ink/components/option-list.d.ts

@@ -1,41 +0,0 @@
-import type { AnsiColors } from "@visulima/colorize";
-import type { ReactElement, ReactNode } from "react";
-import type { LiteralUnion } from "type-fest";
-export type OptionListEntry = {
-    readonly description?: string;
-    readonly icon?: ReactNode;
-    readonly id: string;
-    readonly label: ReactNode;
-    readonly trailing?: ReactNode;
-};
-export type Props = {
-    /**
-     * Highlight color for the row marked as current.
-     */
-    readonly accentColor?: LiteralUnion<AnsiColors, string>;
-    /**
-     * Render the list with a border.
-     */
-    readonly bordered?: boolean;
-    /**
-     * Id of the row to highlight. No visual change if omitted.
-     */
-    readonly currentId?: string;
-    /**
-     * Icon width in characters for column alignment.
-     * @default 2
-     */
-    readonly iconColumnWidth?: number;
-    /**
-     * Entries to render.
-     */
-    readonly options: ReadonlyArray<OptionListEntry>;
-};
-/**
- * Read-only presentational option list. Like `SelectInput` but without focus,
- * input handling, or scrolling — just a styled list of rows. Useful inside
- * modals, sidebars, or summary panels.
- * @param props See {@link Props}.
- * @returns A `ReactElement` rendering the list; bordered when requested.
- */
-export default function OptionList({ accentColor, bordered, currentId, iconColumnWidth, options }: Props): ReactElement;

package/dist/ink/components/ordered-list.d.ts

@@ -1,30 +0,0 @@
-/**
- * Ordered list component for Ink.
- *
- * Inspired by ink-ui OrderedList by Vadim Demedes.
- * @see https://github.com/vadimdemedes/ink-ui
- *
- * MIT License
- * Copyright (c) Vadym Demedes (github.com/vadimdemedes)
- */
-import type { ReactElement, ReactNode } from "react";
-export type OrderedListEntry = {
-    /**
-     * Nested sub-items, rendered as a sub-list with hierarchical numbering.
-     */
-    readonly children?: ReadonlyArray<OrderedListEntry>;
-    /**
-     * Display text for this item.
-     */
-    readonly label: ReactNode;
-};
-export type Props = {
-    /**
-     * Entries to render as a numbered list.
-     */
-    readonly items: ReadonlyArray<OrderedListEntry>;
-};
-/**
- * Renders a numbered list with hierarchical nesting support.
- */
-export default function OrderedList({ items }: Props): ReactElement;

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

@@ -1,59 +0,0 @@
-import type { ReactElement, ReactNode } from "react";
-/**
- * Metadata about the current page state, passed to the render-prop children.
- */
-export type PageMeta = {
-    readonly currentPage: number;
-    readonly endIndex: number;
-    readonly isFirstPage: boolean;
-    readonly isLastPage: boolean;
-    readonly startIndex: number;
-    readonly totalPages: number;
-};
-export type Props<T> = {
-    /**
-     * Render-prop that receives the current page items and page metadata.
-     */
-    readonly children: (pageItems: ReadonlyArray<T>, meta: PageMeta) => ReactNode;
-    /**
-     * Uncontrolled initial page (0-indexed).
-     * @default 0
-     */
-    readonly defaultPage?: number;
-    /**
-     * Color for the active page indicator.
-     * @default "cyan"
-     */
-    readonly indicatorColor?: string;
-    /**
-     * Whether keyboard navigation is active.
-     * @default true
-     */
-    readonly isFocused?: boolean;
-    /**
-     * The full list of items to paginate.
-     */
-    readonly items: ReadonlyArray<T>;
-    /**
-     * Called when the page changes.
-     */
-    readonly onChange?: (page: number) => void;
-    /**
-     * Controlled current page (0-indexed). When provided, the component is controlled.
-     */
-    readonly page?: number;
-    /**
-     * Number of items per page.
-     */
-    readonly pageSize: number;
-    /**
-     * Indicator style.
-     * - `"dots"`: `● ○ ○ ○`
-     * - `"numeric"`: `‹ 1 / 4 ›`
-     * - `"fraction"`: `1/4`
-     * @default "dots"
-     */
-    readonly style?: "dots" | "fraction" | "numeric";
-};
-declare const Paginator: <T>({ children, defaultPage, indicatorColor, isFocused, items, onChange, page: controlledPage, pageSize, style, }: Props<T>) => ReactElement;
-export default Paginator;

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

@@ -1,31 +0,0 @@
-import type { AnsiColors } from "@visulima/colorize";
-import type { ReactElement, ReactNode } from "react";
-import type { LiteralUnion } from "type-fest";
-export type Props = {
-    /**
-     * Paragraph body.
-     */
-    readonly children: ReactNode;
-    /**
-     * Foreground color.
-     */
-    readonly color?: LiteralUnion<AnsiColors, string>;
-    /**
-     * Render the paragraph with dim color.
-     */
-    readonly dimColor?: boolean;
-    /**
-     * Blank lines to add after the paragraph.
-     * @default 1
-     */
-    readonly marginBottom?: number;
-    /**
-     * Blank lines to add before the paragraph.
-     * @default 0
-     */
-    readonly marginTop?: number;
-};
-/**
- * Wraps body text with a trailing blank line. Useful for README-style layouts.
- */
-export default function Paragraph({ children, color, dimColor, marginBottom, marginTop }: Props): ReactElement;

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

@@ -1,47 +0,0 @@
-import type { AnsiColors } from "@visulima/colorize";
-import type { ReactElement } from "react";
-import type { LiteralUnion } from "type-fest";
-export type Props = {
-    /**
-     * Whether to pulse the skeleton blocks (shimmer).
-     * @default true
-     */
-    readonly animated?: boolean;
-    /**
-     * Fill character used for each block.
-     * @default "█"
-     */
-    readonly character?: string;
-    /**
-     * Block color.
-     * @default "gray"
-     */
-    readonly color?: LiteralUnion<AnsiColors, string>;
-    /**
-     * Milliseconds between pulses.
-     * @default 500
-     */
-    readonly interval?: number;
-    /**
-     * Number of skeleton rows to render.
-     * @default 3
-     */
-    readonly rows?: number;
-    /**
-     * Total width reference. When omitted, the block flexes to fill its
-     * parent.
-     */
-    readonly width?: number;
-    /**
-     * Relative widths of each row (0–1). The list is sampled cyclically.
-     * @default [1, 0.85, 0.6]
-     */
-    readonly widths?: ReadonlyArray<number>;
-};
-/**
- * Skeleton loading indicator. Renders a stack of solid blocks whose widths
- * vary to mimic text placeholders. Pair with `async` data fetching.
- * @param props See {@link Props}.
- * @returns A `ReactElement` rendering the skeleton rows.
- */
-export default function Placeholder({ animated, character, color, interval, rows, width, widths, }: Props): ReactElement;

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

@@ -1,51 +0,0 @@
-/**
- * Progress bar component for Ink.
- *
- * Based on ink-progress-bar by Frankie Bagnardi (brigand).
- * @see https://github.com/brigand/ink-progress-bar
- *
- * MIT License
- * Copyright (c) Frankie Bagnardi
- */
-import type { ReactElement } from "react";
-import type { Props as TextProps } from "./text.d.ts";
-export type Props = {
-    /** Fill glyph repeated across the completed portion of the progress bar. Defaults to "█". */
-    readonly character?: string;
-    /**
-     * Override the terminal width used for calculation.
-     * When 0, uses the actual terminal width.
-     * @default 0
-     */
-    readonly columns?: number;
-    /**
-     * Number of columns reserved on the left side (e.g. for labels).
-     * @default 0
-     */
-    readonly left?: number;
-    /**
-     * Completion percentage between 0 and 1.
-     * @default 1
-     */
-    readonly percent?: number;
-    /**
-     * Number of columns reserved on the right side (e.g. for percentage text).
-     * @default 0
-     */
-    readonly right?: number;
-    /**
-     * Whether to pad the remaining space with whitespace.
-     * Useful when rendering the bar over a background color.
-     * @default false
-     */
-    readonly rightPad?: boolean;
-} & Omit<TextProps, "children">;
-/**
- * A terminal progress bar that fills proportionally to a percentage value.
- *
- * ```tsx
- * &lt;ProgressBar percent={0.5} />
- * &lt;ProgressBar percent={0.75} color="green" left={10} right={5} />
- * ```
- */
-export default function ProgressBar({ character, columns: columnsProp, left, percent, right, rightPad, ...textProps }: Props): ReactElement;

package/dist/ink/components/radio-group.d.ts

@@ -1,62 +0,0 @@
-import type { AnsiColors } from "@visulima/colorize";
-import type { ReactElement } from "react";
-import type { LiteralUnion } from "type-fest";
-export type RadioOption = {
-    readonly description?: string;
-    readonly key?: string;
-    readonly label: string;
-    readonly value: string;
-};
-export type Props = {
-    /**
-     * Accent color for the focused and selected indicator.
-     * @default "blue"
-     */
-    readonly accentColor?: LiteralUnion<AnsiColors, string>;
-    /**
-     * Auto-focus when mounted.
-     */
-    readonly autoFocus?: boolean;
-    /**
-     * When true, moving focus with arrow keys immediately updates the selected
-     * value (and fires `onChange`). When false, focus moves independently and
-     * selection commits only on Space or Enter.
-     * @default true
-     */
-    readonly commitOnNavigate?: boolean;
-    /**
-     * Initial selected value when uncontrolled.
-     */
-    readonly defaultValue?: string;
-    /**
-     * Disable input and dim labels.
-     */
-    readonly isDisabled?: boolean;
-    /**
-     * Called when selection changes.
-     */
-    readonly onChange?: (value: string) => void;
-    /**
-     * Called when the user submits by pressing Enter.
-     */
-    readonly onSubmit?: (value: string) => void;
-    /**
-     * Available options.
-     */
-    readonly options: ReadonlyArray<RadioOption>;
-    /**
-     * Orientation of options.
-     * @default "vertical"
-     */
-    readonly orientation?: "horizontal" | "vertical";
-    /**
-     * Controlled selected value.
-     */
-    readonly value?: string;
-};
-/**
- * Single-choice radio group with keyboard navigation. By default, navigation
- * commits selection; set `commitOnNavigate={false}` to require an explicit
- * Space/Enter commit.
- */
-export default function RadioGroup({ accentColor, autoFocus, commitOnNavigate, defaultValue, isDisabled, onChange, onSubmit, options, orientation, value, }: Props): ReactElement;

package/dist/ink/components/scatter-plot.d.ts

@@ -1,23 +0,0 @@
-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 = {
-    readonly axisColor?: LiteralUnion<AnsiColors, string>;
-    readonly height?: number;
-    readonly maxX?: number;
-    readonly maxY?: number;
-    readonly minX?: number;
-    readonly minY?: number;
-    readonly palette?: ReadonlyArray<LiteralUnion<AnsiColors, string>>;
-    readonly series: ReadonlyArray<LineSeries>;
-    readonly showLegend?: boolean;
-    readonly width?: number;
-};
-/**
- * Scatter plot rendered on a braille pixel grid. Each sample lights one
- * sub-cell pixel; overlapping points merge into denser braille glyphs.
- * @param props See {@link Props}.
- * @returns A `ReactElement` containing the plot and an optional legend.
- */
-export default function ScatterPlot({ axisColor, height, maxX, maxY, minX, minY, palette, series, showLegend, width, }: Props): ReactElement;

package/dist/ink/components/scroll/controlled-scroll-view.d.ts

@@ -1,43 +0,0 @@
-import type React from "react";
-import type { ReactNode, Ref } from "react";
-import type { Props as BoxProps } from "../box.d.ts";
-export interface ControlledScrollViewProps extends BoxProps {
-    children?: ReactNode;
-    debug?: boolean;
-    onContentHeightChange?: (height: number, previousHeight: number) => void;
-    onItemHeightChange?: (index: number, height: number, previousHeight: number) => void;
-    onViewportSizeChange?: (size: {
-        height: number;
-        width: number;
-    }, previousSize: {
-        height: number;
-        width: number;
-    }) => void;
-    /**
-     * Number of extra items to render above/below the viewport when virtualized.
-     * @default 3
-     */
-    overscan?: number;
-    scrollOffset: number;
-    /**
-     * Only render items visible in the viewport plus overscan.
-     * Items must be measured first (first render always renders all items).
-     * @default false
-     */
-    virtualize?: boolean;
-}
-export interface ControlledScrollViewRef {
-    getBottomOffset: () => number;
-    getContentHeight: () => number;
-    getItemHeight: (index: number) => number;
-    getItemPosition: (index: number) => {
-        height: number;
-        top: number;
-    } | null;
-    getViewportHeight: () => number;
-    remeasure: () => void;
-    remeasureItem: (index: number) => void;
-}
-export declare const ControlledScrollView: ({ children, debug, onContentHeightChange, onItemHeightChange, onViewportSizeChange, overscan, ref, scrollOffset, virtualize, ...boxProps }: ControlledScrollViewProps & {
-    ref?: Ref<ControlledScrollViewRef>;
-}) => React.JSX.Element;

package/dist/ink/components/scroll/index.d.ts

@@ -1,10 +0,0 @@
-export type { ControlledScrollViewProps, ControlledScrollViewRef } from "./controlled-scroll-view.d.ts";
-export { ControlledScrollView } from "./controlled-scroll-view.d.ts";
-export type { ScrollBarPlacement, ScrollBarProps, ScrollBarStyle } from "./scroll-bar.d.ts";
-export { ScrollBar } from "./scroll-bar.d.ts";
-export type { ScrollBarBoxProps } from "./scroll-bar-box.d.ts";
-export { ScrollBarBox } from "./scroll-bar-box.d.ts";
-export type { ScrollAlignment, ScrollListProps, ScrollListRef } from "./scroll-list.d.ts";
-export { ScrollList } from "./scroll-list.d.ts";
-export type { ScrollViewProps, ScrollViewRef } from "./scroll-view.d.ts";
-export { ScrollView } from "./scroll-view.d.ts";