@proyecto-viviana/solid-stately 0.0.6 → 0.1.1

package/src/collections/ListCollection.ts

@@ -0,0 +1,146 @@
+/**
+ * A simple list collection implementation.
+ * Provides a Collection interface over an array of nodes.
+ */
+
+import type { Collection, CollectionNode, Key } from './types';
+
+/**
+ * A basic implementation of Collection for list-based components.
+ */
+export class ListCollection<T = unknown> implements Collection<T> {
+  private nodes: CollectionNode<T>[];
+  private keyMap: Map<Key, CollectionNode<T>>;
+
+  constructor(nodes: CollectionNode<T>[]) {
+    this.nodes = nodes;
+    this.keyMap = new Map();
+
+    // Build key map for O(1) lookups
+    const addToMap = (node: CollectionNode<T>) => {
+      this.keyMap.set(node.key, node);
+      if (node.childNodes) {
+        for (const child of node.childNodes) {
+          addToMap(child);
+        }
+      }
+    };
+
+    for (const node of nodes) {
+      addToMap(node);
+    }
+  }
+
+  get size(): number {
+    return this.keyMap.size;
+  }
+
+  *[Symbol.iterator](): Iterator<CollectionNode<T>> {
+    yield* this.nodes;
+  }
+
+  *getKeys(): Iterable<Key> {
+    for (const node of this.keyMap.values()) {
+      yield node.key;
+    }
+  }
+
+  getItem(key: Key): CollectionNode<T> | null {
+    return this.keyMap.get(key) ?? null;
+  }
+
+  at(index: number): CollectionNode<T> | null {
+    // Flatten all items for indexing
+    const items = this.getAllItems();
+    return items[index] ?? null;
+  }
+
+  getKeyBefore(key: Key): Key | null {
+    const items = this.getAllItems();
+    const index = items.findIndex((item) => item.key === key);
+    if (index <= 0) return null;
+    return items[index - 1].key;
+  }
+
+  getKeyAfter(key: Key): Key | null {
+    const items = this.getAllItems();
+    const index = items.findIndex((item) => item.key === key);
+    if (index < 0 || index >= items.length - 1) return null;
+    return items[index + 1].key;
+  }
+
+  getFirstKey(): Key | null {
+    const items = this.getAllItems();
+    return items[0]?.key ?? null;
+  }
+
+  getLastKey(): Key | null {
+    const items = this.getAllItems();
+    return items[items.length - 1]?.key ?? null;
+  }
+
+  *getChildren(key: Key): Iterable<CollectionNode<T>> {
+    const node = this.getItem(key);
+    if (node?.childNodes) {
+      yield* node.childNodes;
+    }
+  }
+
+  getTextValue(key: Key): string {
+    return this.getItem(key)?.textValue ?? '';
+  }
+
+  /**
+   * Get all items (excluding sections, including items within sections).
+   */
+  private getAllItems(): CollectionNode<T>[] {
+    const items: CollectionNode<T>[] = [];
+
+    const addItems = (nodes: CollectionNode<T>[]) => {
+      for (const node of nodes) {
+        if (node.type === 'item') {
+          items.push(node);
+        } else if (node.type === 'section' && node.childNodes) {
+          addItems(node.childNodes);
+        }
+      }
+    };
+
+    addItems(this.nodes);
+    return items;
+  }
+}
+
+/**
+ * Create a collection from an array of items.
+ */
+export function createListCollection<T>(
+  items: T[],
+  options: {
+    getKey?: (item: T, index: number) => Key;
+    getTextValue?: (item: T) => string;
+    getDisabled?: (item: T) => boolean;
+  } = {}
+): ListCollection<T> {
+  const {
+    getKey = (item: T, index: number) => (item as any).key ?? (item as any).id ?? index,
+    getTextValue = (item: T) => (item as any).textValue ?? (item as any).label ?? String(item),
+    getDisabled = (item: T) => (item as any).isDisabled ?? false,
+  } = options;
+
+  const nodes: CollectionNode<T>[] = items.map((item, index) => ({
+    type: 'item' as const,
+    key: getKey(item, index),
+    value: item,
+    textValue: getTextValue(item),
+    rendered: null as any, // Will be set by component
+    level: 0,
+    index,
+    parentKey: null,
+    hasChildNodes: false,
+    childNodes: [],
+    isDisabled: getDisabled(item),
+  }));
+
+  return new ListCollection(nodes);
+}

