@voxel51/voodo 0.0.30 → 0.0.32

package/dist/util/useResizableDrawer.d.ts

@@ -2,68 +2,46 @@ import { default as React } from 'react';
 import { UseDisclosureOptions, UseDisclosureReturn } from './useDisclosure';
 import { DragAxis } from './useDragDelta';
 export type { DragAxis };
-/**
- * Options for {@link useResizableDrawer}.
- *
- * Extends {@link UseDisclosureOptions} so the drawer's open state can be
- * controlled or uncontrolled in the same way as {@link useDisclosure}.
- */
 export interface UseResizableDrawerOptions extends UseDisclosureOptions {
     /** Axis the drawer resizes along. `"horizontal"` for left/right drawers, `"vertical"` for top/bottom. */
     axis: DragAxis;
-    /** Initial drawer size in pixels, also used as the restore target after closing. */
-    defaultSize: number;
-    /** Minimum drawer size in pixels while open. */
-    minSize: number;
-    /** Maximum drawer size in pixels. */
+    /**
+     * Maximum content-area size in pixels. The header and handle are excluded —
+     * `maxSize` caps only the scrollable body region.
+     */
     maxSize: number;
-    /** Size at which a drag triggers close. Defaults to 0. */
-    closeThreshold?: number;
     /** Flip the delta sign — use for right-side and bottom-side handles. */
     invert?: boolean;
-    /** Invoked with the new size on every drag-induced resize (not on open/close-only changes). */
+    /** Invoked with the new content-area size on every drag-induced resize. */
     onSizeChange?: (size: number) => void;
 }
-/**
- * Return value of {@link useResizableDrawer}. Extends {@link UseDisclosureReturn}
- * with size and drag state.
- */
 export interface UseResizableDrawerReturn extends UseDisclosureReturn {
-    /** Current drawer size in pixels. Reflects the last committed size even while closed. */
+    /** Current content-area size in pixels (0 when closed or not yet measured). */
     size: number;
     /** `true` while the user is actively dragging the resize handle. */
     isDragging: boolean;
+    /**
+     * `true` only when the current size change should be animated — i.e. an
+     * open/close toggle. Content-driven resizes and drags are instant (`false`),
+     * so the size snaps and doesn't fight the header's un-animated layout change.
+     */
+    animating: boolean;
     /** Props to spread onto the drag handle element. */
     dragHandleProps: {
         onPointerDown: (e: React.PointerEvent<HTMLElement>) => void;
         onPointerMove: (e: React.PointerEvent<HTMLElement>) => void;
         onPointerUp: () => void;
     };
+    /**
+     * Attach the size-bearing wrapper's `onTransitionEnd` to this so `animating`
+     * clears when the open/close transition completes.
+     */
+    onTransitionEnd: () => void;
+    /**
+     * Attach to the content element. The hook observes it via ResizeObserver and
+     * keeps the open size equal to `min(contentHeight, maxSize)` automatically.
+     */
+    contentRef: (el: HTMLElement | null) => void;
 }
-/**
- * Hook which models a drawer that can be opened, closed, and resized by
- * dragging a handle.
- *
- * Behavior:
- * - Dragging below `closeThreshold` (default `0`) closes the drawer.
- * - Dragging above `closeThreshold` while closed reopens the drawer.
- * - Sizes are clamped to `[minSize, maxSize]` while open.
- * - `toggle()` restores the last dragged size when reopening.
- *
- * @example
- * ```tsx
- * const { open, size, toggle, dragHandleProps } = useResizableDrawer({
- *   axis: "horizontal",
- *   defaultSize: 320,
- *   minSize: 200,
- *   maxSize: 600,
- * });
- * return (
- *   <aside style={{ width: open ? size : 0 }}>
- *     <div {...dragHandleProps} />
- *   </aside>
- * );
- * ```
- */
-export declare function useResizableDrawer({ axis, defaultSize, minSize, maxSize, closeThreshold, invert, onSizeChange, ...disclosureOptions }: UseResizableDrawerOptions): UseResizableDrawerReturn;
+export declare function useResizableDrawer({ axis, maxSize, invert, onSizeChange, ...disclosureOptions }: UseResizableDrawerOptions): UseResizableDrawerReturn;
 //# sourceMappingURL=useResizableDrawer.d.ts.map

