v-float 0.9.1 → 0.11.0

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

@@ -1,162 +0,0 @@
-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
- */
-export type AnchorElement = HTMLElement | VirtualElement | null;
-/**
- * Type for floating element in floating UI
- */
-export type FloatingElement = HTMLElement | null;
-/**
- * CSS styles for positioning floating elements
- */
-export type FloatingStyles = {
-    /**
-     * CSS position property
-     */
-    position: Strategy;
-    /**
-     * CSS top property
-     */
-    top: string;
-    /**
-     * CSS left property
-     */
-    left: string;
-    /**
-     * CSS transform property
-     */
-    transform?: string;
-    /**
-     * CSS will-change property
-     */
-    "will-change"?: string;
-} & {
-    [key: `--${string}`]: any;
-};
-/**
- * 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'
-     */
-    placement?: MaybeRefOrGetter<Placement | undefined>;
-    /**
-     * The type of CSS positioning to use.
-     * @default 'absolute'
-     */
-    strategy?: MaybeRefOrGetter<Strategy | undefined>;
-    /**
-     * Whether to use CSS transform instead of top/left positioning.
-     * @default true
-     */
-    transform?: MaybeRefOrGetter<boolean | undefined>;
-    /**
-     * Middlewares modify the positioning coordinates in some fashion, or provide useful data for the consumer to use.
-     */
-    middlewares?: MaybeRefOrGetter<Middleware[]>;
-    /**
-     * Whether to automatically update the position of the floating element.
-     * @default true
-     */
-    autoUpdate?: boolean | AutoUpdateOptions;
-    /**
-   * 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
-     */
-    x: Readonly<Ref<number>>;
-    /**
-     * The y-coordinate of the floating element
-     */
-    y: Readonly<Ref<number>>;
-    /**
-     * The strategy used for positioning
-     */
-    strategy: Readonly<Ref<Strategy>>;
-    /**
-     * The placement of the floating element
-     */
-    placement: Readonly<Ref<Placement>>;
-    /**
-     * Data from middleware for additional customization
-     */
-    middlewareData: Readonly<Ref<MiddlewareData>>;
-    /**
-     * Whether the floating element has been positioned
-     */
-    isPositioned: Readonly<Ref<boolean>>;
-    /**
-     * Reactive styles to apply to the floating element
-     */
-    floatingStyles: Readonly<Ref<FloatingStyles>>;
-    /**
-     * Function to manually update the position
-     */
-    update: () => void;
-    /**
-     * The refs object containing references to anchor and floating elements
-     */
-    refs: {
-        anchorEl: Ref<AnchorElement>;
-        floatingEl: Ref<FloatingElement>;
-        arrowEl: Ref<HTMLElement | null>;
-    };
-    /**
-     * Whether the floating element is open
-     */
-    open: Readonly<Ref<boolean>>;
-    /**
-     * Function to explicitly set the open state of the floating element.
-     */
-    setOpen: (open: boolean, reason?: OpenChangeReason, event?: Event) => void;
-}
-/**
- * Composable function that provides positioning for a floating element relative to an anchor element
- *
- * This composable handles the positioning logic for floating elements (like tooltips, popovers, etc.)
- * relative to their anchor elements. It uses Floating UI under the hood and provides reactive
- * positioning data and styles.
- *
- * @param anchorEl - The anchor element or a reactive reference to it
- * @param floatingEl - The floating element or a reactive reference to it
- * @param options - Additional options for the floating behavior
- * @returns A FloatingContext object containing positioning data and methods
- *
- * @example
- * ```ts
- * const { floatingStyles, refs } = useFloating(anchorEl, floatingEl, {
- *   placement: 'bottom',
- *   strategy: 'absolute'
- * })
- * ```
- */
-export declare function useFloating(anchorEl: Ref<AnchorElement>, floatingEl: Ref<FloatingElement>, options?: UseFloatingOptions): FloatingContext;
-//# sourceMappingURL=use-floating.d.ts.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,2 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,8 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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/index.d.ts

@@ -1,2 +0,0 @@
-export * from './composables';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA"}

package/dist/types.d.ts

@@ -1,18 +0,0 @@
-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 +0,0 @@
-{"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,92 +0,0 @@
-import { AnyFn, VirtualElement } from './types';
-import { FloatingContext } from './composables/positioning/use-floating';
-import { TreeNode } from './composables/positioning/use-floating-tree';
-/**
- * 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
- */
-export declare function isFunction(value: unknown): value is AnyFn;
-/**
- * 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 +0,0 @@
-{"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"}