package/src/collections/createListState.d.ts

@@ -0,0 +1,79 @@
+/**
+ * State management for list-like components.
+ * Combines collection and selection state.
+ * Based on @react-stately/list.
+ */
+import { type Accessor } from 'solid-js';
+import { type MaybeAccessor } from '../utils';
+import { type SelectionState } from './createSelectionState';
+import type { Collection, CollectionNode, DisabledBehavior, FocusStrategy, Key, SelectionBehavior, SelectionMode } from './types';
+export interface ListStateProps<T = unknown> {
+    /** The items in the list (for dynamic rendering). */
+    items?: T[];
+    /** Function to get a key from an item. */
+    getKey?: (item: T) => Key;
+    /** Function to get text value from an item. */
+    getTextValue?: (item: T) => string;
+    /** Function to check if an item is disabled. */
+    getDisabled?: (item: T) => boolean;
+    /** Keys of disabled items. */
+    disabledKeys?: Iterable<Key>;
+    /** How disabled keys behave. */
+    disabledBehavior?: DisabledBehavior;
+    /** 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: 'all' | Set<Key>) => void;
+    /** Whether to allow duplicate selection events. */
+    allowDuplicateSelectionEvents?: boolean;
+}
+export interface ListState<T = unknown> extends SelectionState {
+    /** The collection of items. */
+    readonly collection: Accessor<Collection<T>>;
+    /** Whether the collection is focused. */
+    readonly isFocused: Accessor<boolean>;
+    /** Set the focused state. */
+    setFocused(isFocused: boolean): void;
+    /** The currently focused key. */
+    readonly focusedKey: Accessor<Key | null>;
+    /** Set the focused key. */
+    setFocusedKey(key: Key | null, childStrategy?: FocusStrategy): void;
+    /** The child focus strategy. */
+    readonly childFocusStrategy: Accessor<FocusStrategy | null>;
+}
+/**
+ * Creates state for a list component with selection.
+ */
+export declare function createListState<T = unknown>(props: MaybeAccessor<ListStateProps<T>>): ListState<T>;
+/**
+ * Props for single selection list state.
+ */
+export interface SingleSelectListStateProps<T = unknown> extends Omit<ListStateProps<T>, 'selectionMode' | 'selectedKeys' | 'defaultSelectedKeys' | 'onSelectionChange'> {
+    /** The currently selected key (controlled). */
+    selectedKey?: Key | null;
+    /** The default selected key (uncontrolled). */
+    defaultSelectedKey?: Key;
+    /** Handler for selection changes. */
+    onSelectionChange?: (key: Key | null) => void;
+}
+export interface SingleSelectListState<T = unknown> extends ListState<T> {
+    /** The currently selected key. */
+    readonly selectedKey: Accessor<Key | null>;
+    /** Set the selected key. */
+    setSelectedKey(key: Key | null): void;
+    /** The currently selected item. */
+    readonly selectedItem: Accessor<CollectionNode<T> | null>;
+}
+/**
+ * Creates state for a single-select list component.
+ */
+export declare function createSingleSelectListState<T = unknown>(props: MaybeAccessor<SingleSelectListStateProps<T>>): SingleSelectListState<T>;
+//# sourceMappingURL=createListState.d.ts.map

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

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

package/src/collections/createListState.ts

