@solid2-aria/stately 0.0.0-stage → 0.0.1

package/dist/tree/create-tree-state.js

@@ -0,0 +1,75 @@
+/*
+ * 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/tree/useTreeState.ts.
+ * Modified for Solid Aria: adapted imports, collection descriptors, and reactive state 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 { createCollection } from "../collections/create-collection.js";
+import { createMultipleSelectionState } from "../selection/create-multiple-selection-state.js";
+import { SelectionManager } from "../selection/selection-manager.js";
+import { TreeCollection } from "./tree-collection.js";
+import { createMemo, createRenderEffect, untrack } from "solid-js";
+// src/tree/create-tree-state.ts
+/**
+* Provides state management for tree-like components. Handles building a collection
+* of items from props, item expanded state, and manages multiple selection state.
+*/
+function createTreeState(props) {
+	const [expandedKeys, setExpandedKeys] = createControlledSignal(() => props.expandedKeys ? new Set(props.expandedKeys) : void 0, untrack(() => props.defaultExpandedKeys ? new Set(props.defaultExpandedKeys) : /* @__PURE__ */ new Set()), (keys) => {
+		props.onExpandedChange?.(keys);
+	});
+	const selectionState = createMultipleSelectionState(props);
+	const disabledKeys = createMemo(() => props.disabledKeys ? new Set(props.disabledKeys) : /* @__PURE__ */ new Set());
+	const tree = createCollection(props, (nodes) => new TreeCollection(nodes, { get expandedKeys() {
+		return expandedKeys();
+	} }), null);
+	createRenderEffect(() => {
+		const { focusedKey } = selectionState;
+		return focusedKey !== null && !tree().getItem(focusedKey);
+	}, (removed) => {
+		if (removed) selectionState.setFocusedKey(null);
+	});
+	const onToggle = (key) => {
+		setExpandedKeys((current) => toggleKey(current, key));
+	};
+	return {
+		get collection() {
+			return tree();
+		},
+		get disabledKeys() {
+			return disabledKeys();
+		},
+		get expandedKeys() {
+			return expandedKeys();
+		},
+		get selectionManager() {
+			return new SelectionManager(tree(), selectionState);
+		},
+		get setExpandedKeys() {
+			return setExpandedKeys;
+		},
+		get toggleKey() {
+			return onToggle;
+		}
+	};
+}
+function toggleKey(set, key) {
+	const res = new Set(set);
+	if (res.has(key)) res.delete(key);
+	else res.add(key);
+	return res;
+}
+export { createTreeState };
+
+//# sourceMappingURL=create-tree-state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-tree-state.js","names":[],"sources":["../../src/tree/create-tree-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/tree/useTreeState.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  Collection,\n  CollectionStateBase,\n  DisabledBehavior,\n  Expandable,\n  Key,\n  MultipleSelection,\n  Node,\n} from \"@solid2-aria/types-shared\";\nimport { createMemo, createRenderEffect, untrack } from \"solid-js\";\n\nimport { createCollection } from \"../collections/create-collection\";\nimport { createMultipleSelectionState } from \"../selection/create-multiple-selection-state\";\nimport { SelectionManager } from \"../selection/selection-manager\";\nimport { createControlledSignal } from \"../utils/create-controlled-signal\";\nimport { TreeCollection } from \"./tree-collection\";\n\nexport interface TreeProps<T>\n  extends CollectionStateBase<T>, Expandable, MultipleSelection {\n  /** Whether `disabledKeys` applies to all interactions, or only selection. */\n  disabledBehavior?: DisabledBehavior;\n}\n\nexport interface TreeState<T> {\n  /** A collection of items in the tree. */\n  readonly collection: Collection<Node<T>>;\n  /** A set of keys for items that are disabled. */\n  readonly disabledKeys: Set<Key>;\n  /** A set of keys for items that are expanded. */\n  readonly expandedKeys: Set<Key>;\n  /** Toggles the expanded state for an item by its key. */\n  toggleKey: (key: Key) => void;\n  /** Replaces the set of expanded keys. */\n  setExpandedKeys: (keys: Set<Key>) => void;\n  /** A selection manager to read and update multiple selection state. */\n  readonly selectionManager: SelectionManager;\n}\n\n/**\n * Provides state management for tree-like components. Handles building a collection\n * of items from props, item expanded state, and manages multiple selection state.\n */\nexport function createTreeState<T extends object>(\n  props: TreeProps<T>\n): TreeState<T> {\n  const [expandedKeys, setExpandedKeys] = createControlledSignal(\n    () => (props.expandedKeys ? new Set(props.expandedKeys) : undefined),\n    untrack(() =>\n      props.defaultExpandedKeys\n        ? new Set(props.defaultExpandedKeys)\n        : new Set<Key>()\n    ),\n    (keys) => {\n      props.onExpandedChange?.(keys);\n    }\n  );\n\n  const selectionState = createMultipleSelectionState(props);\n\n  const disabledKeys = createMemo(() =>\n    props.disabledKeys ? new Set(props.disabledKeys) : new Set<Key>()\n  );\n\n  const tree = createCollection(\n    props,\n    (nodes) =>\n      new TreeCollection(nodes, {\n        get expandedKeys() {\n          return expandedKeys();\n        },\n      }),\n    null\n  );\n\n  // Reset focused key if that item is deleted from the collection.\n  createRenderEffect(\n    () => {\n      const { focusedKey } = selectionState;\n\n      return focusedKey !== null && !tree().getItem(focusedKey);\n    },\n    (removed) => {\n      if (removed) {\n        selectionState.setFocusedKey(null);\n      }\n    }\n  );\n\n  const onToggle = (key: Key) => {\n    setExpandedKeys((current) => toggleKey(current, key));\n  };\n\n  return {\n    get collection() {\n      return tree();\n    },\n    get disabledKeys() {\n      return disabledKeys();\n    },\n    get expandedKeys() {\n      return expandedKeys();\n    },\n    get selectionManager() {\n      return new SelectionManager(tree(), selectionState);\n    },\n    get setExpandedKeys() {\n      return setExpandedKeys;\n    },\n    get toggleKey() {\n      return onToggle;\n    },\n  };\n}\n\nfunction toggleKey(set: Set<Key>, key: Key): Set<Key> {\n  const res = new Set(set);\n\n  if (res.has(key)) {\n    res.delete(key);\n  } else {\n    res.add(key);\n  }\n\n  return res;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA2DA,SAAgB,gBACd,OACc;CACd,MAAM,CAAC,cAAc,mBAAmB,6BAC/B,MAAM,eAAe,IAAI,IAAI,MAAM,YAAY,IAAI,KAAA,GAC1D,cACE,MAAM,sBACF,IAAI,IAAI,MAAM,mBAAmB,oBACjC,IAAI,IAAS,CACnB,IACC,SAAS;EACR,MAAM,mBAAmB,IAAI;CAC/B,CACF;CAEA,MAAM,iBAAiB,6BAA6B,KAAK;CAEzD,MAAM,eAAe,iBACnB,MAAM,eAAe,IAAI,IAAI,MAAM,YAAY,oBAAI,IAAI,IAAS,CAClE;CAEA,MAAM,OAAO,iBACX,QACC,UACC,IAAI,eAAe,OAAO,EACxB,IAAI,eAAe;EACjB,OAAO,aAAa;CACtB,EACF,CAAC,GACH,IACF;CAGA,yBACQ;EACJ,MAAM,EAAE,eAAe;EAEvB,OAAO,eAAe,QAAQ,CAAC,KAAK,CAAC,CAAC,QAAQ,UAAU;CAC1D,IACC,YAAY;EACX,IAAI,SACF,eAAe,cAAc,IAAI;CAErC,CACF;CAEA,MAAM,YAAY,QAAa;EAC7B,iBAAiB,YAAY,UAAU,SAAS,GAAG,CAAC;CACtD;CAEA,OAAO;EACL,IAAI,aAAa;GACf,OAAO,KAAK;EACd;EACA,IAAI,eAAe;GACjB,OAAO,aAAa;EACtB;EACA,IAAI,eAAe;GACjB,OAAO,aAAa;EACtB;EACA,IAAI,mBAAmB;GACrB,OAAO,IAAI,iBAAiB,KAAK,GAAG,cAAc;EACpD;EACA,IAAI,kBAAkB;GACpB,OAAO;EACT;EACA,IAAI,YAAY;GACd,OAAO;EACT;CACF;AACF;AAEA,SAAS,UAAU,KAAe,KAAoB;CACpD,MAAM,MAAM,IAAI,IAAI,GAAG;CAEvB,IAAI,IAAI,IAAI,GAAG,GACb,IAAI,OAAO,GAAG;MAEd,IAAI,IAAI,GAAG;CAGb,OAAO;AACT"}

