@proyecto-viviana/solid-stately 0.0.6 → 0.1.0

package/src/collections/createSelectionState.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Selection state management for collections.
+ * Based on @react-stately/selection.
+ */
+import { type Accessor } from 'solid-js';
+import { type MaybeAccessor } from '../utils';
+import type { Collection, DisabledBehavior, Key, Selection, SelectionBehavior, SelectionMode } from './types';
+export interface SelectionStateProps {
+    /** The selection mode. */
+    selectionMode?: SelectionMode;
+    /** How selection behaves on interaction. */
+    selectionBehavior?: SelectionBehavior;
+    /** 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: Selection) => void;
+    /** Keys of disabled items. */
+    disabledKeys?: Iterable<Key>;
+    /** How disabled keys behave. */
+    disabledBehavior?: DisabledBehavior;
+    /** Whether to allow duplicate selection events. */
+    allowDuplicateSelectionEvents?: boolean;
+}
+export interface SelectionState {
+    /** The selection mode. */
+    readonly selectionMode: Accessor<SelectionMode>;
+    /** The selection behavior. */
+    readonly selectionBehavior: Accessor<SelectionBehavior>;
+    /** Whether empty selection is disallowed. */
+    readonly disallowEmptySelection: Accessor<boolean>;
+    /** The currently selected keys. */
+    readonly selectedKeys: Accessor<Selection>;
+    /** Set of disabled keys. */
+    readonly disabledKeys: Accessor<Set<Key>>;
+    /** How disabled keys behave. */
+    readonly disabledBehavior: Accessor<DisabledBehavior>;
+    /** Whether the selection is empty. */
+    readonly isEmpty: Accessor<boolean>;
+    /** Whether all items are selected. */
+    readonly isSelectAll: Accessor<boolean>;
+    /** Check if a key is selected. */
+    isSelected(key: Key): boolean;
+    /** Check if a key is disabled. */
+    isDisabled(key: Key): boolean;
+    /** Set the selection behavior. */
+    setSelectionBehavior(behavior: SelectionBehavior): void;
+    /** Toggle selection for a key. */
+    toggleSelection(key: Key): void;
+    /** Replace selection with a single key. */
+    replaceSelection(key: Key): void;
+    /** Set multiple selected keys. */
+    setSelectedKeys(keys: Iterable<Key>): void;
+    /** Select all items. */
+    selectAll(): void;
+    /** Clear all selection. */
+    clearSelection(): void;
+    /** Toggle between select all and clear. */
+    toggleSelectAll(): void;
+    /** Extend selection to a key (for shift-click). */
+    extendSelection(toKey: Key, collection: Collection): void;
+    /** Select a key based on interaction. */
+    select(key: Key, e?: {
+        shiftKey?: boolean;
+        ctrlKey?: boolean;
+        metaKey?: boolean;
+    }, collection?: Collection): void;
+}
+/**
+ * Creates selection state for a collection.
+ */
+export declare function createSelectionState(props?: MaybeAccessor<SelectionStateProps>): SelectionState;
+//# sourceMappingURL=createSelectionState.d.ts.map

package/src/collections/createSelectionState.d.ts.map

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

package/src/collections/createSelectionState.ts

