@visulima/tui-kit 1.0.0 → 1.0.2

package/dist/status-line.d.ts

@@ -3,35 +3,29 @@ import { ReactNode, ReactElement } from 'react';
 import { LiteralUnion } from 'type-fest';
 type Props = {
   /**
-  * Background color spanning the whole row.
-  */
+   * Background color spanning the whole row.
+   */
   readonly backgroundColor?: LiteralUnion<AnsiColors, string>;
   /**
-  * Content rendered in the center. Optional.
-  */
+   * Content rendered in the center. Optional.
+   */
   readonly center?: ReactNode;
   /**
-  * Default foreground for text rendered inside the row.
-  */
+   * Default foreground for text rendered inside the row.
+   */
   readonly color?: LiteralUnion<AnsiColors, string>;
   /**
-  * Content rendered flush-left.
-  */
+   * Content rendered flush-left.
+   */
   readonly left?: ReactNode;
   /**
-  * Content rendered flush-right.
-  */
+   * Content rendered flush-right.
+   */
   readonly right?: ReactNode;
 };
 /**
-* Full-width status bar with left / center / right slots. Typically pinned to
-* the bottom of the UI.
-*/
-declare function StatusLine({
-  backgroundColor,
-  center,
-  color,
-  left,
-  right
-}: Props): ReactElement;
+ * Full-width status bar with left / center / right slots. Typically pinned to
+ * the bottom of the UI.
+ */
+declare function StatusLine({ backgroundColor, center, color, left, right }: Props): ReactElement;
 export { Props, StatusLine, type Props as StatusLineProps, StatusLine as default };

package/dist/status-message.d.ts

@@ -3,19 +3,16 @@ import { V as Variant } from "./packem_shared/variant-config.d-D5NnrrQK.js";
 type StatusMessageVariant = Variant;
 type Props = {
   /**
-  * Message content.
-  */
+   * Message content.
+   */
   readonly children: ReactNode;
   /**
-  * Determines the icon and color of the status message.
-  */
+   * Determines the icon and color of the status message.
+   */
   readonly variant: StatusMessageVariant;
 };
 /**
-* Renders a status notification with a colored icon and message text.
-*/
-declare function StatusMessage({
-  children,
-  variant
-}: Props): ReactElement;
+ * Renders a status notification with a colored icon and message text.
+ */
+declare function StatusMessage({ children, variant }: Props): ReactElement;
 export { Props, StatusMessage, type Props as StatusMessageProps, StatusMessageVariant, StatusMessage as default };

package/dist/stepper.d.ts

@@ -10,39 +10,33 @@ type StepperStep = {
 };
 type Props = {
   /**
-  * Color used for active and completed steps.
-  * @default "blue"
-  */
+   * Color used for active and completed steps.
+   * @default "blue"
+   */
   readonly accentColor?: LiteralUnion<AnsiColors, string>;
   /**
-  * Index of the current step (used when steps do not provide a status).
-  * @default 0
-  */
+   * Index of the current step (used when steps do not provide a status).
+   * @default 0
+   */
   readonly activeIndex?: number;
   /**
-  * Color used for errors.
-  * @default "red"
-  */
+   * Color used for errors.
+   * @default "red"
+   */
   readonly errorColor?: LiteralUnion<AnsiColors, string>;
   /**
-  * Orientation of the stepper.
-  * @default "horizontal"
-  */
+   * Orientation of the stepper.
+   * @default "horizontal"
+   */
   readonly orientation?: "horizontal" | "vertical";
   /**
-  * List of steps.
-  */
+   * List of steps.
+   */
   readonly steps: ReadonlyArray<StepperStep>;
 };
 /**
-* Step indicator for multi-stage flows.
-* @returns A `ReactElement` rendering the steps horizontally or vertically.
-*/
-declare function Stepper({
-  accentColor,
-  activeIndex,
-  errorColor,
-  orientation,
-  steps
-}: Props): ReactElement;
+ * Step indicator for multi-stage flows.
+ * @returns A `ReactElement` rendering the steps horizontally or vertically.
+ */
+declare function Stepper({ accentColor, activeIndex, errorColor, orientation, steps }: Props): ReactElement;
 export { Props, StepStatus, Stepper, type Props as StepperProps, StepperStep, Stepper as default };

package/dist/stopwatch.d.ts