package/dist/tree/tree-collection.d.ts

@@ -0,0 +1,36 @@
+/*
+ * 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/tree/TreeCollection.ts.
+ * Modified for Solid Aria: adapted imports, collection descriptors, and reactive state APIs for Solid 2.
+ * Licensed under Apache-2.0. See LICENSES/Apache-2.0.txt and NOTICE.txt at the repository root.
+ */
+import { Collection, Key, Node } from "@solid2-aria/types-shared";
+export declare class TreeCollection<T> implements Collection<Node<T>> {
+  private readonly keyMap;
+  private readonly iterable;
+  private readonly firstKey;
+  private readonly lastKey;
+  constructor(nodes: Iterable<Node<T>>, { expandedKeys }?: {
+    expandedKeys?: Set<Key>;
+  });
+  [Symbol.iterator](): IterableIterator<Node<T>>;
+  get size(): number;
+  getKeys(): IterableIterator<Key>;
+  getKeyBefore(key: Key): Key | null;
+  getKeyAfter(key: Key): Key | null;
+  getFirstKey(): Key | null;
+  getLastKey(): Key | null;
+  getItem(key: Key): Node<T> | null;
+  at(idx: number): Node<T> | null;
+}
+//# sourceMappingURL=tree-collection.d.ts.map

package/dist/tree/tree-collection.js

@@ -0,0 +1,84 @@
+/*
+ * 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/tree/TreeCollection.ts.
+ * Modified for Solid Aria: adapted imports, collection descriptors, and reactive state APIs for Solid 2.
+ * Licensed under Apache-2.0. See LICENSES/Apache-2.0.txt and NOTICE.txt at the repository root.
+ */
+import { getChildNodes } from "../collections/get-child-nodes.js";
+// src/tree/tree-collection.ts
+var TreeCollection = class {
+	keyMap = /* @__PURE__ */ new Map();
+	iterable;
+	firstKey = null;
+	lastKey = null;
+	constructor(nodes, { expandedKeys } = {}) {
+		this.iterable = nodes;
+		const visibleExpandedKeys = expandedKeys ?? /* @__PURE__ */ new Set();
+		const visit = (node) => {
+			this.keyMap.set(node.key, node);
+			if (node.type === "section" || visibleExpandedKeys.has(node.key)) for (const child of getChildNodes(node, this)) visit(child);
+		};
+		for (const node of nodes) visit(node);
+		let last = null;
+		let index = 0;
+		for (const [key, node] of this.keyMap) {
+			if (last) {
+				last.nextKey = key;
+				node.prevKey = last.key;
+			} else {
+				this.firstKey = key;
+				node.prevKey = void 0;
+			}
+			if (node.type === "item") {
+				index += 1;
+				node.index = index;
+			}
+			last = node;
+			last.nextKey = void 0;
+		}
+		this.lastKey = last?.key ?? null;
+	}
+	*[Symbol.iterator]() {
+		yield* this.iterable;
+	}
+	get size() {
+		return this.keyMap.size;
+	}
+	getKeys() {
+		return this.keyMap.keys();
+	}
+	getKeyBefore(key) {
+		const node = this.keyMap.get(key);
+		return node ? node.prevKey ?? null : null;
+	}
+	getKeyAfter(key) {
+		const node = this.keyMap.get(key);
+		return node ? node.nextKey ?? null : null;
+	}
+	getFirstKey() {
+		return this.firstKey;
+	}
+	getLastKey() {
+		return this.lastKey;
+	}
+	getItem(key) {
+		return this.keyMap.get(key) ?? null;
+	}
+	at(idx) {
+		const key = [...this.getKeys()][idx];
+		return key === void 0 ? null : this.getItem(key);
+	}
+};
+export { TreeCollection };
+
+//# sourceMappingURL=tree-collection.js.map

