@proyecto-viviana/solidaria 0.3.0 → 0.4.0

package/dist/selection/ListKeyboardDelegate.d.ts

@@ -0,0 +1,95 @@
+/**
+ * ListKeyboardDelegate - keyboard navigation for a list/stack collection.
+ * Based on @react-aria/selection's `ListKeyboardDelegate`.
+ *
+ * React → Solid adaptations (faithful to upstream behavior):
+ *  - The ref is a Solid accessor (`() => HTMLElement | null`) rather than a
+ *    React `RefObject`; `this.ref()` replaces `this.ref.current`.
+ *  - Only the options-object constructor is kept. Upstream also retains a legacy
+ *    positional overload for old `useSelectableCollection` callers; we have none.
+ *  - `getKeyLeftOf` / `getKeyRightOf` are still removed for a vertical stack
+ *    (so `delegate.getKeyLeftOf` is `undefined`, exactly as upstream), which the
+ *    selectable-collection handler relies on to no-op Left/Right.
+ *  - Disabled resolution reads our node shape: per-item disabled lives on the
+ *    top-level `node.isDisabled` (and is also funneled into `disabledKeys`),
+ *    while upstream reads `node.props.isDisabled`. We check both so the delegate
+ *    is correct whether constructed from a manager or directly in a test.
+ */
+import type { Accessor } from "solid-js";
+import type { Collection, DisabledBehavior, Key } from "@proyecto-viviana/solid-stately";
+import type { KeyboardDelegate } from "../grid/types";
+import { type LayoutDelegate } from "./DOMLayoutDelegate";
+/** The primary orientation of a list's items. */
+export type Orientation = "horizontal" | "vertical";
+/** Text direction. */
+export type Direction = "ltr" | "rtl";
+export interface ListKeyboardDelegateOptions<T> {
+    /** The collection to navigate. */
+    collection: Collection<T>;
+    /** A Solid ref accessor to the collection element. */
+    ref: Accessor<HTMLElement | null>;
+    /** A locale-aware collator used for typeahead search. */
+    collator?: Intl.Collator;
+    /** The layout of the items: a 1D `stack` (default) or a 2D `grid`. */
+    layout?: "stack" | "grid";
+    /** The primary orientation of the items. @default 'vertical' */
+    orientation?: Orientation;
+    /** The text direction. */
+    direction?: Direction;
+    /** The item keys that are disabled. */
+    disabledKeys?: Set<Key>;
+    /** Whether disabled items are skipped by navigation. @default 'all' */
+    disabledBehavior?: DisabledBehavior;
+    /** A delegate providing layout information (defaults to a DOM-backed one). */
+    layoutDelegate?: LayoutDelegate;
+}
+/**
+ * A keyboard delegate that handles navigation within a list/stack collection.
+ */
+export declare class ListKeyboardDelegate<T> implements KeyboardDelegate {
+    private collection;
+    private disabledKeys;
+    private disabledBehavior;
+    private ref;
+    private collator;
+    private layout;
+    private orientation;
+    private direction;
+    private layoutDelegate;
+    /** Present unless this is a vertical stack (mirrors upstream's method deletion). */
+    getKeyLeftOf?: (key: Key, options?: {
+        includeDisabled?: boolean;
+    }) => Key | null;
+    /** Present unless this is a vertical stack (mirrors upstream's method deletion). */
+    getKeyRightOf?: (key: Key, options?: {
+        includeDisabled?: boolean;
+    }) => Key | null;
+    constructor(options: ListKeyboardDelegateOptions<T>);
+    private isDisabled;
+    private findNextNonDisabled;
+    getNextKey(key: Key, options?: {
+        includeDisabled?: boolean;
+    }): Key | null;
+    getPreviousKey(key: Key, options?: {
+        includeDisabled?: boolean;
+    }): Key | null;
+    private findKey;
+    private isSameRow;
+    private isSameColumn;
+    private isReversed;
+    getKeyBelow(key: Key, options?: {
+        includeDisabled?: boolean;
+    }): Key | null;
+    getKeyAbove(key: Key, options?: {
+        includeDisabled?: boolean;
+    }): Key | null;
+    private getNextColumn;
+    private computeKeyRightOf;
+    private computeKeyLeftOf;
+    getFirstKey(): Key | null;
+    getLastKey(): Key | null;
+    getKeyPageAbove(key: Key): Key | null;
+    getKeyPageBelow(key: Key): Key | null;
+    getKeyForSearch(search: string, fromKey?: Key): Key | null;
+}
+//# sourceMappingURL=ListKeyboardDelegate.d.ts.map

package/dist/selection/ListKeyboardDelegate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListKeyboardDelegate.d.ts","sourceRoot":"","sources":["../../src/selection/ListKeyboardDelegate.ts"],"names":[],"mappings":"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"}

