@proyecto-viviana/solid-stately 0.2.2 → 0.2.3

package/src/grid/createGridState.ts

@@ -0,0 +1,327 @@
+/**
+ * Grid state management for Table and GridList components.
+ * Based on @react-stately/grid/useGridState.
+ */
+
+import { createSignal, createEffect, createMemo, on, type Accessor } from 'solid-js';
+import type {
+  GridState,
+  GridStateOptions,
+  GridCollection,
+  GridNode,
+} from './types';
+import type { Key, FocusStrategy } from '../collections/types';
+
+/**
+ * Creates state management for a grid component.
+ * Handles row selection, focus management, and keyboard navigation state.
+ */
+export function createGridState<T extends object, C extends GridCollection<T> = GridCollection<T>>(
+  options: Accessor<GridStateOptions<T, C>>
+): GridState<T, C> {
+  const getOptions = () => options();
+
+  // Disabled keys as a Set
+  const disabledKeys = createMemo(() => {
+    const keys = getOptions().disabledKeys;
+    return keys ? new Set(keys) : new Set<Key>();
+  });
+
+  // Focus state
+  const [isFocused, setIsFocused] = createSignal(false);
+  const [focusedKey, setFocusedKeyInternal] = createSignal<Key | null>(null);
+  const [childFocusStrategy, setChildFocusStrategy] = createSignal<FocusStrategy | null>(null);
+  const [isKeyboardNavigationDisabled, setKeyboardNavigationDisabled] = createSignal(false);
+
+  // Selection state
+  const [internalSelectedKeys, setInternalSelectedKeys] = createSignal<'all' | Set<Key>>(
+    getInitialSelection(getOptions().defaultSelectedKeys)
+  );
+  const [anchorKey, setAnchorKey] = createSignal<Key | null>(null);
+
+  // Computed selection
+  const selectedKeys = createMemo(() => {
+    const opts = getOptions();
+    if (opts.selectedKeys !== undefined) {
+      return normalizeSelection(opts.selectedKeys);
+    }
+    return internalSelectedKeys();
+  });
+
+  const selectionMode = createMemo(() => getOptions().selectionMode ?? 'none');
+  const selectionBehavior = createMemo(() => getOptions().selectionBehavior ?? 'toggle');
+  const disallowEmptySelection = createMemo(() => getOptions().disallowEmptySelection ?? false);
+
+  // Focus mode handling
+  const focusMode = createMemo(() => getOptions().focusMode ?? 'row');
+
+  // Set focused key with focus mode awareness
+  const setFocusedKey = (key: Key | null, strategy: FocusStrategy = 'first') => {
+    const opts = getOptions();
+    const collection = opts.collection;
+
+    // If focusMode is cell and an item is focused, focus a child cell instead
+    if (focusMode() === 'cell' && key != null) {
+      const item = collection.getItem(key);
+      if (item?.type === 'item') {
+        const children = [...collection.getChildren(key)];
+        if (strategy === 'last') {
+          key = children[children.length - 1]?.key ?? key;
+        } else {
+          key = children[0]?.key ?? key;
+        }
+      }
+    }
+
+    setFocusedKeyInternal(key);
+    setChildFocusStrategy(strategy);
+  };
+
+  // Reset focused key if the item is deleted from the collection
+  let cachedCollection: C | null = null;
+
+  createEffect(
+    on(
+      () => getOptions().collection,
+      (collection) => {
+        const currentFocusedKey = focusedKey();
+
+        if (currentFocusedKey != null && cachedCollection && !collection.getItem(currentFocusedKey)) {
+          // The focused item was deleted, find a new one to focus
+          const node = cachedCollection.getItem(currentFocusedKey);
+          const parentNode =
+            node?.parentKey != null &&
+            (node.type === 'cell' || node.type === 'rowheader' || node.type === 'column')
+              ? cachedCollection.getItem(node.parentKey)
+              : node;
+
+          if (!parentNode) {
+            setFocusedKeyInternal(null);
+            cachedCollection = collection;
+            return;
+          }
+
+          const cachedRows = cachedCollection.rows;
+          const rows = collection.rows;
+          const diff = cachedRows.length - rows.length;
+
+          let index = Math.min(
+            diff > 1 ? Math.max(parentNode.index - diff + 1, 0) : parentNode.index,
+            rows.length - 1
+          );
+
+          let newRow: GridNode<T> | null = null;
+          while (index >= 0) {
+            const row = rows[index];
+            if (!disabledKeys().has(row.key) && row.type !== 'headerrow') {
+              newRow = row;
+              break;
+            }
+            // Find next, not disabled row
+            if (index < rows.length - 1) {
+              index++;
+            } else {
+              // Otherwise, find previous, not disabled row
+              if (index > parentNode.index) {
+                index = parentNode.index;
+              }
+              index--;
+            }
+          }
+
+          if (newRow) {
+            const childNodes = newRow.hasChildNodes ? [...collection.getChildren(newRow.key)] : [];
+            const keyToFocus =
+              newRow.hasChildNodes &&
+              parentNode !== node &&
+              node &&
+              node.index < childNodes.length
+                ? childNodes[node.index].key
+                : newRow.key;
+            setFocusedKeyInternal(keyToFocus);
+          } else {
+            setFocusedKeyInternal(null);
+          }
+        }
+
+        cachedCollection = collection;
+      }
+    )
+  );
+
+  // Selection methods
+  const isSelected = (key: Key): boolean => {
+    const keys = selectedKeys();
+    if (keys === 'all') return true;
+    return keys.has(key);
+  };
+
+  const isDisabled = (key: Key): boolean => {
+    return disabledKeys().has(key);
+  };
+
+  const updateSelection = (newSelection: 'all' | Set<Key>) => {
+    const opts = getOptions();
+
+    // Controlled mode
+    if (opts.selectedKeys !== undefined) {
+      opts.onSelectionChange?.(newSelection);
+      return;
+    }
+
+    // Uncontrolled mode
+    const current = internalSelectedKeys();
+    const isDifferent =
+      current === 'all' ||
+      newSelection === 'all' ||
+      current.size !== (newSelection as Set<Key>).size ||
+      ![...current].every((k) => (newSelection as Set<Key>).has(k));
+
+    if (isDifferent) {
+      setInternalSelectedKeys(newSelection);
+      opts.onSelectionChange?.(newSelection);
+    }
+  };
+
+  const toggleSelection = (key: Key) => {
+    if (isDisabled(key)) return;
+    if (selectionMode() === 'none') return;
+
+    const current = selectedKeys();
+
+    if (selectionMode() === 'single') {
+      if (isSelected(key) && !disallowEmptySelection()) {
+        updateSelection(new Set());
+      } else {
+        updateSelection(new Set([key]));
+      }
+      return;
+    }
+
+    // Multiple selection
+    if (current === 'all') {
+      // Can't toggle when all selected without knowing all keys
+      return;
+    }
+
+    const newSelection = new Set(current);
+    if (newSelection.has(key)) {
+      if (newSelection.size > 1 || !disallowEmptySelection()) {
+        newSelection.delete(key);
+      }
+    } else {
+      newSelection.add(key);
+    }
+
+    updateSelection(newSelection);
+    setAnchorKey(key);
+  };
+
+  const replaceSelection = (key: Key) => {
+    if (isDisabled(key)) return;
+    if (selectionMode() === 'none') return;
+
+    updateSelection(new Set([key]));
+    setAnchorKey(key);
+  };
+
+  const extendSelection = (toKey: Key) => {
+    if (isDisabled(toKey)) return;
+    if (selectionMode() !== 'multiple') {
+      replaceSelection(toKey);
+      return;
+    }
+
+    const anchor = anchorKey();
+    if (!anchor) {
+      replaceSelection(toKey);
+      return;
+    }
+
+    const collection = getOptions().collection;
+    const rows = collection.rows.filter((r) => r.type === 'item');
+    const keys = rows.map((r) => r.key);
+    const anchorIndex = keys.indexOf(anchor);
+    const toIndex = keys.indexOf(toKey);
+
+    if (anchorIndex === -1 || toIndex === -1) {
+      replaceSelection(toKey);
+      return;
+    }
+
+    const start = Math.min(anchorIndex, toIndex);
+    const end = Math.max(anchorIndex, toIndex);
+    const rangeKeys = keys.slice(start, end + 1).filter((k) => !isDisabled(k));
+
+    updateSelection(new Set(rangeKeys));
+  };
+
+  const selectAll = () => {
+    if (selectionMode() !== 'multiple') return;
+    updateSelection('all');
+  };
+
+  const clearSelection = () => {
+    if (disallowEmptySelection()) return;
+    updateSelection(new Set());
+  };
+
+  const toggleSelectAll = () => {
+    if (selectionMode() !== 'multiple') return;
+
+    if (selectedKeys() === 'all') {
+      clearSelection();
+    } else {
+      selectAll();
+    }
+  };
+
+  return {
+    get collection() {
+      return getOptions().collection;
+    },
+    get disabledKeys() {
+      return disabledKeys();
+    },
+    get isKeyboardNavigationDisabled() {
+      return isKeyboardNavigationDisabled();
+    },
+    get focusedKey() {
+      return focusedKey();
+    },
+    get childFocusStrategy() {
+      return childFocusStrategy();
+    },
+    get isFocused() {
+      return isFocused();
+    },
+    get selectionMode() {
+      return selectionMode();
+    },
+    get selectedKeys() {
+      return selectedKeys();
+    },
+    isSelected,
+    isDisabled,
+    setFocusedKey,
+    setFocused: setIsFocused,
+    toggleSelection,
+    replaceSelection,
+    extendSelection,
+    selectAll,
+    clearSelection,
+    toggleSelectAll,
+    setKeyboardNavigationDisabled,
+  };
+}
+
+// Helper functions
+function getInitialSelection(defaultKeys?: 'all' | Iterable<Key>): 'all' | Set<Key> {
+  if (defaultKeys === undefined) return new Set();
+  return normalizeSelection(defaultKeys);
+}
+
+function normalizeSelection(keys: 'all' | Iterable<Key>): 'all' | Set<Key> {
+  if (keys === 'all') return 'all';
+  return new Set(keys);
+}