package/dist/tree/tree-collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-collection.js","names":[],"sources":["../../src/tree/tree-collection.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/tree/TreeCollection.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 { Collection, Key, Node } from \"@solid2-aria/types-shared\";\n\nimport { getChildNodes } from \"../collections/get-child-nodes\";\n\nexport class TreeCollection<T> implements Collection<Node<T>> {\n  private readonly keyMap = new Map<Key, Node<T>>();\n  private readonly iterable: Iterable<Node<T>>;\n  private readonly firstKey: Key | null = null;\n  private readonly lastKey: Key | null = null;\n  constructor(\n    nodes: Iterable<Node<T>>,\n    {\n      expandedKeys,\n    }: {\n      expandedKeys?: Set<Key>;\n    } = {}\n  ) {\n    this.iterable = nodes;\n    const visibleExpandedKeys = expandedKeys ?? new Set<Key>();\n\n    const visit = (node: Node<T>) => {\n      this.keyMap.set(node.key, node);\n\n      if (node.type === \"section\" || visibleExpandedKeys.has(node.key)) {\n        for (const child of getChildNodes(node, this)) {\n          visit(child);\n        }\n      }\n    };\n\n    for (const node of nodes) {\n      visit(node);\n    }\n\n    let last: Node<T> | null = null;\n    let index = 0;\n\n    for (const [key, node] of this.keyMap) {\n      if (last) {\n        last.nextKey = key;\n        node.prevKey = last.key;\n      } else {\n        this.firstKey = key;\n        node.prevKey = undefined;\n      }\n\n      if (node.type === \"item\") {\n        index += 1;\n        node.index = index;\n      }\n\n      last = node;\n      // Set nextKey as undefined since this might be the last node\n      // If it isn't the last node, last.nextKey will properly set at start of new loop\n      last.nextKey = undefined;\n    }\n\n    this.lastKey = last?.key ?? null;\n  }\n  *[Symbol.iterator](): IterableIterator<Node<T>> {\n    yield* this.iterable;\n  }\n  get size(): number {\n    return this.keyMap.size;\n  }\n  getKeys(): IterableIterator<Key> {\n    return this.keyMap.keys();\n  }\n  getKeyBefore(key: Key): Key | null {\n    const node = this.keyMap.get(key);\n\n    return node ? (node.prevKey ?? null) : null;\n  }\n  getKeyAfter(key: Key): Key | null {\n    const node = this.keyMap.get(key);\n\n    return node ? (node.nextKey ?? null) : null;\n  }\n  getFirstKey(): Key | null {\n    return this.firstKey;\n  }\n  getLastKey(): Key | null {\n    return this.lastKey;\n  }\n  getItem(key: Key): Node<T> | null {\n    return this.keyMap.get(key) ?? null;\n  }\n  at(idx: number): Node<T> | null {\n    const keys = [...this.getKeys()];\n    const key = keys[idx];\n\n    return key === undefined ? null : this.getItem(key);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAqBA,IAAa,iBAAb,MAA8D;CAC5D,yBAA0B,IAAI,IAAkB;CAChD;CACA,WAAwC;CACxC,UAAuC;CACvC,YACE,OACA,EACE,iBAGE,CAAC,GACL;EACA,KAAK,WAAW;EAChB,MAAM,sBAAsB,gCAAgB,IAAI,IAAS;EAEzD,MAAM,SAAS,SAAkB;GAC/B,KAAK,OAAO,IAAI,KAAK,KAAK,IAAI;GAE9B,IAAI,KAAK,SAAS,aAAa,oBAAoB,IAAI,KAAK,GAAG,GAC7D,KAAK,MAAM,SAAS,cAAc,MAAM,IAAI,GAC1C,MAAM,KAAK;EAGjB;EAEA,KAAK,MAAM,QAAQ,OACjB,MAAM,IAAI;EAGZ,IAAI,OAAuB;EAC3B,IAAI,QAAQ;EAEZ,KAAK,MAAM,CAAC,KAAK,SAAS,KAAK,QAAQ;GACrC,IAAI,MAAM;IACR,KAAK,UAAU;IACf,KAAK,UAAU,KAAK;GACtB,OAAO;IACL,KAAK,WAAW;IAChB,KAAK,UAAU,KAAA;GACjB;GAEA,IAAI,KAAK,SAAS,QAAQ;IACxB,SAAS;IACT,KAAK,QAAQ;GACf;GAEA,OAAO;GAGP,KAAK,UAAU,KAAA;EACjB;EAEA,KAAK,UAAU,MAAM,OAAO;CAC9B;CACA,EAAE,OAAO,YAAuC;EAC9C,OAAO,KAAK;CACd;CACA,IAAI,OAAe;EACjB,OAAO,KAAK,OAAO;CACrB;CACA,UAAiC;EAC/B,OAAO,KAAK,OAAO,KAAK;CAC1B;CACA,aAAa,KAAsB;EACjC,MAAM,OAAO,KAAK,OAAO,IAAI,GAAG;EAEhC,OAAO,OAAQ,KAAK,WAAW,OAAQ;CACzC;CACA,YAAY,KAAsB;EAChC,MAAM,OAAO,KAAK,OAAO,IAAI,GAAG;EAEhC,OAAO,OAAQ,KAAK,WAAW,OAAQ;CACzC;CACA,cAA0B;EACxB,OAAO,KAAK;CACd;CACA,aAAyB;EACvB,OAAO,KAAK;CACd;CACA,QAAQ,KAA0B;EAChC,OAAO,KAAK,OAAO,IAAI,GAAG,KAAK;CACjC;CACA,GAAG,KAA6B;EAE9B,MAAM,MAAM,CADE,GAAG,KAAK,QAAQ,CACf,CAAC,CAAC;EAEjB,OAAO,QAAQ,KAAA,IAAY,OAAO,KAAK,QAAQ,GAAG;CACpD;AACF"}

package/dist/utils/create-controlled-signal.d.ts

@@ -0,0 +1,23 @@
+/*
+ * 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/utils/useControlledState.ts.
+ * Modified for Solid Aria: adapted state handling, APIs, or formatting for Solid 2.
+ * Licensed under Apache-2.0. See LICENSES/Apache-2.0.txt and NOTICE.txt at the repository root.
+ */
+import { Accessor } from "solid-js";
+type StateUpdate<T> = T | ((previous: T) => T);
+type ControlledSetter<T, Args extends unknown[]> = (value: StateUpdate<T>, ...args: Args) => void;
+export declare function createControlledSignal<T, Args extends unknown[] = []>(value: Accessor<T>, defaultValue: undefined, onChange?: (value: NoInfer<T>, ...args: Args) => void): [Accessor<T>, ControlledSetter<T, Args>];
+export declare function createControlledSignal<T, Args extends unknown[] = []>(value: Accessor<T | undefined>, defaultValue: T, onChange?: (value: NoInfer<T>, ...args: Args) => void): [Accessor<T>, ControlledSetter<T, Args>];
+export {};
+//# sourceMappingURL=create-controlled-signal.d.ts.map

package/dist/utils/create-controlled-signal.js