package/dist/selection/constants.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Custom DOM event names used to drive virtual focus into a selectable
+ * collection from an outside controller (e.g. an Autocomplete input). Mirrors
+ * @react-aria/selection's `utils/constants` (`FOCUS_EVENT` / `CLEAR_FOCUS_EVENT`).
+ *
+ * Canonical home is here, in the selection layer, because the collection is the
+ * consumer that listens for them. A controller that wants to move virtual focus
+ * (the deferred autocomplete-collection bridge) dispatches these onto the
+ * collection ref.
+ */
+/** Dispatched onto a collection to focus it (optionally its first item). */
+export declare const FOCUS_EVENT = "react-aria-focus";
+/** Dispatched onto a collection to blur it (optionally clearing the focused key). */
+export declare const CLEAR_FOCUS_EVENT = "react-aria-clear-focus";
+//# sourceMappingURL=constants.d.ts.map

package/dist/selection/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/selection/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,4EAA4E;AAC5E,eAAO,MAAM,WAAW,qBAAqB,CAAC;AAE9C,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,2BAA2B,CAAC"}

package/dist/selection/createCollectionRowInteraction.d.ts

@@ -0,0 +1,13 @@
+import type { Accessor, JSX } from "solid-js";
+type KeyboardNavigationBehavior = "arrow" | "tab";
+interface CollectionRowInteractionOptions {
+    ref: Accessor<HTMLElement | null>;
+    keyboardNavigationBehavior: Accessor<KeyboardNavigationBehavior>;
+    direction?: Accessor<"ltr" | "rtl">;
+}
+type CollectionRowInteractionProps<T extends HTMLElement> = JSX.HTMLAttributes<T> & {
+    onKeyDownCapture?: JSX.EventHandler<T, KeyboardEvent>;
+};
+export declare function mergeCollectionRowInteractionProps<T extends HTMLElement>(rowProps: CollectionRowInteractionProps<T>, options: CollectionRowInteractionOptions): CollectionRowInteractionProps<T>;
+export {};
+//# sourceMappingURL=createCollectionRowInteraction.d.ts.map

package/dist/selection/createCollectionRowInteraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createCollectionRowInteraction.d.ts","sourceRoot":"","sources":["../../src/selection/createCollectionRowInteraction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAY9C,KAAK,0BAA0B,GAAG,OAAO,GAAG,KAAK,CAAC;AAElD,UAAU,+BAA+B;IACvC,GAAG,EAAE,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAClC,0BAA0B,EAAE,QAAQ,CAAC,0BAA0B,CAAC,CAAC;IACjE,SAAS,CAAC,EAAE,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;CACrC;AAED,KAAK,6BAA6B,CAAC,CAAC,SAAS,WAAW,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG;IAClF,gBAAgB,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;CACvD,CAAC;AA0CF,wBAAgB,kCAAkC,CAAC,CAAC,SAAS,WAAW,EACtE,QAAQ,EAAE,6BAA6B,CAAC,CAAC,CAAC,EAC1C,OAAO,EAAE,+BAA+B,GACvC,6BAA6B,CAAC,CAAC,CAAC,CA6IlC"}

package/dist/selection/createScrollIntoViewOnFocus.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Reveals the virtually-focused collection item when the focused key changes via
+ * keyboard navigation.
+ *
+ * Mirrors the focused-key scroll effect in @react-aria/selection's
+ * `useSelectableCollection`. Activedescendant collections (ListBox / Menu /
+ * ComboBox) keep real DOM focus on the container and point at the active item
+ * with `aria-activedescendant`, so the browser never natively scrolls the
+ * focused option into view the way a roving-tabindex collection would. This
+ * effect restores that behavior through our `scrollIntoViewport` util.
+ */
+import type { Key } from "@proyecto-viviana/solid-stately";
+export interface ScrollIntoViewOnFocusOptions {
+    /** The currently focused collection key. */
+    focusedKey: () => Key | null;
+    /** The collection element, which is also the scroll container. */
+    ref: () => HTMLElement | null | undefined;
+    /**
+     * Whether the collection is the active focus target. When this returns false
+     * the scroll is suppressed so a background focused-key change can't move the
+     * page. Mirrors upstream's `manager.isFocused` gate. Defaults to always active.
+     */
+    isActive?: () => boolean;
+    /**
+     * Resolves the DOM element for a focused key within `root`. Defaults to a
+     * `[data-key]` lookup, which every collection item carries.
+     */
+    getItemElement?: (root: HTMLElement, key: Key) => HTMLElement | null;
+}
+export declare function createScrollIntoViewOnFocus(options: ScrollIntoViewOnFocusOptions): void;
+//# sourceMappingURL=createScrollIntoViewOnFocus.d.ts.map

package/dist/selection/createScrollIntoViewOnFocus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createScrollIntoViewOnFocus.d.ts","sourceRoot":"","sources":["../../src/selection/createScrollIntoViewOnFocus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iCAAiC,CAAC;AAI3D,MAAM,WAAW,4BAA4B;IAC3C,4CAA4C;IAC5C,UAAU,EAAE,MAAM,GAAG,GAAG,IAAI,CAAC;IAC7B,kEAAkE;IAClE,GAAG,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC;IACzB;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,KAAK,WAAW,GAAG,IAAI,CAAC;CACtE;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,4BAA4B,GAAG,IAAI,CA4BvF"}

