@primereact/mcp 11.0.0-rc.2

package/data/llms/headless/components/tree/api.json

@@ -0,0 +1,1297 @@
+[
+  {
+    "name": "useTree",
+    "source": "apps/showcase/assets/apidoc/usetree.json",
+    "data": {
+      "description": "The useTree manages the state and functionality of a tree component.",
+      "interfaces": {
+        "UseTreeExpandedChangeEvent": {
+          "description": "Event fired when the tree's expanded keys change.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "originalEvent",
+              "type": "E",
+              "default": "",
+              "description": "The original event that triggered the expansion change."
+            },
+            {
+              "name": "node",
+              "type": "TreeExpandedKeys",
+              "default": "",
+              "description": "The new expanded keys."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeSelectionChangeEvent": {
+          "description": "Event fired when the tree's selected keys change.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "originalEvent",
+              "type": "E",
+              "default": "",
+              "description": "The original event that triggered the selection change."
+            },
+            {
+              "name": "value",
+              "type": "TreeSelectionKeys | TreeCheckboxSelectionKeys",
+              "default": "",
+              "description": "The new selected keys."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeToggleEvent": {
+          "description": "Event fired when a node is toggled.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "originalEvent",
+              "type": "SyntheticEvent",
+              "default": "",
+              "description": "The original event that triggered the toggle."
+            },
+            {
+              "name": "node",
+              "type": "TreeNodeData",
+              "default": "",
+              "description": "The toggled node."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeExpandEvent": {
+          "description": "Event fired when a node is expanded.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "originalEvent",
+              "type": "SyntheticEvent",
+              "default": "",
+              "description": "The original event that triggered the toggle."
+            },
+            {
+              "name": "node",
+              "type": "TreeNodeData",
+              "default": "",
+              "description": "The expanded node."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeCollapseEvent": {
+          "description": "Event fired when a node is collapsed.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "originalEvent",
+              "type": "SyntheticEvent",
+              "default": "",
+              "description": "The original event that triggered the collapse."
+            },
+            {
+              "name": "node",
+              "type": "TreeNodeData",
+              "default": "",
+              "description": "The collapsed node."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeClickEvent": {
+          "description": "Event fired when a node is clicked.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "originalEvent",
+              "type": "MouseEvent<Element, MouseEvent> | KeyboardEvent<Element>",
+              "default": "",
+              "description": "The original event that triggered the click."
+            },
+            {
+              "name": "node",
+              "type": "TreeNodeData",
+              "default": "",
+              "description": "The clicked node."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeSelectEvent": {
+          "description": "Event fired when a node is selected.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "originalEvent",
+              "type": "SyntheticEvent<Element, Event> | MouseEvent<Element, MouseEvent> | KeyboardEvent<Element>",
+              "default": "",
+              "description": "The original event that triggered the selection."
+            },
+            {
+              "name": "node",
+              "type": "TreeNodeData",
+              "default": "",
+              "description": "The selected node."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeUnselectEvent": {
+          "description": "Event fired when a node is unselected.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "originalEvent",
+              "type": "SyntheticEvent<Element, Event> | MouseEvent<Element, MouseEvent> | KeyboardEvent<Element>",
+              "default": "",
+              "description": "The original event that triggered the unselection."
+            },
+            {
+              "name": "node",
+              "type": "TreeNodeData",
+              "default": "",
+              "description": "The unselected node."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeMoveEvent": {
+          "description": "Event fired when a drag-and-drop move completes. Replaces the legacy\n `onNodeDrop`  /  `onDragEnter`  /  `onDragLeave`  / drag-drop  `onValueChange`  quartet.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "originalEvent",
+              "type": "DragEvent",
+              "default": "",
+              "description": "The original drop event."
+            },
+            {
+              "name": "value",
+              "type": "TreeNodeData[]",
+              "default": "",
+              "description": "The updated tree value after the move."
+            },
+            {
+              "name": "dragNode",
+              "type": "TreeNodeData",
+              "default": "",
+              "description": "The node being moved."
+            },
+            {
+              "name": "dropNode",
+              "type": "TreeNodeData",
+              "default": "",
+              "description": "The drop target node, or null if dropped at the root level."
+            },
+            {
+              "name": "dropIndex",
+              "type": "number",
+              "default": "",
+              "description": "The destination index within the parent's children array."
+            },
+            {
+              "name": "dropPosition",
+              "type": "TreeDropPosition",
+              "default": "",
+              "description": "Where in relation to  `dropNode`  the drop occurred."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeFocusedKeyChangeEvent": {
+          "description": "Event fired when the focused key changes (keyboard navigation).",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "value",
+              "type": "string",
+              "default": "",
+              "description": "The new focused key, or null when focus leaves the tree."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeProps": {
+          "description": "Defines valid properties in useTree.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "value",
+              "type": "TreeNodeData[]",
+              "default": "",
+              "description": "An array of treenodes."
+            },
+            {
+              "name": "expandedKeys",
+              "type": "TreeExpandedKeys",
+              "default": "",
+              "description": "A record of keys to represent the state of the tree expansion state in controlled mode."
+            },
+            {
+              "name": "defaultExpandedKeys",
+              "type": "TreeExpandedKeys",
+              "default": "",
+              "description": "The default expanded keys when used in uncontrolled mode."
+            },
+            {
+              "name": "selectionKeys",
+              "type": "TreeSelectionKeys | TreeCheckboxSelectionKeys",
+              "default": "",
+              "description": "A record of keys to represent the selection state in controlled mode.\nFor single/multiple mode: Record<string, boolean>\nFor checkbox mode: Record<string, { checked: boolean, partialChecked: boolean }>"
+            },
+            {
+              "name": "defaultSelectionKeys",
+              "type": "TreeSelectionKeys | TreeCheckboxSelectionKeys",
+              "default": "",
+              "description": "The default selected keys when used in uncontrolled mode."
+            },
+            {
+              "name": "selectionMode",
+              "type": "\"checkbox\" | \"multiple\" | \"single\"",
+              "default": "",
+              "description": "Defines the selection mode."
+            },
+            {
+              "name": "metaKeySelection",
+              "type": "boolean",
+              "default": "false",
+              "description": "Defines how multiple items can be selected, when true metaKey needs to be pressed to select or unselect multiple items. When set to false selection of each item can be toggled individually."
+            },
+            {
+              "name": "highlightOnSelect",
+              "type": "boolean",
+              "default": "false",
+              "description": "Highlights automatically the first item."
+            },
+            {
+              "name": "draggable",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the tree nodes can be dragged."
+            },
+            {
+              "name": "droppable",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the tree can accept dropped nodes."
+            },
+            {
+              "name": "draggableScope",
+              "type": "string | string[]",
+              "default": "",
+              "description": "Identifier(s) attached to nodes dragged out of this tree. Other trees use this\nvalue to decide whether they accept the drop (see  `droppableScope` ).\nAccepts a string or an array of strings."
+            },
+            {
+              "name": "droppableScope",
+              "type": "string | string[]",
+              "default": "",
+              "description": "Scope(s) this tree accepts drops from. A drop is allowed when the dragged\nnode's  `draggableScope`  overlaps with this value. Accepts a string or an\narray of strings. When omitted, drops from any scope are accepted."
+            },
+            {
+              "name": "onExpandedChange",
+              "type": "(event: UseTreeExpandedChangeEvent) => void",
+              "default": "",
+              "description": "Callback fired when the tree's expanded keys change."
+            },
+            {
+              "name": "onSelectionChange",
+              "type": "(event: UseTreeSelectionChangeEvent) => void",
+              "default": "",
+              "description": "Callback fired when the tree's selection changes."
+            },
+            {
+              "name": "onToggle",
+              "type": "(event: UseTreeToggleEvent) => void",
+              "default": "",
+              "description": "Callback fired when a node is toggled (expanded or collapsed)."
+            },
+            {
+              "name": "onExpand",
+              "type": "(event: UseTreeExpandEvent) => void",
+              "default": "",
+              "description": "Callback fired when a node is expanded."
+            },
+            {
+              "name": "onCollapse",
+              "type": "(event: UseTreeCollapseEvent) => void",
+              "default": "",
+              "description": "Callback fired when a node is collapsed."
+            },
+            {
+              "name": "onClick",
+              "type": "(event: UseTreeClickEvent) => void",
+              "default": "",
+              "description": "Callback fired when a node is clicked."
+            },
+            {
+              "name": "onSelect",
+              "type": "(event: UseTreeSelectEvent) => void",
+              "default": "",
+              "description": "Callback fired when a node is selected."
+            },
+            {
+              "name": "onUnselect",
+              "type": "(event: UseTreeUnselectEvent) => void",
+              "default": "",
+              "description": "Callback fired when a node is unselected."
+            },
+            {
+              "name": "onMove",
+              "type": "(event: UseTreeMoveEvent) => void",
+              "default": "",
+              "description": "Callback fired when a drag-and-drop move completes. Receives the updated tree value plus move metadata."
+            },
+            {
+              "name": "validateMove",
+              "type": "(event: UseTreeMoveEvent) => boolean | Promise<boolean>",
+              "default": "",
+              "description": "Optional validator invoked before a move is committed. Return  `false`  (sync or async) to cancel the move."
+            },
+            {
+              "name": "onFocusedKeyChange",
+              "type": "(event: UseTreeFocusedKeyChangeEvent) => void",
+              "default": "",
+              "description": "Callback fired when the focused key changes (keyboard navigation)."
+            },
+            {
+              "name": "loading",
+              "type": "boolean",
+              "default": "",
+              "description": "Displays a loading overlay over the tree. Pair with  `Tree.Loading`  to render\nthe spinner / message of your choice."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeState": {
+          "description": "Defines valid state in useTree.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "expandedKeys",
+              "type": "TreeExpandedKeys",
+              "default": "",
+              "description": "The current expanded keys of the tree."
+            },
+            {
+              "name": "selectionKeys",
+              "type": "TreeSelectionKeys | TreeCheckboxSelectionKeys",
+              "default": "",
+              "description": "The current selected keys of the tree."
+            },
+            {
+              "name": "focusedKey",
+              "type": "string",
+              "default": "",
+              "description": "The key of the currently focused node, or null when none."
+            },
+            {
+              "name": "dragHover",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the tree is in drag hover state."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeSelectionApi": {
+          "description": "Selection query / mutation API exposed by useTree. Consumed by  `Tree.Selection` .",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "isSelected",
+              "type": "(key: string) => boolean",
+              "default": "",
+              "description": "True when the given key is selected (or  `checked === true`  in checkbox mode)."
+            },
+            {
+              "name": "isPartiallySelected",
+              "type": "(key: string) => boolean",
+              "default": "",
+              "description": "True when the given key is in the tri-state \"partial\" position (checkbox mode only)."
+            },
+            {
+              "name": "isAllSelected",
+              "type": "() => boolean",
+              "default": "",
+              "description": "True when **all** visible nodes are selected. Aggregate (header) context."
+            },
+            {
+              "name": "isSomeSelected",
+              "type": "() => boolean",
+              "default": "",
+              "description": "True when **some** visible nodes (but not all) are selected. Aggregate (header) context."
+            },
+            {
+              "name": "toggleSelection",
+              "type": "(event: SyntheticEvent, key: string, mode: \"checkbox\" | \"radio\" | \"single\") => void",
+              "default": "",
+              "description": "Toggle a single node's selection.  `mode`  picks the toggle behavior:\n-  `'checkbox'` : tri-state cascade.\n-  `'radio'` : select-only, never deselects on re-click.\n-  `'single'` : select / deselect on re-click."
+            },
+            {
+              "name": "toggleAll",
+              "type": "(event: SyntheticEvent) => void",
+              "default": "",
+              "description": "Select or deselect every visible node."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeExposes": {
+          "description": "Defines the methods and properties exposed by useTree.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "state",
+              "type": "UseTreeState",
+              "default": "",
+              "description": "The state of the useTree."
+            },
+            {
+              "name": "nodeMap",
+              "type": "Map<string, TreeNodeEntry>",
+              "default": "",
+              "description": "Map of every node keyed by  `node.key` , carrying parent / level / posInSet / setSize. O(1) lookup."
+            },
+            {
+              "name": "flatOrder",
+              "type": "string[]",
+              "default": "",
+              "description": "All node keys in depth-first order, regardless of expansion."
+            },
+            {
+              "name": "visibleKeys",
+              "type": "string[]",
+              "default": "",
+              "description": "Keys of nodes whose ancestors are all expanded (i.e. currently visible in the DOM)."
+            },
+            {
+              "name": "visibleCount",
+              "type": "number",
+              "default": "",
+              "description": "Convenience:  `visibleKeys.length` ."
+            },
+            {
+              "name": "findNodeByKey",
+              "type": "(key: string) => TreeNodeData",
+              "default": "",
+              "description": "Look up a node by key in O(1)."
+            },
+            {
+              "name": "findNodeInfo",
+              "type": "(key: string) => { level: number; posInSet: number; setSize: number; parentKey: string }",
+              "default": "",
+              "description": "Look up a node's position metadata by key."
+            },
+            {
+              "name": "getNodes",
+              "type": "() => TreeNodeData[]",
+              "default": "",
+              "description": "Gets the list of tree nodes (the original  `props.value` )."
+            },
+            {
+              "name": "setFocusedKey",
+              "type": "(key: string) => void",
+              "default": "",
+              "description": "Set the focused key explicitly (e.g. from a click handler)."
+            },
+            {
+              "name": "setSelectionKeys",
+              "type": "(keys: TreeSelectionKeys | TreeCheckboxSelectionKeys, event?: SyntheticEvent) => void",
+              "default": "",
+              "description": "Replace the entire selection map."
+            },
+            {
+              "name": "onKeyDown",
+              "type": "(event: KeyboardEvent, node: TreeNodeData, level: number, expanded: boolean, leaf: boolean) => void",
+              "default": "",
+              "description": "Handles keyboard navigation on tree nodes."
+            },
+            {
+              "name": "onNodeToggle",
+              "type": "(event: SyntheticEvent, node: TreeNodeData) => void",
+              "default": "",
+              "description": "Toggles the expansion state of a node."
+            },
+            {
+              "name": "onNodeClick",
+              "type": "(event: MouseEvent<Element, MouseEvent> | KeyboardEvent<Element>, node: TreeNodeData, nodeTouched?: boolean) => void",
+              "default": "",
+              "description": "Handles node click event."
+            },
+            {
+              "name": "onClick",
+              "type": "(event: MouseEvent<Element, MouseEvent> | KeyboardEvent<Element>, node: TreeNodeData, nodeTouched?: boolean) => void",
+              "default": "",
+              "description": "Handles content click event. Automatically delegates to checkbox or node click based on selection mode."
+            },
+            {
+              "name": "onCheckboxChange",
+              "type": "(event: SyntheticEvent, node: TreeNodeData) => void",
+              "default": "",
+              "description": "Handles checkbox state change for checkbox selection mode."
+            },
+            {
+              "name": "isNodeSelected",
+              "type": "(node: TreeNodeData) => boolean",
+              "default": "",
+              "description": "Checks if a node is selected."
+            },
+            {
+              "name": "selection",
+              "type": "UseTreeSelectionApi",
+              "default": "",
+              "description": "Selection query API consumed by  `Tree.Selection` . Mirrors the DataTable selection contract."
+            },
+            {
+              "name": "allowDrop",
+              "type": "(node: TreeNodeData) => boolean",
+              "default": "",
+              "description": "Checks if a node can be dropped based on drag-drop rules."
+            },
+            {
+              "name": "getToggleProps",
+              "type": "(node: TreeNodeData) => UseTreeToggleProps",
+              "default": "",
+              "description": "Returns pre-built props for a tree toggle button element."
+            },
+            {
+              "name": "getToggleSpacerProps",
+              "type": "() => UseTreeToggleSpacerProps",
+              "default": "",
+              "description": "Returns pre-built props for the leaf-row toggle spacer element."
+            },
+            {
+              "name": "getToggleIndicatorProps",
+              "type": "() => UseTreeToggleIndicatorProps",
+              "default": "",
+              "description": "Returns pre-built props for a toggle indicator element."
+            },
+            {
+              "name": "rootProps",
+              "type": "UseTreeRootProps",
+              "default": "",
+              "description": "Returns pre-built props for the tree root element."
+            },
+            {
+              "name": "getNodeProps",
+              "type": "(node: TreeNodeData, level: number, expanded: boolean, checked: boolean, selected: boolean, leaf: boolean, posInSet: number, setSize: number) => UseTreeNodeProps",
+              "default": "",
+              "description": "Returns pre-built props for a tree node element."
+            },
+            {
+              "name": "filterProps",
+              "type": "UseTreeFilterProps",
+              "default": "",
+              "description": "Returns pre-built props for the tree filter element."
+            },
+            {
+              "name": "loadingProps",
+              "type": "UseTreeLoadingProps",
+              "default": "",
+              "description": "Returns pre-built props for the tree loading status element."
+            },
+            {
+              "name": "getNodesProps",
+              "type": "() => UseTreeNodesProps",
+              "default": "",
+              "description": "Returns pre-built props for the flat iterator element."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeToggleProps": {
+          "description": "Pre-built props for a tree toggle button element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"tree\"",
+              "default": "",
+              "description": "Component scope identifier."
+            },
+            {
+              "name": "data-part",
+              "type": "\"toggle\"",
+              "default": "",
+              "description": "Component part identifier."
+            },
+            {
+              "name": "data-expanded",
+              "type": "\"\"",
+              "default": "",
+              "description": "Present when the associated node is expanded."
+            },
+            {
+              "name": "data-collapsed",
+              "type": "\"\"",
+              "default": "",
+              "description": "Present when the associated node is collapsed."
+            },
+            {
+              "name": "type",
+              "type": "\"button\"",
+              "default": "",
+              "description": "The type of the button."
+            },
+            {
+              "name": "tabIndex",
+              "type": "-1",
+              "default": "",
+              "description": "The tab index of the button."
+            },
+            {
+              "name": "onClick",
+              "type": "(event: MouseEvent<HTMLButtonElement>) => void",
+              "default": "",
+              "description": "Click handler that stops propagation and toggles the node."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeToggleSpacerProps": {
+          "description": "Pre-built props for the leaf-row toggle spacer element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"tree\"",
+              "default": "",
+              "description": "Component scope identifier."
+            },
+            {
+              "name": "data-part",
+              "type": "\"toggle-spacer\"",
+              "default": "",
+              "description": "Component part identifier."
+            },
+            {
+              "name": "aria-hidden",
+              "type": "true",
+              "default": "",
+              "description": "Hidden from the accessibility tree; the spacer is purely visual alignment."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeToggleIndicatorProps": {
+          "description": "Pre-built props for a toggle indicator element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"tree\"",
+              "default": "",
+              "description": "Component scope identifier."
+            },
+            {
+              "name": "data-part",
+              "type": "\"toggle-indicator\"",
+              "default": "",
+              "description": "Component part identifier."
+            },
+            {
+              "name": "aria-hidden",
+              "type": "true",
+              "default": "",
+              "description": "Hidden from the accessibility tree; the indicator is purely decorative."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeRootProps": {
+          "description": "Pre-built props for the tree root element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "id",
+              "type": "string",
+              "default": "",
+              "description": "Unique identifier for the root element."
+            },
+            {
+              "name": "data-scope",
+              "type": "\"tree\"",
+              "default": "",
+              "description": "Component scope identifier."
+            },
+            {
+              "name": "data-part",
+              "type": "\"root\"",
+              "default": "",
+              "description": "Component part identifier."
+            },
+            {
+              "name": "data-dragover",
+              "type": "\"\"",
+              "default": "",
+              "description": "Present when the tree root is the active drop target during a drag operation."
+            },
+            {
+              "name": "onDragOver",
+              "type": "(event: DragEvent) => void",
+              "default": "",
+              "description": "Drag over event handler."
+            },
+            {
+              "name": "onDragEnter",
+              "type": "(event: DragEvent) => void",
+              "default": "",
+              "description": "Drag enter event handler."
+            },
+            {
+              "name": "onDragLeave",
+              "type": "(event: DragEvent) => void",
+              "default": "",
+              "description": "Drag leave event handler."
+            },
+            {
+              "name": "onDrop",
+              "type": "(event: DragEvent) => void",
+              "default": "",
+              "description": "Drop event handler."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeNodeProps": {
+          "description": "Pre-built props for a tree node element (li).",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "role",
+              "type": "\"treeitem\"",
+              "default": "",
+              "description": "ARIA role for the node element."
+            },
+            {
+              "name": "tabIndex",
+              "type": "number",
+              "default": "",
+              "description": "Tab index for keyboard navigation."
+            },
+            {
+              "name": "aria-level",
+              "type": "number",
+              "default": "",
+              "description": "ARIA level of the node in the tree hierarchy."
+            },
+            {
+              "name": "aria-setsize",
+              "type": "number",
+              "default": "",
+              "description": "Total number of nodes at the same level for ARIA."
+            },
+            {
+              "name": "aria-posinset",
+              "type": "number",
+              "default": "",
+              "description": "Position of the node in its set for ARIA."
+            },
+            {
+              "name": "aria-expanded",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the node is expanded. Omitted for leaf nodes."
+            },
+            {
+              "name": "aria-selected",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the node is selected (single/multiple selection mode)."
+            },
+            {
+              "name": "aria-checked",
+              "type": "boolean | \"mixed\"",
+              "default": "",
+              "description": "Whether the node is checked (checkbox selection mode);  `'mixed'`  for partial."
+            },
+            {
+              "name": "data-scope",
+              "type": "\"tree\"",
+              "default": "",
+              "description": "Component scope identifier."
+            },
+            {
+              "name": "data-part",
+              "type": "\"node\"",
+              "default": "",
+              "description": "Component part identifier."
+            },
+            {
+              "name": "data-node-key",
+              "type": "string",
+              "default": "",
+              "description": "The key of the node for identification."
+            },
+            {
+              "name": "data-expanded",
+              "type": "\"\"",
+              "default": "",
+              "description": "Present when the node is expanded."
+            },
+            {
+              "name": "data-collapsed",
+              "type": "\"\"",
+              "default": "",
+              "description": "Present when the node is collapsed."
+            },
+            {
+              "name": "data-selected",
+              "type": "\"\"",
+              "default": "",
+              "description": "Present when the node is selected."
+            },
+            {
+              "name": "data-leaf",
+              "type": "\"\"",
+              "default": "",
+              "description": "Present when the node is a leaf node."
+            },
+            {
+              "name": "data-disabled",
+              "type": "\"\"",
+              "default": "",
+              "description": "Present when the node is disabled."
+            },
+            {
+              "name": "data-focused",
+              "type": "\"\"",
+              "default": "",
+              "description": "Present when the node is the currently focused row (keyboard navigation)."
+            },
+            {
+              "name": "onKeyDown",
+              "type": "(event: KeyboardEvent) => void",
+              "default": "",
+              "description": "Keyboard event handler for the node."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeFilterProps": {
+          "description": "Pre-built props for the tree filter element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"tree\"",
+              "default": "",
+              "description": "Component scope identifier."
+            },
+            {
+              "name": "data-part",
+              "type": "\"filter\"",
+              "default": "",
+              "description": "Component part identifier."
+            },
+            {
+              "name": "autoComplete",
+              "type": "\"off\"",
+              "default": "",
+              "description": "Autocomplete attribute for the filter input."
+            },
+            {
+              "name": "onKeyUp",
+              "type": "(event: KeyboardEvent) => void",
+              "default": "",
+              "description": "Key up event handler for the filter."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeLoadingProps": {
+          "description": "Pre-built props for the tree loading status element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"tree\"",
+              "default": "",
+              "description": "Component scope identifier."
+            },
+            {
+              "name": "data-part",
+              "type": "\"loading\"",
+              "default": "",
+              "description": "Component part identifier."
+            },
+            {
+              "name": "role",
+              "type": "\"status\"",
+              "default": "",
+              "description": "Announces the loading region to assistive technology."
+            },
+            {
+              "name": "aria-live",
+              "type": "\"polite\"",
+              "default": "",
+              "description": "Politeness level for the live region updates."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeNodesProps": {
+          "description": "Pre-built props for the flat iterator element ( `<ul role=\"tree\">` ).",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"tree\"",
+              "default": "",
+              "description": "Component scope identifier."
+            },
+            {
+              "name": "data-part",
+              "type": "\"nodes\"",
+              "default": "",
+              "description": "Component part identifier."
+            },
+            {
+              "name": "role",
+              "type": "\"tree\"",
+              "default": "",
+              "description": "ARIA role."
+            }
+          ],
+          "methods": []
+        }
+      },
+      "types": {
+        "UseTreeInstance": {
+          "description": "Instance of useTree headless.",
+          "values": "HeadlessInstance<UseTreeProps, UseTreeState, UseTreeExposes>"
+        }
+      },
+      "variables": {}
+    }
+  },
+  {
+    "name": "useTreeNode",
+    "source": "apps/showcase/assets/apidoc/usetreenode.json",
+    "data": {
+      "description": "The useTreeNode manages the state and functionality of a Tree node.",
+      "interfaces": {
+        "UseTreeNodeHookProps": {
+          "description": "Defines valid properties in useTreeNode hook.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "node",
+              "type": "TreeNodeData",
+              "default": "",
+              "description": "The tree node data."
+            },
+            {
+              "name": "index",
+              "type": "number",
+              "default": "",
+              "description": "Index of the node among its siblings."
+            },
+            {
+              "name": "context",
+              "type": "UseTreeInstance",
+              "default": "",
+              "description": "The parent tree instance providing state and methods."
+            },
+            {
+              "name": "parentContext",
+              "type": "UseTreeNodeInstance",
+              "default": "",
+              "description": "The parent tree node instance (if this is a nested node)."
+            },
+            {
+              "name": "onMove",
+              "type": "(event: UseTreeMoveEvent) => void",
+              "default": "",
+              "description": "Callback fired when a drag-and-drop move completes on this node."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeNodeState": {
+          "description": "Defines valid state in useTreeNode.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "expanded",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the node is expanded."
+            },
+            {
+              "name": "selected",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the node is selected (single/multiple mode)."
+            },
+            {
+              "name": "checked",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the node is checked (checkbox mode)."
+            },
+            {
+              "name": "partialChecked",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the node is partially checked (checkbox mode)."
+            },
+            {
+              "name": "leaf",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the node is a leaf node."
+            },
+            {
+              "name": "level",
+              "type": "number",
+              "default": "",
+              "description": "Depth level of the node in the tree (1-based)."
+            },
+            {
+              "name": "posInSet",
+              "type": "number",
+              "default": "",
+              "description": "Position of this node among its siblings (1-based)."
+            },
+            {
+              "name": "setSize",
+              "type": "number",
+              "default": "",
+              "description": "Total number of siblings at this level."
+            },
+            {
+              "name": "isNodeDropActive",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether this node is currently being dragged over (center zone)."
+            },
+            {
+              "name": "isPrevDropPointActive",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the previous drop point is active."
+            },
+            {
+              "name": "isNextDropPointActive",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the next drop point is active."
+            },
+            {
+              "name": "isDraggable",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether this node is draggable."
+            },
+            {
+              "name": "nodeTouched",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the node was touched (for mobile interactions)."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeNodeExposes": {
+          "description": "Defines the methods and properties exposed by useTreeNode.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "state",
+              "type": "UseTreeNodeState",
+              "default": "",
+              "description": "The computed state."
+            },
+            {
+              "name": "parentNode",
+              "type": "UseTreeNodeInstance",
+              "default": "",
+              "description": "The parent tree node instance (for nested traversal)."
+            },
+            {
+              "name": "nodeProps",
+              "type": "UseTreeNodeProps",
+              "default": "",
+              "description": "Pre-built props for the node root element (li)."
+            },
+            {
+              "name": "contentProps",
+              "type": "UseTreeNodeContentElProps",
+              "default": "",
+              "description": "Pre-built props for the content element (div)."
+            },
+            {
+              "name": "dropPointProps",
+              "type": "UseTreeNodeDropPointElProps",
+              "default": "",
+              "description": "Pre-built props for drop point indicators."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeNodeContentElProps": {
+          "description": "Pre-built props for the content element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"tree\"",
+              "default": "",
+              "description": "Component scope identifier."
+            },
+            {
+              "name": "data-part",
+              "type": "\"content\"",
+              "default": "",
+              "description": "Component part identifier."
+            },
+            {
+              "name": "draggable",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether this node is draggable."
+            },
+            {
+              "name": "data-selected",
+              "type": "\"\"",
+              "default": "",
+              "description": "Present when the node is currently selected."
+            },
+            {
+              "name": "data-selectable",
+              "type": "\"\"",
+              "default": "",
+              "description": "Present when the node is selectable."
+            },
+            {
+              "name": "data-expanded",
+              "type": "\"\"",
+              "default": "",
+              "description": "Present when the node is expanded (non-leaf only)."
+            },
+            {
+              "name": "data-collapsed",
+              "type": "\"\"",
+              "default": "",
+              "description": "Present when the node is collapsed (non-leaf only)."
+            },
+            {
+              "name": "data-leaf",
+              "type": "\"\"",
+              "default": "",
+              "description": "Present when the node is a leaf node."
+            },
+            {
+              "name": "data-checked",
+              "type": "\"\"",
+              "default": "",
+              "description": "Present when the node is checked (checkbox mode)."
+            },
+            {
+              "name": "data-partial-checked",
+              "type": "\"\"",
+              "default": "",
+              "description": "Present when the node is partially checked (checkbox mode)."
+            },
+            {
+              "name": "data-disabled",
+              "type": "\"\"",
+              "default": "",
+              "description": "Present when the node is disabled."
+            },
+            {
+              "name": "data-dragover",
+              "type": "\"\"",
+              "default": "",
+              "description": "Present when the node is being dragged over (drop target)."
+            },
+            {
+              "name": "onDragStart",
+              "type": "(event: DragEvent) => void",
+              "default": "",
+              "description": "Callback fired when a drag operation starts on this node."
+            },
+            {
+              "name": "onDragOver",
+              "type": "(event: DragEvent) => void",
+              "default": "",
+              "description": "Callback fired when a dragged element is over this node."
+            },
+            {
+              "name": "onDragEnter",
+              "type": "() => void",
+              "default": "",
+              "description": "Callback fired when a dragged element enters this node."
+            },
+            {
+              "name": "onDragLeave",
+              "type": "() => void",
+              "default": "",
+              "description": "Callback fired when a dragged element leaves this node."
+            },
+            {
+              "name": "onDragEnd",
+              "type": "(event: DragEvent) => void",
+              "default": "",
+              "description": "Callback fired when a drag operation ends on this node."
+            },
+            {
+              "name": "onDrop",
+              "type": "(event: DragEvent) => void",
+              "default": "",
+              "description": "Callback fired when a dragged element is dropped on this node."
+            },
+            {
+              "name": "onClick",
+              "type": "(event: MouseEvent) => void",
+              "default": "",
+              "description": "Callback fired when this node is clicked."
+            },
+            {
+              "name": "onTouchEnd",
+              "type": "() => void",
+              "default": "",
+              "description": "Callback fired when a touch interaction ends on this node."
+            }
+          ],
+          "methods": []
+        },
+        "UseTreeNodeDropPointElProps": {
+          "description": "Pre-built props for drop point elements.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"tree\"",
+              "default": "",
+              "description": "Component scope identifier."
+            },
+            {
+              "name": "data-part",
+              "type": "\"drop-point\"",
+              "default": "",
+              "description": "Component part identifier."
+            },
+            {
+              "name": "aria-hidden",
+              "type": "true",
+              "default": "",
+              "description": "Hides the drop point element from assistive technologies."
+            }
+          ],
+          "methods": []
+        }
+      },
+      "types": {
+        "UseTreeNodeInstance": {
+          "description": "Instance of useTreeNode headless.",
+          "values": "HeadlessInstance<UseTreeNodeHookProps, UseTreeNodeState, UseTreeNodeExposes>"
+        }
+      },
+      "variables": {}
+    }
+  }
+]