@proyecto-viviana/solid-stately 0.2.7 → 0.4.0

package/src/grid/types.ts

@@ -3,20 +3,20 @@
  * Based on @react-types/grid.
  */
 
-import type { Key, FocusStrategy } from '../collections/types';
+import type { Key, FocusStrategy, Selection, SelectionBehavior } from "../collections/types";
 
 /**
  * Represents the type of a grid node.
  */
 export type GridNodeType =
-  | 'item'           // A selectable row
-  | 'cell'           // A cell within a row
-  | 'column'         // A column header
-  | 'rowheader'      // A cell that acts as a row header
-  | 'headerrow'      // A header row container
-  | 'section'        // A section/group
-  | 'content'        // A collection content placeholder
-  | 'placeholder';   // A placeholder (e.g., empty row)
+  | "item" // A selectable row
+  | "cell" // A cell within a row
+  | "column" // A column header
+  | "rowheader" // A cell that acts as a row header
+  | "headerrow" // A header row container
+  | "section" // A section/group
+  | "content" // A collection content placeholder
+  | "placeholder"; // A placeholder (e.g., empty row)
 
 /**
  * Represents a node in a grid collection.
@@ -42,6 +42,10 @@ export interface GridNode<T = unknown> {
   prevKey?: Key | null;
   /** Next sibling key (visible order). */
   nextKey?: Key | null;
+  /** Key of the first child node, if any (used by tree grids). */
+  firstChildKey?: Key | null;
+  /** Key of the last child node, if any (used by tree grids). */
+  lastChildKey?: Key | null;
   /** Whether this node has child nodes. */
   hasChildNodes: boolean;
   /** Child nodes (cells for rows, rows for sections). */
@@ -49,7 +53,7 @@ export interface GridNode<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>;
   /** Column index for cells. */