package/dist/selection/createSelectableCollection.d.ts

@@ -0,0 +1,69 @@
+/**
+ * createSelectableCollection - keyboard, focus, and selection interactions for a
+ * selectable collection. Based on @react-aria/selection's
+ * `useSelectableCollection`.
+ *
+ * React → Solid adaptations (faithful to upstream behavior):
+ *  - `ref` / `scrollRef` are Solid accessors; `keyboardDelegate` may be an
+ *    accessor so a recreated delegate stays current.
+ *  - Per-render React effects become `createEffect`s that read the manager's
+ *    reactive getters: the autofocus and scroll-into-view effects track
+ *    `isFocused` / `focusedKey` / `collection.size` and run when those change.
+ *    `useUpdateLayoutEffect` (skip-first) maps to `on(..., { defer: true })`.
+ *  - Plain closure variables replace `useRef` (a Solid component body runs once).
+ *  - React's bubbling `onFocus` / `onBlur` are `onFocusIn` / `onFocusOut`
+ *    (the native bubbling focus events) here.
+ *  - The link branch opens the anchor directly (we have no router abstraction)
+ *    and needs no `flushSync` — `setFocusedKey` is synchronous and the keyed
+ *    item element already exists in the DOM.
+ *  - Virtual-focus cursor movement (`moveVirtualFocus` / `dispatchVirtualFocus`)
+ *    is not yet modeled — a documented gap, consistent with createSelectableItem.
+ *    The focused-key bookkeeping around it is preserved.
+ */
+import { type JSX } from "solid-js";
+import type { FocusStrategy, SelectionManager } from "@proyecto-viviana/solid-stately";
+import type { KeyboardDelegate } from "../grid/types";
+import { type MaybeAccessor } from "../utils/reactivity";
+export interface CreateSelectableCollectionOptions<T = unknown> {
+    /** An interface for reading and updating multiple selection state. */
+    selectionManager: SelectionManager<T>;
+    /** A delegate object that implements behavior for keyboard focus movement. */
+    keyboardDelegate: MaybeAccessor<KeyboardDelegate>;
+    /** The ref accessor attached to the element representing the collection. */
+    ref: () => HTMLElement | null;
+    /** Whether the collection or one of its items should be auto-focused. @default false */
+    autoFocus?: boolean | FocusStrategy;
+    /** Whether focus should wrap around when the end/start is reached. @default false */
+    shouldFocusWrap?: boolean;
+    /** Whether the collection allows empty selection. @default false */
+    disallowEmptySelection?: boolean;
+    /** Whether the user can select all items via keyboard shortcut. @default false */
+    disallowSelectAll?: boolean;
+    /** Whether Escape clears selection. @default 'clearSelection' */
+    escapeKeyBehavior?: "clearSelection" | "none";
+    /** Whether selection should occur automatically on focus. @default selectionBehavior === 'replace' */
+    selectOnFocus?: boolean;
+    /** Whether typeahead is disabled. @default false */
+    disallowTypeAhead?: boolean;
+    /** Whether the collection items use virtual focus instead of being focused directly. */
+    shouldUseVirtualFocus?: boolean;
+    /** Whether navigation through the Tab key is enabled. */
+    allowsTabNavigation?: boolean;
+    /** Whether the collection items are contained in a virtual scroller. */
+    isVirtualized?: boolean;
+    /** The ref accessor attached to the scrollable body. Defaults to the collection ref. */
+    scrollRef?: () => HTMLElement | null;
+    /** The behavior of links in the collection. @default 'action' */
+    linkBehavior?: "action" | "selection" | "override";
+    /** Which item to focus when tabbing into the collection. @private */
+    UNSTABLE_focusOnEntry?: "first" | "last";
+}
+export interface SelectableCollectionAria {
+    /** Props for the collection element. */
+    collectionProps: JSX.HTMLAttributes<HTMLElement>;
+}
+/**
+ * Handles interactions with selectable collections.
+ */
+export declare function createSelectableCollection<T = unknown>(options: CreateSelectableCollectionOptions<T>): SelectableCollectionAria;
+//# sourceMappingURL=createSelectableCollection.d.ts.map

