@proyecto-viviana/solid-stately 0.2.4 → 0.3.0

package/src/collections/createMenuState.ts

@@ -1,106 +1,112 @@
-/**
- * State management for menu components.
- * Based on @react-stately/menu.
- */
-
-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'> {
-  /** 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;
-}
-
-/**
- * Creates state for a menu component.
- * Menus are single-select lists that support actions.
- */
-export function createMenuState<T = unknown>(
-  props: MaybeAccessor<MenuStateProps<T>>
-): MenuState<T> {
-  const getProps = () => access(props);
-
-  // Create list state with single selection
-  const listState = createListState<T>({
-    get items() {
-      return getProps().items;
-    },
-    get getKey() {
-      return getProps().getKey;
-    },
-    get getTextValue() {
-      return getProps().getTextValue;
-    },
-    get getDisabled() {
-      return getProps().getDisabled;
-    },
-    get disabledKeys() {
-      return getProps().disabledKeys;
-    },
-    get disabledBehavior() {
-      return getProps().disabledBehavior;
-    },
-    selectionMode: 'none', // Menus typically use onAction, not selection
-    disallowEmptySelection: true,
-    get selectedKeys() {
-      return getProps().selectedKeys;
-    },
-    get defaultSelectedKeys() {
-      return getProps().defaultSelectedKeys;
-    },
-    get onSelectionChange() {
-      return getProps().onSelectionChange;
-    },
-    get selectionBehavior() {
-      return getProps().selectionBehavior;
-    },
-  });
-
-  const close = () => {
-    getProps().onClose?.();
-  };
-
-  return {
-    ...listState,
-    close,
-  };
-}
-
-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;
-}
-
-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;
-}
-
-/**
- * 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';
+/**
+ * State management for menu components.
+ * Based on @react-stately/menu.
+ */
+
+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 ListStateProps<T> {
+  /** 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;
+}
+
+/**
+ * Creates state for a menu component.
+ * Menus are single-select lists that support actions.
+ */
+export function createMenuState<T = unknown>(
+  props: MaybeAccessor<MenuStateProps<T>>,
+): MenuState<T> {
+  const getProps = () => access(props);
+
+  // Menus default to action-only items, but can opt into single or multiple selection.
+  const listState = createListState<T>({
+    get items() {
+      return getProps().items;
+    },
+    get getKey() {
+      return getProps().getKey;
+    },
+    get getTextValue() {
+      return getProps().getTextValue;
+    },
+    get getDisabled() {
+      return getProps().getDisabled;
+    },
+    get disabledKeys() {
+      return getProps().disabledKeys;
+    },
+    get disabledBehavior() {
+      return getProps().disabledBehavior;
+    },
+    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() {
+      return getProps().selectionBehavior;
+    },
+  });
+
+  const close = () => {
+    getProps().onClose?.();
+  };
+
+  return {
+    ...listState,
+    close,
+  };
+}
+
+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;
+}
+
+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;
+}
+
+/**
+ * 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";

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