@proyecto-viviana/solid-stately 0.1.2 → 0.1.4

package/dist/radio/createRadioGroupState.d.ts

@@ -1,76 +0,0 @@
-/**
- * Radio group state for Solid Stately
- *
- * Provides state management for a radio group component.
- * Provides a name for the group, and manages selection and focus state.
- *
- * This is a 1:1 port of @react-stately/radio's useRadioGroupState.
- */
-import { Accessor } from 'solid-js';
-import { type MaybeAccessor } from '../utils';
-export interface RadioGroupProps {
-    /** The current selected value (controlled). */
-    value?: string | null;
-    /** The default selected value (uncontrolled). */
-    defaultValue?: string | null;
-    /** Handler that is called when the value changes. */
-    onChange?: (value: string) => void;
-    /** Whether the radio group is disabled. */
-    isDisabled?: boolean;
-    /** Whether the radio group is read only. */
-    isReadOnly?: boolean;
-    /** Whether the radio group is required. */
-    isRequired?: boolean;
-    /** Whether the radio group is invalid. */
-    isInvalid?: boolean;
-    /** The name of the radio group, used when submitting an HTML form. */
-    name?: string;
-    /** The form to associate the radio group with. */
-    form?: string;
-    /** The label for the radio group. */
-    label?: string;
-    /** Orientation of the radio group. */
-    orientation?: 'horizontal' | 'vertical';
-    /** Handler that is called when the radio group receives focus. */
-    onFocus?: (e: FocusEvent) => void;
-    /** Handler that is called when the radio group loses focus. */
-    onBlur?: (e: FocusEvent) => void;
-    /** Handler that is called when the radio group's focus status changes. */
-    onFocusChange?: (isFocused: boolean) => void;
-}
-export interface RadioGroupState {
-    /** The name for the group, used for native form submission. */
-    readonly name: string;
-    /** Whether the radio group is disabled. */
-    readonly isDisabled: boolean;
-    /** Whether the radio group is read only. */
-    readonly isReadOnly: boolean;
-    /** Whether the radio group is required. */
-    readonly isRequired: boolean;
-    /** Whether the radio group is invalid. */
-    readonly isInvalid: boolean;
-    /** The currently selected value. */
-    readonly selectedValue: Accessor<string | null>;
-    /** The default selected value. */
-    readonly defaultSelectedValue: string | null;
-    /** Sets the selected value. */
-    setSelectedValue(value: string | null): void;
-    /** The value of the last focused radio. */
-    readonly lastFocusedValue: Accessor<string | null>;
-    /** Sets the last focused value. */
-    setLastFocusedValue(value: string | null): void;
-}
-/**
- * Internal WeakMap to store sync version accessors for each radio group state.
- * This is used by createRadio to trigger DOM sync when native radio behavior
- * causes the DOM checked state to desync from our reactive state.
- *
- * This is kept separate from RadioGroupState to maintain API parity with React-Stately.
- * @internal
- */
-export declare const radioGroupSyncVersion: WeakMap<RadioGroupState, Accessor<number>>;
-/**
- * Provides state management for a radio group component.
- * Provides a name for the group, and manages selection and focus state.
- */
-export declare function createRadioGroupState(props?: MaybeAccessor<RadioGroupProps>): RadioGroupState;

package/dist/radio/index.d.ts

@@ -1 +0,0 @@
-export { createRadioGroupState, radioGroupSyncVersion, type RadioGroupProps, type RadioGroupState, } from './createRadioGroupState';

package/dist/searchfield/createSearchFieldState.d.ts

@@ -1,24 +0,0 @@
-/**
- * Creates state for a search field component.
- * Based on @react-stately/searchfield useSearchFieldState.
- */
-import { type Accessor } from 'solid-js';
-import { type MaybeAccessor } from '../utils';
-export interface SearchFieldStateProps {
-    /** The current value (controlled). */
-    value?: string;
-    /** The default value (uncontrolled). */
-    defaultValue?: string;
-    /** Handler that is called when the value changes. */
-    onChange?: (value: string) => void;
-}
-export interface SearchFieldState {
-    /** The current value of the search field. */
-    value: Accessor<string>;
-    /** Sets the value of the search field. */
-    setValue: (value: string) => void;
-}
-/**
- * Provides state management for a search field.
- */
-export declare function createSearchFieldState(props: MaybeAccessor<SearchFieldStateProps>): SearchFieldState;

