@reapit/elements 5.0.0-beta.60 → 5.0.0-beta.62

package/dist/types/icons/social-youtube.d.ts

@@ -0,0 +1,5 @@
+export declare const SocialYoutubeIcon: {
+    ({ className, color, size, ...rest }: import("./make-icon").IconProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+//# sourceMappingURL=social-youtube.d.ts.map

package/dist/types/icons/social-youtube.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"social-youtube.d.ts","sourceRoot":"/","sources":["icons/social-youtube.tsx"],"names":[],"mappings":"AAGA,eAAO,MAAM,iBAAiB;;;CAAkD,CAAA"}

package/dist/types/icons/user-outline.d.ts

@@ -0,0 +1,5 @@
+export declare const UserOutlineIcon: {
+    ({ className, color, size, ...rest }: import("./make-icon").IconProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+//# sourceMappingURL=user-outline.d.ts.map

package/dist/types/icons/user-outline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-outline.d.ts","sourceRoot":"/","sources":["icons/user-outline.tsx"],"names":[],"mappings":"AAGA,eAAO,MAAM,eAAe;;;CAA8C,CAAA"}

package/dist/types/icons/web.d.ts

@@ -0,0 +1,5 @@
+export declare const WebIcon: {
+    ({ className, color, size, ...rest }: import("./make-icon").IconProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+//# sourceMappingURL=web.d.ts.map

package/dist/types/icons/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"/","sources":["icons/web.tsx"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO;;;CAA8B,CAAA"}

package/dist/types/utils/anchor-positioning/__tests__/build-anchor-positioning-css.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-anchor-positioning-css.test.d.ts","sourceRoot":"/","sources":["utils/anchor-positioning/__tests__/build-anchor-positioning-css.test.ts"],"names":[],"mappings":""}

package/dist/types/utils/anchor-positioning/__tests__/map-inset-position-to-css.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=map-inset-position-to-css.test.d.ts.map

package/dist/types/utils/anchor-positioning/__tests__/map-inset-position-to-css.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-inset-position-to-css.test.d.ts","sourceRoot":"/","sources":["utils/anchor-positioning/__tests__/map-inset-position-to-css.test.ts"],"names":[],"mappings":""}

package/dist/types/utils/anchor-positioning/__tests__/map-placement-to-css.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-placement-to-css.test.d.ts","sourceRoot":"/","sources":["utils/anchor-positioning/__tests__/map-placement-to-css.test.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,0BAA0B,gJAaP,CAAA"}

package/dist/types/utils/anchor-positioning/anchor-positioning.d.ts

@@ -0,0 +1,19 @@
+import { buildAnchorPositioningCSS } from './build-anchor-positioning-css';
+import type { HTMLAttributes } from 'react';
+export declare namespace AnchorPositioning {
+    interface PositioningProps extends buildAnchorPositioningCSS.Input {
+    }
+    interface Props extends buildAnchorPositioningCSS.Input, HTMLAttributes<HTMLStyleElement> {
+    }
+}
+/**
+ * A CSS utility component that allows an element, the _positioned element_, to be tethered to
+ * another element, the _anchor element_, using
+ * [CSS Anchor Positioning](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_anchor_positioning).
+ * Polyfills the anchor positioning in browsers that do not natively support it.
+ *
+ * Renders a <style> element containing a stylesheet with the anchor positioning styles. This
+ * stylesheet will be modified by the polyfill if it is applied.
+ */
+export declare function AnchorPositioning({ alignSelf, anchorElementId, bottom, gap, justifySelf, left, maxWidth, minWidth, placement, positionedElementId, positionTryFallbacks, right, top, }: AnchorPositioning.Props): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=anchor-positioning.d.ts.map

package/dist/types/utils/anchor-positioning/anchor-positioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor-positioning.d.ts","sourceRoot":"/","sources":["utils/anchor-positioning/anchor-positioning.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAA;AAG1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAE3C,yBAAiB,iBAAiB,CAAC;IACjC,UAAiB,gBAAiB,SAAQ,yBAAyB,CAAC,KAAK;KAAG;IAC5E,UAAiB,KAAM,SAAQ,yBAAyB,CAAC,KAAK,EAAE,cAAc,CAAC,gBAAgB,CAAC;KAAG;CACpG;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,SAAS,EACT,eAAe,EACf,MAAM,EACN,GAAS,EACT,WAAW,EACX,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,mBAAmB,EACnB,oBAA6B,EAC7B,KAAK,EACL,GAAG,GACJ,EAAE,iBAAiB,CAAC,KAAK,2CAqCzB"}

package/dist/types/utils/anchor-positioning/anchor-positioning.stories.d.ts

@@ -0,0 +1,58 @@
+import { AnchorPositioning } from './anchor-positioning';
+import type { StoryObj } from '@storybook/react-vite';
+declare const meta: {
+    title: string;
+    component: typeof AnchorPositioning;
+    argTypes: {
+        alignSelf: {
+            control: "text";
+        };
+        bottom: {
+            control: "text";
+        };
+        justifySelf: {
+            control: "text";
+        };
+        placement: {
+            control: {
+                type: "select";
+            };
+            options: ("left" | "right" | "bottom" | "top" | "top-start" | "top-end" | "right-start" | "right-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | undefined)[];
+        };
+        left: {
+            control: "text";
+        };
+        right: {
+            control: "text";
+        };
+        top: {
+            control: "text";
+        };
+    };
+    parameters: {
+        layout: string;
+    };
+    render: (args: AnchorPositioning.Props) => import("react/jsx-runtime").JSX.Element;
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const Example: Story;
+/**
+ * A number of common positions for popovers relative to their anchor are available as simple string-based
+ * placements. These are shown below.
+ */
+export declare const Placement: Story;
+/**
+ * A gap can be specified to add space between the anchor element and the positioned elements.
+ * Only applies when positioning with `placement`.
+ */
+export declare const Gap: Story;
+/**
+ * When the predefined placements are insufficient, inset properties, `top`, `right`, `bottom`, and
+ * `left`, and self-alignment properties, `alignSelf` and `justifySelf`, can be used.
+ *
+ * See [Using inset properties with anchor() function values](https://developer.mozilla.org/en-US/docs/Web/CSS/Guides/Anchor_positioning/Using#using_inset_properties_with_anchor_function_values)
+ * for details on how to position the popover element using this approach.
+ */
+export declare const InsetProperties: Story;
+//# sourceMappingURL=anchor-positioning.stories.d.ts.map

package/dist/types/utils/anchor-positioning/anchor-positioning.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor-positioning.stories.d.ts","sourceRoot":"/","sources":["utils/anchor-positioning/anchor-positioning.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAIxD,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAG3D,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCgC,CAAA;AAE1C,eAAe,IAAI,CAAA;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAA;AAElC,eAAO,MAAM,OAAO,EAAE,KAUrB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,KA+BvB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,GAAG,EAAE,KAMjB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,EAAE,KAS7B,CAAA"}

package/dist/types/utils/anchor-positioning/build-anchor-positioning-css.d.ts

@@ -0,0 +1,40 @@
+import { mapInsetPositionToCSS } from './map-inset-position-to-css';
+import { mapPlacementToCSS } from './map-placement-to-css';
+export declare namespace buildAnchorPositioningCSS {
+    interface Input extends mapInsetPositionToCSS.Input, mapPlacementToCSS.Input {
+        /** ID of the anchor element. */
+        anchorElementId: string;
+        /**
+         * Maximum width of the positioned element. Accepts any valid CSS length, including the special
+         * [anchor-size](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Values/anchor-size).
+         * Defaults to content width. Prefer `--size-*` variables.
+         */
+        maxWidth?: string;
+        /**
+         * Minimum width of the positioned element. Accepts any valid CSS length, including the special
+         * [anchor-size](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Values/anchor-size).
+         * Defaults to content width. Prefer `--size-*` variables.
+         */
+        minWidth?: string;
+        /**
+         * Positioned element ID.
+         */
+        positionedElementId: string;
+        /**
+         * Fallback positions when the positioned element overflows the viewport. See
+         * [position-try-fallbacks](https://developer.mozilla.org/en-US/docs/Web/CSS/position-try-fallbacks).
+         * The [polyfill](https://anchor-positioning.oddbird.net/) limits available options.
+         *
+         * Use "flip-block", "flip-inline", or both. Defaults to "none".
+         */
+        positionTryFallbacks?: string;
+    }
+}
+/**
+ * Generates CSS styles to position an element relative to an anchor, using the specified element IDs.
+ * Escapes IDs with [CSS.escape](https://developer.mozilla.org/en-US/docs/Web/API/CSS/escape_static).
+ *
+ * The `placement` property takes priority over inset properties when specified.
+ */
+export declare function buildAnchorPositioningCSS({ alignSelf, anchorElementId, bottom, gap, justifySelf, left, maxWidth, minWidth, placement, positionedElementId, positionTryFallbacks, right, top, }: buildAnchorPositioningCSS.Input): string;
+//# sourceMappingURL=build-anchor-positioning-css.d.ts.map

package/dist/types/utils/anchor-positioning/build-anchor-positioning-css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-anchor-positioning-css.d.ts","sourceRoot":"/","sources":["utils/anchor-positioning/build-anchor-positioning-css.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE1D,yBAAiB,yBAAyB,CAAC;IACzC,UAAiB,KAAM,SAAQ,qBAAqB,CAAC,KAAK,EAAE,iBAAiB,CAAC,KAAK;QACjF,gCAAgC;QAChC,eAAe,EAAE,MAAM,CAAA;QACvB;;;;WAIG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB;;;;WAIG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB;;WAEG;QACH,mBAAmB,EAAE,MAAM,CAAA;QAC3B;;;;;;WAMG;QACH,oBAAoB,CAAC,EAAE,MAAM,CAAA;KAC9B;CACF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,EACxC,SAAS,EACT,eAAe,EACf,MAAM,EACN,GAAG,EACH,WAAW,EACX,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,mBAAmB,EACnB,oBAA6B,EAC7B,KAAK,EACL,GAAG,GACJ,EAAE,yBAAyB,CAAC,KAAK,GAAG,MAAM,CA+B1C"}

package/dist/types/utils/anchor-positioning/index.d.ts

@@ -0,0 +1,4 @@
+export * from './anchor-positioning';
+export * from './build-anchor-positioning-css';
+export * from './map-placement-to-css';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/utils/anchor-positioning/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"/","sources":["utils/anchor-positioning/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA;AACpC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,wBAAwB,CAAA"}

package/dist/types/utils/anchor-positioning/map-inset-position-to-css.d.ts

@@ -0,0 +1,32 @@
+/**
+ * CSS inset property value that uses the anchor() function or any valid CSS length.
+ * Examples: `anchor(top)`, `anchor(bottom)`, `10px`, `var(--spacing-2)`
+ */
+export type InsetProperty = `anchor(${string})` | (string & {});
+/**
+ * CSS self-alignment property value for anchor positioning.
+ * Currently supports 'anchor-center' to center the element relative to its anchor.
+ */
+export type SelfAlignmentProperty = 'anchor-center';
+export declare namespace mapInsetPositionToCSS {
+    interface Input {
+        /** Aligns the positioned element vertically relative to the anchor. */
+        alignSelf?: SelfAlignmentProperty;
+        /** Distance from the bottom edge. Accepts anchor() function or CSS length. */
+        bottom?: InsetProperty;
+        /** Aligns the positioned element horizontally relative to the anchor. */
+        justifySelf?: SelfAlignmentProperty;
+        /** Distance from the left edge. Accepts anchor() function or CSS length. */
+        left?: InsetProperty;
+        /** Distance from the right edge. Accepts anchor() function or CSS length. */
+        right?: InsetProperty;
+        /** Distance from the top edge. Accepts anchor() function or CSS length. */
+        top?: InsetProperty;
+    }
+}
+/**
+ * Generates CSS positioning properties from inset and alignment values.
+ * Use this when predefined placements are insufficient and custom positioning is required.
+ */
+export declare function mapInsetPositionToCSS({ alignSelf, top, right, bottom, left, justifySelf, }: mapInsetPositionToCSS.Input): string;
+//# sourceMappingURL=map-inset-position-to-css.d.ts.map

package/dist/types/utils/anchor-positioning/map-inset-position-to-css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-inset-position-to-css.d.ts","sourceRoot":"/","sources":["utils/anchor-positioning/map-inset-position-to-css.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAE/D;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,eAAe,CAAA;AAEnD,yBAAiB,qBAAqB,CAAC;IACrC,UAAiB,KAAK;QACpB,uEAAuE;QACvE,SAAS,CAAC,EAAE,qBAAqB,CAAA;QACjC,8EAA8E;QAC9E,MAAM,CAAC,EAAE,aAAa,CAAA;QACtB,yEAAyE;QACzE,WAAW,CAAC,EAAE,qBAAqB,CAAA;QACnC,4EAA4E;QAC5E,IAAI,CAAC,EAAE,aAAa,CAAA;QACpB,6EAA6E;QAC7E,KAAK,CAAC,EAAE,aAAa,CAAA;QACrB,2EAA2E;QAC3E,GAAG,CAAC,EAAE,aAAa,CAAA;KACpB;CACF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,SAAS,EACT,GAAG,EACH,KAAK,EACL,MAAM,EACN,IAAI,EACJ,WAAW,GACZ,EAAE,qBAAqB,CAAC,KAAK,GAAG,MAAM,CAWtC"}

package/dist/types/utils/anchor-positioning/map-placement-to-css.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Predefined placement positions for positioning an element relative to an anchor.
+ * Each placement specifies a side (top, right, bottom, left) with optional alignment (start, end).
+ */
+export declare const placements: readonly ["top", "top-start", "top-end", "right", "right-start", "right-end", "bottom", "bottom-start", "bottom-end", "left", "left-start", "left-end"];
+/** A position relative to an anchor element. */
+export type Placement = (typeof placements)[number];
+export declare namespace mapPlacementToCSS {
+    interface Input {
+        /** Gap between positioned element and anchor. */
+        gap?: string;
+        /** Placement relative to anchor */
+        placement?: Placement;
+    }
+}
+/**
+ * Generates CSS properties to position an element using the specified placement.
+ */
+export declare function mapPlacementToCSS({ gap, placement }: mapPlacementToCSS.Input): string;
+//# sourceMappingURL=map-placement-to-css.d.ts.map

package/dist/types/utils/anchor-positioning/map-placement-to-css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-placement-to-css.d.ts","sourceRoot":"/","sources":["utils/anchor-positioning/map-placement-to-css.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,UAAU,yJAab,CAAA;AAEV,gDAAgD;AAChD,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnD,yBAAiB,iBAAiB,CAAC;IACjC,UAAiB,KAAK;QACpB,iDAAiD;QACjD,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,mCAAmC;QACnC,SAAS,CAAC,EAAE,SAAS,CAAA;KACtB;CACF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,GAAS,EAAE,SAAS,EAAE,EAAE,iBAAiB,CAAC,KAAK,GAAG,MAAM,CA+E3F"}

package/dist/types/utils/listbox/__tests__/get-select-id.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=get-select-id.test.d.ts.map

package/dist/types/utils/listbox/__tests__/get-select-id.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-select-id.test.d.ts","sourceRoot":"/","sources":["utils/listbox/__tests__/get-select-id.test.ts"],"names":[],"mappings":""}

package/dist/types/utils/listbox/__tests__/listbox.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=listbox.test.d.ts.map

package/dist/types/utils/listbox/__tests__/listbox.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listbox.test.d.ts","sourceRoot":"/","sources":["utils/listbox/__tests__/listbox.test.tsx"],"names":[],"mappings":""}

package/dist/types/utils/listbox/__tests__/use-listbox-selection-observer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=use-listbox-selection-observer.test.d.ts.map

package/dist/types/utils/listbox/__tests__/use-listbox-selection-observer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-listbox-selection-observer.test.d.ts","sourceRoot":"/","sources":["utils/listbox/__tests__/use-listbox-selection-observer.test.tsx"],"names":[],"mappings":""}

package/dist/types/utils/listbox/__tests__/use-listbox-state.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=use-listbox-state.test.d.ts.map

package/dist/types/utils/listbox/__tests__/use-listbox-state.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-listbox-state.test.d.ts","sourceRoot":"/","sources":["utils/listbox/__tests__/use-listbox-state.test.tsx"],"names":[],"mappings":""}

package/dist/types/utils/listbox/context.d.ts

@@ -0,0 +1,26 @@
+export declare namespace ListboxContext {
+    interface Value {
+        /** Whether the listbox and its options are disabled */
+        disabled: boolean;
+        /** Listbox element ID */
+        listboxId: string;
+        /** Allows multiple option selection */
+        multiple: boolean;
+        /** Whether to toggle or select the option when clicked */
+        selectAction: 'auto' | 'select' | 'toggle';
+        /** Currently selected option values from the hidden select element */
+        selectValue: readonly string[];
+    }
+}
+/**
+ * Provides configuration and state to Listbox descendants for managing
+ * listbox behavior, selection, and form integration.
+ */
+export declare const ListboxContext: import("react").Context<ListboxContext.Value | null>;
+/**
+ * Returns the current ListboxContext value.
+ * @returns The listbox context containing configuration and state
+ * @throws {Error} when used outside a Listbox
+ */
+export declare function useListboxContext(): ListboxContext.Value;
+//# sourceMappingURL=context.d.ts.map

package/dist/types/utils/listbox/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"/","sources":["utils/listbox/context.ts"],"names":[],"mappings":"AAEA,yBAAiB,cAAc,CAAC;IAC9B,UAAiB,KAAK;QACpB,uDAAuD;QACvD,QAAQ,EAAE,OAAO,CAAA;QACjB,yBAAyB;QACzB,SAAS,EAAE,MAAM,CAAA;QACjB,uCAAuC;QACvC,QAAQ,EAAE,OAAO,CAAA;QACjB,0DAA0D;QAC1D,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAA;QAC1C,sEAAsE;QACtE,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;KAC/B;CACF;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,sDAAmD,CAAA;AAE9E;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAAC,KAAK,CAMxD"}

package/dist/types/utils/listbox/dom-helpers/__tests__/clear-listbox-value.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=clear-listbox-value.test.d.ts.map

package/dist/types/utils/listbox/dom-helpers/__tests__/clear-listbox-value.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear-listbox-value.test.d.ts","sourceRoot":"/","sources":["utils/listbox/dom-helpers/__tests__/clear-listbox-value.test.tsx"],"names":[],"mappings":""}

package/dist/types/utils/listbox/dom-helpers/__tests__/common.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=common.test.d.ts.map

package/dist/types/utils/listbox/dom-helpers/__tests__/common.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.test.d.ts","sourceRoot":"/","sources":["utils/listbox/dom-helpers/__tests__/common.test.tsx"],"names":[],"mappings":""}

package/dist/types/utils/listbox/dom-helpers/__tests__/get-listbox-selected-options.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=get-listbox-selected-options.test.d.ts.map

package/dist/types/utils/listbox/dom-helpers/__tests__/get-listbox-selected-options.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-listbox-selected-options.test.d.ts","sourceRoot":"/","sources":["utils/listbox/dom-helpers/__tests__/get-listbox-selected-options.test.tsx"],"names":[],"mappings":""}

package/dist/types/utils/listbox/dom-helpers/__tests__/get-listbox-value.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=get-listbox-value.test.d.ts.map

package/dist/types/utils/listbox/dom-helpers/__tests__/get-listbox-value.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-listbox-value.test.d.ts","sourceRoot":"/","sources":["utils/listbox/dom-helpers/__tests__/get-listbox-value.test.tsx"],"names":[],"mappings":""}

package/dist/types/utils/listbox/dom-helpers/__tests__/is-listbox-option-selected.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=is-listbox-option-selected.test.d.ts.map

package/dist/types/utils/listbox/dom-helpers/__tests__/is-listbox-option-selected.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-listbox-option-selected.test.d.ts","sourceRoot":"/","sources":["utils/listbox/dom-helpers/__tests__/is-listbox-option-selected.test.tsx"],"names":[],"mappings":""}

package/dist/types/utils/listbox/dom-helpers/__tests__/set-listbox-option-selected-state.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=set-listbox-option-selected-state.test.d.ts.map

package/dist/types/utils/listbox/dom-helpers/__tests__/set-listbox-option-selected-state.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-listbox-option-selected-state.test.d.ts","sourceRoot":"/","sources":["utils/listbox/dom-helpers/__tests__/set-listbox-option-selected-state.test.tsx"],"names":[],"mappings":""}

package/dist/types/utils/listbox/dom-helpers/clear-listbox-value.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Clears all selected options in a listbox.
+ *
+ * Iterates through all selected options in the underlying select element and deselects them.
+ * Dispatches an input event to notify listeners, but only when selected options exist.
+ *
+ * @param listboxId - Listbox element ID
+ * @throws {ListboxError} when the listbox does not exist or lacks a select element
+ *
+ * @example
+ * // Clear all selections in a listbox
+ * clearListboxValue('my-listbox')
+ *
+ * @example
+ * // Clear selections with error handling
+ * try {
+ *   clearListboxValue('my-listbox')
+ * } catch (error) {
+ *   if (error instanceof ListboxError) {
+ *     console.error('Failed to clear listbox:', error.message)
+ *   }
+ * }
+ */
+export declare function clearListboxValue(listboxId: string): void;
+//# sourceMappingURL=clear-listbox-value.d.ts.map

package/dist/types/utils/listbox/dom-helpers/clear-listbox-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear-listbox-value.d.ts","sourceRoot":"/","sources":["utils/listbox/dom-helpers/clear-listbox-value.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAYzD"}

package/dist/types/utils/listbox/dom-helpers/common.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Custom error class for listbox-related errors.
+ * Provides more specific error identification for debugging.
+ */
+export declare class ListboxError extends Error {
+    constructor(message: string);
+}
+/**
+ * Gets the select element from a listbox by its ID.
+ * @param listboxId - The ID of the listbox element
+ * @returns The select element within the listbox
+ * @throws {ListboxError} if the listbox does not exist or does not contain a select element.
+ */
+export declare function getListboxSelectElement(listboxId: string): HTMLSelectElement;
+/**
+ * Gets an option element from a select element by its value.
+ * @param selectElement - The select element to search within
+ * @param optionValue - The value of the option to find
+ * @returns The option element with the matching value
+ * @throws {ListboxError} if the option does not exist.
+ */
+export declare function getSelectOptionByValue(selectElement: HTMLSelectElement, optionValue: string): HTMLOptionElement;
+/**
+ * Dispatches an input event on the select element to notify listeners of changes.
+ * @param selectElement - The select element to dispatch the event on
+ */
+export declare function dispatchInputEvent(selectElement: HTMLSelectElement): void;
+//# sourceMappingURL=common.d.ts.map

package/dist/types/utils/listbox/dom-helpers/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"/","sources":["utils/listbox/dom-helpers/common.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAQ5B;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAkB5E;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,GAAG,iBAAiB,CAc/G;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,iBAAiB,GAAG,IAAI,CAGzE"}

package/dist/types/utils/listbox/dom-helpers/get-listbox-selected-options.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Returns an array of the selected display options (button elements) from a listbox.
+ *
+ * This function queries the listbox DOM for all option elements that are currently marked as
+ * selected using ARIA attributes (aria-checked="true" or aria-selected="true"). Unlike
+ * `getListboxValue`, which returns the values themselves, this function returns the actual
+ * DOM button elements representing the selected options.
+ *
+ * This is useful when you need to interact with the selected option elements directly,
+ * such as for styling, scrolling into view, or extracting additional data attributes.
+ *
+ * @param listboxElement - The listbox element to search within
+ * @returns An array of HTMLButtonElement instances representing the selected options
+ *
+ * @example
+ * // Get selected option elements from a listbox
+ * const listboxElement = document.getElementById('my-listbox')
+ * const selectedOptions = getListboxSelectedOptions(listboxElement)
+ * console.log(`${selectedOptions.length} options selected`)
+ *
+ * @example
+ * // Scroll the first selected option into view
+ * const selectedOptions = getListboxSelectedOptions(listboxElement)
+ * if (selectedOptions.length > 0) {
+ *   selectedOptions[0].scrollIntoView({ block: 'nearest' })
+ * }
+ *
+ * @example
+ * // Extract values from selected option buttons
+ * const selectedOptions = getListboxSelectedOptions(listboxElement)
+ * const values = selectedOptions.map(option => option.value)
+ *
+ * @example
+ * // Apply styling to selected options
+ * const selectedOptions = getListboxSelectedOptions(listboxElement)
+ * selectedOptions.forEach(option => {
+ *   option.classList.add('highlighted')
+ * })
+ */
+export declare function getListboxSelectedOptions(listboxElement: HTMLElement): HTMLButtonElement[];
+//# sourceMappingURL=get-listbox-selected-options.d.ts.map

package/dist/types/utils/listbox/dom-helpers/get-listbox-selected-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-listbox-selected-options.d.ts","sourceRoot":"/","sources":["utils/listbox/dom-helpers/get-listbox-selected-options.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,WAAW,GAAG,iBAAiB,EAAE,CAK1F"}

package/dist/types/utils/listbox/dom-helpers/get-listbox-value.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Gets selected values from a listbox.
+ *
+ * Retrieves all selected option values from the underlying select element. Filters out
+ * empty string values (typically from placeholder options). Accepts either a listbox ID
+ * or a direct reference to the select element.
+ *
+ * @param listboxId - Listbox element ID
+ * @returns Readonly array of selected option values, excluding empty strings
+ * @throws {ListboxError} when the listbox does not exist or lacks a select element
+ */
+export declare function getListboxValue(listboxId: string): readonly string[];
+export declare function getListboxValue(selectElement: HTMLSelectElement): readonly string[];
+//# sourceMappingURL=get-listbox-value.d.ts.map

package/dist/types/utils/listbox/dom-helpers/get-listbox-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-listbox-value.d.ts","sourceRoot":"/","sources":["utils/listbox/dom-helpers/get-listbox-value.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;AACrE,wBAAgB,eAAe,CAAC,aAAa,EAAE,iBAAiB,GAAG,SAAS,MAAM,EAAE,CAAA"}

package/dist/types/utils/listbox/dom-helpers/index.d.ts

@@ -0,0 +1,7 @@
+export * from './clear-listbox-value';
+export * from './get-listbox-value';
+export * from './get-listbox-selected-options';
+export * from './is-listbox-option-selected';
+export * from './selectors';
+export * from './set-listbox-option-selected-state';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/utils/listbox/dom-helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"/","sources":["utils/listbox/dom-helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,aAAa,CAAA;AAC3B,cAAc,qCAAqC,CAAA"}

package/dist/types/utils/listbox/dom-helpers/is-listbox-option-selected.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Determines whether a listbox option is selected by checking its ARIA attributes.
+ *
+ * This function checks both `aria-checked` and `aria-selected` attributes because
+ * the appropriate attribute depends on the listbox type:
+ * - Single-select listboxes use `aria-selected="true"` to indicate selection
+ * - Multi-select listboxes use `aria-checked="true"` to indicate selection
+ *
+ * See https://www.w3.org/WAI/ARIA/apg/patterns/listbox for ARIA listbox patterns.
+ *
+ * @param option - The button element representing a listbox option
+ * @returns `true` if the option is selected (either checked or selected), `false` otherwise
+ *
+ * @example
+ * // Check if a specific option is selected
+ * const optionElement = document.querySelector('[role="option"][value="option1"]')
+ * if (isListboxOptionSelected(optionElement)) {
+ *   console.log('Option 1 is selected')
+ * }
+ *
+ * @example
+ * // Filter to only selected options
+ * const allOptions = Array.from(document.querySelectorAll('[role="option"]'))
+ * const selectedOptions = allOptions.filter(isListboxOptionSelected)
+ *
+ * @example
+ * // Check selection in a multi-select listbox (uses aria-checked)
+ * const multiSelectOption = document.querySelector('[aria-checked="true"]')
+ * console.log(isListboxOptionSelected(multiSelectOption)) // true
+ *
+ * @example
+ * // Check selection in a single-select listbox (uses aria-selected)
+ * const singleSelectOption = document.querySelector('[aria-selected="true"]')
+ * console.log(isListboxOptionSelected(singleSelectOption)) // true
+ */
+export declare function isListboxOptionSelected(option: HTMLButtonElement): boolean;
+//# sourceMappingURL=is-listbox-option-selected.d.ts.map

package/dist/types/utils/listbox/dom-helpers/is-listbox-option-selected.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-listbox-option-selected.d.ts","sourceRoot":"/","sources":["utils/listbox/dom-helpers/is-listbox-option-selected.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAE1E"}

package/dist/types/utils/listbox/dom-helpers/selectors.d.ts

@@ -0,0 +1,23 @@
+/**
+ * CSS selector for all listbox option elements.
+ *
+ * Matches button elements with the role="option" attribute, which represent
+ * individual options within a listbox. These are the interactive elements that
+ * users can click or navigate to with the keyboard.
+ */
+export declare const OPTION_SELECTOR = "button[role=\"option\"]";
+/**
+ * CSS selector for selected listbox option elements.
+ *
+ * Matches button elements with role="option" that are currently selected,
+ * as indicated by either aria-checked="true" or aria-selected="true".
+ *
+ * The selector checks both attributes because:
+ * - Single-select listboxes use `aria-selected="true"` to indicate selection
+ * - Multi-select listboxes use `aria-checked="true"` to indicate selection
+ *
+ * This follows the ARIA listbox pattern specification:
+ * https://www.w3.org/WAI/ARIA/apg/patterns/listbox
+ */
+export declare const SELECTED_OPTION_SELECTOR = "button[role=\"option\"]:is([aria-checked=\"true\"], [aria-selected=\"true\"])";
+//# sourceMappingURL=selectors.d.ts.map

package/dist/types/utils/listbox/dom-helpers/selectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.d.ts","sourceRoot":"/","sources":["utils/listbox/dom-helpers/selectors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,4BAA0B,CAAA;AAEtD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB,kFAAyE,CAAA"}

package/dist/types/utils/listbox/dom-helpers/set-listbox-option-selected-state.d.ts

@@ -0,0 +1,27 @@
+export type SelectionSetter = (selected: boolean, selectElement: HTMLSelectElement) => boolean;
+/**
+ * Updates a listbox option's selected state and dispatches an input event when the state changes.
+ *
+ * Modifies the selected state of a specific option in the underlying select element and
+ * triggers an input event to notify listeners. Dispatches the event only when the selected
+ * state changes.
+ *
+ * @param listboxId - Listbox element ID
+ * @param optionValue - Option value to update
+ * @param setter - Receives current selected state and returns new selected state
+ * @throws {ListboxError} when the listbox or option does not exist
+ *
+ * @example
+ * // Toggle an option's selected state
+ * setListboxOptionSelectedState('my-listbox', 'option1', (selected) => !selected)
+ *
+ * @example
+ * // Always select an option
+ * setListboxOptionSelectedState('my-listbox', 'option2', () => true)
+ *
+ * @example
+ * // Always deselect an option
+ * setListboxOptionSelectedState('my-listbox', 'option3', () => false)
+ */
+export declare function setListboxOptionSelectedState(listboxId: string, optionValue: string, setter: SelectionSetter): void;
+//# sourceMappingURL=set-listbox-option-selected-state.d.ts.map

package/dist/types/utils/listbox/dom-helpers/set-listbox-option-selected-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-listbox-option-selected-state.d.ts","sourceRoot":"/","sources":["utils/listbox/dom-helpers/set-listbox-option-selected-state.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,iBAAiB,KAAK,OAAO,CAAA;AAE9F;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CASnH"}

package/dist/types/utils/listbox/get-select-id.d.ts

@@ -0,0 +1,2 @@
+export declare function getListboxSelectId(listboxId: string): string;
+//# sourceMappingURL=get-select-id.d.ts.map