package/dist/util/useResizableDrawer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useResizableDrawer.d.ts","sourceRoot":"","sources":["../../src/util/useResizableDrawer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAwC,MAAM,OAAO,CAAC;AAE7D,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EAEpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAgB,MAAM,gBAAgB,CAAC;AAGxD,YAAY,EAAE,QAAQ,EAAE,CAAC;AAEzB;;;;;GAKG;AACH,MAAM,WAAW,yBAA0B,SAAQ,oBAAoB;IACrE,yGAAyG;IACzG,IAAI,EAAE,QAAQ,CAAC;IACf,oFAAoF;IACpF,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+FAA+F;IAC/F,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACnE,yFAAyF;IACzF,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,UAAU,EAAE,OAAO,CAAC;IACpB,oDAAoD;IACpD,eAAe,EAAE;QACf,aAAa,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;QAC5D,aAAa,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;QAC5D,WAAW,EAAE,MAAM,IAAI,CAAC;KACzB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,IAAI,EACJ,WAAW,EACX,OAAO,EACP,OAAO,EACP,cAAkB,EAClB,MAAc,EACd,YAAY,EACZ,GAAG,iBAAiB,EACrB,EAAE,yBAAyB,GAAG,wBAAwB,CA0EtD"}
+{"version":3,"file":"useResizableDrawer.d.ts","sourceRoot":"","sources":["../../src/util/useResizableDrawer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAyD,MAAM,OAAO,CAAC;AAE9E,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EAEpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAgB,MAAM,gBAAgB,CAAC;AAIxD,YAAY,EAAE,QAAQ,EAAE,CAAC;AAEzB,MAAM,WAAW,yBAA0B,SAAQ,oBAAoB;IACrE,yGAAyG;IACzG,IAAI,EAAE,QAAQ,CAAC;IACf;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACnE,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,UAAU,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,eAAe,EAAE;QACf,aAAa,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;QAC5D,aAAa,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;QAC5D,WAAW,EAAE,MAAM,IAAI,CAAC;KACzB,CAAC;IACF;;;OAGG;IACH,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B;;;OAGG;IACH,UAAU,EAAE,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;CAC9C;AAED,wBAAgB,kBAAkB,CAAC,EACjC,IAAI,EACJ,OAAO,EACP,MAAc,EACd,YAAY,EACZ,GAAG,iBAAiB,EACrB,EAAE,yBAAyB,GAAG,wBAAwB,CAmHtD"}

package/dist/util/useTree.d.ts

@@ -0,0 +1,126 @@
+import { KeyboardEvent } from 'react';
+import { ResolvedNode } from '../components/TreeSelect/types';
+export interface UseTreeOptions {
+    /** Pre-resolved (and optionally pre-filtered) tree. */
+    tree: ResolvedNode;
+    /**
+     * Set of currently selected paths, used for `aria-selected` and `isSelected`.
+     * For single-select, pass a Set with one element. For multi-select, pass
+     * all selected paths. The hook is mode-agnostic.
+     */
+    selection?: Set<string>;
+    /**
+     * Paths that must be treated as expanded regardless of user expansion state
+     * (e.g. ancestors of a search match).
+     */
+    forceOpenPaths?: Set<string>;
+    /** Optional id prefix override; defaults to a `useId()` value. */
+    idPrefix?: string;
+    /** Scroll the active row into view on change. @default true */
+    scrollActiveIntoView?: boolean;
+    /** Fires on selectable row click and Enter on active selectable row. */
+    onSelect?: (path: string) => void;
+    /** Fires on Escape key. */
+    onEscape?: () => void;
+    /**
+     * Fires when a branch is newly opened by user interaction
+     * (`toggleExpand`, `expand`, or ArrowRight). Does **not** fire for paths
+     * opened solely via `forceOpenPaths` (search auto-expand), and fires at
+     * most once per path transition from closed → open.
+     */
+    onExpand?: (path: string) => void;
+    /**
+     * Async load state for lazy branches. Exposed via `getLoadState` so
+     * renderers can show spinners / error icons without direct access to the
+     * map.
+     */
+    loadState?: Map<string, "loading" | "error">;
+    /**
+     * Branches to expand initially. User can still collapse them.
+     * `resetExpansion()` restores this set rather than clearing to empty.
+     *
+     * - `Set<string>` — explicit branch paths.
+     * - `true` — expand every branch in `tree`.
+     * - `false` / `undefined` — expand nothing.
+     */
+    defaultExpanded?: Set<string> | boolean;
+}
+export interface TreeItemProps {
+    id: string;
+    role: "treeitem";
+    "aria-selected": boolean | undefined;
+    "aria-expanded": boolean | undefined;
+    "aria-posinset": number;
+    "aria-setsize": number;
+    tabIndex: -1;
+    "data-active": true | undefined;
+    onClick: () => void;
+    onMouseDown: (e: {
+        preventDefault: () => void;
+    }) => void;
+    onMouseEnter: () => void;
+}
+export interface TreeChevronProps {
+    "aria-expanded": boolean;
+    "aria-label": string;
+    onClick: (e: {
+        stopPropagation: () => void;
+        preventDefault: () => void;
+    }) => void;
+    onPointerDown: (e: {
+        stopPropagation: () => void;
+        preventDefault: () => void;
+    }) => void;
+    onPointerUp: (e: {
+        stopPropagation: () => void;
+        preventDefault: () => void;
+    }) => void;
+}
+export interface UseTreeReturn {
+    /** Flat list of visible nodes in DOM render order. */
+    visibleNodes: ResolvedNode[];
+    /** Set of explicitly expanded paths (excludes forceOpenPaths). */
+    expandedPaths: Set<string>;
+    /** Path of the keyboard-active row, or `null`. */
+    activePath: string | null;
+    /** DOM id of the active row, for `aria-activedescendant`. */
+    activeDescendantId: string | undefined;
+    /** Toggle a branch open/closed. */
+    toggleExpand: (path: string) => void;
+    /** Expand a branch (no-op if already open). */
+    expand: (path: string) => void;
+    /** Collapse a branch (no-op if already closed). */
+    collapse: (path: string) => void;
+    /** Clear all user-expanded paths. */
+    resetExpansion: () => void;
+    /** Set the active (keyboard-highlighted) path. */
+    setActivePath: (path: string | null) => void;
+    /** Spread onto the outer `<div role="treeitem">` wrapper. */
+    getItemProps: (node: ResolvedNode) => TreeItemProps;
+    /** Spread onto the chevron `<button>`. */
+    getChevronProps: (node: ResolvedNode) => TreeChevronProps;
+    /** `onKeyDown` handler for the element that holds virtual focus (e.g. search input). */
+    handleKeyDown: (e: KeyboardEvent) => void;
+    /** Get the DOM id for a given path. */
+    rowId: (path: string) => string;
+    /** Whether a path is effectively open (expanded or force-open). */
+    isOpen: (path: string) => boolean;
+    /** Whether a path is the keyboard-active row. */
+    isActive: (path: string) => boolean;
+    /** Whether a node is the selected value. */
+    isSelected: (node: ResolvedNode) => boolean;
+    /** Whether any descendant of a node is in the current selection. */
+    hasSelectedDescendant: (node: ResolvedNode) => boolean;
+    /** Async load state for a path: `"loading"`, `"error"`, or `undefined`. */
+    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.
+ *
+ * Designed to be consumed by `TreeSelect` and `TreeSelectNode` but generic
+ * enough for any component that renders a tree of `ResolvedNode`s.
+ */
+export declare function useTree(options: UseTreeOptions): UseTreeReturn;
+//# sourceMappingURL=useTree.d.ts.map

package/dist/util/useTree.d.ts.map

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