@solid2-aria/stately 0.0.0-stage → 0.0.1

package/dist/select/create-select-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-select-state.js","names":[],"sources":["../../src/select/create-select-state.ts"],"sourcesContent":["/*\n * Copyright 2020 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n/*\n * Derived from Adobe React Spectrum: packages/react-stately/src/select/useSelectState.ts.\n * Modified for Solid Aria: adapted imports, collection descriptors, and reactive state APIs for Solid 2.\n * Licensed under Apache-2.0. See LICENSES/Apache-2.0.txt and NOTICE.txt at the repository root.\n */\n\nimport type {\n  CollectionBase,\n  CollectionStateBase,\n  FocusableProps,\n  FocusStrategy,\n  HelpTextProps,\n  InputBase,\n  Key,\n  LabelableProps,\n  Node,\n  Selection,\n  TextInputBase,\n  Validation,\n  ValueBase,\n} from \"@solid2-aria/types-shared\";\nimport { createMemo, createSignal, merge, omit, untrack } from \"solid-js\";\n\nimport { createFormValidationState } from \"../form/create-form-validation-state\";\nimport type { FormValidationState } from \"../form/create-form-validation-state\";\nimport { createListState } from \"../list/create-list-state\";\nimport type { ListState } from \"../list/create-list-state\";\nimport { createOverlayTriggerState } from \"../overlays/create-overlay-trigger-state\";\nimport type { OverlayTriggerState } from \"../overlays/create-overlay-trigger-state\";\nimport { createControlledSignal } from \"../utils/create-controlled-signal\";\nimport {\n  getLegacyDefaultSelectedKey,\n  getLegacySelectedKey,\n  notifyLegacySelectionChange,\n} from \"../utils/legacy-props\";\n\nexport type SelectionMode = \"single\" | \"multiple\";\n\nexport type ValueType<M extends SelectionMode> = M extends \"single\"\n  ? Key | null\n  : readonly Key[];\n\nexport type ChangeValueType<M extends SelectionMode> = M extends \"single\"\n  ? Key | null\n  : Key[];\n\ntype ValidationType<M extends SelectionMode> = M extends \"single\" ? Key : Key[];\n\nexport interface SelectProps<T, M extends SelectionMode = \"single\">\n  extends\n    CollectionBase<T>,\n    Omit<InputBase, \"isReadOnly\">,\n    ValueBase<ValueType<M>, ChangeValueType<M>>,\n    Validation<ValidationType<M>>,\n    HelpTextProps,\n    LabelableProps,\n    TextInputBase,\n    FocusableProps {\n  /**\n   * Whether single or multiple selection is enabled.\n   *\n   * @default 'single'\n   */\n  selectionMode?: M;\n  /**\n   * The currently selected key in the collection (controlled).\n   *\n   * @deprecated\n   */\n  selectedKey?: Key | null;\n  /**\n   * The initial selected key in the collection (uncontrolled).\n   *\n   * @deprecated\n   */\n  defaultSelectedKey?: Key | null;\n  /**\n   * Handler that is called when the selection changes.\n   *\n   * @deprecated\n   */\n  onSelectionChange?: (key: Key | null) => void;\n  /** Sets the open state of the menu. */\n  isOpen?: boolean;\n  /** Sets the default open state of the menu. */\n  defaultOpen?: boolean;\n  /** Method that is called when the open state of the menu changes. */\n  onOpenChange?: (isOpen: boolean) => void;\n  /**\n   * Whether the Select should close when an item is selected. Defaults to true if selectionMode is\n   * single, false otherwise.\n   */\n  shouldCloseOnSelect?: boolean;\n  /** Whether the select should be allowed to be open when the collection is empty. */\n  allowsEmptyCollection?: boolean;\n}\n\nexport interface SelectStateOptions<T, M extends SelectionMode = \"single\">\n  extends Omit<SelectProps<T, M>, \"children\">, CollectionStateBase<T> {}\n\nexport interface SelectState<T, M extends SelectionMode = \"single\">\n  extends ListState<T>, OverlayTriggerState, FormValidationState {\n  /**\n   * The key for the first selected item.\n   *\n   * @deprecated\n   */\n  readonly selectedKey: Key | null;\n  /**\n   * The default selected key.\n   *\n   * @deprecated\n   */\n  readonly defaultSelectedKey: Key | null;\n  /**\n   * Sets the selected key.\n   *\n   * @deprecated\n   */\n  setSelectedKey: (key: Key | null) => void;\n  /** The current select value. */\n  readonly value: ValueType<M>;\n  /** The default select value. */\n  readonly defaultValue: ValueType<M>;\n  /** Sets the select value. */\n  setValue: (value: Key | readonly Key[] | null) => void;\n  /**\n   * The value of the first selected item.\n   *\n   * @deprecated\n   */\n  readonly selectedItem: Node<T> | null;\n  /** The value of the selected items. */\n  readonly selectedItems: Node<T>[];\n  /** Whether the select is currently focused. */\n  readonly isFocused: boolean;\n  /** Sets whether the select is focused. */\n  setFocused: (isFocused: boolean) => void;\n  /** Controls which item will be auto focused when the menu opens. */\n  readonly focusStrategy: FocusStrategy | null;\n  /** Opens the menu. */\n  open: (focusStrategy?: FocusStrategy | null) => void;\n  /** Toggles the menu. */\n  toggle: (focusStrategy?: FocusStrategy | null) => void;\n}\n\n/**\n * Provides state management for a select component. Handles building a collection\n * of items from props, handles the open state for the popup menu, and manages\n * multiple selection state.\n */\nexport function createSelectState<\n  T extends object,\n  M extends SelectionMode = \"single\",\n>(props: SelectStateOptions<T, M>): SelectState<T, M> {\n  const triggerState = createOverlayTriggerState(props);\n\n  const [focusStrategy, setFocusStrategy] = createSignal<FocusStrategy | null>(\n    null,\n    { ownedWrite: true }\n  );\n\n  const defaultValue = createMemo(\n    () =>\n      props.defaultValue ??\n      ((props.selectionMode ?? \"single\") === \"single\"\n        ? (getLegacyDefaultSelectedKey(props) ?? null)\n        : [])\n  );\n\n  const value = createMemo(\n    () =>\n      props.value ??\n      ((props.selectionMode ?? \"single\") === \"single\"\n        ? getLegacySelectedKey(props)\n        : undefined)\n  );\n\n  const [controlledValue, setControlledValue] = createControlledSignal<\n    Key | readonly Key[] | null\n  >(\n    () => value(),\n    untrack(() => defaultValue()),\n    (nextValue) => {\n      const change = isKeyArray(nextValue) ? [...nextValue] : nextValue;\n      // SAFETY: setValue normalizes the change to the active selection mode before dispatch.\n      // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n      props.onChange?.(change as ChangeValueType<M>);\n    }\n  );\n\n  // Only display the first selected item if in single selection mode but the value is an array.\n  const displayValue = createMemo(() => {\n    const current = controlledValue();\n\n    return (props.selectionMode ?? \"single\") === \"single\" && isKeyArray(current)\n      ? (current[0] ?? null)\n      : current;\n  });\n\n  const setValue = (localValue: Key | readonly Key[] | null) => {\n    if ((props.selectionMode ?? \"single\") === \"single\") {\n      const key = isKeyArray(localValue) ? (localValue[0] ?? null) : localValue;\n\n      setControlledValue(key);\n\n      if (key !== displayValue()) {\n        notifyLegacySelectionChange(props, key);\n      }\n    } else {\n      let keys: Key[] = [];\n\n      if (isKeyArray(localValue)) {\n        keys = [...localValue];\n      } else if (localValue !== null && localValue !== undefined) {\n        keys =\n          typeof localValue === \"string\" || typeof localValue === \"number\"\n            ? [localValue]\n            : [...localValue];\n      }\n\n      setControlledValue(keys);\n    }\n  };\n\n  const validationState = createFormValidationState(\n    merge(omit(props, \"value\"), {\n      get value() {\n        const current = displayValue();\n        let validationValue: Key | Key[] | null = null;\n\n        if (isKeyArray(current)) {\n          validationValue = current.length === 0 ? null : [...current];\n        } else {\n          validationValue = current;\n        }\n\n        // SAFETY: displayValue follows selectionMode, which also determines the validation value type.\n        // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n        return validationValue as ValidationType<M> | null;\n      },\n    })\n  );\n\n  const listState = createListState(\n    merge(props, {\n      get allowDuplicateSelectionEvents() {\n        return true;\n      },\n      get disallowEmptySelection() {\n        return (props.selectionMode ?? \"single\") === \"single\";\n      },\n      get onSelectionChange() {\n        return (keys: Selection) => {\n          // impossible, but TS doesn't know that\n          if (keys === \"all\") {\n            return;\n          }\n\n          if ((props.selectionMode ?? \"single\") === \"single\") {\n            const key = keys.values().next().value ?? null;\n            setValue(key);\n          } else {\n            setValue([...keys]);\n          }\n\n          if (\n            props.shouldCloseOnSelect ??\n            (props.selectionMode ?? \"single\") === \"single\"\n          ) {\n            triggerState.close();\n          }\n\n          validationState.commitValidation();\n        };\n      },\n      get selectedKeys() {\n        return convertValue(displayValue());\n      },\n      get selectionMode() {\n        return props.selectionMode ?? \"single\";\n      },\n    })\n  );\n\n  const selectedKey = createMemo(\n    () => listState.selectionManager.firstSelectedKey\n  );\n\n  const selectedItems = createMemo(() =>\n    [...listState.selectionManager.selectedKeys].flatMap((key) => {\n      const item = listState.collection.getItem(key);\n\n      return item === null || item === undefined ? [] : [item];\n    })\n  );\n\n  const [isFocused, setFocused] = createSignal(false, { ownedWrite: true });\n\n  const initialValue = untrack(() => displayValue());\n\n  return merge(validationState, listState, triggerState, {\n    get defaultSelectedKey() {\n      return (\n        getLegacyDefaultSelectedKey(props) ??\n        (props.selectionMode === \"single\" &&\n        (typeof initialValue === \"string\" || typeof initialValue === \"number\")\n          ? initialValue\n          : null)\n      );\n    },\n    get defaultValue() {\n      // SAFETY: defaults use the same active mode as the state returned to the caller.\n      // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n      return (defaultValue() ?? initialValue) as ValueType<M>;\n    },\n    get focusStrategy() {\n      return focusStrategy();\n    },\n    get isFocused() {\n      return isFocused();\n    },\n    open(localFocusStrategy: FocusStrategy | null = null) {\n      // Don't open if the collection is empty.\n      if (\n        listState.collection.size !== 0 ||\n        props.allowsEmptyCollection === true\n      ) {\n        setFocusStrategy(localFocusStrategy);\n        triggerState.open();\n      }\n    },\n    get selectedItem() {\n      return selectedItems()[0] ?? null;\n    },\n    get selectedItems() {\n      return selectedItems();\n    },\n    get selectedKey() {\n      return selectedKey();\n    },\n    get setFocused() {\n      return setFocused;\n    },\n    get setSelectedKey() {\n      return setValue;\n    },\n    get setValue() {\n      return setValue;\n    },\n    toggle(localFocusStrategy: FocusStrategy | null = null) {\n      if (\n        listState.collection.size !== 0 ||\n        props.allowsEmptyCollection === true\n      ) {\n        setFocusStrategy(localFocusStrategy);\n        triggerState.toggle();\n      }\n    },\n    get value() {\n      // SAFETY: single mode exposes a key; multiple mode exposes the normalized key array.\n      // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n      return displayValue() as ValueType<M>;\n    },\n  });\n}\n\nfunction convertValue(value: Key | readonly Key[] | null | undefined) {\n  if (value === undefined) {\n    return value;\n  }\n\n  if (value === null) {\n    return [];\n  }\n\n  return isKeyArray(value) ? value : [value];\n}\n\nfunction isKeyArray(\n  value: Key | readonly Key[] | null | undefined\n): value is readonly Key[] {\n  return Array.isArray(value);\n}\n"],"mappings":"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"}

