@proyecto-viviana/solid-stately 0.2.7 → 0.4.0

package/src/tree/types.d.ts

@@ -2,156 +2,161 @@
  * Tree collection types for Tree components.
  * Based on @react-stately/tree.
  */
-import type { Key, FocusStrategy } from '../collections/types';
-import type { GridNode, GridCollection } from '../grid/types';
+import type { Key, FocusStrategy } from "../collections/types";
+import type { GridNode, GridCollection } from "../grid/types";
 /**
  * Represents a node in a tree collection.
  * Extends GridNode with tree-specific properties.
  */
 export interface TreeNode<T = unknown> extends GridNode<T> {
-    /** Whether this node has child nodes that can be expanded. */
-    hasChildNodes: boolean;
-    /** Child nodes of this tree item. */
-    childNodes: TreeNode<T>[];
-    /** The level of nesting (0 for root items). */
-    level: number;
-    /** The key of the parent node, if any. */
-    parentKey?: Key | null;
-    /** Whether this node is expandable. */
-    isExpandable?: boolean;
-    /** Whether this node is currently expanded (only meaningful if expandable). */
-    isExpanded?: boolean;
+  /** Whether this node has child nodes that can be expanded. */
+  hasChildNodes: boolean;
+  /** Child nodes of this tree item. */
+  childNodes: TreeNode<T>[];
+  /** The level of nesting (0 for root items). */
+  level: number;
+  /** The key of the parent node, if any. */
+  parentKey?: Key | null;
+  /** Whether this node is expandable. */
+  isExpandable?: boolean;
+  /** Whether this node is currently expanded (only meaningful if expandable). */
+  isExpanded?: boolean;
 }
 /**
  * A collection of tree nodes with tree-specific navigation.
  * Only includes visible nodes (respects expanded state).
  */