package/dist/searchfield/index.d.ts

@@ -1,2 +0,0 @@
-export { createSearchFieldState } from './createSearchFieldState';
-export type { SearchFieldState, SearchFieldStateProps, } from './createSearchFieldState';

package/dist/select/createSelectState.d.ts

@@ -1,72 +0,0 @@
-/**
- * State management for select components.
- * Based on @react-stately/select useSelectState.
- */
-import { type Accessor } from 'solid-js';
-import { type MaybeAccessor } from '../utils';
-import type { Key, CollectionNode, Collection } from '../collections/types';
-export interface SelectStateProps<T = unknown> {
-    /** The items to display in the select. */
-    items: T[];
-    /** Function to get the key for an item. */
-    getKey?: (item: T) => Key;
-    /** Function to get the text value for an item. */
-    getTextValue?: (item: T) => string;
-    /** Function to check if an item is disabled. */
-    getDisabled?: (item: T) => boolean;
-    /** Keys of disabled items. */
-    disabledKeys?: Iterable<Key>;
-    /** The currently selected key (controlled). */
-    selectedKey?: Key | null;
-    /** The default selected key (uncontrolled). */
-    defaultSelectedKey?: Key | null;
-    /** Handler called when the selection changes. */
-    onSelectionChange?: (key: Key | null) => void;
-    /** Whether the select is open (controlled). */
-    isOpen?: boolean;
-    /** Whether the select is open by default (uncontrolled). */
-    defaultOpen?: boolean;
-    /** Handler called when the open state changes. */
-    onOpenChange?: (isOpen: boolean) => void;
-    /** Whether the select is disabled. */
-    isDisabled?: boolean;
-    /** Whether the select is required. */
-    isRequired?: boolean;
-}
-export interface SelectState<T = unknown> {
-    /** The collection of items. */
-    readonly collection: Accessor<Collection<T>>;
-    /** Whether the select dropdown is open. */
-    readonly isOpen: Accessor<boolean>;
-    /** Open the select dropdown. */
-    open(): void;
-    /** Close the select dropdown. */
-    close(): void;
-    /** Toggle the select dropdown. */
-    toggle(): void;
-    /** The currently selected key. */
-    readonly selectedKey: Accessor<Key | null>;
-    /** The currently selected item. */
-    readonly selectedItem: Accessor<CollectionNode<T> | null>;
-    /** Set the selected key. */
-    setSelectedKey(key: Key | null): void;
-    /** The currently focused key. */
-    readonly focusedKey: Accessor<Key | null>;
-    /** Set the focused key. */
-    setFocusedKey(key: Key | null): void;
-    /** Whether the select has focus. */
-    readonly isFocused: Accessor<boolean>;
-    /** Set whether the select has focus. */
-    setFocused(isFocused: boolean): void;
-    /** Whether a specific key is disabled. */
-    isKeyDisabled(key: Key): boolean;
-    /** Whether the select is disabled. */
-    readonly isDisabled: boolean;
-    /** Whether the select is required. */
-    readonly isRequired: boolean;
-}
-/**
- * Creates state for a select component.
- * Combines list state with overlay trigger state for dropdown behavior.
- */
-export declare function createSelectState<T = unknown>(props: MaybeAccessor<SelectStateProps<T>>): SelectState<T>;

package/dist/select/index.d.ts

@@ -1 +0,0 @@
-export { createSelectState, type SelectStateProps, type SelectState, } from './createSelectState';

package/dist/slider/createSliderState.d.ts