package/dist/selection/create-multiple-selection-state.d.ts

@@ -0,0 +1,39 @@
+/*
+ * Copyright 2020 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+/*
+ * Derived from Adobe React Spectrum: packages/react-stately/src/selection/useMultipleSelectionState.ts.
+ * Modified for Solid Aria: adapted reactive state, getters, imports, and APIs for Solid 2.
+ * Licensed under Apache-2.0. See LICENSES/Apache-2.0.txt and NOTICE.txt at the repository root.
+ */
+import { MultipleSelectionState } from "./types.js";
+import { DisabledBehavior, MultipleSelection, SelectionBehavior } from "@solid2-aria/types-shared";
+export interface MultipleSelectionStateProps extends MultipleSelection {
+  /**
+   * How multiple selection should behave in the collection.
+   *
+   * @default 'toggle'
+   */
+  selectionBehavior?: SelectionBehavior;
+  /** Whether onSelectionChange should fire even if the new set of keys is the same as the last. */
+  allowDuplicateSelectionEvents?: boolean;
+  /**
+   * Whether `disabledKeys` applies to all interactions, or only selection.
+   *
+   * @default 'all'
+   */
+  disabledBehavior?: DisabledBehavior;
+}
+/**
+ * Manages state for multiple selection and focus in a collection.
+ */
+export declare function createMultipleSelectionState(props: MultipleSelectionStateProps): MultipleSelectionState;
+//# sourceMappingURL=create-multiple-selection-state.d.ts.map

