@proyecto-viviana/solid-stately 0.2.7 → 0.4.0

package/dist/calendar/createDatePickerState.d.ts

@@ -0,0 +1,60 @@
+/**
+ * DatePickerState for Solid-Stately
+ *
+ * Provides unified state management for DatePicker components.
+ * Based on @react-stately/datepicker useDatePickerState
+ */
+import { type Accessor } from "solid-js";
+import { type DateValue, DateFormatter } from "@internationalized/date";
+import { type MaybeAccessor } from "../utils";
+import type { ValidationState } from "./createCalendarState";
+import type { TimeValue } from "./createTimeFieldState";
+export type Granularity = "day" | "hour" | "minute" | "second";
+export type DatePickerStateProps<T extends DateValue = DateValue> = DatePickerStateOptions<T>;
+export interface DatePickerStateOptions<T extends DateValue = DateValue> {
+    value?: MaybeAccessor<T | null>;
+    defaultValue?: T | null;
+    onChange?: (value: T | null) => void;
+    minValue?: MaybeAccessor<DateValue | undefined>;
+    maxValue?: MaybeAccessor<DateValue | undefined>;
+    isDisabled?: MaybeAccessor<boolean>;
+    isReadOnly?: MaybeAccessor<boolean>;
+    isRequired?: MaybeAccessor<boolean>;
+    granularity?: Granularity;
+    hourCycle?: 12 | 24;
+    hideTimeZone?: boolean;
+    placeholderValue?: DateValue;
+    shouldCloseOnSelect?: boolean | (() => boolean);
+    defaultOpen?: boolean;
+    isOpen?: MaybeAccessor<boolean | undefined>;
+    onOpenChange?: (isOpen: boolean) => void;
+    isDateUnavailable?: (date: DateValue) => boolean;
+    validationState?: MaybeAccessor<ValidationState | undefined>;
+}
+export interface DatePickerState<T extends DateValue = DateValue> {
+    value: Accessor<T | null>;
+    defaultValue: T | null;
+    setValue: (value: T | null) => void;
+    dateValue: Accessor<DateValue | null>;
+    setDateValue: (value: DateValue) => void;
+    timeValue: Accessor<TimeValue | null>;
+    setTimeValue: (value: TimeValue) => void;
+    granularity: Granularity;
+    hasTime: boolean;
+    isOpen: Accessor<boolean>;
+    open: () => void;
+    close: () => void;
+    setOpen: (isOpen: boolean) => void;
+    isInvalid: Accessor<boolean>;
+    validationState: Accessor<ValidationState | undefined>;
+    builtinValidation: Accessor<{
+        isInvalid: boolean;
+    }>;
+    showEra: Accessor<boolean>;
+    formatValue: (locale: string, fieldOptions?: Intl.DateTimeFormatOptions) => string;
+    getDateFormatter: (locale: string, formatOptions?: Intl.DateTimeFormatOptions) => DateFormatter;
+}
+/**
+ * Provides unified state management for a DatePicker component.
+ */
+export declare function createDatePickerState<T extends DateValue = DateValue>(props?: DatePickerStateOptions<T>): DatePickerState<T>;

package/dist/calendar/createRangeCalendarState.d.ts

@@ -4,10 +4,12 @@
  * Provides state management for range calendar components.
  * Based on @react-stately/calendar useRangeCalendarState
  */