@@ -1,71 +0,0 @@
-/**
- * Creates state for a slider component.
- * Based on @react-stately/slider useSliderState.
- */
-import { type Accessor } from 'solid-js';
-import { type MaybeAccessor } from '../utils';
-export type SliderOrientation = 'horizontal' | 'vertical';
-export interface SliderStateProps {
-    /** The current value (controlled). */
-    value?: number;
-    /** The default value (uncontrolled). */
-    defaultValue?: number;
-    /** Handler called when the value changes. */
-    onChange?: (value: number) => void;
-    /** Handler called when the user stops dragging. */
-    onChangeEnd?: (value: number) => void;
-    /** The minimum value. */
-    minValue?: number;
-    /** The maximum value. */
-    maxValue?: number;
-    /** The step value. */
-    step?: number;
-    /** The orientation of the slider. */
-    orientation?: SliderOrientation;
-    /** Whether the slider is disabled. */
-    isDisabled?: boolean;
-    /** The locale for number formatting. */
-    locale?: string;
-    /** Number format options. */
-    formatOptions?: Intl.NumberFormatOptions;
-}
-export interface SliderState {
-    /** The current value. */
-    value: Accessor<number>;
-    /** Sets the value. */
-    setValue: (value: number) => void;
-    /** Sets the value by percent (0-1). */
-    setValuePercent: (percent: number) => void;
-    /** Gets the value as a percent (0-1). */
-    getValuePercent: Accessor<number>;
-    /** Gets the formatted value string. */
-    getFormattedValue: Accessor<string>;
-    /** Whether the thumb is being dragged. */
-    isDragging: Accessor<boolean>;
-    /** Sets the dragging state. */
-    setDragging: (dragging: boolean) => void;
-    /** Whether the slider is focused. */
-    isFocused: Accessor<boolean>;
-    /** Sets the focused state. */
-    setFocused: (focused: boolean) => void;
-    /** Increments the value by step. */
-    increment: (stepMultiplier?: number) => void;
-    /** Decrements the value by step. */
-    decrement: (stepMultiplier?: number) => void;
-    /** The minimum value. */
-    minValue: number;
-    /** The maximum value. */
-    maxValue: number;
-    /** The step value. */
-    step: number;
-    /** The page step (larger step for Page Up/Down). */
-    pageStep: number;
-    /** The orientation. */
-    orientation: SliderOrientation;
-    /** Whether the slider is disabled. */
-    isDisabled: boolean;
-}
-/**
- * Provides state management for a slider component.
- */
-export declare function createSliderState(props: MaybeAccessor<SliderStateProps>): SliderState;

package/dist/slider/index.d.ts

@@ -1,2 +0,0 @@
-export { createSliderState } from './createSliderState';
-export type { SliderState, SliderStateProps, SliderOrientation, } from './createSliderState';

package/dist/ssr/index.d.ts

@@ -1,27 +0,0 @@
-/**
- * SSR utilities for Solid Stately
- *
- * SolidJS has built-in SSR support with `isServer` and `createUniqueId()`.
- * These utilities provide a consistent API matching React-Stately's patterns.
- */
-/**
- * Re-export isServer from solid-js/web for convenience.
- */
-export declare const isServer: boolean;
-/**
- * Returns whether the component is currently being server side rendered.
- * Can be used to delay browser-specific rendering until after hydration.
- */
-export declare function createIsSSR(): boolean;
-/**
- * Generate a unique ID that is stable across server and client.
- * Uses SolidJS's built-in createUniqueId which handles SSR correctly.
- *
- * @param defaultId - Optional default ID to use instead of generating one.
- */
-export declare function createId(defaultId?: string): string;
-/**
- * Check if we can use DOM APIs.
- * This is useful for code that needs to run only in the browser.
- */
-export declare const canUseDOM: boolean;

package/dist/table/TableCollection.d.ts