@@ -0,0 +1,264 @@
+/**
+ * State management for list-like components.
+ * Combines collection and selection state.
+ * Based on @react-stately/list.
+ */
+
+import { createSignal, type Accessor } from 'solid-js';
+import { access, type MaybeAccessor } from '../utils';
+import { ListCollection } from './ListCollection';
+import { createSelectionState, type SelectionState } from './createSelectionState';
+import type {
+  Collection,
+  CollectionNode,
+  DisabledBehavior,
+  FocusStrategy,
+  Key,
+  SelectionBehavior,
+  SelectionMode,
+} from './types';
+
+export interface ListStateProps<T = unknown> {
+  /** The items in the list (for dynamic rendering). */
+  items?: T[];
+  /** Function to get a key from an item. */
+  getKey?: (item: T) => Key;
+  /** Function to get text value from an item. */
+  getTextValue?: (item: T) => string;
+  /** Function to check if an item is disabled. */
+  getDisabled?: (item: T) => boolean;
+  /** Keys of disabled items. */
+  disabledKeys?: Iterable<Key>;
+  /** How disabled keys behave. */
+  disabledBehavior?: DisabledBehavior;
+  /** 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: 'all' | Set<Key>) => void;
+  /** Whether to allow duplicate selection events. */
+  allowDuplicateSelectionEvents?: boolean;
+}
+
+export interface ListState<T = unknown> extends SelectionState {
+  /** The collection of items. */
+  readonly collection: Accessor<Collection<T>>;
+  /** Whether the collection is focused. */
+  readonly isFocused: Accessor<boolean>;
+  /** Set the focused state. */
+  setFocused(isFocused: boolean): void;
+  /** The currently focused key. */
+  readonly focusedKey: Accessor<Key | null>;
+  /** Set the focused key. */
+  setFocusedKey(key: Key | null, childStrategy?: FocusStrategy): void;
+  /** The child focus strategy. */
+  readonly childFocusStrategy: Accessor<FocusStrategy | null>;
+}
+
+/**
+ * Creates state for a list component with selection.
+ */
+export function createListState<T = unknown>(
+  props: MaybeAccessor<ListStateProps<T>>
+): ListState<T> {
+  const getProps = () => access(props);
+
+  // Build collection from items
+  const collection: Accessor<Collection<T>> = () => {
+    const p = getProps();
+    const items = p.items ?? [];
+
+    const nodes: CollectionNode<T>[] = items.map((item, index) => {
+      const key = p.getKey?.(item) ?? (item as any).key ?? (item as any).id ?? index;
+      const textValue =
+        p.getTextValue?.(item) ?? (item as any).textValue ?? (item as any).label ?? String(item);
+      const isDisabled = p.getDisabled?.(item) ?? (item as any).isDisabled ?? false;
+
+      return {
+        type: 'item' as const,
+        key,
+        value: item,
+        textValue,
+        rendered: null as any,
+        level: 0,
+        index,
+        parentKey: null,
+        hasChildNodes: false,
+        childNodes: [],
+        isDisabled,
+      };
+    });
+
+    return new ListCollection(nodes);
+  };
+
+  // Combine disabled keys from props and items
+  const combinedDisabledKeys = (): Iterable<Key> => {
+    const p = getProps();
+    const propsDisabled = p.disabledKeys ? [...p.disabledKeys] : [];
+    const itemDisabled: Key[] = [];
+
+    const coll = collection();
+    for (const node of coll) {
+      if (node.isDisabled) {
+        itemDisabled.push(node.key);
+      }
+    }
+
+    return [...new Set([...propsDisabled, ...itemDisabled])];
+  };
+
+  // Create selection state
+  const selectionState = createSelectionState({
+    get selectionMode() {
+      return getProps().selectionMode;
+    },
+    get selectionBehavior() {
+      return getProps().selectionBehavior;
+    },
+    get disallowEmptySelection() {
+      return getProps().disallowEmptySelection;
+    },
+    get selectedKeys() {
+      return getProps().selectedKeys;
+    },
+    get defaultSelectedKeys() {
+      return getProps().defaultSelectedKeys;
+    },
+    get onSelectionChange() {
+      return getProps().onSelectionChange;
+    },
+    get disabledKeys() {
+      return combinedDisabledKeys();
+    },
+    get disabledBehavior() {
+      return getProps().disabledBehavior;
+    },
+    get allowDuplicateSelectionEvents() {
+      return getProps().allowDuplicateSelectionEvents;
+    },
+  });
+
+  // Focus state
+  const [isFocused, setIsFocused] = createSignal(false);
+  const [focusedKey, setFocusedKeyInternal] = createSignal<Key | null>(null);
+  const [childFocusStrategy, setChildFocusStrategy] = createSignal<FocusStrategy | null>(null);
+
+  const setFocusedKey = (key: Key | null, childStrategy?: FocusStrategy) => {
+    setFocusedKeyInternal(key);
+    setChildFocusStrategy(childStrategy ?? null);
+  };
+
+  return {
+    collection,
+    isFocused,
+    setFocused: setIsFocused,
+    focusedKey,
+    setFocusedKey,
+    childFocusStrategy,
+    ...selectionState,
+  };
+}
+
+/**
+ * Props for single selection list state.
+ */
+export interface SingleSelectListStateProps<T = unknown>
+  extends Omit<ListStateProps<T>, 'selectionMode' | 'selectedKeys' | 'defaultSelectedKeys' | 'onSelectionChange'> {
+  /** The currently selected key (controlled). */
+  selectedKey?: Key | null;
+  /** The default selected key (uncontrolled). */
+  defaultSelectedKey?: Key;
+  /** Handler for selection changes. */
+  onSelectionChange?: (key: Key | null) => void;
+}
+
+export interface SingleSelectListState<T = unknown> extends ListState<T> {
+  /** The currently selected key. */
+  readonly selectedKey: Accessor<Key | null>;
+  /** Set the selected key. */
+  setSelectedKey(key: Key | null): void;
+  /** The currently selected item. */
+  readonly selectedItem: Accessor<CollectionNode<T> | null>;
+}
+
+/**
+ * Creates state for a single-select list component.
+ */
+export function createSingleSelectListState<T = unknown>(
+  props: MaybeAccessor<SingleSelectListStateProps<T>>
+): SingleSelectListState<T> {
+  const getProps = () => access(props);
+
+  // Convert single selection props to multiple selection props
+  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: 'single',
+    disallowEmptySelection: true,
+    allowDuplicateSelectionEvents: true,
+    get selectedKeys() {
+      const key = getProps().selectedKey;
+      return key != null ? [key] : [];
+    },
+    get defaultSelectedKeys() {
+      const key = getProps().defaultSelectedKey;
+      return key != null ? [key] : undefined;
+    },
+    onSelectionChange(keys) {
+      if (keys === 'all') return;
+      const key = keys.values().next().value ?? null;
+      getProps().onSelectionChange?.(key);
+    },
+  });
+
+  const selectedKey: Accessor<Key | null> = () => {
+    const keys = listState.selectedKeys();
+    if (keys === 'all') return null;
+    return keys.values().next().value ?? null;
+  };
+
+  const setSelectedKey = (key: Key | null) => {
+    if (key === null) {
+      listState.clearSelection();
+    } else {
+      listState.replaceSelection(key);
+    }
+  };
+
+  const selectedItem: Accessor<CollectionNode<T> | null> = () => {
+    const key = selectedKey();
+    if (key === null) return null;
+    return listState.collection().getItem(key);
+  };
+
+  return {
+    ...listState,
+    selectedKey,
+    setSelectedKey,
+    selectedItem,
+  };
+}

