@visulima/tui-kit 1.0.0 → 1.0.1

package/dist/operation-tree.d.ts

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

package/dist/option-list.d.ts

@@ -10,38 +10,32 @@ type OptionListEntry = {
 };
 type Props = {
   /**
-  * Highlight color for the row marked as current.
-  */
+   * Highlight color for the row marked as current.
+   */
   readonly accentColor?: LiteralUnion<AnsiColors, string>;
   /**
-  * Render the list with a border.
-  */
+   * Render the list with a border.
+   */
   readonly bordered?: boolean;
   /**
-  * Id of the row to highlight. No visual change if omitted.
-  */
+   * Id of the row to highlight. No visual change if omitted.
+   */
   readonly currentId?: string;
   /**
-  * Icon width in characters for column alignment.
-  * @default 2
-  */
+   * Icon width in characters for column alignment.
+   * @default 2
+   */
   readonly iconColumnWidth?: number;
   /**
-  * Entries to render.
-  */
+   * 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.
-* @returns A `ReactElement` rendering the list; bordered when requested.
-*/
-declare function OptionList({
-  accentColor,
-  bordered,
-  currentId,
-  iconColumnWidth,
-  options
-}: Props): ReactElement;
+ * 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.
+ * @returns A `ReactElement` rendering the list; bordered when requested.
+ */
+declare function OptionList({ accentColor, bordered, currentId, iconColumnWidth, options }: Props): ReactElement;
 export { OptionList, OptionListEntry, type Props as OptionListProps, Props, OptionList as default };

package/dist/ordered-list.d.ts

@@ -1,24 +1,22 @@
 import { ReactNode, ReactElement } from 'react';
 type OrderedListEntry = {
   /**
-  * Nested sub-items, rendered as a sub-list with hierarchical numbering.
-  */
+   * Nested sub-items, rendered as a sub-list with hierarchical numbering.
+   */
   readonly children?: ReadonlyArray<OrderedListEntry>;
   /**
-  * Display text for this item.
-  */
+   * Display text for this item.
+   */
   readonly label: ReactNode;
 };
 type Props = {
   /**
-  * Entries to render as a numbered list.
-  */
+   * Entries to render as a numbered list.
+   */
   readonly items: ReadonlyArray<OrderedListEntry>;
 };
 /**
-* Renders a numbered list with hierarchical nesting support.
-*/
-declare function OrderedList({
-  items
-}: Props): ReactElement;
+ * Renders a numbered list with hierarchical nesting support.
+ */
+declare function OrderedList({ items }: Props): ReactElement;
 export { OrderedList, OrderedListEntry, type Props as OrderedListProps, Props, OrderedList as default };

package/dist/packem_shared/{controlled-scroll-view.d-vF4wevEJ.d.ts → controlled-scroll-view.d-D3kZZzjI.d.ts}

@@ -13,16 +13,16 @@ interface ControlledScrollViewProps extends Props {
     width: number;
   }) => void;
   /**
-  * Number of extra items to render above/below the viewport when virtualized.
-  * @default 3
-  */
+   * 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
-  */
+   * Only render items visible in the viewport plus overscan.
+   * Items must be measured first (first render always renders all items).
+   * @default false
+   */
   virtualize?: boolean;
 }
 interface ControlledScrollViewRef {
@@ -37,18 +37,7 @@ interface ControlledScrollViewRef {
   remeasure: () => void;
   remeasureItem: (index: number) => void;
 }
-declare const ControlledScrollView: ({
-  children,
-  debug,
-  onContentHeightChange,
-  onItemHeightChange,
-  onViewportSizeChange,
-  overscan,
-  ref,
-  scrollOffset,
-  virtualize,
-  ...boxProps
-}: ControlledScrollViewProps & {
+declare const ControlledScrollView: ({ children, debug, onContentHeightChange, onItemHeightChange, onViewportSizeChange, overscan, ref, scrollOffset, virtualize, ...boxProps }: ControlledScrollViewProps & {
   ref?: Ref<ControlledScrollViewRef>;
 }) => React.JSX.Element;
 export { ControlledScrollView as C, ControlledScrollViewProps as a, ControlledScrollViewRef as b };

package/dist/packem_shared/file-picker.d-CH7pccC7.d.ts

@@ -0,0 +1,92 @@
+import { ReactElement } from 'react';
+/**
+ * A single entry (file or directory) returned by the file system hook.
+ */
+type FileEntry = {
+  readonly isDirectory: boolean;
+  readonly isHidden: boolean;
+  readonly name: string;
+  readonly path: string;
+  readonly permissions: string;
+  readonly size: number;
+};
+/**
+ * Filter options for the file picker.
+ */
+type FilePickerFilter = {
+  /**
+   * Allowed file extensions (e.g. `[".ts", ".tsx"]`). Empty or omitted means all.
+   */
+  readonly extensions?: ReadonlyArray<string>;
+  /**
+   * Whether to include directories in the list.
+   * @default true
+   */
+  readonly showDirectories?: boolean;
+  /**
+   * Whether to include regular files in the list.
+   * @default true
+   */
+  readonly showFiles?: boolean;
+  /**
+   * Whether to include hidden files (names starting with `.`).
+   * @default false
+   */
+  readonly showHidden?: boolean;
+};
+type Props = {
+  /**
+   * Color for the focused item highlight.
+   * @default "cyan"
+   */
+  readonly accentColor?: string;
+  /**
+   * Color for directory entries.
+   * @default "blue"
+   */
+  readonly directoryColor?: string;
+  /**
+   * Color for file entries.
+   * @default "white"
+   */
+  readonly fileColor?: string;
+  /**
+   * File filter options.
+   */
+  readonly filter?: FilePickerFilter;
+  /**
+   * Starting directory path.
+   * @default process.cwd()
+   */
+  readonly initialPath?: string;
+  /**
+   * Whether keyboard navigation is active.
+   * @default true
+   */
+  readonly isFocused?: boolean;
+  /**
+   * Maximum number of visible items (viewport height).
+   * @default 10
+   */
+  readonly limit?: number;
+  /**
+   * Called when escape is pressed.
+   */
+  readonly onCancel?: () => void;
+  /**
+   * Called when a file is selected (enter on a file entry).
+   */
+  readonly onSelect?: (entry: FileEntry) => void;
+  /**
+   * Show file permissions column.
+   * @default false
+   */
+  readonly showPermissions?: boolean;
+  /**
+   * Show file size column.
+   * @default false
+   */
+  readonly showSize?: boolean;
+};
+declare const FilePicker: ({ accentColor, directoryColor, fileColor, filter, initialPath, isFocused, limit, onCancel, onSelect, showPermissions, showSize }: Props) => ReactElement;
+export { FileEntry as F, Props as P, FilePicker as a, FilePickerFilter as b };

package/dist/packem_shared/{scroll-bar-box.d-DSBbBsRc.d.ts → scroll-bar-box.d-CpTYEcTZ.d.ts}

@@ -9,22 +9,5 @@ interface ScrollBarBoxProps extends Props {
   thumbChar?: string;
   viewportHeight: number;
 }
-declare const ScrollBarBox: ({
-  borderColor,
-  borderDimColor,
-  borderLeftColor,
-  borderLeftDimColor,
-  borderRightColor,
-  borderRightDimColor,
-  borderStyle,
-  children,
-  contentHeight,
-  height,
-  scrollBarAutoHide,
-  scrollBarPosition,
-  scrollOffset,
-  thumbChar,
-  viewportHeight,
-  ...boxProps
-}: ScrollBarBoxProps) => React.JSX.Element;
+declare const ScrollBarBox: ({ borderColor, borderDimColor, borderLeftColor, borderLeftDimColor, borderRightColor, borderRightDimColor, borderStyle, children, contentHeight, height, scrollBarAutoHide, scrollBarPosition, scrollOffset, thumbChar, viewportHeight, ...boxProps }: ScrollBarBoxProps) => React.JSX.Element;
 export { ScrollBarBox as S, ScrollBarBoxProps as a };

package/dist/packem_shared/{scroll-list.d-BP0UZSY4.d.ts → scroll-list.d-CPCF0RwC.d.ts}

@@ -1,5 +1,5 @@
 import React, { Ref } from 'react';
-import { a as ScrollViewProps, b as ScrollViewRef } from "./scroll-view.d-BqKpI-F-.js";
+import { a as ScrollViewProps, b as ScrollViewRef } from "./scroll-view.d-GZcgAHl4.js";
 type ScrollAlignment = "auto" | "bottom" | "center" | "top";
 interface ScrollListProps extends ScrollViewProps {
   readonly scrollAlignment?: ScrollAlignment;

package/dist/packem_shared/scroll-view.d-GZcgAHl4.d.ts

@@ -0,0 +1,98 @@
+import { Props } from '@visulima/tui/components/box';
+import React, { ReactNode, Ref } from 'react';
+interface ScrollViewProps extends Props {
+  children?: ReactNode;
+  debug?: boolean;
+  /**
+   * Auto-scroll to bottom when content grows and user is at/near the bottom.
+   * Pauses when user scrolls away from bottom; resumes when they return.
+   * @default false
+   */
+  followOutput?: boolean;
+  /**
+   * Number of lines from bottom that still counts as "at bottom" for followOutput.
+   * @default 3
+   */
+  followThreshold?: number;
+  /**
+   * Enable built-in keyboard navigation (arrows, page up/down, home/end, ctrl+u/d).
+   * When enabled, the component becomes focusable.
+   * @default false
+   */
+  keyboard?: boolean;
+  onContentHeightChange?: (height: number, previousHeight: number) => void;
+  onItemHeightChange?: (index: number, height: number, previousHeight: number) => void;
+  /**
+   * Fires when scrolled within `reachThreshold` lines of the end.
+   * Only fires once per entry into the threshold zone.
+   */
+  onReachEnd?: () => void;
+  /**
+   * Fires when scrolled within `reachThreshold` lines of the start.
+   * Only fires once per entry into the threshold zone.
+   */
+  onReachStart?: () => void;
+  onScroll?: (scrollOffset: 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;
+  /**
+   * Distance in lines from the edge to trigger onReachEnd/onReachStart.
+   * @default 5
+   */
+  reachThreshold?: number;
+  /**
+   * Show a scrollbar track when content overflows the viewport.
+   * @default false
+   */
+  scrollbar?: boolean;
+  /**
+   * Color of the scrollbar thumb and track.
+   */
+  scrollbarColor?: string;
+  /**
+   * Scrollbar visual style.
+   * @default "line"
+   */
+  scrollbarStyle?: "arrow" | "block" | "bold" | "classic" | "dots" | "double" | "doubleSingle" | "line" | "round" | "single" | "singleDouble" | "thick";
+  /**
+   * Enable vim-style keybindings (j/k/g/G/u/d). Requires `keyboard` to be true.
+   * @default false
+   */
+  vimBindings?: boolean;
+  /**
+   * Only render items visible in the viewport plus overscan. Requires items to be measured first.
+   * @default false
+   */
+  virtualize?: boolean;
+}
+interface ScrollViewRef {
+  getBottomOffset: () => number;
+  getContentHeight: () => number;
+  getItemHeight: (index: number) => number;
+  getItemPosition: (index: number) => {
+    height: number;
+    top: number;
+  } | null;
+  getScrollOffset: () => number;
+  getViewportHeight: () => number;
+  remeasure: () => void;
+  remeasureItem: (index: number) => void;
+  scrollBy: (delta: number) => void;
+  scrollTo: (offset: number) => void;
+  scrollToBottom: () => void;
+  scrollToTop: () => void;
+}
+declare const ScrollView: ({ children, debug, followOutput, followThreshold, keyboard, onContentHeightChange, onItemHeightChange, onReachEnd, onReachStart, onScroll, onViewportSizeChange, overscan, reachThreshold, ref, scrollbar, scrollbarColor, scrollbarStyle: scrollbarStyleProp, vimBindings, virtualize, ...boxProps }: ScrollViewProps & {
+  ref?: Ref<ScrollViewRef>;
+}) => React.JSX.Element;
+export { ScrollView as S, ScrollViewProps as a, ScrollViewRef as b };