@@ -0,0 +1,54 @@
+/*
+ * 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/utils/useControlledState.ts.
+ * Modified for Solid Aria: adapted state handling, APIs, or formatting for Solid 2.
+ * Licensed under Apache-2.0. See LICENSES/Apache-2.0.txt and NOTICE.txt at the repository root.
+ */
+import { createRenderEffect, createSignal, untrack } from "solid-js";
+// src/utils/create-controlled-signal.ts
+function isUpdater(update) {
+	return typeof update === "function";
+}
+function createControlledSignal(value, defaultValue, onChange) {
+	const initialValue = untrack(value);
+	let initialState = defaultValue;
+	if (initialValue !== void 0) initialState = initialValue;
+	const [state, setState] = createSignal({ value: initialState }, { ownedWrite: true });
+	let pendingValue = initialState;
+	let wasControlled = initialValue !== void 0;
+	const currentValue = () => {
+		const controlledValue = value();
+		if (controlledValue !== void 0) return controlledValue;
+		return state().value;
+	};
+	createRenderEffect(() => ({
+		controlled: value() !== void 0,
+		state: state(),
+		value: currentValue()
+	}), (current) => {
+		if (wasControlled !== current.controlled && process.env.NODE_ENV !== "production") console.warn(`WARN: A component changed from ${wasControlled ? "controlled" : "uncontrolled"} to ${current.controlled ? "controlled" : "uncontrolled"}.`);
+		wasControlled = current.controlled;
+		pendingValue = current.value;
+	});
+	const setValue = (update, ...args) => {
+		const nextValue = isUpdater(update) ? update(pendingValue) : update;
+		if (Object.is(pendingValue, nextValue)) return;
+		pendingValue = nextValue;
+		setState({ value: nextValue });
+		untrack(() => onChange?.(nextValue, ...args));
+	};
+	return [currentValue, setValue];
+}
+export { createControlledSignal };
+
+//# sourceMappingURL=create-controlled-signal.js.map

package/dist/utils/create-controlled-signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-controlled-signal.js","names":[],"sources":["../../src/utils/create-controlled-signal.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/utils/useControlledState.ts.\n * Modified for Solid Aria: adapted state handling, APIs, or formatting 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 { Accessor } from \"solid-js\";\nimport { createRenderEffect, createSignal, untrack } from \"solid-js\";\n\ntype StateUpdate<T> = T | ((previous: T) => T);\n\ntype ControlledSetter<T, Args extends unknown[]> = (\n  value: StateUpdate<T>,\n  ...args: Args\n) => void;\n\nfunction isUpdater<T>(update: StateUpdate<T>): update is (previous: T) => T {\n  return typeof update === \"function\";\n}\n\nexport function createControlledSignal<T, Args extends unknown[] = []>(\n  value: Accessor<T>,\n  defaultValue: undefined,\n  onChange?: (value: NoInfer<T>, ...args: Args) => void\n): [Accessor<T>, ControlledSetter<T, Args>];\nexport function createControlledSignal<T, Args extends unknown[] = []>(\n  value: Accessor<T | undefined>,\n  defaultValue: T,\n  onChange?: (value: NoInfer<T>, ...args: Args) => void\n): [Accessor<T>, ControlledSetter<T, Args>];\nexport function createControlledSignal<T, Args extends unknown[] = []>(\n  value: Accessor<T | undefined>,\n  defaultValue: T,\n  onChange?: (value: NoInfer<T>, ...args: Args) => void\n): [Accessor<T>, ControlledSetter<T, Args>] {\n  const initialValue = untrack(value);\n\n  let initialState = defaultValue;\n\n  if (initialValue !== undefined) {\n    initialState = initialValue;\n  }\n\n  const [state, setState] = createSignal(\n    { value: initialState },\n    { ownedWrite: true }\n  );\n\n  let pendingValue = initialState;\n  let wasControlled = initialValue !== undefined;\n\n  const currentValue = () => {\n    const controlledValue = value();\n\n    if (controlledValue !== undefined) {\n      return controlledValue;\n    }\n\n    return state().value;\n  };\n\n  createRenderEffect(\n    () => ({\n      controlled: value() !== undefined,\n      state: state(),\n      value: currentValue(),\n    }),\n    (current) => {\n      if (\n        wasControlled !== current.controlled &&\n        process.env.NODE_ENV !== \"production\"\n      ) {\n        console.warn(\n          `WARN: A component changed from ${wasControlled ? \"controlled\" : \"uncontrolled\"} to ${current.controlled ? \"controlled\" : \"uncontrolled\"}.`\n        );\n      }\n\n      wasControlled = current.controlled;\n      pendingValue = current.value;\n    }\n  );\n\n  const setValue: ControlledSetter<T, Args> = (update, ...args) => {\n    const nextValue = isUpdater(update) ? update(pendingValue) : update;\n\n    if (Object.is(pendingValue, nextValue)) {\n      return;\n    }\n\n    pendingValue = nextValue;\n    setState({ value: nextValue });\n    untrack(() => onChange?.(nextValue, ...args));\n  };\n\n  return [currentValue, setValue];\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AA2BA,SAAS,UAAa,QAAsD;CAC1E,OAAO,OAAO,WAAW;AAC3B;AAYA,SAAgB,uBACd,OACA,cACA,UAC0C;CAC1C,MAAM,eAAe,QAAQ,KAAK;CAElC,IAAI,eAAe;CAEnB,IAAI,iBAAiB,KAAA,GACnB,eAAe;CAGjB,MAAM,CAAC,OAAO,YAAY,aACxB,EAAE,OAAO,aAAa,GACtB,EAAE,YAAY,KAAK,CACrB;CAEA,IAAI,eAAe;CACnB,IAAI,gBAAgB,iBAAiB,KAAA;CAErC,MAAM,qBAAqB;EACzB,MAAM,kBAAkB,MAAM;EAE9B,IAAI,oBAAoB,KAAA,GACtB,OAAO;EAGT,OAAO,MAAM,CAAC,CAAC;CACjB;CAEA,0BACS;EACL,YAAY,MAAM,MAAM,KAAA;EACxB,OAAO,MAAM;EACb,OAAO,aAAa;CACtB,KACC,YAAY;EACX,IACE,kBAAkB,QAAQ,cAC1B,QAAQ,IAAI,aAAa,cAEzB,QAAQ,KACN,kCAAkC,gBAAgB,eAAe,eAAe,MAAM,QAAQ,aAAa,eAAe,eAAe,EAC3I;EAGF,gBAAgB,QAAQ;EACxB,eAAe,QAAQ;CACzB,CACF;CAEA,MAAM,YAAuC,QAAQ,GAAG,SAAS;EAC/D,MAAM,YAAY,UAAU,MAAM,IAAI,OAAO,YAAY,IAAI;EAE7D,IAAI,OAAO,GAAG,cAAc,SAAS,GACnC;EAGF,eAAe;EACf,SAAS,EAAE,OAAO,UAAU,CAAC;EAC7B,cAAc,WAAW,WAAW,GAAG,IAAI,CAAC;CAC9C;CAEA,OAAO,CAAC,cAAc,QAAQ;AAChC"}

package/dist/utils/get-item-key.d.ts

@@ -0,0 +1,5 @@
+
+import { Key } from "@solid2-aria/types-shared";
+/** Resolves the conventional id/key fields when a data source has no getKey callback. */
+export declare function getItemKey(item: unknown): Key;
+//# sourceMappingURL=get-item-key.d.ts.map

package/dist/utils/get-item-key.js

