v-float 0.7.1 → 0.8.0

package/dist/composables/interactions/use-focus.d.ts

@@ -1,40 +1,35 @@
 import { MaybeRefOrGetter } from 'vue';
-import { FloatingContext } from '..';
-import { TreeNode } from '../use-floating-tree';
+import { FloatingContext } from '../positioning/use-floating';
+import { Tree } from '../positioning/use-floating-tree';
 /**
- * Enables showing/hiding the floating element when focusing the reference element.
+ * Enables showing/hiding the floating element when the reference element receives or loses focus.
  *
- * This composable is responsible for KEYBOARD-ONLY interactions. For a complete user experience,
- * it should be composed with other hooks like `useClick`, `useHover`, and `useEscapeKey`.
+ * Keyboard-only interaction hook. Compose with `useClick`, `useHover`, `useEscapeKey` for a complete UX.
  *
- * The composable supports both standalone usage with FloatingContext and tree-aware
- * usage with TreeNode<FloatingContext> for complex nested floating UI structures.
+ * Tree-aware behavior is enabled by providing a `tree` option and passing the corresponding
+ * FloatingContext (i.e., the node's `.data`). IDs are only relevant for tree-aware usage and are
+ * automatically assigned when using `useFloatingTree().addNode(...)`.
  *
- * @param context - The floating context or tree node with open state and change handler.
- * @param options - Configuration options for focus behavior.
+ * @param context - The floating context for this element (not a TreeNode).
+ * @param options - Configuration options. Provide `tree` to enable tree-aware behavior.
  *
- * @example Basic standalone usage
+ * @example Standalone
  * ```ts
- * const context = useFloating(...)
- * useFocus(context, {
- *   enabled: true,
- *   requireFocusVisible: true
- * })
+ * const ctx = useFloating(...)
+ * useFocus(ctx)
  * ```
  *
- * @example Tree-aware usage for nested floating elements
+ * @example Tree-aware
  * ```ts
- * const tree = useFloatingTree(rootContext)
- * const parentNode = tree.root
- * const childNode = tree.addNode(childContext, parentNode.id)
+ * const tree = useFloatingTree(rootAnchor, rootFloating)
+ * const parent = tree.root
+ * const child = tree.addNode(childAnchor, childFloating, { parentId: parent.id })
  *
- * // Tree-aware behavior: parent stays open when focus moves to child,
- * // but closes when focus moves outside hierarchy
- * useFocus(parentNode, { requireFocusVisible: true })
- * useFocus(childNode, { requireFocusVisible: true })
+ * useFocus(parent.data, { tree })
+ * useFocus(child.data, { tree })
  * ```
  */
-export declare function useFocus(context: FloatingContext | TreeNode<FloatingContext>, options?: UseFocusOptions): UseFocusReturn;
+export declare function useFocus(context: FloatingContext, options?: UseFocusOptions): UseFocusReturn;
 export interface UseFocusOptions {
     /**
      * Whether focus event listeners are enabled
@@ -47,9 +42,19 @@ export interface UseFocusOptions {
      * @default true
      */
     requireFocusVisible?: MaybeRefOrGetter<boolean>;
+    /**
+     * When provided, enables tree-aware focus handling.
+     */
+    tree?: Tree<FloatingContext>;
 }
 /**
  * Return value of the useFocus composable
  */
-export type UseFocusReturn = undefined;
+export interface UseFocusReturn {
+    /**
+     * Cleanup function that removes all event listeners and clears pending timeouts.
+     * Useful for manual cleanup in testing scenarios.
+     */
+    cleanup: () => void;
+}
 //# sourceMappingURL=use-focus.d.ts.map

