@ariakit/core 0.3.3 → 0.3.5

package/cjs/tab/tab-store.d.cts

@@ -0,0 +1,87 @@
+import type { CollectionStore, CollectionStoreItem } from "../collection/collection-store.js";
+import type { CompositeStoreFunctions, CompositeStoreItem, CompositeStoreOptions, CompositeStoreState } from "../composite/composite-store.js";
+import type { Store, StoreOptions, StoreProps } from "../utils/store.js";
+import type { SetState } from "../utils/types.js";
+type Item = CompositeStoreItem & {
+    dimmed?: boolean;
+};
+type Panel = CollectionStoreItem & {
+    tabId?: string | null;
+};
+export declare function createTabStore(props?: TabStoreProps): TabStore;
+export type TabStoreItem = Item;
+export type TabStorePanel = Panel;
+export interface TabStoreState extends CompositeStoreState<Item> {
+    /**
+     * @default "horizontal"
+     */
+    orientation: CompositeStoreState<Item>["orientation"];
+    /**
+     * @default true
+     */
+    focusLoop: CompositeStoreState<Item>["focusLoop"];
+    /**
+     * The id of the tab whose panel is currently visible. If it's `undefined`, it
+     * will be automatically set to the first enabled tab.
+     *
+     * Live examples:
+     * - [Tab with React Router](https://ariakit.org/examples/tab-react-router)
+     */
+    selectedId: TabStoreState["activeId"];
+    /**
+     * Whether the tab should be selected when it receives focus. If it's set to
+     * `false`, the tab will be selected only when it's clicked.
+     *
+     * Live examples:
+     * - [Tab with React Router](https://ariakit.org/examples/tab-react-router)
+     * @default true
+     */
+    selectOnMove?: boolean;
+}
+export interface TabStoreFunctions extends CompositeStoreFunctions<Item> {
+    /**
+     * Sets the `selectedId` state without moving focus. If you want to move focus,
+     * use the `select` function instead.
+     *
+     * Live examples:
+     * - [Tab with React Router](https://ariakit.org/examples/tab-react-router)
+     * @example
+     * // Selects the tab with id "tab-1"
+     * store.setSelectedId("tab-1");
+     * // Toggles between "tab-1" and "tab-2"
+     * store.setSelectedId((id) => id === "tab-1" ? "tab-2" : "tab-1"));
+     * // Selects the first tab
+     * store.setSelectedId(store.first());
+     * // Selects the next tab
+     * store.setSelectedId(store.next());
+     */
+    setSelectedId: SetState<TabStoreState["selectedId"]>;
+    /**
+     * A collection store containing the tab panels.
+     */
+    panels: CollectionStore<Panel>;
+    /**
+     * Selects the tab for the given id and moves focus to it. If you want to set
+     * the `selectedId` state without moving focus, use the `setSelectedId`
+     * function instead.
+     * @param id The id of the tab to select.
+     * @example
+     * // Selects the tab with id "tab-1"
+     * store.select("tab-1");
+     * // Selects the first tab
+     * store.select(store.first());
+     * // Selects the next tab
+     * store.select(store.next());
+     */
+    select: TabStore["move"];
+}
+export interface TabStoreOptions extends StoreOptions<TabStoreState, "orientation" | "focusLoop" | "selectedId" | "selectOnMove">, CompositeStoreOptions<Item> {
+    /**
+     * The id of the tab whose panel is currently visible. If it's `undefined`, it
+     * will be automatically set to the first enabled tab.
+     */
+    defaultSelectedId?: TabStoreState["selectedId"];
+}
+export type TabStoreProps = TabStoreOptions & StoreProps<TabStoreState>;
+export type TabStore = TabStoreFunctions & Store<TabStoreState>;
+export {};

package/cjs/toolbar/toolbar-store.cjs

@@ -1,29 +1,30 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
-var _TTWS4MDCcjs = require('../__chunks/TTWS4MDC.cjs');
-require('../__chunks/W5IQT6Z2.cjs');
-require('../__chunks/A4GDJCZB.cjs');
 
+var _AR2VJ37Fcjs = require('../__chunks/AR2VJ37F.cjs');
+require('../__chunks/FFY2GSOG.cjs');
+require('../__chunks/FJSZTIOU.cjs');
 