@@ -0,0 +1,12 @@
+
+// src/utils/get-item-key.ts
+/** Resolves the conventional id/key fields when a data source has no getKey callback. */
+function getItemKey(item) {
+	if (typeof item !== "object" || item === null) throw new Error("Provide getKey for items without an id or key.");
+	const key = ("id" in item ? item.id : void 0) ?? ("key" in item ? item.key : void 0);
+	if (typeof key === "string" || typeof key === "number") return key;
+	throw new Error("Provide getKey for items without a string or number id or key.");
+}
+export { getItemKey };
+
+//# sourceMappingURL=get-item-key.js.map

package/dist/utils/get-item-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-item-key.js","names":[],"sources":["../../src/utils/get-item-key.ts"],"sourcesContent":["import type { Key } from \"@solid2-aria/types-shared\";\n\n/** Resolves the conventional id/key fields when a data source has no getKey callback. */\n// oxlint-disable-next-line anti-slop/no-unknown-parameters -- This function parses the conventional id/key metadata boundary for arbitrary caller-provided items.\nexport function getItemKey(item: unknown): Key {\n  if (typeof item !== \"object\" || item === null) {\n    throw new Error(\"Provide getKey for items without an id or key.\");\n  }\n\n  const key =\n    (\"id\" in item ? item.id : undefined) ??\n    (\"key\" in item ? item.key : undefined);\n\n  if (typeof key === \"string\" || typeof key === \"number\") {\n    return key;\n  }\n\n  throw new Error(\n    \"Provide getKey for items without a string or number id or key.\"\n  );\n}\n"],"mappings":";;;AAIA,SAAgB,WAAW,MAAoB;CAC7C,IAAI,OAAO,SAAS,YAAY,SAAS,MACvC,MAAM,IAAI,MAAM,gDAAgD;CAGlE,MAAM,OACH,QAAQ,OAAO,KAAK,KAAK,KAAA,OACzB,SAAS,OAAO,KAAK,MAAM,KAAA;CAE9B,IAAI,OAAO,QAAQ,YAAY,OAAO,QAAQ,UAC5C,OAAO;CAGT,MAAM,IAAI,MACR,gEACF;AACF"}

package/dist/utils/get-node-props.d.ts

@@ -0,0 +1,23 @@
+
+import { ColumnSize } from "../table/column.js";
+/** Read the built-in metadata at the boundary of the extensible Node.props contract. */
+export declare function getNodeProps(node: {
+  props?: unknown;
+} | null | undefined): {
+  allowsSorting: boolean;
+  children: number;
+  colSpan: number | undefined;
+  defaultWidth: ColumnSize | undefined;
+  disabledBehavior: unknown;
+  hasChildItems: boolean;
+  href: string | undefined;
+  isDisabled: boolean;
+  isDragButtonCell: boolean;
+  isLoading: boolean;
+  isRowHeader: boolean;
+  isSelectionCell: boolean;
+  maxWidth: ColumnSize | undefined;
+  minWidth: ColumnSize | undefined;
+  width: ColumnSize | undefined;
+};
+//# sourceMappingURL=get-node-props.d.ts.map

package/dist/utils/get-node-props.js

@@ -0,0 +1,38 @@
+
+// src/utils/get-node-props.ts
+function isColumnSize(value) {
+	return typeof value === "number" || typeof value === "string" && /^-?(?:\d+\.?\d*|\.\d+)(?:e[+-]?\d+)?(?:%|fr)?$/iu.test(value);
+}
+function columnSize(metadata, key) {
+	const value = metadata[key];
+	return (typeof value === "string" || typeof value === "number") && isColumnSize(value) ? value : void 0;
+}
+/** Read the built-in metadata at the boundary of the extensible Node.props contract. */
+function getNodeProps(node) {
+	const metadata = node?.props;
+	const props = typeof metadata === "object" && metadata !== null ? metadata : {};
+	const children = props.children;
+	const childItems = props.UNSTABLE_childItems;
+	const { colSpan } = props;
+	const { href } = props;
+	return {
+		allowsSorting: props.allowsSorting === true,
+		children: Array.isArray(children) ? children.length : 0,
+		colSpan: typeof colSpan === "number" ? colSpan : void 0,
+		defaultWidth: columnSize(props, "defaultWidth"),
+		disabledBehavior: props.disabledBehavior,
+		hasChildItems: childItems !== null && childItems !== void 0,
+		href: typeof href === "string" ? href : void 0,
+		isDisabled: props.isDisabled === true,
+		isDragButtonCell: props.isDragButtonCell === true,
+		isLoading: props.isLoading === true,
+		isRowHeader: props.isRowHeader === true,
+		isSelectionCell: props.isSelectionCell === true,
+		maxWidth: columnSize(props, "maxWidth"),
+		minWidth: columnSize(props, "minWidth"),
+		width: columnSize(props, "width")
+	};
+}
+export { getNodeProps };
+
+//# sourceMappingURL=get-node-props.js.map

