v-float 0.7.2 → 0.9.0

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

@@ -25,28 +25,120 @@ interface AddNodeOptions extends UseFloatingOptions {
      */
     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> {
-    readonly root: TreeNode<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;
 }
 /**
@@ -54,10 +146,40 @@ export interface Tree<T> {
  */
 export interface FloatingTreeOptions extends CreateTreeOptions {
 }
-export interface UseFloatingTreeReturn extends Omit<Tree<FloatingContext>, "addNode"> {
+/**
+ * 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>[];
-    getTopmostOpenNode: () => TreeNode<FloatingContext> | null;
+    /**
+     * 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.
@@ -78,13 +200,15 @@ type NodeRelationship = "ancestors-only" | "siblings-only" | "descendants-only"
 /**
  * Creates and manages a hierarchical tree of floating elements.
  *
- * @param anchorEl - The anchor element for the root floating context
- * @param floatingEl - The floating element for the root floating context
- * @param options - Options for the root floating context
+ * 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(anchorEl: Ref<AnchorElement>, floatingEl: Ref<FloatingElement>, options?: UseFloatingOptions, treeOptions?: FloatingTreeOptions): UseFloatingTreeReturn;
+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
@@ -102,16 +226,15 @@ export declare function createTreeNode<T>(data: T, parent?: TreeNode<T> | null,
  * traversal and search functionality.
  *
  * @template T The type of data stored in the tree nodes.
- * @param initialRootData Data for the root node.
  * @param options Configuration options for the tree behavior.
  * @returns A tree management object with methods and reactive properties
  *
  * @example
  * ```ts
- * const myTree = createTree({ name: 'Root' });
- * const childNode = myTree.addNode({ name: 'Child' }, myTree.root.id);
+ * const myTree = createTree<{ name: string }>();
+ * const childNode = myTree.addNode({ name: 'Child' }, myTree.root?.id);
  * ```
  */
-export declare function createTree<T>(initialRootData: T, options?: CreateTreeOptions): Tree<T>;
+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":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAE9B,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,eAAe,EACf,kBAAkB,EACnB,MAAM,gBAAgB,CAAA;AAOvB;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAEhC;;;;OAIG;IACH,cAAc,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAA;CACxC;AAED,UAAU,cAAe,SAAQ,kBAAkB;IACjD;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;IAChB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IACxC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IACrC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAA;IACvC;;OAEG;IACH,QAAQ,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;IAC1C;;OAEG;IACH,oBAAoB,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,OAAO,CAAA;IACzD;;OAEG;IACH,SAAS,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IAC5E;;OAEG;IACH,cAAc,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IACjF;;OAEG;IACH,cAAc,EAAE,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,OAAO,CAAA;IAC3D;;OAEG;IACH,OAAO,EAAE,MAAM,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAA;CAC7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,IAAI,CAAC,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IACjC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACpD;;OAEG;IACH,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IAChD;;OAEG;IACH,OAAO,EAAE,CACP,IAAI,EAAE,CAAC,EACP,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EACxB,WAAW,CAAC,EAAE,qBAAqB,KAChC,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IACvB;;OAEG;IACH,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,QAAQ,GAAG,WAAW,KAAK,OAAO,CAAA;IAChF;;OAEG;IACH,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAA;IACjE;;OAEG;IACH,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAA;IACrF;;OAEG;IACH,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;CAAG;AAEjE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,qBACf,SAAQ,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IACvD;;OAEG;IACH,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,IAAI,CAAA;IACtC;;OAEG;IACH,OAAO,EAAE,CACP,QAAQ,EAAE,GAAG,CAAC,aAAa,CAAC,EAC5B,UAAU,EAAE,GAAG,CAAC,eAAe,CAAC,EAChC,OAAO,CAAC,EAAE,cAAc,KACrB,QAAQ,CAAC,eAAe,CAAC,GAAG,IAAI,CAAA;IACrC;;OAEG;IACH,eAAe,EAAE,MAAM,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAA;IAClD;;OAEG;IACH,kBAAkB,EAAE,MAAM,QAAQ,CAAC,eAAe,CAAC,GAAG,IAAI,CAAA;IAC1D;;;;;;;OAOG;IACH,YAAY,EAAE,CACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,KAAK,IAAI,EACnD,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,gBAAgB,CAAA;QAC/B,eAAe,CAAC,EAAE,OAAO,CAAA;KAC1B,KACE,IAAI,CAAA;CACV;AAED;;GAEG;AACH,KAAK,gBAAgB,GACjB,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,eAAe,GACf,oBAAoB,GACpB,mBAAmB,GACnB,sBAAsB,GACtB,mBAAmB,GACnB,6BAA6B,GAC7B,aAAa,GACb,mBAAmB,CAAA;AAqBvB;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,WAAW,GAAE,mBAAwB,GAAG,qBAAqB,CA+L5F;AAMD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,IAAI,EAAE,CAAC,EACP,MAAM,GAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAW,EACjC,OAAO,GAAE,qBAA0B,EACnC,MAAM,UAAQ,GACb,QAAQ,CAAC,CAAC,CAAC,CAiEb;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC,CAAC,CAAC,CAmPlE"}

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,20 +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>;
+    /**
+     * Callback invoked whenever the open state changes via setOpen.
+     * Provides the new state, the reason, and the triggering DOM event (if any).
+     */
+    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
      */
@@ -121,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/composables/utils/is-using-keyboard.d.ts

@@ -0,0 +1,2 @@
+export declare const isUsingKeyboard: Readonly<import('vue').Ref<boolean, boolean>>;
+//# sourceMappingURL=is-using-keyboard.d.ts.map

package/dist/composables/utils/is-using-keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-using-keyboard.d.ts","sourceRoot":"","sources":["../../../src/composables/utils/is-using-keyboard.ts"],"names":[],"mappings":"AAkCA,eAAO,MAAM,eAAe,+CAAuB,CAAA"}

package/dist/composables/utils/use-active-descendant.d.ts

@@ -0,0 +1,8 @@
+import { ComputedRef, MaybeRefOrGetter, Ref } from 'vue';
+export interface UseActiveDescendantOptions {
+    virtual: MaybeRefOrGetter<boolean>;
+    open: Ref<boolean>;
+    virtualItemRef?: Ref<HTMLElement | null>;
+}
+export declare function useActiveDescendant(anchorEl: ComputedRef<HTMLElement | null>, listRef: Ref<Array<HTMLElement | null>>, activeIndex: MaybeRefOrGetter<number | null>, options: UseActiveDescendantOptions): void;
+//# sourceMappingURL=use-active-descendant.d.ts.map

package/dist/composables/utils/use-active-descendant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-active-descendant.d.ts","sourceRoot":"","sources":["../../../src/composables/utils/use-active-descendant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,GAAG,EAAkB,MAAM,KAAK,CAAA;AAEjG,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAClC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IAClB,cAAc,CAAC,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;CACzC;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,WAAW,CAAC,WAAW,GAAG,IAAI,CAAC,EACzC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,EACvC,WAAW,EAAE,gBAAgB,CAAC,MAAM,GAAG,IAAI,CAAC,EAC5C,OAAO,EAAE,0BAA0B,GAClC,IAAI,CAmBN"}

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"}