v-float 0.4.0 → 0.6.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 V-Float
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+MIT License
+
+Copyright (c) 2025 V-Float
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.

package/dist/composables/index.d.ts

@@ -1,7 +1,6 @@
-export * from './use-floating';
-export * from './use-arrow';
 export * from './interactions';
 export * from './middlewares';
-export * from './use-tree';
+export * from './use-arrow';
+export * from './use-floating';
 export * from './use-floating-tree';
 //# sourceMappingURL=index.d.ts.map

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

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

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

@@ -1,7 +1,7 @@
-export * from './use-hover';
-export * from './use-focus';
 export * from './use-click';
-export * from './use-client-point';
+export { type AxisConstraint, type Coordinates, type TrackingMode, type UseClientPointContext, type UseClientPointOptions, type UseClientPointReturn, useClientPoint, } from './use-client-point';
 export * from './use-escape-key';
+export * from './use-focus';
+export * from './use-hover';
 export * from './utils';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/composables/interactions/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/composables/interactions/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,cAAc,GACf,MAAM,oBAAoB,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA"}

package/dist/composables/interactions/polygon.d.ts

@@ -1,4 +1,4 @@
-import { TreeNode } from '../use-tree';
+import { TreeNode } from '../use-floating-tree';
 import { AnchorElement, FloatingContext, FloatingElement } from '../use-floating';
 type Point = [number, number];
 type Polygon = Point[];