package/src/collections/createMenuState.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 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;
+}
+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 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;
+}
+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';
+//# sourceMappingURL=createMenuState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createMenuState.d.ts","sourceRoot":"","sources":["createMenuState.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAU,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAmB,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAEnC,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO,CACzC,SAAQ,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,eAAe,GAAG,wBAAwB,CAAC;IAC3E,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;IAC9B,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IAC1D,sBAAsB;IACtB,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EACzC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GACtC,SAAS,CAAC,CAAC,CAAC,CA+Cd;AAED,MAAM,WAAW,qBAAqB;IACpC,6CAA6C;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kDAAkD;IAClD,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC;IAC/B,qBAAqB;IACrB,IAAI,IAAI,IAAI,CAAC;IACb,sBAAsB;IACtB,KAAK,IAAI,IAAI,CAAC;IACd,uBAAuB;IACvB,MAAM,IAAI,IAAI,CAAC;IACf,8CAA8C;IAC9C,QAAQ,CAAC,aAAa,EAAE,MAAM,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;IACtD,8BAA8B;IAC9B,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;CAC3D;AAED;;;GAGG;AACH,OAAO,EAAE,yBAAyB,IAAI,sBAAsB,EAAE,MAAM,aAAa,CAAC"}

package/src/collections/createMenuState.ts

@@ -0,0 +1,106 @@
+/**
+ * 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';