package/dist/selection/create-multiple-selection-state.js

@@ -0,0 +1,114 @@
+/*
+ * Copyright 2020 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+/*
+ * Derived from Adobe React Spectrum: packages/react-stately/src/selection/useMultipleSelectionState.ts.
+ * Modified for Solid Aria: adapted reactive state, getters, imports, and APIs for Solid 2.
+ * Licensed under Apache-2.0. See LICENSES/Apache-2.0.txt and NOTICE.txt at the repository root.
+ */
+import { createControlledSignal } from "../utils/create-controlled-signal.js";
+import { Selection } from "./selection.js";
+import { createMemo, createRenderEffect, createSignal, untrack } from "solid-js";
+// src/selection/create-multiple-selection-state.ts
+function equalSets(setA, setB) {
+	if (setA === "all" || setB === "all") return setA === setB;
+	if (setA.size !== setB.size) return false;
+	for (const item of setA) if (!setB.has(item)) return false;
+	return true;
+}
+/**
+* Manages state for multiple selection and focus in a collection.
+*/
+function createMultipleSelectionState(props) {
+	const selectionMode = createMemo(() => props.selectionMode ?? "none");
+	const disallowEmptySelection = createMemo(() => props.disallowEmptySelection ?? false);
+	const allowDuplicateSelectionEvents = createMemo(() => props.allowDuplicateSelectionEvents);
+	const selectionBehaviorProp = createMemo(() => props.selectionBehavior ?? "toggle");
+	const disabledBehavior = createMemo(() => props.disabledBehavior ?? "all");
+	let isFocusedRef = false;
+	const [focused, setFocused] = createSignal(false, { ownedWrite: true });
+	let focusedKeyRef = null;
+	let childFocusStrategyRef = null;
+	const [focusedKey, setFocusedKey] = createSignal(0, { ownedWrite: true });
+	const selectedKeysProp = createMemo(() => convertSelection(props.selectedKeys));
+	const defaultSelectedKeys = createMemo(() => convertSelection(props.defaultSelectedKeys) ?? new Selection());
+	const [selectedKeys, setSelectedKeys] = createControlledSignal(() => selectedKeysProp(), untrack(() => {
+		return defaultSelectedKeys();
+	}), (value) => {
+		props.onSelectionChange?.(value);
+	});
+	const disabledKeysProp = createMemo(() => props.disabledKeys ? new Set(props.disabledKeys) : /* @__PURE__ */ new Set());
+	const [selectionBehavior, setSelectionBehavior] = createSignal(untrack(() => selectionBehaviorProp()), { ownedWrite: true });
+	createRenderEffect(() => ({
+		behavior: selectionBehavior(),
+		keys: selectedKeys(),
+		preferredBehavior: selectionBehaviorProp()
+	}), ({ behavior, keys, preferredBehavior }) => {
+		if (preferredBehavior === "replace" && behavior === "toggle" && typeof keys === "object" && keys.size === 0) setSelectionBehavior("replace");
+	});
+	createRenderEffect(selectionBehaviorProp, setSelectionBehavior, { defer: true });
+	return {
+		get childFocusStrategy() {
+			focusedKey();
+			return childFocusStrategyRef;
+		},
+		get disabledBehavior() {
+			return disabledBehavior();
+		},
+		get disabledKeys() {
+			return disabledKeysProp();
+		},
+		get disallowEmptySelection() {
+			return disallowEmptySelection();
+		},
+		get focusedKey() {
+			focusedKey();
+			return focusedKeyRef;
+		},
+		get isFocused() {
+			focused();
+			return isFocusedRef;
+		},
+		get selectedKeys() {
+			return selectedKeys() ?? new Selection();
+		},
+		get selectionBehavior() {
+			return selectionBehavior();
+		},
+		get selectionMode() {
+			return selectionMode();
+		},
+		setFocused(f) {
+			isFocusedRef = f;
+			setFocused(f);
+		},
+		setFocusedKey(k, childFocusStrategy = "first") {
+			focusedKeyRef = k;
+			childFocusStrategyRef = childFocusStrategy;
+			setFocusedKey((previous) => previous + 1);
+		},
+		setSelectedKeys(keys) {
+			const currentAllowDuplicateSelectionEvents = allowDuplicateSelectionEvents();
+			const currentSelectedKeys = selectedKeys();
+			if (currentAllowDuplicateSelectionEvents === true || !equalSets(keys, currentSelectedKeys)) setSelectedKeys(keys);
+		},
+		setSelectionBehavior: (value) => {
+			setSelectionBehavior(value);
+		}
+	};
+}
+function convertSelection(selection, defaultValue) {
+	if (selection === null || selection === void 0) return defaultValue;
+	return selection === "all" ? "all" : new Selection(selection);
+}
+export { createMultipleSelectionState };
+
+//# sourceMappingURL=create-multiple-selection-state.js.map