package/src/grid/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Grid state management module.
+ * Provides state hooks for Table and GridList components.
+ */
+export { createGridState } from './createGridState';
+export type { GridState, GridStateOptions, GridCollection, GridNode, GridNodeType, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/src/grid/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,QAAQ,EACR,YAAY,GACb,MAAM,SAAS,CAAC"}

package/src/grid/index.ts

@@ -0,0 +1,13 @@
+/**
+ * Grid state management module.
+ * Provides state hooks for Table and GridList components.
+ */
+
+export { createGridState } from './createGridState';
+export type {
+  GridState,
+  GridStateOptions,
+  GridCollection,
+  GridNode,
+  GridNodeType,
+} from './types';

package/src/grid/types.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Grid collection types for Table and GridList components.
+ * Based on @react-types/grid.
+ */
+import type { Key, FocusStrategy } from '../collections/types';
+/**
+ * Represents the type of a grid node.
+ */
+export type GridNodeType = 'item' | 'cell' | 'column' | 'rowheader' | 'headerrow' | 'section' | 'placeholder';
+/**
+ * Represents a node in a grid collection.
+ */
+export interface GridNode<T = unknown> {
+    /** The type of grid node. */
+    type: GridNodeType;
+    /** A unique key for the node. */
+    key: Key;
+    /** The original value/data for this node. */
+    value: T | null;
+    /** The text content for accessibility and typeahead. */
+    textValue: string;
+    /** The rendered content (JSX) - optional for programmatic nodes. */
+    rendered?: unknown;
+    /** The level of nesting (0 for top-level). */
+    level: number;
+    /** The index within the parent. */
+    index: number;
+    /** The key of the parent node, if any. */
+    parentKey?: Key | null;
+    /** Whether this node has child nodes. */
+    hasChildNodes: boolean;
+    /** Child nodes (cells for rows, rows for sections). */
+    childNodes: GridNode<T>[];
+    /** Whether this item is disabled. */
+    isDisabled?: boolean;
+    /** ARIA label for this node. */
+    'aria-label'?: string;
+    /** Additional props for the node. */
+    props?: Record<string, unknown>;
+    /** Column index for cells. */
+    column?: number;
+    /** Column span for cells. */
+    colspan?: number;
+    /** Row index. */
+    rowIndex?: number;
+    /** Whether this row can be expanded (for tree grids). */
+    isExpandable?: boolean;
+    /** Whether this row is expanded. */
+    isExpanded?: boolean;
+}
+/**
+ * A collection of grid nodes with grid-specific navigation.
+ */
+export interface GridCollection<T = unknown> {
+    /** The number of items in the collection. */
+    readonly size: number;
+    /** All rows in the grid (including header rows). */
+    readonly rows: GridNode<T>[];
+    /** All column definitions. */
+    readonly columns: GridNode<T>[];
+    /** Number of header rows. */
+    readonly headerRows: GridNode<T>[];
+    /** Number of body rows (excluding headers). */
+    readonly rowCount: number;
+    /** Number of columns. */
+    readonly columnCount: number;
+    /** Get all keys in the collection. */
+    getKeys(): Iterable<Key>;
+    /** Get a node by its key. */
+    getItem(key: Key): GridNode<T> | null;
+    /** Get a node by index. */
+    at(index: number): GridNode<T> | null;
+    /** Get the key before the given key. */
+    getKeyBefore(key: Key): Key | null;
+    /** Get the key after the given key. */
+    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<GridNode<T>>;
+    /** Get the text value for a key. */
+    getTextValue(key: Key): string;
+    /** Get a cell by row and column key. */
+    getCell(rowKey: Key, columnKey: Key): GridNode<T> | null;
+    /** Iterator over all nodes. */
+    [Symbol.iterator](): Iterator<GridNode<T>>;
+}
+/**
+ * State for a grid component.
+ */
+export interface GridState<T, C extends GridCollection<T> = GridCollection<T>> {
+    /** The grid collection. */
+    readonly collection: C;
+    /** Keys of disabled rows. */
+    readonly disabledKeys: 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 grid 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;
+    /** 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 rows. */
+    selectAll(): void;
+    /** Clear selection. */
+    clearSelection(): void;
+    /** Toggle select all. */
+    toggleSelectAll(): void;
+    /** Set keyboard navigation disabled. */
+    setKeyboardNavigationDisabled(isDisabled: boolean): void;
+}
+/**
+ * Options for creating grid state.
+ */
+export interface GridStateOptions<T, C extends GridCollection<T> = GridCollection<T>> {
+    /** The grid 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;
+}
+//# sourceMappingURL=types.d.ts.map

package/src/grid/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"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"}

package/src/grid/types.ts

@@ -0,0 +1,179 @@
+/**
+ * Grid collection types for Table and GridList components.
+ * Based on @react-types/grid.
+ */
+
+import type { Key, FocusStrategy } 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
+  | 'placeholder';   // A placeholder (e.g., empty row)
+
+/**
+ * Represents a node in a grid collection.
+ */
+export interface GridNode<T = unknown> {
+  /** The type of grid node. */
+  type: GridNodeType;
+  /** A unique key for the node. */
+  key: Key;
+  /** The original value/data for this node. */
+  value: T | null;
+  /** The text content for accessibility and typeahead. */
+  textValue: string;
+  /** The rendered content (JSX) - optional for programmatic nodes. */
+  rendered?: unknown;
+  /** The level of nesting (0 for top-level). */
+  level: number;
+  /** The index within the parent. */
+  index: number;
+  /** The key of the parent node, if any. */
+  parentKey?: Key | null;
+  /** Whether this node has child nodes. */
+  hasChildNodes: boolean;
+  /** Child nodes (cells for rows, rows for sections). */
+  childNodes: GridNode<T>[];
+  /** Whether this item is disabled. */
+  isDisabled?: boolean;
+  /** ARIA label for this node. */
+  'aria-label'?: string;
+  /** Additional props for the node. */
+  props?: Record<string, unknown>;
+  /** Column index for cells. */
+  column?: number;
+  /** Column span for cells. */
+  colspan?: number;
+  /** Row index. */
+  rowIndex?: number;
+  /** Whether this row can be expanded (for tree grids). */
+  isExpandable?: boolean;
+  /** Whether this row is expanded. */
+  isExpanded?: boolean;
+}
+
+/**
+ * A collection of grid nodes with grid-specific navigation.
+ */
+export interface GridCollection<T = unknown> {
+  /** The number of items in the collection. */
+  readonly size: number;
+  /** All rows in the grid (including header rows). */
+  readonly rows: GridNode<T>[];
+  /** All column definitions. */
+  readonly columns: GridNode<T>[];
+  /** Number of header rows. */
+  readonly headerRows: GridNode<T>[];
+  /** Number of body rows (excluding headers). */
+  readonly rowCount: number;
+  /** Number of columns. */
+  readonly columnCount: number;
+
+  /** Get all keys in the collection. */
+  getKeys(): Iterable<Key>;
+
+  /** Get a node by its key. */
+  getItem(key: Key): GridNode<T> | null;
+
+  /** Get a node by index. */
+  at(index: number): GridNode<T> | null;
+
+  /** Get the key before the given key. */
+  getKeyBefore(key: Key): Key | null;
+
+  /** Get the key after the given key. */
+  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<GridNode<T>>;
+
+  /** Get the text value for a key. */
+  getTextValue(key: Key): string;
+
+  /** Get a cell by row and column key. */
+  getCell(rowKey: Key, columnKey: Key): GridNode<T> | null;
+
+  /** Iterator over all nodes. */
+  [Symbol.iterator](): Iterator<GridNode<T>>;
+}
+
+/**
+ * State for a grid component.
+ */
+export interface GridState<T, C extends GridCollection<T> = GridCollection<T>> {
+  /** The grid collection. */
+  readonly collection: C;
+  /** Keys of disabled rows. */
+  readonly disabledKeys: 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 grid 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;
+  /** 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 rows. */
+  selectAll(): void;
+  /** Clear selection. */
+  clearSelection(): void;
+  /** Toggle select all. */
+  toggleSelectAll(): void;
+  /** Set keyboard navigation disabled. */
+  setKeyboardNavigationDisabled(isDisabled: boolean): void;
+}
+
+/**
+ * Options for creating grid state.
+ */
+export interface GridStateOptions<T, C extends GridCollection<T> = GridCollection<T>> {
+  /** The grid 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;
+}