@voxel51/voodo 0.0.30 → 0.0.31

package/dist/components/Checkbox/Checkbox.d.ts

@@ -4,6 +4,7 @@ type ModifiedCheckboxProps = Omit<InputHTMLAttributes<HTMLInputElement>, "size"
 export interface CheckboxProps extends ModifiedCheckboxProps {
     checked?: boolean;
     onChange?: (checked: boolean) => void;
+    indeterminate?: boolean;
     label?: string;
     disabled?: boolean;
     size?: Size;
@@ -34,6 +35,8 @@ export interface CheckboxProps extends ModifiedCheckboxProps {
  *
  * @param checked `checked` state of the checkbox.
  * @param onChange Change handler for when the checked state changes.
+ * @param indeterminate When true (and `checked` is false), renders a dash icon,
+ *  indicating partial selection among descendants. Ignored when `checked` is true.
  * @param size Size of the checkbox; this controls both the checkbox itself and the associated label. See {@link Size}.
  * @param radius Border radius of the checkbox; this controls the styling of the checkbox itself. See {@link Radius}.
  * @param className `class` overrides to apply to the checkbox.

package/dist/components/Checkbox/Checkbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Checkbox.d.ts","sourceRoot":"","sources":["../../../src/components/Checkbox/Checkbox.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC;AAMrD,OAAO,EAOL,MAAM,EACN,IAAI,EAGL,MAAM,SAAS,CAAC;AAGjB,KAAK,qBAAqB,GAAG,IAAI,CAC/B,mBAAmB,CAAC,gBAAgB,CAAC,EACrC,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAC3D,CAAC;AAEF,MAAM,WAAW,aAAc,SAAQ,qBAAqB;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAkBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,QAAQ,EAAE,EAAE,CAAC,aAAa,CA6DtC,CAAC"}
+{"version":3,"file":"Checkbox.d.ts","sourceRoot":"","sources":["../../../src/components/Checkbox/Checkbox.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC;AAMrD,OAAO,EAQL,MAAM,EACN,IAAI,EAGL,MAAM,SAAS,CAAC;AAGjB,KAAK,qBAAqB,GAAG,IAAI,CAC/B,mBAAmB,CAAC,gBAAgB,CAAC,EACrC,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAC3D,CAAC;AAEF,MAAM,WAAW,aAAc,SAAQ,qBAAqB;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAkBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,QAAQ,EAAE,EAAE,CAAC,aAAa,CA0EtC,CAAC"}

package/dist/components/Pill/Pill.d.ts

@@ -10,6 +10,7 @@ export interface PillProps extends HTMLAttributes<HTMLSpanElement> {
     isStatus?: boolean;
     backgroundColor?: PillColor;
     icon?: IconName;
+    onRemove?: () => void;
 }
 /**
  * A basic pill component.

package/dist/components/Pill/Pill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Pill.d.ts","sourceRoot":"","sources":["../../../src/components/Pill/Pill.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAMhD,OAAO,EACL,eAAe,EACf,QAAQ,EACR,MAAM,EACN,aAAa,EACb,MAAM,EACN,IAAI,EAEJ,WAAW,EACX,SAAS,EACV,MAAM,SAAS,CAAC;AAGjB,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;AACxD,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,aAAa,GAAG,WAAW,CAAC;AAEtE,MAAM,WAAW,SAAU,SAAQ,cAAc,CAAC,eAAe,CAAC;IAChE,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAQD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,IAAI,EAAE,EAAE,CAAC,SAAS,CA6C9B,CAAC"}
+{"version":3,"file":"Pill.d.ts","sourceRoot":"","sources":["../../../src/components/Pill/Pill.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAMhD,OAAO,EACL,eAAe,EACf,QAAQ,EACR,MAAM,EACN,aAAa,EACb,MAAM,EACN,IAAI,EAEJ,WAAW,EACX,SAAS,EACV,MAAM,SAAS,CAAC;AAIjB,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;AACxD,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,aAAa,GAAG,WAAW,CAAC;AAEtE,MAAM,WAAW,SAAU,SAAQ,cAAc,CAAC,eAAe,CAAC;IAChE,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAQD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,IAAI,EAAE,EAAE,CAAC,SAAS,CAoE9B,CAAC"}

package/dist/components/TreeSelect/TreeSelect.d.ts

@@ -0,0 +1,33 @@
+import { FC } from 'react';
+import { TreeSelectProps } from './types';
+/**
+ * A tree-shaped selection control that renders nodes in a
+ * searchable dropdown panel styled to match {@link Select}.
+ *
+ * Supports single-select with full keyboard navigation (ARIA treeview pattern).
+ *
+ * Paths are represented as {@link TreePath} — ordered arrays of raw node
+ * names. No encoding is needed, even when names contain `/` or `%`.
+ *
+ * @example
+ * ```tsx
+ * const tree: TreeNode = {
+ *   name: "vehicle_type",
+ *   values: [
+ *     { name: "car", values: [{ name: "Honda" }, { name: "Toyota" }] },
+ *     { name: "motorcycle" },
+ *   ],
+ * };
+ *
+ * const [value, setValue] = useState<TreePath | undefined>();
+ *
+ * <TreeSelect
+ *   root={tree}
+ *   value={value}
+ *   onChange={(path) => setValue(path ?? undefined)}
+ *   placeholder="Select a vehicle…"
+ * />
+ * ```
+ */
+export declare const TreeSelect: FC<TreeSelectProps>;
+//# sourceMappingURL=TreeSelect.d.ts.map

package/dist/components/TreeSelect/TreeSelect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeSelect.d.ts","sourceRoot":"","sources":["../../../src/components/TreeSelect/TreeSelect.tsx"],"names":[],"mappings":"AASA,OAAO,EACL,KAAK,EAAE,EAMR,MAAM,OAAO,CAAC;AAgBf,OAAO,KAAK,EAAsB,eAAe,EAAE,MAAM,SAAS,CAAC;AAWnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,UAAU,EAAE,EAAE,CAAC,eAAe,CAoV1C,CAAC"}

package/dist/components/TreeSelect/TreeSelectNode.d.ts

@@ -0,0 +1,21 @@
+import { FC } from 'react';
+import { UseTreeReturn } from '../../util/useTree';
+import { ResolvedNode } from './types';
+export interface TreeSelectNodeProps {
+    resolved: ResolvedNode;
+    tree: UseTreeReturn;
+    query?: string;
+    multiSelect?: boolean;
+    onRetryLoad?: (path: string) => void;
+}
+/**
+ * Renders a single node row. The parent renders a flat list of all visible
+ * nodes (via `tree.visibleNodes`), so this component never recurses.
+ * Depth-based indentation produces the visual tree hierarchy.
+ * All state is driven by the `tree` hook — this component is purely
+ * presentational.
+ *
+ * @internal For use by TreeSelectPanel.
+ */
+export declare const TreeSelectNode: FC<TreeSelectNodeProps>;
+//# sourceMappingURL=TreeSelectNode.d.ts.map

package/dist/components/TreeSelect/TreeSelectNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeSelectNode.d.ts","sourceRoot":"","sources":["../../../src/components/TreeSelect/TreeSelectNode.tsx"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,EAAE,EAAE,MAAM,OAAO,CAAC;AAwBvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAI5C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAqBD;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,EAAE,EAAE,CAAC,mBAAmB,CAgKlD,CAAC"}

package/dist/components/TreeSelect/TreeSelectPanel.d.ts

@@ -0,0 +1,21 @@
+import { CSSProperties, FC, RefObject } from 'react';
+import { ZIndex } from '../../types';
+import { UseTreeReturn } from '../../util/useTree';
+export interface TreeSelectPanelProps {
+    floatingRef: (node: HTMLElement | null) => void;
+    floatingStyles: CSSProperties;
+    portal?: boolean;
+    zIndex?: ZIndex;
+    panelId: string;
+    query: string;
+    onQueryChange: (q: string) => void;
+    debouncedQuery: string;
+    searchInputRef: RefObject<HTMLInputElement | null>;
+    tree: UseTreeReturn;
+    filteredTree: boolean;
+    multiSelect?: boolean;
+    onRetryLoad?: (path: string) => void;
+    panelMaxHeight?: string;
+}
+export declare const TreeSelectPanel: FC<TreeSelectPanelProps>;
+//# sourceMappingURL=TreeSelectPanel.d.ts.map

package/dist/components/TreeSelect/TreeSelectPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeSelectPanel.d.ts","sourceRoot":"","sources":["../../../src/components/TreeSelect/TreeSelectPanel.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,EAAE,EAGP,KAAK,SAAS,EAGf,MAAM,OAAO,CAAC;AAMf,OAAO,EAUL,MAAM,EAEP,MAAM,SAAS,CAAC;AAEjB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AA4BpD,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,cAAc,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACnD,IAAI,EAAE,aAAa,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAeD,eAAO,MAAM,eAAe,EAAE,EAAE,CAAC,oBAAoB,CAmHpD,CAAC"}

package/dist/components/TreeSelect/TreeSelectSearchInput.d.ts

@@ -0,0 +1,16 @@
+import { FC, KeyboardEvent, Ref } from 'react';
+export interface TreeSelectSearchInputProps {
+    value: string;
+    onChange: (value: string) => void;
+    onKeyDown: (e: KeyboardEvent) => void;
+    inputRef: Ref<HTMLInputElement>;
+    activeDescendantId?: string;
+}
+/**
+ * Sticky search bar rendered at the top of the TreeSelect panel.
+ * Owns the magnifier icon, text input, and clear button.
+ *
+ * @internal For use by TreeSelectPanel.
+ */
+export declare const TreeSelectSearchInput: FC<TreeSelectSearchInputProps>;
+//# sourceMappingURL=TreeSelectSearchInput.d.ts.map

package/dist/components/TreeSelect/TreeSelectSearchInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeSelectSearchInput.d.ts","sourceRoot":"","sources":["../../../src/components/TreeSelect/TreeSelectSearchInput.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,aAAa,EAAE,KAAK,GAAG,EAAE,MAAM,OAAO,CAAC;AAiB9D,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,SAAS,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,IAAI,CAAC;IACtC,QAAQ,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAChC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,EAAE,CAAC,0BAA0B,CA+DhE,CAAC"}

package/dist/components/TreeSelect/TreeSelectTrigger.d.ts

@@ -0,0 +1,22 @@
+import { FC } from 'react';
+export interface TreeSelectTriggerProps {
+    multiSelect?: boolean;
+    value: string | string[] | undefined;
+    disabled?: boolean;
+    placeholder?: string;
+    isOpen: boolean;
+    panelId: string;
+    hasValue: boolean;
+    getDisplayValue: (path: string | null) => string;
+    onToggle: () => void;
+    onClear: () => void;
+    onRemoveOne: (path: string) => void;
+}
+/**
+ * Trigger element for TreeSelect. Renders either a pill-based multi-select
+ * trigger or a single-select read-only input, branching on `multiSelect`.
+ *
+ * @internal For use by TreeSelect.
+ */
+export declare const TreeSelectTrigger: FC<TreeSelectTriggerProps>;
+//# sourceMappingURL=TreeSelectTrigger.d.ts.map

package/dist/components/TreeSelect/TreeSelectTrigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeSelectTrigger.d.ts","sourceRoot":"","sources":["../../../src/components/TreeSelect/TreeSelectTrigger.tsx"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,EAAE,EAAE,MAAM,OAAO,CAAC;AAkBvC,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,CAAC;IACjD,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AA6DD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,EAAE,CAAC,sBAAsB,CAyFxD,CAAC"}

package/dist/components/TreeSelect/index.d.ts

@@ -0,0 +1,4 @@
+export { TreeSelect } from './TreeSelect';
+export type { TreeNode, TreePath, TreeSelectProps } from './types';
+export { formatBreadcrumb, getNodeByPath } from './tree';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/TreeSelect/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/TreeSelect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC"}

package/dist/components/TreeSelect/tree.d.ts

@@ -0,0 +1,100 @@
+import { ResolvedNode, TreeNode, TreePath } from './types';
+/**
+ * Converts a {@link TreePath} of raw node names to an internal encoded string.
+ * @internal
+ */
+export declare function toInternalPath(segments: TreePath): string;
+/**
+ * Converts an internal encoded path string to a {@link TreePath} of raw node names.
+ * @internal
+ */
+export declare function fromInternalPath(path: string): TreePath;
+/**
+ * Whether a node is selectable given the current mode flags.
+ *
+ * A node is selectable when:
+ * 1. Its `can_select` is not explicitly `false` (defaults to `true`).
+ * 2. If `leavesOnly` is enabled, the node must be a leaf.
+ */
+export declare function isSelectable(node: TreeNode, leavesOnly?: boolean): boolean;
+/**
+ * Recursively resolves a {@link TreeNode} subtree into a parallel
+ * {@link ResolvedNode} tree with pre-computed paths, depths, and
+ * selectability flags.
+ *
+ * @param root The root node of the tree.
+ * @param options.leavesOnly When `true`, branch nodes are marked non-selectable.
+ * @param loadedChildren Cache of asynchronously fetched children, keyed by
+ *   slash-delimited path. When a node has `values: []` and a cache entry
+ *   exists, the cached children are used in place of the empty array.
+ * @returns The resolved root node (callers typically render its `children`).
+ */
+export declare function buildResolvedTree(root: TreeNode, options?: {
+    leavesOnly?: boolean;
+}, loadedChildren?: Map<string, TreeNode[]>): ResolvedNode;
+/**
+ * Filters a resolved tree for a search query, returning a pruned copy of the
+ * tree that contains only:
+ * - Matched nodes (case-insensitive name substring match, any node)
+ * - Every ancestor of a match (force-expanded so the match is visible)
+ * - Siblings of each match (rendered but subtrees pruned)
+ * - Direct children of each match (rendered collapsed)
+ *
+ * Returns `null` when no nodes match the query.
+ */
+export declare function filterTreeForQuery(resolved: ResolvedNode, query: string): {
+    tree: ResolvedNode;
+    forceOpenPaths: Set<string>;
+} | null;
+/**
+ * Resolves a {@link TreePath} back to the corresponding
+ * {@link TreeNode} in the original tree.
+ *
+ * @returns The matching node, or `undefined` if the path doesn't match.
+ *
+ * @example
+ * ```ts
+ * const node = getNodeByPath(root, ["vehicle_type", "car", "make", "Honda"]);
+ * // node?.name === "Honda"
+ * ```
+ */
+export declare function getNodeByPath(root: TreeNode, path: TreePath): TreeNode | undefined;
+/**
+ * Internal variant of {@link getNodeByPath} that accepts an encoded
+ * internal path string. Used by `TreeSelect.tsx` to resolve nodes from
+ * the encoded paths stored on {@link ResolvedNode}.
+ * @internal
+ */
+export declare function getNodeByInternalPath(root: TreeNode, internalPath: string): TreeNode | undefined;
+/**
+ * Returns the parent of an internal encoded path by stripping the last
+ * segment, or `undefined` for root-level paths (single segment).
+ * @internal
+ */
+export declare function getParentPath(path: string): string | undefined;
+/**
+ * Depth-first walk of a resolved tree returning nodes in DOM render order.
+ * Skips the root itself (callers render `root.children`). For each child,
+ * includes the child, then if `isOpen(child.path)` returns true, recurses
+ * into its children. This mirrors exactly what `TreeSelectNode` renders.
+ */
+export declare function flattenVisible(root: ResolvedNode, isOpen: (path: string) => boolean): ResolvedNode[];
+/**
+ * Collects the paths of every non-leaf (branch) node in a resolved tree.
+ * Useful for resolving `defaultExpanded: true` into a concrete set of paths.
+ */
+export declare function collectBranchPaths(root: ResolvedNode): Set<string>;
+/**
+ * Formats a {@link TreePath} as a human-readable breadcrumb string.
+ *
+ * @example
+ * ```ts
+ * formatBreadcrumb(["vehicle_type", "car", "make", "Honda"]);
+ * // "vehicle_type / car / make / Honda"
+ *
+ * formatBreadcrumb(["music", "rock", "AC/DC"]);
+ * // "music / rock / AC/DC"
+ * ```
+ */
+export declare function formatBreadcrumb(path: TreePath): string;
+//# sourceMappingURL=tree.d.ts.map

package/dist/components/TreeSelect/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../../src/components/TreeSelect/tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AA8BhE;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAEvD;AAcD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,UAAQ,GAAG,OAAO,CAIxE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,QAAQ,EACd,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,EACtC,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,GACvC,YAAY,CAyCd;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,MAAM,GACZ;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,CAyE5D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,QAAQ,GACb,QAAQ,GAAG,SAAS,CAatB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,QAAQ,EACd,YAAY,EAAE,MAAM,GACnB,QAAQ,GAAG,SAAS,CAEtB;AAWD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG9D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAChC,YAAY,EAAE,CAiBhB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,CAiBlE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEvD"}

package/dist/components/TreeSelect/types.d.ts

@@ -0,0 +1,163 @@
+import { HTMLAttributes } from 'react';
+import { SelectAnchor } from '../Select';
+import { ZIndex } from '../../types';
+/**
+ * An ordered list of node names from root to the target node.
+ *
+ * Each element is the raw {@link TreeNode.name} — no encoding is needed.
+ * For example, a path to an "AC/DC" node under "rock" under "music"
+ * is simply `["music", "rock", "AC/DC"]`.
+ */
+export type TreePath = readonly string[];
+/**
+ * A node within a tree.
+ *
+ * `values` has three meaningful states:
+ * - `TreeNode[]` (non-empty) — branch with known, loaded children.
+ * - `[]` — branch whose children have not yet been loaded (truncated by
+ *   the source). Renders with a chevron; expanding it triggers
+ *   `loadChildren` (when wired up).
+ * - `undefined` — leaf node; the field is omitted entirely.
+ */
+export interface TreeNode {
+    name: string;
+    description?: string;
+    can_select?: boolean;
+    deprecated?: boolean;
+    values?: TreeNode[];
+}
+/**
+ * Pre-computed representation of a {@link TreeNode} produced by
+ * {@link buildResolvedTree}. Carries the original node plus derived metadata
+ * so the renderer never needs to recompute selectability or paths.
+ */
+export interface ResolvedNode {
+    /** Reference to the original input node. */
+    node: TreeNode;
+    /** Slash-delimited path from the root, e.g. `"car/Honda/model/Civic"`. */
+    path: string;
+    /** Zero-based depth in the tree (root children = 0). */
+    depth: number;
+    /** Whether this node can be selected given current mode flags. */
+    selectable: boolean;
+    /** `true` when the source node has `values: undefined` (a true leaf). */
+    isLeaf: boolean;
+    /**
+     * `true` when the source node has `values: []` (truncated branch) and
+     * no cached children have been loaded for this path yet. Renders as a
+     * branch (chevron visible) with an empty `children` array.
+     */
+    isLazyBranch: boolean;
+    /** Pre-resolved children, in source order. Empty array for leaves and lazy branches. */
+    children: ResolvedNode[];
+    /** 1-based position among siblings (for `aria-posinset`). */
+    posinset: number;
+    /** Total number of siblings including this node (for `aria-setsize`). */
+    setsize: number;
+}
+/**
+ * Props shared by single-select and multi-select modes.
+ */
+interface TreeSelectBaseProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** The root node of the tree. */
+    root: TreeNode;
+    /**
+     * When `true`, only leaf nodes (nodes with no children) are selectable.
+     * Branch nodes still expand/collapse but cannot be picked as values.
+     * @default false
+     */
+    leavesOnly?: boolean;
+    /** If `true`, the entire component is disabled. */
+    disabled?: boolean;
+    /** Placeholder text shown in the input when no value is selected. */
+    placeholder?: string;
+    /**
+     * Position of the dropdown panel relative to the trigger.
+     * Reuses {@link SelectAnchor} for consistency with {@link Select}.
+     */
+    anchor?: SelectAnchor;
+    /**
+     * Renders the dropdown panel in a portal so it escapes overflow-hidden
+     * ancestors. Defaults to `false`.
+     */
+    portal?: boolean;
+    /** Explicit z-index for the dropdown panel. */
+    zIndex?: ZIndex;
+    /**
+     * Maximum height of the dropdown panel. Accepts any valid CSS length value
+     * (e.g. `"400px"`, `"50vh"`). Defaults to `"18rem"` (equivalent to
+     * Tailwind's `max-h-72`).
+     */
+    panelMaxHeight?: string;
+    /**
+     * Custom formatter for the trigger display text when a value is selected.
+     * Receives the selected path (as a {@link TreePath} of raw node names)
+     * and the corresponding {@link TreeNode}.
+     * When omitted, the node name is shown (e.g. `"Civic"`).
+     */
+    displayValue?: (path: TreePath, node: TreeNode) => string;
+    /**
+     * Fetches children for a lazy branch (a node whose `values` is an empty
+     * array). Called exactly once per lazy branch on first user-initiated
+     * expand. Receives a {@link TreePath} of raw node names.
+     * The returned children are spliced into the tree and cached for
+     * the lifetime of `root`. Errors set the branch to an "error" state with
+     * an inline retry control.
+     */
+    loadChildren?: (path: TreePath) => Promise<TreeNode[]>;
+    /**
+     * Branches to expand when the panel first opens. Unlike `forceOpenPaths`
+     * (which prevents collapsing), these paths are user-collapsible and
+     * restored on panel re-open.
+     *
+     * - `TreePath[]` — explicit branch paths (each a {@link TreePath} of
+     *   raw node names) to start expanded.
+     * - `true` — expand every branch in the tree.
+     * - `false` / `undefined` — expand nothing (default).
+     */
+    defaultExpanded?: readonly TreePath[] | boolean;
+}
+/**
+ * Single-select mode (default). `value` is a {@link TreePath} and
+ * `onChange` fires with the selected path or `null` on clear.
+ */
+interface TreeSelectSingleProps extends TreeSelectBaseProps {
+    multiSelect?: false;
+    /**
+     * Currently selected node path as a {@link TreePath} — an ordered array
+     * of raw node names from root to the selected node. No encoding needed.
+     */
+    value?: TreePath;
+    /**
+     * Fires when the user selects or clears a node. The path argument is a
+     * {@link TreePath} of raw node names, or `null` when cleared.
+     */
+    onChange?: (path: TreePath | null) => void;
+}
+/**
+ * Multi-select mode. `value` is an array of {@link TreePath} entries and
+ * `onChange` fires with the full updated array on every toggle.
+ */
+interface TreeSelectMultiProps extends TreeSelectBaseProps {
+    multiSelect: true;
+    /**
+     * Currently selected node paths. Each entry is a {@link TreePath} —
+     * an ordered array of raw node names. No encoding needed.
+     */
+    value?: readonly TreePath[];
+    /**
+     * Fires with the updated array whenever a node is toggled. Each entry
+     * is a {@link TreePath} of raw node names.
+     */
+    onChange?: (paths: TreePath[]) => void;
+}
+/**
+ * Props for {@link TreeSelect}.
+ *
+ * Discriminated on `multiSelect`:
+ * - `multiSelect?: false` (default) — single-select; `value` is `TreePath`, `onChange` fires `TreePath | null`.
+ * - `multiSelect: true` — multi-select; `value` is `readonly TreePath[]`, `onChange` fires `TreePath[]`.
+ */
+export type TreeSelectProps = TreeSelectSingleProps | TreeSelectMultiProps;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/components/TreeSelect/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/TreeSelect/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEtC;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,MAAM,EAAE,CAAC;AAEzC;;;;;;;;;GASG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,IAAI,EAAE,QAAQ,CAAC;IACf,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,UAAU,EAAE,OAAO,CAAC;IACpB,yEAAyE;IACzE,MAAM,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB,wFAAwF;IACxF,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,UAAU,mBAAoB,SAAQ,IAAI,CACxC,cAAc,CAAC,cAAc,CAAC,EAC9B,UAAU,CACX;IACC,iCAAiC;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,KAAK,MAAM,CAAC;IAC1D;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvD;;;;;;;;;OASG;IACH,eAAe,CAAC,EAAE,SAAS,QAAQ,EAAE,GAAG,OAAO,CAAC;CACjD;AAED;;;GAGG;AACH,UAAU,qBAAsB,SAAQ,mBAAmB;IACzD,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,KAAK,IAAI,CAAC;CAC5C;AAED;;;GAGG;AACH,UAAU,oBAAqB,SAAQ,mBAAmB;IACxD,WAAW,EAAE,IAAI,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;CACxC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,qBAAqB,GAAG,oBAAoB,CAAC"}

package/dist/components/index.d.ts

@@ -37,5 +37,6 @@ export * from './Toggle';
 export * from './ToggleSwitch';
 export * from './Toolbar';
 export * from './Tooltip';
+export * from './TreeSelect';
 export * from './UnsetHint';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}