@proyecto-viviana/solid-stately 0.3.0 → 0.4.1

package/dist/dnd/createDroppableCollectionState.d.ts

@@ -5,6 +5,7 @@
  */
 import { type Accessor } from "solid-js";
 import type { DropItem, DropTarget, DropOperation, DragTypes, DroppableCollectionEnterEvent, DroppableCollectionActivateEvent, DroppableCollectionExitEvent, DroppableCollectionDropEvent, DroppableCollectionInsertDropEvent, DroppableCollectionRootDropEvent, DroppableCollectionOnItemDropEvent, DroppableCollectionReorderEvent, ItemDropTarget } from "./types";
+import type { Collection } from "../collections/types";
 export interface DroppableCollectionStateOptions {
     /**
      * The drag types that the droppable collection accepts.
@@ -35,6 +36,14 @@ export interface DroppableCollectionStateOptions {
     onMove?: (e: DroppableCollectionReorderEvent) => void;
     /** A function returning whether a given target is a valid "on" drop target. */
     shouldAcceptItemDrop?: (target: ItemDropTarget, types: DragTypes) => boolean;
+    /**
+     * The host collection. Used by the default drop-operation feature detection to
+     * confirm a reorder stays within the same parent and to prevent dropping an
+     * item onto itself or a descendant. Optional: a flat collection (e.g. a plain
+     * ListBox) is always "within parent" and has no descendants, so omitting it is
+     * faithful for flat hosts.
+     */
+    collection?: Collection<unknown>;
     /** Whether the droppable collection is disabled. */
     isDisabled?: boolean;
 }
@@ -59,8 +68,14 @@ export interface DroppableCollectionState {
     activateTarget(x: number, y: number): void;
     /** Perform a drop on the collection. */
     drop(items: DropItem[], dropOperation: DropOperation, isInternal: boolean, draggingKeys?: Set<string | number>): void;
-    /** Get the drop operation for a target. */
-    getDropOperation(target: DropTarget, types: DragTypes, allowedOperations: DropOperation[]): DropOperation;
+    /**
+     * Get the drop operation for a target. `isInternal` is true when the active
+     * drag originated from this same collection; `draggingKeys` are the keys being
+     * dragged. Both feed the handler-aware feature detection that decides whether a
+     * given drop position (before/after/on/root) is a valid target — e.g. a
+     * reorder-only collection rejects "on" targets, matching React Aria.
+     */
+    getDropOperation(target: DropTarget, types: DragTypes, allowedOperations: DropOperation[], isInternal?: boolean, draggingKeys?: Set<string | number>): DropOperation;
     /** Check if an item drop should be accepted. */
     shouldAcceptItemDrop(target: ItemDropTarget, types: DragTypes): boolean;
 }

package/dist/dnd/index.d.ts

@@ -3,7 +3,7 @@
  *
  * Exports for DnD functionality.
  */
-export type { DropOperation, DragItem, DragDropEvent, DragStartEvent, DragMoveEvent, DragEndEvent, DropEnterEvent, DropMoveEvent, DropActivateEvent, DropExitEvent, TextDropItem, FileDropItem, DirectoryDropItem, DropItem, DropEvent, DropPosition, RootDropTarget, ItemDropTarget, DropTarget, DroppableCollectionEnterEvent, DroppableCollectionMoveEvent, DroppableCollectionActivateEvent, DroppableCollectionExitEvent, DroppableCollectionDropEvent, DroppableCollectionInsertDropEvent, DroppableCollectionRootDropEvent, DroppableCollectionOnItemDropEvent, DroppableCollectionReorderEvent, DragTypes, DropTargetDelegate, DraggableCollectionStartEvent, DraggableCollectionMoveEvent, DraggableCollectionEndEvent, DragPreviewRenderer, DroppableCollectionUtilityOptions, DroppableCollectionBaseProps, DroppableCollectionProps, DraggableCollectionProps, } from "./types";
+export type { DropOperation, DragItem, DragDropEvent, DragStartEvent, DragMoveEvent, DragEndEvent, DropEnterEvent, DropMoveEvent, DropActivateEvent, DropExitEvent, TextDropItem, FileDropItem, DirectoryDropItem, DropItem, DropEvent, DropPosition, RootDropTarget, ItemDropTarget, DropTarget, DroppableCollectionEnterEvent, DroppableCollectionMoveEvent, DroppableCollectionActivateEvent, DroppableCollectionExitEvent, DroppableCollectionDropEvent, DroppableCollectionInsertDropEvent, DroppableCollectionRootDropEvent, DroppableCollectionOnItemDropEvent, DroppableCollectionReorderEvent, DragType, DragTypes, DropTargetDelegate, DraggableCollectionStartEvent, DraggableCollectionMoveEvent, DraggableCollectionEndEvent, DragPreviewRenderer, DroppableCollectionUtilityOptions, DroppableCollectionBaseProps, DroppableCollectionProps, DraggableCollectionProps, } from "./types";
 export { createDragState, type DragStateOptions, type DragState } from "./createDragState";
 export { createDropState, type DropStateOptions, type DropState } from "./createDropState";
 export { createDraggableCollectionState, type DraggableCollectionStateOptions, type DraggableCollectionState, } from "./createDraggableCollectionState";