package/dist/selection/createSelectableCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSelectableCollection.d.ts","sourceRoot":"","sources":["../../src/selection/createSelectableCollection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAA+B,KAAK,GAAG,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAO,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAC5F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAU,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAoBjE,MAAM,WAAW,iCAAiC,CAAC,CAAC,GAAG,OAAO;IAC5D,sEAAsE;IACtE,gBAAgB,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACtC,8EAA8E;IAC9E,gBAAgB,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAClD,4EAA4E;IAC5E,GAAG,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IAC9B,wFAAwF;IACxF,SAAS,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;IACpC,qFAAqF;IACrF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oEAAoE;IACpE,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,kFAAkF;IAClF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;IAC9C,sGAAsG;IACtG,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,wFAAwF;IACxF,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,yDAAyD;IACzD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,wEAAwE;IACxE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACrC,iEAAiE;IACjE,YAAY,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;IACnD,qEAAqE;IACrE,qBAAqB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1C;AAED,MAAM,WAAW,wBAAwB;IACvC,wCAAwC;IACxC,eAAe,EAAE,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;CAClD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,GAAG,OAAO,EACpD,OAAO,EAAE,iCAAiC,CAAC,CAAC,CAAC,GAC5C,wBAAwB,CAyhB1B"}

package/dist/selection/createSelectableItem.d.ts

@@ -0,0 +1,154 @@
+/**
+ * createSelectableItem - handles interactions with an item in a selectable
+ * collection. Port of `@react-aria/selection`'s `useSelectableItem`.
+ *
+ * This encapsulates the full press-path action model: the
+ * selection-vs-action decision per pointer type, the press-up-vs-press timing
+ * (menus select on press up, rows on press down), the keyboard Space/Enter
+ * split, double-click secondary actions, and long-press-to-toggle. The
+ * selection decision itself is delegated to the aria-layer {@link selectItem}
+ * (Phase 0), which is also where the platform-aware modifier resolution lives.
+ *
+ * Documented adaptations from upstream (React → Solid / our thinner state):
+ * - **Link model is prop-threaded.** Our collection nodes don't expose
+ *   `manager.isLink`/`manager.getItemProps`, so link items pass `isLink` /
+ *   `href` / `routerOptions` via options and navigation goes through
+ *   {@link openLink} (we have no `RouterProvider` context).
+ * - **Selection manager shape is structural.** ListState passes its
+ *   SelectionManager; grid-like states pass an adapter with the same observable
+ *   surface. `canSelectItem` is read from that surface when available so
+ *   `disabledBehavior: 'selection'` keeps actions enabled while selection stays
+ *   blocked.
+ * - **Virtual focus** guards real DOM focus and updates the focused key on
+ *   press; we have no `moveVirtualFocus`, so no AT cursor move is dispatched.
+ * - **`onDragStart`** is bubble phase (upstream uses capture to beat `useDrag`);
+ *   wired to capture when drag-and-drop integration lands.
+ * - **`getItemProps` press-handler chaining** (collection-provided press
+ *   handlers) is omitted — our nodes don't carry them.
+ */
+import { type Accessor, type JSX } from "solid-js";
+import type { Collection, DisabledBehavior, FocusStrategy, Key, Selection, SelectionBehavior } from "@proyecto-viviana/solid-stately";
+import { type PressEvent } from "../interactions/createPress";
+import { type MaybeAccessor } from "../utils/reactivity";
+import { type SelectItemState } from "./selectItem";
+/**
+ * DOM event dispatched when an item action is performed. Mirrors upstream's
+ * `react-aria-item-action`; combobox/autocomplete listen for it to close on
+ * action. Exported so emitter and listener share one constant.
+ */
+export declare const ITEM_ACTION_EVENT = "solidaria:item-action";
+/** How links in the collection behave relative to selection and actions. */
+export type LinkBehavior = "action" | "selection" | "override" | "none";
+export interface CreateSelectableItemOptions {
+    /** A unique key for the item. */
+    key: Key;
+    /** Optional DOM id for the item element. Defaults to a generated id. */
+    id?: string;
+    /**
+     * By default, selection occurs on pointer down. Set to select on pointer up
+     * instead — useful when selecting an item makes the UI disappear (e.g. menus).
+     */
+    shouldSelectOnPressUp?: boolean;
+    /**
+     * Whether selection may trigger on a pointer up whose pointer down occurred on
+     * a different target (e.g. press down on the menu trigger, up on a menu item).
+     */
+    allowsDifferentPressOrigin?: boolean;
+    /** Whether the item is contained in a virtual scroller. */
+    isVirtualized?: boolean;
+    /** Function to focus the item, overriding the default DOM focus. */
+    focus?: () => void;
+    /** Whether the item should use virtual focus instead of receiving DOM focus. */
+    shouldUseVirtualFocus?: boolean;
+    /** Whether the item is disabled. */
+    isDisabled?: boolean;
+    /**
+     * Handler called when the user performs an action on the item. The triggering
+     * event depends on the collection's `selectionBehavior` and the modality.
+     */
+    onAction?: (event: PressEvent | MouseEvent) => void;
+    /**
+     * The behavior of links in the collection.
+     * - `action`: link behaves like onAction.
+     * - `selection`: link follows selection interactions (e.g. URL drives selection).
+     * - `override`: links override all other interactions (link items aren't selectable).
+     * - `none`: links are disabled for both selection and actions.
+     * @default 'action'
+     */
+    linkBehavior?: LinkBehavior;
+    /** Whether this item is a link (prop-threaded; our nodes don't expose `isLink`). */
+    isLink?: boolean;
+    /** The link target URL, when `isLink`. */
+    href?: string;
+    /** Router options forwarded to navigation, when `isLink`. */
+    routerOptions?: Record<string, unknown>;
+    /**
+     * Unstable upstream override that forces an item with `onAction` to treat the
+     * action as primary (single click), even when it is selectable.
+     */
+    UNSTABLE_itemBehavior?: "selection" | "action";
+}
+export interface SelectableItemAria {
+    /** Props to spread on the item root element. */
+    itemProps: JSX.HTMLAttributes<HTMLElement>;
+    /** Whether the item is currently pressed. */
+    isPressed: Accessor<boolean>;
+    /** Whether the item is currently selected. */
+    isSelected: Accessor<boolean>;
+    /** Whether the item is currently focused. */
+    isFocused: Accessor<boolean>;
+    /** Whether the item is non-interactive (selection and actions both disabled). */
+    isDisabled: Accessor<boolean>;
+    /** Whether the item may be selected. */
+    allowsSelection: Accessor<boolean>;
+    /** Whether the item has an action (primary or secondary). */
+    hasAction: Accessor<boolean>;
+}
+export interface SelectableItemState<T> extends SelectItemState {
+    /** The collection the item belongs to. */
+    readonly collection: Accessor<Collection<T>>;
+    /** Whether the collection is currently focused. */
+    readonly isFocused: Accessor<boolean>;
+    /** Sets whether the collection is focused. */
+    setFocused(isFocused: boolean): void;
+    /** The currently focused key in the collection. */
+    readonly focusedKey: Accessor<Key | null>;
+    /** The strategy for child focus, when applicable. */
+    readonly childFocusStrategy?: Accessor<FocusStrategy | null>;
+    /** Sets the focused key. */
+    setFocusedKey(key: Key | null, childFocusStrategy?: FocusStrategy): void;
+    /** The currently selected keys. */
+    readonly selectedKeys: Accessor<Selection>;
+    /** Disabled keys for the collection. */
+    readonly disabledKeys: Accessor<Set<Key>>;
+    /** How disabled keys behave. */
+    readonly disabledBehavior: Accessor<DisabledBehavior>;
+    /** Whether selection is empty. */
+    readonly isEmpty: Accessor<boolean>;
+    /** Whether all selectable items are selected. */
+    readonly isSelectAll?: Accessor<boolean>;
+    /** Whether the key is fully disabled for interaction. */
+    isDisabled(key: Key): boolean;
+    /** Whether the key may be selected. Defaults to SelectionManager when present. */
+    canSelectItem?(key: Key): boolean;
+    /** Set the selection behavior for the collection. */
+    setSelectionBehavior(behavior: SelectionBehavior): void;
+    /** Set multiple selected keys. */
+    setSelectedKeys(keys: Iterable<Key>): void;
+    /** Select all selectable keys. */
+    selectAll(): void;
+    /** Clear selection. */
+    clearSelection(): void;
+    /** Toggle select all. */
+    toggleSelectAll(): void;
+    /** Optional stable object used by selectable collections for DOM scoping. */
+    readonly selectionManager?: {
+        canSelectItem?(key: Key): boolean;
+    } & object;
+}
+/**
+ * Provides the behavior and accessibility implementation for an item in a
+ * selectable collection.
+ */
+export declare function createSelectableItem<T>(options: MaybeAccessor<CreateSelectableItemOptions>, manager: SelectableItemState<T>, ref: () => HTMLElement | null): SelectableItemAria;
+//# sourceMappingURL=createSelectableItem.d.ts.map