package/dist/composables/interactions/use-focus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-focus.d.ts","sourceRoot":"","sources":["../../../src/composables/interactions/use-focus.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,gBAAgB,EAMtB,MAAM,KAAK,CAAA;AACZ,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAc/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC,EACpD,OAAO,GAAE,eAAoB,GAC5B,cAAc,CAwIhB;AAMD,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAEnC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;CAChD;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,CAAA"}
+{"version":3,"file":"use-focus.d.ts","sourceRoot":"","sources":["../../../src/composables/interactions/use-focus.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,gBAAgB,EAOtB,MAAM,KAAK,CAAA;AACZ,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAA;AAC7E,OAAO,KAAK,EAAE,IAAI,EAAY,MAAM,6CAA6C,CAAA;AAkBjF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,eAAoB,GAC5B,cAAc,CA8NhB;AAMD,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAEnC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAE/C;;OAEG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB"}

package/dist/composables/interactions/use-hover.d.ts

@@ -1,6 +1,6 @@
 import { MaybeRef } from 'vue';
-import { TreeNode } from '../use-floating-tree';
-import { FloatingContext } from '../use-floating';
+import { TreeNode } from '../positioning/use-floating-tree';
+import { FloatingContext } from '../positioning/use-floating';
 import { SafePolygonOptions } from './polygon';
 export interface UseHoverOptions {
     /**

package/dist/composables/interactions/use-hover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-hover.d.ts","sourceRoot":"","sources":["../../../src/composables/interactions/use-hover.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,QAAQ,EAKd,MAAM,KAAK,CAAA;AACZ,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAE/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,EAAE,KAAK,kBAAkB,EAAe,MAAM,WAAW,CAAA;AAWhE,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAE3B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAE5D;;;;;OAKG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IAEzB;;;OAGG;IACH,SAAS,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAE7B;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,QAAQ,CAAC,OAAO,GAAG,kBAAkB,CAAC,CAAA;CACrD;AAiED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC,EACpD,OAAO,GAAE,eAAoB,GAC5B,IAAI,CA8ON"}
+{"version":3,"file":"use-hover.d.ts","sourceRoot":"","sources":["../../../src/composables/interactions/use-hover.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,QAAQ,EAKd,MAAM,KAAK,CAAA;AACZ,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6CAA6C,CAAA;AAE3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,EAAE,KAAK,kBAAkB,EAAe,MAAM,WAAW,CAAA;AAWhE,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAE3B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAE5D;;;;;OAKG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IAEzB;;;OAGG;IACH,SAAS,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAE7B;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,QAAQ,CAAC,OAAO,GAAG,kBAAkB,CAAC,CAAA;CACrD;AAqED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC,EACpD,OAAO,GAAE,eAAoB,GAC5B,IAAI,CA8ON"}

package/dist/composables/middlewares/arrow.d.ts

@@ -14,13 +14,12 @@ export interface ArrowMiddlewareOptions {
     element: Ref<HTMLElement | null>;
 }
 /**
- * Positions an inner element of the floating element such that it is centered to the reference element.
+ * Positions an inner element of the floating element such that it is centered to the anchor element.
  *
  * This middleware is used to position arrow elements within floating elements.
  *
  * @param options - The arrow options including padding and element reference
  * @returns A middleware function for arrow positioning
- * @see https://floating-ui.com/docs/arrow
  */
 export declare function arrow(options: ArrowMiddlewareOptions): Middleware;
 //# sourceMappingURL=arrow.d.ts.map

package/dist/composables/middlewares/arrow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arrow.d.ts","sourceRoot":"","sources":["../../../src/composables/middlewares/arrow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAE3D,OAAO,EAAE,KAAK,GAAG,EAAW,MAAM,KAAK,CAAA;AAMvC;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;OAEG;IACH,OAAO,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;CACjC;AAMD;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,sBAAsB,GAAG,UAAU,CAcjE"}
+{"version":3,"file":"arrow.d.ts","sourceRoot":"","sources":["../../../src/composables/middlewares/arrow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAE3D,OAAO,EAAE,KAAK,GAAG,EAAW,MAAM,KAAK,CAAA;AAMvC;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;OAEG;IACH,OAAO,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;CACjC;AAMD;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,sBAAsB,GAAG,UAAU,CAcjE"}

package/dist/composables/middlewares/index.d.ts

@@ -1,2 +1,4 @@
-export { arrow, autoPlacement, flip, hide, offset, shift, size } from '@floating-ui/dom';
+export type { Middleware, Placement, Strategy } from '@floating-ui/dom';
+export { autoPlacement, flip, hide, offset, shift, size } from '@floating-ui/dom';
+export { arrow } from './arrow';
 //# sourceMappingURL=index.d.ts.map

package/dist/composables/middlewares/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/composables/middlewares/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/composables/middlewares/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AACvE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACjF,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA"}

package/dist/composables/positioning/index.d.ts

@@ -0,0 +1,5 @@
+export * from './use-arrow';
+export * from './use-client-point';
+export * from './use-floating';
+export * from './use-floating-tree';
+//# sourceMappingURL=index.d.ts.map

package/dist/composables/positioning/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/composables/positioning/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA"}

package/dist/composables/positioning/use-arrow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-arrow.d.ts","sourceRoot":"","sources":["../../../src/composables/positioning/use-arrow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAE3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAMrD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAE3B;;OAEG;IACH,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAE3B;;OAEG;IACH,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,EAChC,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,eAAoB,GAC5B,cAAc,CAyDhB"}

package/dist/composables/{interactions → positioning}/use-client-point.d.ts

@@ -1,6 +1,6 @@
-import { VirtualElement } from '@floating-ui/dom';
 import { MaybeRefOrGetter, Ref } from 'vue';
-import { AnchorElement } from '../use-floating';
+import { VirtualElement } from '../../types';
+import { AnchorElement } from './use-floating';
 /**
  * Represents 2D coordinates with optional null values for unset states
  */

package/dist/composables/positioning/use-client-point.d.ts.map

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

package/dist/composables/positioning/use-floating-tree.d.ts

@@ -0,0 +1,240 @@
+import { Ref } from 'vue';
+import { AnchorElement, FloatingContext, FloatingElement, UseFloatingOptions } from './use-floating';
+/**
+ * Options for creating a TreeNode
+ */
+export interface CreateTreeNodeOptions {
+    /** Optional ID for the node. If not provided, one will be generated. */
+    id?: string;
+}
+/**
+ * Options for configuring tree behavior
+ */
+export interface CreateTreeOptions {
+    /** Strategy for deleting child nodes when a parent is deleted.
+     * - 'orphan': Children are detached from the tree (parent becomes null).
+     * - 'recursive': Children are also deleted recursively.
+     * @default 'recursive'
+     */
+    deleteStrategy?: "orphan" | "recursive";
+}
+interface AddNodeOptions extends UseFloatingOptions {
+    /**
+     * Parent node ID for tree hierarchy.
+     * @default undefined
+     */
+    parentId?: string;
+}
+/**
+ * Represents a single node in a tree structure with hierarchical relationships.
+ *
+ * A TreeNode maintains references to its parent and children, allowing bidirectional
+ * traversal of the tree. Each node stores generic data and provides methods for
+ * tree navigation and manipulation.
+ *
+ * @template T The type of data stored in the node
+ *
+ * @example
+ * ```ts
+ * const node = createTreeNode({ name: 'Parent' });
+ * const childNode = createTreeNode({ name: 'Child' }, node);
+ * node.addChild(childNode);
+ * ```
+ */
+export interface TreeNode<T> {
+    /**
+     * Unique identifier for this node
+     */
+    readonly id: string;
+    /**
+     * The data stored in this node
+     */
+    readonly data: T;
+    /**
+     * Reference to the parent node, or null if this is the root
+     */
+    readonly parent: Ref<TreeNode<T> | null>;
+    /**
+     * Array of child nodes
+     */
+    readonly children: Ref<TreeNode<T>[]>;
+    /**
+     * Whether this node is the root of the tree
+     */
+    readonly isRoot: boolean;
+    /**
+     * Computed property indicating whether this node has no children
+     */
+    readonly isLeaf: Readonly<Ref<boolean>>;
+    /**
+     * Adds a child node to this node's children array
+     */
+    addChild: (childNode: TreeNode<T>) => void;
+    /**
+     * Internal method to remove a child instance from this node
+     */
+    _removeChildInstance: (childNode: TreeNode<T>) => boolean;
+    /**
+     * Finds the first immediate child matching the predicate
+     */
+    findChild: (predicate: (node: TreeNode<T>) => boolean) => TreeNode<T> | null;
+    /**
+     * Recursively finds the first descendant matching the predicate
+     */
+    findDescendant: (predicate: (node: TreeNode<T>) => boolean) => TreeNode<T> | null;
+    /**
+     * Checks if this node is a descendant of the given ancestor
+     */
+    isDescendantOf: (potentialAncestor: TreeNode<T>) => boolean;
+    /**
+     * Returns the path from root to this node (inclusive)
+     */
+    getPath: () => TreeNode<T>[];
+}
+/**
+ * Core tree data structure for managing hierarchical node relationships.
+ *
+ * Provides methods for adding, removing, moving, and traversing nodes.
+ * Maintains a root node and a map of all nodes for efficient lookups.
+ * Supports both orphaning and recursive deletion strategies.
+ *
+ * @template T The type of data stored in tree nodes
+ *
+ * @example
+ * ```ts
+ * const tree = createTree<{ name: string }>();
+ * const child = tree.addNode({ name: 'Child' }, tree.root?.id);
+ * tree.traverse('dfs'); // Get all nodes in depth-first order
+ * ```
+ */
+export interface Tree<T> {
+    /**
+     * The root node of the tree, or null if empty
+     */
+    readonly root: TreeNode<T> | null;
+    /**
+     * Read-only map of all nodes indexed by their ID for O(1) lookups
+     */
+    readonly nodeMap: Readonly<Map<string, TreeNode<T>>>;
+    /**
+     * Finds a node by its ID anywhere in the tree
+     */
+    findNodeById: (id: string) => TreeNode<T> | null;
+    /**
+     * Adds a new node to the tree as a child of the specified parent
+     */
+    addNode: (data: T, parentId?: string | null, nodeOptions?: CreateTreeNodeOptions) => TreeNode<T> | null;
+    /**
+     * Removes a node from the tree using the specified deletion strategy
+     */
+    removeNode: (nodeId: string, deleteStrategy?: "orphan" | "recursive") => boolean;
+    /**
+     * Moves a node to become a child of a different parent
+     */
+    moveNode: (nodeId: string, newParentId: string | null) => boolean;
+    /**
+     * Traverses the tree using DFS or BFS strategy, optionally starting from a specific node
+     */
+    traverse: (strategy?: "dfs" | "bfs", startNode?: TreeNode<T> | null) => TreeNode<T>[];
+    /**
+     * Clears all nodes from the tree to allow garbage collection
+     */
+    dispose: () => void;
+}
+/**
+ * Configuration options for the floating tree
+ */
+export interface FloatingTreeOptions extends CreateTreeOptions {
+}
+/**
+ * Return type for the useFloatingTree composable.
+ *
+ * Extends the base Tree interface with floating-specific methods for managing
+ * a hierarchical tree of floating UI elements. Each node wraps a FloatingContext
+ * and provides methods to query and manipulate open states across the tree.
+ *
+ * @example
+ * ```ts
+ * const tree = useFloatingTree();
+ * const childNode = tree.addNode(anchorEl, floatingEl, { parentId: tree.root?.id });
+ * const deepest = tree.getDeepestOpenNode();
+ * tree.applyToNodes(childNode.id, (node) => node.data.setOpen(false), {
+ *   relationship: 'descendants-only'
+ * });
+ * ```
+ */
+export interface UseFloatingTreeReturn extends Omit<Tree<FloatingContext>, "addNode" | "root"> {
+    /**
+     * The root node of the floating tree
+     */
+    root: TreeNode<FloatingContext> | null;
+    /**
+     * Adds a new floating element node to the tree with the specified anchor and floating elements
+     */
+    addNode: (anchorEl: Ref<AnchorElement>, floatingEl: Ref<FloatingElement>, options?: AddNodeOptions) => TreeNode<FloatingContext> | null;
+    /**
+     * Returns an array of all nodes that are currently open
+     */
+    getAllOpenNodes: () => TreeNode<FloatingContext>[];
+    /**
+     * Returns the deepest (most nested) open node in the tree, or null if none are open
+     */
+    getDeepestOpenNode: () => TreeNode<FloatingContext> | null;
+    /**
+     * Executes a provided function once for each tree node that matches the specified relationship.
+     * This is a flexible iteration method that can target nodes based on their relationship to a target node.
+     *
+     * @param nodeId - The ID of the target node used as a reference point for the relationship
+     * @param callback - A function to execute for each matching node
+     * @param options - Configuration options for the iteration behavior
+     */
+    applyToNodes: (nodeId: string, callback: (node: TreeNode<FloatingContext>) => void, options?: {
+        relationship?: NodeRelationship;
+        applyToMatching?: boolean;
+    }) => void;
+}
+/**
+ * Predefined node relationship strategies used for filtering nodes.
+ */
+type NodeRelationship = "ancestors-only" | "siblings-only" | "descendants-only" | "children-only" | "self-and-ancestors" | "self-and-children" | "self-and-descendants" | "self-and-siblings" | "self-ancestors-and-children" | "full-branch" | "all-except-branch";
+/**
+ * Creates and manages a hierarchical tree of floating elements.
+ *
+ * Each node in the tree is assigned a stable ID. For non-root nodes, `addNode` generates
+ * the ID and injects it into the created FloatingContext (passed to `useFloating`).
+ * Consumers should not provide a custom `id` in `UseFloatingOptions` when using `addNode`;
+ * it will be ignored in favor of the generated one.
+ *
+ * @param treeOptions - Options for tree behavior
+ * @returns UseFloatingTreeReturn with tree management methods and root context
+ */
+export declare function useFloatingTree(treeOptions?: FloatingTreeOptions): UseFloatingTreeReturn;
+/**
+ * Creates a reactive tree node with data, parent reference, and children references.
+ * @param data The data to store in the node
+ * @param parent The parent node, or null for root nodes
+ * @param options Configuration options for the node
+ * @param isRoot Whether this node is the true root of a tree
+ * @returns A reactive tree node object with methods and reactive properties
+ */
+export declare function createTreeNode<T>(data: T, parent?: TreeNode<T> | null, options?: CreateTreeNodeOptions, isRoot?: boolean): TreeNode<T>;
+/**
+ * Creates and manages a reactive tree structure.
+ *
+ * This factory function provides a complete tree data structure with reactive nodes,
+ * supporting operations like adding, removing, and moving nodes, as well as
+ * traversal and search functionality.
+ *
+ * @template T The type of data stored in the tree nodes.
+ * @param options Configuration options for the tree behavior.
+ * @returns A tree management object with methods and reactive properties
+ *
+ * @example
+ * ```ts
+ * const myTree = createTree<{ name: string }>();
+ * const childNode = myTree.addNode({ name: 'Child' }, myTree.root?.id);
+ * ```
+ */
+export declare function createTree<T>(options?: CreateTreeOptions): Tree<T>;
+export {};
+//# sourceMappingURL=use-floating-tree.d.ts.map

package/dist/composables/positioning/use-floating-tree.d.ts.map

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

package/dist/composables/{use-floating.d.ts → positioning/use-floating.d.ts}

@@ -1,5 +1,6 @@
-import { AutoUpdateOptions, Middleware, MiddlewareData, Placement, Strategy, VirtualElement } from '@floating-ui/dom';
+import { AutoUpdateOptions, Middleware, MiddlewareData, Placement, Strategy } from '@floating-ui/dom';
 import { MaybeRefOrGetter, Ref } from 'vue';
+import { OpenChangeReason, VirtualElement } from '../../types';
 /**
  * Type for anchor element in floating UI
  */
@@ -39,6 +40,12 @@ export type FloatingStyles = {
  * Options for configuring floating element behavior
  */
 export interface UseFloatingOptions {
+    /**
+     * Optional stable identifier for this floating context.
+     * Only relevant for tree-aware behavior and typically generated by `useFloatingTree().addNode(...)`.
+     * Standalone usage should omit this.
+     */
+    id?: string;
     /**
      * Where to place the floating element relative to its anchor element.
      * @default 'bottom'
@@ -60,26 +67,28 @@ export interface UseFloatingOptions {
     middlewares?: MaybeRefOrGetter<Middleware[]>;
     /**
      * Whether to automatically update the position of the floating element.
-     * Can be a boolean or an `AutoUpdateOptions` object.
      * @default true
      */
     autoUpdate?: boolean | AutoUpdateOptions;
     /**
-     * Whether the floating element is open.
-     * @default false
-     */
+   * Whether the floating element is open.
+   * @default false
+   */
     open?: Ref<boolean>;
     /**
-     * Parent node ID for tree hierarchy.
-     * Used when adding nodes to floating trees.
-     * @default null
+     * Callback invoked whenever the open state changes via setOpen.
+     * Provides the new state, the reason, and the triggering DOM event (if any).
      */
-    parentId?: string | null;
+    onOpenChange?: (open: boolean, reason: OpenChangeReason, event?: Event) => void;
 }
 /**
  * Context object returned by useFloating containing all necessary data and methods
  */
 export interface FloatingContext {
+    /**
+     * Stable identifier for this floating context. Used for tree-aware interactions.
+     */
+    id?: string;
     /**
      * The x-coordinate of the floating element
      */
@@ -127,7 +136,7 @@ export interface FloatingContext {
     /**
      * Function to explicitly set the open state of the floating element.
      */
-    setOpen: (open: boolean) => void;
+    setOpen: (open: boolean, reason?: OpenChangeReason, event?: Event) => void;
 }
 /**
  * Composable function that provides positioning for a floating element relative to an anchor element

package/dist/composables/positioning/use-floating.d.ts.map

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

package/dist/types.d.ts

@@ -1,3 +1,18 @@
 export type AnyFn<T extends unknown[] = unknown[], U = unknown> = (...args: T) => U;
 export type Fn = () => void;
+/**
+ * Minimal VirtualElement interface compatible with Floating UI expectations.
+ * Provides a bounding client rect and an optional context element for layout.
+ */
+export interface VirtualElement {
+    getBoundingClientRect: () => DOMRect;
+    /**
+     * Optional context element used by Floating UI to resolve layout metrics.
+     */
+    contextElement?: Element;
+}
+/**
+ * Primary interaction reasons for open state changes. Minimal and extensible.
+ */
+export type OpenChangeReason = "anchor-click" | "keyboard-activate" | "outside-pointer" | "focus" | "blur" | "hover" | "escape-key" | "tree-ancestor-close" | "programmatic";
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,CAAA;AACnF,MAAM,MAAM,EAAE,GAAG,MAAM,IAAI,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,CAAA;AACnF,MAAM,MAAM,EAAE,GAAG,MAAM,IAAI,CAAA;AAE3B;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,qBAAqB,EAAE,MAAM,OAAO,CAAA;IACpC;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,cAAc,GACd,mBAAmB,GACnB,iBAAiB,GACjB,OAAO,GACP,MAAM,GACN,OAAO,GACP,YAAY,GACZ,qBAAqB,GACrB,cAAc,CAAA"}

package/dist/utils.d.ts

@@ -1,15 +1,92 @@
-import { AnyFn } from './types';
+import { AnyFn, VirtualElement } from './types';
+import { FloatingContext } from './composables/positioning/use-floating';
+import { TreeNode } from './composables/positioning/use-floating-tree';
 /**
- * Generates a unique ID.
- * The ID is incremented with each call.
- * @returns A unique string ID.
+ * Wrapper around Vue's useId that provides a fallback counter-based ID generator.
+ * This ensures unique IDs even when useId() returns empty strings (e.g., in test environments).
  */
 export declare function useId(): string;
 /**
  * Checks if a value is a function
- * @param value - The value to check
- * @returns True if the value is a function, false otherwise
  */
 export declare function isFunction(value: unknown): value is AnyFn;
-export declare function isHTMLElement(value: unknown): value is HTMLElement;
+/**
+ * Type guard for HTMLElement
+ */
+export declare function isHTMLElement(value: unknown | null): value is HTMLElement;
+/**
+ * Checks if the user agent is on a Mac.
+ */
+export declare function isMac(): boolean;
+/**
+ * Checks if the browser is Safari.
+ */
+export declare function isSafari(): boolean;
+/**
+ * A simple utility to check if an element matches `:focus-visible`.
+ */
+export declare function matchesFocusVisible(element: Element): boolean;
+/**
+ * Checks if the pointer type is mouse-like (mouse or pen).
+ */
+export declare function isMouseLikePointerType(pointerType: string | undefined, strict?: boolean): boolean;
+/**
+ * Checks if the element is an input, textarea, or contenteditable element.
+ */
+export declare function isTypeableElement(element: Element | null): boolean;
+/**
+ * Checks if the event target is a button-like element.
+ */
+export declare function isButtonTarget(event: KeyboardEvent): boolean;
+/**
+ * Checks if the Space key press should be ignored for the given element.
+ */
+export declare function isSpaceIgnored(element: Element | null): boolean;
+/**
+ * Checks if the value is a VirtualElement.
+ */
+export declare function isVirtualElement(el: unknown): el is VirtualElement;
+/**
+ * Checks if the event target is within the given element.
+ */
+export declare function isEventTargetWithin(event: Event, element: Element | null | undefined): boolean;
+/**
+ * Checks if a click event occurred on a scrollbar.
+ */
+export declare function isClickOnScrollbar(event: MouseEvent, target: HTMLElement): boolean;
+/**
+ * Simple element containment wrapper.
+ */
+export declare function contains(el: HTMLElement, target: Element | null): boolean;
+/**
+ * Event target extraction utility.
+ */
+export declare function getTarget(event: MouseEvent | TouchEvent): Element | null;
+/**
+ * Safe performance timing that handles environments without performance API.
+ */
+export declare function getCurrentTime(): number;
+/**
+ * Centralized timeout management to prevent memory leaks.
+ */
+export declare function clearTimeoutIfSet(timeoutId: number): void;
+/**
+ * Type guard to determine if the context parameter is a TreeNode.
+ */
+export declare function isTreeNode(context: FloatingContext | TreeNode<FloatingContext>): context is TreeNode<FloatingContext>;
+/**
+ * Extracts floating context and tree context from the parameter.
+ */
+export declare function getContextFromParameter(context: FloatingContext | TreeNode<FloatingContext>): {
+    floatingContext: FloatingContext;
+    treeContext: TreeNode<FloatingContext> | null;
+};
+/**
+ * Checks if a target node is within an anchor or floating element, handling VirtualElement.
+ */
+export declare function isTargetWithinElement(target: Node, element: unknown): boolean;
+/**
+ * Finds a descendant node that contains the target element.
+ */
+export declare function findDescendantContainingTarget(node: TreeNode<FloatingContext>, target: Node): TreeNode<FloatingContext> | null;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAGpC;;;;GAIG;AACH,wBAAgB,KAAK,IAAI,MAAM,CAE9B;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEzD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAKpC;;;GAGG;AACH,wBAAgB,KAAK,IAAI,MAAM,CAI9B;AAED,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAA;AAC7E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6CAA6C,CAAA;AAM3E;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEzD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,KAAK,IAAI,WAAW,CAEzE;AAMD;;GAEG;AACH,wBAAgB,KAAK,IAAI,OAAO,CAG/B;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAGlC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG7D;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAIjG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAOlE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAQ5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAE/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,cAAc,CAElE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAM9F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CA0BlF;AAMD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAEzE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,IAAI,CAExE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAIzD;AAMD;;GAEG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC,GACnD,OAAO,IAAI,QAAQ,CAAC,eAAe,CAAC,CAStC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC,GACnD;IACD,eAAe,EAAE,eAAe,CAAA;IAChC,WAAW,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,IAAI,CAAA;CAC9C,CAWA;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAkB7E;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,EAC/B,MAAM,EAAE,IAAI,GACX,QAAQ,CAAC,eAAe,CAAC,GAAG,IAAI,CAgBlC"}