package/dist/utils/get-node-props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-node-props.js","names":[],"sources":["../../src/utils/get-node-props.ts"],"sourcesContent":["import type { ColumnSize } from \"../table/column\";\n\ninterface NodeMetadata {\n  allowsSorting?: unknown;\n  children?: unknown;\n  UNSTABLE_childItems?: unknown;\n  colSpan?: unknown;\n  href?: unknown;\n  defaultWidth?: unknown;\n  disabledBehavior?: unknown;\n  isDisabled?: unknown;\n  isDragButtonCell?: unknown;\n  isLoading?: unknown;\n  isRowHeader?: unknown;\n  isSelectionCell?: unknown;\n  maxWidth?: unknown;\n  minWidth?: unknown;\n  width?: unknown;\n}\n\nfunction isColumnSize(value: string | number): value is ColumnSize {\n  return (\n    typeof value === \"number\" ||\n    (typeof value === \"string\" &&\n      /^-?(?:\\d+\\.?\\d*|\\.\\d+)(?:e[+-]?\\d+)?(?:%|fr)?$/iu.test(value))\n  );\n}\n\nfunction columnSize(\n  metadata: NodeMetadata,\n  key: \"width\" | \"defaultWidth\" | \"minWidth\" | \"maxWidth\"\n): ColumnSize | undefined {\n  const value = metadata[key];\n\n  return (typeof value === \"string\" || typeof value === \"number\") &&\n    isColumnSize(value)\n    ? value\n    : undefined;\n}\n\n/** Read the built-in metadata at the boundary of the extensible Node.props contract. */\nexport function getNodeProps(node: { props?: unknown } | null | undefined) {\n  const metadata: unknown = node?.props;\n\n  const props: NodeMetadata =\n    typeof metadata === \"object\" && metadata !== null ? metadata : {};\n\n  const children: unknown = props.children;\n  const childItems = props.UNSTABLE_childItems;\n  const { colSpan } = props;\n  const { href } = props;\n\n  return {\n    allowsSorting: props.allowsSorting === true,\n    children: Array.isArray(children) ? children.length : 0,\n    colSpan: typeof colSpan === \"number\" ? colSpan : undefined,\n    defaultWidth: columnSize(props, \"defaultWidth\"),\n    disabledBehavior: props.disabledBehavior,\n    hasChildItems: childItems !== null && childItems !== undefined,\n    href: typeof href === \"string\" ? href : undefined,\n    isDisabled: props.isDisabled === true,\n    isDragButtonCell: props.isDragButtonCell === true,\n    isLoading: props.isLoading === true,\n    isRowHeader: props.isRowHeader === true,\n    isSelectionCell: props.isSelectionCell === true,\n    maxWidth: columnSize(props, \"maxWidth\"),\n    minWidth: columnSize(props, \"minWidth\"),\n    width: columnSize(props, \"width\"),\n  };\n}\n"],"mappings":";;AAoBA,SAAS,aAAa,OAA6C;CACjE,OACE,OAAO,UAAU,YAChB,OAAO,UAAU,YAChB,mDAAmD,KAAK,KAAK;AAEnE;AAEA,SAAS,WACP,UACA,KACwB;CACxB,MAAM,QAAQ,SAAS;CAEvB,QAAQ,OAAO,UAAU,YAAY,OAAO,UAAU,aACpD,aAAa,KAAK,IAChB,QACA,KAAA;AACN;;AAGA,SAAgB,aAAa,MAA8C;CACzE,MAAM,WAAoB,MAAM;CAEhC,MAAM,QACJ,OAAO,aAAa,YAAY,aAAa,OAAO,WAAW,CAAC;CAElE,MAAM,WAAoB,MAAM;CAChC,MAAM,aAAa,MAAM;CACzB,MAAM,EAAE,YAAY;CACpB,MAAM,EAAE,SAAS;CAEjB,OAAO;EACL,eAAe,MAAM,kBAAkB;EACvC,UAAU,MAAM,QAAQ,QAAQ,IAAI,SAAS,SAAS;EACtD,SAAS,OAAO,YAAY,WAAW,UAAU,KAAA;EACjD,cAAc,WAAW,OAAO,cAAc;EAC9C,kBAAkB,MAAM;EACxB,eAAe,eAAe,QAAQ,eAAe,KAAA;EACrD,MAAM,OAAO,SAAS,WAAW,OAAO,KAAA;EACxC,YAAY,MAAM,eAAe;EACjC,kBAAkB,MAAM,qBAAqB;EAC7C,WAAW,MAAM,cAAc;EAC/B,aAAa,MAAM,gBAAgB;EACnC,iBAAiB,MAAM,oBAAoB;EAC3C,UAAU,WAAW,OAAO,UAAU;EACtC,UAAU,WAAW,OAAO,UAAU;EACtC,OAAO,WAAW,OAAO,OAAO;CAClC;AACF"}

package/dist/utils/has-content.d.ts

@@ -0,0 +1,5 @@
+
+import { Element } from "solid-js";
+/** Collection descriptors use JavaScript truthiness to select optional JSX content. */
+export declare const hasContent: (value: Element) => boolean;
+//# sourceMappingURL=has-content.d.ts.map

package/dist/utils/has-content.js

@@ -0,0 +1,7 @@
+
+// src/utils/has-content.ts
+/** Collection descriptors use JavaScript truthiness to select optional JSX content. */
+const hasContent = Boolean;
+export { hasContent };
+
+//# sourceMappingURL=has-content.js.map

package/dist/utils/has-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-content.js","names":[],"sources":["../../src/utils/has-content.ts"],"sourcesContent":["import type { Element as SolidElement } from \"solid-js\";\n\n/** Collection descriptors use JavaScript truthiness to select optional JSX content. */\nexport const hasContent: (value: SolidElement) => boolean = Boolean;\n"],"mappings":";;;AAGA,MAAa,aAA+C"}

package/dist/utils/legacy-props.d.ts

@@ -0,0 +1,10 @@
+
+import { SelectProps } from "../select/create-select-state.js";
+import { Key, Validation } from "@solid2-aria/types-shared";
+type LegacySelectionProps = Pick<SelectProps<object>, "selectedKey" | "defaultSelectedKey" | "onSelectionChange">;
+export declare function getLegacySelectedKey(props: LegacySelectionProps): Key | null | undefined;
+export declare function getLegacyDefaultSelectedKey(props: LegacySelectionProps): Key | null | undefined;
+export declare function notifyLegacySelectionChange(props: LegacySelectionProps, key: Key | null): void;
+export declare function getLegacyValidationState(props: Pick<Validation, "validationState">): import("@solid2-aria/types-shared").ValidationState | undefined;
+export {};
+//# sourceMappingURL=legacy-props.d.ts.map

package/dist/utils/legacy-props.js

@@ -0,0 +1,17 @@
+
+// src/utils/legacy-props.ts
+function getLegacySelectedKey(props) {
+	return props.selectedKey;
+}
+function getLegacyDefaultSelectedKey(props) {
+	return props.defaultSelectedKey;
+}
+function notifyLegacySelectionChange(props, key) {
+	props.onSelectionChange?.(key);
+}
+function getLegacyValidationState(props) {
+	return props.validationState;
+}
+export { getLegacyDefaultSelectedKey, getLegacySelectedKey, getLegacyValidationState, notifyLegacySelectionChange };
+
+//# sourceMappingURL=legacy-props.js.map

package/dist/utils/legacy-props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-props.js","names":[],"sources":["../../src/utils/legacy-props.ts"],"sourcesContent":["import type { Key, Validation } from \"@solid2-aria/types-shared\";\n\nimport type { SelectProps } from \"../select/create-select-state\";\n\ntype LegacySelectionProps = Pick<\n  SelectProps<object>,\n  \"selectedKey\" | \"defaultSelectedKey\" | \"onSelectionChange\"\n>;\n\nexport function getLegacySelectedKey(\n  props: LegacySelectionProps\n): Key | null | undefined {\n  // oxlint-disable-next-line typescript/no-deprecated, solid/reactivity -- The compatibility getter is evaluated in its caller's tracked scope.\n  return props.selectedKey;\n}\n\nexport function getLegacyDefaultSelectedKey(\n  props: LegacySelectionProps\n): Key | null | undefined {\n  // oxlint-disable-next-line typescript/no-deprecated, solid/reactivity -- The compatibility getter is evaluated in its caller's tracked scope.\n  return props.defaultSelectedKey;\n}\n\nexport function notifyLegacySelectionChange(\n  props: LegacySelectionProps,\n  key: Key | null\n): void {\n  // oxlint-disable-next-line typescript/no-deprecated -- Notify existing consumers of the legacy callback alongside onChange.\n  props.onSelectionChange?.(key);\n}\n\nexport function getLegacyValidationState(\n  props: Pick<Validation, \"validationState\">\n) {\n  // oxlint-disable-next-line typescript/no-deprecated, solid/reactivity -- The compatibility getter is evaluated in its caller's tracked scope.\n  return props.validationState;\n}\n"],"mappings":";;AASA,SAAgB,qBACd,OACwB;CAExB,OAAO,MAAM;AACf;AAEA,SAAgB,4BACd,OACwB;CAExB,OAAO,MAAM;AACf;AAEA,SAAgB,4BACd,OACA,KACM;CAEN,MAAM,oBAAoB,GAAG;AAC/B;AAEA,SAAgB,yBACd,OACA;CAEA,OAAO,MAAM;AACf"}