-var _RCYVACJOcjs = require('../__chunks/RCYVACJO.cjs');
-require('../__chunks/EXM2AW52.cjs');
-require('../__chunks/GDZQUFNP.cjs');
 
+var _3UT5FE6Kcjs = require('../__chunks/3UT5FE6K.cjs');
+require('../__chunks/FTB5CXVB.cjs');
+require('../__chunks/ULSPM3Y3.cjs');
 
 
-var _72I2GWXFcjs = require('../__chunks/72I2GWXF.cjs');
+
+var _AV6KTKLEcjs = require('../__chunks/AV6KTKLE.cjs');
 
 // src/toolbar/toolbar-store.ts
 function createToolbarStore(props = {}) {
   var _a;
   const syncState = (_a = props.store) == null ? void 0 : _a.getState();
-  return _TTWS4MDCcjs.createCompositeStore.call(void 0, _72I2GWXFcjs.__spreadProps.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, {}, props), {
-    orientation: _RCYVACJOcjs.defaultValue.call(void 0, 
+  return _AR2VJ37Fcjs.createCompositeStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
+    orientation: _3UT5FE6Kcjs.defaultValue.call(void 0, 
       props.orientation,
       syncState == null ? void 0 : syncState.orientation,
       "horizontal"
     ),
-    focusLoop: _RCYVACJOcjs.defaultValue.call(void 0, props.focusLoop, syncState == null ? void 0 : syncState.focusLoop, true)
+    focusLoop: _3UT5FE6Kcjs.defaultValue.call(void 0, props.focusLoop, syncState == null ? void 0 : syncState.focusLoop, true)
   }));
 }
 

package/cjs/toolbar/toolbar-store.d.cts

@@ -0,0 +1,21 @@
+import type { CompositeStore, CompositeStoreFunctions, CompositeStoreOptions, CompositeStoreProps, CompositeStoreState } from "../composite/composite-store.js";
+import type { StoreOptions } from "../utils/store.js";
+/**
+ * Creates a toolbar store.
+ */
+export declare function createToolbarStore(props?: ToolbarStoreProps): ToolbarStore;
+export interface ToolbarStoreState extends CompositeStoreState {
+    /**
+     * @default "horizontal"
+     */
+    orientation: CompositeStoreState["orientation"];
+    /**
+     * @default true
+     */
+    focusLoop: CompositeStoreState["focusLoop"];
+}
+export type ToolbarStoreFunctions = CompositeStoreFunctions;
+export interface ToolbarStoreOptions extends StoreOptions<ToolbarStoreState, "orientation" | "focusLoop">, CompositeStoreOptions {
+}
+export type ToolbarStore = CompositeStore;
+export type ToolbarStoreProps = CompositeStoreProps;

package/cjs/tooltip/tooltip-store.cjs

@@ -1,38 +1,39 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
-var _NEBQQIUXcjs = require('../__chunks/NEBQQIUX.cjs');
-require('../__chunks/ZYIEFAMB.cjs');
-require('../__chunks/DFFIYGBS.cjs');
-require('../__chunks/A7K3KZJL.cjs');
 
+var _XVR5QRC3cjs = require('../__chunks/XVR5QRC3.cjs');
+require('../__chunks/HOEZKRUM.cjs');
+require('../__chunks/MYTMMWXI.cjs');
+require('../__chunks/F6Q5QSXF.cjs');
 
-var _A4GDJCZBcjs = require('../__chunks/A4GDJCZB.cjs');
 
+var _FJSZTIOUcjs = require('../__chunks/FJSZTIOU.cjs');
 
-var _RCYVACJOcjs = require('../__chunks/RCYVACJO.cjs');
 