package/dist/dnd/types.d.ts

@@ -174,10 +174,12 @@ export interface DroppableCollectionReorderEvent {
     /** The drop target. */
     target: ItemDropTarget;
 }
+/** A drag type: either a MIME type string or a symbol such as the directory drag type. */
+export type DragType = string | symbol;
 /** Interface for checking drag types. */
 export interface DragTypes {
     /** Returns whether the drag contains data of the given type. */
-    has(type: string | symbol): boolean;
+    has(type: DragType | DragType[]): boolean;
 }
 /** Delegate for determining drop targets within a collection. */
 export interface DropTargetDelegate {

package/dist/grid/types.d.ts

@@ -2,7 +2,7 @@
  * Grid collection types for Table and GridList components.
  * 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.
  */
@@ -31,6 +31,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). */
@@ -99,6 +103,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. */
@@ -110,7 +116,9 @@ export interface GridState<T, C extends GridCollection<T> = GridCollection<T>> {
     /** The selection mode. */
     readonly selectionMode: "none" | "single" | "multiple";
     /** The selection behavior. */
-    readonly selectionBehavior: "toggle" | "replace";
+    readonly selectionBehavior: SelectionBehavior;
+    /** Whether empty selection is disallowed. */
+    readonly disallowEmptySelection: boolean;
     /** The currently selected keys. */
     readonly selectedKeys: "all" | Set<Key>;
     /** Check if a key is selected. */
@@ -121,10 +129,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. */
@@ -144,12 +156,14 @@ 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";
     /** Selection mode. */
     selectionMode?: "none" | "single" | "multiple";
     /** Selection behavior. */
-    selectionBehavior?: "toggle" | "replace";
+    selectionBehavior?: SelectionBehavior;
     /** Whether empty selection is disallowed. */
     disallowEmptySelection?: boolean;
     /** Currently selected keys (controlled). */

package/dist/index.d.ts

@@ -4,8 +4,8 @@ export { createTextFieldState, type TextFieldStateOptions, type TextFieldState }
 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 { 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, getItemCount, createSelectionState, type SelectionStateProps, type SelectionState, type SelectionPressEvent, createListState, createFilteredListState, createSingleSelectListState, type ListStateProps, type ListState, type ListFilterFn, type SingleSelectListStateProps, type SingleSelectListState, createMenuState, createMenuTriggerState, type MenuStateProps, type MenuState, type MenuTriggerStateProps, type MenuTriggerState, } from "./collections";
+export { useMultipleSelectionState, type MultipleSelectionStateProps, type MultipleSelectionState, SelectionManager, type SelectionManagerOptions, type LayoutDelegate, } 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";
@@ -15,14 +15,14 @@ export { createNumberFieldState, type NumberFieldStateProps, type NumberFieldSta
 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 { createToastState, createToastQueue, ToastQueue, Timer, type ToastOptions, type QueuedToast, type ToastQueueOptions, type ToastAction, 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, createDatePickerState, type DatePickerState, 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 { createCalendarState, type CalendarStateProps, type CalendarState, type CalendarSelectionMode, type CalendarValueType, 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, createDatePickerState, type DatePickerState, 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, createTableColumnResizeState, TableCollection, createTableCollection, type TableState, type TableStateOptions, type ITableCollection, type SortDescriptor, type SortDirection, type Sortable, type ColumnDefinition, type RowDefinition, type TableCollectionOptions, type ColumnSize, type ColumnResizeDefinition, type TableColumnResizeStateProps, type TableColumnResizeState, } from "./table";
+export { createTableState, createTreeGridState, createTableColumnResizeState, TableCollection, createTableCollection, type TableState, type TableStateOptions, type ITableCollection, type TreeGridState, type TreeGridStateOptions, type SortDescriptor, type SortDirection, type Sortable, type ColumnDefinition, type RowDefinition, type TableCollectionOptions, type ColumnSize, type ColumnResizeDefinition, type TableColumnResizeStateProps, type TableColumnResizeState, } 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 { 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 { 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";