@accelint/design-toolkit 9.3.0 → 9.4.0

package/dist/hooks/coordinate-field/use-timeout-cleanup.d.ts

@@ -1,7 +1,39 @@
 //#region src/hooks/coordinate-field/use-timeout-cleanup.d.ts
+/** Return value from the useTimeoutCleanup hook */
 interface UseTimeoutCleanupResult {
+  /** Register a timeout for automatic cleanup on unmount */
   registerTimeout: (timeoutId: NodeJS.Timeout) => void;
 }
+/**
+ * Registers timeouts for automatic cleanup on component unmount
+ *
+ * @example
+ * ```tsx
+ * function ComponentWithTimeouts() {
+ *   const { registerTimeout } = useTimeoutCleanup();
+ *   const [message, setMessage] = useState('');
+ *
+ *   const handleClick = () => {
+ *     setMessage('Saving...');
+ *
+ *     registerTimeout(
+ *       setTimeout(() => {
+ *         setMessage('Saved!');
+ *       }, 1000)
+ *     );
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <Button onPress={handleClick}>Save</Button>
+ *       <span>{message}</span>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @returns {@link UseTimeoutCleanupResult} Timeout registration function.
+ */
 declare function useTimeoutCleanup(): UseTimeoutCleanupResult;
 //#endregion
 export { UseTimeoutCleanupResult, useTimeoutCleanup };

package/dist/hooks/coordinate-field/use-timeout-cleanup.js

@@ -14,6 +14,36 @@
 import { useEffect, useRef } from "react";
 
 //#region src/hooks/coordinate-field/use-timeout-cleanup.ts