-export interface TreeCollection<T = unknown> extends Omit<GridCollection<T>, 'rows' | 'columns' | 'headerRows' | 'columnCount' | 'getCell'> {
-    /** All visible rows in the tree (respects expanded state). */
-    readonly rows: TreeNode<T>[];
-    /** Number of visible rows. */
-    readonly rowCount: number;
-    /** Get all keys in the collection (visible only). */
-    getKeys(): Iterable<Key>;
-    /** Get a node by its key (any node, visible or not). */
-    getItem(key: Key): TreeNode<T> | null;
-    /** Get a node by index (visible nodes only). */
-    at(index: number): TreeNode<T> | null;
-    /** Get the key before the given key (visible nodes only). */
-    getKeyBefore(key: Key): Key | null;
-    /** Get the key after the given key (visible nodes only). */
-    getKeyAfter(key: Key): Key | null;
-    /** Get the first key in the collection. */
-    getFirstKey(): Key | null;
-    /** Get the last key in the collection. */
-    getLastKey(): Key | null;
-    /** Get the children of a node. */
-    getChildren(key: Key): Iterable<TreeNode<T>>;
-    /** Get the text value for a key. */
-    getTextValue(key: Key): string;
-    /** Get the parent key for a node. */
-    getParentKey(key: Key): Key | null;
-    /** Iterator over visible nodes. */
-    [Symbol.iterator](): Iterator<TreeNode<T>>;
+export interface TreeCollection<T = unknown> extends Omit<
+  GridCollection<T>,
+  "rows" | "columns" | "headerRows" | "columnCount" | "getCell"
+> {
+  /** All visible rows in the tree (respects expanded state). */
+  readonly rows: TreeNode<T>[];
+  /** Number of visible rows. */
+  readonly rowCount: number;
+  /** Get all keys in the collection (visible only). */
+  getKeys(): Iterable<Key>;
+  /** Get a node by its key (any node, visible or not). */
+  getItem(key: Key): TreeNode<T> | null;
+  /** Get a node by index (visible nodes only). */
+  at(index: number): TreeNode<T> | null;
+  /** Get the key before the given key (visible nodes only). */
+  getKeyBefore(key: Key): Key | null;
+  /** Get the key after the given key (visible nodes only). */
+  getKeyAfter(key: Key): Key | null;
+  /** Get the first key in the collection. */
+  getFirstKey(): Key | null;
+  /** Get the last key in the collection. */
+  getLastKey(): Key | null;
+  /** Get the children of a node. */
+  getChildren(key: Key): Iterable<TreeNode<T>>;
+  /** Get the text value for a key. */
+  getTextValue(key: Key): string;
+  /** Get the parent key for a node. */
+  getParentKey(key: Key): Key | null;
+  /** Iterator over visible nodes. */
+  [Symbol.iterator](): Iterator<TreeNode<T>>;
 }
 /**
  * State for a tree component.
  * Extends grid state with expansion management.
  */
 export interface TreeState<T, C extends TreeCollection<T> = TreeCollection<T>> {
-    /** The tree collection (only visible nodes). */
-    readonly collection: C;
-    /** Keys of disabled items. */
-    readonly disabledKeys: Set<Key>;
-    /** Keys of expanded items. */
-    readonly expandedKeys: Set<Key>;
-    /** Whether keyboard navigation is disabled. */
-    readonly isKeyboardNavigationDisabled: boolean;
-    /** Currently focused key. */
-    readonly focusedKey: Key | null;
-    /** Focus strategy for child focus. */
-    readonly childFocusStrategy: FocusStrategy | null;
-    /** Whether the tree is focused. */
-    readonly isFocused: boolean;
-    /** The selection mode. */
-    readonly selectionMode: 'none' | 'single' | 'multiple';
-    /** The currently selected keys. */
-    readonly selectedKeys: 'all' | Set<Key>;
-    /** Check if a key is selected. */
-    isSelected(key: Key): boolean;
-    /** Check if a key is disabled. */
-    isDisabled(key: Key): boolean;
-    /** Check if a key is expanded. */
-    isExpanded(key: Key): boolean;
-    /** Set the focused key. */
-    setFocusedKey(key: Key | null, childFocusStrategy?: FocusStrategy): void;
-    /** Set focused state. */
-    setFocused(isFocused: boolean): void;
-    /** Toggle selection for a key. */
-    toggleSelection(key: Key): void;
-    /** Replace selection with a key. */
-    replaceSelection(key: Key): void;
-    /** Extend selection to a key (shift-click). */
-    extendSelection(toKey: Key): void;
-    /** Select all visible items. */
-    selectAll(): void;
-    /** Clear selection. */
-    clearSelection(): void;
-    /** Toggle select all. */
-    toggleSelectAll(): void;
-    /** Toggle expansion for a key. */
-    toggleKey(key: Key): void;
-    /** Expand a key. */
-    expandKey(key: Key): void;
-    /** Collapse a key. */
-    collapseKey(key: Key): void;
-    /** Set the expanded keys. */
-    setExpandedKeys(keys: Set<Key>): void;
-    /** Set keyboard navigation disabled. */
-    setKeyboardNavigationDisabled(isDisabled: boolean): void;
+  /** The tree collection (only visible nodes). */
+  readonly collection: C;
+  /** Keys of disabled items. */
+  readonly disabledKeys: Set<Key>;
+  /** Keys of expanded items. */
+  readonly expandedKeys: Set<Key>;
+  /** Whether keyboard navigation is disabled. */
+  readonly isKeyboardNavigationDisabled: boolean;
+  /** Currently focused key. */
+  readonly focusedKey: Key | null;
+  /** Focus strategy for child focus. */
+  readonly childFocusStrategy: FocusStrategy | null;
+  /** Whether the tree is focused. */
+  readonly isFocused: boolean;
+  /** The selection mode. */
+  readonly selectionMode: "none" | "single" | "multiple";
+  /** How selection behaves when pressing an item. */
+  readonly selectionBehavior: "toggle" | "replace";
+  /** The currently selected keys. */
+  readonly selectedKeys: "all" | Set<Key>;
+  /** Check if a key is selected. */
+  isSelected(key: Key): boolean;
+  /** Check if a key is disabled. */
+  isDisabled(key: Key): boolean;
+  /** Check if a key is expanded. */
+  isExpanded(key: Key): boolean;
+  /** Set the focused key. */
+  setFocusedKey(key: Key | null, childFocusStrategy?: FocusStrategy): void;
+  /** Set focused state. */
+  setFocused(isFocused: boolean): void;
+  /** Toggle selection for a key. */
+  toggleSelection(key: Key): void;
+  /** Replace selection with a key. */
+  replaceSelection(key: Key): void;
+  /** Extend selection to a key (shift-click). */
+  extendSelection(toKey: Key): void;
+  /** Select all visible items. */
+  selectAll(): void;
+  /** Clear selection. */
+  clearSelection(): void;
+  /** Toggle select all. */
+  toggleSelectAll(): void;
+  /** Toggle expansion for a key. */
+  toggleKey(key: Key): void;
+  /** Expand a key. */
+  expandKey(key: Key): void;
+  /** Collapse a key. */
+  collapseKey(key: Key): void;
+  /** Set the expanded keys. */
+  setExpandedKeys(keys: Set<Key>): void;
+  /** Set keyboard navigation disabled. */
+  setKeyboardNavigationDisabled(isDisabled: boolean): void;
 }
 /**
  * Options for creating tree state.
  */
 export interface TreeStateOptions<T, C extends TreeCollection<T> = TreeCollection<T>> {
-    /** The tree collection builder - receives expanded keys and returns collection. */
-    collectionFactory: (expandedKeys: Set<Key>) => C;
-    /** Keys of disabled items. */
-    disabledKeys?: Iterable<Key>;
-    /** Disabled behavior: 'selection' only or 'all' interactions. */
-    disabledBehavior?: 'selection' | 'all';
-    /** 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;
-    /** Currently expanded keys (controlled). */
-    expandedKeys?: Iterable<Key>;
-    /** Default expanded keys (uncontrolled). */
-    defaultExpandedKeys?: Iterable<Key>;
-    /** Handler for expansion changes. */
-    onExpandedChange?: (keys: Set<Key>) => void;
+  /** The tree collection builder - receives expanded keys and returns collection. */
+  collectionFactory: (expandedKeys: Set<Key>) => C;
+  /** Keys of disabled items. */
+  disabledKeys?: Iterable<Key>;
+  /** Disabled behavior: 'selection' only or 'all' interactions. */
+  disabledBehavior?: "selection" | "all";
+  /** 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;
+  /** Currently expanded keys (controlled). */
+  expandedKeys?: Iterable<Key>;
+  /** Default expanded keys (uncontrolled). */
+  defaultExpandedKeys?: Iterable<Key>;
+  /** Handler for expansion changes. */
+  onExpandedChange?: (keys: Set<Key>) => void;
 }
 /**
  * Item representation for building tree collections.
  */
 export interface TreeItemData<T = unknown> {
-    /** Unique key for this item. */
-    key: Key;
-    /** The data value for this item. */
-    value: T;
-    /** Text content for accessibility and search. */
-    textValue?: string;
-    /** Child items (makes this item expandable). */
-    children?: TreeItemData<T>[];
-    /** Whether this item is disabled. */
-    isDisabled?: boolean;
+  /** Unique key for this item. */
+  key: Key;
+  /** The data value for this item. */
+  value: T;
+  /** Text content for accessibility and search. */
+  textValue?: string;
+  /** Child items (makes this item expandable). */
+  children?: TreeItemData<T>[];
+  /** Whether this item is disabled. */
+  isDisabled?: boolean;
 }
-//# sourceMappingURL=types.d.ts.map
+//# sourceMappingURL=types.d.ts.map

package/src/tree/types.ts

@@ -3,8 +3,8 @@
  * Based on @react-stately/tree.
  */
 
-import type { Key, FocusStrategy } from '../collections/types';
-import type { GridNode, GridCollection } from '../grid/types';
+import type { Key, FocusStrategy, Selection, SelectionBehavior } from "../collections/types";
+import type { GridNode, GridCollection } from "../grid/types";
 
 /**
  * Represents a node in a tree collection.
@@ -29,7 +29,10 @@ export interface TreeNode<T = unknown> extends GridNode<T> {
  * A collection of tree nodes with tree-specific navigation.
  * Only includes visible nodes (respects expanded state).
  */
-export interface TreeCollection<T = unknown> extends Omit<GridCollection<T>, 'rows' | 'columns' | 'headerRows' | 'columnCount' | 'getCell'> {
+export interface TreeCollection<T = unknown> extends Omit<
+  GridCollection<T>,
+  "rows" | "columns" | "headerRows" | "columnCount" | "getCell"
+> {
   /** All visible rows in the tree (respects expanded state). */
   readonly rows: TreeNode<T>[];
   /** Number of visible rows. */
@@ -78,6 +81,8 @@ export interface TreeState<T, C extends TreeCollection<T> = TreeCollection<T>> {
   readonly collection: C;
   /** Keys of disabled items. */
   readonly disabledKeys: Set<Key>;
+  /** Whether `disabledKeys` applies to all interactions, or only selection. */
+  readonly disabledBehavior: "selection" | "all";
   /** Keys of expanded items. */
   readonly expandedKeys: Set<Key>;
   /** Whether keyboard navigation is disabled. */
@@ -89,9 +94,13 @@ export interface TreeState<T, C extends TreeCollection<T> = TreeCollection<T>> {
   /** Whether the tree is focused. */
   readonly isFocused: boolean;
   /** The selection mode. */
-  readonly selectionMode: 'none' | 'single' | 'multiple';
+  readonly selectionMode: "none" | "single" | "multiple";
+  /** How selection behaves when pressing an item. */
+  readonly selectionBehavior: SelectionBehavior;
+  /** Whether empty selection is disallowed. */
+  readonly disallowEmptySelection: boolean;
   /** The currently selected keys. */
-  readonly selectedKeys: 'all' | Set<Key>;
+  readonly selectedKeys: Selection;
 
   /** Check if a key is selected. */
   isSelected(key: Key): boolean;
@@ -107,6 +116,10 @@ export interface TreeState<T, C extends TreeCollection<T> = TreeCollection<T>> {
   toggleSelection(key: Key): void;
   /** Replace selection with a key. */
   replaceSelection(key: Key): void;
+  /** Set the selected keys directly. */
+  setSelectedKeys(keys: Selection | Iterable<Key>): void;
+  /** Set how selection behaves when pressing an item. */
+  setSelectionBehavior(behavior: SelectionBehavior): void;
   /** Extend selection to a key (shift-click). */
   extendSelection(toKey: Key): void;
   /** Select all visible items. */
@@ -136,19 +149,19 @@ export interface TreeStateOptions<T, C extends TreeCollection<T> = TreeCollectio
   /** Keys of disabled items. */
   disabledKeys?: Iterable<Key>;
   /** Disabled behavior: 'selection' only or 'all' interactions. */
-  disabledBehavior?: 'selection' | 'all';
+  disabledBehavior?: "selection" | "all";
   /** 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?: Selection | Iterable<Key>;
   /** Default selected keys (uncontrolled). */
-  defaultSelectedKeys?: 'all' | Iterable<Key>;
+  defaultSelectedKeys?: Selection | Iterable<Key>;
   /** Handler for selection changes. */
-  onSelectionChange?: (keys: 'all' | Set<Key>) => void;
+  onSelectionChange?: (keys: "all" | Set<Key>) => void;
   /** Currently expanded keys (controlled). */
   expandedKeys?: Iterable<Key>;
   /** Default expanded keys (uncontrolled). */
@@ -162,13 +175,17 @@ export interface TreeStateOptions<T, C extends TreeCollection<T> = TreeCollectio
  */
 export interface TreeItemData<T = unknown> {
   /** Unique key for this item. */
-  key: Key;
+  key?: Key;
+  /** S2/React Aria-compatible unique id alias. */
+  id?: Key;
   /** The data value for this item. */
-  value: T;
+  value?: T;
   /** Text content for accessibility and search. */
   textValue?: string;
   /** Child items (makes this item expandable). */
   children?: TreeItemData<T>[];
+  /** Whether this item has children that may not be loaded yet. */
+  hasChildItems?: boolean;
   /** Whether this item is disabled. */
   isDisabled?: boolean;
 }

package/src/utils/index.d.ts

@@ -1,2 +1,2 @@
-export { access, isAccessor, type MaybeAccessor, type MaybeAccessorValue } from './reactivity';
-//# sourceMappingURL=index.d.ts.map
+export { access, isAccessor, type MaybeAccessor, type MaybeAccessorValue } from "./reactivity";
+//# sourceMappingURL=index.d.ts.map

package/src/utils/index.ts

@@ -1 +1 @@
-export { access, isAccessor, type MaybeAccessor, type MaybeAccessorValue } from './reactivity';
+export { access, isAccessor, type MaybeAccessor, type MaybeAccessorValue } from "./reactivity";

package/src/utils/reactivity.d.ts

@@ -3,7 +3,7 @@
  *
  * Provides type-safe utilities for working with SolidJS reactivity patterns.
  */
-import { Accessor } from 'solid-js';
+import { Accessor } from "solid-js";
 /**
  * A value that may be either a raw value or an accessor function.
  * This is a common pattern in SolidJS for props that may be reactive.
@@ -25,4 +25,4 @@ export type MaybeAccessorValue<T> = T | undefined | Accessor<T | undefined>;
  * Checks if a value is an accessor function.
  */
 export declare function isAccessor<T>(value: MaybeAccessor<T>): value is Accessor<T>;
-//# sourceMappingURL=reactivity.d.ts.map
+//# sourceMappingURL=reactivity.d.ts.map

package/src/utils/reactivity.ts

@@ -4,7 +4,7 @@
  * Provides type-safe utilities for working with SolidJS reactivity patterns.
  */
 
-import { Accessor } from 'solid-js';
+import { Accessor } from "solid-js";
 
 /**
  * A value that may be either a raw value or an accessor function.
@@ -20,7 +20,7 @@ export type MaybeAccessor<T> = T | Accessor<T>;
  * @param value - The value or accessor to unwrap.
  */
 export function access<T>(value: MaybeAccessor<T>): T {
-  return typeof value === 'function' ? (value as Accessor<T>)() : value;
+  return typeof value === "function" ? (value as Accessor<T>)() : value;
 }
 
 /**
@@ -32,5 +32,5 @@ export type MaybeAccessorValue<T> = T | undefined | Accessor<T | undefined>;
  * Checks if a value is an accessor function.
  */
 export function isAccessor<T>(value: MaybeAccessor<T>): value is Accessor<T> {
-  return typeof value === 'function';
+  return typeof value === "function";
 }