@visulima/tui-kit 1.0.3 → 1.0.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +15 -0
- package/dist/accordion.js +1 -1
- package/dist/alert.js +1 -1
- package/dist/animate-presence.js +1 -1
- package/dist/approval-prompt.js +1 -1
- package/dist/area-chart.js +1 -1
- package/dist/badge.js +1 -1
- package/dist/bar-chart.js +1 -1
- package/dist/big-text.js +1 -1
- package/dist/blink-dot.js +1 -1
- package/dist/breadcrumb.js +1 -1
- package/dist/button.js +1 -1
- package/dist/calendar.js +1 -1
- package/dist/card.js +1 -1
- package/dist/checkbox-group.js +1 -1
- package/dist/checkbox.js +1 -1
- package/dist/code.js +2 -2
- package/dist/collapsible.js +1 -1
- package/dist/color-picker.js +1 -1
- package/dist/command-block.js +4 -4
- package/dist/command-palette.js +1 -1
- package/dist/confirm-dialog.js +1 -1
- package/dist/confirm-input.js +1 -1
- package/dist/console-overlay.js +1 -1
- package/dist/content-switcher.js +1 -1
- package/dist/controlled-scroll-view.d.ts +43 -3
- package/dist/controlled-scroll-view.js +1 -1
- package/dist/data-grid.js +1 -1
- package/dist/date-picker.js +1 -1
- package/dist/definition-list.js +1 -1
- package/dist/dialog.d.ts +1 -1
- package/dist/dialog.js +1 -1
- package/dist/diff-view.js +1 -1
- package/dist/digits.js +1 -1
- package/dist/directory-tree.js +1 -1
- package/dist/divider.js +1 -1
- package/dist/drawer.js +1 -1
- package/dist/file-change.js +1 -1
- package/dist/file-picker-entry.d.ts +92 -2
- package/dist/file-picker-entry.js +1 -1
- package/dist/form.js +1 -1
- package/dist/gauge.js +1 -1
- package/dist/gradient.js +1 -1
- package/dist/grid.js +1 -1
- package/dist/heading.js +1 -1
- package/dist/heatmap.js +1 -1
- package/dist/help.js +1 -1
- package/dist/histogram.js +1 -1
- package/dist/image.js +1 -1
- package/dist/index.d.ts +25 -9
- package/dist/index.js +1 -1
- package/dist/json.js +1 -1
- package/dist/kbd.js +1 -1
- package/dist/line-chart.js +1 -1
- package/dist/link.js +1 -1
- package/dist/loading-indicator.js +1 -1
- package/dist/log.js +1 -1
- package/dist/markdown.js +1 -1
- package/dist/masked-input.js +1 -1
- package/dist/menu.js +1 -1
- package/dist/message-bubble.js +1 -1
- package/dist/model-badge.js +1 -1
- package/dist/model-selector.js +1 -1
- package/dist/multi-progress.js +1 -1
- package/dist/multi-select.js +1 -1
- package/dist/notification-badge.js +1 -1
- package/dist/number-input.js +1 -1
- package/dist/operation-tree.js +1 -1
- package/dist/option-list.js +1 -1
- package/dist/ordered-list.js +1 -1
- package/dist/packem_shared/ControlledScrollView-soZtm3m7.js +1 -0
- package/dist/packem_shared/FilePicker-KGAg6v5x.js +1 -0
- package/dist/packem_shared/ScrollBar-arHRP6OT.js +1 -0
- package/dist/packem_shared/ScrollBarBox-C8wZ_Slk.js +1 -0
- package/dist/packem_shared/ScrollList-BCqHHps6.js +1 -0
- package/dist/packem_shared/ScrollView-Dt5E9Yl7.js +1 -0
- package/dist/packem_shared/TreeNodeMap-BK7nRlt0.js +1 -0
- package/dist/packem_shared/TreeView-BEZAFOfr.js +1 -0
- package/dist/packem_shared/controlled-scroll-view-BHCYjiKa.js +1 -0
- package/dist/packem_shared/line-chart-BqOUjZTt.js +1 -0
- package/dist/packem_shared/treeViewTheme-DuCcyBDe.js +1 -0
- package/dist/packem_shared/useTreeView-Dt_iWxVs.js +1 -0
- package/dist/packem_shared/useTreeViewState-aHwNZhIE.js +1 -0
- package/dist/packem_shared/{variant-config-BJqpNo7H.js → variant-config-BnAmf1rP.js} +1 -1
- package/dist/paginator.js +1 -1
- package/dist/paragraph.js +1 -1
- package/dist/path-input.js +1 -1
- package/dist/pie-chart.js +1 -1
- package/dist/placeholder.js +1 -1
- package/dist/popover.js +1 -1
- package/dist/progress-bar.js +1 -1
- package/dist/progress-circle.js +1 -1
- package/dist/qr-code.js +1 -1
- package/dist/radio-group.js +1 -1
- package/dist/scatter-plot.js +1 -1
- package/dist/scroll-bar-box.d.ts +13 -3
- package/dist/scroll-bar-box.js +1 -1
- package/dist/scroll-bar.d.ts +18 -3
- package/dist/scroll-bar.js +1 -1
- package/dist/scroll-list.d.ts +12 -3
- package/dist/scroll-list.js +1 -1
- package/dist/scroll-view.d.ts +98 -3
- package/dist/scroll-view.js +1 -1
- package/dist/search-input.js +1 -1
- package/dist/select-input-indicator.js +1 -1
- package/dist/select-input-item.js +1 -1
- package/dist/select-input.js +1 -1
- package/dist/shimmer-text.js +1 -1
- package/dist/sidebar.js +1 -1
- package/dist/slider.js +1 -1
- package/dist/sparkline.js +1 -1
- package/dist/spinner.js +1 -1
- package/dist/status-line.js +1 -1
- package/dist/status-message.js +1 -1
- package/dist/stepper.js +1 -1
- package/dist/stopwatch.js +1 -1
- package/dist/streaming-text.js +1 -1
- package/dist/switch.js +1 -1
- package/dist/tab.js +1 -1
- package/dist/table.js +1 -1
- package/dist/tabs.js +1 -1
- package/dist/tag-input.js +1 -1
- package/dist/tag.js +1 -1
- package/dist/text-input.js +1 -1
- package/dist/textarea.js +2 -2
- package/dist/thinking-block.js +1 -1
- package/dist/time-picker.js +1 -1
- package/dist/timer.js +1 -1
- package/dist/toast.js +1 -1
- package/dist/token-usage.js +1 -1
- package/dist/tool-call.js +1 -1
- package/dist/tooltip.js +1 -1
- package/dist/transition.js +1 -1
- package/dist/tree-select.js +1 -1
- package/dist/tree-view-entry.d.ts +314 -4
- package/dist/tree-view-entry.js +1 -1
- package/dist/unordered-list.js +1 -1
- package/dist/use-linked-scroll.d.ts +1 -1
- package/dist/use-linked-scroll.js +1 -1
- package/package.json +8 -8
- package/dist/packem_shared/ControlledScrollView-BzlbIUph.js +0 -1
- package/dist/packem_shared/FilePicker-V5H2fb-v.js +0 -1
- package/dist/packem_shared/ScrollBar-C9i3z3Ft.js +0 -1
- package/dist/packem_shared/ScrollBarBox-DZEC8YnV.js +0 -1
- package/dist/packem_shared/ScrollList-Djtb2vVy.js +0 -1
- package/dist/packem_shared/ScrollView-ESxpl6Hy.js +0 -1
- package/dist/packem_shared/TreeNodeMap-cJlYqckB.js +0 -1
- package/dist/packem_shared/TreeView-q0l446NV.js +0 -1
- package/dist/packem_shared/controlled-scroll-view-DerVKKv6.js +0 -1
- package/dist/packem_shared/controlled-scroll-view.d-D3kZZzjI.d.ts +0 -43
- package/dist/packem_shared/file-picker.d-CH7pccC7.d.ts +0 -92
- package/dist/packem_shared/line-chart-BbhMhcZg.js +0 -1
- package/dist/packem_shared/scroll-bar-box.d-CpTYEcTZ.d.ts +0 -13
- package/dist/packem_shared/scroll-bar.d-B4sD1hBR.d.ts +0 -18
- package/dist/packem_shared/scroll-list.d-CPCF0RwC.d.ts +0 -12
- package/dist/packem_shared/scroll-view.d-GZcgAHl4.d.ts +0 -98
- package/dist/packem_shared/treeViewTheme-Dq3ekRAC.js +0 -1
- package/dist/packem_shared/use-tree-view.d-DeMQ6G2r.d.ts +0 -314
- package/dist/packem_shared/useTreeView-D0JEqT6W.js +0 -1
- package/dist/packem_shared/useTreeViewState-BiTJakkh.js +0 -1
|
@@ -1,98 +0,0 @@
|
|
|
1
|
-
import { Props } from '@visulima/tui/components/box';
|
|
2
|
-
import React, { ReactNode, Ref } from 'react';
|
|
3
|
-
interface ScrollViewProps extends Props {
|
|
4
|
-
children?: ReactNode;
|
|
5
|
-
debug?: boolean;
|
|
6
|
-
/**
|
|
7
|
-
* Auto-scroll to bottom when content grows and user is at/near the bottom.
|
|
8
|
-
* Pauses when user scrolls away from bottom; resumes when they return.
|
|
9
|
-
* @default false
|
|
10
|
-
*/
|
|
11
|
-
followOutput?: boolean;
|
|
12
|
-
/**
|
|
13
|
-
* Number of lines from bottom that still counts as "at bottom" for followOutput.
|
|
14
|
-
* @default 3
|
|
15
|
-
*/
|
|
16
|
-
followThreshold?: number;
|
|
17
|
-
/**
|
|
18
|
-
* Enable built-in keyboard navigation (arrows, page up/down, home/end, ctrl+u/d).
|
|
19
|
-
* When enabled, the component becomes focusable.
|
|
20
|
-
* @default false
|
|
21
|
-
*/
|
|
22
|
-
keyboard?: boolean;
|
|
23
|
-
onContentHeightChange?: (height: number, previousHeight: number) => void;
|
|
24
|
-
onItemHeightChange?: (index: number, height: number, previousHeight: number) => void;
|
|
25
|
-
/**
|
|
26
|
-
* Fires when scrolled within `reachThreshold` lines of the end.
|
|
27
|
-
* Only fires once per entry into the threshold zone.
|
|
28
|
-
*/
|
|
29
|
-
onReachEnd?: () => void;
|
|
30
|
-
/**
|
|
31
|
-
* Fires when scrolled within `reachThreshold` lines of the start.
|
|
32
|
-
* Only fires once per entry into the threshold zone.
|
|
33
|
-
*/
|
|
34
|
-
onReachStart?: () => void;
|
|
35
|
-
onScroll?: (scrollOffset: number) => void;
|
|
36
|
-
onViewportSizeChange?: (size: {
|
|
37
|
-
height: number;
|
|
38
|
-
width: number;
|
|
39
|
-
}, previousSize: {
|
|
40
|
-
height: number;
|
|
41
|
-
width: number;
|
|
42
|
-
}) => void;
|
|
43
|
-
/**
|
|
44
|
-
* Number of extra items to render above/below the viewport when virtualized.
|
|
45
|
-
* @default 3
|
|
46
|
-
*/
|
|
47
|
-
overscan?: number;
|
|
48
|
-
/**
|
|
49
|
-
* Distance in lines from the edge to trigger onReachEnd/onReachStart.
|
|
50
|
-
* @default 5
|
|
51
|
-
*/
|
|
52
|
-
reachThreshold?: number;
|
|
53
|
-
/**
|
|
54
|
-
* Show a scrollbar track when content overflows the viewport.
|
|
55
|
-
* @default false
|
|
56
|
-
*/
|
|
57
|
-
scrollbar?: boolean;
|
|
58
|
-
/**
|
|
59
|
-
* Color of the scrollbar thumb and track.
|
|
60
|
-
*/
|
|
61
|
-
scrollbarColor?: string;
|
|
62
|
-
/**
|
|
63
|
-
* Scrollbar visual style.
|
|
64
|
-
* @default "line"
|
|
65
|
-
*/
|
|
66
|
-
scrollbarStyle?: "arrow" | "block" | "bold" | "classic" | "dots" | "double" | "doubleSingle" | "line" | "round" | "single" | "singleDouble" | "thick";
|
|
67
|
-
/**
|
|
68
|
-
* Enable vim-style keybindings (j/k/g/G/u/d). Requires `keyboard` to be true.
|
|
69
|
-
* @default false
|
|
70
|
-
*/
|
|
71
|
-
vimBindings?: boolean;
|
|
72
|
-
/**
|
|
73
|
-
* Only render items visible in the viewport plus overscan. Requires items to be measured first.
|
|
74
|
-
* @default false
|
|
75
|
-
*/
|
|
76
|
-
virtualize?: boolean;
|
|
77
|
-
}
|
|
78
|
-
interface ScrollViewRef {
|
|
79
|
-
getBottomOffset: () => number;
|
|
80
|
-
getContentHeight: () => number;
|
|
81
|
-
getItemHeight: (index: number) => number;
|
|
82
|
-
getItemPosition: (index: number) => {
|
|
83
|
-
height: number;
|
|
84
|
-
top: number;
|
|
85
|
-
} | null;
|
|
86
|
-
getScrollOffset: () => number;
|
|
87
|
-
getViewportHeight: () => number;
|
|
88
|
-
remeasure: () => void;
|
|
89
|
-
remeasureItem: (index: number) => void;
|
|
90
|
-
scrollBy: (delta: number) => void;
|
|
91
|
-
scrollTo: (offset: number) => void;
|
|
92
|
-
scrollToBottom: () => void;
|
|
93
|
-
scrollToTop: () => void;
|
|
94
|
-
}
|
|
95
|
-
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 & {
|
|
96
|
-
ref?: Ref<ScrollViewRef>;
|
|
97
|
-
}) => React.JSX.Element;
|
|
98
|
-
export { ScrollView as S, ScrollViewProps as a, ScrollViewRef as b };
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
const c={styles:{container:()=>({flexDirection:"column"}),expandIndicator:e=>({color:"gray"}),focusIndicator:()=>({color:"blue"}),indent:({depth:e})=>({width:(e??0)*2}),label:({isFocused:e,isSelected:n})=>{let o;return n&&(o="green"),e&&(o="blue"),{color:o}},loadingIndicator:()=>({color:"yellow"}),node:({isFocused:e})=>({gap:1,paddingLeft:e?0:2}),selectedIndicator:()=>({color:"green"})}};export{c as theme};
|
|
@@ -1,314 +0,0 @@
|
|
|
1
|
-
import { Props as Props$1 } from '@visulima/tui/components/box';
|
|
2
|
-
import { Props as Props$2 } from '@visulima/tui/components/text';
|
|
3
|
-
import { ReactNode, ReactElement } from 'react';
|
|
4
|
-
type StyleFunctionProps = {
|
|
5
|
-
readonly depth?: number;
|
|
6
|
-
readonly hasChildren?: boolean;
|
|
7
|
-
readonly isExpanded?: boolean;
|
|
8
|
-
readonly isFocused?: boolean;
|
|
9
|
-
readonly isLoading?: boolean;
|
|
10
|
-
readonly isSelected?: boolean;
|
|
11
|
-
};
|
|
12
|
-
declare const theme: {
|
|
13
|
-
styles: {
|
|
14
|
-
container: () => Props$1;
|
|
15
|
-
expandIndicator: (_props: StyleFunctionProps) => Props$2;
|
|
16
|
-
focusIndicator: () => Props$2;
|
|
17
|
-
indent: ({ depth }: StyleFunctionProps) => Props$1;
|
|
18
|
-
label: ({ isFocused, isSelected }: StyleFunctionProps) => Props$2;
|
|
19
|
-
loadingIndicator: () => Props$2;
|
|
20
|
-
node: ({ isFocused }: StyleFunctionProps) => Props$1;
|
|
21
|
-
selectedIndicator: () => Props$2;
|
|
22
|
-
};
|
|
23
|
-
};
|
|
24
|
-
type Theme = typeof theme;
|
|
25
|
-
/**
|
|
26
|
-
* A single node in the tree. Generic over the user's data shape.
|
|
27
|
-
* The `id` field MUST be unique across the entire tree.
|
|
28
|
-
*/
|
|
29
|
-
type TreeNode<T = Record<string, unknown>> = {
|
|
30
|
-
/** Child nodes. Undefined or empty array means leaf node. */
|
|
31
|
-
readonly children?: TreeNode<T>[];
|
|
32
|
-
/** Arbitrary user data attached to this node. */
|
|
33
|
-
readonly data?: T;
|
|
34
|
-
/** Unique identifier for this node. Used as the key for all lookups. */
|
|
35
|
-
readonly id: string;
|
|
36
|
-
/**
|
|
37
|
-
* Explicitly marks this node as a parent that can have children loaded
|
|
38
|
-
* asynchronously via `loadChildren`. When true, the node shows an expand
|
|
39
|
-
* indicator even if `children` is empty or undefined, and expanding it
|
|
40
|
-
* triggers the `loadChildren` callback.
|
|
41
|
-
*/
|
|
42
|
-
readonly isParent?: boolean;
|
|
43
|
-
/** Display label. Used by the default renderer. */
|
|
44
|
-
readonly label: string;
|
|
45
|
-
};
|
|
46
|
-
/**
|
|
47
|
-
* For async/lazy loading: a function that resolves children on demand.
|
|
48
|
-
*/
|
|
49
|
-
type AsyncChildrenFunction<T = Record<string, unknown>> = (node: TreeNode<T>) => Promise<TreeNode<T>[]>;
|
|
50
|
-
/**
|
|
51
|
-
* State passed to custom renderers and theme functions.
|
|
52
|
-
*/
|
|
53
|
-
type TreeNodeState = {
|
|
54
|
-
/** Depth of this node in the tree (root = 0). */
|
|
55
|
-
readonly depth: number;
|
|
56
|
-
/** Whether this node has children (or a lazy loader). */
|
|
57
|
-
readonly hasChildren: boolean;
|
|
58
|
-
/** Whether this node is expanded (children visible). */
|
|
59
|
-
readonly isExpanded: boolean;
|
|
60
|
-
/** Whether this node is currently focused (cursor is on it). */
|
|
61
|
-
readonly isFocused: boolean;
|
|
62
|
-
/** Whether children are currently loading (async mode). */
|
|
63
|
-
readonly isLoading: boolean;
|
|
64
|
-
/** Whether this node is selected (in select/multi-select mode). */
|
|
65
|
-
readonly isSelected: boolean;
|
|
66
|
-
};
|
|
67
|
-
/**
|
|
68
|
-
* Props received by a custom node renderer.
|
|
69
|
-
*/
|
|
70
|
-
type TreeNodeRendererProps<T = Record<string, unknown>> = {
|
|
71
|
-
/** The tree node data. */
|
|
72
|
-
readonly node: TreeNode<T>;
|
|
73
|
-
/** Current state of this node. */
|
|
74
|
-
readonly state: TreeNodeState;
|
|
75
|
-
};
|
|
76
|
-
/**
|
|
77
|
-
* Selection mode for the tree view.
|
|
78
|
-
*/
|
|
79
|
-
type SelectionMode = "multiple" | "none" | "single";
|
|
80
|
-
/**
|
|
81
|
-
* A flattened representation of a tree node with navigation links.
|
|
82
|
-
*/
|
|
83
|
-
type FlatNode<T = Record<string, unknown>> = {
|
|
84
|
-
/** Ordered list of direct children IDs. */
|
|
85
|
-
readonly childrenIds: ReadonlyArray<string>;
|
|
86
|
-
/** Depth in the tree (0 for roots). */
|
|
87
|
-
readonly depth: number;
|
|
88
|
-
/** Index in the flattened DFS order (across ALL nodes, not just visible). */
|
|
89
|
-
readonly flatIndex: number;
|
|
90
|
-
/** Whether this node has children. */
|
|
91
|
-
readonly hasChildren: boolean;
|
|
92
|
-
/** Next sibling's ID, or undefined. */
|
|
93
|
-
readonly nextSiblingId: string | undefined;
|
|
94
|
-
/** The original tree node. */
|
|
95
|
-
readonly node: TreeNode<T>;
|
|
96
|
-
/** Parent's id, or undefined if root. */
|
|
97
|
-
readonly parentId: string | undefined;
|
|
98
|
-
/** Previous sibling's ID, or undefined. */
|
|
99
|
-
readonly previousSiblingId: string | undefined;
|
|
100
|
-
/** Total number of siblings (including this node). */
|
|
101
|
-
readonly siblingCount: number;
|
|
102
|
-
/** Zero-based index among siblings. */
|
|
103
|
-
readonly siblingIndex: number;
|
|
104
|
-
};
|
|
105
|
-
/**
|
|
106
|
-
* A flattened map of all tree nodes built via DFS traversal.
|
|
107
|
-
* Stores parent/child/sibling links for O(1) navigation.
|
|
108
|
-
*/
|
|
109
|
-
declare class TreeNodeMap<T = Record<string, unknown>> {
|
|
110
|
-
/** All node IDs in DFS order. */
|
|
111
|
-
readonly orderedIds: string[];
|
|
112
|
-
/** Root-level node IDs. */
|
|
113
|
-
readonly rootIds: string[];
|
|
114
|
-
/** Map from node ID to FlatNode. */
|
|
115
|
-
private readonly map;
|
|
116
|
-
constructor(data: TreeNode<T>[]);
|
|
117
|
-
/**
|
|
118
|
-
* Iterate over all entries.
|
|
119
|
-
*/
|
|
120
|
-
entries(): IterableIterator<[string, FlatNode<T>]>;
|
|
121
|
-
/**
|
|
122
|
-
* Get a flat node by ID.
|
|
123
|
-
*/
|
|
124
|
-
get(id: string): FlatNode<T> | undefined;
|
|
125
|
-
/**
|
|
126
|
-
* Total number of nodes in the tree.
|
|
127
|
-
*/
|
|
128
|
-
get size(): number;
|
|
129
|
-
/**
|
|
130
|
-
* Given a set of expanded node IDs, return the ordered list of
|
|
131
|
-
* VISIBLE node IDs (i.e., a node is visible if all its ancestors
|
|
132
|
-
* are expanded).
|
|
133
|
-
*
|
|
134
|
-
* Uses iterative DFS, skipping collapsed subtrees.
|
|
135
|
-
*/
|
|
136
|
-
getVisibleIds(expandedIds: ReadonlySet<string>): string[];
|
|
137
|
-
/**
|
|
138
|
-
* Check if a node is a descendant of another node.
|
|
139
|
-
*/
|
|
140
|
-
isDescendantOf(nodeId: string, ancestorId: string): boolean;
|
|
141
|
-
/**
|
|
142
|
-
* Insert dynamically-loaded children under a parent node.
|
|
143
|
-
* Returns a new TreeNodeMap (immutable operation).
|
|
144
|
-
*
|
|
145
|
-
* Rebuilds the full tree from the current map state (not the original
|
|
146
|
-
* input data), so successive calls for different parents are safe.
|
|
147
|
-
*/
|
|
148
|
-
withChildren(parentId: string, children: TreeNode<T>[]): TreeNodeMap<T>;
|
|
149
|
-
private buildFromData;
|
|
150
|
-
}
|
|
151
|
-
type Props<T = Record<string, unknown>> = {
|
|
152
|
-
/**
|
|
153
|
-
* Accessible label for the tree container.
|
|
154
|
-
* Useful when multiple tree views are on screen.
|
|
155
|
-
* @default "Tree view"
|
|
156
|
-
*/
|
|
157
|
-
readonly ariaLabel?: string;
|
|
158
|
-
/**
|
|
159
|
-
* The tree data. Array of root-level nodes.
|
|
160
|
-
*
|
|
161
|
-
* **Important:** Must be referentially stable across renders (e.g. stored
|
|
162
|
-
* in state or wrapped in `useMemo`). Passing a new array reference on
|
|
163
|
-
* every render will reset focus, expansion, and selection state.
|
|
164
|
-
*/
|
|
165
|
-
readonly data: TreeNode<T>[];
|
|
166
|
-
/**
|
|
167
|
-
* Set of node IDs that are expanded by default.
|
|
168
|
-
* If not provided, all nodes start collapsed.
|
|
169
|
-
*/
|
|
170
|
-
readonly defaultExpanded?: ReadonlySet<string> | "all";
|
|
171
|
-
/**
|
|
172
|
-
* Set of node IDs that are selected by default.
|
|
173
|
-
*/
|
|
174
|
-
readonly defaultSelected?: ReadonlySet<string>;
|
|
175
|
-
/**
|
|
176
|
-
* When disabled, user input is ignored.
|
|
177
|
-
* @default false
|
|
178
|
-
*/
|
|
179
|
-
readonly isDisabled?: boolean;
|
|
180
|
-
/**
|
|
181
|
-
* Async function to load children on demand.
|
|
182
|
-
*/
|
|
183
|
-
readonly loadChildren?: AsyncChildrenFunction<T>;
|
|
184
|
-
/** Called when expanded set changes. */
|
|
185
|
-
readonly onExpandChange?: (expandedIds: ReadonlySet<string>) => void;
|
|
186
|
-
/** Called when the focused node changes. */
|
|
187
|
-
readonly onFocusChange?: (nodeId: string) => void;
|
|
188
|
-
/**
|
|
189
|
-
* Called when `loadChildren` rejects. Receives the node ID and error.
|
|
190
|
-
*/
|
|
191
|
-
readonly onLoadError?: (nodeId: string, error: Error) => void;
|
|
192
|
-
/** Called when selection changes. */
|
|
193
|
-
readonly onSelectChange?: (selectedIds: ReadonlySet<string>) => void;
|
|
194
|
-
/**
|
|
195
|
-
* Custom node renderer. Receives node + state, returns Ink JSX.
|
|
196
|
-
*/
|
|
197
|
-
readonly renderNode?: (props: TreeNodeRendererProps<T>) => ReactNode;
|
|
198
|
-
/**
|
|
199
|
-
* Selection mode.
|
|
200
|
-
* - "none": No selection behavior (default).
|
|
201
|
-
* - "single": One node can be selected at a time.
|
|
202
|
-
* - "multiple": Multiple nodes can be selected (checkboxes shown).
|
|
203
|
-
* @default "none"
|
|
204
|
-
*/
|
|
205
|
-
readonly selectionMode?: SelectionMode;
|
|
206
|
-
/**
|
|
207
|
-
* Number of visible nodes in the viewport (for virtualization).
|
|
208
|
-
* @default Infinity (no virtualization)
|
|
209
|
-
*/
|
|
210
|
-
readonly visibleNodeCount?: number;
|
|
211
|
-
};
|
|
212
|
-
/**
|
|
213
|
-
* Renders an interactive tree view with keyboard navigation.
|
|
214
|
-
*
|
|
215
|
-
* ```tsx
|
|
216
|
-
* <TreeView
|
|
217
|
-
* data={[
|
|
218
|
-
* { id: "1", label: "Root", children: [
|
|
219
|
-
* { id: "1.1", label: "Child" },
|
|
220
|
-
* ]},
|
|
221
|
-
* ]}
|
|
222
|
-
* defaultExpanded="all"
|
|
223
|
-
* />
|
|
224
|
-
* ```
|
|
225
|
-
*/
|
|
226
|
-
declare function TreeView<T = Record<string, unknown>>({ ariaLabel, data, defaultExpanded, defaultSelected, isDisabled, loadChildren, onExpandChange, onFocusChange, onLoadError, onSelectChange, renderNode, selectionMode, visibleNodeCount }: Props<T>): ReactElement;
|
|
227
|
-
type UseTreeViewStateProps<T = Record<string, unknown>> = {
|
|
228
|
-
/** The tree data. Array of root-level nodes. */
|
|
229
|
-
readonly data: TreeNode<T>[];
|
|
230
|
-
/**
|
|
231
|
-
* Set of node IDs that are expanded by default.
|
|
232
|
-
* If not provided, all nodes start collapsed.
|
|
233
|
-
*/
|
|
234
|
-
readonly defaultExpanded?: ReadonlySet<string> | "all";
|
|
235
|
-
/**
|
|
236
|
-
* Set of node IDs that are selected by default.
|
|
237
|
-
*/
|
|
238
|
-
readonly defaultSelected?: ReadonlySet<string>;
|
|
239
|
-
/** Called when expanded set changes. */
|
|
240
|
-
readonly onExpandChange?: (expandedIds: ReadonlySet<string>) => void;
|
|
241
|
-
/** Called when the focused node changes. */
|
|
242
|
-
readonly onFocusChange?: (nodeId: string) => void;
|
|
243
|
-
/** Called when selection changes. */
|
|
244
|
-
readonly onSelectChange?: (selectedIds: ReadonlySet<string>) => void;
|
|
245
|
-
/**
|
|
246
|
-
* Selection mode.
|
|
247
|
-
* @default "none"
|
|
248
|
-
*/
|
|
249
|
-
readonly selectionMode?: SelectionMode;
|
|
250
|
-
/**
|
|
251
|
-
* Number of visible nodes in the viewport (for virtualization).
|
|
252
|
-
* @default Infinity
|
|
253
|
-
*/
|
|
254
|
-
readonly visibleNodeCount?: number;
|
|
255
|
-
};
|
|
256
|
-
type TreeViewState<T = Record<string, unknown>> = {
|
|
257
|
-
readonly collapse: () => void;
|
|
258
|
-
readonly collapseAll: () => void;
|
|
259
|
-
readonly collapseNode: (nodeId: string) => void;
|
|
260
|
-
readonly expand: () => void;
|
|
261
|
-
readonly expandAll: () => void;
|
|
262
|
-
readonly expandedIds: ReadonlySet<string>;
|
|
263
|
-
readonly expandNode: (nodeId: string) => void;
|
|
264
|
-
readonly focusedId: string | undefined;
|
|
265
|
-
readonly focusFirst: () => void;
|
|
266
|
-
readonly focusFirstChild: () => void;
|
|
267
|
-
readonly focusLast: () => void;
|
|
268
|
-
readonly focusNext: () => void;
|
|
269
|
-
readonly focusParent: () => void;
|
|
270
|
-
readonly focusPrevious: () => void;
|
|
271
|
-
readonly hasScrollDown: boolean;
|
|
272
|
-
readonly hasScrollUp: boolean;
|
|
273
|
-
readonly insertChildren: (parentId: string, children: TreeNode<T>[]) => void;
|
|
274
|
-
readonly loadingIds: ReadonlySet<string>;
|
|
275
|
-
readonly nodeMap: TreeNodeMap<T>;
|
|
276
|
-
readonly select: () => void;
|
|
277
|
-
readonly selectedIds: ReadonlySet<string>;
|
|
278
|
-
readonly setChildrenError: (nodeId: string) => void;
|
|
279
|
-
readonly setLoading: (nodeId: string, isLoading: boolean) => void;
|
|
280
|
-
readonly toggleExpanded: () => void;
|
|
281
|
-
readonly viewportFromIndex: number;
|
|
282
|
-
readonly viewportNodes: {
|
|
283
|
-
node: TreeNode<T>;
|
|
284
|
-
state: TreeNodeState;
|
|
285
|
-
}[];
|
|
286
|
-
readonly viewportToIndex: number;
|
|
287
|
-
readonly visibleCount: number;
|
|
288
|
-
};
|
|
289
|
-
declare function useTreeViewState<T = Record<string, unknown>>({ data, defaultExpanded, defaultSelected, onExpandChange, onFocusChange, onSelectChange, selectionMode, visibleNodeCount }: UseTreeViewStateProps<T>): TreeViewState<T>;
|
|
290
|
-
type UseTreeViewProps<T = Record<string, unknown>> = {
|
|
291
|
-
/**
|
|
292
|
-
* When disabled, user input is ignored.
|
|
293
|
-
* @default false
|
|
294
|
-
*/
|
|
295
|
-
readonly isDisabled?: boolean;
|
|
296
|
-
/**
|
|
297
|
-
* Async function to load children on demand.
|
|
298
|
-
*/
|
|
299
|
-
readonly loadChildren?: AsyncChildrenFunction<T>;
|
|
300
|
-
/**
|
|
301
|
-
* Called when `loadChildren` rejects.
|
|
302
|
-
*/
|
|
303
|
-
readonly onLoadError?: (nodeId: string, error: Error) => void;
|
|
304
|
-
/**
|
|
305
|
-
* Selection mode.
|
|
306
|
-
*/
|
|
307
|
-
readonly selectionMode: SelectionMode;
|
|
308
|
-
/**
|
|
309
|
-
* The tree view state from `useTreeViewState`.
|
|
310
|
-
*/
|
|
311
|
-
readonly state: TreeViewState<T>;
|
|
312
|
-
};
|
|
313
|
-
declare function useTreeView<T>({ isDisabled, loadChildren, onLoadError, selectionMode, state }: UseTreeViewProps<T>): void;
|
|
314
|
-
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 };
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
import g from"@visulima/tui/hooks/use-input";import{useRef as s,useCallback as I}from"react";function C({isDisabled:h=!1,loadChildren:d,onLoadError:i,selectionMode:f,state:e}){const u=s(new Set),n=s(e);n.current=e;const a=s(d);a.current=d;const l=s(i);l.current=i;const p=I(async t=>{if(u.current.has(t))return;const r=a.current;if(!r)return;const o=n.current.nodeMap.get(t);if(!(!o||o.childrenIds.length>0)){u.current.add(t),n.current.setLoading(t,!0);try{const c=await r(o.node);n.current.insertChildren(t,c),n.current.expandNode(t)}catch(c){const x=c instanceof Error?c:new Error(String(c));n.current.setChildrenError(t),l.current?.(t,x)}finally{n.current.setLoading(t,!1),u.current.delete(t)}}},[]);g((t,r)=>{if(r.downArrow){e.focusNext();return}if(r.upArrow){e.focusPrevious();return}if(r.rightArrow){if(e.focusedId&&e.expandedIds.has(e.focusedId))e.focusFirstChild();else if(e.focusedId){if(d){const o=e.nodeMap.get(e.focusedId);if(o&&o.hasChildren&&o.childrenIds.length===0){p(e.focusedId).catch(()=>{});return}}e.expand()}return}if(r.leftArrow){e.focusedId&&e.expandedIds.has(e.focusedId)?e.collapse():e.focusParent();return}if(r.return){f==="none"?e.toggleExpanded():e.select();return}if(t===" "){f==="multiple"?e.select():e.toggleExpanded();return}if(t==="\x1B[H"||t==="\x1B[1~"||t==="\x1BOH"){e.focusFirst();return}(t==="\x1B[F"||t==="\x1B[4~"||t==="\x1BOF")&&e.focusLast()},{isActive:!h})}export{C as useTreeView};
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
import{useReducer as H,useState as J,useRef as v,useEffect as b,useMemo as K,useCallback as l}from"react";import{TreeNodeMap as Q}from"./TreeNodeMap-cJlYqckB.js";function p(e){const t=new Map;for(const[d,s]of e.entries())t.set(s,d);return t}function f(e,t){if(e.visibleNodeCount>=e.visibleIds.length)return{viewportFromIndex:0,viewportToIndex:e.visibleIds.length};let d=e.viewportFromIndex,s=e.viewportToIndex;return t>=s&&(s=t+1,d=s-e.visibleNodeCount),t<d&&(d=t,s=d+e.visibleNodeCount),{viewportFromIndex:Math.max(0,d),viewportToIndex:Math.min(e.visibleIds.length,s)}}function w(e,t){if(e.visibleNodeCount>=t.length)return{viewportFromIndex:0,viewportToIndex:t.length};const d=e.focusedId?t.indexOf(e.focusedId):-1;if(d<0)return{viewportFromIndex:0,viewportToIndex:Math.min(e.visibleNodeCount,t.length)};let s=Math.min(e.viewportToIndex,t.length),o=Math.max(0,s-e.visibleNodeCount);return d>=s&&(s=d+1,o=s-e.visibleNodeCount),d<o&&(o=d,s=o+e.visibleNodeCount),{viewportFromIndex:Math.max(0,o),viewportToIndex:Math.min(t.length,s)}}function x(e,t){switch(t.type){case"collapse":return e.focusedId?x(e,{nodeId:e.focusedId,type:"collapse-node"}):e;case"collapse-all":{const d=new Set,s=e.nodeMap.getVisibleIds(d);return{...e,expandedIds:d,focusedId:s[0],previousExpandedIds:e.expandedIds,viewportFromIndex:0,viewportToIndex:Math.min(e.visibleNodeCount,s.length),visibleIdIndex:p(s),visibleIds:s}}case"collapse-node":{const{nodeId:d}=t;if(!e.expandedIds.has(d))return e;const s=new Set(e.expandedIds);s.delete(d);const o=e.nodeMap.getVisibleIds(s);let r=e.focusedId;return r!==void 0&&r!==d&&e.nodeMap.isDescendantOf(r,d)&&(r=d),{...e,expandedIds:s,focusedId:r,previousExpandedIds:e.expandedIds,visibleIdIndex:p(o),visibleIds:o,...w({...e,focusedId:r},o)}}case"expand":return e.focusedId?x(e,{nodeId:e.focusedId,type:"expand-node"}):e;case"expand-all":{const d=new Set;for(const[o,r]of e.nodeMap.entries())r.hasChildren&&d.add(o);const s=e.nodeMap.getVisibleIds(d);return{...e,expandedIds:d,previousExpandedIds:e.expandedIds,visibleIdIndex:p(s),visibleIds:s,...w({...e},s)}}case"expand-node":{const{nodeId:d}=t;if(!e.nodeMap.get(d)?.hasChildren||e.expandedIds.has(d))return e;const s=new Set(e.expandedIds);s.add(d);const o=e.nodeMap.getVisibleIds(s);return{...e,expandedIds:s,previousExpandedIds:e.expandedIds,visibleIdIndex:p(o),visibleIds:o,...w({...e},o)}}case"focus-first":return e.visibleIds.length===0?e:{...e,focusedId:e.visibleIds[0],viewportFromIndex:0,viewportToIndex:Math.min(e.visibleNodeCount,e.visibleIds.length)};case"focus-first-child":{if(!e.focusedId)return e;const d=e.nodeMap.get(e.focusedId);if(!d||d.childrenIds.length===0||!e.expandedIds.has(e.focusedId))return e;const s=d.childrenIds[0],o=e.visibleIdIndex.get(s)??-1;return o<0?e:{...e,focusedId:s,...f(e,o)}}case"focus-last":{if(e.visibleIds.length===0)return e;const d=e.visibleIds.length-1;return{...e,focusedId:e.visibleIds[d],...f(e,d)}}case"focus-next":{if(!e.focusedId)return e;const d=e.visibleIdIndex.get(e.focusedId)??-1;if(d<0||d>=e.visibleIds.length-1)return e;const s=e.visibleIds[d+1];return{...e,focusedId:s,...f(e,d+1)}}case"focus-parent":{if(!e.focusedId)return e;const d=e.nodeMap.get(e.focusedId);if(!d?.parentId)return e;const s=e.visibleIdIndex.get(d.parentId)??-1;return s<0?e:{...e,focusedId:d.parentId,...f(e,s)}}case"focus-previous":{if(!e.focusedId)return e;const d=e.visibleIdIndex.get(e.focusedId)??-1;if(d<=0)return e;const s=e.visibleIds[d-1];return{...e,focusedId:s,...f(e,d-1)}}case"insert-children":{if(!e.nodeMap.get(t.parentId))return e;const d=e.nodeMap.withChildren(t.parentId,t.children),s=d.getVisibleIds(e.expandedIds);return{...e,nodeMap:d,visibleIdIndex:p(s),visibleIds:s}}case"reset":return t.state;case"select":{if(!e.focusedId||e.selectionMode==="none")return e;if(e.selectionMode==="single"){const s=new Set([e.focusedId]);return{...e,previousSelectedIds:e.selectedIds,selectedIds:s}}const d=new Set(e.selectedIds);return d.has(e.focusedId)?d.delete(e.focusedId):d.add(e.focusedId),{...e,previousSelectedIds:e.selectedIds,selectedIds:d}}case"set-children-error":{const d=new Set(e.loadingIds);return d.delete(t.nodeId),{...e,loadingIds:d}}case"set-loading":{const d=new Set(e.loadingIds);return t.isLoading?d.add(t.nodeId):d.delete(t.nodeId),{...e,loadingIds:d}}case"toggle-expanded":return e.focusedId?e.expandedIds.has(e.focusedId)?x(e,{type:"collapse"}):x(e,{type:"expand"}):e;default:return e}}function y({data:e,defaultExpanded:t,defaultSelected:d,selectionMode:s,visibleNodeCount:o}){const r=new Q(e);let I;if(t==="all"){I=new Set;for(const[h,g]of r.entries())g.hasChildren&&I.add(h)}else t?I=new Set(t):I=new Set;const c=r.getVisibleIds(I),n=s!=="none"&&d?new Set(d):new Set,i=Math.min(o,c.length);return{expandedIds:I,focusedId:c[0],loadingIds:new Set,nodeMap:r,previousExpandedIds:I,previousSelectedIds:n,selectedIds:n,selectionMode:s,viewportFromIndex:0,viewportToIndex:i,visibleIdIndex:p(c),visibleIds:c,visibleNodeCount:o}}function Y({data:e,defaultExpanded:t,defaultSelected:d,onExpandChange:s,onFocusChange:o,onSelectChange:r,selectionMode:I="none",visibleNodeCount:c=1/0}){const[n,i]=H(x,{data:e,defaultExpanded:t,defaultSelected:d,selectionMode:I,visibleNodeCount:c},y),[h,g]=J(e);e!==h&&(i({state:y({data:e,defaultExpanded:t,defaultSelected:d,selectionMode:I,visibleNodeCount:c}),type:"reset"}),g(e));const M=v(o);M.current=o;const m=v(s);m.current=s;const S=v(r);S.current=r;const C=v(!0);b(()=>{if(C.current){C.current=!1;return}n.focusedId&&M.current?.(n.focusedId)},[n.focusedId]),b(()=>{n.expandedIds!==n.previousExpandedIds&&m.current?.(n.expandedIds)},[n.expandedIds,n.previousExpandedIds]),b(()=>{n.selectedIds!==n.previousSelectedIds&&S.current?.(n.selectedIds)},[n.selectedIds,n.previousSelectedIds]);const N=K(()=>n.visibleIds.slice(n.viewportFromIndex,n.viewportToIndex).map(a=>{const u=n.nodeMap.get(a);return{node:u.node,state:{depth:u.depth,hasChildren:u.hasChildren,isExpanded:n.expandedIds.has(a),isFocused:a===n.focusedId,isLoading:n.loadingIds.has(a),isSelected:n.selectedIds.has(a)}}}),[n.visibleIds,n.viewportFromIndex,n.viewportToIndex,n.focusedId,n.expandedIds,n.selectedIds,n.nodeMap,n.loadingIds]),F=l(()=>{i({type:"focus-next"})},[]),T=l(()=>{i({type:"focus-previous"})},[]),E=l(()=>{i({type:"focus-first"})},[]),V=l(()=>{i({type:"focus-last"})},[]),L=l(()=>{i({type:"expand"})},[]),D=l(a=>{i({nodeId:a,type:"expand-node"})},[]),A=l(()=>{i({type:"collapse"})},[]),O=l(a=>{i({nodeId:a,type:"collapse-node"})},[]),P=l(()=>{i({type:"toggle-expanded"})},[]),R=l(()=>{i({type:"expand-all"})},[]),k=l(()=>{i({type:"collapse-all"})},[]),U=l(()=>{i({type:"select"})},[]),j=l(()=>{i({type:"focus-parent"})},[]),q=l(()=>{i({type:"focus-first-child"})},[]),z=l((a,u)=>{i({isLoading:u,nodeId:a,type:"set-loading"})},[]),B=l(a=>{i({nodeId:a,type:"set-children-error"})},[]),G=l((a,u)=>{i({children:u,parentId:a,type:"insert-children"})},[]);return{collapse:A,collapseAll:k,collapseNode:O,expand:L,expandAll:R,expandedIds:n.expandedIds,expandNode:D,focusedId:n.focusedId,focusFirst:E,focusFirstChild:q,focusLast:V,focusNext:F,focusParent:j,focusPrevious:T,hasScrollDown:n.viewportToIndex<n.visibleIds.length,hasScrollUp:n.viewportFromIndex>0,insertChildren:G,loadingIds:n.loadingIds,nodeMap:n.nodeMap,select:U,selectedIds:n.selectedIds,setChildrenError:B,setLoading:z,toggleExpanded:P,viewportFromIndex:n.viewportFromIndex,viewportNodes:N,viewportToIndex:n.viewportToIndex,visibleCount:n.visibleIds.length}}export{y as createDefaultState,x as reducer,Y as useTreeViewState};
|