@@ -1,51 +0,0 @@
-/**
- * TableCollection - A collection class for table data.
- * Based on @react-stately/table/TableCollection.
- */
-import type { Key } from '../collections/types';
-import type { GridNode } from '../grid/types';
-import type { TableCollection as ITableCollection, TableCollectionOptions } from './types';
-/**
- * Creates a table collection from column and row definitions.
- */
-export declare class TableCollection<T = unknown> implements ITableCollection<T> {
-    private _columns;
-    private _rows;
-    private _headerRows;
-    private _body;
-    private _head;
-    private _keyMap;
-    private _rowHeaderColumnKeys;
-    private _size;
-    constructor(options: TableCollectionOptions<T>);
-    private buildColumns;
-    private buildColumnNode;
-    private getDefaultRowHeaderColumnKeys;
-    private buildHeaderRows;
-    private buildRows;
-    private isRowDefinition;
-    get size(): number;
-    get rows(): GridNode<T>[];
-    get columns(): GridNode<T>[];
-    get headerRows(): GridNode<T>[];
-    get head(): GridNode<T> | undefined;
-    get body(): GridNode<T>;
-    get rowCount(): number;
-    get columnCount(): number;
-    get rowHeaderColumnKeys(): Set<Key>;
-    getKeys(): Iterable<Key>;
-    getItem(key: Key): GridNode<T> | null;
-    at(index: number): GridNode<T> | null;
-    getChildren(key: Key): Iterable<GridNode<T>>;
-    getTextValue(key: Key): string;
-    getCell(rowKey: Key, columnKey: Key): GridNode<T> | null;
-    getFirstKey(): Key | null;
-    getLastKey(): Key | null;
-    getKeyBefore(key: Key): Key | null;
-    getKeyAfter(key: Key): Key | null;
-    [Symbol.iterator](): Iterator<GridNode<T>>;
-}
-/**
- * Creates a table collection from options.
- */
-export declare function createTableCollection<T>(options: TableCollectionOptions<T>): TableCollection<T>;

package/dist/table/createTableState.d.ts

@@ -1,11 +0,0 @@
-/**
- * Table state management for Table components.
- * Based on @react-stately/table/useTableState.
- */
-import { type Accessor } from 'solid-js';
-import type { TableState, TableStateOptions, TableCollection } from './types';
-/**
- * Creates state management for a table component.
- * Extends grid state with sorting and table-specific features.
- */
-export declare function createTableState<T extends object, C extends TableCollection<T> = TableCollection<T>>(options: Accessor<TableStateOptions<T, C>>): TableState<T, C>;

package/dist/table/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * Table state management module.
- * Provides state hooks for Table components.
- */
-export { createTableState } from './createTableState';
-export { TableCollection, createTableCollection } from './TableCollection';
-export type { TableState, TableStateOptions, TableCollection as ITableCollection, SortDescriptor, SortDirection, Sortable, ColumnDefinition, RowDefinition, TableCollectionOptions, } from './types';

package/dist/table/types.d.ts