-import { type Accessor } from 'solid-js';
-import { type CalendarDate, type DateValue } from '@internationalized/date';
-import { type MaybeAccessor } from '../utils';
-import type { ValidationState } from './createCalendarState';
+import { type Accessor } from "solid-js";
+import { type Calendar as InternationalizedCalendar, type CalendarDate, type CalendarIdentifier, type DateValue } from "@internationalized/date";
+import { type MaybeAccessor } from "../utils";
+import type { CalendarDayOfWeek, ValidationState } from "./createCalendarState";
+type RangeCalendarSelectionAlignment = "start" | "center" | "end";
+type RangeCalendarPageBehavior = "single" | "visible";
 export interface DateRange {
     start: CalendarDate;
     end: CalendarDate;
@@ -22,7 +24,7 @@ export interface RangeCalendarStateProps<T extends DateValue = DateValue> {
     /** The default value (uncontrolled). */
     defaultValue?: RangeValue<T> | null;
     /** Handler called when the value changes. */
-    onChange?: (value: RangeValue<T>) => void;
+    onChange?: (value: RangeValue<T> | null) => void;
     /** The minimum allowed date. */
     minValue?: MaybeAccessor<DateValue | undefined>;
     /** The maximum allowed date. */
@@ -32,17 +34,27 @@ export interface RangeCalendarStateProps<T extends DateValue = DateValue> {
     /** Whether the calendar is read-only. */
     isReadOnly?: MaybeAccessor<boolean>;
     /** The date that is focused when the calendar first mounts. */
-    focusedValue?: MaybeAccessor<DateValue | undefined>;
+    focusedValue?: MaybeAccessor<DateValue | null | undefined>;
     /** The default focused date (uncontrolled). */
     defaultFocusedValue?: DateValue;
     /** Handler called when the focused date changes. */
     onFocusChange?: (date: CalendarDate) => void;
     /** The locale to use for formatting. */
-    locale?: string;
-    /** Callback to determine if a date is unavailable. */
-    isDateUnavailable?: (date: DateValue) => boolean;
+    locale?: MaybeAccessor<string | undefined>;
+    /** Creates a calendar object for a locale calendar identifier. */
+    createCalendar?: (identifier: CalendarIdentifier) => InternationalizedCalendar;
+    /**
+     * Callback that determines if a date is unavailable. The second argument is the
+     * current selection anchor (the first selected date), so availability can be
+     * derived from it. Mirrors @react-stately/calendar 1.18.
+     */
+    isDateUnavailable?: (date: DateValue, anchorDate: CalendarDate | null) => boolean;
     /** The number of months to display at once. */
-    visibleMonths?: number;
+    visibleMonths?: MaybeAccessor<number | undefined>;
+    /** Controls how the initial visible months are aligned around the current value. */
+    selectionAlignment?: MaybeAccessor<RangeCalendarSelectionAlignment | undefined>;
+    /** Controls whether pagination moves by one month or the visible month count. */
+    pageBehavior?: MaybeAccessor<RangeCalendarPageBehavior | undefined>;
     /** Controls which days are disabled. */
     isDateDisabled?: (date: DateValue) => boolean;
     /** Validation state. */
@@ -61,6 +73,10 @@ export interface RangeCalendarState<T extends DateValue = DateValue> {
     focusedDate: Accessor<CalendarDate>;
     /** Sets the focused date. */
     setFocusedDate: (date: CalendarDate) => void;
+    /** The minimum allowed date that a user may select. */
+    minValue: Accessor<DateValue | null>;
+    /** The maximum allowed date that a user may select. */
+    maxValue: Accessor<DateValue | null>;
     /** The anchor date when selecting a range (first click). */
     anchorDate: Accessor<CalendarDate | null>;
     /** Sets the anchor date. */
@@ -78,8 +94,14 @@ export interface RangeCalendarState<T extends DateValue = DateValue> {
     }>;
     /** The timezone used for date calculations. */
     timeZone: string;
+    /** The locale used for formatting and locale-specific week starts. */
+    locale: Accessor<string>;
+    /** The explicitly requested first weekday, or undefined for the locale default. */
+    firstDayOfWeek: Accessor<CalendarDayOfWeek | undefined>;
     /** The validation state. */
     validationState: Accessor<ValidationState | undefined>;
+    /** Whether the current value is invalid according to validation state. */
+    isValueInvalid: Accessor<boolean>;
     /** Whether a date is within the selected range. */
     isSelected: (date: DateValue) => boolean;
     /** Whether a date is the start of the selection. */
@@ -104,6 +126,10 @@ export interface RangeCalendarState<T extends DateValue = DateValue> {
     focusPreviousSection: () => void;
     /** Moves focus to the next section (year). */
     focusNextSection: () => void;
+    /** Whether the previous visible range would be outside the allowed date range. */
+    isPreviousVisibleRangeInvalid: () => boolean;
+    /** Whether the next visible range would be outside the allowed date range. */
+    isNextVisibleRangeInvalid: () => boolean;
     /** Moves focus to the previous day. */
     focusPreviousDay: () => void;
     /** Moves focus to the next day. */
@@ -143,3 +169,4 @@ export interface RangeCalendarState<T extends DateValue = DateValue> {
  * Provides state management for a range calendar component.
  */
 export declare function createRangeCalendarState<T extends DateValue = CalendarDate>(props?: RangeCalendarStateProps<T>): RangeCalendarState<T>;
+export {};

package/dist/calendar/createTimeFieldState.d.ts

@@ -4,12 +4,13 @@
  * Provides state management for time field components with segment-based editing.
  * Based on @react-stately/datepicker useTimeFieldState
  */
-import { type Accessor } from 'solid-js';
-import { type Time, type CalendarDateTime, type ZonedDateTime } from '@internationalized/date';
-import { type MaybeAccessor } from '../utils';
-import type { ValidationState } from './createCalendarState';
+import { type Accessor } from "solid-js";
+import { type Time, type CalendarDateTime, type ZonedDateTime, type DateValue } from "@internationalized/date";
+import { type MaybeAccessor } from "../utils";
+import type { ValidationState } from "./createCalendarState";
+import { type ValidationBehavior, type ValidationFunction, type ValidationResult } from "../form";
 export type TimeValue = Time | CalendarDateTime | ZonedDateTime;
-export type TimeSegmentType = 'hour' | 'minute' | 'second' | 'dayPeriod' | 'literal';
+export type TimeSegmentType = "hour" | "minute" | "second" | "dayPeriod" | "literal";
 export interface TimeSegment {
     /** The type of segment. */
     type: TimeSegmentType;
@@ -45,20 +46,36 @@ export interface TimeFieldStateProps<T extends TimeValue = Time> {
     isReadOnly?: MaybeAccessor<boolean>;
     /** Whether the field is required. */
     isRequired?: MaybeAccessor<boolean>;
+    /** Whether the value is invalid (controlled). */
+    isInvalid?: boolean;
     /** The locale to use for formatting. */
     locale?: string;
     /** The granularity (hour, minute, second). */
-    granularity?: 'hour' | 'minute' | 'second';
+    granularity?: "hour" | "minute" | "second";
     /** Whether to show 12 or 24 hour format. */
     hourCycle?: 12 | 24;
+    /** Whether to force leading zeroes in the hour segment. */
+    shouldForceLeadingZeros?: boolean;
     /** Validation state. */
     validationState?: MaybeAccessor<ValidationState | undefined>;
+    /** Validation behavior mode. */
+    validationBehavior?: ValidationBehavior;
+    /** Custom validation function. */
+    validate?: ValidationFunction<T>;
+    /** Description text. */
+    description?: string;
+    /** Error message. */
+    errorMessage?: string;
     /** The placeholder value. */
     placeholderValue?: T;
+    /** Whether dates outside the min/max range are unavailable. Added for API consistency. */
+    isDateUnavailable?: (date: DateValue) => boolean;
 }
 export interface TimeFieldState<T extends TimeValue = Time> {
     /** The current value. */
     value: Accessor<T | null>;
+    /** The default value. */
+    defaultValue: T | null;
     /** Sets the value. */
     setValue: (value: T | null) => void;
     /** The segments that make up the time. */
@@ -80,9 +97,19 @@ export interface TimeFieldState<T extends TimeValue = Time> {
     /** The validation state. */
     validationState: Accessor<ValidationState | undefined>;
     /** The granularity. */
-    granularity: 'hour' | 'minute' | 'second';
+    granularity: "hour" | "minute" | "second";
     /** Whether the value is invalid. */
     isInvalid: Accessor<boolean>;
+    /** Realtime validation results, including native and custom constraints. */
+    realtimeValidation: Accessor<ValidationResult>;
+    /** Currently displayed validation results. */
+    displayValidation: Accessor<ValidationResult>;
+    /** Updates the current validation result. */
+    updateValidation: (result: ValidationResult) => void;
+    /** Resets displayed validation to valid. */
+    resetValidation: () => void;
+    /** Commits realtime validation to displayed validation. */
+    commitValidation: () => void;
     /** The locale. */
     locale: string;
     /** The hour cycle. */

package/dist/calendar/index.d.ts

@@ -1,6 +1,7 @@
-export { createCalendarState, type CalendarStateProps, type CalendarState, type ValidationState, } from './createCalendarState';
-export { createRangeCalendarState, type RangeCalendarStateProps, type RangeCalendarState, type DateRange, type RangeValue, } from './createRangeCalendarState';
-export { createDateFieldState, type DateFieldStateProps, type DateFieldState, type DateSegment, type DateSegmentType, } from './createDateFieldState';
-export { createTimeFieldState, type TimeFieldStateProps, type TimeFieldState, type TimeSegment, type TimeSegmentType, type TimeValue, } from './createTimeFieldState';
-export type { CalendarDate, CalendarDateTime, ZonedDateTime, DateValue, Time, } from '@internationalized/date';
-export { today, now, getLocalTimeZone, parseDate, parseDateTime, parseTime, parseAbsolute, parseAbsoluteToLocal, parseZonedDateTime, toCalendarDate, toCalendarDateTime, toZoned, toTime, CalendarDate as CalendarDateClass, CalendarDateTime as CalendarDateTimeClass, ZonedDateTime as ZonedDateTimeClass, Time as TimeClass, DateFormatter, isSameDay, isSameMonth, isSameYear, isToday, isWeekend, startOfMonth, endOfMonth, startOfWeek, endOfWeek, startOfYear, endOfYear, getWeeksInMonth, getDayOfWeek, minDate, maxDate, } from '@internationalized/date';
+export { createCalendarState, type CalendarStateProps, type CalendarState, type CalendarSelectionMode, type CalendarValueType, type ValidationState, type CalendarPageBehavior, type CalendarSelectionAlignment, type CalendarDayOfWeek, } from "./createCalendarState";
+export { createRangeCalendarState, type RangeCalendarStateProps, type RangeCalendarState, type DateRange, type RangeValue, } from "./createRangeCalendarState";
+export { createDateFieldState, type DateFieldStateProps, type DateFieldState, type DateSegment, type DateSegmentType, } from "./createDateFieldState";
+export { createTimeFieldState, type TimeFieldStateProps, type TimeFieldState, type TimeSegment, type TimeSegmentType, type TimeValue, } from "./createTimeFieldState";
+export { createDatePickerState, type DatePickerStateOptions, type DatePickerState, } from "./createDatePickerState";
+export type { CalendarDate, CalendarDateTime, ZonedDateTime, DateValue, Time, Calendar, CalendarIdentifier, AnyCalendarDate, } from "@internationalized/date";
+export { createCalendar, GregorianCalendar, today, now, getLocalTimeZone, parseDate, parseDateTime, parseTime, parseAbsolute, parseAbsoluteToLocal, parseZonedDateTime, toCalendarDate, toCalendarDateTime, toZoned, toTime, CalendarDate as CalendarDateClass, CalendarDateTime as CalendarDateTimeClass, ZonedDateTime as ZonedDateTimeClass, Time as TimeClass, DateFormatter, isSameDay, isSameMonth, isSameYear, isToday, isWeekend, startOfMonth, endOfMonth, startOfWeek, endOfWeek, startOfYear, endOfYear, getWeeksInMonth, getDayOfWeek, toCalendar, minDate, maxDate, } from "@internationalized/date";

package/dist/checkbox/createCheckboxGroupState.d.ts

@@ -6,9 +6,9 @@
  *
  * This is a 1:1 port of @react-stately/checkbox's useCheckboxGroupState.
  */
-import { Accessor } from 'solid-js';
-import { type MaybeAccessor } from '../utils';
-import { type FormValidationState, type ValidationFunction, type ValidationResult } from '../form';
+import { Accessor } from "solid-js";
+import { type MaybeAccessor } from "../utils";
+import { type FormValidationState, type ValidationFunction, type ValidationResult } from "../form";
 export interface CheckboxGroupProps {
     /** The current selected values (controlled). */
     value?: string[];
@@ -37,13 +37,13 @@ export interface CheckboxGroupProps {
     /** Handler that is called when the checkbox group's focus status changes. */
     onFocusChange?: (isFocused: boolean) => void;
     /** Backward-compatible controlled validation state. */
-    validationState?: 'valid' | 'invalid';
+    validationState?: "valid" | "invalid";
     /** Custom validation function. */
     validate?: ValidationFunction<readonly string[]>;
     /** Validation behavior for the checkbox group. */
-    validationBehavior?: 'aria' | 'native';
+    validationBehavior?: "aria" | "native";
 }
-export interface CheckboxGroupState extends Pick<FormValidationState, 'realtimeValidation' | 'displayValidation' | 'updateValidation' | 'resetValidation' | 'commitValidation'> {
+export interface CheckboxGroupState extends Pick<FormValidationState, "realtimeValidation" | "displayValidation" | "updateValidation" | "resetValidation" | "commitValidation"> {
     /** Current selected values. */
     readonly value: Accessor<readonly string[]>;
     /** Default selected values. */

package/dist/checkbox/index.d.ts

@@ -1 +1 @@
-export { createCheckboxGroupState, type CheckboxGroupProps, type CheckboxGroupState, } from './createCheckboxGroupState';
+export { createCheckboxGroupState, type CheckboxGroupProps, type CheckboxGroupState, } from "./createCheckboxGroupState";

package/dist/collections/ListCollection.d.ts

@@ -2,7 +2,7 @@
  * A simple list collection implementation.
  * Provides a Collection interface over an array of nodes.
  */
-import type { Collection, CollectionNode, Key } from './types';
+import type { Collection, CollectionNode, Key } from "./types";
 /**
  * A basic implementation of Collection for list-based components.
  */

package/dist/collections/createListState.d.ts

@@ -3,10 +3,11 @@
  * Combines collection and selection state.
  * Based on @react-stately/list.
  */
-import { type Accessor } from 'solid-js';
-import { type MaybeAccessor } from '../utils';
-import { type SelectionState } from './createSelectionState';
-import type { Collection, CollectionNode, DisabledBehavior, FocusStrategy, Key, SelectionBehavior, SelectionMode } from './types';
+import { type Accessor } from "solid-js";
+import { type MaybeAccessor } from "../utils";
+import type { SelectionState } from "./createSelectionState";
+import { SelectionManager } from "../selection/SelectionManager";
+import type { Collection, CollectionNode, DisabledBehavior, FocusStrategy, Key, SelectionBehavior, SelectionMode } from "./types";
 export interface ListStateProps<T = unknown> {
     /** The items in the list (for dynamic rendering). */
     items?: T[];
@@ -27,17 +28,19 @@ export interface ListStateProps<T = unknown> {
     /** Whether empty selection is disallowed. */
     disallowEmptySelection?: boolean;
     /** Currently selected keys (controlled). */
-    selectedKeys?: 'all' | Iterable<Key>;
+    selectedKeys?: "all" | Iterable<Key>;
     /** Default selected keys (uncontrolled). */
-    defaultSelectedKeys?: 'all' | Iterable<Key>;
+    defaultSelectedKeys?: "all" | Iterable<Key>;
     /** Handler for selection changes. */
-    onSelectionChange?: (keys: 'all' | Set<Key>) => void;
+    onSelectionChange?: (keys: "all" | Set<Key>) => void;
     /** Whether to allow duplicate selection events. */
     allowDuplicateSelectionEvents?: boolean;
 }
 export interface ListState<T = unknown> extends SelectionState {
     /** The collection of items. */
     readonly collection: Accessor<Collection<T>>;
+    /** The collection-aware selection manager (single source of truth for selection). */
+    readonly selectionManager: SelectionManager<T>;
     /** Whether the collection is focused. */
     readonly isFocused: Accessor<boolean>;
     /** Set the focused state. */
@@ -56,7 +59,7 @@ export declare function createListState<T = unknown>(props: MaybeAccessor<ListSt
 /**
  * Props for single selection list state.
  */
-export interface SingleSelectListStateProps<T = unknown> extends Omit<ListStateProps<T>, 'selectionMode' | 'selectedKeys' | 'defaultSelectedKeys' | 'onSelectionChange'> {
+export interface SingleSelectListStateProps<T = unknown> extends Omit<ListStateProps<T>, "selectionMode" | "selectedKeys" | "defaultSelectedKeys" | "onSelectionChange"> {
     /** The currently selected key (controlled). */
     selectedKey?: Key | null;
     /** The default selected key (uncontrolled). */

package/dist/collections/createMenuState.d.ts

@@ -2,10 +2,10 @@
  * State management for menu components.
  * Based on @react-stately/menu.
  */
-import { type MaybeAccessor } from '../utils';
-import { type ListState, type ListStateProps } from './createListState';
-import type { Key } from './types';
-export interface MenuStateProps<T = unknown> extends Omit<ListStateProps<T>, 'selectionMode' | 'disallowEmptySelection'> {
+import { type MaybeAccessor } from "../utils";
+import { type ListState, type ListStateProps } from "./createListState";
+import type { Key } from "./types";
+export interface MenuStateProps<T = unknown> extends ListStateProps<T> {
     /** Handler called when an item is activated (pressed). */
     onAction?: (key: Key) => void;
     /** Handler called when the menu should close. */
@@ -38,12 +38,12 @@ export interface MenuTriggerState {
     /** Toggle the menu. */
     toggle(): void;
     /** Focus strategy for when the menu opens. */
-    readonly focusStrategy: () => 'first' | 'last' | null;
+    readonly focusStrategy: () => "first" | "last" | null;
     /** Set the focus strategy. */
-    setFocusStrategy(strategy: 'first' | 'last' | null): void;
+    setFocusStrategy(strategy: "first" | "last" | null): void;
 }
 /**
  * Creates state for a menu trigger (button that opens a menu).
  * This is essentially the same as overlay trigger state but with focus strategy.
  */
-export { createOverlayTriggerState as createMenuTriggerState } from '../overlays';
+export { createOverlayTriggerState as createMenuTriggerState } from "../overlays";

package/dist/collections/createSelectionState.d.ts

@@ -2,9 +2,9 @@
  * Selection state management for collections.
  * Based on @react-stately/selection.
  */
-import { type Accessor } from 'solid-js';
-import { type MaybeAccessor } from '../utils';
-import type { Collection, DisabledBehavior, Key, Selection, SelectionBehavior, SelectionMode } from './types';
+import { type Accessor } from "solid-js";
+import { type MaybeAccessor } from "../utils";
+import type { Collection, DisabledBehavior, Key, Selection, SelectionBehavior, SelectionMode } from "./types";
 export interface SelectionStateProps {
     /** The selection mode. */
     selectionMode?: SelectionMode;
@@ -13,9 +13,9 @@ export interface SelectionStateProps {
     /** Whether empty selection is disallowed. */
     disallowEmptySelection?: boolean;
     /** Currently selected keys (controlled). */
-    selectedKeys?: 'all' | Iterable<Key>;
+    selectedKeys?: "all" | Iterable<Key>;
     /** Default selected keys (uncontrolled). */
-    defaultSelectedKeys?: 'all' | Iterable<Key>;
+    defaultSelectedKeys?: "all" | Iterable<Key>;
     /** Handler for selection changes. */
     onSelectionChange?: (keys: Selection) => void;
     /** Keys of disabled items. */
@@ -63,11 +63,23 @@ export interface SelectionState {
     /** Extend selection to a key (for shift-click). */
     extendSelection(toKey: Key, collection: Collection): void;
     /** Select a key based on interaction. */
-    select(key: Key, e?: {
-        shiftKey?: boolean;
-        ctrlKey?: boolean;
-        metaKey?: boolean;
-    }, collection?: Collection): void;
+    select(key: Key, e?: SelectionPressEvent): void;
+}
+/**
+ * The press/pointer interaction consulted by {@link SelectionState.select}.
+ * Mirrors react-stately's `SelectionManager.select(e)`: only `pointerType` is
+ * read here (touch / virtual force toggle, since those devices have no modifier
+ * keys). Modifier keys (ctrl / meta / shift) are resolved one layer up in the
+ * aria-layer `onSelect` (solidaria `selectItem`), matching upstream's split
+ * between react-stately and react-aria. The modifier fields are accepted so a
+ * full press/pointer event is assignable, but they are not read here.
+ */
+export interface SelectionPressEvent {
+    pointerType?: "mouse" | "pen" | "touch" | "keyboard" | "virtual";
+    shiftKey?: boolean;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    altKey?: boolean;
 }
 /**
  * Creates selection state for a collection.

package/dist/collections/getChildNodes.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Helpers for traversing collection nodes and comparing their document order.
+ *
+ * Based on @react-stately/collections.
+ */
+import type { Collection, CollectionNode } from "./types";
+export declare function getChildNodes<T>(node: CollectionNode<T>, collection: Collection<T>): Iterable<CollectionNode<T>>;
+export declare function getFirstItem<T>(iterable: Iterable<T>): T | undefined;
+export declare function getNthItem<T>(iterable: Iterable<T>, index: number): T | undefined;
+export declare function getLastItem<T>(iterable: Iterable<T>): T | undefined;
+export declare function compareNodeOrder<T>(collection: Collection<T>, a: CollectionNode<T>, b: CollectionNode<T>): number;

package/dist/collections/index.d.ts

@@ -1,5 +1,6 @@
-export type { Key, SelectionMode, SelectionBehavior, Selection, FocusStrategy, DisabledBehavior, CollectionNode, Collection, ItemProps, SectionProps, CollectionBase, SingleSelection, MultipleSelection, } from './types';
-export { ListCollection, createListCollection } from './ListCollection';
-export { createSelectionState, type SelectionStateProps, type SelectionState, } from './createSelectionState';
-export { createListState, createSingleSelectListState, type ListStateProps, type ListState, type SingleSelectListStateProps, type SingleSelectListState, } from './createListState';
-export { createMenuState, createMenuTriggerState, type MenuStateProps, type MenuState, type MenuTriggerStateProps, type MenuTriggerState, } from './createMenuState';
+export type { Key, SelectionMode, SelectionBehavior, Selection, FocusStrategy, DisabledBehavior, CollectionNode, Collection, ItemProps, SectionProps, CollectionBase, SingleSelection, MultipleSelection, } from "./types";
+export { ListCollection, createListCollection } from "./ListCollection";
+export { getChildNodes, getFirstItem, getNthItem, getLastItem, compareNodeOrder, } from "./getChildNodes";
+export { createSelectionState, type SelectionStateProps, type SelectionState, type SelectionPressEvent, } from "./createSelectionState";
+export { createListState, createSingleSelectListState, type ListStateProps, type ListState, type SingleSelectListStateProps, type SingleSelectListState, } from "./createListState";
+export { createMenuState, createMenuTriggerState, type MenuStateProps, type MenuState, type MenuTriggerStateProps, type MenuTriggerState, } from "./createMenuState";

package/dist/collections/types.d.ts

@@ -2,25 +2,25 @@
  * Core types for collection state management.
  * Simplified from @react-stately/collections for SolidJS.
  */
-import type { JSX } from 'solid-js';
+import type { JSX } from "solid-js";
 /** A unique identifier for an item in a collection. */
 export type Key = string | number;
 /** The type of selection allowed in a collection. */
-export type SelectionMode = 'none' | 'single' | 'multiple';
+export type SelectionMode = "none" | "single" | "multiple";
 /** How selection behaves when clicking on items. */
-export type SelectionBehavior = 'toggle' | 'replace';
+export type SelectionBehavior = "toggle" | "replace";
 /** Represents the current selection state. */
-export type Selection = 'all' | Set<Key>;
+export type Selection = "all" | Set<Key>;
 /** Strategy for focusing first or last item. */
-export type FocusStrategy = 'first' | 'last';
+export type FocusStrategy = "first" | "last";
 /** Whether disabled keys affect selection, actions, or both. */
-export type DisabledBehavior = 'selection' | 'all';
+export type DisabledBehavior = "selection" | "all";
 /**
  * Represents a node in a collection (item or section).
  */
 export interface CollectionNode<T = unknown> {
     /** The type of node: 'item' or 'section'. */
-    type: 'item' | 'section';
+    type: "item" | "section";
     /** A unique key for the node. */
     key: Key;
     /** The original value/data for this node. */
@@ -42,7 +42,7 @@ export interface CollectionNode<T = unknown> {
     /** Whether this item is disabled. */
     isDisabled?: boolean;
     /** ARIA label for this node. */
-    'aria-label'?: string;
+    "aria-label"?: string;
     /** Additional props for the node. */
     props?: Record<string, unknown>;
 }
@@ -95,7 +95,7 @@ export interface ItemProps<T = unknown> {
     /** The rendered content of the item. */
     children?: JSX.Element;
     /** ARIA label for the item. */
-    'aria-label'?: string;
+    "aria-label"?: string;
     /** The original value for dynamic collections. */
     value?: T;
 }
@@ -108,7 +108,7 @@ export interface SectionProps<T = unknown> {
     /** The section header/title. */
     title?: JSX.Element;
     /** ARIA label for the section. */
-    'aria-label'?: string;
+    "aria-label"?: string;
     /** The items in this section. */
     children?: JSX.Element;
     /** Items for dynamic rendering. */
@@ -147,9 +147,9 @@ export interface MultipleSelection {
     /** Whether empty selection is allowed. */
     disallowEmptySelection?: boolean;
     /** The currently selected keys (controlled). */
-    selectedKeys?: 'all' | Iterable<Key>;
+    selectedKeys?: "all" | Iterable<Key>;
     /** The default selected keys (uncontrolled). */
-    defaultSelectedKeys?: 'all' | Iterable<Key>;
+    defaultSelectedKeys?: "all" | Iterable<Key>;
     /** Handler called when selection changes. */
     onSelectionChange?: (keys: Selection) => void;
     /** Keys of disabled items. */

package/dist/color/Color.d.ts

@@ -4,7 +4,7 @@
  *
  * Provides color manipulation, conversion, and formatting.
  */
-import type { Color } from './types';
+import type { Color } from "./types";
 /**
  * Parse a color string into a Color object.
  */

package/dist/color/createColorAreaState.d.ts

@@ -2,8 +2,8 @@
  * ColorArea state management.
  * Based on @react-stately/color useColorAreaState.
  */
-import { type Accessor } from 'solid-js';
-import type { Color, ColorChannel } from './types';
+import { type Accessor } from "solid-js";
+import type { Color, ColorChannel, ColorSpace } from "./types";
 export interface ColorAreaStateOptions {
     /** The current color value (controlled). */
     value?: Color | string;
@@ -17,6 +17,8 @@ export interface ColorAreaStateOptions {
     xChannel?: ColorChannel;
     /** The color channel for the Y axis. */
     yChannel?: ColorChannel;
+    /** The color space to use for the color area. */
+    colorSpace?: ColorSpace;
     /** Whether the area is disabled. */
     isDisabled?: boolean;
 }