+var _3UT5FE6Kcjs = require('../__chunks/3UT5FE6K.cjs');
 
 
-var _72I2GWXFcjs = require('../__chunks/72I2GWXF.cjs');
+
+var _AV6KTKLEcjs = require('../__chunks/AV6KTKLE.cjs');
 
 // src/tooltip/tooltip-store.ts
 function createTooltipStore(props = {}) {
   var _a;
   const syncState = (_a = props.store) == null ? void 0 : _a.getState();
-  const hovercard = _NEBQQIUXcjs.createHovercardStore.call(void 0, _72I2GWXFcjs.__spreadProps.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, {}, props), {
-    placement: _RCYVACJOcjs.defaultValue.call(void 0, 
+  const hovercard = _XVR5QRC3cjs.createHovercardStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
+    placement: _3UT5FE6Kcjs.defaultValue.call(void 0, 
       props.placement,
       syncState == null ? void 0 : syncState.placement,
       "top"
     ),
-    hideTimeout: _RCYVACJOcjs.defaultValue.call(void 0, props.hideTimeout, syncState == null ? void 0 : syncState.hideTimeout, 0)
+    hideTimeout: _3UT5FE6Kcjs.defaultValue.call(void 0, props.hideTimeout, syncState == null ? void 0 : syncState.hideTimeout, 0)
   }));
-  const initialState = _72I2GWXFcjs.__spreadProps.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, {}, hovercard.getState()), {
-    type: _RCYVACJOcjs.defaultValue.call(void 0, props.type, syncState == null ? void 0 : syncState.type, "description"),
-    skipTimeout: _RCYVACJOcjs.defaultValue.call(void 0, props.skipTimeout, syncState == null ? void 0 : syncState.skipTimeout, 300)
+  const initialState = _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, hovercard.getState()), {
+    type: _3UT5FE6Kcjs.defaultValue.call(void 0, props.type, syncState == null ? void 0 : syncState.type, "description"),
+    skipTimeout: _3UT5FE6Kcjs.defaultValue.call(void 0, props.skipTimeout, syncState == null ? void 0 : syncState.skipTimeout, 300)
   });
-  const tooltip = _A4GDJCZBcjs.createStore.call(void 0, initialState, hovercard, props.store);
-  return _72I2GWXFcjs.__spreadValues.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, {}, hovercard), tooltip);
+  const tooltip = _FJSZTIOUcjs.createStore.call(void 0, initialState, hovercard, props.store);
+  return _AV6KTKLEcjs.__spreadValues.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, hovercard), tooltip);
 }
 
 

package/cjs/tooltip/tooltip-store.d.cts

@@ -0,0 +1,29 @@
+import type { HovercardStoreFunctions, HovercardStoreOptions, HovercardStoreState } from "../hovercard/hovercard-store.js";
+import type { Store, StoreOptions, StoreProps } from "../utils/store.js";
+/**
+ * Creates a tooltip store.
+ */
+export declare function createTooltipStore(props?: TooltipStoreProps): TooltipStore;
+export interface TooltipStoreState extends HovercardStoreState {
+    /**
+     * Determines whether the tooltip is being used as a label or a description
+     * for the anchor element.
+     * @default "description"
+     */
+    type: "label" | "description";
+    /**
+     * The amount of time after a tooltip is hidden while all tooltips on the
+     * page can be shown immediately, without waiting for the show timeout.
+     * @default 300
+     */
+    skipTimeout: number;
+    /** @default "top" */
+    placement: HovercardStoreState["placement"];
+    /** @default 0 */
+    hideTimeout?: HovercardStoreState["hideTimeout"];
+}
+export type TooltipStoreFunctions = HovercardStoreFunctions;
+export interface TooltipStoreOptions extends StoreOptions<TooltipStoreState, "type" | "placement" | "timeout" | "showTimeout" | "hideTimeout" | "skipTimeout">, HovercardStoreOptions {
+}
+export type TooltipStoreProps = TooltipStoreOptions & StoreProps<TooltipStoreState>;
+export type TooltipStore = TooltipStoreFunctions & Store<TooltipStoreState>;

package/cjs/utils/array.cjs

@@ -1,13 +1,14 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
 
 
-var _GDZQUFNPcjs = require('../__chunks/GDZQUFNP.cjs');
-require('../__chunks/72I2GWXF.cjs');
 