package/dist/selection/createSelectableItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSelectableItem.d.ts","sourceRoot":"","sources":["../../src/selection/createSelectableItem.ts"],"names":[],"mappings":"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"}

package/dist/selection/createSelectableList.d.ts

@@ -0,0 +1,43 @@
+/**
+ * createSelectableList - keyboard navigation and selection for a list collection.
+ * Based on @react-aria/selection's `useSelectableList`.
+ *
+ * React → Solid adaptations (faithful to upstream behavior):
+ *  - `ref` / `scrollRef` are Solid accessors.
+ *  - The default `ListKeyboardDelegate` is built inside a `createMemo` so it is
+ *    recreated whenever the collection, disabled keys, disabled behavior, or
+ *    collator change (the house convention — the delegate stores those as plain
+ *    values; see {@link ListKeyboardDelegate}). This is the Solid equivalent of
+ *    upstream's `useMemo` keyed on the same inputs.
+ *  - Upstream takes `collection` and `disabledKeys` as separate props; our
+ *    SelectionManager already exposes them as reactive getters
+ *    (`manager.collection`, `manager.disabledKeys`, `manager.disabledBehavior`),
+ *    so the delegate is derived from the manager — a single source of truth.
+ *    A `layoutDelegate` may still be supplied for virtualized collections.
+ */
+import type { KeyboardDelegate } from "../grid/types";
+import { type MaybeAccessor } from "../utils/reactivity";
+import type { LayoutDelegate } from "./DOMLayoutDelegate";
+import { type CreateSelectableCollectionOptions, type SelectableCollectionAria } from "./createSelectableCollection";
+export interface CreateSelectableListOptions<T = unknown> extends Omit<CreateSelectableCollectionOptions<T>, "keyboardDelegate"> {
+    /**
+     * A delegate object that implements behavior for keyboard focus movement.
+     * Defaults to a {@link ListKeyboardDelegate} derived from the selection manager.
+     */
+    keyboardDelegate?: MaybeAccessor<KeyboardDelegate>;
+    /**
+     * A delegate object that provides layout information for items in the
+     * collection. Supply this for virtualized collections; by default layout is
+     * read from the DOM.
+     */
+    layoutDelegate?: LayoutDelegate;
+}
+export interface SelectableListAria {
+    /** Props for the list element. */
+    listProps: SelectableCollectionAria["collectionProps"];
+}
+/**
+ * Handles interactions with a selectable list collection.
+ */
+export declare function createSelectableList<T = unknown>(options: CreateSelectableListOptions<T>): SelectableListAria;
+//# sourceMappingURL=createSelectableList.d.ts.map