@@ -1,138 +0,0 @@
-/**
- * Table state types for Table components.
- * Based on @react-stately/table and @react-types/table.
- */
-import type { Key } from '../collections/types';
-import type { GridState, GridCollection, GridNode } from '../grid/types';
-/**
- * Sort direction for table columns.
- */
-export type SortDirection = 'ascending' | 'descending';
-/**
- * Describes which column to sort by and in what direction.
- */
-export interface SortDescriptor {
-    /** The key of the column to sort by. */
-    column: Key;
-    /** The direction to sort by. */
-    direction: SortDirection;
-}
-/**
- * Interface for sortable components.
- */
-export interface Sortable {
-    /** The current sorted column and direction. */
-    sortDescriptor?: SortDescriptor;
-    /** Handler that is called when the sorted column or direction changes. */
-    onSortChange?: (descriptor: SortDescriptor) => void;
-}
-/**
- * A collection of table rows and columns.
- * Extends GridCollection with table-specific metadata.
- */
-export interface TableCollection<T = unknown> extends GridCollection<T> {
-    /** A list of header row nodes in the table. */
-    readonly headerRows: GridNode<T>[];
-    /** A list of column nodes in the table. */
-    readonly columns: GridNode<T>[];
-    /** A set of column keys that serve as the row header. */
-    readonly rowHeaderColumnKeys: Set<Key>;
-    /** The node that makes up the header of the table. */
-    readonly head?: GridNode<T>;
-    /** The node that makes up the body of the table. */
-    readonly body: GridNode<T>;
-}
-/**
- * State for a table component.
- * Extends GridState with table-specific functionality.
- */
-export interface TableState<T, C extends TableCollection<T> = TableCollection<T>> extends Omit<GridState<T, GridCollection<T>>, 'collection'> {
-    /** The table collection. */
-    readonly collection: C;
-    /** Whether the row selection checkboxes should be displayed. */
-    readonly showSelectionCheckboxes: boolean;
-    /** The current sorted column and direction. */
-    readonly sortDescriptor: SortDescriptor | null;
-    /** Sort by the given column and direction. */
-    sort(columnKey: Key, direction?: SortDirection): void;
-}
-/**
- * Options for creating table state.
- */
-export interface TableStateOptions<T, C extends TableCollection<T> = TableCollection<T>> extends Sortable {
-    /** The table collection. */
-    collection: C;
-    /** Keys of disabled rows. */
-    disabledKeys?: Iterable<Key>;
-    /** Focus mode: 'row' or 'cell'. */
-    focusMode?: 'row' | 'cell';
-    /** Selection mode. */
-    selectionMode?: 'none' | 'single' | 'multiple';
-    /** Selection behavior. */
-    selectionBehavior?: 'toggle' | 'replace';
-    /** Whether empty selection is disallowed. */
-    disallowEmptySelection?: boolean;
-    /** Currently selected keys (controlled). */
-    selectedKeys?: 'all' | Iterable<Key>;
-    /** Default selected keys (uncontrolled). */
-    defaultSelectedKeys?: 'all' | Iterable<Key>;
-    /** Handler for selection changes. */
-    onSelectionChange?: (keys: 'all' | Set<Key>) => void;
-    /** Whether the row selection checkboxes should be displayed. */
-    showSelectionCheckboxes?: boolean;
-}
-/**
- * Column definition for building table collections.
- */
-export interface ColumnDefinition<T = unknown> {
-    /** The key for the column. */
-    key: Key;
-    /** The display name or rendered content. */
-    name?: string;
-    /** Text value for accessibility. */
-    textValue?: string;
-    /** Whether this column is a row header. */
-    isRowHeader?: boolean;
-    /** Whether this column allows sorting. */
-    allowsSorting?: boolean;
-    /** Child columns (for column groups). */
-    children?: ColumnDefinition<T>[];
-    /** Width of the column. */
-    width?: number | string;
-    /** Minimum width of the column. */
-    minWidth?: number;
-    /** Maximum width of the column. */
-    maxWidth?: number;
-}
-/**
- * Row definition for building table collections.
- */
-export interface RowDefinition<T = unknown> {
-    /** The key for the row. */
-    key: Key;
-    /** The data value for the row. */
-    value: T;
-    /** Text value for accessibility/search. */
-    textValue?: string;
-    /** Whether this row has child rows (for tree tables). */
-    hasChildRows?: boolean;
-    /** Child rows (for tree tables). */
-    childRows?: RowDefinition<T>[];
-}
-/**
- * Options for building a table collection.
- */
-export interface TableCollectionOptions<T = unknown> {
-    /** Column definitions. */
-    columns: ColumnDefinition<T>[];
-    /** Row definitions or data items. */
-    rows: RowDefinition<T>[] | T[];
-    /** Function to get the key from a data item. */
-    getKey?: (item: T) => Key;
-    /** Function to get the text value from a data item. */
-    getTextValue?: (item: T, column: ColumnDefinition<T>) => string;
-    /** Whether to show selection checkboxes. */
-    showSelectionCheckboxes?: boolean;
-    /** Set of column keys that serve as row headers. */
-    rowHeaderColumnKeys?: Set<Key>;
-}

package/dist/tabs/createTabListState.d.ts