+var _ULSPM3Y3cjs = require('../__chunks/ULSPM3Y3.cjs');
+require('../__chunks/AV6KTKLE.cjs');
 
 
 
 
-exports.addItemToArray = _GDZQUFNPcjs.addItemToArray; exports.flatten2DArray = _GDZQUFNPcjs.flatten2DArray; exports.reverseArray = _GDZQUFNPcjs.reverseArray; exports.toArray = _GDZQUFNPcjs.toArray;
+
+exports.addItemToArray = _ULSPM3Y3cjs.addItemToArray; exports.flatten2DArray = _ULSPM3Y3cjs.flatten2DArray; exports.reverseArray = _ULSPM3Y3cjs.reverseArray; exports.toArray = _ULSPM3Y3cjs.toArray;

package/cjs/utils/array.d.cts

@@ -0,0 +1,29 @@
+/**
+ * Transforms `arg` into an array if it's not already.
+ * @example
+ * toArray("a"); // ["a"]
+ * toArray(["a"]); // ["a"]
+ */
+export declare function toArray<T>(arg: T): T extends readonly any[] ? T : T[];
+/**
+ * Immutably adds an index to an array.
+ * @example
+ * addItemToArray(["a", "b", "d"], "c", 2); // ["a", "b", "c", "d"]
+ * @returns {Array} A new array with the item in the passed array index.
+ */
+export declare function addItemToArray<T extends any[]>(array: T, item: T[number], index?: number): T;
+/**
+ * Flattens a 2D array into a one-dimensional array.
+ * @example
+ * flatten2DArray([["a"], ["b"], ["c"]]); // ["a", "b", "c"]
+ *
+ * @returns {Array} A one-dimensional array.
+ */
+export declare function flatten2DArray<T>(array: T[][]): T[];
+/**
+ * Immutably reverses an array.
+ * @example
+ * reverseArray(["a", "b", "c"]); // ["c", "b", "a"]
+ * @returns {Array} Reversed array.
+ */
+export declare function reverseArray<T>(array: T[]): T[];

package/cjs/utils/dom.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
 
@@ -16,9 +16,9 @@
 
 
 
-var _EXM2AW52cjs = require('../__chunks/EXM2AW52.cjs');
-require('../__chunks/72I2GWXF.cjs');
 
+var _FTB5CXVBcjs = require('../__chunks/FTB5CXVB.cjs');
+require('../__chunks/AV6KTKLE.cjs');
 
 
 
@@ -36,4 +36,5 @@ require('../__chunks/72I2GWXF.cjs');
 
 
 
-exports.canUseDOM = _EXM2AW52cjs.canUseDOM; exports.closest = _EXM2AW52cjs.closest; exports.contains = _EXM2AW52cjs.contains; exports.getActiveElement = _EXM2AW52cjs.getActiveElement; exports.getDocument = _EXM2AW52cjs.getDocument; exports.getPopupItemRole = _EXM2AW52cjs.getPopupItemRole; exports.getPopupRole = _EXM2AW52cjs.getPopupRole; exports.getScrollingElement = _EXM2AW52cjs.getScrollingElement; exports.getTextboxSelection = _EXM2AW52cjs.getTextboxSelection; exports.getWindow = _EXM2AW52cjs.getWindow; exports.isButton = _EXM2AW52cjs.isButton; exports.isFrame = _EXM2AW52cjs.isFrame; exports.isPartiallyHidden = _EXM2AW52cjs.isPartiallyHidden; exports.isTextField = _EXM2AW52cjs.isTextField; exports.isVisible = _EXM2AW52cjs.isVisible; exports.matches = _EXM2AW52cjs.matches; exports.scrollIntoViewIfNeeded = _EXM2AW52cjs.scrollIntoViewIfNeeded;
+
+exports.canUseDOM = _FTB5CXVBcjs.canUseDOM; exports.closest = _FTB5CXVBcjs.closest; exports.contains = _FTB5CXVBcjs.contains; exports.getActiveElement = _FTB5CXVBcjs.getActiveElement; exports.getDocument = _FTB5CXVBcjs.getDocument; exports.getPopupItemRole = _FTB5CXVBcjs.getPopupItemRole; exports.getPopupRole = _FTB5CXVBcjs.getPopupRole; exports.getScrollingElement = _FTB5CXVBcjs.getScrollingElement; exports.getTextboxSelection = _FTB5CXVBcjs.getTextboxSelection; exports.getWindow = _FTB5CXVBcjs.getWindow; exports.isButton = _FTB5CXVBcjs.isButton; exports.isFrame = _FTB5CXVBcjs.isFrame; exports.isPartiallyHidden = _FTB5CXVBcjs.isPartiallyHidden; exports.isTextField = _FTB5CXVBcjs.isTextField; exports.isVisible = _FTB5CXVBcjs.isVisible; exports.matches = _FTB5CXVBcjs.matches; exports.scrollIntoViewIfNeeded = _FTB5CXVBcjs.scrollIntoViewIfNeeded;