@@ -3,47 +3,40 @@ import { Ref, ReactElement } from 'react';
 type StopwatchRef = Omit<UseStopwatchResult, "elapsed" | "isRunning" | "laps">;
 type Props = {
   /**
-  * Whether to start counting immediately.
-  * @default false
-  */
+   * Whether to start counting immediately.
+   * @default false
+   */
   readonly autoStart?: boolean;
   /**
-  * Make the rendered text bold.
-  */
+   * Make the rendered text bold.
+   */
   readonly bold?: boolean;
   /**
-  * Text color for the rendered time.
-  */
+   * Text color for the rendered time.
+   */
   readonly color?: string;
   /**
-  * Custom formatter for the elapsed time.
-  * Receives elapsed milliseconds, returns a display string.
-  * @default formatDuration (MM:SS or HH:MM:SS)
-  */
+   * Custom formatter for the elapsed time.
+   * Receives elapsed milliseconds, returns a display string.
+   * @default formatDuration (MM:SS or HH:MM:SS)
+   */
   readonly format?: (elapsed: number) => string;
   /**
-  * Tick interval in milliseconds.
-  * @default 1000
-  */
+   * Tick interval in milliseconds.
+   * @default 1000
+   */
   readonly interval?: number;
   readonly ref?: Ref<StopwatchRef>;
 };
 /**
-* A count-up stopwatch component.
-*
-* Exposes `start`, `stop`, `toggle`, `reset`, and `lap` methods via ref.
-*
-* ```tsx
-* const ref = useRef&lt;StopwatchRef>(null);
-* &lt;Stopwatch ref={ref} autoStart />
-* ```
-*/
-declare const Stopwatch: ({
-  autoStart,
-  bold,
-  color,
-  format,
-  interval,
-  ref
-}: Props) => ReactElement;
+ * A count-up stopwatch component.
+ *
+ * Exposes `start`, `stop`, `toggle`, `reset`, and `lap` methods via ref.
+ *
+ * ```tsx
+ * const ref = useRef&lt;StopwatchRef>(null);
+ * &lt;Stopwatch ref={ref} autoStart />
+ * ```
+ */
+declare const Stopwatch: ({ autoStart, bold, color, format, interval, ref }: Props) => ReactElement;
 export { Props, Stopwatch, type Props as StopwatchProps, StopwatchRef, Stopwatch as default };

package/dist/streaming-text.d.ts

@@ -3,44 +3,37 @@ import { ReactElement } from 'react';
 import { LiteralUnion } from 'type-fest';
 type Props = {
   /**
-  * Color applied to the streamed output.
-  */
+   * Color applied to the streamed output.
+   */
   readonly color?: LiteralUnion<AnsiColors, string>;
   /**
-  * Glyph rendered at the streaming caret while characters are still being revealed.
-  * @default "▊" (left three quarters block)
-  */
+   * Glyph rendered at the streaming caret while characters are still being revealed.
+   * @default "▊" (left three quarters block)
+   */
   readonly cursor?: string;
   /**
-  * Milliseconds between characters.
-  * @default 20
-  */
+   * Milliseconds between characters.
+   * @default 20
+   */
   readonly interval?: number;
   /**
-  * Called exactly once per `text` value, after the full text has been revealed.
-  */
+   * Called exactly once per `text` value, after the full text has been revealed.
+   */
   readonly onComplete?: () => void;
   /**
-  * Whether to display the cursor after streaming completes.
-  * @default false
-  */
+   * Whether to display the cursor after streaming completes.
+   * @default false
+   */
   readonly showCursorWhenDone?: boolean;
   /**
-  * Full text to stream into the output.
-  */
+   * Full text to stream into the output.
+   */
   readonly text: string;
 };
 /**
-* Typewriter animation that reveals text one character at a time.
-* Automatically resets and replays when `text` changes. `onComplete`
-* fires exactly once per `text` value once it is fully revealed.
-*/
-declare function StreamingText({
-  color,
-  cursor,
-  interval,
-  onComplete,
-  showCursorWhenDone,
-  text
-}: Props): ReactElement;
+ * Typewriter animation that reveals text one character at a time.
+ * Automatically resets and replays when `text` changes. `onComplete`
+ * fires exactly once per `text` value once it is fully revealed.
+ */
+declare function StreamingText({ color, cursor, interval, onComplete, showCursorWhenDone, text }: Props): ReactElement;
 export { Props, StreamingText, type Props as StreamingTextProps, StreamingText as default };

