@proyecto-viviana/solid-stately 0.2.7 → 0.3.0

package/src/collections/createMenuState.d.ts

@@ -2,49 +2,54 @@
  * State management for menu components.
  * Based on @react-stately/menu.
  */
-import { type MaybeAccessor } from '../utils';
-import { type ListState, type ListStateProps } from './createListState';
-import type { Key } from './types';
-export interface MenuStateProps<T = unknown> extends Omit<ListStateProps<T>, 'selectionMode' | 'disallowEmptySelection'> {
-    /** Handler called when an item is activated (pressed). */
-    onAction?: (key: Key) => void;
-    /** Handler called when the menu should close. */
-    onClose?: () => void;
+import { type MaybeAccessor } from "../utils";
+import { type ListState, type ListStateProps } from "./createListState";
+import type { Key } from "./types";
+export interface MenuStateProps<T = unknown> extends Omit<
+  ListStateProps<T>,
+  "selectionMode" | "disallowEmptySelection"
+> {
+  /** Handler called when an item is activated (pressed). */
+  onAction?: (key: Key) => void;
+  /** Handler called when the menu should close. */
+  onClose?: () => void;
 }
 export interface MenuState<T = unknown> extends ListState<T> {
-    /** Close the menu. */
-    close(): void;
+  /** Close the menu. */
+  close(): void;
 }
 /**
  * Creates state for a menu component.
  * Menus are single-select lists that support actions.
  */
-export declare function createMenuState<T = unknown>(props: MaybeAccessor<MenuStateProps<T>>): MenuState<T>;
+export declare function createMenuState<T = unknown>(
+  props: MaybeAccessor<MenuStateProps<T>>,
+): MenuState<T>;
 export interface MenuTriggerStateProps {
-    /** Whether the menu is open (controlled). */
-    isOpen?: boolean;
-    /** Default open state (uncontrolled). */
-    defaultOpen?: boolean;
-    /** Handler called when the open state changes. */
-    onOpenChange?: (isOpen: boolean) => void;
+  /** Whether the menu is open (controlled). */
+  isOpen?: boolean;
+  /** Default open state (uncontrolled). */
+  defaultOpen?: boolean;
+  /** Handler called when the open state changes. */
+  onOpenChange?: (isOpen: boolean) => void;
 }
 export interface MenuTriggerState {
-    /** Whether the menu is open. */
-    readonly isOpen: () => boolean;
-    /** Open the menu. */
-    open(): void;
-    /** Close the menu. */
-    close(): void;
-    /** Toggle the menu. */
-    toggle(): void;
-    /** Focus strategy for when the menu opens. */
-    readonly focusStrategy: () => 'first' | 'last' | null;
-    /** Set the focus strategy. */
-    setFocusStrategy(strategy: 'first' | 'last' | null): void;
+  /** Whether the menu is open. */
+  readonly isOpen: () => boolean;
+  /** Open the menu. */
+  open(): void;
+  /** Close the menu. */
+  close(): void;
+  /** Toggle the menu. */
+  toggle(): void;
+  /** Focus strategy for when the menu opens. */
+  readonly focusStrategy: () => "first" | "last" | null;
+  /** Set the focus strategy. */
+  setFocusStrategy(strategy: "first" | "last" | null): void;
 }
 /**
  * Creates state for a menu trigger (button that opens a menu).
  * This is essentially the same as overlay trigger state but with focus strategy.
  */
-export { createOverlayTriggerState as createMenuTriggerState } from '../overlays';
-//# sourceMappingURL=createMenuState.d.ts.map
+export { createOverlayTriggerState as createMenuTriggerState } from "../overlays";
+//# sourceMappingURL=createMenuState.d.ts.map

package/src/collections/createMenuState.ts

@@ -3,12 +3,11 @@
  * Based on @react-stately/menu.
  */
 
-import { access, type MaybeAccessor } from '../utils';
-import { createListState, type ListState, type ListStateProps } from './createListState';
-import type { Key } from './types';
+import { access, type MaybeAccessor } from "../utils";
+import { createListState, type ListState, type ListStateProps } from "./createListState";
+import type { Key } from "./types";
 
-export interface MenuStateProps<T = unknown>
-  extends Omit<ListStateProps<T>, 'selectionMode' | 'disallowEmptySelection'> {
+export interface MenuStateProps<T = unknown> extends ListStateProps<T> {
   /** Handler called when an item is activated (pressed). */
   onAction?: (key: Key) => void;
   /** Handler called when the menu should close. */
@@ -25,11 +24,11 @@ export interface MenuState<T = unknown> extends ListState<T> {
  * Menus are single-select lists that support actions.
  */
 export function createMenuState<T = unknown>(
-  props: MaybeAccessor<MenuStateProps<T>>
+  props: MaybeAccessor<MenuStateProps<T>>,
 ): MenuState<T> {
   const getProps = () => access(props);
 
-  // Create list state with single selection
+  // Menus default to action-only items, but can opt into single or multiple selection.
   const listState = createListState<T>({
     get items() {
       return getProps().items;
@@ -49,15 +48,22 @@ export function createMenuState<T = unknown>(
     get disabledBehavior() {
       return getProps().disabledBehavior;
     },
-    selectionMode: 'none', // Menus typically use onAction, not selection
-    disallowEmptySelection: true,
+    get selectionMode() {
+      return getProps().selectionMode ?? "none";
+    },
+    get disallowEmptySelection() {
+      return getProps().disallowEmptySelection;
+    },
     get selectedKeys() {
+      if ((getProps().selectionMode ?? "none") === "none") return undefined;
       return getProps().selectedKeys;
     },
     get defaultSelectedKeys() {
+      if ((getProps().selectionMode ?? "none") === "none") return undefined;
       return getProps().defaultSelectedKeys;
     },
     get onSelectionChange() {
+      if ((getProps().selectionMode ?? "none") === "none") return undefined;
       return getProps().onSelectionChange;
     },
     get selectionBehavior() {
@@ -94,13 +100,13 @@ export interface MenuTriggerState {
   /** Toggle the menu. */
   toggle(): void;
   /** Focus strategy for when the menu opens. */
-  readonly focusStrategy: () => 'first' | 'last' | null;
+  readonly focusStrategy: () => "first" | "last" | null;
   /** Set the focus strategy. */
-  setFocusStrategy(strategy: 'first' | 'last' | null): void;
+  setFocusStrategy(strategy: "first" | "last" | null): void;
 }
 
 /**
  * Creates state for a menu trigger (button that opens a menu).
  * This is essentially the same as overlay trigger state but with focus strategy.
  */
-export { createOverlayTriggerState as createMenuTriggerState } from '../overlays';
+export { createOverlayTriggerState as createMenuTriggerState } from "../overlays";

package/src/collections/createSelectionState.d.ts

@@ -2,75 +2,88 @@
  * 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';
+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;
+  /** 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;
+  /** 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
+export declare function createSelectionState(
+  props?: MaybeAccessor<SelectionStateProps>,
+): SelectionState;
+//# sourceMappingURL=createSelectionState.d.ts.map

package/src/collections/createSelectionState.ts

@@ -3,8 +3,8 @@
  * Based on @react-stately/selection.
  */
 
-import { createSignal, createMemo, type Accessor } from 'solid-js';
-import { access, type MaybeAccessor } from '../utils';
+import { createSignal, createMemo, type Accessor } from "solid-js";
+import { access, type MaybeAccessor } from "../utils";
 import type {
   Collection,
   DisabledBehavior,
@@ -13,7 +13,7 @@ import type {
   Selection,
   SelectionBehavior,
   SelectionMode,
-} from './types';
+} from "./types";
 
 export interface SelectionStateProps {
   /** The selection mode. */
@@ -23,9 +23,9 @@ export interface SelectionStateProps {
   /** 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: Selection) => void;
   /** Keys of disabled items. */
@@ -74,30 +74,34 @@ export interface SelectionState {
   /** 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;
+  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> = {}
+  props: MaybeAccessor<SelectionStateProps> = {},
 ): SelectionState {
   const getProps = () => access(props);
 
   // Selection behavior state
-  const [internalBehavior, setInternalBehavior] = createSignal<SelectionBehavior>('toggle');
+  const [internalBehavior, setInternalBehavior] = createSignal<SelectionBehavior>("toggle");
 
   // Internal selection state
   const [internalSelectedKeys, setInternalSelectedKeys] = createSignal<Selection>(
-    getInitialSelection(getProps().defaultSelectedKeys)
+    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 selectionMode: Accessor<SelectionMode> = () => getProps().selectionMode ?? "none";
 
   const selectionBehavior: Accessor<SelectionBehavior> = () => {
     return getProps().selectionBehavior ?? internalBehavior();
@@ -121,22 +125,22 @@ export function createSelectionState(
   });
 
   const disabledBehavior: Accessor<DisabledBehavior> = () => {
-    return getProps().disabledBehavior ?? 'all';
+    return getProps().disabledBehavior ?? "all";
   };
 
   const isEmpty: Accessor<boolean> = () => {
     const keys = selectedKeys();
-    return keys !== 'all' && keys.size === 0;
+    return keys !== "all" && keys.size === 0;
   };
 
   const isSelectAll: Accessor<boolean> = () => {
-    return selectedKeys() === 'all';
+    return selectedKeys() === "all";
   };
 
   // Methods
   const isSelected = (key: Key): boolean => {
     const keys = selectedKeys();
-    if (keys === 'all') return true;
+    if (keys === "all") return true;
     return keys.has(key);
   };
 
@@ -156,8 +160,8 @@ export function createSelectionState(
     // Uncontrolled mode
     const current = internalSelectedKeys();
     const isDifferent =
-      current === 'all' ||
-      newSelection === 'all' ||
+      current === "all" ||
+      newSelection === "all" ||
       current.size !== (newSelection as Set<Key>).size ||
       ![...current].every((k) => (newSelection as Set<Key>).has(k));
 
@@ -169,11 +173,11 @@ export function createSelectionState(
 
   const toggleSelection = (key: Key) => {
     if (isDisabled(key)) return;
-    if (selectionMode() === 'none') return;
+    if (selectionMode() === "none") return;
 
     const current = selectedKeys();
 
-    if (selectionMode() === 'single') {
+    if (selectionMode() === "single") {
       if (isSelected(key) && !disallowEmptySelection()) {
         updateSelection(new Set());
       } else {
@@ -183,7 +187,7 @@ export function createSelectionState(
     }
 
     // Multiple selection
-    if (current === 'all') {
+    if (current === "all") {
       // Can't toggle when all selected without collection
       return;
     }
@@ -203,7 +207,7 @@ export function createSelectionState(
 
   const replaceSelection = (key: Key) => {
     if (isDisabled(key)) return;
-    if (selectionMode() === 'none') return;
+    if (selectionMode() === "none") return;
 
     updateSelection(new Set([key]));
     setAnchorKey(key);
@@ -215,8 +219,8 @@ export function createSelectionState(
   };
 
   const selectAll = () => {
-    if (selectionMode() !== 'multiple') return;
-    updateSelection('all');
+    if (selectionMode() !== "multiple") return;
+    updateSelection("all");
   };
 
   const clearSelection = () => {
@@ -225,7 +229,7 @@ export function createSelectionState(
   };
 
   const toggleSelectAll = () => {
-    if (selectionMode() !== 'multiple') return;
+    if (selectionMode() !== "multiple") return;
 
     if (isSelectAll()) {
       clearSelection();
@@ -236,7 +240,7 @@ export function createSelectionState(
 
   const extendSelection = (toKey: Key, collection: Collection) => {
     if (isDisabled(toKey)) return;
-    if (selectionMode() !== 'multiple') {
+    if (selectionMode() !== "multiple") {
       replaceSelection(toKey);
       return;
     }
@@ -267,16 +271,16 @@ export function createSelectionState(
   const select = (
     key: Key,
     e?: { shiftKey?: boolean; ctrlKey?: boolean; metaKey?: boolean },
-    collection?: Collection
+    collection?: Collection,
   ) => {
     if (isDisabled(key)) return;
-    if (selectionMode() === 'none') return;
+    if (selectionMode() === "none") return;
 
     const mode = selectionMode();
     const behavior = selectionBehavior();
 
-    if (mode === 'single') {
-      if (behavior === 'replace' || !isSelected(key)) {
+    if (mode === "single") {
+      if (behavior === "replace" || !isSelected(key)) {
         replaceSelection(key);
       } else if (!disallowEmptySelection()) {
         clearSelection();
@@ -290,7 +294,7 @@ export function createSelectionState(
       return;
     }
 
-    if (e?.ctrlKey || e?.metaKey || behavior === 'toggle') {
+    if (e?.ctrlKey || e?.metaKey || behavior === "toggle") {
       toggleSelection(key);
     } else {
       replaceSelection(key);
@@ -325,12 +329,12 @@ export function createSelectionState(
 }
 
 // Helper functions
-function getInitialSelection(defaultKeys?: 'all' | Iterable<Key>): Selection {
+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';
+function normalizeSelection(keys: "all" | Iterable<Key>): Selection {
+  if (keys === "all") return "all";
   return new Set(keys);
 }

package/src/collections/index.d.ts

@@ -1,6 +1,38 @@
-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
+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.ts

@@ -1,4 +1,3 @@
-// Types
 export type {
   Key,
   SelectionMode,
@@ -13,19 +12,16 @@ export type {
   CollectionBase,
   SingleSelection,
   MultipleSelection,
-} from './types';
+} from "./types";
 
-// List Collection
-export { ListCollection, createListCollection } from './ListCollection';
+export { ListCollection, createListCollection } from "./ListCollection";
 
-// Selection State
 export {
   createSelectionState,
   type SelectionStateProps,
   type SelectionState,
-} from './createSelectionState';
+} from "./createSelectionState";
 
-// List State
 export {
   createListState,
   createSingleSelectListState,
@@ -33,9 +29,8 @@ export {
   type ListState,
   type SingleSelectListStateProps,
   type SingleSelectListState,
-} from './createListState';
+} from "./createListState";
 
-// Menu State
 export {
   createMenuState,
   createMenuTriggerState,
@@ -43,4 +38,4 @@ export {
   type MenuState,
   type MenuTriggerStateProps,
   type MenuTriggerState,
-} from './createMenuState';
+} from "./createMenuState";