package/cjs/utils/dom.d.cts

@@ -0,0 +1,105 @@
+import type { AriaHasPopup, AriaRole } from "./types.js";
+/**
+ * It's `true` if it is running in a browser environment or `false` if it is not
+ * (SSR).
+ * @example
+ * const title = canUseDOM ? document.title : "";
+ */
+export declare const canUseDOM: boolean;
+/**
+ * Returns `element.ownerDocument || document`.
+ */
+export declare function getDocument(node?: Node | null): Document;
+/**
+ * Returns `element.ownerDocument.defaultView || window`.
+ */
+export declare function getWindow(node?: Node | null): Window;
+/**
+ * Returns `element.ownerDocument.activeElement`.
+ */
+export declare function getActiveElement(node?: Node | null, activeDescendant?: boolean): HTMLElement | null;
+/**
+ * Similar to `Element.prototype.contains`, but a little bit faster when
+ * `element` is the same as `child`.
+ * @example
+ * contains(
+ *   document.getElementById("parent"),
+ *   document.getElementById("child")
+ * );
+ */
+export declare function contains(parent: Node, child: Node): boolean;
+/**
+ * Checks whether `element` is a frame element.
+ */
+export declare function isFrame(element: Element): element is HTMLIFrameElement;
+/**
+ * Checks whether `element` is a native HTML button element.
+ * @example
+ * isButton(document.querySelector("button")); // true
+ * isButton(document.querySelector("input[type='button']")); // true
+ * isButton(document.querySelector("div")); // false
+ * isButton(document.querySelector("input[type='text']")); // false
+ * isButton(document.querySelector("div[role='button']")); // false
+ */
+export declare function isButton(element: {
+    tagName: string;
+    type?: string;
+}): boolean;
+/**
+ * Ponyfill for `Element.prototype.matches`
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Element/matches
+ */
+export declare function matches(element: Element, selectors: string): boolean;
+/**
+ * Checks if the element is visible or not.
+ */
+export declare function isVisible(element: Element): boolean;
+/**
+ * Ponyfill for `Element.prototype.closest`
+ * @example
+ * closest(document.getElementById("id"), "div");
+ * // same as
+ * document.getElementById("id").closest("div");
+ */
+export declare function closest<K extends keyof HTMLElementTagNameMap>(element: Element, selectors: K): HTMLElementTagNameMap[K];
+export declare function closest<K extends keyof SVGElementTagNameMap>(element: Element, selectors: K): SVGElementTagNameMap[K];
+export declare function closest<T extends Element = Element>(element: Element, selectors: string): T | null;
+/**
+ * Check whether the given element is a text field, where text field is defined
+ * by the ability to select within the input.
+ * @example
+ * isTextField(document.querySelector("div")); // false
+ * isTextField(document.querySelector("input")); // true
+ * isTextField(document.querySelector("input[type='button']")); // false
+ * isTextField(document.querySelector("textarea")); // true
+ */
+export declare function isTextField(element: Element): element is HTMLInputElement | HTMLTextAreaElement;
+/**
+ * Returns the element's role attribute, if it has one.
+ */
+export declare function getPopupRole(element?: Element | null, fallback?: AriaHasPopup): AriaHasPopup;
+/**
+ * Returns the item role attribute based on the popup's role.
+ */
+export declare function getPopupItemRole(element?: Element | null, fallback?: AriaRole): string | undefined;
+/**
+ * Returns the start and end offsets of the selection in the element.
+ */
+export declare function getTextboxSelection(element: HTMLElement): {
+    start: number;
+    end: number;
+};
+/**
+ * Calls `element.scrollIntoView()` if the element is hidden or partly hidden in
+ * the viewport.
+ */
+export declare function scrollIntoViewIfNeeded(element: Element, arg?: boolean | ScrollIntoViewOptions): void;
+/**
+ * Returns the scrolling container element of a given element.
+ */
+export declare function getScrollingElement(element?: Element | null): HTMLElement | Element | null;
+/**
+ * Determines whether an element is hidden or partially hidden in the viewport.
+ */
+export declare function isPartiallyHidden(element: Element): boolean;