@@ -0,0 +1,336 @@
+/**
+ * Selection state management for collections.
+ * Based on @react-stately/selection.
+ */
+
+import { createSignal, type Accessor } from 'solid-js';
+import { access, type MaybeAccessor } from '../utils';
+import type {
+  Collection,
+  DisabledBehavior,
+  FocusStrategy,
+  Key,
+  Selection,
+  SelectionBehavior,
+  SelectionMode,
+} from './types';
+
+export interface SelectionStateProps {
+  /** The selection mode. */
+  selectionMode?: SelectionMode;
+  /** How selection behaves on interaction. */
+  selectionBehavior?: SelectionBehavior;
+  /** 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: Selection) => void;
+  /** Keys of disabled items. */
+  disabledKeys?: Iterable<Key>;
+  /** How disabled keys behave. */
+  disabledBehavior?: DisabledBehavior;
+  /** Whether to allow duplicate selection events. */
+  allowDuplicateSelectionEvents?: boolean;
+}
+
+export interface SelectionState {
+  /** The selection mode. */
+  readonly selectionMode: Accessor<SelectionMode>;
+  /** The selection behavior. */
+  readonly selectionBehavior: Accessor<SelectionBehavior>;
+  /** Whether empty selection is disallowed. */
+  readonly disallowEmptySelection: Accessor<boolean>;
+  /** The currently selected keys. */
+  readonly selectedKeys: Accessor<Selection>;
+  /** Set of disabled keys. */
+  readonly disabledKeys: Accessor<Set<Key>>;
+  /** How disabled keys behave. */
+  readonly disabledBehavior: Accessor<DisabledBehavior>;
+  /** Whether the selection is empty. */
+  readonly isEmpty: Accessor<boolean>;
+  /** Whether all items are selected. */
+  readonly isSelectAll: Accessor<boolean>;
+  /** Check if a key is selected. */
+  isSelected(key: Key): boolean;
+  /** Check if a key is disabled. */
+  isDisabled(key: Key): boolean;
+  /** Set the selection behavior. */
+  setSelectionBehavior(behavior: SelectionBehavior): void;
+  /** Toggle selection for a key. */
+  toggleSelection(key: Key): void;
+  /** Replace selection with a single key. */
+  replaceSelection(key: Key): void;
+  /** Set multiple selected keys. */
+  setSelectedKeys(keys: Iterable<Key>): void;
+  /** Select all items. */
+  selectAll(): void;
+  /** Clear all selection. */
+  clearSelection(): void;
+  /** Toggle between select all and clear. */
+  toggleSelectAll(): void;
+  /** Extend selection to a key (for shift-click). */
+  extendSelection(toKey: Key, collection: Collection): void;
+  /** Select a key based on interaction. */
+  select(key: Key, e?: { shiftKey?: boolean; ctrlKey?: boolean; metaKey?: boolean }, collection?: Collection): void;
+}
+
+/**
+ * Creates selection state for a collection.
+ */
+export function createSelectionState(
+  props: MaybeAccessor<SelectionStateProps> = {}
+): SelectionState {
+  const getProps = () => access(props);
+
+  // Selection behavior state
+  const [internalBehavior, setInternalBehavior] = createSignal<SelectionBehavior>('toggle');
+
+  // Internal selection state
+  const [internalSelectedKeys, setInternalSelectedKeys] = createSignal<Selection>(
+    getInitialSelection(getProps().defaultSelectedKeys)
+  );
+
+  // Track anchor for range selection
+  const [anchorKey, setAnchorKey] = createSignal<Key | null>(null);
+
+  // Computed values
+  const selectionMode: Accessor<SelectionMode> = () => getProps().selectionMode ?? 'none';
+
+  const selectionBehavior: Accessor<SelectionBehavior> = () => {
+    return getProps().selectionBehavior ?? internalBehavior();
+  };
+
+  const disallowEmptySelection: Accessor<boolean> = () => {
+    return getProps().disallowEmptySelection ?? false;
+  };
+
+  const selectedKeys: Accessor<Selection> = () => {
+    const p = getProps();
+    if (p.selectedKeys !== undefined) {
+      return normalizeSelection(p.selectedKeys);
+    }
+    return internalSelectedKeys();
+  };
+
+  const disabledKeys: Accessor<Set<Key>> = () => {
+    const keys = getProps().disabledKeys;
+    return keys ? new Set(keys) : new Set();
+  };
+
+  const disabledBehavior: Accessor<DisabledBehavior> = () => {
+    return getProps().disabledBehavior ?? 'all';
+  };
+
+  const isEmpty: Accessor<boolean> = () => {
+    const keys = selectedKeys();
+    return keys !== 'all' && keys.size === 0;
+  };
+
+  const isSelectAll: Accessor<boolean> = () => {
+    return selectedKeys() === 'all';
+  };
+
+  // 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: Selection) => {
+    const p = getProps();
+
+    // Controlled mode
+    if (p.selectedKeys !== undefined) {
+      p.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 || p.allowDuplicateSelectionEvents) {
+      setInternalSelectedKeys(newSelection);
+      p.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 collection
+      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 setSelectedKeys = (keys: Iterable<Key>) => {
+    const filtered = [...keys].filter((k) => !isDisabled(k));
+    updateSelection(new Set(filtered));
+  };
+
+  const selectAll = () => {
+    if (selectionMode() !== 'multiple') return;
+    updateSelection('all');
+  };
+
+  const clearSelection = () => {
+    if (disallowEmptySelection()) return;
+    updateSelection(new Set());
+  };
+
+  const toggleSelectAll = () => {
+    if (selectionMode() !== 'multiple') return;
+
+    if (isSelectAll()) {
+      clearSelection();
+    } else {
+      selectAll();
+    }
+  };
+
+  const extendSelection = (toKey: Key, collection: Collection) => {
+    if (isDisabled(toKey)) return;
+    if (selectionMode() !== 'multiple') {
+      replaceSelection(toKey);
+      return;
+    }
+
+    const anchor = anchorKey();
+    if (!anchor) {
+      replaceSelection(toKey);
+      return;
+    }
+
+    // Get keys between anchor and toKey
+    const keys = [...collection.getKeys()];
+    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 select = (
+    key: Key,
+    e?: { shiftKey?: boolean; ctrlKey?: boolean; metaKey?: boolean },
+    collection?: Collection
+  ) => {
+    if (isDisabled(key)) return;
+    if (selectionMode() === 'none') return;
+
+    const mode = selectionMode();
+    const behavior = selectionBehavior();
+
+    if (mode === 'single') {
+      if (behavior === 'replace' || !isSelected(key)) {
+        replaceSelection(key);
+      } else if (!disallowEmptySelection()) {
+        clearSelection();
+      }
+      return;
+    }
+
+    // Multiple selection
+    if (e?.shiftKey && collection) {
+      extendSelection(key, collection);
+      return;
+    }
+
+    if (e?.ctrlKey || e?.metaKey || behavior === 'toggle') {
+      toggleSelection(key);
+    } else {
+      replaceSelection(key);
+    }
+  };
+
+  const setSelectionBehavior = (behavior: SelectionBehavior) => {
+    setInternalBehavior(behavior);
+  };
+
+  return {
+    selectionMode,
+    selectionBehavior,
+    disallowEmptySelection,
+    selectedKeys,
+    disabledKeys,
+    disabledBehavior,
+    isEmpty,
+    isSelectAll,
+    isSelected,
+    isDisabled,
+    setSelectionBehavior,
+    toggleSelection,
+    replaceSelection,
+    setSelectedKeys,
+    selectAll,
+    clearSelection,
+    toggleSelectAll,
+    extendSelection,
+    select,
+  };
+}
+
+// Helper functions
+function getInitialSelection(defaultKeys?: 'all' | Iterable<Key>): Selection {
+  if (defaultKeys === undefined) return new Set();
+  return normalizeSelection(defaultKeys);
+}
+
+function normalizeSelection(keys: 'all' | Iterable<Key>): Selection {
+  if (keys === 'all') return 'all';
+  return new Set(keys);
+}

package/src/collections/index.d.ts

@@ -0,0 +1,6 @@
+export type { Key, SelectionMode, SelectionBehavior, Selection, FocusStrategy, DisabledBehavior, CollectionNode, Collection, ItemProps, SectionProps, CollectionBase, SingleSelection, MultipleSelection, } from './types';
+export { ListCollection, createListCollection } from './ListCollection';
+export { createSelectionState, type SelectionStateProps, type SelectionState, } from './createSelectionState';
+export { createListState, createSingleSelectListState, type ListStateProps, type ListState, type SingleSelectListStateProps, type SingleSelectListState, } from './createListState';
+export { createMenuState, createMenuTriggerState, type MenuStateProps, type MenuState, type MenuTriggerStateProps, type MenuTriggerState, } from './createMenuState';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,GAAG,EACH,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,SAAS,EACT,YAAY,EACZ,cAAc,EACd,eAAe,EACf,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGxE,OAAO,EACL,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACpB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,eAAe,EACf,2BAA2B,EAC3B,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC"}

package/src/collections/index.ts

@@ -0,0 +1,46 @@
+// Types
+export type {
+  Key,
+  SelectionMode,
+  SelectionBehavior,
+  Selection,
+  FocusStrategy,
+  DisabledBehavior,
+  CollectionNode,
+  Collection,
+  ItemProps,
+  SectionProps,
+  CollectionBase,
+  SingleSelection,
+  MultipleSelection,
+} from './types';
+
+// List Collection
+export { ListCollection, createListCollection } from './ListCollection';
+
+// Selection State
+export {
+  createSelectionState,
+  type SelectionStateProps,
+  type SelectionState,
+} from './createSelectionState';
+
+// List State
+export {
+  createListState,
+  createSingleSelectListState,
+  type ListStateProps,
+  type ListState,
+  type SingleSelectListStateProps,
+  type SingleSelectListState,
+} from './createListState';
+
+// Menu State
+export {
+  createMenuState,
+  createMenuTriggerState,
+  type MenuStateProps,
+  type MenuState,
+  type MenuTriggerStateProps,
+  type MenuTriggerState,
+} from './createMenuState';

package/src/collections/types.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Core types for collection state management.
+ * Simplified from @react-stately/collections for SolidJS.
+ */
+import type { JSX } from 'solid-js';
+/** A unique identifier for an item in a collection. */
+export type Key = string | number;
+/** The type of selection allowed in a collection. */
+export type SelectionMode = 'none' | 'single' | 'multiple';
+/** How selection behaves when clicking on items. */
+export type SelectionBehavior = 'toggle' | 'replace';
+/** Represents the current selection state. */
+export type Selection = 'all' | Set<Key>;
+/** Strategy for focusing first or last item. */
+export type FocusStrategy = 'first' | 'last';
+/** Whether disabled keys affect selection, actions, or both. */
+export type DisabledBehavior = 'selection' | 'all';
+/**
+ * Represents a node in a collection (item or section).
+ */
+export interface CollectionNode<T = unknown> {
+    /** The type of node: 'item' or 'section'. */
+    type: 'item' | 'section';
+    /** 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). */
+    rendered: JSX.Element;
+    /** 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, if any. */
+    childNodes: CollectionNode<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>;
+}
+/**
+ * A collection of nodes with methods to traverse and query.
+ */
+export interface Collection<T = unknown> extends Iterable<CollectionNode<T>> {
+    /** The number of items in the collection. */
+    readonly size: number;
+    /** Get all keys in the collection. */
+    getKeys(): Iterable<Key>;
+    /** Get a node by its key. */
+    getItem(key: Key): CollectionNode<T> | null;
+    /** Get a node by index. */
+    at(index: number): CollectionNode<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<CollectionNode<T>>;
+    /** Get the text value for a key. */
+    getTextValue(key: Key): string;
+}
+/**
+ * Props for items in a collection.
+ */
+export interface ItemProps<T = unknown> {
+    /** Unique key for the item. Required if items is used for dynamic collections. */
+    key?: Key;
+    /** The text value for accessibility and typeahead. If not provided, derived from children. */
+    textValue?: string;
+    /** Whether the item is disabled. */
+    isDisabled?: boolean;
+    /** The rendered content of the item. */
+    children?: JSX.Element;
+    /** ARIA label for the item. */
+    'aria-label'?: string;
+    /** The original value for dynamic collections. */
+    value?: T;
+}
+/**
+ * Props for sections in a collection.
+ */
+export interface SectionProps<T = unknown> {
+    /** Unique key for the section. */
+    key?: Key;
+    /** The section header/title. */
+    title?: JSX.Element;
+    /** ARIA label for the section. */
+    'aria-label'?: string;
+    /** The items in this section. */
+    children?: JSX.Element;
+    /** Items for dynamic rendering. */
+    items?: Iterable<T>;
+}
+/**
+ * Base props for components that use collections.
+ */
+export interface CollectionBase<T = unknown> {
+    /** The items in the collection (for dynamic rendering). */
+    items?: Iterable<T>;
+    /** The children (static items or render function). */
+    children?: JSX.Element | ((item: T) => JSX.Element);
+    /** Keys of disabled items. */
+    disabledKeys?: Iterable<Key>;
+}
+/**
+ * Props for single selection.
+ */
+export interface SingleSelection {
+    /** Whether empty selection is allowed. */
+    disallowEmptySelection?: boolean;
+    /** The currently selected key (controlled). */
+    selectedKey?: Key | null;
+    /** The default selected key (uncontrolled). */
+    defaultSelectedKey?: Key;
+    /** Handler called when selection changes. */
+    onSelectionChange?: (key: Key | null) => void;
+}
+/**
+ * Props for multiple selection.
+ */
+export interface MultipleSelection {
+    /** The selection mode. */
+    selectionMode?: SelectionMode;
+    /** Whether empty selection is allowed. */
+    disallowEmptySelection?: boolean;
+    /** The currently selected keys (controlled). */
+    selectedKeys?: 'all' | Iterable<Key>;
+    /** The default selected keys (uncontrolled). */
+    defaultSelectedKeys?: 'all' | Iterable<Key>;
+    /** Handler called when selection changes. */
+    onSelectionChange?: (keys: Selection) => void;
+    /** Keys of disabled items. */
+    disabledKeys?: Iterable<Key>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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