package/dist/selection/create-multiple-selection-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-multiple-selection-state.js","names":[],"sources":["../../src/selection/create-multiple-selection-state.ts"],"sourcesContent":["/*\n * Copyright 2020 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n/*\n * Derived from Adobe React Spectrum: packages/react-stately/src/selection/useMultipleSelectionState.ts.\n * Modified for Solid Aria: adapted reactive state, getters, imports, and APIs for Solid 2.\n * Licensed under Apache-2.0. See LICENSES/Apache-2.0.txt and NOTICE.txt at the repository root.\n */\n\nimport type {\n  DisabledBehavior,\n  FocusStrategy,\n  Key,\n  MultipleSelection,\n  SelectionBehavior,\n} from \"@solid2-aria/types-shared\";\nimport {\n  createMemo,\n  createSignal,\n  createRenderEffect,\n  untrack,\n} from \"solid-js\";\n\nimport { createControlledSignal } from \"../utils/create-controlled-signal\";\nimport { Selection } from \"./selection\";\nimport type { MultipleSelectionState } from \"./types\";\n\nfunction equalSets(setA: \"all\" | Set<Key>, setB: \"all\" | Set<Key>) {\n  if (setA === \"all\" || setB === \"all\") {\n    return setA === setB;\n  }\n\n  if (setA.size !== setB.size) {\n    return false;\n  }\n\n  for (const item of setA) {\n    if (!setB.has(item)) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\nexport interface MultipleSelectionStateProps extends MultipleSelection {\n  /**\n   * How multiple selection should behave in the collection.\n   *\n   * @default 'toggle'\n   */\n  selectionBehavior?: SelectionBehavior;\n  /** Whether onSelectionChange should fire even if the new set of keys is the same as the last. */\n  allowDuplicateSelectionEvents?: boolean;\n  /**\n   * Whether `disabledKeys` applies to all interactions, or only selection.\n   *\n   * @default 'all'\n   */\n  disabledBehavior?: DisabledBehavior;\n}\n\n/**\n * Manages state for multiple selection and focus in a collection.\n */\nexport function createMultipleSelectionState(\n  props: MultipleSelectionStateProps\n): MultipleSelectionState {\n  const selectionMode = createMemo(() => props.selectionMode ?? \"none\");\n\n  const disallowEmptySelection = createMemo(\n    () => props.disallowEmptySelection ?? false\n  );\n\n  const allowDuplicateSelectionEvents = createMemo(\n    () => props.allowDuplicateSelectionEvents\n  );\n\n  const selectionBehaviorProp = createMemo(\n    () => props.selectionBehavior ?? \"toggle\"\n  );\n\n  const disabledBehavior = createMemo(() => props.disabledBehavior ?? \"all\");\n  // We want synchronous updates to `isFocused` and `focusedKey` after their setters are called.\n  // But we also need to trigger a react re-render. So, we have both a ref (sync) and state (async).\n  let isFocusedRef = false;\n\n  const [focused, setFocused] = createSignal(false, { ownedWrite: true });\n\n  let focusedKeyRef: Key | null = null;\n  let childFocusStrategyRef: FocusStrategy | null = null;\n\n  const [focusedKey, setFocusedKey] = createSignal<number>(0, {\n    ownedWrite: true,\n  });\n\n  const selectedKeysProp = createMemo(() =>\n    convertSelection(props.selectedKeys)\n  );\n\n  const defaultSelectedKeys = createMemo(\n    () => convertSelection(props.defaultSelectedKeys) ?? new Selection()\n  );\n\n  const [selectedKeys, setSelectedKeys] = createControlledSignal(\n    () => selectedKeysProp(),\n    untrack(() => {\n      const currentDefaultSelectedKeys = defaultSelectedKeys();\n\n      return currentDefaultSelectedKeys;\n    }),\n    (value) => {\n      props.onSelectionChange?.(value);\n    }\n  );\n\n  const disabledKeysProp = createMemo(() =>\n    props.disabledKeys ? new Set(props.disabledKeys) : new Set<Key>()\n  );\n\n  const [selectionBehavior, setSelectionBehavior] = createSignal(\n    untrack(() => selectionBehaviorProp()),\n    { ownedWrite: true }\n  );\n\n  createRenderEffect(\n    () => ({\n      behavior: selectionBehavior(),\n      keys: selectedKeys(),\n      preferredBehavior: selectionBehaviorProp(),\n    }),\n    ({ behavior, keys, preferredBehavior }) => {\n      if (\n        preferredBehavior === \"replace\" &&\n        behavior === \"toggle\" &&\n        typeof keys === \"object\" &&\n        keys.size === 0\n      ) {\n        setSelectionBehavior(\"replace\");\n      }\n    }\n  );\n  createRenderEffect(selectionBehaviorProp, setSelectionBehavior, {\n    defer: true,\n  });\n\n  return {\n    get childFocusStrategy() {\n      focusedKey();\n\n      return childFocusStrategyRef;\n    },\n    get disabledBehavior() {\n      return disabledBehavior();\n    },\n    get disabledKeys() {\n      return disabledKeysProp();\n    },\n    get disallowEmptySelection() {\n      return disallowEmptySelection();\n    },\n    get focusedKey() {\n      focusedKey();\n\n      return focusedKeyRef;\n    },\n    get isFocused() {\n      focused();\n\n      return isFocusedRef;\n    },\n    get selectedKeys() {\n      return selectedKeys() ?? new Selection();\n    },\n    get selectionBehavior() {\n      return selectionBehavior();\n    },\n    get selectionMode() {\n      return selectionMode();\n    },\n    setFocused(f) {\n      isFocusedRef = f;\n      setFocused(f);\n    },\n    setFocusedKey(k, childFocusStrategy = \"first\") {\n      focusedKeyRef = k;\n      childFocusStrategyRef = childFocusStrategy;\n      setFocusedKey((previous) => previous + 1);\n    },\n    setSelectedKeys(keys) {\n      const currentAllowDuplicateSelectionEvents =\n        allowDuplicateSelectionEvents();\n\n      const currentSelectedKeys = selectedKeys();\n\n      if (\n        currentAllowDuplicateSelectionEvents === true ||\n        !equalSets(keys, currentSelectedKeys)\n      ) {\n        setSelectedKeys(keys);\n      }\n    },\n    setSelectionBehavior: (value) => {\n      setSelectionBehavior(value);\n    },\n  };\n}\n\nfunction convertSelection(\n  selection: \"all\" | Iterable<Key> | null | undefined,\n  defaultValue?: Selection\n): \"all\" | Set<Key> | undefined {\n  if (selection === null || selection === undefined) {\n    return defaultValue;\n  }\n\n  return selection === \"all\" ? \"all\" : new Selection(selection);\n}\n"],"mappings":"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"}