package/dist/switch.d.ts

@@ -3,53 +3,44 @@ import { ReactNode, ReactElement } from 'react';
 import { LiteralUnion } from 'type-fest';
 type Props = {
   /**
-  * Accent color for the on state.
-  * @default "green"
-  */
+   * Accent color for the on state.
+   * @default "green"
+   */
   readonly accentColor?: LiteralUnion<AnsiColors, string>;
   /**
-  * Auto-focus when mounted if nothing else is focused.
-  */
+   * Auto-focus when mounted if nothing else is focused.
+   */
   readonly autoFocus?: boolean;
   /**
-  * Optional label rendered after the switch.
-  */
+   * Optional label rendered after the switch.
+   */
   readonly children?: ReactNode;
   /**
-  * Initial value when uncontrolled.
-  */
+   * Initial value when uncontrolled.
+   */
   readonly defaultValue?: boolean;
   /**
-  * Disable input and dim the switch.
-  */
+   * Disable input and dim the switch.
+   */
   readonly isDisabled?: boolean;
   /**
-  * Labels displayed inside the switch track.
-  * @default ["off", "on"]
-  */
+   * Labels displayed inside the switch track.
+   * @default ["off", "on"]
+   */
   readonly labels?: readonly [string, string];
   /**
-  * Fired when the switch is toggled.
-  */
+   * Fired when the switch is toggled.
+   */
   readonly onChange?: (value: boolean) => void;
   /**
-  * Controlled value. Pair with `onChange` to update the parent.
-  */
+   * Controlled value. Pair with `onChange` to update the parent.
+   */
   readonly value?: boolean;
 };
 /**
-* Focusable on/off switch. Toggles with Space or Enter.
-* @returns A `ReactElement` rendering two labeled segments plus an optional
-* trailing label.
-*/
-declare function Switch({
-  accentColor,
-  autoFocus,
-  children,
-  defaultValue,
-  isDisabled,
-  labels,
-  onChange,
-  value
-}: Props): ReactElement;
+ * Focusable on/off switch. Toggles with Space or Enter.
+ * @returns A `ReactElement` rendering two labeled segments plus an optional
+ * trailing label.
+ */
+declare function Switch({ accentColor, autoFocus, children, defaultValue, isDisabled, labels, onChange, value }: Props): ReactElement;
 export { Props, Switch, type Props as SwitchProps, Switch as default };

package/dist/tab.d.ts

@@ -1,19 +1,17 @@
 import { ReactNode, ReactElement } from 'react';
 type Props = {
   /**
-  * Tab content to render when the tab is active.
-  */
+   * Tab content to render when the tab is active.
+   */
   readonly children: ReactNode;
   /**
-  * Unique name identifying this tab.
-  */
+   * Unique name identifying this tab.
+   */
   readonly name: string;
 };
 /**
-* A single tab within a Tabs container.
-* The `name` prop identifies the tab; `children` is rendered when active.
-*/
-declare function Tab({
-  children
-}: Props): ReactElement;
+ * A single tab within a Tabs container.
+ * The `name` prop identifies the tab; `children` is rendered when active.
+ */
+declare function Tab({ children }: Props): ReactElement;
 export { Props, Tab, type Props as TabProps, Tab as default };

package/dist/table.d.ts