package/dist/composables/interactions/polygon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"polygon.d.ts","sourceRoot":"","sources":["../../../src/composables/interactions/polygon.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAGtD,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAGtF,KAAK,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAC7B,KAAK,OAAO,GAAG,KAAK,EAAE,CAAA;AAoDtB,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CAC7C;AAED,MAAM,WAAW,+BAA+B;IAC9C,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,SAAS,EAAE,eAAe,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAA;IAChD,QAAQ,EAAE;QACR,YAAY,EAAE,aAAa,GAAG,IAAI,CAAA;QAClC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAA;KACjC,CAAA;IACD,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAA;KAAE,CAAA;CACzD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB;cAsCJ,+BAA+B,WAehD,UAAU;;;;EAiVhD"}
+{"version":3,"file":"polygon.d.ts","sourceRoot":"","sources":["../../../src/composables/interactions/polygon.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAGtF,KAAK,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAC7B,KAAK,OAAO,GAAG,KAAK,EAAE,CAAA;AAoDtB,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CAC7C;AAED,MAAM,WAAW,+BAA+B;IAC9C,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,SAAS,EAAE,eAAe,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAA;IAChD,QAAQ,EAAE;QACR,YAAY,EAAE,aAAa,GAAG,IAAI,CAAA;QAClC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAA;KACjC,CAAA;IACD,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAA;KAAE,CAAA;CACzD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB;cAsCJ,+BAA+B,WAehD,UAAU;;;;EAiVhD"}

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

@@ -1,6 +1,6 @@
-import { FloatingContext } from '..';
-import { TreeNode } from '../use-tree';
 import { MaybeRefOrGetter } from 'vue';
+import { FloatingContext } from '..';
+import { TreeNode } from '../use-floating-tree';
 /**
  * Enables showing/hiding the floating element when clicking the reference element
  * and optionally when clicking outside both the reference and floating elements.

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

@@ -1 +1 @@
-{"version":3,"file":"use-click.d.ts","sourceRoot":"","sources":["../../../src/composables/interactions/use-click.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAGtD,OAAO,EAAE,KAAK,gBAAgB,EAAwD,MAAM,KAAK,CAAA;AAkBjG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC,EACpD,OAAO,GAAE,eAAoB,GAC5B,IAAI,CAiQN;AA0CD;;GAEG;AACH,MAAM,WAAW,eAAe;IAG9B;;;OAGG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAEnC;;;;OAIG;IACH,KAAK,CAAC,EAAE,gBAAgB,CAAC,OAAO,GAAG,WAAW,CAAC,CAAA;IAE/C;;;OAGG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAElC;;;OAGG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAEvC;;;OAGG;IACH,cAAc,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAE1C;;;OAGG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAIvC;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAExC;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC,aAAa,GAAG,WAAW,GAAG,OAAO,CAAC,CAAA;IAEtE;;;OAGG;IACH,cAAc,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAE1C;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,KAAK,IAAI,CAAA;IAEtE;;;OAGG;IACH,qBAAqB,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAEjD;;;OAGG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;CAC7C"}
+{"version":3,"file":"use-click.d.ts","sourceRoot":"","sources":["../../../src/composables/interactions/use-click.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,gBAAgB,EAA8C,MAAM,KAAK,CAAA;AACjG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAiB/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC,EACpD,OAAO,GAAE,eAAoB,GAC5B,IAAI,CA6PN;AA0CD;;GAEG;AACH,MAAM,WAAW,eAAe;IAG9B;;;OAGG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAEnC;;;;OAIG;IACH,KAAK,CAAC,EAAE,gBAAgB,CAAC,OAAO,GAAG,WAAW,CAAC,CAAA;IAE/C;;;OAGG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAElC;;;OAGG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAEvC;;;OAGG;IACH,cAAc,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAE1C;;;OAGG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAIvC;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAExC;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC,aAAa,GAAG,WAAW,GAAG,OAAO,CAAC,CAAA;IAEtE;;;OAGG;IACH,cAAc,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAE1C;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,KAAK,IAAI,CAAA;IAEtE;;;OAGG;IACH,qBAAqB,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAEjD;;;OAGG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;CAC7C"}

package/dist/composables/interactions/use-client-point.d.ts

@@ -1,25 +1,35 @@
-import { FloatingContext } from '..';
+import { VirtualElement } from '@floating-ui/dom';
 import { MaybeRefOrGetter, Ref } from 'vue';
+import { AnchorElement } from '../use-floating';
 /**
- * Positions the floating element relative to a client point (mouse position).
- *
- * This composable tracks pointer movements and positions the floating element
- * accordingly, with options for axis locking and controlled coordinates.
- *
- * @param pointerTarget - The DOM element whose bounding box is used as the reference for pointer event listeners and initial positioning.
- * @param context - The floating context with open state and position reference
- * @param options - Configuration options for client point behavior
- *
- * @example
- * ```ts
- * const context = useFloating(...)
- * useClientPoint(context, {
- *   axis: "x",
- *   enabled: true
- * })
- * ```
+ * Represents 2D coordinates with optional null values for unset states
+ */
+export interface Coordinates {
+    x: number | null;
+    y: number | null;
+}
+/**
+ * Axis constraint types for coordinate positioning
+ */
+export type AxisConstraint = "x" | "y" | "both";
+/**
+ * Tracking mode for client point positioning behavior
+ */
+export type TrackingMode = "follow" | "static";
+/**
+ * Processed pointer event data
+ */
+interface PointerEventData {
+    type: "pointerdown" | "pointermove" | "pointerenter";
+    coordinates: Coordinates;
+    originalEvent: PointerEvent;
+}
+/**
+ * Context for tracking strategy operations
  */
-export declare function useClientPoint(pointerTarget: Ref<HTMLElement | null>, context: FloatingContext, options?: UseClientPointOptions): UseClientPointReturn;
+interface TrackingContext {
+    isOpen: boolean;
+}
 export interface UseClientPointOptions {
     /**
      * Whether the Hook is enabled
@@ -30,7 +40,7 @@ export interface UseClientPointOptions {
      * Whether to restrict the client point to an axis
      * @default 'both'
      */
-    axis?: MaybeRefOrGetter<"x" | "y" | "both">;
+    axis?: MaybeRefOrGetter<AxisConstraint>;
     /**
      * Controlled x coordinate
      * @default null
@@ -41,6 +51,13 @@ export interface UseClientPointOptions {
      * @default null
      */
     y?: MaybeRefOrGetter<number | null>;
+    /**
+     * Tracking behavior mode:
+     * - "follow": Continuous cursor tracking (default)
+     * - "static": Position at initial interaction, no subsequent tracking
+     * @default "follow"
+     */
+    trackingMode?: TrackingMode;
 }
 export interface UseClientPointReturn {
     /**
@@ -55,4 +72,147 @@ export interface UseClientPointReturn {
      */
     updatePosition: (x: number, y: number) => void;
 }
+export interface UseClientPointContext {
+    open: Readonly<Ref<boolean>>;
+    refs: {
+        anchorEl: Ref<AnchorElement>;
+    };
+}
+/**
+ * Virtual element factory for floating positioning anchors.
+ * Creates virtual DOM elements that serve as positioning anchors.
+ */
+export declare class VirtualElementFactory {
+    private static readonly DEFAULT_DIMENSIONS;
+    /**
+     * Create a virtual anchor element
+     */
+    create(options: {
+        coordinates: Coordinates;
+        referenceElement?: HTMLElement | null;
+        baselineCoordinates?: Coordinates | null;
+        axis?: AxisConstraint;
+    }): VirtualElement;
+    /**
+     * Build configuration from options with defaults
+     */
+    private buildConfiguration;
+    /**
+     * Build the bounding rectangle for the virtual element
+     */
+    private buildBoundingRect;
+    /**
+     * Get reference element bounds with fallback
+     */
+    private getReferenceRect;
+    /**
+     * Resolve final position from coordinate sources
+     */
+    private resolvePosition;
+    /**
+     * Resolve coordinate for a single axis with clear precedence
+     */
+    private resolveAxisCoordinate;
+    /**
+     * Calculate virtual element size based on axis constraints
+     */
+    private calculateSize;
+    /**
+     * Build a DOMRect object
+     */
+    private buildDOMRect;
+}
+/**
+ * Abstract base class for tracking strategies
+ */
+export declare abstract class TrackingStrategy {
+    abstract readonly name: TrackingMode;
+    protected lastKnownCoordinates: Coordinates | null;
+    /**
+     * Process a pointer event and return coordinates if the strategy wants to update
+     * This is the heart of each strategy's behavior
+     */
+    abstract process(event: PointerEventData, context: TrackingContext): Coordinates | null;
+    /**
+     * Get the list of pointer events this strategy needs to listen for
+     * This allows strategies to optimize performance by only registering necessary events
+     */
+    abstract getRequiredEvents(): PointerEventData["type"][];
+    /**
+     * Get coordinates to use when the floating element opens
+     * This lets each strategy decide its opening behavior without client code needing to know the details
+     */
+    getCoordinatesForOpening(): Coordinates | null;
+    /**
+     * Called when the floating element closes
+     * This is where strategies should clean up any temporary state
+     */
+    onClose(): void;
+    /**
+     * Reset all strategy state - used when the composable is disabled or reset
+     */
+    reset(): void;
+}
+/**
+ * Strategy for continuous cursor tracking
+ */
+export declare class FollowTracker extends TrackingStrategy {
+    readonly name: "follow";
+    /**
+     * Follow strategy needs all pointer events for continuous tracking
+     */
+    getRequiredEvents(): PointerEventData["type"][];
+    /**
+     * Follow strategy: always update coordinates based on the current pointer position
+     * This creates smooth, continuous tracking behavior
+     */
+    process(event: PointerEventData, context: TrackingContext): Coordinates | null;
+}
+/**
+ * Strategy for static positioning at initial interaction
+ */
+export declare class StaticTracker extends TrackingStrategy {
+    readonly name: "static";
+    private triggerCoordinates;
+    /**
+     * Static strategy only needs click events, not hover or continuous movement
+     * This optimization avoids registering unnecessary pointer events
+     */
+    getRequiredEvents(): PointerEventData["type"][];
+    /**
+     * Static strategy: capture coordinates from trigger events, ignore movement
+     * This creates stable positioning that doesn't jump around
+     */
+    process(event: PointerEventData, context: TrackingContext): Coordinates | null;
+    /**
+     * Get coordinates to use when floating element opens
+     */
+    getCoordinatesForOpening(): Coordinates | null;
+    /**
+     * Reset tracking state
+     */
+    reset(): void;
+    onClose(): void;
+}
+/**
+ * Positions the floating element relative to a client point (mouse position).
+ *
+ * This composable tracks pointer movements and positions the floating element
+ * accordingly, with options for axis locking and controlled coordinates.
+ *
+ * @param pointerTarget - The DOM element whose bounding box is used as the reference for pointer event listeners and initial positioning.
+ * @param context - The floating context with open state and position reference
+ * @param options - Configuration options for client point behavior
+ *
+ * @example
+ * ```ts
+ * const context = useFloating(...)
+ * useClientPoint(context, {
+ *   axis: "x",
+ *   enabled: true
+ * })
+ * ```
+ */
+export declare function useClientPoint(pointerTarget: Ref<HTMLElement | null>, context: UseClientPointContext, options?: UseClientPointOptions): UseClientPointReturn;
+export {};
 //# sourceMappingURL=use-client-point.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-client-point.d.ts","sourceRoot":"","sources":["../../../src/composables/interactions/use-client-point.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAGpD,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,GAAG,EAOT,MAAM,KAAK,CAAA;AAOZ;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAC5B,aAAa,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,EACtC,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,qBAA0B,GAClC,oBAAoB,CA4EtB;AA8FD,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAEnC;;;OAGG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAC,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC,CAAA;IAE3C;;;OAGG;IACH,CAAC,CAAC,EAAE,gBAAgB,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAEnC;;;OAGG;IACH,CAAC,CAAC,EAAE,gBAAgB,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,WAAW,EAAE,QAAQ,CAAC,GAAG,CAAC;QAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC,CAAA;IAClE;;OAEG;IACH,cAAc,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/C"}
+{"version":3,"file":"use-client-point.d.ts","sourceRoot":"","sources":["../../../src/composables/interactions/use-client-point.ts"],"names":[],"mappings":"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"}

package/dist/composables/interactions/use-escape-key.d.ts

@@ -1,4 +1,6 @@
 import { MaybeRefOrGetter } from 'vue';
+import { FloatingContext } from '..';
+import { TreeNode } from '../use-floating-tree';
 export interface UseEscapeKeyOptions {
     /**
      * Condition to enable the escape key listener.
@@ -11,14 +13,45 @@ export interface UseEscapeKeyOptions {
      */
     capture?: boolean;
     /**
-     * Callback function to be executed when the escape key is pressed.
+     * Custom callback function to be executed when the escape key is pressed.
+     * When provided, overrides default behavior.
      */
-    onEscape: (event: KeyboardEvent) => void;
+    onEscape?: (event: KeyboardEvent) => void;
 }
 /**
- * A composable to handle the escape key press, with composition event handling.
+ * A composable to handle the escape key press with tree-aware behavior and composition event handling.
  *
+ * When passed a FloatingContext, it will close that floating element by setting open to false.
+ * When passed a TreeNode<FloatingContext>, it will find and close the topmost open node in the tree.
+ *
+ * @param context - The floating context or tree node with open state and change handler.
  * @param options - {@link UseEscapeKeyOptions}
+ *
+ * @example Basic standalone usage
+ * ```ts
+ * const context = useFloating(...)
+ * useEscapeKey(context) // Closes the floating element on escape
+ * ```
+ *
+ * @example Tree-aware usage
+ * ```ts
+ * const tree = useFloatingTree(...)
+ * const childNode = tree.addNode(...)
+ * useEscapeKey(childNode) // Closes the topmost open node in the tree
+ * ```
+ *
+ * @example Custom handler
+ * ```ts
+ * useEscapeKey(context, {
+ *   onEscape: (event) => {
+ *     if (hasUnsavedChanges.value) {
+ *       showConfirmDialog.value = true
+ *     } else {
+ *       context.setOpen(false)
+ *     }
+ *   }
+ * })
+ * ```
  */
-export declare function useEscapeKey(options: UseEscapeKeyOptions): void;
+export declare function useEscapeKey(context: FloatingContext | TreeNode<FloatingContext>, options?: UseEscapeKeyOptions): void;
 //# sourceMappingURL=use-escape-key.d.ts.map

package/dist/composables/interactions/use-escape-key.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-escape-key.d.ts","sourceRoot":"","sources":["../../../src/composables/interactions/use-escape-key.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,gBAAgB,EAAgB,MAAM,KAAK,CAAA;AAMzD,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAEnC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;OAEG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;CACzC;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAe/D"}
+{"version":3,"file":"use-escape-key.d.ts","sourceRoot":"","sources":["../../../src/composables/interactions/use-escape-key.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,gBAAgB,EAAgB,MAAM,KAAK,CAAA;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAO/D,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAEnC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;CAC1C;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC,EACpD,OAAO,GAAE,mBAAwB,GAChC,IAAI,CAiCN"}

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

@@ -1,6 +1,6 @@
-import { FloatingContext } from '..';
-import { TreeNode } from '../use-tree';
 import { MaybeRefOrGetter } from 'vue';
+import { FloatingContext } from '..';
+import { TreeNode } from '../use-floating-tree';
 /**
  * Enables showing/hiding the floating element when focusing the reference element.
  *

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":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEtD,OAAO,EACL,KAAK,gBAAgB,EAOtB,MAAM,KAAK,CAAA;AAgBZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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,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"}

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

@@ -1,5 +1,5 @@
-import { TreeNode } from '../use-tree';
 import { MaybeRef } from 'vue';
+import { TreeNode } from '../use-floating-tree';
 import { FloatingContext } from '../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":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAGtD,OAAO,EACL,KAAK,QAAQ,EAMd,MAAM,KAAK,CAAA;AACZ,OAAO,KAAK,EAAiB,eAAe,EAAmB,MAAM,iBAAiB,CAAA;AACtF,OAAO,EAAE,KAAK,kBAAkB,EAAe,MAAM,WAAW,CAAA;AAehE,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,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"}

package/dist/composables/interactions/utils/index.d.ts

@@ -4,8 +4,8 @@
  * This module exports shared helper functions to eliminate code duplication
  * across use-click, use-focus, use-hover, use-client-point, and polygon composables.
  */
-export { isTreeNode, getContextFromParameter, isTargetWithinElement, findDescendantContainingTarget, } from './tree-context';
-export { isMouseLikePointerType, isTypeableElement, isButtonTarget, isSpaceIgnored, isHTMLElement, isVirtualElement, isEventTargetWithin, isClickOnScrollbar, } from './element-detection';
 export { isMac, isSafari, matchesFocusVisible, } from './browser-detection';
-export { contains, getTarget, getCurrentTime, clearTimeoutIfSet, } from './event-utils';
+export { isButtonTarget, isClickOnScrollbar, isEventTargetWithin, isHTMLElement, isMouseLikePointerType, isSpaceIgnored, isTypeableElement, isVirtualElement, } from './element-detection';
+export { clearTimeoutIfSet, contains, getCurrentTime, getTarget, } from './event-utils';
+export { findDescendantContainingTarget, getContextFromParameter, isTargetWithinElement, isTreeNode, } from './tree-context';
 //# sourceMappingURL=index.d.ts.map

package/dist/composables/interactions/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/composables/interactions/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,UAAU,EACV,uBAAuB,EACvB,qBAAqB,EACrB,8BAA8B,GAC/B,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACL,KAAK,EACL,QAAQ,EACR,mBAAmB,GACpB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACL,QAAQ,EACR,SAAS,EACT,cAAc,EACd,iBAAiB,GAClB,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/composables/interactions/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,KAAK,EACL,QAAQ,EACR,mBAAmB,GACpB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,iBAAiB,EACjB,QAAQ,EACR,cAAc,EACd,SAAS,GACV,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,8BAA8B,EAC9B,uBAAuB,EACvB,qBAAqB,EACrB,UAAU,GACX,MAAM,gBAAgB,CAAA"}

package/dist/composables/interactions/utils/tree-context.d.ts

@@ -1,5 +1,5 @@
 import { FloatingContext } from '../..';
-import { TreeNode } from '../../use-tree';
+import { TreeNode } from '../../use-floating-tree';
 /**
  * Type guard to determine if the context parameter is a TreeNode.
  * @param context - The context parameter to check
@@ -21,7 +21,7 @@ export declare function getContextFromParameter(context: FloatingContext | TreeN
  * @param element - The element to check containment against (can be VirtualElement or null)
  * @returns True if the target is within the element
  */
-export declare function isTargetWithinElement(target: Node, element: any): boolean;
+export declare function isTargetWithinElement(target: Node, element: unknown): boolean;
 /**
  * Finds a descendant node that contains the target element.
  * @param node - The parent node to search from

package/dist/composables/interactions/utils/tree-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tree-context.d.ts","sourceRoot":"","sources":["../../../../src/composables/interactions/utils/tree-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEtD;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC,GACnD,OAAO,IAAI,QAAQ,CAAC,eAAe,CAAC,CAStC;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC,GAAG;IAC7F,eAAe,EAAE,eAAe,CAAA;IAChC,WAAW,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,IAAI,CAAA;CAC9C,CAWA;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAkBzE;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,EAC/B,MAAM,EAAE,IAAI,GACX,QAAQ,CAAC,eAAe,CAAC,GAAG,IAAI,CAgBlC"}
+{"version":3,"file":"tree-context.d.ts","sourceRoot":"","sources":["../../../../src/composables/interactions/utils/tree-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAE/D;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC,GACnD,OAAO,IAAI,QAAQ,CAAC,eAAe,CAAC,CAStC;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC,GAAG;IAC7F,eAAe,EAAE,eAAe,CAAA;IAChC,WAAW,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,IAAI,CAAA;CAC9C,CAWA;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAkB7E;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,EAC/B,MAAM,EAAE,IAAI,GACX,QAAQ,CAAC,eAAe,CAAC,GAAG,IAAI,CAgBlC"}

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

@@ -1,2 +1,2 @@
-export { offset, flip, shift, hide } from '@floating-ui/dom';
+export { flip, hide, offset, shift } from '@floating-ui/dom';
 //# 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,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/composables/middlewares/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA"}

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

@@ -1,4 +1,3 @@
-import { Padding } from '@floating-ui/dom';
 import { ComputedRef, Ref } from 'vue';
 import { FloatingContext } from './use-floating';
 /**
@@ -34,10 +33,6 @@ export interface UseArrowOptions {
      * @default '-4px'
      */
     offset?: string;
-    /**
-     * Padding around arrow element
-     */
-    padding?: Padding;
 }
 /**
  * Composable for computing arrow position styles for floating elements

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

@@ -1 +1 @@
-{"version":3,"file":"use-arrow.d.ts","sourceRoot":"","sources":["../../src/composables/use-arrow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC/C,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;IAEf;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;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"}
+{"version":3,"file":"use-arrow.d.ts","sourceRoot":"","sources":["../../src/composables/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/use-floating-tree.d.ts

@@ -1,20 +1,54 @@
 import { Ref } from 'vue';
 import { AnchorElement, FloatingContext, FloatingElement, UseFloatingOptions } from './use-floating';
-import { TreeNode, TreeOptions } from './use-tree';
 /**
- * Configuration options for the floating tree
+ * Options for creating a TreeNode
  */
-export interface FloatingTreeOptions extends TreeOptions {
+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";
 }
-export interface UseFloatingTreeReturn {
-    readonly nodeMap: Readonly<Map<string, TreeNode<FloatingContext>>>;
-    readonly root: TreeNode<FloatingContext>;
-    findNodeById: (nodeId: string) => TreeNode<FloatingContext> | null;
+export interface TreeNode<T> {
+    readonly id: string;
+    readonly data: T;
+    readonly parent: Ref<TreeNode<T> | null>;
+    readonly children: Ref<TreeNode<T>[]>;
+    readonly isRoot: boolean;
+    readonly isLeaf: Readonly<Ref<boolean>>;
+    addChild: (childNode: TreeNode<T>) => void;
+    _removeChildInstance: (childNode: TreeNode<T>) => boolean;
+    findChild: (predicate: (node: TreeNode<T>) => boolean) => TreeNode<T> | null;
+    findDescendant: (predicate: (node: TreeNode<T>) => boolean) => TreeNode<T> | null;
+    isDescendantOf: (potentialAncestor: TreeNode<T>) => boolean;
+    getPath: () => TreeNode<T>[];
+}
+export interface Tree<T> {
+    readonly root: TreeNode<T>;
+    readonly nodeMap: Readonly<Map<string, TreeNode<T>>>;
+    findNodeById: (id: string) => TreeNode<T> | null;
+    addNode: (data: T, parentId?: string | null, nodeOptions?: CreateTreeNodeOptions) => TreeNode<T> | null;
+    removeNode: (nodeId: string, deleteStrategy?: "orphan" | "recursive") => boolean;
     moveNode: (nodeId: string, newParentId: string | null) => boolean;
+    traverse: (strategy?: "dfs" | "bfs", startNode?: TreeNode<T> | null) => TreeNode<T>[];
     dispose: () => void;
+}
+/**
+ * Configuration options for the floating tree
+ */
+export interface FloatingTreeOptions extends CreateTreeOptions {
+}
+export interface UseFloatingTreeReturn extends Omit<Tree<FloatingContext>, "addNode"> {
     addNode: (anchorEl: Ref<AnchorElement>, floatingEl: Ref<FloatingElement>, options?: UseFloatingOptions) => TreeNode<FloatingContext> | null;
-    removeNode: (nodeId: string, deleteStrategy?: "orphan" | "recursive") => boolean;
-    traverse: (mode: "dfs" | "bfs", startNode?: TreeNode<FloatingContext>) => TreeNode<FloatingContext>[];
     getAllOpenNodes: () => TreeNode<FloatingContext>[];
     getTopmostOpenNode: () => TreeNode<FloatingContext> | null;
     /**
@@ -25,7 +59,7 @@ export interface UseFloatingTreeReturn {
      * @param callback - A function to execute for each matching node
      * @param options - Configuration options for the iteration behavior
      */
-    forEach: (nodeId: string, callback: (node: TreeNode<FloatingContext>) => void, options?: {
+    applyToNodes: (nodeId: string, callback: (node: TreeNode<FloatingContext>) => void, options?: {
         relationship?: NodeRelationship;
         applyToMatching?: boolean;
     }) => void;
@@ -44,5 +78,33 @@ type NodeRelationship = "ancestors-only" | "siblings-only" | "descendants-only"
  * @returns UseFloatingTreeReturn with tree management methods and root context
  */
 export declare function useFloatingTree(anchorEl: Ref<AnchorElement>, floatingEl: Ref<FloatingElement>, options?: UseFloatingOptions, 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 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);
+ * ```
+ */
+export declare function createTree<T>(initialRootData: T, options?: CreateTreeOptions): Tree<T>;
 export {};
 //# sourceMappingURL=use-floating-tree.d.ts.map