@@ -123,6 +127,8 @@ export interface GridState<T, C extends GridCollection<T> = GridCollection<T>> {
   readonly collection: C;
   /** Keys of disabled rows. */
   readonly disabledKeys: Set<Key>;
+  /** Whether `disabledKeys` applies to all interactions, or only selection. */
+  readonly disabledBehavior: "selection" | "all";
   /** Whether keyboard navigation is disabled. */
   readonly isKeyboardNavigationDisabled: boolean;
   /** Currently focused key. */
@@ -132,9 +138,13 @@ export interface GridState<T, C extends GridCollection<T> = GridCollection<T>> {
   /** Whether the grid is focused. */
   readonly isFocused: boolean;
   /** The selection mode. */
-  readonly selectionMode: 'none' | 'single' | 'multiple';
+  readonly selectionMode: "none" | "single" | "multiple";
+  /** The selection behavior. */
+  readonly selectionBehavior: SelectionBehavior;
+  /** Whether empty selection is disallowed. */
+  readonly disallowEmptySelection: boolean;
   /** The currently selected keys. */
-  readonly selectedKeys: 'all' | Set<Key>;
+  readonly selectedKeys: "all" | Set<Key>;
   /** Check if a key is selected. */
   isSelected(key: Key): boolean;
   /** Check if a key is disabled. */
@@ -143,10 +153,14 @@ export interface GridState<T, C extends GridCollection<T> = GridCollection<T>> {
   setFocusedKey(key: Key | null, childFocusStrategy?: FocusStrategy): void;
   /** Set focused state. */
   setFocused(isFocused: boolean): void;
+  /** Set the selection behavior. */
+  setSelectionBehavior(behavior: SelectionBehavior): void;
   /** Toggle selection for a key. */
   toggleSelection(key: Key): void;
   /** Replace selection with a key. */
   replaceSelection(key: Key): void;
+  /** Set multiple selected keys. */
+  setSelectedKeys(keys: Selection | Iterable<Key>): void;
   /** Extend selection to a key (shift-click). */
   extendSelection(toKey: Key): void;
   /** Select all rows. */
@@ -167,18 +181,20 @@ export interface GridStateOptions<T, C extends GridCollection<T> = GridCollectio
   collection: C;
   /** Keys of disabled rows. */
   disabledKeys?: Iterable<Key>;
+  /** Whether `disabledKeys` applies to all interactions, or only selection. @default "all" */
+  disabledBehavior?: "selection" | "all";
   /** Focus mode: 'row' or 'cell'. */
-  focusMode?: 'row' | 'cell';
+  focusMode?: "row" | "cell";
   /** Selection mode. */
-  selectionMode?: 'none' | 'single' | 'multiple';
+  selectionMode?: "none" | "single" | "multiple";
   /** Selection behavior. */
-  selectionBehavior?: 'toggle' | 'replace';
+  selectionBehavior?: SelectionBehavior;
   /** 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;
 }

package/src/index.d.ts

@@ -1,26 +1,311 @@
-export { createToggleState, type ToggleStateOptions, type ToggleState, } 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 { 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';
-export { createNumberFieldState, type NumberFieldStateProps, type NumberFieldState, } from './numberfield';
-export { createSearchFieldState, type SearchFieldStateProps, type SearchFieldState, } from './searchfield';
-export { createSliderState, type SliderStateProps, type SliderState, type SliderOrientation, } from './slider';
-export { createTooltipTriggerState, resetTooltipState, type TooltipTriggerProps, type TooltipTriggerState, } from './tooltip';
-export { createToastState, createToastQueue, ToastQueue, Timer, type ToastOptions, type QueuedToast, type ToastQueueOptions, type ToastStateProps, type ToastState, } from './toast';
-export { createDisclosureState, createDisclosureGroupState, type DisclosureStateProps, type DisclosureState, type DisclosureGroupStateProps, type DisclosureGroupState, type Key as DisclosureKey, } from './disclosure';
-export { createCalendarState, type CalendarStateProps, type CalendarState, type ValidationState, createRangeCalendarState, type RangeCalendarStateProps, type RangeCalendarState, type DateRange, type RangeValue, createDateFieldState, type DateFieldStateProps, type DateFieldState, type DateSegment, type DateSegmentType, createTimeFieldState, type TimeFieldStateProps, type TimeFieldState, type TimeSegment, type TimeSegmentType, type TimeValue, type CalendarDate, type CalendarDateTime, type ZonedDateTime, type DateValue, type Time, today, now, getLocalTimeZone, parseDate, parseDateTime, parseTime, parseAbsolute, parseAbsoluteToLocal, parseZonedDateTime, toCalendarDate, toCalendarDateTime, toZoned, toTime, CalendarDateClass, CalendarDateTimeClass, ZonedDateTimeClass, TimeClass, DateFormatter, isSameDay, isSameMonth, isSameYear, isToday, isWeekend, startOfMonth, endOfMonth, startOfWeek, endOfWeek, startOfYear, endOfYear, getWeeksInMonth, getDayOfWeek, minDate, maxDate, } from './calendar';
-export { createGridState, type GridState, type GridStateOptions, type GridCollection, type GridNode, type GridNodeType, } from './grid';
-export { createTableState, TableCollection, createTableCollection, type TableState, type TableStateOptions, type ITableCollection, type SortDescriptor, type SortDirection, type Sortable, type ColumnDefinition, type RowDefinition, type TableCollectionOptions, } from './table';
-export { createTreeState, TreeCollection, createTreeCollection, type TreeState, type TreeStateOptions, type TreeCollectionInterface, type TreeNode, type TreeItemData, } from './tree';
-export { type Color, type ColorFormat, type ColorSpace, type ColorChannel, type ColorChannelRange, type ColorAxes, parseColor, normalizeColor, createRGBColor, createHSLColor, createHSBColor, createColorSliderState, type ColorSliderStateOptions, type ColorSliderState, createColorAreaState, type ColorAreaStateOptions, type ColorAreaState, createColorWheelState, type ColorWheelStateOptions, type ColorWheelState, createColorFieldState, type ColorFieldStateOptions, type ColorFieldState, } from './color';
-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 { access, isAccessor, type MaybeAccessor, type MaybeAccessorValue } from './utils';
-//# sourceMappingURL=index.d.ts.map
+export { createToggleState, type ToggleStateOptions, type ToggleState } 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 { 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";
+export {
+  createNumberFieldState,
+  type NumberFieldStateProps,
+  type NumberFieldState,
+} from "./numberfield";
+export {
+  createSearchFieldState,
+  type SearchFieldStateProps,
+  type SearchFieldState,
+} from "./searchfield";
+export {
+  createSliderState,
+  type SliderStateProps,
+  type SliderState,
+  type SliderOrientation,
+} from "./slider";
+export {
+  createTooltipTriggerState,
+  resetTooltipState,
+  type TooltipTriggerProps,
+  type TooltipTriggerState,
+} from "./tooltip";
+export {
+  createToastState,
+  createToastQueue,
+  ToastQueue,
+  Timer,
+  type ToastOptions,
+  type QueuedToast,
+  type ToastQueueOptions,
+  type ToastStateProps,
+  type ToastState,
+} from "./toast";
+export {
+  createDisclosureState,
+  createDisclosureGroupState,
+  type DisclosureStateProps,
+  type DisclosureState,
+  type DisclosureGroupStateProps,
+  type DisclosureGroupState,
+  type Key as DisclosureKey,
+} from "./disclosure";
+export {
+  createCalendarState,
+  type CalendarStateProps,
+  type CalendarState,
+  type ValidationState,
+  type CalendarPageBehavior,
+  type CalendarSelectionAlignment,
+  type CalendarDayOfWeek,
+  createRangeCalendarState,
+  type RangeCalendarStateProps,
+  type RangeCalendarState,
+  type DateRange,
+  type RangeValue,
+  createDateFieldState,
+  type DateFieldStateProps,
+  type DateFieldState,
+  type DateSegment,
+  type DateSegmentType,
+  createTimeFieldState,
+  type TimeFieldStateProps,
+  type TimeFieldState,
+  type TimeSegment,
+  type TimeSegmentType,
+  type TimeValue,
+  type CalendarDate,
+  type CalendarDateTime,
+  type ZonedDateTime,
+  type DateValue,
+  type Time,
+  type Calendar,
+  type CalendarIdentifier,
+  type AnyCalendarDate,
+  createCalendar,
+  GregorianCalendar,
+  today,
+  now,
+  getLocalTimeZone,
+  parseDate,
+  parseDateTime,
+  parseTime,
+  parseAbsolute,
+  parseAbsoluteToLocal,
+  parseZonedDateTime,
+  toCalendarDate,
+  toCalendarDateTime,
+  toZoned,
+  toTime,
+  CalendarDateClass,
+  CalendarDateTimeClass,
+  ZonedDateTimeClass,
+  TimeClass,
+  DateFormatter,
+  isSameDay,
+  isSameMonth,
+  isSameYear,
+  isToday,
+  isWeekend,
+  startOfMonth,
+  endOfMonth,
+  startOfWeek,
+  endOfWeek,
+  startOfYear,
+  endOfYear,
+  getWeeksInMonth,
+  getDayOfWeek,
+  toCalendar,
+  minDate,
+  maxDate,
+} from "./calendar";
+export {
+  createGridState,
+  type GridState,
+  type GridStateOptions,
+  type GridCollection,
+  type GridNode,
+  type GridNodeType,
+} from "./grid";
+export {
+  createTableState,
+  TableCollection,
+  createTableCollection,
+  type TableState,
+  type TableStateOptions,
+  type ITableCollection,
+  type SortDescriptor,
+  type SortDirection,
+  type Sortable,
+  type ColumnDefinition,
+  type RowDefinition,
+  type TableCollectionOptions,
+} from "./table";
+export {
+  createTreeState,
+  TreeCollection,
+  createTreeCollection,
+  type TreeState,
+  type TreeStateOptions,
+  type TreeCollectionInterface,
+  type TreeNode,
+  type TreeItemData,
+} from "./tree";
+export {
+  type Color,
+  type ColorFormat,
+  type ColorSpace,
+  type ColorChannel,
+  type ColorChannelRange,
+  type ColorAxes,
+  parseColor,
+  normalizeColor,
+  createRGBColor,
+  createHSLColor,
+  createHSBColor,
+  createColorSliderState,
+  type ColorSliderStateOptions,
+  type ColorSliderState,
+  createColorAreaState,
+  type ColorAreaStateOptions,
+  type ColorAreaState,
+  createColorWheelState,
+  type ColorWheelStateOptions,
+  type ColorWheelState,
+  createColorFieldState,
+  type ColorFieldStateOptions,
+  type ColorFieldState,
+} from "./color";
+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 DragType,
+  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 { access, isAccessor, type MaybeAccessor, type MaybeAccessorValue } from "./utils";
+//# sourceMappingURL=index.d.ts.map