package/dist/selection/selection-manager.d.ts

@@ -0,0 +1,139 @@
+/*
+ * Copyright 2020 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+/*
+ * Derived from Adobe React Spectrum: packages/react-stately/src/selection/SelectionManager.ts.
+ * Modified for Solid Aria: adapted reactive state, getters, imports, and APIs for Solid 2.
+ * Licensed under Apache-2.0. See LICENSES/Apache-2.0.txt and NOTICE.txt at the repository root.
+ */
+import { MultipleSelectionManager, MultipleSelectionState } from "./types.js";
+import { Collection, DisabledBehavior, FocusStrategy, Key, LayoutDelegate, LongPressEvent, Node, PressEvent, Selection, SelectionBehavior, SelectionMode } from "@solid2-aria/types-shared";
+interface SelectionManagerOptions {
+  allowsCellSelection?: boolean;
+  layoutDelegate?: LayoutDelegate;
+  fullCollection?: Collection<Node<unknown>>;
+}
+/**
+ * An interface for reading and updating multiple selection state.
+ */
+export declare class SelectionManager implements MultipleSelectionManager {
+  collection: Collection<Node<unknown>>;
+  private readonly state;
+  private readonly allowsCellSelection;
+  private _isSelectAll;
+  private readonly layoutDelegate;
+  private readonly fullCollection;
+  constructor(collection: Collection<Node<unknown>>, state: MultipleSelectionState, options?: SelectionManagerOptions);
+  /**
+   * The type of selection that is allowed in the collection.
+   */
+  get selectionMode(): SelectionMode;
+  /**
+   * Whether the collection allows empty selection.
+   */
+  get disallowEmptySelection(): boolean;
+  /**
+   * The selection behavior for the collection.
+   */
+  get selectionBehavior(): SelectionBehavior;
+  /**
+   * Sets the selection behavior for the collection.
+   */
+  setSelectionBehavior(selectionBehavior: SelectionBehavior): void;
+  /**
+   * Whether the collection is currently focused.
+   */
+  get isFocused(): boolean;
+  /**
+   * Sets whether the collection is focused.
+   */
+  setFocused(isFocused: boolean): void;
+  /**
+   * The current focused key in the collection.
+   */
+  get focusedKey(): Key | null;
+  /** Whether the first or last child of the focused key should receive focus. */
+  get childFocusStrategy(): FocusStrategy | null;
+  /**
+   * Sets the focused key.
+   */
+  setFocusedKey(key: Key | null, childFocusStrategy?: FocusStrategy): void;
+  /**
+   * The currently selected keys in the collection.
+   */
+  get selectedKeys(): Set<Key>;
+  /**
+   * The raw selection value for the collection.
+   * Either 'all' for select all, or a set of keys.
+   */
+  get rawSelection(): Selection;
+  /**
+   * Returns whether a key is selected.
+   */
+  isSelected(key: Key): boolean;
+  /**
+   * Whether the selection is empty.
+   */
+  get isEmpty(): boolean;
+  /**
+   * Whether all items in the collection are selected.
+   */
+  get isSelectAll(): boolean;
+  get firstSelectedKey(): Key | null;
+  get lastSelectedKey(): Key | null;
+  get disabledKeys(): Set<Key>;
+  get disabledBehavior(): DisabledBehavior;
+  /**
+   * Extends the selection to the given key.
+   */
+  extendSelection(toKey: Key): void;
+  private getKeyRange;
+  private getKeyRangeInternal;
+  private getKey;
+  /**
+   * Toggles whether the given key is selected.
+   */
+  toggleSelection(key: Key): void;
+  /**
+   * Replaces the selection with only the given key.
+   */
+  replaceSelection(key: Key): void;
+  /**
+   * Replaces the selection with the given keys.
+   */
+  setSelectedKeys(keys: Iterable<Key>): void;
+  private getSelectAllKeys;
+  /**
+   * Selects all items in the collection.
+   */
+  selectAll(): void;
+  /**
+   * Removes all keys from the selection.
+   */
+  clearSelection(): void;
+  /**
+   * Toggles between select all and an empty selection.
+   */
+  toggleSelectAll(): void;
+  select(key: Key, e?: PressEvent | LongPressEvent | PointerEvent): void;
+  /**
+   * Returns whether the current selection is equal to the given selection.
+   */
+  isSelectionEqual(selection: Set<Key>): boolean;
+  canSelectItem(key: Key): boolean;
+  private canSelectItemIn;
+  isDisabled(key: Key): boolean;
+  isLink(key: Key): boolean;
+  getItemProps(key: Key): Node<unknown>["props"];
+  withCollection(collection: Collection<Node<unknown>>): SelectionManager;
+}
+export {};
+//# sourceMappingURL=selection-manager.d.ts.map