package/cjs/utils/events.cjs

@@ -1,18 +1,19 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
-var _EIRIJC7Tcjs = require('../__chunks/EIRIJC7T.cjs');
 
+var _G5EW4WEDcjs = require('../__chunks/G5EW4WED.cjs');
 
-var _EXM2AW52cjs = require('../__chunks/EXM2AW52.cjs');
 
+var _FTB5CXVBcjs = require('../__chunks/FTB5CXVB.cjs');
 
 
-var _72I2GWXFcjs = require('../__chunks/72I2GWXF.cjs');
+
+var _AV6KTKLEcjs = require('../__chunks/AV6KTKLE.cjs');
 
 // src/utils/events.ts
 function isPortalEvent(event) {
   return Boolean(
-    event.currentTarget && !_EXM2AW52cjs.contains.call(void 0, event.currentTarget, event.target)
+    event.currentTarget && !_FTB5CXVBcjs.contains.call(void 0, event.currentTarget, event.target)
   );
 }
 function isSelfTarget(event) {
@@ -22,7 +23,7 @@ function isOpeningInNewTab(event) {
   const element = event.currentTarget;
   if (!element)
     return false;
-  const isAppleDevice = _EIRIJC7Tcjs.isApple.call(void 0, );
+  const isAppleDevice = _G5EW4WEDcjs.isApple.call(void 0, );
   if (isAppleDevice && !event.metaKey)
     return false;
   if (!isAppleDevice && !event.ctrlKey)
@@ -58,14 +59,14 @@ function fireEvent(element, type, eventInit) {
 function fireBlurEvent(element, eventInit) {
   const event = new FocusEvent("blur", eventInit);
   const defaultAllowed = element.dispatchEvent(event);
-  const bubbleInit = _72I2GWXFcjs.__spreadProps.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, {}, eventInit), { bubbles: true });
+  const bubbleInit = _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, eventInit), { bubbles: true });
   element.dispatchEvent(new FocusEvent("focusout", bubbleInit));
   return defaultAllowed;
 }
 function fireFocusEvent(element, eventInit) {
   const event = new FocusEvent("focus", eventInit);
   const defaultAllowed = element.dispatchEvent(event);
-  const bubbleInit = _72I2GWXFcjs.__spreadProps.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, {}, eventInit), { bubbles: true });
+  const bubbleInit = _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, eventInit), { bubbles: true });
   element.dispatchEvent(new FocusEvent("focusin", bubbleInit));
   return defaultAllowed;
 }
