@proyecto-viviana/solid-stately 0.2.4 → 0.2.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Proyecto Viviana contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/autocomplete/createAutocompleteState.d.ts

@@ -4,6 +4,7 @@
  * Based on @react-stately/autocomplete useAutocompleteState.
  */
 import { type Accessor } from 'solid-js';
+import { type MaybeAccessor } from '../utils';
 export interface AutocompleteState {
     /** The current value of the autocomplete input. */
     inputValue: Accessor<string>;
@@ -42,4 +43,4 @@ export interface AutocompleteStateOptions {
  * state.setFocusedNodeId('item-1');
  * ```
  */
-export declare function createAutocompleteState(props?: AutocompleteStateOptions): AutocompleteState;
+export declare function createAutocompleteState(props?: MaybeAccessor<AutocompleteStateOptions>): AutocompleteState;

package/dist/checkbox/createCheckboxGroupState.d.ts

@@ -8,6 +8,7 @@
  */
 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[];
@@ -35,8 +36,14 @@ export interface CheckboxGroupProps {
     onBlur?: (e: FocusEvent) => void;
     /** Handler that is called when the checkbox group's focus status changes. */
     onFocusChange?: (isFocused: boolean) => void;
+    /** Backward-compatible controlled validation state. */
+    validationState?: 'valid' | 'invalid';
+    /** Custom validation function. */
+    validate?: ValidationFunction<readonly string[]>;
+    /** Validation behavior for the checkbox group. */
+    validationBehavior?: 'aria' | 'native';
 }
-export interface CheckboxGroupState {
+export interface CheckboxGroupState extends Pick<FormValidationState, 'realtimeValidation' | 'displayValidation' | 'updateValidation' | 'resetValidation' | 'commitValidation'> {
     /** Current selected values. */
     readonly value: Accessor<readonly string[]>;
     /** Default selected values. */
@@ -62,6 +69,8 @@ export interface CheckboxGroupState {
     removeValue(value: string): void;
     /** Toggles a value in the set of selected values. */
     toggleValue(value: string): void;
+    /** Current display validation result for the group. */
+    readonly displayValidation: Accessor<ValidationResult>;
 }
 /**
  * Provides state management for a checkbox group component.

package/dist/collections/types.d.ts

@@ -71,6 +71,17 @@ export interface Collection<T = unknown> extends Iterable<CollectionNode<T>> {
     /** Get the text value for a key. */
     getTextValue(key: Key): string;
 }
+/**
+ * Structural shape expected when inferring collection item properties
+ * (key, textValue, etc.) from plain objects without explicit getKey/getTextValue/getDisabled.
+ */
+export interface CollectionItemLike {
+    key?: Key;
+    id?: Key;
+    textValue?: string;
+    label?: string;
+    isDisabled?: boolean;
+}
 /**
  * Props for items in a collection.
  */

package/dist/color/getColorChannels.d.ts

@@ -0,0 +1,20 @@
+/**
+ * getColorChannels - Standalone function to get color channels for a color space.
+ *
+ * Returns the three channels for a given color space.
+ */
+import type { ColorChannel, ColorSpace } from './types';
+/**
+ * Returns the color channels for a given color space.
+ *
+ * @param colorSpace - The color space to get channels for.
+ * @returns A tuple of three color channels.
+ *
+ * @example
+ * ```ts
+ * getColorChannels('rgb') // ['red', 'green', 'blue']
+ * getColorChannels('hsl') // ['hue', 'saturation', 'lightness']
+ * getColorChannels('hsb') // ['hue', 'saturation', 'brightness']
+ * ```
+ */
+export declare function getColorChannels(colorSpace: ColorSpace): [ColorChannel, ColorChannel, ColorChannel];

package/dist/data/createAsyncList.d.ts

@@ -0,0 +1,111 @@
+/**
+ * createAsyncList - SolidJS port of React Spectrum's useAsyncList
+ *
+ * Manages state for an immutable async loaded list data structure, and provides
+ * convenience methods to update the data over time. Manages loading and error
+ * states, pagination, and sorting.
+ */
+export type Key = string | number;
+export type Selection = 'all' | Set<Key>;
+export type LoadingState = 'idle' | 'loading' | 'loadingMore' | 'sorting' | 'filtering' | 'error';
+export interface SortDescriptor {
+    /** The key of the column to sort by. */
+    column?: Key;
+    /** The direction to sort by. */
+    direction?: 'ascending' | 'descending';
+}
+export interface AsyncListLoadOptions<T, C> {
+    /** The items currently in the list. */
+    items: T[];
+    /** The keys of the currently selected items in the list. */
+    selectedKeys: Selection;
+    /** The current sort descriptor for the list. */
+    sortDescriptor?: SortDescriptor;
+    /** An abort signal used to notify the load function that the request has been aborted. */
+    signal: AbortSignal;
+    /** The pagination cursor returned from the last page load. */
+    cursor?: C;
+    /** The current filter text used to perform server side filtering. */
+    filterText?: string;
+    /** The current loading state of the list. */
+    loadingState?: LoadingState;
+}
+export interface AsyncListStateUpdate<T, C> {
+    /** The new items to append to the list. */
+    items: Iterable<T>;
+    /** The keys to add to the selection. */
+    selectedKeys?: Iterable<Key>;
+    /** The sort descriptor to set. */
+    sortDescriptor?: SortDescriptor;
+    /** The pagination cursor to be used for the next page load. */
+    cursor?: C;
+    /** The updated filter text for the list. */
+    filterText?: string;
+}
+export type AsyncListLoadFunction<T, C> = (state: AsyncListLoadOptions<T, C>) => AsyncListStateUpdate<T, C> | Promise<AsyncListStateUpdate<T, C>>;
+export interface AsyncListOptions<T, C> {
+    /** The keys for the initially selected items. */
+    initialSelectedKeys?: 'all' | Iterable<Key>;
+    /** The initial sort descriptor. */
+    initialSortDescriptor?: SortDescriptor;
+    /** The initial filter text. */
+    initialFilterText?: string;
+    /** A function that returns a unique key for an item object. */
+    getKey?: (item: T) => Key;
+    /** A function that loads the data for the items in the list. */
+    load: AsyncListLoadFunction<T, C>;
+    /** An optional function that performs sorting. */
+    sort?: AsyncListLoadFunction<T, C>;
+}
+export interface AsyncListData<T> {
+    /** The items in the list. */
+    readonly items: T[];
+    /** The keys of the currently selected items in the list. */
+    readonly selectedKeys: Selection;
+    /** The current sort descriptor for the list. */
+    readonly sortDescriptor: SortDescriptor | undefined;
+    /** Whether data is currently being loaded. */
+    readonly isLoading: boolean;
+    /** If loading data failed, then this contains the error that occurred. */
+    readonly error: Error | undefined;
+    /** The current filter text. */
+    readonly filterText: string;
+    /** The current loading state for the list. */
+    readonly loadingState: LoadingState;
+    /** Reloads the data in the list. */
+    reload(): void;
+    /** Loads the next page of data in the list. */
+    loadMore(): void;
+    /** Triggers sorting for the list. */
+    sort(descriptor: SortDescriptor): void;
+    /** Sets the selected keys. */
+    setSelectedKeys(keys: Selection): void;
+    /** Sets the filter text. */
+    setFilterText(filterText: string): void;
+    /** Gets an item from the list by key. */
+    getItem(key: Key): T | undefined;
+    /** Inserts items into the list at the given index. */
+    insert(index: number, ...values: T[]): void;
+    /** Inserts items before a given key. */
+    insertBefore(key: Key, ...values: T[]): void;
+    /** Inserts items after a given key. */
+    insertAfter(key: Key, ...values: T[]): void;
+    /** Appends items to the list. */
+    append(...values: T[]): void;
+    /** Prepends items to the list. */
+    prepend(...values: T[]): void;
+    /** Removes items from the list by their keys. */
+    remove(...keys: Key[]): void;
+    /** Removes all items from the list that are currently in the set of selected items. */
+    removeSelectedItems(): void;
+    /** Moves an item within the list. */
+    move(key: Key, toIndex: number): void;
+    /** Updates an item in the list. */
+    update(key: Key, newValue: T): void;
+}
+/**
+ * Manages state for an immutable async loaded list data structure, and provides
+ * convenience methods to update the data over time. Manages loading and error
+ * states, pagination, and sorting.
+ */
+export declare function createAsyncList<T, C = string>(options: AsyncListOptions<T, C>): AsyncListData<T>;

package/dist/data/createListData.d.ts

@@ -0,0 +1,65 @@
+/**
+ * createListData - SolidJS port of React Spectrum's useListData
+ *
+ * Manages state for an immutable list data structure, and provides
+ * convenience methods to update the data over time.
+ */
+export type Key = string | number;
+export type Selection = 'all' | Set<Key>;
+export interface ListOptions<T> {
+    /** Initial items in the list. */
+    initialItems?: T[];
+    /** The keys for the initially selected items. */
+    initialSelectedKeys?: 'all' | Iterable<Key>;
+    /** The initial text to filter the list by. */
+    initialFilterText?: string;
+    /** A function that returns a unique key for an item object. */
+    getKey?: (item: T) => Key;
+    /** A function that returns whether an item matches the current filter text. */
+    filter?: (item: T, filterText: string) => boolean;
+}
+export interface ListData<T> {
+    /** The items in the list. */
+    readonly items: T[];
+    /** The keys of the currently selected items in the list. */
+    readonly selectedKeys: Selection;
+    /** The current filter text. */
+    readonly filterText: string;
+    /** Sets the selected keys. */
+    setSelectedKeys(keys: Selection): void;
+    /** Adds the given keys to the current selected keys. */
+    addKeysToSelection(keys: Selection): void;
+    /** Removes the given keys from the current selected keys. */
+    removeKeysFromSelection(keys: Selection): void;
+    /** Sets the filter text. */
+    setFilterText(filterText: string): void;
+    /** Gets an item from the list by key. */
+    getItem(key: Key): T | undefined;
+    /** Inserts items into the list at the given index. */
+    insert(index: number, ...values: T[]): void;
+    /** Inserts items into the list before the item at the given key. */
+    insertBefore(key: Key, ...values: T[]): void;
+    /** Inserts items into the list after the item at the given key. */
+    insertAfter(key: Key, ...values: T[]): void;
+    /** Appends items to the list. */
+    append(...values: T[]): void;
+    /** Prepends items to the list. */
+    prepend(...values: T[]): void;
+    /** Removes items from the list by their keys. */
+    remove(...keys: Key[]): void;
+    /** Removes all items from the list that are currently in the set of selected items. */
+    removeSelectedItems(): void;
+    /** Moves an item within the list. */
+    move(key: Key, toIndex: number): void;
+    /** Moves one or more items before a given key. */
+    moveBefore(key: Key, keys: Iterable<Key>): void;
+    /** Moves one or more items after a given key. */
+    moveAfter(key: Key, keys: Iterable<Key>): void;
+    /** Updates an item in the list. */
+    update(key: Key, newValue: T | ((prev: T) => T)): void;
+}
+/**
+ * Manages state for an immutable list data structure, and provides
+ * convenience methods to update the data over time.
+ */
+export declare function createListData<T>(options: ListOptions<T>): ListData<T>;

package/dist/data/createTreeData.d.ts

@@ -0,0 +1,61 @@
+/**
+ * createTreeData - SolidJS port of React Spectrum's useTreeData
+ *
+ * Manages state for an immutable tree data structure, and provides
+ * convenience methods to update the data over time.
+ */
+export type Key = string | number;
+export type Selection = 'all' | Set<Key>;
+export interface TreeNode<T> {
+    /** A unique key for the tree node. */
+    key: Key;
+    /** The key of the parent node. */
+    parentKey: Key | null;
+    /** The value object for the tree node. */
+    value: T;
+    /** The children of this node. */
+    children: TreeNode<T>[] | null;
+}
+export interface TreeOptions<T> {
+    /** Initial items in the tree. */
+    initialItems?: T[];
+    /** The keys for the initially selected items. */
+    initialSelectedKeys?: 'all' | Iterable<Key>;
+    /** A function that returns a unique key for an item object. */
+    getKey?: (item: T) => Key;
+    /** A function that returns the children of an item object. */
+    getChildren?: (item: T) => T[];
+}
+export interface TreeData<T> {
+    /** The root items in the tree. */
+    readonly items: TreeNode<T>[];
+    /** The keys of the currently selected items in the tree. */
+    readonly selectedKeys: Selection;
+    /** Sets the selected keys. */
+    setSelectedKeys(keys: Selection): void;
+    /** Gets an item from the tree by key. */
+    getItem(key: Key): TreeNode<T> | undefined;
+    /** Inserts items into the tree. */
+    insert(parentKey: Key | null, index: number, ...values: T[]): void;
+    /** Inserts items before a given key. */
+    insertBefore(key: Key, ...values: T[]): void;
+    /** Inserts items after a given key. */
+    insertAfter(key: Key, ...values: T[]): void;
+    /** Appends items to a parent node. */
+    append(parentKey: Key | null, ...values: T[]): void;
+    /** Prepends items to a parent node. */
+    prepend(parentKey: Key | null, ...values: T[]): void;
+    /** Removes items from the tree by their keys. */
+    remove(...keys: Key[]): void;
+    /** Removes all items from the tree that are currently in the set of selected items. */
+    removeSelectedItems(): void;
+    /** Moves an item to a new parent. */
+    move(key: Key, toParentKey: Key | null, index: number): void;
+    /** Updates an item in the tree. */
+    update(key: Key, newValue: T): void;
+}
+/**
+ * Manages state for an immutable tree data structure, and provides
+ * convenience methods to update the data over time.
+ */
+export declare function createTreeData<T>(options: TreeOptions<T>): TreeData<T>;

package/dist/data/index.d.ts

@@ -0,0 +1,3 @@
+export { createListData, type ListOptions, type ListData, type Key as ListDataKey, type Selection as ListDataSelection, } from './createListData';
+export { createTreeData, type TreeOptions, type TreeData, type TreeNode as TreeDataNode, } from './createTreeData';
+export { createAsyncList, type AsyncListOptions, type AsyncListData, type AsyncListLoadFunction, type AsyncListLoadOptions, type AsyncListStateUpdate, type SortDescriptor, type LoadingState, } from './createAsyncList';

package/dist/datepicker/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Datepicker compatibility surface.
+ *
+ * This is a module-compat shim that maps React Stately datepicker hook names
+ * to existing Solid stately primitives.
+ */
+export { createDateFieldState, createTimeFieldState, createRangeCalendarState, type DateFieldStateProps as DateFieldStateOptions, type DateFieldState, type DateSegment, type DateSegmentType as SegmentType, type TimeFieldStateProps as TimeFieldStateOptions, type TimeFieldState, type TimeSegment, type TimeSegmentType, type RangeCalendarStateProps as DateRangePickerStateOptions, type RangeCalendarState as DateRangePickerState, } from '../calendar';
+export { createOverlayTriggerState, type OverlayTriggerProps as DatePickerStateOptions, type OverlayTriggerState as DatePickerState, } from '../overlays';
+export { createDateFieldState as useDateFieldState, createTimeFieldState as useTimeFieldState, createRangeCalendarState as useDateRangePickerState, } from '../calendar';
+export { createOverlayTriggerState as useDatePickerState } from '../overlays';

package/dist/grid/types.d.ts

@@ -6,7 +6,7 @@ import type { Key, FocusStrategy } from '../collections/types';
 /**
  * Represents the type of a grid node.
  */
-export type GridNodeType = 'item' | 'cell' | 'column' | 'rowheader' | 'headerrow' | 'section' | 'placeholder';
+export type GridNodeType = 'item' | 'cell' | 'column' | 'rowheader' | 'headerrow' | 'section' | 'content' | 'placeholder';
 /**
  * Represents a node in a grid collection.
  */
@@ -27,6 +27,10 @@ export interface GridNode<T = unknown> {
     index: number;
     /** The key of the parent node, if any. */
     parentKey?: Key | null;
+    /** Previous sibling key (visible order). */
+    prevKey?: Key | null;
+    /** Next sibling key (visible order). */
+    nextKey?: Key | null;
     /** Whether this node has child nodes. */
     hasChildNodes: boolean;
     /** Child nodes (cells for rows, rows for sections). */

package/dist/index.d.ts

@@ -1,10 +1,13 @@
-export { createToggleState, type ToggleStateOptions, type ToggleState, } from './toggle';
+export { createToggleState, createToggleGroupState, type ToggleStateOptions, type ToggleState, type ToggleGroupProps, type ToggleGroupState, } from './toggle';
 export { createAutocompleteState, type AutocompleteState, type AutocompleteStateOptions, } from './autocomplete';
 export { createTextFieldState, type TextFieldStateOptions, type TextFieldState, } from './textfield';
 export { createCheckboxGroupState, type CheckboxGroupProps, type CheckboxGroupState, } from './checkbox';
 export { createRadioGroupState, radioGroupSyncVersion, type RadioGroupProps, type RadioGroupState, } from './radio';
 export { createOverlayTriggerState, type OverlayTriggerProps, type OverlayTriggerState, } from './overlays';
 export { type Key, type SelectionMode, type SelectionBehavior, type Selection, type FocusStrategy, type DisabledBehavior, type CollectionNode, type Collection, type ItemProps, type SectionProps, type CollectionBase, type SingleSelection, type MultipleSelection, ListCollection, createListCollection, createSelectionState, type SelectionStateProps, type SelectionState, createListState, createSingleSelectListState, type ListStateProps, type ListState, type SingleSelectListStateProps, type SingleSelectListState, createMenuState, createMenuTriggerState, type MenuStateProps, type MenuState, type MenuTriggerStateProps, type MenuTriggerState, } from './collections';
+export { useMultipleSelectionState, type MultipleSelectionStateProps, type MultipleSelectionState, } from './selection';
+export { useMenuTriggerState, } from './menu';
+export { useDateFieldState, useDatePickerState, useDateRangePickerState, useTimeFieldState, type DateFieldStateOptions, type DatePickerStateOptions, type DateRangePickerStateOptions, type TimeFieldStateOptions, type SegmentType, } from './datepicker';
 export { createSelectState, type SelectStateProps, type SelectState, } from './select';
 export { createComboBoxState, defaultContainsFilter, type ComboBoxState, type ComboBoxStateProps, type FilterFn, type MenuTriggerAction, } from './combobox';
 export { createTabListState, type TabListStateProps, type TabListState, type KeyboardActivation, type TabOrientation, } from './tabs';
@@ -22,4 +25,6 @@ export { type Color, type ColorFormat, type ColorSpace, type ColorChannel, type
 export { type DropOperation, type DragItem, type DragDropEvent, type DragStartEvent, type DragMoveEvent, type DragEndEvent, type DropEnterEvent, type DropMoveEvent, type DropActivateEvent, type DropExitEvent, type TextDropItem, type FileDropItem, type DirectoryDropItem, type DropItem, type DropEvent, type DropPosition, type RootDropTarget, type ItemDropTarget, type DropTarget, type DroppableCollectionEnterEvent, type DroppableCollectionMoveEvent, type DroppableCollectionActivateEvent, type DroppableCollectionExitEvent, type DroppableCollectionDropEvent, type DroppableCollectionInsertDropEvent, type DroppableCollectionRootDropEvent, type DroppableCollectionOnItemDropEvent, type DroppableCollectionReorderEvent, type DragTypes, type DropTargetDelegate, type DraggableCollectionStartEvent, type DraggableCollectionMoveEvent, type DraggableCollectionEndEvent, type DragPreviewRenderer, type DroppableCollectionUtilityOptions, type DroppableCollectionBaseProps, type DroppableCollectionProps, type DraggableCollectionProps, createDragState, type DragStateOptions, type DragState, createDropState, type DropStateOptions, type DropState, createDraggableCollectionState, type DraggableCollectionStateOptions, type DraggableCollectionState, createDroppableCollectionState, DIRECTORY_DRAG_TYPE, type DroppableCollectionStateOptions, type DroppableCollectionState, } from './dnd';
 export { createFormValidationState, mergeValidation, FormValidationContext, privateValidationStateProp, VALID_VALIDITY_STATE, DEFAULT_VALIDATION_RESULT, type FormValidationState, type FormValidationProps, type ValidationResult, type ValidationErrors, type ValidationFunction, type ValidationBehavior, type ValidityState, } from './form';
 export { createIsSSR, createId, canUseDOM, isServer } from './ssr';
+export { createListData, type ListOptions, type ListData, createTreeData, type TreeOptions, type TreeData, type TreeDataNode, createAsyncList, type AsyncListOptions, type AsyncListData, type AsyncListLoadFunction, type AsyncListLoadOptions, type AsyncListStateUpdate, type LoadingState, } from './data';
+export { getColorChannels } from './color/getColorChannels';
 export { access, isAccessor, type MaybeAccessor, type MaybeAccessorValue } from './utils';