@@ -4,8 +4,8 @@ interface BorderComponent {
   width: number;
 }
 /**
-* Represents the style of the border for a table or grid.
-*/
+ * Represents the style of the border for a table or grid.
+ */
 interface BorderStyle {
   /** Box vertical character. */
   bodyJoin: BorderComponent;
@@ -38,81 +38,80 @@ interface BorderStyle {
   /** Box top right character. */
   topRight: BorderComponent;
 }
-/** Base style properties applicable globally */
 type HorizontalAlignment = "center" | "left" | "right";
 /**
-* Scalar value that can be displayed in a table cell.
-*/
+ * Scalar value that can be displayed in a table cell.
+ */
 type Scalar = bigint | boolean | number | string | null | undefined;
 /**
-* Dictionary with scalar values, representing a single row of data.
-*/
+ * Dictionary with scalar values, representing a single row of data.
+ */
 type ScalarDict = Record<string, Scalar>;
 /**
-* Configuration for a single table column.
-*/
+ * Configuration for a single table column.
+ */
 type ColumnConfig<T extends ScalarDict> = {
   /**
-  * Horizontal alignment of cell content.
-  */
+   * Horizontal alignment of cell content.
+   */
   readonly align?: HorizontalAlignment;
   /**
-  * Custom header label. Defaults to the key name.
-  */
+   * Custom header label. Defaults to the key name.
+   */
   readonly header?: string;
   /**
-  * Key from the data object to display in this column.
-  */
+   * Key from the data object to display in this column.
+   */
   readonly key: keyof T & string;
   /**
-  * Fixed width for this column in characters.
-  */
+   * Fixed width for this column in characters.
+   */
   readonly width?: number;
 };
 type Props<T extends ScalarDict> = {
   /**
-  * Border style preset name or a custom `BorderStyle` object from `@visulima/tabular`.
-  * @default "default"
-  */
+   * Border style preset name or a custom `BorderStyle` object from `@visulima/tabular`.
+   * @default "default"
+   */
   readonly borderStyle?: "ascii" | "block" | "default" | "dots" | "double" | "markdown" | "minimal" | "none" | "rounded" | "thick" | BorderStyle;
   /**
-  * Columns to display and their order.
-  * Accepts simple key strings or `ColumnConfig` objects for advanced control.
-  * If omitted, all keys from the first data item are used.
-  */
+   * Columns to display and their order.
+   * Accepts simple key strings or `ColumnConfig` objects for advanced control.
+   * If omitted, all keys from the first data item are used.
+   */
   readonly columns?: ((keyof T & string) | ColumnConfig<T>)[];
   /**
-  * Array of objects to display as rows.
-  */
+   * Array of objects to display as rows.
+   */
   readonly data: T[];
   /**
-  * Format a cell value before rendering. Return a string to display in the cell.
-  */
+   * Format a cell value before rendering. Return a string to display in the cell.
+   */
   readonly formatCell?: (value: Scalar, column: keyof T & string, rowIndex: number) => string;
   /**
-  * Format a header label before rendering. Return a string to display as the column header.
-  */
+   * Format a header label before rendering. Return a string to display as the column header.
+   */
   readonly formatHeader?: (column: keyof T & string) => string;
   /**
-  * Maximum width of the table in characters. Columns will be truncated or wrapped to fit.
-  */
+   * Maximum width of the table in characters. Columns will be truncated or wrapped to fit.
+   */
   readonly maxWidth?: number;
   /**
-  * Cell padding (left and right) in characters.
-  * @default 1
-  */
+   * Cell padding (left and right) in characters.
+   * @default 1
+   */
   readonly padding?: number;
   /**
-  * Whether to show the header row.
-  * @default true
-  */
+   * Whether to show the header row.
+   * @default true
+   */
   readonly showHeader?: boolean;
   /** Placeholder shown in place of `null` or `undefined` cell values. Defaults to an empty string. */
   readonly skeleton?: string;
   /**
-  * Enable word wrap instead of truncation when cells exceed their width.
-  * @default false
-  */
+   * Enable word wrap instead of truncation when cells exceed their width.
+   * @default false
+   */
   readonly wordWrap?: boolean;
 };
 declare const Table: <T extends ScalarDict>(props: Props<T>) => ReactElement;

package/dist/tabs.d.ts

@@ -3,33 +3,33 @@ import { ReactNode, ReactElement } from 'react';
 import { LiteralUnion } from 'type-fest';
 import { Props as Props$1 } from "./tab.js";
 /**
-* Keyboard navigation configuration for Tabs.
-*/
+ * Keyboard navigation configuration for Tabs.
+ */
 type KeyMap = {
   /**
-  * Key names that move to the next tab.
-  * Defaults to `["rightArrow"]` for row layouts and `["downArrow"]` for column layouts.
-  */
+   * Key names that move to the next tab.
+   * Defaults to `["rightArrow"]` for row layouts and `["downArrow"]` for column layouts.
+   */
   readonly next?: ReadonlyArray<string>;
   /**
-  * Key names that move to the previous tab.
-  * Defaults to `["leftArrow"]` for row layouts and `["upArrow"]` for column layouts.
-  */
+   * Key names that move to the previous tab.
+   * Defaults to `["leftArrow"]` for row layouts and `["upArrow"]` for column layouts.
+   */
   readonly previous?: ReadonlyArray<string>;
   /**
-  * Whether Meta/Cmd + 1–9 jumps to a specific tab.
-  * @default true
-  */
+   * Whether Meta/Cmd + 1–9 jumps to a specific tab.
+   * @default true
+   */
   readonly useNumbers?: boolean;
   /**
-  * Whether the Tab key cycles through tabs (only when `isFocused` is not managed by Ink).
-  * @default true
-  */
+   * Whether the Tab key cycles through tabs (only when `isFocused` is not managed by Ink).
+   * @default true
+   */
   readonly useTab?: boolean;
 };
 /**
-* Color customization for active tab styling.
-*/
+ * Color customization for active tab styling.
+ */
 type TabColors = {
   readonly activeTab?: {
     readonly backgroundColor?: LiteralUnion<AnsiColors, string>;
@@ -38,70 +38,59 @@ type TabColors = {
 };
 type Props = {
   /**
-  * Tab elements to render.
-  */
+   * Tab elements to render.
+   */
   readonly children: ReactNode;
   /**
-  * Active tab colors. When `isFocused` is `false`, the active tab uses gray.
-  */
+   * Active tab colors. When `isFocused` is `false`, the active tab uses gray.
+   */
   readonly colors?: TabColors;
   /**
-  * Name of the tab to select initially (uncontrolled mode).
-  * Ignored when `value` is provided.
-  */
+   * Name of the tab to select initially (uncontrolled mode).
+   * Ignored when `value` is provided.
+   */
   readonly defaultValue?: string;
   /**
-  * Layout direction for the tab bar.
-  * @default "row"
-  */
+   * Layout direction for the tab bar.
+   * @default "row"
+   */
   readonly flexDirection?: "column" | "column-reverse" | "row" | "row-reverse";
   /**
-  * Whether the tabs are focused and respond to keyboard input.
-  * - `true`: focused, uses active colors.
-  * - `false`: unfocused, uses gray active color, ignores input.
-  * - `undefined`/`null`: always active (focus not managed by Ink).
-  * @default undefined
-  */
+   * Whether the tabs are focused and respond to keyboard input.
+   * - `true`: focused, uses active colors.
+   * - `false`: unfocused, uses gray active color, ignores input.
+   * - `undefined`/`null`: always active (focus not managed by Ink).
+   * @default undefined
+   */
   readonly isFocused?: boolean | null;
   /**
-  * Custom keyboard mappings.
-  */
+   * Custom keyboard mappings.
+   */
   readonly keyMap?: KeyMap;
   /**
-  * Called when the active tab changes.
-  */
+   * Called when the active tab changes.
+   */
   readonly onChange: (name: string, activeTab: ReactElement<Props$1>) => void;
   /**
-  * Whether to display 1-based index numbers before each tab name.
-  * @default true
-  */
+   * Whether to display 1-based index numbers before each tab name.
+   * @default true
+   */
   readonly showIndex?: boolean;
   /**
-  * Controlled active tab name. When provided, the component is controlled —
-  * the parent owns the active tab state and must update it via `onChange`.
-  * When omitted, the component manages its own state (uncontrolled mode).
-  */
+   * Controlled active tab name. When provided, the component is controlled —
+   * the parent owns the active tab state and must update it via `onChange`.
+   * When omitted, the component manages its own state (uncontrolled mode).
+   */
   readonly value?: string;
   /**
-  * Width of the container Box. Also determines the separator width in column layouts.
-  */
+   * Width of the container Box. Also determines the separator width in column layouts.
+   */
   readonly width?: number | string;
 };
 /**
-* Tabbed navigation component. Renders a row or column of tabs with keyboard
-* navigation (arrow keys, Tab, number keys) and calls `onChange` when the
-* active tab changes.
-*/
-declare function Tabs({
-  children,
-  colors: colorsProp,
-  defaultValue,
-  flexDirection,
-  isFocused,
-  keyMap: keyMapProp,
-  onChange,
-  showIndex,
-  value,
-  width
-}: Props): ReactElement;
+ * Tabbed navigation component. Renders a row or column of tabs with keyboard
+ * navigation (arrow keys, Tab, number keys) and calls `onChange` when the
+ * active tab changes.
+ */
+declare function Tabs({ children, colors: colorsProp, defaultValue, flexDirection, isFocused, keyMap: keyMapProp, onChange, showIndex, value, width }: Props): ReactElement;
 export { KeyMap, Props, TabColors, Tabs, type KeyMap as TabsKeyMap, type Props as TabsProps, Tabs as default };