package/dist/selection/createSelectableList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSelectableList.d.ts","sourceRoot":"","sources":["../../src/selection/createSelectableList.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAU,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAEL,KAAK,iCAAiC,EACtC,KAAK,wBAAwB,EAC9B,MAAM,8BAA8B,CAAC;AAEtC,MAAM,WAAW,2BAA2B,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,IAAI,CACpE,iCAAiC,CAAC,CAAC,CAAC,EACpC,kBAAkB,CACnB;IACC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IACnD;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,SAAS,EAAE,wBAAwB,CAAC,iBAAiB,CAAC,CAAC;CACxD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,GAAG,OAAO,EAC9C,OAAO,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACtC,kBAAkB,CAmCpB"}

package/dist/selection/createTypeSelect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createTypeSelect.d.ts","sourceRoot":"","sources":["../../src/selection/createTypeSelect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,GAAG,EAAE,UAAU,EAAkB,MAAM,iCAAiC,CAAC;AAOvF,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,wCAAwC;IACxC,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,iCAAiC;IACjC,UAAU,EAAE,QAAQ,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IACjC,6DAA6D;IAC7D,kBAAkB,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;IACvC,kDAAkD;IAClD,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;IAClC,8CAA8C;IAC9C,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC;IACtC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,eAAe,EAAE,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;CAClD;AA4ED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,cAAc,CA4EjF"}
+{"version":3,"file":"createTypeSelect.d.ts","sourceRoot":"","sources":["../../src/selection/createTypeSelect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,GAAG,EAAE,UAAU,EAAkB,MAAM,iCAAiC,CAAC;AAQvF,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,wCAAwC;IACxC,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,iCAAiC;IACjC,UAAU,EAAE,QAAQ,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IACjC,6DAA6D;IAC7D,kBAAkB,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;IACvC,kDAAkD;IAClD,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;IAClC,8CAA8C;IAC9C,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC;IACtC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,eAAe,EAAE,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;CAClD;AAoFD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,cAAc,CA+HjF"}

package/dist/selection/index.d.ts

@@ -3,4 +3,13 @@
  * in collection components.
  */
 export { createTypeSelect, type TypeSelectOptions, type TypeSelectAria } from "./createTypeSelect";
+export { createScrollIntoViewOnFocus, type ScrollIntoViewOnFocusOptions, } from "./createScrollIntoViewOnFocus";
+export { selectItem } from "./selectItem";
+export { createSelectableItem, ITEM_ACTION_EVENT, type CreateSelectableItemOptions, type SelectableItemAria, type LinkBehavior, } from "./createSelectableItem";
+export { isNonContiguousSelectionModifier, getItemElement } from "./utils";
+export { FOCUS_EVENT, CLEAR_FOCUS_EVENT } from "./constants";
+export { ListKeyboardDelegate, type ListKeyboardDelegateOptions, type Orientation, type Direction, } from "./ListKeyboardDelegate";
+export { DOMLayoutDelegate, type LayoutDelegate, type Rect, type Size } from "./DOMLayoutDelegate";
+export { createSelectableCollection, type CreateSelectableCollectionOptions, type SelectableCollectionAria, } from "./createSelectableCollection";
+export { createSelectableList, type CreateSelectableListOptions, type SelectableListAria, } from "./createSelectableList";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/selection/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/selection/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACnG,OAAO,EACL,2BAA2B,EAC3B,KAAK,4BAA4B,GAClC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,2BAA2B,EAChC,KAAK,kBAAkB,EACvB,KAAK,YAAY,GAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gCAAgC,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EACL,oBAAoB,EACpB,KAAK,2BAA2B,EAChC,KAAK,WAAW,EAChB,KAAK,SAAS,GACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,KAAK,IAAI,EAAE,KAAK,IAAI,EAAE,MAAM,qBAAqB,CAAC;AACnG,OAAO,EACL,0BAA0B,EAC1B,KAAK,iCAAiC,EACtC,KAAK,wBAAwB,GAC9B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,oBAAoB,EACpB,KAAK,2BAA2B,EAChC,KAAK,kBAAkB,GACxB,MAAM,wBAAwB,CAAC"}

package/dist/selection/index.js

@@ -0,0 +1,4 @@
+import { t as createTypeSelect } from "../_chunk/createTypeSelect.js";
+import { a as isNonContiguousSelectionModifier, i as getItemElement, n as createSelectableItem, r as selectItem, t as ITEM_ACTION_EVENT } from "../_chunk/createSelectableItem.js";
+import { a as CLEAR_FOCUS_EVENT, i as DOMLayoutDelegate, n as createSelectableCollection, o as FOCUS_EVENT, r as ListKeyboardDelegate, s as createScrollIntoViewOnFocus, t as createSelectableList } from "../_chunk/selection.js";
+export { CLEAR_FOCUS_EVENT, DOMLayoutDelegate, FOCUS_EVENT, ITEM_ACTION_EVENT, ListKeyboardDelegate, createScrollIntoViewOnFocus, createSelectableCollection, createSelectableItem, createSelectableList, createTypeSelect, getItemElement, isNonContiguousSelectionModifier, selectItem };

package/dist/selection/index.jsx

@@ -0,0 +1,4 @@
+import { t as createTypeSelect } from "../_chunk/createTypeSelect.jsx";
+import { a as isNonContiguousSelectionModifier, i as getItemElement, n as createSelectableItem, r as selectItem, t as ITEM_ACTION_EVENT } from "../_chunk/createSelectableItem.jsx";
+import { a as CLEAR_FOCUS_EVENT, i as DOMLayoutDelegate, n as createSelectableCollection, o as FOCUS_EVENT, r as ListKeyboardDelegate, s as createScrollIntoViewOnFocus, t as createSelectableList } from "../_chunk/selection.jsx";
+export { CLEAR_FOCUS_EVENT, DOMLayoutDelegate, FOCUS_EVENT, ITEM_ACTION_EVENT, ListKeyboardDelegate, createScrollIntoViewOnFocus, createSelectableCollection, createSelectableItem, createSelectableList, createTypeSelect, getItemElement, isNonContiguousSelectionModifier, selectItem };

package/dist/selection/selectItem.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The aria-layer selection decision, mirroring `@react-aria/selection`'s
+ * `useSelectableItem` `onSelect`. This is where the platform-aware modifier
+ * resolution lives — react-stately's `SelectionManager.select` only knows
+ * `pointerType` + `selectionBehavior`; the ctrl/meta/shift decision belongs one
+ * layer up, here, where `isMac` is reachable.
+ *
+ * The link branch (`linkBehavior` 'selection'/'override'/'none') is deferred to
+ * `createSelectableItem` (Phase 1 of the press-path epic); callers here pass
+ * non-link items.
+ */
+import type { Accessor } from "solid-js";
+import type { Collection, Key, SelectionBehavior, SelectionMode, SelectionPressEvent } from "@proyecto-viviana/solid-stately";
+export interface SelectItemState {
+    readonly selectionMode: Accessor<SelectionMode>;
+    readonly selectionBehavior: Accessor<SelectionBehavior>;
+    readonly disallowEmptySelection: Accessor<boolean>;
+    isSelected(key: Key): boolean;
+    toggleSelection(key: Key): void;
+    replaceSelection(key: Key): void;
+    extendSelection(toKey: Key, collection: Collection): void;
+}
+/**
+ * Resolve a press/keyboard interaction into a selection mutation on `manager`,
+ * faithful to `useSelectableItem.onSelect`. `collection` is required for the
+ * shift-extend (contiguous range) path.
+ */
+export declare function selectItem(manager: SelectItemState, key: Key, e: SelectionPressEvent, collection: Collection): void;
+//# sourceMappingURL=selectItem.d.ts.map

package/dist/selection/selectItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectItem.d.ts","sourceRoot":"","sources":["../../src/selection/selectItem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EACV,UAAU,EACV,GAAG,EACH,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAKzC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IAChD,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACxD,QAAQ,CAAC,sBAAsB,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACnD,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC;IAC9B,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;IAChC,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;IACjC,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;CAC3D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,eAAe,EACxB,GAAG,EAAE,GAAG,EACR,CAAC,EAAE,mBAAmB,EACtB,UAAU,EAAE,UAAU,GACrB,IAAI,CAmCN"}

package/dist/selection/utils.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Selection helpers shared across collection item hooks.
+ * Based on @react-aria/selection's utilities.
+ */
+import type { Accessor } from "solid-js";
+import type { Key } from "@proyecto-viviana/solid-stately";
+/**
+ * Resolves the DOM element rendered for a collection item by its key, scoped to
+ * the owning collection when a `data-collection` id is present. Mirrors
+ * `@react-aria/selection`'s `getItemElement`, adapted to take a Solid ref
+ * accessor instead of a React ref object.
+ */
+export declare function getItemElement(ref: Accessor<HTMLElement | null>, key: Key): HTMLElement | null;
+/**
+ * Registers (on first call) and returns the collection id for a SelectionManager.
+ * The collection container calls this; its items read the same id via
+ * {@link getCollectionId}. Must be called within a reactive owner (uses createId).
+ */
+export declare function registerCollectionId(manager: object): string;
+/**
+ * Returns the collection id registered for a SelectionManager, or `undefined`
+ * when its container has not registered one (e.g. an item not yet wired into a
+ * `createSelectableCollection`). A Solid `undefined` attribute is omitted, so an
+ * unregistered item simply renders no `data-collection`.
+ */
+export declare function getCollectionId(manager: object): string | undefined;
+/** The modifier-key fields consulted by {@link isNonContiguousSelectionModifier}. */
+interface ModifierKeyEvent {
+    altKey?: boolean;
+    ctrlKey?: boolean;
+}
+/**
+ * Returns whether the modifier for non-contiguous (toggle) keyboard selection
+ * is pressed. Mirrors `@react-aria/selection`'s `isNonContiguousSelectionModifier`:
+ * Ctrl + Arrow Up/Down has a system-wide meaning on macOS, so Apple devices use
+ * Alt instead; Windows and Ubuntu use Ctrl.
+ */
+export declare function isNonContiguousSelectionModifier(e: ModifierKeyEvent): boolean;
+export {};
+//# sourceMappingURL=utils.d.ts.map

package/dist/selection/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/selection/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iCAAiC,CAAC;AAI3D;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,GAAG,WAAW,GAAG,IAAI,CAW9F;AAgBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAO5D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnE;AAED,qFAAqF;AACrF,UAAU,gBAAgB;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAE7E"}

package/dist/separator/index.js

@@ -0,0 +1,2 @@
+import { t as createSeparator } from "../_chunk/separator.js";
+export { createSeparator };

package/dist/separator/index.jsx

@@ -0,0 +1,2 @@
+import { t as createSeparator } from "../_chunk/separator.jsx";
+export { createSeparator };

package/dist/slider/createSlider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createSlider.d.ts","sourceRoot":"","sources":["../../src/slider/createSlider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,GAAG,EAAsB,MAAM,UAAU,CAAC;AAOxD,OAAO,EAAU,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEtF,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gCAAgC;IAChC,KAAK,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IACpB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qCAAqC;IACrC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,mCAAmC;IACnC,UAAU,EAAE,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;IAC5C,wCAAwC;IACxC,UAAU,EAAE,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;IAC5C,mCAAmC;IACnC,UAAU,EAAE,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;IAC5C,mCAAmC;IACnC,UAAU,EAAE,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;IAC5C,0CAA0C;IAC1C,UAAU,EAAE,GAAG,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IACtD,4DAA4D;IAC5D,WAAW,EAAE,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,EACrC,KAAK,EAAE,WAAW,EAClB,QAAQ,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,EACnC,QAAQ,CAAC,EAAE,MAAM,gBAAgB,GAAG,IAAI,GACvC,UAAU,CAgRZ"}
+{"version":3,"file":"createSlider.d.ts","sourceRoot":"","sources":["../../src/slider/createSlider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,GAAG,EAAsB,MAAM,UAAU,CAAC;AAQxD,OAAO,EAAU,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEtF,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gCAAgC;IAChC,KAAK,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;IACpB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qCAAqC;IACrC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,mCAAmC;IACnC,UAAU,EAAE,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;IAC5C,wCAAwC;IACxC,UAAU,EAAE,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;IAC5C,mCAAmC;IACnC,UAAU,EAAE,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;IAC5C,mCAAmC;IACnC,UAAU,EAAE,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;IAC5C,0CAA0C;IAC1C,UAAU,EAAE,GAAG,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IACtD,4DAA4D;IAC5D,WAAW,EAAE,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,EACrC,KAAK,EAAE,WAAW,EAClB,QAAQ,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,EACnC,QAAQ,CAAC,EAAE,MAAM,gBAAgB,GAAG,IAAI,GACvC,UAAU,CA8TZ"}

package/dist/slider/index.js

@@ -0,0 +1,2 @@
+import { t as createSlider } from "../_chunk/slider.js";
+export { createSlider };

package/dist/slider/index.jsx

@@ -0,0 +1,2 @@
+import { t as createSlider } from "../_chunk/slider.jsx";
+export { createSlider };