@voxel51/voodo 0.0.38 → 0.0.40

package/dist/components/Toast/Toast.d.ts

@@ -1,11 +1,12 @@
 import { FC, HTMLAttributes, ReactNode } from 'react';
-import { Anchor, IconName, Variant } from '../../types';
+import { IconProps } from '../Icons';
+import { Anchor, Variant } from '../../types';
 type ToastVariant = Exclude<Variant, Variant.Borderless>;
 export interface ToastProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
     action?: ReactNode;
     anchor?: Anchor;
     description?: ReactNode;
-    icon?: FC | IconName;
+    icon?: FC<IconProps>;
     open?: boolean;
     title?: ReactNode;
     variant?: ToastVariant;
@@ -25,7 +26,7 @@ export interface ToastProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"
  *       open={open}
  *       title="Message sent"
  *       description="You will be notified when the recipient opens your message"
- *       icon={IconName.Check}
+ *       icon={CheckIcon}
  *       action={
  *         <Button onClick={() => setOpen(false)}>
  *           Close
@@ -41,7 +42,7 @@ export interface ToastProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"
  * @param anchor The location in the viewport to anchor the toast. See {@link Anchor}.
  * @param className `class` overrides to apply to the component.
  * @param description Optional content to display in the "description" slot; this should be considered secondary content.
- * @param icon An optional reference ({@link FC}) to an icon or an {@link IconName} to display in the "icon" slot.
+ * @param icon An optional icon component to display in the "icon" slot.
  * @param open If `true`, the toast will be visible; otherwise it will be hidden.
  * @param title Optional content to display in the "title" slot; this should be considered the primary content.
  * @param variant The variant of the toast; this controls icon styling. See {@link Variant}.

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

@@ -1 +1 @@
-{"version":3,"file":"Toast.d.ts","sourceRoot":"","sources":["../../../src/components/Toast/Toast.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAQ3D,OAAO,EAEL,MAAM,EAIN,QAAQ,EAOR,OAAO,EACR,MAAM,SAAS,CAAC;AAGjB,KAAK,YAAY,GAAG,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzD,MAAM,WAAW,UAAW,SAAQ,IAAI,CACtC,cAAc,CAAC,cAAc,CAAC,EAC9B,OAAO,CACR;IACC,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,IAAI,CAAC,EAAE,EAAE,GAAG,QAAQ,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAUD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,KAAK,EAAE,EAAE,CAAC,UAAU,CA0ChC,CAAC"}
+{"version":3,"file":"Toast.d.ts","sourceRoot":"","sources":["../../../src/components/Toast/Toast.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE3D,OAAO,EAAE,KAAK,SAAS,EAAe,MAAM,oBAAoB,CAAC;AAMjE,OAAO,EAEL,MAAM,EAUN,OAAO,EACR,MAAM,SAAS,CAAC;AAGjB,KAAK,YAAY,GAAG,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzD,MAAM,WAAW,UAAW,SAAQ,IAAI,CACtC,cAAc,CAAC,cAAc,CAAC,EAC9B,OAAO,CACR;IACC,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,IAAI,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAUD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,KAAK,EAAE,EAAE,CAAC,UAAU,CA0ChC,CAAC"}

package/dist/components/Tooltip/Tooltip.d.ts

@@ -22,7 +22,9 @@ export interface TooltipProps extends Omit<HTMLAttributes<HTMLDivElement>, "cont
  * @param content The content of the tooltip.
  * @param children The content which this component wraps; this acts as the element anchor and the hover trigger.
  * @param className `class` overrides to apply to the tooltip panel.
- * @param portal If `true`, renders the tooltip via a React portal so it escapes overflow-hidden ancestors.
+ * @param portal If `true`, renders the tooltip via a React portal into `document.body` with an
+ * above-modal z-index, so it escapes ancestor stacking contexts (e.g. inside modals). The default
+ * tooltip already uses fixed positioning, so it is never clipped by overflow-hidden/scroll ancestors.
  * @param shadow The shadow to apply to the tooltip. See {@link Shadow}.
  * @param wrapperClassName Additional classes to apply to the outer wrapper element.
  * @param props Additional HTML properties to apply to the component.

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

@@ -1 +1 @@
-{"version":3,"file":"Tooltip.d.ts","sourceRoot":"","sources":["../../../src/components/Tooltip/Tooltip.tsx"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,EAAE,EACP,KAAK,cAAc,EACnB,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAKf,OAAO,EACL,MAAM,EAMN,MAAM,EAKP,MAAM,SAAS,CAAC;AAGjB,MAAM,MAAM,aAAa,GAAG,OAAO,CACjC,MAAM,EACN,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CACxD,CAAC;AAEF,MAAM,WAAW,YAAa,SAAQ,IAAI,CACxC,cAAc,CAAC,cAAc,CAAC,EAC9B,SAAS,CACV;IACC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AA4ED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,OAAO,EAAE,EAAE,CAAC,YAAY,CAiFpC,CAAC"}
+{"version":3,"file":"Tooltip.d.ts","sourceRoot":"","sources":["../../../src/components/Tooltip/Tooltip.tsx"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,EAAE,EACP,KAAK,cAAc,EACnB,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAKf,OAAO,EACL,MAAM,EAMN,MAAM,EAKP,MAAM,SAAS,CAAC;AAGjB,MAAM,MAAM,aAAa,GAAG,OAAO,CACjC,MAAM,EACN,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CACxD,CAAC;AAEF,MAAM,WAAW,YAAa,SAAQ,IAAI,CACxC,cAAc,CAAC,cAAc,CAAC,EAC9B,SAAS,CACV;IACC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAkED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,OAAO,EAAE,EAAE,CAAC,YAAY,CAoFpC,CAAC"}

package/dist/components/Tree/TreeBody.d.ts

@@ -0,0 +1,37 @@
+import { FC, RefObject } from 'react';
+import { RenderTreeLabel } from './types';
+import { UseTreeReturn } from './useTree';
+export interface TreeBodyProps {
+    tree: UseTreeReturn;
+    query: string;
+    onQueryChange: (q: string) => void;
+    debouncedQuery: string;
+    filteredTree: boolean;
+    multiSelect?: boolean;
+    onRetryLoad?: (path: string) => void;
+    searchInputRef: RefObject<HTMLInputElement | null>;
+    /** When false, the search input is hidden and the wrapper becomes the keyboard focus target. */
+    showSearch?: boolean;
+    /**
+     * When `true`, hovering the tree focuses the search input (or wrapper)
+     * so keyboard navigation works without a click. Only safe inside a
+     * transient surface like the TreeSelect dropdown — an embedded TreeView
+     * must not steal focus from the rest of the page. When `false`, hover
+     * only retargets focus that is already inside the tree.
+     * @default false
+     */
+    focusOnHover?: boolean;
+    /** Custom label renderer forwarded to each {@link TreeItem}. */
+    renderLabel?: RenderTreeLabel;
+    className?: string;
+}
+/**
+ * Shared tree rendering body: virtualizer + optional search input + empty state.
+ *
+ * Owns no chrome (border, shadow, z-index, portal). The parent
+ * (`TreeSelectPanel` or `TreeView`) provides that.
+ *
+ * @internal Shared by TreeSelectPanel and TreeView.
+ */
+export declare const TreeBody: FC<TreeBodyProps>;
+//# sourceMappingURL=TreeBody.d.ts.map

package/dist/components/Tree/TreeBody.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeBody.d.ts","sourceRoot":"","sources":["../../../src/components/Tree/TreeBody.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,SAAS,EAAkC,MAAM,OAAO,CAAC;AAShF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAK/C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,cAAc,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACnD,gGAAgG;IAChG,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gEAAgE;IAChE,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,EAAE,EAAE,CAAC,aAAa,CA2HtC,CAAC"}

package/dist/components/{TreeSelect/TreeSelectNode.d.ts → Tree/TreeItem.d.ts}

@@ -1,12 +1,13 @@
 import { FC } from 'react';
-import { UseTreeReturn } from '../../util/useTree';
-import { ResolvedNode } from './types';
-export interface TreeSelectNodeProps {
+import { RenderTreeLabel, ResolvedNode } from './types';
+import { UseTreeReturn } from './useTree';
+export interface TreeItemViewProps {
     resolved: ResolvedNode;
     tree: UseTreeReturn;
     query?: string;
     multiSelect?: boolean;
     onRetryLoad?: (path: string) => void;
+    renderLabel?: RenderTreeLabel;
 }
 /**
  * Renders a single node row. The parent renders a flat list of all visible
@@ -15,7 +16,7 @@ export interface TreeSelectNodeProps {
  * All state is driven by the `tree` hook — this component is purely
  * presentational.
  *
- * @internal For use by TreeSelectPanel.
+ * @internal Shared by TreeSelectPanel and TreeBody.
  */
-export declare const TreeSelectNode: FC<TreeSelectNodeProps>;
-//# sourceMappingURL=TreeSelectNode.d.ts.map
+export declare const TreeItem: FC<TreeItemViewProps>;
+//# sourceMappingURL=TreeItem.d.ts.map

package/dist/components/Tree/TreeItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeItem.d.ts","sourceRoot":"","sources":["../../../src/components/Tree/TreeItem.tsx"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,EAAE,EAAE,MAAM,OAAO,CAAC;AA0BvC,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAI/C,MAAM,WAAW,iBAAiB;IAChC,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;IACrC,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAqBD;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,EAAE,EAAE,CAAC,iBAAiB,CA0K1C,CAAC"}

package/dist/components/{TreeSelect/TreeSelectSearchInput.d.ts → Tree/TreeSearchInput.d.ts}

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

package/dist/components/Tree/TreeSearchInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeSearchInput.d.ts","sourceRoot":"","sources":["../../../src/components/Tree/TreeSearchInput.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,aAAa,EAAE,KAAK,GAAG,EAAE,MAAM,OAAO,CAAC;AAgB9D,MAAM,WAAW,oBAAoB;IACnC,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,eAAe,EAAE,EAAE,CAAC,oBAAoB,CA6DpD,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"TreeSelect.d.ts","sourceRoot":"","sources":["../../../src/components/Tree/TreeSelect.tsx"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,EAAE,EAAoC,MAAM,OAAO,CAAC;AAYlE,OAAO,KAAK,EAAY,eAAe,EAAE,MAAM,SAAS,CAAC;AAYzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,UAAU,EAAE,EAAE,CAAC,eAAe,CA4M1C,CAAC"}

package/dist/components/{TreeSelect → Tree}/TreeSelectPanel.d.ts

@@ -1,6 +1,6 @@
 import { CSSProperties, FC, RefObject } from 'react';
 import { ZIndex } from '../../types';
-import { UseTreeReturn } from '../../util/useTree';
+import { UseTreeReturn } from './useTree';
 export interface TreeSelectPanelProps {
     floatingRef: (node: HTMLElement | null) => void;
     floatingStyles: CSSProperties;
@@ -17,5 +17,12 @@ export interface TreeSelectPanelProps {
     onRetryLoad?: (path: string) => void;
     panelMaxHeight?: string;
 }
+/**
+ * Floating panel for TreeSelect. Provides the dropdown shell (border,
+ * shadow, z-index, portal, max-height) and delegates the tree body
+ * rendering to {@link TreeBody}.
+ *
+ * @internal For use by TreeSelect.
+ */
 export declare const TreeSelectPanel: FC<TreeSelectPanelProps>;
 //# sourceMappingURL=TreeSelectPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TreeSelectPanel.d.ts","sourceRoot":"","sources":["../../../src/components/Tree/TreeSelectPanel.tsx"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,EAAE,EAGP,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAIf,OAAO,EAOL,MAAM,EAEP,MAAM,SAAS,CAAC;AAIjB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAyB/C,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;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,EAAE,EAAE,CAAC,oBAAoB,CAkDpD,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"TreeSelectTrigger.d.ts","sourceRoot":"","sources":["../../../src/components/Tree/TreeSelectTrigger.tsx"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,EAAE,EAAY,MAAM,OAAO,CAAC;AAiBjD,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;AA2DD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,EAAE,CAAC,sBAAsB,CAsGxD,CAAC"}

package/dist/components/Tree/TreeView.d.ts

@@ -0,0 +1,32 @@
+import { FC } from 'react';
+import { TreeViewProps } from './types';
+/**
+ * A tree-shaped navigation or selection component. Drop it into a sidebar,
+ * panel, or inline layout.
+ *
+ * Supports three modes via the `selectable` prop:
+ * - **Navigate (default)**: clicking a leaf fires `onChange` with the
+ *   path; clicking a branch toggles expansion. No selection state is
+ *   tracked, no checkboxes, no "selected" highlight.
+ * - **Single-select** (`selectable={true}`): same as TreeSelect's
+ *   single-select but always visible.
+ * - **Multi-select** (`selectable={true} multiSelect={true}`): same as
+ *   TreeSelect's multi-select but always visible.
+ *
+ * @example
+ * ```tsx
+ * <TreeView root={tree} onChange={(path) => navigate(path)} />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * <TreeView
+ *   root={tree}
+ *   selectable
+ *   value={selected}
+ *   onChange={(path) => setSelected(path ?? undefined)}
+ * />
+ * ```
+ */
+export declare const TreeView: FC<TreeViewProps>;
+//# sourceMappingURL=TreeView.d.ts.map

package/dist/components/Tree/TreeView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeView.d.ts","sourceRoot":"","sources":["../../../src/components/Tree/TreeView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAe,MAAM,OAAO,CAAC;AAO7C,OAAO,KAAK,EAAY,aAAa,EAAE,MAAM,SAAS,CAAC;AAGvD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,QAAQ,EAAE,EAAE,CAAC,aAAa,CAqFtC,CAAC"}

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

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

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

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

package/dist/components/{TreeSelect → Tree}/tree.d.ts

@@ -76,7 +76,7 @@ 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.
+ * into its children. This mirrors exactly what `TreeItem` renders.
  */
 export declare function flattenVisible(root: ResolvedNode, isOpen: (path: string) => boolean): ResolvedNode[];
 /**

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

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../../src/components/Tree/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 → Tree}/types.d.ts

@@ -1,4 +1,4 @@
-import { HTMLAttributes } from 'react';
+import { HTMLAttributes, ReactNode } from 'react';
 import { SelectAnchor } from '../Select';
 import { ZIndex } from '../../types';
 /**
@@ -56,9 +56,9 @@ export interface ResolvedNode {
     setsize: number;
 }
 /**
- * Props shared by single-select and multi-select modes.
+ * Data-layer props shared by all tree consumers (`TreeSelect` and `TreeView`).
  */
-interface TreeSelectBaseProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
+export interface TreeDataProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
     /** The root node of the tree. */
     root: TreeNode;
     /**
@@ -67,6 +67,31 @@ interface TreeSelectBaseProps extends Omit<HTMLAttributes<HTMLDivElement>, "onCh
      * @default false
      */
     leavesOnly?: boolean;
+    /**
+     * 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 component first renders (or when the
+     * TreeSelect panel first opens). These paths are user-collapsible and
+     * restored on panel re-open (TreeSelect) or component remount (TreeView).
+     *
+     * - `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;
+}
+/**
+ * UI props specific to TreeSelect (trigger + floating panel).
+ */
+interface TreeSelectUIProps {
     /** If `true`, the entire component is disabled. */
     disabled?: boolean;
     /** Placeholder text shown in the input when no value is selected. */
@@ -96,32 +121,10 @@ interface TreeSelectBaseProps extends Omit<HTMLAttributes<HTMLDivElement>, "onCh
      * 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 {
+interface TreeSelectBaseProps extends TreeDataProps, TreeSelectUIProps {
+}
+interface TreeSingleSelection {
     multiSelect?: false;
     /**
      * Currently selected node path as a {@link TreePath} — an ordered array
@@ -134,11 +137,7 @@ interface TreeSelectSingleProps extends TreeSelectBaseProps {
      */
     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 {
+interface TreeMultiSelection {
     multiSelect: true;
     /**
      * Currently selected node paths. Each entry is a {@link TreePath} —
@@ -158,6 +157,72 @@ interface TreeSelectMultiProps extends TreeSelectBaseProps {
  * - `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 type TreeSelectProps = (TreeSelectBaseProps & TreeSingleSelection) | (TreeSelectBaseProps & TreeMultiSelection);
+/**
+ * Custom renderer for a row's label content in {@link TreeView}.
+ *
+ * Receives the source node, its {@link TreePath}, and the default label
+ * element (the node name with search-match highlighting applied). The
+ * returned content replaces only the name text — chevron, checkbox, and
+ * `description` rendering are unaffected. The custom content is wrapped in
+ * a flex-1 container, so trailing content (e.g. a count) can be
+ * right-aligned with `justify-between`.
+ */
+export type RenderTreeLabel = (node: TreeNode, path: TreePath, defaultLabel: ReactNode) => ReactNode;
+interface TreeViewSharedProps extends TreeDataProps {
+    /**
+     * Custom renderer for each row's label content. See
+     * {@link RenderTreeLabel}. When omitted, the node name is rendered with
+     * search-match highlighting.
+     */
+    renderLabel?: RenderTreeLabel;
+    /** Show the built-in search input. @default true */
+    showSearch?: boolean;
+    /**
+     * Controlled search query. When provided, `onQueryChange` is required
+     * and the built-in search input is hidden — the consumer renders their
+     * own search UI.
+     */
+    query?: string;
+    /** Required when `query` is controlled. */
+    onQueryChange?: (q: string) => void;
+    maxHeight?: string;
+    className?: string;
+}
+/**
+ * Navigation mode (default). `onChange` fires per leaf click; no value is
+ * tracked, no checkboxes, no "selected" highlight. Clicking a branch
+ * toggles its expansion.
+ */
+interface TreeViewNavigateProps extends TreeViewSharedProps {
+    selectable?: false;
+    multiSelect?: never;
+    value?: never;
+    /** Fires when the user clicks a selectable node. */
+    onChange?: (path: TreePath) => void;
+}
+/** Single-select mode. */
+interface TreeViewSingleSelectProps extends TreeViewSharedProps {
+    selectable: true;
+    multiSelect?: false;
+    value?: TreePath;
+    onChange?: (path: TreePath | null) => void;
+}
+/** Multi-select mode. */
+interface TreeViewMultiSelectProps extends TreeViewSharedProps {
+    selectable: true;
+    multiSelect: true;
+    value?: readonly TreePath[];
+    onChange?: (paths: TreePath[]) => void;
+}
+/**
+ * Props for {@link TreeView}.
+ *
+ * Discriminated on `selectable` and `multiSelect`:
+ * - `selectable?: false` (default) — navigation mode; `onChange` fires `TreePath` per click, no selection state tracked.
+ * - `selectable: true, multiSelect?: false` — single-select; `value` is `TreePath`, `onChange` fires `TreePath | null`.
+ * - `selectable: true, multiSelect: true` — multi-select; `value` is `readonly TreePath[]`, `onChange` fires `TreePath[]`.
+ */
+export type TreeViewProps = TreeViewNavigateProps | TreeViewSingleSelectProps | TreeViewMultiSelectProps;
 export {};
 //# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/Tree/types.ts"],"names":[],"mappings":"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"}

package/dist/{util → components/Tree}/useTree.d.ts

@@ -1,5 +1,5 @@
 import { KeyboardEvent } from 'react';
-import { ResolvedNode } from '../components/TreeSelect/types';
+import { ResolvedNode } from './types';
 export interface UseTreeOptions {
     /** Pre-resolved (and optionally pre-filtered) tree. */
     tree: ResolvedNode;
@@ -115,12 +115,19 @@ export interface UseTreeReturn {
     getLoadState: (path: string) => "loading" | "error" | undefined;
 }
 /**
- * Headless hook that manages tree state: expansion, active (keyboard) path,
- * keyboard navigation per WAI-ARIA treeview semantics, ARIA prop generation,
- * and scroll-into-view. Owns no rendering or styling.
+ * **UI mechanics layer** — sits below {@link useTreeViewState} in the stack.
  *
- * Designed to be consumed by `TreeSelect` and `TreeSelectNode` but generic
- * enough for any component that renders a tree of `ResolvedNode`s.
+ * Headless hook that manages pure interaction state: which branches are
+ * expanded, which node has the keyboard cursor (`activePath`), keyboard
+ * navigation per WAI-ARIA treeview semantics, ARIA prop generation, and
+ * scroll-into-view. Owns no data fetching, search, filtering, or selection
+ * values — it operates on a pre-resolved, pre-filtered `ResolvedNode` tree
+ * that the caller is responsible for producing.
+ *
+ * {@link useTreeViewState} calls this hook after handling search, debouncing,
+ * async `loadChildren`, and selection bookkeeping. Neither `TreeSelect` nor
+ * `TreeView` calls `useTree` directly — they receive its return value via
+ * `state.tree` from `useTreeViewState`.
  */
 export declare function useTree(options: UseTreeOptions): UseTreeReturn;
 //# sourceMappingURL=useTree.d.ts.map

package/dist/components/Tree/useTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTree.d.ts","sourceRoot":"","sources":["../../../src/components/Tree/useTree.ts"],"names":[],"mappings":"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"}

package/dist/components/Tree/useTreeViewState.d.ts

@@ -0,0 +1,59 @@
+import { RefObject } from 'react';
+import { TreeNode, TreePath } from './types';
+import { UseTreeReturn } from './useTree';
+export interface UseTreeViewStateOptions {
+    root: TreeNode;
+    multiSelect?: boolean;
+    leavesOnly?: boolean;
+    defaultExpanded?: readonly TreePath[] | boolean;
+    loadChildren?: (path: TreePath) => Promise<TreeNode[]>;
+    value?: TreePath | readonly TreePath[];
+    onChange?: ((p: TreePath | null) => void) | ((p: TreePath[]) => void);
+    onEscape?: () => void;
+    onAfterSelect?: (internalPath: string) => void;
+    /**
+     * When provided, the hook treats query as controlled and skips
+     * internal query state. The consumer must also provide `onQueryChange`.
+     */
+    query?: string;
+    /** Required when `query` is controlled. */
+    onQueryChange?: (q: string) => void;
+    scrollActiveIntoView?: boolean;
+    /**
+     * When `true`, single-select picks reset the search query. Correct for
+     * TreeSelect, where selecting closes the panel and the query is stale on
+     * re-open. Persistent consumers (TreeView) must leave this off: the tree
+     * stays on screen, so wiping the filter — and firing `onQueryChange("")`
+     * behind a controlled-query consumer's back — discards user state.
+     * @default false
+     */
+    clearQueryOnSelect?: boolean;
+}
+export interface UseTreeViewStateReturn {
+    tree: UseTreeReturn;
+    query: string;
+    setQuery: (q: string) => void;
+    debouncedQuery: string;
+    filteredTree: boolean;
+    onRetryLoad: (path: string) => void;
+    searchInputRef: RefObject<HTMLInputElement | null>;
+    clearSelection: () => void;
+}
+/**
+ * **Data layer** — sits above {@link useTree} in the stack.
+ *
+ * Shared data-layer hook for tree components. Manages:
+ * - Search query (internal or controlled) + 200ms debounce
+ * - Async `loadChildren` with loading/error state and retry
+ * - `buildResolvedTree` / `filterTreeForQuery` memoization
+ * - Selection logic (single/multi) with `toInternalPath` encoding
+ * - Wiring into {@link useTree} (the UI mechanics layer below)
+ *
+ * Consumed by both `TreeSelect` and `TreeView`. Each consumer composes
+ * its own UI around the returned `tree` and query state. Neither component
+ * calls `useTree` directly — they receive its return value via `state.tree`.
+ *
+ * @internal
+ */
+export declare function useTreeViewState(options: UseTreeViewStateOptions): UseTreeViewStateReturn;
+//# sourceMappingURL=useTreeViewState.d.ts.map

package/dist/components/Tree/useTreeViewState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTreeViewState.d.ts","sourceRoot":"","sources":["../../../src/components/Tree/useTreeViewState.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AAWf,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,KAAK,aAAa,EAAW,MAAM,WAAW,CAAC;AAExD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,SAAS,QAAQ,EAAE,GAAG,OAAO,CAAC;IAChD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvD,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,QAAQ,EAAE,CAAC;IACvC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC,CAAC;IACtE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,aAAa,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,aAAa,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,cAAc,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACnD,cAAc,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,uBAAuB,GAC/B,sBAAsB,CAoOxB"}

package/dist/components/index.d.ts

@@ -37,6 +37,6 @@ export * from './Toggle';
 export * from './ToggleSwitch';
 export * from './Toolbar';
 export * from './Tooltip';
-export * from './TreeSelect';
+export * from './Tree';
 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,cAAc,CAAC;AAC7B,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,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC"}