@visulima/tui-kit 1.0.0 → 1.0.1

package/dist/packem_shared/{use-tree-view.d-dXTKoDPM.d.ts → use-tree-view.d-DeMQ6G2r.d.ts}

@@ -14,25 +14,18 @@ declare const theme: {
     container: () => Props$1;
     expandIndicator: (_props: StyleFunctionProps) => Props$2;
     focusIndicator: () => Props$2;
-    indent: ({
-      depth
-    }: StyleFunctionProps) => Props$1;
-    label: ({
-      isFocused,
-      isSelected
-    }: StyleFunctionProps) => Props$2;
+    indent: ({ depth }: StyleFunctionProps) => Props$1;
+    label: ({ isFocused, isSelected }: StyleFunctionProps) => Props$2;
     loadingIndicator: () => Props$2;
-    node: ({
-      isFocused
-    }: StyleFunctionProps) => Props$1;
+    node: ({ isFocused }: StyleFunctionProps) => Props$1;
     selectedIndicator: () => Props$2;
   };
 };
 type Theme = typeof theme;
 /**
-* A single node in the tree. Generic over the user's data shape.
-* The `id` field MUST be unique across the entire tree.
-*/
+ * A single node in the tree. Generic over the user's data shape.
+ * The `id` field MUST be unique across the entire tree.
+ */
 type TreeNode<T = Record<string, unknown>> = {
   /** Child nodes. Undefined or empty array means leaf node. */
   readonly children?: TreeNode<T>[];
@@ -41,22 +34,22 @@ type TreeNode<T = Record<string, unknown>> = {
   /** Unique identifier for this node. Used as the key for all lookups. */
   readonly id: string;
   /**
-  * Explicitly marks this node as a parent that can have children loaded
-  * asynchronously via `loadChildren`. When true, the node shows an expand
-  * indicator even if `children` is empty or undefined, and expanding it
-  * triggers the `loadChildren` callback.
-  */
+   * Explicitly marks this node as a parent that can have children loaded
+   * asynchronously via `loadChildren`. When true, the node shows an expand
+   * indicator even if `children` is empty or undefined, and expanding it
+   * triggers the `loadChildren` callback.
+   */
   readonly isParent?: boolean;
   /** Display label. Used by the default renderer. */
   readonly label: string;
 };
 /**
-* For async/lazy loading: a function that resolves children on demand.
-*/
+ * For async/lazy loading: a function that resolves children on demand.
+ */
 type AsyncChildrenFunction<T = Record<string, unknown>> = (node: TreeNode<T>) => Promise<TreeNode<T>[]>;
 /**
-* State passed to custom renderers and theme functions.
-*/
+ * State passed to custom renderers and theme functions.
+ */
 type TreeNodeState = {
   /** Depth of this node in the tree (root = 0). */
   readonly depth: number;
@@ -72,8 +65,8 @@ type TreeNodeState = {
   readonly isSelected: boolean;
 };
 /**
-* Props received by a custom node renderer.
-*/
+ * Props received by a custom node renderer.
+ */
 type TreeNodeRendererProps<T = Record<string, unknown>> = {
   /** The tree node data. */
   readonly node: TreeNode<T>;
@@ -81,12 +74,12 @@ type TreeNodeRendererProps<T = Record<string, unknown>> = {
   readonly state: TreeNodeState;
 };
 /**
-* Selection mode for the tree view.
-*/
+ * Selection mode for the tree view.
+ */
 type SelectionMode = "multiple" | "none" | "single";
 /**
-* A flattened representation of a tree node with navigation links.
-*/
+ * A flattened representation of a tree node with navigation links.
+ */
 type FlatNode<T = Record<string, unknown>> = {
   /** Ordered list of direct children IDs. */
   readonly childrenIds: ReadonlyArray<string>;
@@ -110,9 +103,9 @@ type FlatNode<T = Record<string, unknown>> = {
   readonly siblingIndex: number;
 };
 /**
-* A flattened map of all tree nodes built via DFS traversal.
-* Stores parent/child/sibling links for O(1) navigation.
-*/
+ * A flattened map of all tree nodes built via DFS traversal.
+ * Stores parent/child/sibling links for O(1) navigation.
+ */
 declare class TreeNodeMap<T = Record<string, unknown>> {
   /** All node IDs in DFS order. */
   readonly orderedIds: string[];
@@ -122,140 +115,126 @@ declare class TreeNodeMap<T = Record<string, unknown>> {
   private readonly map;
   constructor(data: TreeNode<T>[]);
   /**
-  * Iterate over all entries.
-  */
+   * Iterate over all entries.
+   */
   entries(): IterableIterator<[string, FlatNode<T>]>;
   /**
-  * Get a flat node by ID.
-  */
+   * Get a flat node by ID.
+   */
   get(id: string): FlatNode<T> | undefined;
   /**
-  * Total number of nodes in the tree.
-  */
+   * Total number of nodes in the tree.
+   */
   get size(): number;
   /**
-  * Given a set of expanded node IDs, return the ordered list of
-  * VISIBLE node IDs (i.e., a node is visible if all its ancestors
-  * are expanded).
-  *
-  * Uses iterative DFS, skipping collapsed subtrees.
-  */
+   * Given a set of expanded node IDs, return the ordered list of
+   * VISIBLE node IDs (i.e., a node is visible if all its ancestors
+   * are expanded).
+   *
+   * Uses iterative DFS, skipping collapsed subtrees.
+   */
   getVisibleIds(expandedIds: ReadonlySet<string>): string[];
   /**
-  * Check if a node is a descendant of another node.
-  */
+   * Check if a node is a descendant of another node.
+   */
   isDescendantOf(nodeId: string, ancestorId: string): boolean;
   /**
-  * Insert dynamically-loaded children under a parent node.
-  * Returns a new TreeNodeMap (immutable operation).
-  *
-  * Rebuilds the full tree from the current map state (not the original
-  * input data), so successive calls for different parents are safe.
-  */
+   * Insert dynamically-loaded children under a parent node.
+   * Returns a new TreeNodeMap (immutable operation).
+   *
+   * Rebuilds the full tree from the current map state (not the original
+   * input data), so successive calls for different parents are safe.
+   */
   withChildren(parentId: string, children: TreeNode<T>[]): TreeNodeMap<T>;
   private buildFromData;
 }
 type Props<T = Record<string, unknown>> = {
   /**
-  * Accessible label for the tree container.
-  * Useful when multiple tree views are on screen.
-  * @default "Tree view"
-  */
+   * Accessible label for the tree container.
+   * Useful when multiple tree views are on screen.
+   * @default "Tree view"
+   */
   readonly ariaLabel?: string;
   /**
-  * The tree data. Array of root-level nodes.
-  *
-  * **Important:** Must be referentially stable across renders (e.g. stored
-  * in state or wrapped in `useMemo`). Passing a new array reference on
-  * every render will reset focus, expansion, and selection state.
-  */
+   * The tree data. Array of root-level nodes.
+   *
+   * **Important:** Must be referentially stable across renders (e.g. stored
+   * in state or wrapped in `useMemo`). Passing a new array reference on
+   * every render will reset focus, expansion, and selection state.
+   */
   readonly data: TreeNode<T>[];
   /**
-  * Set of node IDs that are expanded by default.
-  * If not provided, all nodes start collapsed.
-  */
+   * Set of node IDs that are expanded by default.
+   * If not provided, all nodes start collapsed.
+   */
   readonly defaultExpanded?: ReadonlySet<string> | "all";
   /**
-  * Set of node IDs that are selected by default.
-  */
+   * Set of node IDs that are selected by default.
+   */
   readonly defaultSelected?: ReadonlySet<string>;
   /**
-  * When disabled, user input is ignored.
-  * @default false
-  */
+   * When disabled, user input is ignored.
+   * @default false
+   */
   readonly isDisabled?: boolean;
   /**
-  * Async function to load children on demand.
-  */
+   * Async function to load children on demand.
+   */
   readonly loadChildren?: AsyncChildrenFunction<T>;
   /** Called when expanded set changes. */
   readonly onExpandChange?: (expandedIds: ReadonlySet<string>) => void;
   /** Called when the focused node changes. */
   readonly onFocusChange?: (nodeId: string) => void;
   /**
-  * Called when `loadChildren` rejects. Receives the node ID and error.
-  */
+   * Called when `loadChildren` rejects. Receives the node ID and error.
+   */
   readonly onLoadError?: (nodeId: string, error: Error) => void;
   /** Called when selection changes. */
   readonly onSelectChange?: (selectedIds: ReadonlySet<string>) => void;
   /**
-  * Custom node renderer. Receives node + state, returns Ink JSX.
-  */
+   * Custom node renderer. Receives node + state, returns Ink JSX.
+   */
   readonly renderNode?: (props: TreeNodeRendererProps<T>) => ReactNode;
   /**
-  * Selection mode.
-  * - "none": No selection behavior (default).
-  * - "single": One node can be selected at a time.
-  * - "multiple": Multiple nodes can be selected (checkboxes shown).
-  * @default "none"
-  */
+   * Selection mode.
+   * - "none": No selection behavior (default).
+   * - "single": One node can be selected at a time.
+   * - "multiple": Multiple nodes can be selected (checkboxes shown).
+   * @default "none"
+   */
   readonly selectionMode?: SelectionMode;
   /**
-  * Number of visible nodes in the viewport (for virtualization).
-  * @default Infinity (no virtualization)
-  */
+   * Number of visible nodes in the viewport (for virtualization).
+   * @default Infinity (no virtualization)
+   */
   readonly visibleNodeCount?: number;
 };
 /**
-* Renders an interactive tree view with keyboard navigation.
-*
-* ```tsx
-* &lt;TreeView
-*   data={[
-*     { id: "1", label: "Root", children: [
-*       { id: "1.1", label: "Child" },
-*     ]},
-*   ]}
-*   defaultExpanded="all"
-* />
-* ```
-*/
-declare function TreeView<T = Record<string, unknown>>({
-  ariaLabel,
-  data,
-  defaultExpanded,
-  defaultSelected,
-  isDisabled,
-  loadChildren,
-  onExpandChange,
-  onFocusChange,
-  onLoadError,
-  onSelectChange,
-  renderNode,
-  selectionMode,
-  visibleNodeCount
-}: Props<T>): ReactElement;
+ * Renders an interactive tree view with keyboard navigation.
+ *
+ * ```tsx
+ * &lt;TreeView
+ *   data={[
+ *     { id: "1", label: "Root", children: [
+ *       { id: "1.1", label: "Child" },
+ *     ]},
+ *   ]}
+ *   defaultExpanded="all"
+ * />
+ * ```
+ */
+declare function TreeView<T = Record<string, unknown>>({ ariaLabel, data, defaultExpanded, defaultSelected, isDisabled, loadChildren, onExpandChange, onFocusChange, onLoadError, onSelectChange, renderNode, selectionMode, visibleNodeCount }: Props<T>): ReactElement;
 type UseTreeViewStateProps<T = Record<string, unknown>> = {
   /** The tree data. Array of root-level nodes. */
   readonly data: TreeNode<T>[];
   /**
-  * Set of node IDs that are expanded by default.
-  * If not provided, all nodes start collapsed.
-  */
+   * Set of node IDs that are expanded by default.
+   * If not provided, all nodes start collapsed.
+   */
   readonly defaultExpanded?: ReadonlySet<string> | "all";
   /**
-  * Set of node IDs that are selected by default.
-  */
+   * Set of node IDs that are selected by default.
+   */
   readonly defaultSelected?: ReadonlySet<string>;
   /** Called when expanded set changes. */
   readonly onExpandChange?: (expandedIds: ReadonlySet<string>) => void;
@@ -264,14 +243,14 @@ type UseTreeViewStateProps<T = Record<string, unknown>> = {
   /** Called when selection changes. */
   readonly onSelectChange?: (selectedIds: ReadonlySet<string>) => void;
   /**
-  * Selection mode.
-  * @default "none"
-  */
+   * Selection mode.
+   * @default "none"
+   */
   readonly selectionMode?: SelectionMode;
   /**
-  * Number of visible nodes in the viewport (for virtualization).
-  * @default Infinity
-  */
+   * Number of visible nodes in the viewport (for virtualization).
+   * @default Infinity
+   */
   readonly visibleNodeCount?: number;
 };
 type TreeViewState<T = Record<string, unknown>> = {
@@ -307,44 +286,29 @@ type TreeViewState<T = Record<string, unknown>> = {
   readonly viewportToIndex: number;
   readonly visibleCount: number;
 };
-declare function useTreeViewState<T = Record<string, unknown>>({
-  data,
-  defaultExpanded,
-  defaultSelected,
-  onExpandChange,
-  onFocusChange,
-  onSelectChange,
-  selectionMode,
-  visibleNodeCount
-}: UseTreeViewStateProps<T>): TreeViewState<T>;
+declare function useTreeViewState<T = Record<string, unknown>>({ data, defaultExpanded, defaultSelected, onExpandChange, onFocusChange, onSelectChange, selectionMode, visibleNodeCount }: UseTreeViewStateProps<T>): TreeViewState<T>;
 type UseTreeViewProps<T = Record<string, unknown>> = {
   /**
-  * When disabled, user input is ignored.
-  * @default false
-  */
+   * When disabled, user input is ignored.
+   * @default false
+   */
   readonly isDisabled?: boolean;
   /**
-  * Async function to load children on demand.
-  */
+   * Async function to load children on demand.
+   */
   readonly loadChildren?: AsyncChildrenFunction<T>;
   /**
-  * Called when `loadChildren` rejects.
-  */
+   * Called when `loadChildren` rejects.
+   */
   readonly onLoadError?: (nodeId: string, error: Error) => void;
   /**
-  * Selection mode.
-  */
+   * Selection mode.
+   */
   readonly selectionMode: SelectionMode;
   /**
-  * The tree view state from `useTreeViewState`.
-  */
+   * The tree view state from `useTreeViewState`.
+   */
   readonly state: TreeViewState<T>;
 };
-declare function useTreeView<T>({
-  isDisabled,
-  loadChildren,
-  onLoadError,
-  selectionMode,
-  state
-}: UseTreeViewProps<T>): void;
+declare function useTreeView<T>({ isDisabled, loadChildren, onLoadError, selectionMode, state }: UseTreeViewProps<T>): void;
 export { AsyncChildrenFunction as A, FlatNode as F, Props as P, SelectionMode as S, TreeNode as T, UseTreeViewProps as U, TreeNodeMap as a, TreeNodeRendererProps as b, TreeNodeState as c, TreeView as d, TreeViewState as e, Theme as f, UseTreeViewStateProps as g, useTreeViewState as h, theme as t, useTreeView as u };

package/dist/paginator.d.ts

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

package/dist/paragraph.d.ts

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

package/dist/path-input.d.ts

@@ -3,65 +3,54 @@ import { ReactElement } from 'react';
 import { LiteralUnion } from 'type-fest';
 type Props = {
   /**
-  * Accent color for the focused border and caret.
-  * @default "blue"
-  */
+   * Accent color for the focused border and caret.
+   * @default "blue"
+   */
   readonly accentColor?: LiteralUnion<AnsiColors, string>;
   /**
-  * Auto-focus on mount.
-  */
+   * Auto-focus on mount.
+   */
   readonly autoFocus?: boolean;
   /**
-  * Initial path when uncontrolled.
-  */
+   * Initial path when uncontrolled.
+   */
   readonly defaultValue?: string;
   /**
-  * Override how completions are produced (e.g. to sandbox or mock the
-  * filesystem). Defaults to reading the real filesystem.
-  */
+   * Override how completions are produced (e.g. to sandbox or mock the
+   * filesystem). Defaults to reading the real filesystem.
+   */
   readonly getCompletions?: (input: string) => ReadonlyArray<string>;
   /**
-  * Disable input and dim the display.
-  */
+   * Disable input and dim the display.
+   */
   readonly isDisabled?: boolean;
   /**
-  * Fires whenever the path text changes.
-  */
+   * Fires whenever the path text changes.
+   */
   readonly onChange?: (path: string) => void;
   /**
-  * Fires on Enter with the current path.
-  */
+   * Fires on Enter with the current path.
+   */
   readonly onSubmit?: (path: string) => void;
   /**
-  * Placeholder shown when empty.
-  * @default "Enter a path…"
-  */
+   * Placeholder shown when empty.
+   * @default "Enter a path…"
+   */
   readonly placeholder?: string;
   /**
-  * Show the first few completion candidates beneath the field.
-  * @default true
-  */
+   * Show the first few completion candidates beneath the field.
+   * @default true
+   */
   readonly showSuggestions?: boolean;
   /**
-  * Controlled path. When provided, `defaultValue` is ignored.
-  */
+   * Controlled path. When provided, `defaultValue` is ignored.
+   */
   readonly value?: string;
 };
 /**
-* A text input specialised for filesystem paths. Tab completes against the
-* directory being typed (cycling through matches on repeated presses), and a
-* short list of candidates is shown below the field.
-*/
-declare function PathInput({
-  accentColor,
-  autoFocus,
-  defaultValue,
-  getCompletions,
-  isDisabled,
-  onChange,
-  onSubmit,
-  placeholder,
-  showSuggestions,
-  value: controlledValue
-}: Props): ReactElement;
+ * A text input specialised for filesystem paths. Tab completes against the
+ * directory being typed (cycling through matches on repeated presses), and a
+ * short list of candidates is shown below the field.
+ */
+declare function PathInput({ accentColor, autoFocus, defaultValue, getCompletions, isDisabled, onChange, onSubmit, placeholder, showSuggestions, value: controlledValue }: Props): ReactElement;
 export { PathInput, type Props as PathInputProps, Props, PathInput as default };