@@ -80,7 +81,7 @@ function fireClickEvent(element, eventInit) {
 function isFocusEventOutside(event, container) {
   const containerElement = container || event.currentTarget;
   const relatedTarget = event.relatedTarget;
-  return !relatedTarget || !_EXM2AW52cjs.contains.call(void 0, containerElement, relatedTarget);
+  return !relatedTarget || !_FTB5CXVBcjs.contains.call(void 0, containerElement, relatedTarget);
 }
 function queueBeforeEvent(element, type, callback) {
   const raf = requestAnimationFrame(() => {

package/cjs/utils/events.d.cts

@@ -0,0 +1,70 @@
+/**
+ * Returns `true` if `event` has been fired within a React Portal element.
+ */
+export declare function isPortalEvent(event: Pick<Event, "currentTarget" | "target">): boolean;
+/**
+ * Returns `true` if `event.target` and `event.currentTarget` are the same.
+ */
+export declare function isSelfTarget(event: Pick<Event, "target" | "currentTarget">): boolean;
+/**
+ * Checks whether the user event is triggering a page navigation in a new tab.
+ */
+export declare function isOpeningInNewTab(event: Pick<MouseEvent, "currentTarget" | "metaKey" | "ctrlKey">): boolean;
+/**
+ * Checks whether the user event is triggering a download.
+ */
+export declare function isDownloading(event: Pick<MouseEvent, "altKey" | "currentTarget">): boolean;
+/**
+ * Creates and dispatches an event.
+ * @example
+ * fireEvent(document.getElementById("id"), "blur", {
+ *   bubbles: true,
+ *   cancelable: true,
+ * });
+ */
+export declare function fireEvent(element: Element, type: string, eventInit?: EventInit): boolean;
+/**
+ * Creates and dispatches a blur event.
+ * @example
+ * fireBlurEvent(document.getElementById("id"));
+ */
+export declare function fireBlurEvent(element: Element, eventInit?: FocusEventInit): boolean;
+/**
+ * Creates and dispatches a focus event.
+ * @example
+ * fireFocusEvent(document.getElementById("id"));
+ */
+export declare function fireFocusEvent(element: Element, eventInit?: FocusEventInit): boolean;
+/**
+ * Creates and dispatches a keyboard event.
+ * @example
+ * fireKeyboardEvent(document.getElementById("id"), "keydown", {
+ *   key: "ArrowDown",
+ *   shiftKey: true,
+ * });
+ */
+export declare function fireKeyboardEvent(element: Element, type: string, eventInit?: KeyboardEventInit): boolean;
+/**
+ * Creates and dispatches a click event.
+ * @example
+ * fireClickEvent(document.getElementById("id"));
+ */
+export declare function fireClickEvent(element: Element, eventInit?: PointerEventInit): boolean;
+/**
+ * Checks whether the focus/blur event is happening from/to outside of the
+ * container element.
+ * @example
+ * const element = document.getElementById("id");
+ * element.addEventListener("blur", (event) => {
+ *   if (isFocusEventOutside(event)) {
+ *     // ...
+ *   }
+ * });
+ */
+export declare function isFocusEventOutside(event: Pick<FocusEvent, "currentTarget" | "relatedTarget">, container?: Element | null): boolean;
+/**
+ * Runs a callback on the next animation frame, but before a certain event.
+ */
+export declare function queueBeforeEvent(element: Element, type: string, callback: () => void): number;
+export declare function addGlobalEventListener<K extends keyof DocumentEventMap>(type: K, listener: (event: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions, scope?: Window): () => void;
+export declare function addGlobalEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions, scope?: Window): () => void;

package/cjs/utils/focus.cjs

@@ -1,14 +1,15 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
 
 
 
 
-var _EXM2AW52cjs = require('../__chunks/EXM2AW52.cjs');
 
+var _FTB5CXVBcjs = require('../__chunks/FTB5CXVB.cjs');
 
-var _72I2GWXFcjs = require('../__chunks/72I2GWXF.cjs');
+
+var _AV6KTKLEcjs = require('../__chunks/AV6KTKLE.cjs');
 
 // src/utils/focus.ts
 var selector = "input:not([type='hidden']):not([disabled]), select:not([disabled]), textarea:not([disabled]), a[href], button:not([disabled]), [tabindex], iframe, object, embed, area[href], audio[controls], video[controls], [contenteditable]:not([contenteditable='false'])";
@@ -17,11 +18,11 @@ function hasNegativeTabIndex(element) {
   return tabIndex < 0;
 }
 function isFocusable(element) {
-  if (!_EXM2AW52cjs.matches.call(void 0, element, selector))
+  if (!_FTB5CXVBcjs.matches.call(void 0, element, selector))
     return false;
-  if (!_EXM2AW52cjs.isVisible.call(void 0, element))
+  if (!_FTB5CXVBcjs.isVisible.call(void 0, element))
     return false;
-  if (_EXM2AW52cjs.closest.call(void 0, element, "[inert]"))
+  if (_FTB5CXVBcjs.closest.call(void 0, element, "[inert]"))
     return false;
   return true;
 }
@@ -43,7 +44,7 @@ function isTabbable(element) {
     return true;
   if (!("length" in radioGroup))
     return true;
-  const activeElement = _EXM2AW52cjs.getActiveElement.call(void 0, element);
+  const activeElement = _FTB5CXVBcjs.getActiveElement.call(void 0, element);
   if (!activeElement)
     return true;
   if (activeElement === element)
@@ -65,7 +66,7 @@ function getAllFocusableIn(container, includeContainer) {
   }
   const focusableElements = elements.filter(isFocusable);
   focusableElements.forEach((element, i) => {
-    if (_EXM2AW52cjs.isFrame.call(void 0, element) && element.contentDocument) {
+    if (_FTB5CXVBcjs.isFrame.call(void 0, element) && element.contentDocument) {
       const frameBody = element.contentDocument.body;
       focusableElements.splice(i, 1, ...getAllFocusableIn(frameBody));
     }
@@ -91,7 +92,7 @@ function getAllTabbableIn(container, includeContainer, fallbackToFocusable) {
     tabbableElements.unshift(container);
   }
   tabbableElements.forEach((element, i) => {
-    if (_EXM2AW52cjs.isFrame.call(void 0, element) && element.contentDocument) {
+    if (_FTB5CXVBcjs.isFrame.call(void 0, element) && element.contentDocument) {
       const frameBody = element.contentDocument.body;
       const allFrameTabbable = getAllTabbableIn(
         frameBody,
@@ -132,7 +133,7 @@ function getLastTabbable(fallbackToFocusable) {
   return getLastTabbableIn(document.body, false, fallbackToFocusable);
 }
 function getNextTabbableIn(container, includeContainer, fallbackToFirst, fallbackToFocusable) {
-  const activeElement = _EXM2AW52cjs.getActiveElement.call(void 0, container);
+  const activeElement = _FTB5CXVBcjs.getActiveElement.call(void 0, container);
   const allFocusable = getAllFocusableIn(container, includeContainer);
   const activeIndex = allFocusable.indexOf(activeElement);
   const nextFocusableElements = allFocusable.slice(activeIndex + 1);
@@ -147,7 +148,7 @@ function getNextTabbable(fallbackToFirst, fallbackToFocusable) {
   );
 }
 function getPreviousTabbableIn(container, includeContainer, fallbackToLast, fallbackToFocusable) {
-  const activeElement = _EXM2AW52cjs.getActiveElement.call(void 0, container);
+  const activeElement = _FTB5CXVBcjs.getActiveElement.call(void 0, container);
   const allFocusable = getAllFocusableIn(container, includeContainer).reverse();
   const activeIndex = allFocusable.indexOf(activeElement);
   const previousFocusableElements = allFocusable.slice(activeIndex + 1);
@@ -163,12 +164,12 @@ function getPreviousTabbable(fallbackToFirst, fallbackToFocusable) {
 }
 function getClosestFocusable(element) {
   while (element && !isFocusable(element)) {
-    element = _EXM2AW52cjs.closest.call(void 0, element, selector);
+    element = _FTB5CXVBcjs.closest.call(void 0, element, selector);
   }
   return element || null;
 }
 function hasFocus(element) {
-  const activeElement = _EXM2AW52cjs.getActiveElement.call(void 0, element);
+  const activeElement = _FTB5CXVBcjs.getActiveElement.call(void 0, element);
   if (!activeElement)
     return false;
   if (activeElement === element)
@@ -179,10 +180,10 @@ function hasFocus(element) {
   return activeDescendant === element.id;
 }
 function hasFocusWithin(element) {
-  const activeElement = _EXM2AW52cjs.getActiveElement.call(void 0, element);
+  const activeElement = _FTB5CXVBcjs.getActiveElement.call(void 0, element);
   if (!activeElement)
     return false;
-  if (_EXM2AW52cjs.contains.call(void 0, element, activeElement))
+  if (_FTB5CXVBcjs.contains.call(void 0, element, activeElement))
     return true;
   const activeDescendant = activeElement.getAttribute("aria-activedescendant");
   if (!activeDescendant)
@@ -229,7 +230,7 @@ function focusIntoView(element, options) {
     element.focus();
   } else {
     element.focus({ preventScroll: true });
-    element.scrollIntoView(_72I2GWXFcjs.__spreadValues.call(void 0, { block: "nearest", inline: "nearest" }, options));
+    element.scrollIntoView(_AV6KTKLEcjs.__spreadValues.call(void 0, { block: "nearest", inline: "nearest" }, options));
   }
 }