package/dist/utils/number.d.ts

@@ -0,0 +1,25 @@
+/*
+ * 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/utils/number.ts.
+ * Modified for Solid Aria: adapted state handling, APIs, or formatting for Solid 2.
+ * Licensed under Apache-2.0. See LICENSES/Apache-2.0.txt and NOTICE.txt at the repository root.
+ */
+/**
+ * Takes a value and forces it to the closest min/max if it's outside. Also forces it to the closest
+ * valid step.
+ */
+export declare function clamp(value: number, min?: number, max?: number): number;
+export declare function roundToStepPrecision(value: number, step: number): number;
+export declare function snapValueToStep(value: number, min: number | undefined, max: number | undefined, step: number): number;
+export declare function toFixedNumber(value: number, digits: number, base?: number): number;
+//# sourceMappingURL=number.d.ts.map

package/dist/utils/number.js

@@ -0,0 +1,59 @@
+/*
+ * 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/utils/number.ts.
+ * Modified for Solid Aria: adapted state handling, APIs, or formatting for Solid 2.
+ * Licensed under Apache-2.0. See LICENSES/Apache-2.0.txt and NOTICE.txt at the repository root.
+ */
+// src/utils/number.ts
+/**
+* Takes a value and forces it to the closest min/max if it's outside. Also forces it to the closest
+* valid step.
+*/
+function clamp(value, min = -Infinity, max = Infinity) {
+	return Math.min(Math.max(value, min), max);
+}
+function roundToStepPrecision(value, step) {
+	let roundedValue = value;
+	let precision = 0;
+	const stepString = step.toString();
+	const eIndex = stepString.toLowerCase().indexOf("e-");
+	if (eIndex > 0) precision = Math.abs(Math.floor(Math.log10(Math.abs(step)))) + eIndex;
+	else {
+		const pointIndex = stepString.indexOf(".");
+		if (pointIndex !== -1) precision = stepString.length - pointIndex;
+	}
+	if (precision > 0) {
+		const pow = 10 ** precision;
+		roundedValue = Math.round(roundedValue * pow) / pow;
+	}
+	return roundedValue;
+}
+function snapValueToStep(value, min, max, step) {
+	const minOrNan = Number(min);
+	const maxOrNan = Number(max);
+	const remainder = (value - (Number.isNaN(minOrNan) ? 0 : minOrNan)) % step;
+	let snappedValue = roundToStepPrecision(Math.abs(remainder) * 2 >= step ? value + Math.sign(remainder) * (step - Math.abs(remainder)) : value - remainder, step);
+	if (!Number.isNaN(minOrNan)) {
+		if (snappedValue < minOrNan) snappedValue = minOrNan;
+		else if (!Number.isNaN(maxOrNan) && snappedValue > maxOrNan) snappedValue = minOrNan + Math.floor(roundToStepPrecision((maxOrNan - minOrNan) / step, step)) * step;
+	} else if (!Number.isNaN(maxOrNan) && snappedValue > maxOrNan) snappedValue = Math.floor(roundToStepPrecision(maxOrNan / step, step)) * step;
+	snappedValue = roundToStepPrecision(snappedValue, step);
+	return snappedValue;
+}
+function toFixedNumber(value, digits, base = 10) {
+	const pow = base ** digits;
+	return Math.round(value * pow) / pow;
+}
+export { clamp, roundToStepPrecision, snapValueToStep, toFixedNumber };
+
+//# sourceMappingURL=number.js.map