+/**
+* Registers timeouts for automatic cleanup on component unmount
+*
+* @example
+* ```tsx
+* function ComponentWithTimeouts() {
+*   const { registerTimeout } = useTimeoutCleanup();
+*   const [message, setMessage] = useState('');
+*
+*   const handleClick = () => {
+*     setMessage('Saving...');
+*
+*     registerTimeout(
+*       setTimeout(() => {
+*         setMessage('Saved!');
+*       }, 1000)
+*     );
+*   };
+*
+*   return (
+*     <div>
+*       <Button onPress={handleClick}>Save</Button>
+*       <span>{message}</span>
+*     </div>
+*   );
+* }
+* ```
+*
+* @returns {@link UseTimeoutCleanupResult} Timeout registration function.
+*/
 function useTimeoutCleanup() {
 	const timeoutIdsRef = useRef(/* @__PURE__ */ new Set());
 	const registerTimeout = (timeoutId) => {

package/dist/hooks/coordinate-field/use-timeout-cleanup.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-timeout-cleanup.js","names":[],"sources":["../../../src/hooks/coordinate-field/use-timeout-cleanup.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { useEffect, useRef } from 'react';\n\nexport interface UseTimeoutCleanupResult {\n  registerTimeout: (timeoutId: NodeJS.Timeout) => void;\n}\n\nexport function useTimeoutCleanup(): UseTimeoutCleanupResult {\n  const timeoutIdsRef = useRef<Set<NodeJS.Timeout>>(new Set());\n\n  const registerTimeout = (timeoutId: NodeJS.Timeout) => {\n    timeoutIdsRef.current.add(timeoutId);\n  };\n\n  useEffect(() => {\n    return () => {\n      timeoutIdsRef.current.forEach(clearTimeout);\n      timeoutIdsRef.current.clear();\n    };\n  }, []);\n\n  return { registerTimeout };\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAkBA,SAAgB,oBAA6C;CAC3D,MAAM,gBAAgB,uBAA4B,IAAI,KAAK,CAAC;CAE5D,MAAM,mBAAmB,cAA8B;AACrD,gBAAc,QAAQ,IAAI,UAAU;;AAGtC,iBAAgB;AACd,eAAa;AACX,iBAAc,QAAQ,QAAQ,aAAa;AAC3C,iBAAc,QAAQ,OAAO;;IAE9B,EAAE,CAAC;AAEN,QAAO,EAAE,iBAAiB"}
+{"version":3,"file":"use-timeout-cleanup.js","names":[],"sources":["../../../src/hooks/coordinate-field/use-timeout-cleanup.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { useEffect, useRef } from 'react';\n\n/** Return value from the useTimeoutCleanup hook */\nexport interface UseTimeoutCleanupResult {\n  /** Register a timeout for automatic cleanup on unmount */\n  registerTimeout: (timeoutId: NodeJS.Timeout) => void;\n}\n\n/**\n * Registers timeouts for automatic cleanup on component unmount\n *\n * @example\n * ```tsx\n * function ComponentWithTimeouts() {\n *   const { registerTimeout } = useTimeoutCleanup();\n *   const [message, setMessage] = useState('');\n *\n *   const handleClick = () => {\n *     setMessage('Saving...');\n *\n *     registerTimeout(\n *       setTimeout(() => {\n *         setMessage('Saved!');\n *       }, 1000)\n *     );\n *   };\n *\n *   return (\n *     <div>\n *       <Button onPress={handleClick}>Save</Button>\n *       <span>{message}</span>\n *     </div>\n *   );\n * }\n * ```\n *\n * @returns {@link UseTimeoutCleanupResult} Timeout registration function.\n */\nexport function useTimeoutCleanup(): UseTimeoutCleanupResult {\n  const timeoutIdsRef = useRef<Set<NodeJS.Timeout>>(new Set());\n\n  const registerTimeout = (timeoutId: NodeJS.Timeout) => {\n    timeoutIdsRef.current.add(timeoutId);\n  };\n\n  useEffect(() => {\n    return () => {\n      timeoutIdsRef.current.forEach(clearTimeout);\n      timeoutIdsRef.current.clear();\n    };\n  }, []);\n\n  return { registerTimeout };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDA,SAAgB,oBAA6C;CAC3D,MAAM,gBAAgB,uBAA4B,IAAI,KAAK,CAAC;CAE5D,MAAM,mBAAmB,cAA8B;AACrD,gBAAc,QAAQ,IAAI,UAAU;;AAGtC,iBAAgB;AACd,eAAa;AACX,iBAAc,QAAQ,QAAQ,aAAa;AAC3C,iBAAc,QAAQ,OAAO;;IAE9B,EAAE,CAAC;AAEN,QAAO,EAAE,iBAAiB"}

package/dist/hooks/use-frame-delay/index.d.ts

@@ -15,6 +15,11 @@ interface UseFrameDelayResult {
  * Useful for deferring expensive renders to allow the browser to paint
  * a loading state first.
  *
+ * @param options - {@link UseFrameDelayOptions}
+ * @param options.frames - Number of animation frames to wait (default: 2).
+ * @param options.onReady - Callback fired when delay completes.
+ * @returns {@link UseFrameDelayResult} Object with isReady boolean.
+ *
  * @example
  * ```tsx
  * // Pattern 1: Reactive

package/dist/hooks/use-frame-delay/index.js

@@ -20,6 +20,11 @@ import { useEffect, useState } from "react";
 * Useful for deferring expensive renders to allow the browser to paint
 * a loading state first.
 *
+* @param options - {@link UseFrameDelayOptions}
+* @param options.frames - Number of animation frames to wait (default: 2).
+* @param options.onReady - Callback fired when delay completes.
+* @returns {@link UseFrameDelayResult} Object with isReady boolean.
+*
 * @example
 * ```tsx
 * // Pattern 1: Reactive

package/dist/hooks/use-frame-delay/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["animationId: number"],"sources":["../../../src/hooks/use-frame-delay/index.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { useEffect, useState } from 'react';\n\nexport interface UseFrameDelayOptions {\n  /** Number of animation frames to wait (default: 2) */\n  frames?: number;\n  /** Callback fired when delay completes */\n  onReady?: () => void;\n}\n\nexport interface UseFrameDelayResult {\n  /** Whether the delay has completed */\n  isReady: boolean;\n}\n\n/**\n * Delays execution by a specified number of animation frames.\n *\n * Useful for deferring expensive renders to allow the browser to paint\n * a loading state first.\n *\n * @example\n * ```tsx\n * // Pattern 1: Reactive\n * function DeferredContent() {\n *   const { isReady } = useFrameDelay();\n *   if (!isReady) return <Fallback />;\n *   return <ExpensiveContent />;\n * }\n *\n * // Pattern 2: Callback\n * function WithCallback() {\n *   const [loaded, setLoaded] = useState(false);\n *   useFrameDelay({ onReady: () => setLoaded(true) });\n *   return loaded ? <Content /> : <Loading />;\n * }\n * ```\n */\nexport function useFrameDelay(\n  options: UseFrameDelayOptions = {},\n): UseFrameDelayResult {\n  const { frames = 2, onReady } = options;\n  const [isReady, setIsReady] = useState(false);\n\n  useEffect(() => {\n    let frameCount = 0;\n    let animationId: number;\n\n    const tick = () => {\n      frameCount++;\n      if (frameCount >= frames) {\n        setIsReady(true);\n        onReady?.();\n      } else {\n        animationId = requestAnimationFrame(tick);\n      }\n    };\n\n    animationId = requestAnimationFrame(tick);\n    return () => cancelAnimationFrame(animationId);\n  }, [frames, onReady]);\n\n  return { isReady };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDA,SAAgB,cACd,UAAgC,EAAE,EACb;CACrB,MAAM,EAAE,SAAS,GAAG,YAAY;CAChC,MAAM,CAAC,SAAS,cAAc,SAAS,MAAM;AAE7C,iBAAgB;EACd,IAAI,aAAa;EACjB,IAAIA;EAEJ,MAAM,aAAa;AACjB;AACA,OAAI,cAAc,QAAQ;AACxB,eAAW,KAAK;AAChB,eAAW;SAEX,eAAc,sBAAsB,KAAK;;AAI7C,gBAAc,sBAAsB,KAAK;AACzC,eAAa,qBAAqB,YAAY;IAC7C,CAAC,QAAQ,QAAQ,CAAC;AAErB,QAAO,EAAE,SAAS"}
+{"version":3,"file":"index.js","names":["animationId: number"],"sources":["../../../src/hooks/use-frame-delay/index.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { useEffect, useState } from 'react';\n\nexport interface UseFrameDelayOptions {\n  /** Number of animation frames to wait (default: 2) */\n  frames?: number;\n  /** Callback fired when delay completes */\n  onReady?: () => void;\n}\n\nexport interface UseFrameDelayResult {\n  /** Whether the delay has completed */\n  isReady: boolean;\n}\n\n/**\n * Delays execution by a specified number of animation frames.\n *\n * Useful for deferring expensive renders to allow the browser to paint\n * a loading state first.\n *\n * @param options - {@link UseFrameDelayOptions}\n * @param options.frames - Number of animation frames to wait (default: 2).\n * @param options.onReady - Callback fired when delay completes.\n * @returns {@link UseFrameDelayResult} Object with isReady boolean.\n *\n * @example\n * ```tsx\n * // Pattern 1: Reactive\n * function DeferredContent() {\n *   const { isReady } = useFrameDelay();\n *   if (!isReady) return <Fallback />;\n *   return <ExpensiveContent />;\n * }\n *\n * // Pattern 2: Callback\n * function WithCallback() {\n *   const [loaded, setLoaded] = useState(false);\n *   useFrameDelay({ onReady: () => setLoaded(true) });\n *   return loaded ? <Content /> : <Loading />;\n * }\n * ```\n */\nexport function useFrameDelay(\n  options: UseFrameDelayOptions = {},\n): UseFrameDelayResult {\n  const { frames = 2, onReady } = options;\n  const [isReady, setIsReady] = useState(false);\n\n  useEffect(() => {\n    let frameCount = 0;\n    let animationId: number;\n\n    const tick = () => {\n      frameCount++;\n      if (frameCount >= frames) {\n        setIsReady(true);\n        onReady?.();\n      } else {\n        animationId = requestAnimationFrame(tick);\n      }\n    };\n\n    animationId = requestAnimationFrame(tick);\n    return () => cancelAnimationFrame(animationId);\n  }, [frames, onReady]);\n\n  return { isReady };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDA,SAAgB,cACd,UAAgC,EAAE,EACb;CACrB,MAAM,EAAE,SAAS,GAAG,YAAY;CAChC,MAAM,CAAC,SAAS,cAAc,SAAS,MAAM;AAE7C,iBAAgB;EACd,IAAI,aAAa;EACjB,IAAIA;EAEJ,MAAM,aAAa;AACjB;AACA,OAAI,cAAc,QAAQ;AACxB,eAAW,KAAK;AAChB,eAAW;SAEX,eAAc,sBAAsB,KAAK;;AAI7C,gBAAc,sBAAsB,KAAK;AACzC,eAAa,qBAAqB,YAAY;IAC7C,CAAC,QAAQ,QAAQ,CAAC;AAErB,QAAO,EAAE,SAAS"}

package/dist/hooks/use-tree/actions/index.d.ts

@@ -22,7 +22,9 @@ import "client-only";
  * Note: each operation returns the whole tree. Future iterations
  * might want to return only the changed portion of the tree.
  *
- * @returns {TreeActions<T>} Object containing all tree manipulation functions
+ * @param options - {@link UseTreeActionsOptions}
+ * @param options.nodes - Current tree nodes to operate on.
+ * @returns {@link TreeActions} Object containing all tree manipulation functions.
  *
  * @example
  * ```tsx
@@ -42,7 +44,7 @@ import "client-only";
  * // Use tree actions
  * const updatedTree = treeActions.insertAfter('child1', [
  *   { key: 'newChild', label: 'New Child' }
- * ]);Type T | undefined is not assignable to type T | undefined. Two different types with this name exist, but they are unrelated.
+ * ]);
  * ```
  */
 declare function useTreeActions<T>({

package/dist/hooks/use-tree/actions/index.js

@@ -26,7 +26,9 @@ import { useUpdateEffect } from "@react-aria/utils";
 * Note: each operation returns the whole tree. Future iterations
 * might want to return only the changed portion of the tree.
 *
-* @returns {TreeActions<T>} Object containing all tree manipulation functions
+* @param options - {@link UseTreeActionsOptions}
+* @param options.nodes - Current tree nodes to operate on.
+* @returns {@link TreeActions} Object containing all tree manipulation functions.
 *
 * @example
 * ```tsx
@@ -46,7 +48,7 @@ import { useUpdateEffect } from "@react-aria/utils";
 * // Use tree actions
 * const updatedTree = treeActions.insertAfter('child1', [
 *   { key: 'newChild', label: 'New Child' }
-* ]);Type T | undefined is not assignable to type T | undefined. Two different types with this name exist, but they are unrelated.
+* ]);
 * ```
 */
 function useTreeActions({ nodes }) {

package/dist/hooks/use-tree/actions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["nodes"],"sources":["../../../../src/hooks/use-tree/actions/index.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { useUpdateEffect } from '@react-aria/utils';\nimport { useRef } from 'react';\nimport { Cache } from './cache';\nimport type { Key } from '@react-types/shared';\nimport type {\n  TreeActions,\n  TreeData,\n  TreeNode,\n  TreeNodeBase,\n  UseTreeActionsOptions,\n} from '../types';\n\n/**\n * Stateless hook that transforms tree data according to actions\n * it takes in nodes and returns a new version of the tree.\n *\n * Note: each operation returns the whole tree. Future iterations\n * might want to return only the changed portion of the tree.\n *\n * @returns {TreeActions<T>} Object containing all tree manipulation functions\n *\n * @example\n * ```tsx\n * const treeActions = useTreeActions({\n *   nodes: [\n *     {\n *       key: 'root',\n *       label: 'Root',\n *       children: [\n *         { key: 'child1', label: 'Child 1' },\n *         { key: 'child2', label: 'Child 2' }\n *       ]\n *     }\n *   ]\n * });\n *\n * // Use tree actions\n * const updatedTree = treeActions.insertAfter('child1', [\n *   { key: 'newChild', label: 'New Child' }\n * ]);Type T | undefined is not assignable to type T | undefined. Two different types with this name exist, but they are unrelated.\n * ```\n */\nexport function useTreeActions<T>({\n  nodes,\n}: UseTreeActionsOptions<T>): TreeActions<T> {\n  const cache = useRef(new Cache<T>(nodes)).current;\n\n  useUpdateEffect(() => {\n    cache.rebuild(nodes);\n  }, [nodes]);\n\n  /** GET NODE **/\n  function getNode(key: Key) {\n    return cache.getNode(key);\n  }\n\n  /** INSERT NODES **/\n  function insertAfter(\n    target: Key | null,\n    nodes: TreeNode<T>[],\n  ): TreeNode<T>[] {\n    cache.addNodes(target, nodes, 'after');\n\n    return cache.toTree(true);\n  }\n\n  function insertBefore(\n    target: Key | null,\n    nodes: TreeNode<T>[],\n  ): TreeNode<T>[] {\n    cache.addNodes(target, nodes, 'before');\n\n    return cache.toTree(true);\n  }\n\n  function insertInto(target: Key | null, nodes: TreeNode<T>[]): TreeNode<T>[] {\n    for (const node of nodes) {\n      cache.insertNode(target, node, 0);\n    }\n\n    return cache.toTree(true);\n  }\n\n  /** MOVE NODES **/\n  function moveAfter(target: Key | null, keys: Set<Key>): TreeNode<T>[] {\n    cache.moveNodes(target, keys, 'after');\n\n    return cache.toTree();\n  }\n\n  function moveBefore(target: Key | null, keys: Set<Key>): TreeNode<T>[] {\n    cache.moveNodes(target, keys, 'before');\n\n    return cache.toTree();\n  }\n\n  function moveInto(target: Key | null, keys: Set<Key>): TreeNode<T>[] {\n    for (const key of keys) {\n      cache.moveNode(target, key, 0);\n    }\n\n    return cache.toTree();\n  }\n\n  /** UPDATE NODES **/\n  function updateNode(\n    key: Key,\n    callback: (node: TreeNodeBase<T>) => TreeNodeBase<T>,\n  ): TreeNode<T>[] {\n    const node = cache.getNode(key);\n\n    cache.setNode(key, callback(node));\n\n    return cache.toTree(true);\n  }\n\n  /** REMOVE NODES **/\n  function remove(keys: Set<Key>): TreeNode<T>[] {\n    for (const key of keys.values()) {\n      cache.deleteNode(key);\n    }\n\n    return cache.toTree(true);\n  }\n\n  /** SELECTION **/\n  function onSelectionChange(keys: Set<Key>): TreeNode<T>[] {\n    unselectAll();\n\n    for (const key of keys) {\n      const node = cache.getNode(key);\n\n      cache.setNode(node.key, {\n        ...node,\n        isSelected: true,\n      });\n    }\n\n    return cache.toTree();\n  }\n\n  function selectAll(): TreeNode<T>[] {\n    cache.setAllNodes({ isSelected: true });\n\n    return cache.toTree();\n  }\n\n  function unselectAll(): TreeNode<T>[] {\n    cache.setAllNodes({ isSelected: false });\n\n    return cache.toTree();\n  }\n\n  /** EXPANSION **/\n  function onExpandedChange(keys: Set<Key>): TreeNode<T>[] {\n    collapseAll();\n\n    for (const key of keys) {\n      const node = cache.getNode(key);\n\n      cache.setNode(node.key, {\n        ...node,\n        isExpanded: true,\n      });\n    }\n\n    return cache.toTree();\n  }\n\n  function expandAll(): TreeNode<T>[] {\n    cache.setAllNodes({ isExpanded: true });\n\n    return cache.toTree();\n  }\n\n  function collapseAll(): TreeNode<T>[] {\n    cache.setAllNodes({ isExpanded: false });\n\n    return cache.toTree();\n  }\n\n  /** VISIBILITY **/\n  function onVisibilityChange(keys: Set<Key>): TreeData<T> {\n    hideAll();\n\n    for (const key of keys) {\n      const node = cache.getNode(key);\n      cache.setNode(node.key, {\n        ...node,\n        isVisible: true,\n      });\n    }\n    return cache.toTree(true);\n  }\n\n  function revealAll(): TreeNode<T>[] {\n    cache.setAllNodes({ isVisible: true });\n\n    return cache.toTree(true);\n  }\n\n  function hideAll(): TreeNode<T>[] {\n    cache.setAllNodes({ isVisible: false });\n\n    return cache.toTree(true);\n  }\n\n  return {\n    getNode,\n    insertAfter,\n    insertBefore,\n    insertInto,\n    moveAfter,\n    moveBefore,\n    moveInto,\n    remove,\n    updateNode,\n\n    // Expansion\n    collapseAll,\n    expandAll,\n    onExpandedChange,\n\n    // Selection\n    selectAll,\n    unselectAll,\n    onSelectionChange,\n\n    // Visibility\n    hideAll,\n    revealAll,\n    onVisibilityChange,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["nodes"],"sources":["../../../../src/hooks/use-tree/actions/index.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { useUpdateEffect } from '@react-aria/utils';\nimport { useRef } from 'react';\nimport { Cache } from './cache';\nimport type { Key } from '@react-types/shared';\nimport type {\n  TreeActions,\n  TreeData,\n  TreeNode,\n  TreeNodeBase,\n  UseTreeActionsOptions,\n} from '../types';\n\n/**\n * Stateless hook that transforms tree data according to actions\n * it takes in nodes and returns a new version of the tree.\n *\n * Note: each operation returns the whole tree. Future iterations\n * might want to return only the changed portion of the tree.\n *\n * @param options - {@link UseTreeActionsOptions}\n * @param options.nodes - Current tree nodes to operate on.\n * @returns {@link TreeActions} Object containing all tree manipulation functions.\n *\n * @example\n * ```tsx\n * const treeActions = useTreeActions({\n *   nodes: [\n *     {\n *       key: 'root',\n *       label: 'Root',\n *       children: [\n *         { key: 'child1', label: 'Child 1' },\n *         { key: 'child2', label: 'Child 2' }\n *       ]\n *     }\n *   ]\n * });\n *\n * // Use tree actions\n * const updatedTree = treeActions.insertAfter('child1', [\n *   { key: 'newChild', label: 'New Child' }\n * ]);\n * ```\n */\nexport function useTreeActions<T>({\n  nodes,\n}: UseTreeActionsOptions<T>): TreeActions<T> {\n  const cache = useRef(new Cache<T>(nodes)).current;\n\n  useUpdateEffect(() => {\n    cache.rebuild(nodes);\n  }, [nodes]);\n\n  /** GET NODE **/\n  function getNode(key: Key) {\n    return cache.getNode(key);\n  }\n\n  /** INSERT NODES **/\n  function insertAfter(\n    target: Key | null,\n    nodes: TreeNode<T>[],\n  ): TreeNode<T>[] {\n    cache.addNodes(target, nodes, 'after');\n\n    return cache.toTree(true);\n  }\n\n  function insertBefore(\n    target: Key | null,\n    nodes: TreeNode<T>[],\n  ): TreeNode<T>[] {\n    cache.addNodes(target, nodes, 'before');\n\n    return cache.toTree(true);\n  }\n\n  function insertInto(target: Key | null, nodes: TreeNode<T>[]): TreeNode<T>[] {\n    for (const node of nodes) {\n      cache.insertNode(target, node, 0);\n    }\n\n    return cache.toTree(true);\n  }\n\n  /** MOVE NODES **/\n  function moveAfter(target: Key | null, keys: Set<Key>): TreeNode<T>[] {\n    cache.moveNodes(target, keys, 'after');\n\n    return cache.toTree();\n  }\n\n  function moveBefore(target: Key | null, keys: Set<Key>): TreeNode<T>[] {\n    cache.moveNodes(target, keys, 'before');\n\n    return cache.toTree();\n  }\n\n  function moveInto(target: Key | null, keys: Set<Key>): TreeNode<T>[] {\n    for (const key of keys) {\n      cache.moveNode(target, key, 0);\n    }\n\n    return cache.toTree();\n  }\n\n  /** UPDATE NODES **/\n  function updateNode(\n    key: Key,\n    callback: (node: TreeNodeBase<T>) => TreeNodeBase<T>,\n  ): TreeNode<T>[] {\n    const node = cache.getNode(key);\n\n    cache.setNode(key, callback(node));\n\n    return cache.toTree(true);\n  }\n\n  /** REMOVE NODES **/\n  function remove(keys: Set<Key>): TreeNode<T>[] {\n    for (const key of keys.values()) {\n      cache.deleteNode(key);\n    }\n\n    return cache.toTree(true);\n  }\n\n  /** SELECTION **/\n  function onSelectionChange(keys: Set<Key>): TreeNode<T>[] {\n    unselectAll();\n\n    for (const key of keys) {\n      const node = cache.getNode(key);\n\n      cache.setNode(node.key, {\n        ...node,\n        isSelected: true,\n      });\n    }\n\n    return cache.toTree();\n  }\n\n  function selectAll(): TreeNode<T>[] {\n    cache.setAllNodes({ isSelected: true });\n\n    return cache.toTree();\n  }\n\n  function unselectAll(): TreeNode<T>[] {\n    cache.setAllNodes({ isSelected: false });\n\n    return cache.toTree();\n  }\n\n  /** EXPANSION **/\n  function onExpandedChange(keys: Set<Key>): TreeNode<T>[] {\n    collapseAll();\n\n    for (const key of keys) {\n      const node = cache.getNode(key);\n\n      cache.setNode(node.key, {\n        ...node,\n        isExpanded: true,\n      });\n    }\n\n    return cache.toTree();\n  }\n\n  function expandAll(): TreeNode<T>[] {\n    cache.setAllNodes({ isExpanded: true });\n\n    return cache.toTree();\n  }\n\n  function collapseAll(): TreeNode<T>[] {\n    cache.setAllNodes({ isExpanded: false });\n\n    return cache.toTree();\n  }\n\n  /** VISIBILITY **/\n  function onVisibilityChange(keys: Set<Key>): TreeData<T> {\n    hideAll();\n\n    for (const key of keys) {\n      const node = cache.getNode(key);\n      cache.setNode(node.key, {\n        ...node,\n        isVisible: true,\n      });\n    }\n    return cache.toTree(true);\n  }\n\n  function revealAll(): TreeNode<T>[] {\n    cache.setAllNodes({ isVisible: true });\n\n    return cache.toTree(true);\n  }\n\n  function hideAll(): TreeNode<T>[] {\n    cache.setAllNodes({ isVisible: false });\n\n    return cache.toTree(true);\n  }\n\n  return {\n    getNode,\n    insertAfter,\n    insertBefore,\n    insertInto,\n    moveAfter,\n    moveBefore,\n    moveInto,\n    remove,\n    updateNode,\n\n    // Expansion\n    collapseAll,\n    expandAll,\n    onExpandedChange,\n\n    // Selection\n    selectAll,\n    unselectAll,\n    onSelectionChange,\n\n    // Visibility\n    hideAll,\n    revealAll,\n    onVisibilityChange,\n  };\n}\n"],"mappings":"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"}

package/dist/hooks/use-tree/state/index.d.ts

@@ -14,6 +14,13 @@ import { UseTreeState, UseTreeStateOptions } from "../types.js";
 import "client-only";
 
 //#region src/hooks/use-tree/state/index.d.ts
+/**
+ * Stateful tree manager with drag-and-drop, selection, expansion, and visibility controls
+ *
+ * @param options - {@link UseTreeStateOptions}
+ * @param options.items - Initial tree node items.
+ * @returns {@link UseTreeState} Tree state, actions, and drag-and-drop configuration.
+ */
 declare function useTreeState<T>({
   items
 }: UseTreeStateOptions<T>): UseTreeState<T>;

package/dist/hooks/use-tree/state/index.js

@@ -19,6 +19,13 @@ import "client-only";
 import { useState } from "react";
 
 //#region src/hooks/use-tree/state/index.ts
+/**
+* Stateful tree manager with drag-and-drop, selection, expansion, and visibility controls
+*
+* @param options - {@link UseTreeStateOptions}
+* @param options.items - Initial tree node items.
+* @returns {@link UseTreeState} Tree state, actions, and drag-and-drop configuration.
+*/
 function useTreeState({ items }) {
 	const [nodes, setNodes] = useState(items);
 	const actions = useTreeActions({ nodes });

package/dist/hooks/use-tree/state/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["dragAndDropConfig: DragAndDropConfig","items"],"sources":["../../../../src/hooks/use-tree/state/index.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { useState } from 'react';\nimport { useTreeActions } from '../actions';\nimport { processDroppedItems } from './utils';\nimport type {\n  DragItem,\n  DroppableCollectionInsertDropEvent,\n  DroppableCollectionOnItemDropEvent,\n  DroppableCollectionReorderEvent,\n  DroppableCollectionRootDropEvent,\n  Key,\n  Selection,\n} from '@react-types/shared';\nimport type {\n  DragAndDropConfig,\n  UseTreeState,\n  UseTreeStateOptions,\n} from '../types';\n\nexport function useTreeState<T>({\n  items,\n}: UseTreeStateOptions<T>): UseTreeState<T> {\n  const [nodes, setNodes] = useState(items);\n  const actions = useTreeActions<T>({ nodes });\n\n  const dragAndDropConfig: DragAndDropConfig = {\n    getItems: (keys: Set<Key>): DragItem[] =>\n      [...keys].map((key) => {\n        const node = actions.getNode(key);\n\n        return {\n          key: `${key}`,\n          'text/plain': JSON.stringify(node),\n        };\n      }),\n    onReorder: (e: DroppableCollectionReorderEvent) => {\n      if (e.target.dropPosition === 'before') {\n        setNodes(actions.moveBefore(e.target.key, e.keys));\n      } else {\n        setNodes(actions.moveAfter(e.target.key, e.keys));\n      }\n    },\n    onInsert: ({ items, target }: DroppableCollectionInsertDropEvent) => {\n      (async () => {\n        const processedItems = await processDroppedItems(\n          items,\n          dragAndDropConfig.acceptedDragTypes ?? [],\n        );\n\n        setNodes(\n          actions.remove(new Set(processedItems.map((item) => item.id))),\n        );\n\n        if (target.dropPosition === 'before') {\n          setNodes(actions.insertBefore(target.key, processedItems));\n        } else if (target.dropPosition === 'after') {\n          setNodes(actions.insertAfter(target.key, processedItems));\n        }\n      })();\n    },\n    onItemDrop: ({ target, items }: DroppableCollectionOnItemDropEvent) => {\n      (async () => {\n        const targetNode = actions.getNode(target.key);\n        const [item] = items;\n\n        if (\n          target.dropPosition === 'on' &&\n          targetNode &&\n          item &&\n          item.kind !== 'directory'\n        ) {\n          const key = await item.getText('key');\n\n          if (key) {\n            setNodes(actions.moveInto(target.key, new Set([key])));\n          }\n        }\n      })();\n    },\n    onRootDrop: ({ items }: DroppableCollectionRootDropEvent) => {\n      (async () => {\n        const processedItems = await processDroppedItems(\n          items,\n          dragAndDropConfig.acceptedDragTypes ?? [],\n        );\n\n        setNodes(\n          actions.remove(new Set(processedItems.map((item) => item.key))),\n        );\n        setNodes(actions.insertAfter(null, processedItems));\n      })();\n    },\n  };\n\n  function collapseAll() {\n    setNodes(actions.collapseAll());\n  }\n\n  function expandAll() {\n    setNodes(actions.expandAll());\n  }\n\n  function onExpandedChange(keys: Set<Key>) {\n    setNodes(actions.onExpandedChange(keys));\n  }\n\n  function selectAll() {\n    setNodes(actions.selectAll());\n  }\n\n  function unselectAll() {\n    setNodes(actions.unselectAll());\n  }\n\n  function onSelectionChange(keys: Selection) {\n    if (keys === 'all') {\n      return selectAll();\n    }\n\n    setNodes(actions.onSelectionChange(keys));\n  }\n\n  function hideAll() {\n    setNodes(actions.hideAll());\n  }\n\n  function revealAll() {\n    setNodes(actions.revealAll());\n  }\n\n  function onVisibilityChange(keys: Set<Key>) {\n    setNodes(actions.onVisibilityChange(keys));\n  }\n\n  return {\n    nodes,\n    actions: {\n      // Expansion\n      collapseAll,\n      expandAll,\n      onExpandedChange,\n\n      // Selection\n      selectAll,\n      unselectAll,\n      onSelectionChange,\n\n      // Visibility\n      hideAll,\n      revealAll,\n      onVisibilityChange,\n    },\n    dragAndDropConfig,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAgCA,SAAgB,aAAgB,EAC9B,SAC0C;CAC1C,MAAM,CAAC,OAAO,YAAY,SAAS,MAAM;CACzC,MAAM,UAAU,eAAkB,EAAE,OAAO,CAAC;CAE5C,MAAMA,oBAAuC;EAC3C,WAAW,SACT,CAAC,GAAG,KAAK,CAAC,KAAK,QAAQ;GACrB,MAAM,OAAO,QAAQ,QAAQ,IAAI;AAEjC,UAAO;IACL,KAAK,GAAG;IACR,cAAc,KAAK,UAAU,KAAK;IACnC;IACD;EACJ,YAAY,MAAuC;AACjD,OAAI,EAAE,OAAO,iBAAiB,SAC5B,UAAS,QAAQ,WAAW,EAAE,OAAO,KAAK,EAAE,KAAK,CAAC;OAElD,UAAS,QAAQ,UAAU,EAAE,OAAO,KAAK,EAAE,KAAK,CAAC;;EAGrD,WAAW,EAAE,gBAAO,aAAiD;AACnE,IAAC,YAAY;IACX,MAAM,iBAAiB,MAAM,oBAC3BC,SACA,kBAAkB,qBAAqB,EAAE,CAC1C;AAED,aACE,QAAQ,OAAO,IAAI,IAAI,eAAe,KAAK,SAAS,KAAK,GAAG,CAAC,CAAC,CAC/D;AAED,QAAI,OAAO,iBAAiB,SAC1B,UAAS,QAAQ,aAAa,OAAO,KAAK,eAAe,CAAC;aACjD,OAAO,iBAAiB,QACjC,UAAS,QAAQ,YAAY,OAAO,KAAK,eAAe,CAAC;OAEzD;;EAEN,aAAa,EAAE,QAAQ,qBAAgD;AACrE,IAAC,YAAY;IACX,MAAM,aAAa,QAAQ,QAAQ,OAAO,IAAI;IAC9C,MAAM,CAAC,QAAQA;AAEf,QACE,OAAO,iBAAiB,QACxB,cACA,QACA,KAAK,SAAS,aACd;KACA,MAAM,MAAM,MAAM,KAAK,QAAQ,MAAM;AAErC,SAAI,IACF,UAAS,QAAQ,SAAS,OAAO,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;;OAGxD;;EAEN,aAAa,EAAE,qBAA8C;AAC3D,IAAC,YAAY;IACX,MAAM,iBAAiB,MAAM,oBAC3BA,SACA,kBAAkB,qBAAqB,EAAE,CAC1C;AAED,aACE,QAAQ,OAAO,IAAI,IAAI,eAAe,KAAK,SAAS,KAAK,IAAI,CAAC,CAAC,CAChE;AACD,aAAS,QAAQ,YAAY,MAAM,eAAe,CAAC;OACjD;;EAEP;CAED,SAAS,cAAc;AACrB,WAAS,QAAQ,aAAa,CAAC;;CAGjC,SAAS,YAAY;AACnB,WAAS,QAAQ,WAAW,CAAC;;CAG/B,SAAS,iBAAiB,MAAgB;AACxC,WAAS,QAAQ,iBAAiB,KAAK,CAAC;;CAG1C,SAAS,YAAY;AACnB,WAAS,QAAQ,WAAW,CAAC;;CAG/B,SAAS,cAAc;AACrB,WAAS,QAAQ,aAAa,CAAC;;CAGjC,SAAS,kBAAkB,MAAiB;AAC1C,MAAI,SAAS,MACX,QAAO,WAAW;AAGpB,WAAS,QAAQ,kBAAkB,KAAK,CAAC;;CAG3C,SAAS,UAAU;AACjB,WAAS,QAAQ,SAAS,CAAC;;CAG7B,SAAS,YAAY;AACnB,WAAS,QAAQ,WAAW,CAAC;;CAG/B,SAAS,mBAAmB,MAAgB;AAC1C,WAAS,QAAQ,mBAAmB,KAAK,CAAC;;AAG5C,QAAO;EACL;EACA,SAAS;GAEP;GACA;GACA;GAGA;GACA;GACA;GAGA;GACA;GACA;GACD;EACD;EACD"}
+{"version":3,"file":"index.js","names":["dragAndDropConfig: DragAndDropConfig","items"],"sources":["../../../../src/hooks/use-tree/state/index.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { useState } from 'react';\nimport { useTreeActions } from '../actions';\nimport { processDroppedItems } from './utils';\nimport type {\n  DragItem,\n  DroppableCollectionInsertDropEvent,\n  DroppableCollectionOnItemDropEvent,\n  DroppableCollectionReorderEvent,\n  DroppableCollectionRootDropEvent,\n  Key,\n  Selection,\n} from '@react-types/shared';\nimport type {\n  DragAndDropConfig,\n  UseTreeState,\n  UseTreeStateOptions,\n} from '../types';\n\n/**\n * Stateful tree manager with drag-and-drop, selection, expansion, and visibility controls\n *\n * @param options - {@link UseTreeStateOptions}\n * @param options.items - Initial tree node items.\n * @returns {@link UseTreeState} Tree state, actions, and drag-and-drop configuration.\n */\nexport function useTreeState<T>({\n  items,\n}: UseTreeStateOptions<T>): UseTreeState<T> {\n  const [nodes, setNodes] = useState(items);\n  const actions = useTreeActions<T>({ nodes });\n\n  const dragAndDropConfig: DragAndDropConfig = {\n    getItems: (keys: Set<Key>): DragItem[] =>\n      [...keys].map((key) => {\n        const node = actions.getNode(key);\n\n        return {\n          key: `${key}`,\n          'text/plain': JSON.stringify(node),\n        };\n      }),\n    onReorder: (e: DroppableCollectionReorderEvent) => {\n      if (e.target.dropPosition === 'before') {\n        setNodes(actions.moveBefore(e.target.key, e.keys));\n      } else {\n        setNodes(actions.moveAfter(e.target.key, e.keys));\n      }\n    },\n    onInsert: ({ items, target }: DroppableCollectionInsertDropEvent) => {\n      (async () => {\n        const processedItems = await processDroppedItems(\n          items,\n          dragAndDropConfig.acceptedDragTypes ?? [],\n        );\n\n        setNodes(\n          actions.remove(new Set(processedItems.map((item) => item.id))),\n        );\n\n        if (target.dropPosition === 'before') {\n          setNodes(actions.insertBefore(target.key, processedItems));\n        } else if (target.dropPosition === 'after') {\n          setNodes(actions.insertAfter(target.key, processedItems));\n        }\n      })();\n    },\n    onItemDrop: ({ target, items }: DroppableCollectionOnItemDropEvent) => {\n      (async () => {\n        const targetNode = actions.getNode(target.key);\n        const [item] = items;\n\n        if (\n          target.dropPosition === 'on' &&\n          targetNode &&\n          item &&\n          item.kind !== 'directory'\n        ) {\n          const key = await item.getText('key');\n\n          if (key) {\n            setNodes(actions.moveInto(target.key, new Set([key])));\n          }\n        }\n      })();\n    },\n    onRootDrop: ({ items }: DroppableCollectionRootDropEvent) => {\n      (async () => {\n        const processedItems = await processDroppedItems(\n          items,\n          dragAndDropConfig.acceptedDragTypes ?? [],\n        );\n\n        setNodes(\n          actions.remove(new Set(processedItems.map((item) => item.key))),\n        );\n        setNodes(actions.insertAfter(null, processedItems));\n      })();\n    },\n  };\n\n  function collapseAll() {\n    setNodes(actions.collapseAll());\n  }\n\n  function expandAll() {\n    setNodes(actions.expandAll());\n  }\n\n  function onExpandedChange(keys: Set<Key>) {\n    setNodes(actions.onExpandedChange(keys));\n  }\n\n  function selectAll() {\n    setNodes(actions.selectAll());\n  }\n\n  function unselectAll() {\n    setNodes(actions.unselectAll());\n  }\n\n  function onSelectionChange(keys: Selection) {\n    if (keys === 'all') {\n      return selectAll();\n    }\n\n    setNodes(actions.onSelectionChange(keys));\n  }\n\n  function hideAll() {\n    setNodes(actions.hideAll());\n  }\n\n  function revealAll() {\n    setNodes(actions.revealAll());\n  }\n\n  function onVisibilityChange(keys: Set<Key>) {\n    setNodes(actions.onVisibilityChange(keys));\n  }\n\n  return {\n    nodes,\n    actions: {\n      // Expansion\n      collapseAll,\n      expandAll,\n      onExpandedChange,\n\n      // Selection\n      selectAll,\n      unselectAll,\n      onSelectionChange,\n\n      // Visibility\n      hideAll,\n      revealAll,\n      onVisibilityChange,\n    },\n    dragAndDropConfig,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,SAAgB,aAAgB,EAC9B,SAC0C;CAC1C,MAAM,CAAC,OAAO,YAAY,SAAS,MAAM;CACzC,MAAM,UAAU,eAAkB,EAAE,OAAO,CAAC;CAE5C,MAAMA,oBAAuC;EAC3C,WAAW,SACT,CAAC,GAAG,KAAK,CAAC,KAAK,QAAQ;GACrB,MAAM,OAAO,QAAQ,QAAQ,IAAI;AAEjC,UAAO;IACL,KAAK,GAAG;IACR,cAAc,KAAK,UAAU,KAAK;IACnC;IACD;EACJ,YAAY,MAAuC;AACjD,OAAI,EAAE,OAAO,iBAAiB,SAC5B,UAAS,QAAQ,WAAW,EAAE,OAAO,KAAK,EAAE,KAAK,CAAC;OAElD,UAAS,QAAQ,UAAU,EAAE,OAAO,KAAK,EAAE,KAAK,CAAC;;EAGrD,WAAW,EAAE,gBAAO,aAAiD;AACnE,IAAC,YAAY;IACX,MAAM,iBAAiB,MAAM,oBAC3BC,SACA,kBAAkB,qBAAqB,EAAE,CAC1C;AAED,aACE,QAAQ,OAAO,IAAI,IAAI,eAAe,KAAK,SAAS,KAAK,GAAG,CAAC,CAAC,CAC/D;AAED,QAAI,OAAO,iBAAiB,SAC1B,UAAS,QAAQ,aAAa,OAAO,KAAK,eAAe,CAAC;aACjD,OAAO,iBAAiB,QACjC,UAAS,QAAQ,YAAY,OAAO,KAAK,eAAe,CAAC;OAEzD;;EAEN,aAAa,EAAE,QAAQ,qBAAgD;AACrE,IAAC,YAAY;IACX,MAAM,aAAa,QAAQ,QAAQ,OAAO,IAAI;IAC9C,MAAM,CAAC,QAAQA;AAEf,QACE,OAAO,iBAAiB,QACxB,cACA,QACA,KAAK,SAAS,aACd;KACA,MAAM,MAAM,MAAM,KAAK,QAAQ,MAAM;AAErC,SAAI,IACF,UAAS,QAAQ,SAAS,OAAO,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;;OAGxD;;EAEN,aAAa,EAAE,qBAA8C;AAC3D,IAAC,YAAY;IACX,MAAM,iBAAiB,MAAM,oBAC3BA,SACA,kBAAkB,qBAAqB,EAAE,CAC1C;AAED,aACE,QAAQ,OAAO,IAAI,IAAI,eAAe,KAAK,SAAS,KAAK,IAAI,CAAC,CAAC,CAChE;AACD,aAAS,QAAQ,YAAY,MAAM,eAAe,CAAC;OACjD;;EAEP;CAED,SAAS,cAAc;AACrB,WAAS,QAAQ,aAAa,CAAC;;CAGjC,SAAS,YAAY;AACnB,WAAS,QAAQ,WAAW,CAAC;;CAG/B,SAAS,iBAAiB,MAAgB;AACxC,WAAS,QAAQ,iBAAiB,KAAK,CAAC;;CAG1C,SAAS,YAAY;AACnB,WAAS,QAAQ,WAAW,CAAC;;CAG/B,SAAS,cAAc;AACrB,WAAS,QAAQ,aAAa,CAAC;;CAGjC,SAAS,kBAAkB,MAAiB;AAC1C,MAAI,SAAS,MACX,QAAO,WAAW;AAGpB,WAAS,QAAQ,kBAAkB,KAAK,CAAC;;CAG3C,SAAS,UAAU;AACjB,WAAS,QAAQ,SAAS,CAAC;;CAG7B,SAAS,YAAY;AACnB,WAAS,QAAQ,WAAW,CAAC;;CAG/B,SAAS,mBAAmB,MAAgB;AAC1C,WAAS,QAAQ,mBAAmB,KAAK,CAAC;;AAG5C,QAAO;EACL;EACA,SAAS;GAEP;GACA;GACA;GAGA;GACA;GACA;GAGA;GACA;GACA;GACD;EACD;EACD"}

package/dist/hooks/use-tree/types.d.ts

@@ -15,7 +15,9 @@ import { DropTarget, Selection } from "react-aria-components";
 import { DragItem, DroppableCollectionInsertDropEvent, DroppableCollectionOnItemDropEvent, DroppableCollectionReorderEvent, DroppableCollectionRootDropEvent, Key as Key$1 } from "@react-types/shared";
 
 //#region src/hooks/use-tree/types.d.ts
+/** Configuration for tree drag-and-drop behavior */
 type DragAndDropConfig = {
+  /** Returns drag items for the given keys */
   getItems: (key: Set<Key$1>) => DragItem[];
   /**
    * Handler that is called when external items are dropped on the droppable collection's root.
@@ -33,8 +35,11 @@ type DragAndDropConfig = {
    * moved to a different parent item within a tree.
    */
   onMove?: (e: DroppableCollectionReorderEvent) => void;
+  /** Custom drag preview renderer */
   renderDragPreview?: (items: DragItem[]) => ReactElement;
+  /** Custom drop indicator renderer */
   renderDropIndicator?: (target: DropTarget) => ReactElement;
+  /** Accepted MIME types for drops */
   acceptedDragTypes?: string[];
   /**
    * Handler that is called when external items are dropped "between" items.
@@ -45,25 +50,40 @@ type DragAndDropConfig = {
    */
   onItemDrop?: (e: DroppableCollectionOnItemDropEvent) => void;
 };
+/** Options for the useTreeState hook */
 type UseTreeStateOptions<T> = {
   /** Initial root items in the tree. If omitted, will return an empty tree. */
   items: TreeNode<T>[];
 };
+/** Return value from the useTreeState hook */
 type UseTreeState<T> = {
+  /** Current tree nodes */
   nodes: TreeNode<T>[];
+  /** Drag-and-drop configuration for the tree */
   dragAndDropConfig: DragAndDropConfig;
+  /** Tree manipulation actions */
   actions: {
+    /** Collapse all nodes */
     collapseAll: () => void;
+    /** Expand all nodes */
     expandAll: () => void;
+    /** Handle expansion state changes */
     onExpandedChange: (keys: Set<Key$1>) => void;
+    /** Select all nodes */
     selectAll: () => void;
+    /** Unselect all nodes */
     unselectAll: () => void;
+    /** Handle selection state changes */
     onSelectionChange: (keys: Selection) => void;
+    /** Hide all nodes */
     hideAll: () => void;
+    /** Reveal all nodes */
     revealAll: () => void;
+    /** Handle visibility state changes */
     onVisibilityChange: (keys: Set<Key$1>) => void;
   };
 };
+/** Array of tree nodes representing tree data */
 type TreeData<T> = TreeNode<T>[];
 /**
  * The TreeNode is a wrapper that describes the relationship of this node
@@ -95,7 +115,9 @@ type TreeNode<T> = TreeNodeBase<T> & {
   /** Children of the tree node. */
   children?: TreeNode<T>[];
 };
+/** Options for the useTreeActions hook */
 type UseTreeActionsOptions<T> = {
+  /** Current tree nodes to operate on */
   nodes: TreeNode<T>[];
 };
 /**

package/dist/index.d.ts

@@ -86,12 +86,12 @@ import { DividerProps } from "./components/divider/types.js";
 import { DividerContext, DividerProvider } from "./components/divider/context.js";
 import { Divider } from "./components/divider/index.js";
 import { DrawerBack } from "./components/drawer/back.js";
-import { DrawerClose } from "./components/drawer/close.js";
-import { DrawerContent } from "./components/drawer/content.js";
 import { ViewStackEventNamespace, ViewStackEventTypes } from "./components/view-stack/events.js";
 import { ViewStackBackEvent, ViewStackClearEvent, ViewStackContextValue, ViewStackEvent, ViewStackProps, ViewStackPushEvent, ViewStackResetEvent, ViewStackTriggerProps, ViewStackViewProps } from "./components/view-stack/types.js";
 import { DrawerEventNamespace, DrawerEventTypes } from "./components/drawer/events.js";
-import { DrawerContextValue, DrawerEvent, DrawerLayoutProps, DrawerMenuItemProps, DrawerMenuProps, DrawerOpenEvent, DrawerProps, DrawerTitleProps, DrawerToggleEvent, DrawerTriggerProps } from "./components/drawer/types.js";
+import { ChainedEvents, DrawerCloseEvent, DrawerCloseProps, DrawerContextValue, DrawerEvent, DrawerLayoutProps, DrawerMenuItemProps, DrawerMenuProps, DrawerOpenEvent, DrawerProps, DrawerTitleProps, DrawerToggleEvent, DrawerTriggerProps, SimpleEvents, TargetedEvents } from "./components/drawer/types.js";
+import { DrawerClose } from "./components/drawer/close.js";
+import { DrawerContent } from "./components/drawer/content.js";
 import { DrawerContext, DrawerEventHandlers, bus, useDrawerEmit } from "./components/drawer/context.js";
 import { DrawerFooter } from "./components/drawer/footer.js";
 import { DrawerHeaderTitle } from "./components/drawer/header-title.js";
@@ -274,4 +274,4 @@ import { useTreeState } from "./hooks/use-tree/state/index.js";
 import { isSlottedContextValue } from "./lib/utils.js";
 import { PortalProvider } from "./providers/portal.js";
 import { ThemeMode, ThemeProvider, useTheme } from "./providers/theme-provider.js";
-export { Accordion, AccordionContext, AccordionGroup, type AccordionGroupProps, AccordionHeader, type AccordionHeaderProps, AccordionPanel, type AccordionPanelProps, type AccordionProps, type AccordionStyleVariants, AccordionTrigger, type AccordionTriggerProps, ActionBar, type ActionBarProps, type AriaAttributes, type AriaAttributesWithRef, Avatar, AvatarContext, type AvatarProps, AvatarProvider, Badge, BadgeContext, type BadgeProps, BadgeProvider, BreadcrumbItem, type BreadcrumbItemProps, Breadcrumbs, Button, ButtonContext, type ButtonProps, ButtonProvider, type ButtonStyleVariants, COORDINATE_EPSILON, COORDINATE_ERROR_MESSAGES, COORDINATE_FORMAT_LABELS, COORDINATE_FORMAT_NAMES, COORDINATE_SYSTEMS, Checkbox, CheckboxContext, CheckboxGroup, CheckboxGroupContext, type CheckboxGroupProps, type CheckboxProps, type ChildrenRenderProps, Chip, ChipContext, type ChipContextValue, ChipList, type ChipListProps, ChipListRenderingContext, type ChipProps, ChipProvider, type ClassNameRenderProps, type ClassNames, ClassificationBadge, ClassificationBadgeContext, type ClassificationBadgeProps, ClassificationBadgeProvider, ClassificationBanner, ClassificationBannerContext, type ClassificationBannerProps, ClassificationBannerProvider, Clock, type ClockProps, CloneAction, ColorPicker, type ColorPickerProps, CombinatorSelector, ComboBoxField, ComboBoxFieldContext, type ComboBoxFieldProps, ComboBoxFieldProvider, CoordinateField, CoordinateFieldContext, type CoordinateFieldProps, CoordinateFieldProvider, type CoordinateFieldState, CoordinateFieldStateContext, CoordinateFieldStateProvider, type CoordinateFormatResult, CoordinateSegment, type CoordinateSegmentProps, type CoordinateSystem, type CoordinateValue, DateField, type DateFieldProps, type DefaultRQBProps, DeferredCollection, type DeferredCollectionProps, DeletableChip, type DeletableChipProps, DetailsList, DetailsListContext, DetailsListLabel, type DetailsListLabelProps, type DetailsListProps, DetailsListProvider, DetailsListValue, type DetailsListValueProps, Dialog, DialogContent, DialogContext, DialogFooter, type DialogProps, DialogTitle, DialogTrigger, type DialogTriggerProps, Divider, DividerContext, type DividerProps, DividerProvider, type DragAndDropConfig, DragContext, Drawer, DrawerBack, DrawerClose, DrawerContent, DrawerContext, type DrawerContextValue, type DrawerEvent, DrawerEventHandlers, DrawerEventNamespace, DrawerEventTypes, DrawerFooter, DrawerHeader, DrawerHeaderTitle, DrawerLayout, DrawerLayoutMain, type DrawerLayoutProps, DrawerMenu, DrawerMenuItem, type DrawerMenuItemProps, type DrawerMenuProps, type DrawerOpenEvent, DrawerPanel, type DrawerProps, type DrawerTitleProps, type DrawerToggleEvent, DrawerTrigger, type DrawerTriggerProps, DrawerView, type DropTargetInfo, EXPECTED_SEGMENT_COUNTS, type Field, Flashcard, FlashcardAdditionalData, type FlashcardComponentProps, FlashcardContext, FlashcardDetailsLabel, FlashcardDetailsList, type FlashcardDetailsListProps, FlashcardDetailsValue, FlashcardHero, type FlashcardProps, GROUP_SEPARATOR, HeaderColumnAction, type HeaderColumnActionKey, Hero, HeroContext, type HeroProps, HeroSubtitle, HeroTitle, Hotkey, HotkeyContext, type HotkeyProps, HotkeyProvider, HotkeySet, Icon, IconContext, type IconProps, IconProvider, Input, InputContext, type InputProps, Kanban, KanbanCard, KanbanCardBody, type KanbanCardData, KanbanCardHeader, KanbanCardHeaderActions, KanbanCardHeaderTitle, type KanbanCardProps, type KanbanColContentActionProps, type KanbanColContentProps, type KanbanColProps, KanbanColumn, KanbanColumnActions, KanbanColumnContainer, KanbanColumnContent, type KanbanColumnData, KanbanColumnHeader, KanbanColumnHeaderActions, KanbanColumnHeaderDragHandle, KanbanColumnHeaderTitle, type KanbanComponentProps, type KanbanContextData, KanbanHeader, KanbanHeaderActions, KanbanHeaderSearch, KanbanHeaderTitle, type KanbanMenuProps, type KanbanProps, KanbanProvider, type KanbanProviderProps, type KanbanSearchProps, Label, LabelContext, type LabelProps, LabelProvider, Lines, type LinesProps, Link, LinkButton, LinkButtonContext, type LinkButtonProps, LinkButtonProvider, type LinkProps, LinkProvider, List, ListContext, ListItem, ListItemContent, type ListItemContentProps, ListItemDescription, type ListItemDescriptionProps, type ListItemProps, ListItemTitle, type ListItemTitleProps, type ListItemVariant, type ListProps, LockAction, Menu, MenuContext, MenuItem, MenuItemDescription, MenuItemLabel, type MenuItemProps, type MenuProps, MenuSection, type MenuSectionProps, MenuSeparator, MenuSubmenu, MenuTrigger, type MoveCard, type MoveCardValidationParams, type MoveCardValidationResult, Notice, type NoticeActionEvent, type NoticeColor, type NoticeContent, type NoticeDequeueEvent, NoticeEventNamespace, NoticeEventTypes, NoticeIcon, type NoticeIconProps, NoticeList, type NoticeListProps, type NoticeProps, type NoticeQueueEvent, Options, OptionsContext, type OptionsDataItem, OptionsItem, OptionsItemContent, OptionsItemDescription, OptionsItemLabel, type OptionsItemProps, type OptionsProps, OptionsSection, type OptionsSectionProps, Pagination, PaginationContext, type PaginationContextValue, PaginationNext, type PaginationNextProps, PaginationPages, type PaginationPagesProps, PaginationPrev, type PaginationPrevProps, type PaginationProps, type ParsedCoordinateMatch, Popover, PopoverContent, PopoverFooter, type PopoverProps, PopoverTitle, PopoverTrigger, type PopoverTriggerProps, PortalProvider, type ProviderProps, QueryBuilder, type QueryBuilderContextType, type QueryBuilderProps, type QueryBuilderValueEditors, Radio, RadioContext, RadioGroup, type RadioGroupProps, type RadioProps, RemoveRuleAction, type RenderProps, type RenderPropsChildren, type RenderPropsClassName, type RenderPropsStyle, type RuleGroupType, SearchField, SearchFieldContext, type SearchFieldProps, SearchFieldProvider, type SegmentConfig, type SegmentType, SelectField, SelectFieldContext, type SelectFieldProps, SelectFieldProvider, SelectableChip, type SelectableChipProps, Sidenav, SidenavAvatar, type SidenavAvatarProps, type SidenavCloseEvent, SidenavContent, type SidenavContentProps, SidenavContext, type SidenavContextValue, type SidenavDividerProps, type SidenavEvent, SidenavEventNamespace, SidenavEventTypes, SidenavFooter, type SidenavFooterProps, SidenavHeader, type SidenavHeaderProps, SidenavItem, type SidenavItemProps, SidenavLink, type SidenavLinkProps, SidenavMenu, SidenavMenuItem, type SidenavMenuItemProps, type SidenavMenuProps, type SidenavOpenEvent, type SidenavProps, type SidenavToggleEvent, SidenavTrigger, type SidenavTriggerProps, Skeleton, type SkeletonProps, Slider, type SliderMarker, type SliderMarkersConfig, type SliderProps, type SlottedValue, SortDirection, type SortDirectionState, type StylePropRenderProps, type StyleRenderProps, Switch, SwitchContext, type SwitchProps, SwitchProvider, Tab, TabList, TabPanel, Table, type TableBodyProps, type TableCellProps, TableContext, type TableContextValue, type TableHeaderCellProps, type TableHeaderProps, type TableProps, type TableRowProps, Tabs, TabsContext, type TabsProps, TabsProvider, TextAreaField, TextAreaFieldContext, type TextAreaFieldProps, TextAreaFieldProvider, TextField, TextFieldContext, type TextFieldProps, TextFieldProvider, type ThemeMode, ThemeProvider, TimeField, type TimeFieldProps, ToggleButton, ToggleButtonContext, type ToggleButtonProps, ToggleButtonProvider, type ToggleButtonStyleVariants, Tooltip, TooltipContext, type TooltipProps, TooltipTrigger, type TooltipTriggerProps, Tree, type TreeActions, TreeContext, type TreeContextValue, type TreeData, TreeItem, TreeItemActions, TreeItemContent, type TreeItemContentProps, type TreeItemContentRenderProps, TreeItemContext, type TreeItemContextValue, TreeItemDescription, TreeItemLabel, TreeItemPrefixIcon, type TreeItemProps, TreeLines, type TreeNode, type TreeNodeBase, type TreeProps, type TreeStyleVariant, type UseCoordinateCopyOptions, type UseCoordinateCopyResult, type UseCoordinateFieldResult, type UseCoordinateFieldStateOptions, type UseCoordinateFieldStateResult, type UseCoordinateFocusOptions, type UseCoordinateFocusResult, type UseCoordinatePasteOptions, type UseCoordinatePasteResult, type UseFrameDelayOptions, type UseFrameDelayResult, type UseTimeoutCleanupResult, type UseTreeActionsOptions, type UseTreeState, type UseTreeStateOptions, ViewStack, type ViewStackBackEvent, type ViewStackClearEvent, ViewStackContext, type ViewStackContextValue, type ViewStackEvent, ViewStackEventHandlers, ViewStackEventNamespace, ViewStackEventTypes, type ViewStackProps, type ViewStackPushEvent, type ViewStackResetEvent, ViewStackTrigger, type ViewStackTriggerProps, ViewStackView, type ViewStackViewProps, areAllSegmentsFilled, areCoordinatesEqual, bus, calculateClosestEdge, columnData, convertDDToDisplaySegments, convertDisplaySegmentsToDD, ddSegmentConfigs, ddmSegmentConfigs, deduplicateMatchesByLocation, dmsSegmentConfigs, formatSegmentsToCoordinateString, getAllCoordinateFormats, getEditableSegmentCount, getFormatDescription, getInsertIndex, getSegmentConfigs, getSegmentLabel, hasAnySegmentValue, headerColumnActionValues, isCompleteCoordinate, isSlottedContextValue, matchesMetadata, mgrsSegmentConfigs, parseCoordinatePaste, parseCoordinateStringToSegments, parseDropTarget, sortDirectionValues, useCardInteractions, useColumnInteractions, useCoordinateCopy, useCoordinateField, useCoordinateFieldState, useCoordinateFieldStateContext, useCoordinateFocus, useCoordinatePaste, useDragContext, useDrawerEmit, useFrameDelay, useKanban, useListItemVariant, useTheme, useTimeoutCleanup, useTreeActions, useTreeState, useViewStackEmit, utmSegmentConfigs, validateCoordinateSegments, validateMoveCard };
+export { Accordion, AccordionContext, AccordionGroup, type AccordionGroupProps, AccordionHeader, type AccordionHeaderProps, AccordionPanel, type AccordionPanelProps, type AccordionProps, type AccordionStyleVariants, AccordionTrigger, type AccordionTriggerProps, ActionBar, type ActionBarProps, type AriaAttributes, type AriaAttributesWithRef, Avatar, AvatarContext, type AvatarProps, AvatarProvider, Badge, BadgeContext, type BadgeProps, BadgeProvider, BreadcrumbItem, type BreadcrumbItemProps, Breadcrumbs, Button, ButtonContext, type ButtonProps, ButtonProvider, type ButtonStyleVariants, COORDINATE_EPSILON, COORDINATE_ERROR_MESSAGES, COORDINATE_FORMAT_LABELS, COORDINATE_FORMAT_NAMES, COORDINATE_SYSTEMS, type ChainedEvents, Checkbox, CheckboxContext, CheckboxGroup, CheckboxGroupContext, type CheckboxGroupProps, type CheckboxProps, type ChildrenRenderProps, Chip, ChipContext, type ChipContextValue, ChipList, type ChipListProps, ChipListRenderingContext, type ChipProps, ChipProvider, type ClassNameRenderProps, type ClassNames, ClassificationBadge, ClassificationBadgeContext, type ClassificationBadgeProps, ClassificationBadgeProvider, ClassificationBanner, ClassificationBannerContext, type ClassificationBannerProps, ClassificationBannerProvider, Clock, type ClockProps, CloneAction, ColorPicker, type ColorPickerProps, CombinatorSelector, ComboBoxField, ComboBoxFieldContext, type ComboBoxFieldProps, ComboBoxFieldProvider, CoordinateField, CoordinateFieldContext, type CoordinateFieldProps, CoordinateFieldProvider, type CoordinateFieldState, CoordinateFieldStateContext, CoordinateFieldStateProvider, type CoordinateFormatResult, CoordinateSegment, type CoordinateSegmentProps, type CoordinateSystem, type CoordinateValue, DateField, type DateFieldProps, type DefaultRQBProps, DeferredCollection, type DeferredCollectionProps, DeletableChip, type DeletableChipProps, DetailsList, DetailsListContext, DetailsListLabel, type DetailsListLabelProps, type DetailsListProps, DetailsListProvider, DetailsListValue, type DetailsListValueProps, Dialog, DialogContent, DialogContext, DialogFooter, type DialogProps, DialogTitle, DialogTrigger, type DialogTriggerProps, Divider, DividerContext, type DividerProps, DividerProvider, type DragAndDropConfig, DragContext, Drawer, DrawerBack, DrawerClose, type DrawerCloseEvent, type DrawerCloseProps, DrawerContent, DrawerContext, type DrawerContextValue, type DrawerEvent, DrawerEventHandlers, DrawerEventNamespace, DrawerEventTypes, DrawerFooter, DrawerHeader, DrawerHeaderTitle, DrawerLayout, DrawerLayoutMain, type DrawerLayoutProps, DrawerMenu, DrawerMenuItem, type DrawerMenuItemProps, type DrawerMenuProps, type DrawerOpenEvent, DrawerPanel, type DrawerProps, type DrawerTitleProps, type DrawerToggleEvent, DrawerTrigger, type DrawerTriggerProps, DrawerView, type DropTargetInfo, EXPECTED_SEGMENT_COUNTS, type Field, Flashcard, FlashcardAdditionalData, type FlashcardComponentProps, FlashcardContext, FlashcardDetailsLabel, FlashcardDetailsList, type FlashcardDetailsListProps, FlashcardDetailsValue, FlashcardHero, type FlashcardProps, GROUP_SEPARATOR, HeaderColumnAction, type HeaderColumnActionKey, Hero, HeroContext, type HeroProps, HeroSubtitle, HeroTitle, Hotkey, HotkeyContext, type HotkeyProps, HotkeyProvider, HotkeySet, Icon, IconContext, type IconProps, IconProvider, Input, InputContext, type InputProps, Kanban, KanbanCard, KanbanCardBody, type KanbanCardData, KanbanCardHeader, KanbanCardHeaderActions, KanbanCardHeaderTitle, type KanbanCardProps, type KanbanColContentActionProps, type KanbanColContentProps, type KanbanColProps, KanbanColumn, KanbanColumnActions, KanbanColumnContainer, KanbanColumnContent, type KanbanColumnData, KanbanColumnHeader, KanbanColumnHeaderActions, KanbanColumnHeaderDragHandle, KanbanColumnHeaderTitle, type KanbanComponentProps, type KanbanContextData, KanbanHeader, KanbanHeaderActions, KanbanHeaderSearch, KanbanHeaderTitle, type KanbanMenuProps, type KanbanProps, KanbanProvider, type KanbanProviderProps, type KanbanSearchProps, Label, LabelContext, type LabelProps, LabelProvider, Lines, type LinesProps, Link, LinkButton, LinkButtonContext, type LinkButtonProps, LinkButtonProvider, type LinkProps, LinkProvider, List, ListContext, ListItem, ListItemContent, type ListItemContentProps, ListItemDescription, type ListItemDescriptionProps, type ListItemProps, ListItemTitle, type ListItemTitleProps, type ListItemVariant, type ListProps, LockAction, Menu, MenuContext, MenuItem, MenuItemDescription, MenuItemLabel, type MenuItemProps, type MenuProps, MenuSection, type MenuSectionProps, MenuSeparator, MenuSubmenu, MenuTrigger, type MoveCard, type MoveCardValidationParams, type MoveCardValidationResult, Notice, type NoticeActionEvent, type NoticeColor, type NoticeContent, type NoticeDequeueEvent, NoticeEventNamespace, NoticeEventTypes, NoticeIcon, type NoticeIconProps, NoticeList, type NoticeListProps, type NoticeProps, type NoticeQueueEvent, Options, OptionsContext, type OptionsDataItem, OptionsItem, OptionsItemContent, OptionsItemDescription, OptionsItemLabel, type OptionsItemProps, type OptionsProps, OptionsSection, type OptionsSectionProps, Pagination, PaginationContext, type PaginationContextValue, PaginationNext, type PaginationNextProps, PaginationPages, type PaginationPagesProps, PaginationPrev, type PaginationPrevProps, type PaginationProps, type ParsedCoordinateMatch, Popover, PopoverContent, PopoverFooter, type PopoverProps, PopoverTitle, PopoverTrigger, type PopoverTriggerProps, PortalProvider, type ProviderProps, QueryBuilder, type QueryBuilderContextType, type QueryBuilderProps, type QueryBuilderValueEditors, Radio, RadioContext, RadioGroup, type RadioGroupProps, type RadioProps, RemoveRuleAction, type RenderProps, type RenderPropsChildren, type RenderPropsClassName, type RenderPropsStyle, type RuleGroupType, SearchField, SearchFieldContext, type SearchFieldProps, SearchFieldProvider, type SegmentConfig, type SegmentType, SelectField, SelectFieldContext, type SelectFieldProps, SelectFieldProvider, SelectableChip, type SelectableChipProps, Sidenav, SidenavAvatar, type SidenavAvatarProps, type SidenavCloseEvent, SidenavContent, type SidenavContentProps, SidenavContext, type SidenavContextValue, type SidenavDividerProps, type SidenavEvent, SidenavEventNamespace, SidenavEventTypes, SidenavFooter, type SidenavFooterProps, SidenavHeader, type SidenavHeaderProps, SidenavItem, type SidenavItemProps, SidenavLink, type SidenavLinkProps, SidenavMenu, SidenavMenuItem, type SidenavMenuItemProps, type SidenavMenuProps, type SidenavOpenEvent, type SidenavProps, type SidenavToggleEvent, SidenavTrigger, type SidenavTriggerProps, type SimpleEvents, Skeleton, type SkeletonProps, Slider, type SliderMarker, type SliderMarkersConfig, type SliderProps, type SlottedValue, SortDirection, type SortDirectionState, type StylePropRenderProps, type StyleRenderProps, Switch, SwitchContext, type SwitchProps, SwitchProvider, Tab, TabList, TabPanel, Table, type TableBodyProps, type TableCellProps, TableContext, type TableContextValue, type TableHeaderCellProps, type TableHeaderProps, type TableProps, type TableRowProps, Tabs, TabsContext, type TabsProps, TabsProvider, type TargetedEvents, TextAreaField, TextAreaFieldContext, type TextAreaFieldProps, TextAreaFieldProvider, TextField, TextFieldContext, type TextFieldProps, TextFieldProvider, type ThemeMode, ThemeProvider, TimeField, type TimeFieldProps, ToggleButton, ToggleButtonContext, type ToggleButtonProps, ToggleButtonProvider, type ToggleButtonStyleVariants, Tooltip, TooltipContext, type TooltipProps, TooltipTrigger, type TooltipTriggerProps, Tree, type TreeActions, TreeContext, type TreeContextValue, type TreeData, TreeItem, TreeItemActions, TreeItemContent, type TreeItemContentProps, type TreeItemContentRenderProps, TreeItemContext, type TreeItemContextValue, TreeItemDescription, TreeItemLabel, TreeItemPrefixIcon, type TreeItemProps, TreeLines, type TreeNode, type TreeNodeBase, type TreeProps, type TreeStyleVariant, type UseCoordinateCopyOptions, type UseCoordinateCopyResult, type UseCoordinateFieldResult, type UseCoordinateFieldStateOptions, type UseCoordinateFieldStateResult, type UseCoordinateFocusOptions, type UseCoordinateFocusResult, type UseCoordinatePasteOptions, type UseCoordinatePasteResult, type UseFrameDelayOptions, type UseFrameDelayResult, type UseTimeoutCleanupResult, type UseTreeActionsOptions, type UseTreeState, type UseTreeStateOptions, ViewStack, type ViewStackBackEvent, type ViewStackClearEvent, ViewStackContext, type ViewStackContextValue, type ViewStackEvent, ViewStackEventHandlers, ViewStackEventNamespace, ViewStackEventTypes, type ViewStackProps, type ViewStackPushEvent, type ViewStackResetEvent, ViewStackTrigger, type ViewStackTriggerProps, ViewStackView, type ViewStackViewProps, areAllSegmentsFilled, areCoordinatesEqual, bus, calculateClosestEdge, columnData, convertDDToDisplaySegments, convertDisplaySegmentsToDD, ddSegmentConfigs, ddmSegmentConfigs, deduplicateMatchesByLocation, dmsSegmentConfigs, formatSegmentsToCoordinateString, getAllCoordinateFormats, getEditableSegmentCount, getFormatDescription, getInsertIndex, getSegmentConfigs, getSegmentLabel, hasAnySegmentValue, headerColumnActionValues, isCompleteCoordinate, isSlottedContextValue, matchesMetadata, mgrsSegmentConfigs, parseCoordinatePaste, parseCoordinateStringToSegments, parseDropTarget, sortDirectionValues, useCardInteractions, useColumnInteractions, useCoordinateCopy, useCoordinateField, useCoordinateFieldState, useCoordinateFieldStateContext, useCoordinateFocus, useCoordinatePaste, useDragContext, useDrawerEmit, useFrameDelay, useKanban, useListItemVariant, useTheme, useTimeoutCleanup, useTreeActions, useTreeState, useViewStackEmit, utmSegmentConfigs, validateCoordinateSegments, validateMoveCard };

package/dist/index.js

@@ -71,7 +71,6 @@ import { DialogTrigger } from "./components/dialog/trigger.js";
 import { Popover } from "./components/popover/index.js";
 import { PopoverContent } from "./components/popover/content.js";
 import { PopoverTitle } from "./components/popover/title.js";
-import { PopoverTrigger } from "./components/popover/trigger.js";
 import { Radio } from "./components/radio/index.js";
 import { RadioContext } from "./components/radio/context.js";
 import { RadioGroup } from "./components/radio/group.js";
@@ -177,6 +176,7 @@ import { PaginationPages } from "./components/pagination/pages.js";
 import { PaginationPrev } from "./components/pagination/prev.js";
 import { Pagination } from "./components/pagination/index.js";
 import { PopoverFooter } from "./components/popover/footer.js";
+import { PopoverTrigger } from "./components/popover/trigger.js";
 import { CloneAction, LockAction, RemoveRuleAction } from "./components/query-builder/actions.js";
 import { CombinatorSelector } from "./components/query-builder/combinator-selector.js";
 import { SwitchContext, SwitchProvider } from "./components/switch/context.js";

package/dist/lib/types.d.ts

@@ -16,35 +16,52 @@ import { AriaAttributes as AriaAttributes$1, AriaRole, CSSProperties, PropsWithC
 /**
  * Re-export due to not being exported by library
  */
+/** Render props with optional default className merged with generic state */
 type ClassNameRenderProps<T extends object> = T & {
+  /** Optional default CSS class name */
   defaultClassName?: string;
 };
+/** CSS class name as string or render function receiving component state */
 type RenderPropsClassName<T extends object> = string | ((values: ClassNameRenderProps<T>) => string);
+/** Render props with optional default style merged with generic state */
 type StylePropRenderProps<T extends object> = T & {
+  /** Optional default inline styles */
   defaultStyle?: CSSProperties;
 };
+/** Inline styles as CSSProperties or render function receiving component state */
 type RenderPropsStyle<T extends object> = CSSProperties | ((values: StylePropRenderProps<T>) => CSSProperties);
+/** Render props with optional default children merged with generic state */
 type ChildrenRenderProps<T extends object> = T & {
+  /** Optional default children content */
   defaultChildren?: ReactNode;
 };
+/** Children as ReactNode or render function receiving component state */
 type RenderPropsChildren<T extends object> = ReactNode | ((values: ChildrenRenderProps<T>) => ReactNode);
+/** Props for className and style that accept render functions */
 type StyleRenderProps<T extends object> = {
   /** The CSS [className](https://developer.mozilla.org/en-US/docs/Web/API/Element/className) for the element. A function may be provided to compute the class based on component state. */
   className?: RenderPropsClassName<T>;
   /** The inline [style](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/style) for the element. A function may be provided to compute the style based on component state. */
   style?: RenderPropsStyle<T>;
 };
+/** Combined render props for className, style, and children */
 type RenderProps<T extends object> = StyleRenderProps<T> & {
   /** The children of the component. A function may be provided to alter the children based on component state. */
   children?: RenderPropsChildren<T>;
 };
+/** Container for slot-based context values */
 type SlottedValue<T> = {
+  /** Map of slot names to their values */
   slots?: Record<string | symbol, T>;
 };
+/** Props for context providers with slot support */
 type ProviderProps<T> = PropsWithChildren<Omit<T, 'children' | 'slot'> & SlottedValue<T>>;
+/** Extended ARIA attributes including role */
 type AriaAttributes = AriaAttributes$1 & {
+  /** ARIA role for the element */
   role?: AriaRole;
 };
+/** ARIA attributes combined with ref forwarding support */
 type AriaAttributesWithRef<T> = AriaAttributes & RefAttributes<T>;
 //#endregion
 export { AriaAttributes, AriaAttributesWithRef, ChildrenRenderProps, ClassNameRenderProps, ProviderProps, RenderProps, RenderPropsChildren, RenderPropsClassName, RenderPropsStyle, SlottedValue, StylePropRenderProps, StyleRenderProps };

package/dist/lib/utils.d.ts

@@ -22,6 +22,21 @@ interface SlottedValue<T> {
 }
 /**
  * A helper to narrow the type of Context Value
+ *
+ * @example
+ * ```tsx
+ * function ComponentWithContext({ context }: { context: ContextValue<Props, HTMLElement> }) {
+ *   if (isSlottedContextValue(context)) {
+ *     // TypeScript knows context has 'slots' property
+ *     const slotValue = context.slots?.['header'];
+ *     return <div>{slotValue && 'Has header slot'}</div>;
+ *   }
+ *   return <div>No slots</div>;
+ * }
+ * ```
+ *
+ * @param context - The context value to check.
+ * @returns True if the context contains slot definitions.
  */
 declare function isSlottedContextValue<T, E>(context: ContextValue<T, E>): context is SlottedValue<WithRef<T, E>>;
 //#endregion

package/dist/lib/utils.js

@@ -14,6 +14,21 @@
 //#region src/lib/utils.ts
 /**
 * A helper to narrow the type of Context Value
+*
+* @example
+* ```tsx
+* function ComponentWithContext({ context }: { context: ContextValue<Props, HTMLElement> }) {
+*   if (isSlottedContextValue(context)) {
+*     // TypeScript knows context has 'slots' property
+*     const slotValue = context.slots?.['header'];
+*     return <div>{slotValue && 'Has header slot'}</div>;
+*   }
+*   return <div>No slots</div>;
+* }
+* ```
+*
+* @param context - The context value to check.
+* @returns True if the context contains slot definitions.
 */
 function isSlottedContextValue(context) {
 	return !!context && "slots" in context;

package/dist/lib/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":[],"sources":["../../src/lib/utils.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport type { ForwardedRef } from 'react';\nimport type { ContextValue } from 'react-aria-components';\n\n// Types copied from RAC due to not being exported\ntype WithRef<T, E> = T & {\n  ref?: ForwardedRef<E>;\n};\n\ninterface SlottedValue<T> {\n  slots?: Record<string | symbol, T>;\n}\n\n/**\n * A helper to narrow the type of Context Value\n */\nexport function isSlottedContextValue<T, E>(\n  context: ContextValue<T, E>,\n): context is SlottedValue<WithRef<T, E>> {\n  return !!context && 'slots' in context;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA2BA,SAAgB,sBACd,SACwC;AACxC,QAAO,CAAC,CAAC,WAAW,WAAW"}
+{"version":3,"file":"utils.js","names":[],"sources":["../../src/lib/utils.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport type { ForwardedRef } from 'react';\nimport type { ContextValue } from 'react-aria-components';\n\n// Types copied from RAC due to not being exported\ntype WithRef<T, E> = T & {\n  ref?: ForwardedRef<E>;\n};\n\ninterface SlottedValue<T> {\n  slots?: Record<string | symbol, T>;\n}\n\n/**\n * A helper to narrow the type of Context Value\n *\n * @example\n * ```tsx\n * function ComponentWithContext({ context }: { context: ContextValue<Props, HTMLElement> }) {\n *   if (isSlottedContextValue(context)) {\n *     // TypeScript knows context has 'slots' property\n *     const slotValue = context.slots?.['header'];\n *     return <div>{slotValue && 'Has header slot'}</div>;\n *   }\n *   return <div>No slots</div>;\n * }\n * ```\n *\n * @param context - The context value to check.\n * @returns True if the context contains slot definitions.\n */\nexport function isSlottedContextValue<T, E>(\n  context: ContextValue<T, E>,\n): context is SlottedValue<WithRef<T, E>> {\n  return !!context && 'slots' in context;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,SAAgB,sBACd,SACwC;AACxC,QAAO,CAAC,CAAC,WAAW,WAAW"}

package/dist/providers/portal.d.ts

@@ -11,9 +11,18 @@
  */
 
 import { PropsWithChildren, RefObject } from "react";
-import * as react_jsx_runtime2 from "react/jsx-runtime";
+import * as react_jsx_runtime9 from "react/jsx-runtime";
 
 //#region src/providers/portal.d.ts
+/**
+ * Provides a portal container for rendering overlays and modals
+ *
+ * @param props - Component props.
+ * @param props.parentRef - Optional ref to parent element for portal attachment.
+ * @param props.inject - Optional element to inject as portal container.
+ * @param props.children - Content to render within the portal context.
+ * @returns The portal provider wrapping children.
+ */
 declare function PortalProvider({
   parentRef,
   inject,
@@ -21,7 +30,7 @@ declare function PortalProvider({
 }: PropsWithChildren<{
   parentRef?: RefObject<HTMLElement | null>;
   inject?: HTMLElement | null;
-}>): react_jsx_runtime2.JSX.Element;
+}>): react_jsx_runtime9.JSX.Element;
 //#endregion
 export { PortalProvider };
 //# sourceMappingURL=portal.d.ts.map

package/dist/providers/portal.js

@@ -17,6 +17,15 @@ import { UNSAFE_PortalProvider } from "@react-aria/overlays";
 import { useIsSSR } from "@react-aria/ssr";
 
 //#region src/providers/portal.tsx
+/**
+* Provides a portal container for rendering overlays and modals
+*
+* @param props - Component props.
+* @param props.parentRef - Optional ref to parent element for portal attachment.
+* @param props.inject - Optional element to inject as portal container.
+* @param props.children - Content to render within the portal context.
+* @returns The portal provider wrapping children.
+*/
 function PortalProvider({ parentRef, inject, children }) {
 	const isSSR = useIsSSR();
 	const [portal, setPortal] = useState(isSSR ? null : document.body);

package/dist/providers/portal.js.map

@@ -1 +1 @@
-{"version":3,"file":"portal.js","names":[],"sources":["../../src/providers/portal.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { UNSAFE_PortalProvider } from '@react-aria/overlays';\nimport { useIsSSR } from '@react-aria/ssr';\nimport {\n  type PropsWithChildren,\n  type RefObject,\n  useEffect,\n  useState,\n} from 'react';\n\nexport function PortalProvider({\n  parentRef,\n  inject,\n  children,\n}: PropsWithChildren<{\n  parentRef?: RefObject<HTMLElement | null>;\n  inject?: HTMLElement | null;\n}>) {\n  const isSSR = useIsSSR();\n  const [portal, setPortal] = useState(isSSR ? null : document.body);\n\n  useEffect(() => {\n    const node = parentRef?.current;\n    // TODO: Ensure proper ssr hydration\n    const port = isSSR ? null : inject;\n\n    if (node && port) {\n      node.appendChild(port);\n\n      setPortal(port);\n    } else if (node) {\n      setPortal(node);\n    }\n\n    return () => {\n      port?.remove();\n\n      setPortal(isSSR ? null : document.body);\n    };\n  }, [isSSR, parentRef, inject]);\n\n  return (\n    <UNSAFE_PortalProvider getContainer={() => portal}>\n      {children}\n    </UNSAFE_PortalProvider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,eAAe,EAC7B,WACA,QACA,YAIE;CACF,MAAM,QAAQ,UAAU;CACxB,MAAM,CAAC,QAAQ,aAAa,SAAS,QAAQ,OAAO,SAAS,KAAK;AAElE,iBAAgB;EACd,MAAM,OAAO,WAAW;EAExB,MAAM,OAAO,QAAQ,OAAO;AAE5B,MAAI,QAAQ,MAAM;AAChB,QAAK,YAAY,KAAK;AAEtB,aAAU,KAAK;aACN,KACT,WAAU,KAAK;AAGjB,eAAa;AACX,SAAM,QAAQ;AAEd,aAAU,QAAQ,OAAO,SAAS,KAAK;;IAExC;EAAC;EAAO;EAAW;EAAO,CAAC;AAE9B,QACE,oBAAC;EAAsB,oBAAoB;EACxC;GACqB"}
+{"version":3,"file":"portal.js","names":[],"sources":["../../src/providers/portal.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { UNSAFE_PortalProvider } from '@react-aria/overlays';\nimport { useIsSSR } from '@react-aria/ssr';\nimport {\n  type PropsWithChildren,\n  type RefObject,\n  useEffect,\n  useState,\n} from 'react';\n\n/**\n * Provides a portal container for rendering overlays and modals\n *\n * @param props - Component props.\n * @param props.parentRef - Optional ref to parent element for portal attachment.\n * @param props.inject - Optional element to inject as portal container.\n * @param props.children - Content to render within the portal context.\n * @returns The portal provider wrapping children.\n */\nexport function PortalProvider({\n  parentRef,\n  inject,\n  children,\n}: PropsWithChildren<{\n  parentRef?: RefObject<HTMLElement | null>;\n  inject?: HTMLElement | null;\n}>) {\n  const isSSR = useIsSSR();\n  const [portal, setPortal] = useState(isSSR ? null : document.body);\n\n  useEffect(() => {\n    const node = parentRef?.current;\n    // TODO: Ensure proper ssr hydration\n    const port = isSSR ? null : inject;\n\n    if (node && port) {\n      node.appendChild(port);\n\n      setPortal(port);\n    } else if (node) {\n      setPortal(node);\n    }\n\n    return () => {\n      port?.remove();\n\n      setPortal(isSSR ? null : document.body);\n    };\n  }, [isSSR, parentRef, inject]);\n\n  return (\n    <UNSAFE_PortalProvider getContainer={() => portal}>\n      {children}\n    </UNSAFE_PortalProvider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,eAAe,EAC7B,WACA,QACA,YAIE;CACF,MAAM,QAAQ,UAAU;CACxB,MAAM,CAAC,QAAQ,aAAa,SAAS,QAAQ,OAAO,SAAS,KAAK;AAElE,iBAAgB;EACd,MAAM,OAAO,WAAW;EAExB,MAAM,OAAO,QAAQ,OAAO;AAE5B,MAAI,QAAQ,MAAM;AAChB,QAAK,YAAY,KAAK;AAEtB,aAAU,KAAK;aACN,KACT,WAAU,KAAK;AAGjB,eAAa;AACX,SAAM,QAAQ;AAEd,aAAU,QAAQ,OAAO,SAAS,KAAK;;IAExC;EAAC;EAAO;EAAW;EAAO,CAAC;AAE9B,QACE,oBAAC;EAAsB,oBAAoB;EACxC;GACqB"}