@@ -1,67 +0,0 @@
-/**
- * State management for tab components.
- * Based on @react-stately/tabs.
- */
-import { type Accessor } from 'solid-js';
-import { type MaybeAccessor } from '../utils';
-import type { Collection, CollectionNode, Key, FocusStrategy } from '../collections/types';
-export type KeyboardActivation = 'automatic' | 'manual';
-export type TabOrientation = 'horizontal' | 'vertical';
-export interface TabListStateProps<T = unknown> {
-    /** The items in the tab list. */
-    items?: T[];
-    /** Function to get a key from an item. */
-    getKey?: (item: T) => Key;
-    /** Function to get text value from an item. */
-    getTextValue?: (item: T) => string;
-    /** Function to check if an item is disabled. */
-    getDisabled?: (item: T) => boolean;
-    /** Keys of disabled tabs. */
-    disabledKeys?: Iterable<Key>;
-    /** The currently selected tab key (controlled). */
-    selectedKey?: Key | null;
-    /** The default selected tab key (uncontrolled). */
-    defaultSelectedKey?: Key;
-    /** Handler for tab selection changes. */
-    onSelectionChange?: (key: Key) => void;
-    /** Whether the entire tab list is disabled. */
-    isDisabled?: boolean;
-    /** Whether tabs are activated automatically on focus or manually. */
-    keyboardActivation?: KeyboardActivation;
-    /** The orientation of the tab list. */
-    orientation?: TabOrientation;
-}
-export interface TabListState<T = unknown> {
-    /** The collection of tabs. */
-    readonly collection: Accessor<Collection<T>>;
-    /** The currently selected tab key. */
-    readonly selectedKey: Accessor<Key | null>;
-    /** Set the selected tab key. */
-    setSelectedKey(key: Key): void;
-    /** The currently selected tab item. */
-    readonly selectedItem: Accessor<CollectionNode<T> | null>;
-    /** Whether the tab list is disabled. */
-    readonly isDisabled: Accessor<boolean>;
-    /** The keyboard activation mode. */
-    readonly keyboardActivation: Accessor<KeyboardActivation>;
-    /** The orientation of the tab list. */
-    readonly orientation: Accessor<TabOrientation>;
-    /** Whether a tab key is disabled. */
-    isKeyDisabled(key: Key): boolean;
-    /** The set of disabled keys. */
-    readonly disabledKeys: Accessor<Set<Key>>;
-    /** Whether the collection is focused. */
-    readonly isFocused: Accessor<boolean>;
-    /** Set the focused state. */
-    setFocused(isFocused: boolean): void;
-    /** The currently focused tab key. */
-    readonly focusedKey: Accessor<Key | null>;
-    /** Set the focused tab key. */
-    setFocusedKey(key: Key | null, childStrategy?: FocusStrategy): void;
-    /** The child focus strategy. */
-    readonly childFocusStrategy: Accessor<FocusStrategy | null>;
-}
-/**
- * Creates state for a tab list component.
- */
-export declare function createTabListState<T = unknown>(props: MaybeAccessor<TabListStateProps<T>>): TabListState<T>;

package/dist/tabs/index.d.ts

@@ -1 +0,0 @@
-export { createTabListState, type TabListStateProps, type TabListState, type KeyboardActivation, type TabOrientation, } from './createTabListState';

package/dist/textfield/createTextFieldState.d.ts

@@ -1,29 +0,0 @@
-/**
- * TextField state for Solid Stately
- *
- * Provides state management for text input components.
- *
- * This is a port of @react-stately/utils's useControlledState pattern
- * as used by @react-aria/textfield.
- */
-import { Accessor } from 'solid-js';
-import { type MaybeAccessor } from '../utils';
-export interface TextFieldStateOptions {
-    /** The current value (controlled). */
-    value?: string;
-    /** The default value (uncontrolled). */
-    defaultValue?: string;
-    /** Handler that is called when the value changes. */
-    onChange?: (value: string) => void;
-}
-export interface TextFieldState {
-    /** The current value of the text field. */
-    readonly value: Accessor<string>;
-    /** Sets the value of the text field. */
-    setValue(value: string): void;
-}
-/**
- * Provides state management for text input components.
- * Supports both controlled and uncontrolled modes.
- */
-export declare function createTextFieldState(props?: MaybeAccessor<TextFieldStateOptions>): TextFieldState;

package/dist/textfield/index.d.ts

@@ -1 +0,0 @@
-export { createTextFieldState, type TextFieldStateOptions, type TextFieldState, } from './createTextFieldState';