package/dist/utils/number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.js","names":[],"sources":["../../src/utils/number.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/utils/number.ts.\n * Modified for Solid Aria: adapted state handling, APIs, or formatting for Solid 2.\n * Licensed under Apache-2.0. See LICENSES/Apache-2.0.txt and NOTICE.txt at the repository root.\n */\n\n/**\n * Takes a value and forces it to the closest min/max if it's outside. Also forces it to the closest\n * valid step.\n */\n\nexport function clamp(value: number, min = -Infinity, max = Infinity): number {\n  const newValue = Math.min(Math.max(value, min), max);\n\n  return newValue;\n}\n\nexport function roundToStepPrecision(value: number, step: number): number {\n  let roundedValue = value;\n  let precision = 0;\n  const stepString = step.toString();\n  // Handle negative exponents in exponential notation (e.g., \"1e-7\" → precision 8)\n  const eIndex = stepString.toLowerCase().indexOf(\"e-\");\n\n  if (eIndex > 0) {\n    precision = Math.abs(Math.floor(Math.log10(Math.abs(step)))) + eIndex;\n  } else {\n    const pointIndex = stepString.indexOf(\".\");\n\n    if (pointIndex !== -1) {\n      precision = stepString.length - pointIndex;\n    }\n  }\n\n  if (precision > 0) {\n    const pow = 10 ** precision;\n    roundedValue = Math.round(roundedValue * pow) / pow;\n  }\n\n  return roundedValue;\n}\n\nexport function snapValueToStep(\n  value: number,\n  min: number | undefined,\n  max: number | undefined,\n  step: number\n): number {\n  const minOrNan = Number(min);\n  const maxOrNan = Number(max);\n  const remainder = (value - (Number.isNaN(minOrNan) ? 0 : minOrNan)) % step;\n\n  let snappedValue = roundToStepPrecision(\n    Math.abs(remainder) * 2 >= step\n      ? value + Math.sign(remainder) * (step - Math.abs(remainder))\n      : value - remainder,\n    step\n  );\n\n  if (!Number.isNaN(minOrNan)) {\n    if (snappedValue < minOrNan) {\n      snappedValue = minOrNan;\n    } else if (!Number.isNaN(maxOrNan) && snappedValue > maxOrNan) {\n      snappedValue =\n        minOrNan +\n        Math.floor(roundToStepPrecision((maxOrNan - minOrNan) / step, step)) *\n          step;\n    }\n  } else if (!Number.isNaN(maxOrNan) && snappedValue > maxOrNan) {\n    snappedValue =\n      Math.floor(roundToStepPrecision(maxOrNan / step, step)) * step;\n  }\n\n  // correct floating point behavior by rounding to step precision\n  snappedValue = roundToStepPrecision(snappedValue, step);\n\n  return snappedValue;\n}\n\n/* Takes a value and rounds off to the number of digits. */\nexport function toFixedNumber(\n  value: number,\n  digits: number,\n  base = 10\n): number {\n  const pow = base ** digits;\n\n  return Math.round(value * pow) / pow;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,MAAM,OAAe,MAAM,WAAW,MAAM,UAAkB;CAG5E,OAFiB,KAAK,IAAI,KAAK,IAAI,OAAO,GAAG,GAAG,GAElC;AAChB;AAEA,SAAgB,qBAAqB,OAAe,MAAsB;CACxE,IAAI,eAAe;CACnB,IAAI,YAAY;CAChB,MAAM,aAAa,KAAK,SAAS;CAEjC,MAAM,SAAS,WAAW,YAAY,CAAC,CAAC,QAAQ,IAAI;CAEpD,IAAI,SAAS,GACX,YAAY,KAAK,IAAI,KAAK,MAAM,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI;MAC1D;EACL,MAAM,aAAa,WAAW,QAAQ,GAAG;EAEzC,IAAI,eAAe,IACjB,YAAY,WAAW,SAAS;CAEpC;CAEA,IAAI,YAAY,GAAG;EACjB,MAAM,MAAM,MAAM;EAClB,eAAe,KAAK,MAAM,eAAe,GAAG,IAAI;CAClD;CAEA,OAAO;AACT;AAEA,SAAgB,gBACd,OACA,KACA,KACA,MACQ;CACR,MAAM,WAAW,OAAO,GAAG;CAC3B,MAAM,WAAW,OAAO,GAAG;CAC3B,MAAM,aAAa,SAAS,OAAO,MAAM,QAAQ,IAAI,IAAI,aAAa;CAEtE,IAAI,eAAe,qBACjB,KAAK,IAAI,SAAS,IAAI,KAAK,OACvB,QAAQ,KAAK,KAAK,SAAS,KAAK,OAAO,KAAK,IAAI,SAAS,KACzD,QAAQ,WACZ,IACF;CAEA,IAAI,CAAC,OAAO,MAAM,QAAQ,GAAG;EAC3B,IAAI,eAAe,UACjB,eAAe;OACV,IAAI,CAAC,OAAO,MAAM,QAAQ,KAAK,eAAe,UACnD,eACE,WACA,KAAK,MAAM,sBAAsB,WAAW,YAAY,MAAM,IAAI,CAAC,IACjE;CAER,OAAO,IAAI,CAAC,OAAO,MAAM,QAAQ,KAAK,eAAe,UACnD,eACE,KAAK,MAAM,qBAAqB,WAAW,MAAM,IAAI,CAAC,IAAI;CAI9D,eAAe,qBAAqB,cAAc,IAAI;CAEtD,OAAO;AACT;AAGA,SAAgB,cACd,OACA,QACA,OAAO,IACC;CACR,MAAM,MAAM,QAAQ;CAEpB,OAAO,KAAK,MAAM,QAAQ,GAAG,IAAI;AACnC"}

package/dist/utils/parse-calendar-identifier.d.ts

@@ -0,0 +1,5 @@
+
+import { CalendarIdentifier } from "@internationalized/date";
+/** Narrow Intl's string calendar identifier before passing it to a calendar factory. */
+export declare function parseCalendarIdentifier(value: string): CalendarIdentifier;
+//# sourceMappingURL=parse-calendar-identifier.d.ts.map

package/dist/utils/parse-calendar-identifier.js

@@ -0,0 +1,31 @@
+
+// src/utils/parse-calendar-identifier.ts
+const CALENDAR_IDENTIFIERS = [
+	"gregory",
+	"buddhist",
+	"chinese",
+	"coptic",
+	"dangi",
+	"ethioaa",
+	"ethiopic",
+	"hebrew",
+	"indian",
+	"islamic",
+	"islamic-umalqura",
+	"islamic-tbla",
+	"islamic-civil",
+	"islamic-rgsa",
+	"iso8601",
+	"japanese",
+	"persian",
+	"roc"
+];
+/** Narrow Intl's string calendar identifier before passing it to a calendar factory. */
+function parseCalendarIdentifier(value) {
+	const identifier = CALENDAR_IDENTIFIERS.find((candidate) => candidate === value);
+	if (identifier === void 0) throw new RangeError(`Unsupported calendar identifier: ${value}`);
+	return identifier;
+}
+export { parseCalendarIdentifier };
+
+//# sourceMappingURL=parse-calendar-identifier.js.map

package/dist/utils/parse-calendar-identifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-calendar-identifier.js","names":[],"sources":["../../src/utils/parse-calendar-identifier.ts"],"sourcesContent":["import type { CalendarIdentifier } from \"@internationalized/date\";\n\nconst CALENDAR_IDENTIFIERS = [\n  \"gregory\",\n  \"buddhist\",\n  \"chinese\",\n  \"coptic\",\n  \"dangi\",\n  \"ethioaa\",\n  \"ethiopic\",\n  \"hebrew\",\n  \"indian\",\n  \"islamic\",\n  \"islamic-umalqura\",\n  \"islamic-tbla\",\n  \"islamic-civil\",\n  \"islamic-rgsa\",\n  \"iso8601\",\n  \"japanese\",\n  \"persian\",\n  \"roc\",\n] as const satisfies readonly CalendarIdentifier[];\n\n/** Narrow Intl's string calendar identifier before passing it to a calendar factory. */\nexport function parseCalendarIdentifier(value: string): CalendarIdentifier {\n  const identifier = CALENDAR_IDENTIFIERS.find(\n    (candidate) => candidate === value\n  );\n\n  if (identifier === undefined) {\n    throw new RangeError(`Unsupported calendar identifier: ${value}`);\n  }\n\n  return identifier;\n}\n"],"mappings":";;AAEA,MAAM,uBAAuB;CAC3B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;AAGA,SAAgB,wBAAwB,OAAmC;CACzE,MAAM,aAAa,qBAAqB,MACrC,cAAc,cAAc,KAC/B;CAEA,IAAI,eAAe,KAAA,GACjB,MAAM,IAAI,WAAW,oCAAoC,OAAO;CAGlE,OAAO;AACT"}

package/dist/utils/require-value.d.ts

@@ -0,0 +1,4 @@
+
+/** Check collection and layout invariants that TypeScript cannot infer from key or index bounds. */
+export declare function requireValue<T>(value: T, message: string): NonNullable<T>;
+//# sourceMappingURL=require-value.d.ts.map

package/dist/utils/require-value.js

@@ -0,0 +1,10 @@
+
+// src/utils/require-value.ts
+/** Check collection and layout invariants that TypeScript cannot infer from key or index bounds. */
+function requireValue(value, message) {
+	if (value === null || value === void 0) throw new Error(message);
+	return value;
+}
+export { requireValue };
+
+//# sourceMappingURL=require-value.js.map