@solid2-aria/stately 0.0.0-stage → 0.0.1

package/dist/table/column.d.ts

@@ -0,0 +1,66 @@
+/*
+ * 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/table/Column.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 { CollectionContext, PartialNode } from "../collections/types.js";
+import { Element } from "solid-js";
+import { Key, Node } from "@solid2-aria/types-shared";
+/** Widths that result in a constant pixel value for the same Table width. */
+export type ColumnStaticSize = number | `${number}` | `${number}%`;
+/**
+ * Widths that change size in relation to the remaining space and in ratio to other dynamic columns.
+ * All numbers must be integers and greater than 0.
+ * FR units take up remaining, if any, space in the table.
+ */
+export type ColumnDynamicSize = `${number}fr`;
+/** All possible sizes a column can be assigned. */
+export type ColumnSize = ColumnStaticSize | ColumnDynamicSize;
+export type ColumnElement<_T> = Element;
+export type ColumnRenderer<T> = (item: T) => ColumnElement<T>;
+export interface ColumnProps<T> {
+  key?: Key;
+  "aria-label"?: string;
+  /** Rendered contents of the column if `children` contains child columns. */
+  title?: Element;
+  /** Static child columns or content to render as the column header. */
+  children: Element | ColumnElement<T>[];
+  /** A list of child columns used when dynamically rendering nested child columns. */
+  childColumns?: T[];
+  /** The width of the column. */
+  width?: ColumnSize | null;
+  /** The minimum width of the column. */
+  minWidth?: ColumnStaticSize | null;
+  /** The maximum width of the column. */
+  maxWidth?: ColumnStaticSize | null;
+  /** The default width of the column. */
+  defaultWidth?: ColumnSize | null;
+  /** Whether the column allows resizing. */
+  allowsResizing?: boolean;
+  /** Whether the column allows sorting. */
+  allowsSorting?: boolean;
+  /**
+   * Whether a column is a [row header](https://www.w3.org/TR/wai-aria-1.1/#rowheader) and should be
+   * announced by assistive technology during row navigation.
+   */
+  isRowHeader?: boolean;
+  /** A string representation of the column's contents, used for accessibility announcements. */
+  textValue?: string;
+}
+declare function Column<T>(props: ColumnProps<T>): Element;
+declare namespace Column {
+  var getCollectionNode: <T>(props: ColumnProps<T>, context: CollectionContext) => Generator<PartialNode<T>, void, Node<T>[]>;
+}
+export { Column };
+//# sourceMappingURL=column.d.ts.map

package/dist/table/column.js

@@ -0,0 +1,71 @@
+/*
+ * 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/table/Column.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 { hasContent } from "../utils/has-content.js";
+import { collectionChildren } from "../collections/types.js";
+import { isTableCollectionContext } from "./collection-context.js";
+// src/table/column.ts
+function Column(props) {
+	return Object.assign([], {
+		getCollectionNode: (context) => Column.getCollectionNode(props, context),
+		get key() {
+			return props.key;
+		},
+		props,
+		type: Column
+	});
+}
+Column.getCollectionNode = function* getCollectionNode(props, context) {
+	if (!isTableCollectionContext(context)) throw new Error("Table collection context is required.");
+	const { title, children, childColumns } = props;
+	const rendered = title ?? children;
+	let textValue = props["aria-label"] ?? "";
+	if (typeof rendered === "string" && rendered !== "") textValue = rendered;
+	if (props.textValue !== void 0 && props.textValue !== "") ({textValue} = props);
+	const fullNodes = yield {
+		*childNodes() {
+			if (childColumns) for (const child of childColumns) yield {
+				type: "column",
+				value: child
+			};
+			else if (hasContent(title)) {
+				const localChildColumns = [];
+				for (const child of collectionChildren(children)) localChildColumns.push({
+					element: child,
+					type: "column"
+				});
+				yield* localChildColumns;
+			}
+		},
+		hasChildNodes: !!childColumns || Boolean(title) && collectionChildren(children).length > 0,
+		props,
+		rendered,
+		shouldInvalidate(newContext) {
+			if (!isTableCollectionContext(newContext)) return true;
+			updateContext(newContext);
+			return false;
+		},
+		textValue,
+		type: "column"
+	};
+	function updateContext(localContext) {
+		for (const node of fullNodes) if (!node.hasChildNodes) localContext.columns.push(node);
+	}
+	updateContext(context);
+};
+export { Column };
+
+//# sourceMappingURL=column.js.map

package/dist/table/column.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"column.js","names":[],"sources":["../../src/table/column.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/table/Column.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 { Key, Node } from \"@solid2-aria/types-shared\";\nimport type { Element as SolidElement } from \"solid-js\";\n\nimport type { PartialNode, CollectionContext } from \"../collections/types\";\nimport { collectionChildren } from \"../collections/types\";\nimport { hasContent } from \"../utils/has-content\";\nimport { isTableCollectionContext } from \"./collection-context\";\nimport type { CollectionBuilderContext } from \"./create-table-state\";\n\n/** Widths that result in a constant pixel value for the same Table width. */\n// match regex: /^(\\d+)(?=%$)/\nexport type ColumnStaticSize = number | `${number}` | `${number}%`;\n\n/**\n * Widths that change size in relation to the remaining space and in ratio to other dynamic columns.\n * All numbers must be integers and greater than 0.\n * FR units take up remaining, if any, space in the table.\n */\n// match regex: /^(\\d+)(?=fr$)/\nexport type ColumnDynamicSize = `${number}fr`;\n\n/** All possible sizes a column can be assigned. */\nexport type ColumnSize = ColumnStaticSize | ColumnDynamicSize;\n\nexport type ColumnElement<_T> = SolidElement;\n\nexport type ColumnRenderer<T> = (item: T) => ColumnElement<T>;\n\nexport interface ColumnProps<T> {\n  key?: Key;\n  \"aria-label\"?: string;\n  /** Rendered contents of the column if `children` contains child columns. */\n  title?: SolidElement;\n  /** Static child columns or content to render as the column header. */\n  children: SolidElement | ColumnElement<T>[];\n  /** A list of child columns used when dynamically rendering nested child columns. */\n  childColumns?: T[];\n  /** The width of the column. */\n  width?: ColumnSize | null;\n  /** The minimum width of the column. */\n  minWidth?: ColumnStaticSize | null;\n  /** The maximum width of the column. */\n  maxWidth?: ColumnStaticSize | null;\n  /** The default width of the column. */\n  defaultWidth?: ColumnSize | null;\n  /** Whether the column allows resizing. */\n  allowsResizing?: boolean;\n  /** Whether the column allows sorting. */\n  allowsSorting?: boolean;\n  /**\n   * Whether a column is a [row header](https://www.w3.org/TR/wai-aria-1.1/#rowheader) and should be\n   * announced by assistive technology during row navigation.\n   */\n  isRowHeader?: boolean;\n  /** A string representation of the column's contents, used for accessibility announcements. */\n  textValue?: string;\n}\n\nfunction Column<T>(props: ColumnProps<T>): SolidElement {\n  return Object.assign([], {\n    getCollectionNode: (context: CollectionContext) =>\n      Column.getCollectionNode(props, context),\n    get key() {\n      return props.key;\n    },\n    props,\n    type: Column,\n  });\n}\n\nColumn.getCollectionNode = function* getCollectionNode<T>(\n  props: ColumnProps<T>,\n  context: CollectionContext\n): Generator<PartialNode<T>, void, Node<T>[]> {\n  if (!isTableCollectionContext<T>(context)) {\n    throw new Error(\"Table collection context is required.\");\n  }\n\n  const { title, children, childColumns } = props;\n  const rendered = title ?? children;\n\n  let textValue = props[\"aria-label\"] ?? \"\";\n\n  if (typeof rendered === \"string\" && rendered !== \"\") {\n    textValue = rendered;\n  }\n\n  if (props.textValue !== undefined && props.textValue !== \"\") {\n    ({ textValue } = props);\n  }\n\n  const fullNodes = yield {\n    *childNodes() {\n      if (childColumns) {\n        for (const child of childColumns) {\n          yield {\n            type: \"column\",\n            value: child,\n          };\n        }\n      } else if (hasContent(title)) {\n        const localChildColumns: PartialNode<T>[] = [];\n\n        for (const child of collectionChildren(children)) {\n          localChildColumns.push({\n            element: child,\n            type: \"column\",\n          });\n        }\n\n        yield* localChildColumns;\n      }\n    },\n    hasChildNodes:\n      !!childColumns ||\n      (Boolean(title) && collectionChildren(children).length > 0),\n    props,\n    rendered,\n    shouldInvalidate(newContext: CollectionContext) {\n      if (!isTableCollectionContext<T>(newContext)) {\n        return true;\n      }\n\n      // This is a bit of a hack, but it works.\n      // If this method is called, then there's a cached version of this node available.\n      // But, we need to keep the list of columns in the new context up to date.\n      updateContext(newContext);\n\n      return false;\n    },\n    textValue,\n    type: \"column\",\n  };\n\n  function updateContext(localContext: CollectionBuilderContext<T>) {\n    // register leaf columns on the context so that <Row> can access them\n    for (const node of fullNodes) {\n      if (!node.hasChildNodes) {\n        localContext.columns.push(node);\n      }\n    }\n  }\n\n  updateContext(context);\n};\n\n/**\n * A Column represents a field of each item within a Table. Columns may also contain nested\n * Column elements to represent column groups. Nested columns can be statically defined as\n * children, or dynamically generated using a function based on the `childColumns` prop.\n */\n// We don't want getCollectionNode to show up in the type definition\nexport { Column };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA2EA,SAAS,OAAU,OAAqC;CACtD,OAAO,OAAO,OAAO,CAAC,GAAG;EACvB,oBAAoB,YAClB,OAAO,kBAAkB,OAAO,OAAO;EACzC,IAAI,MAAM;GACR,OAAO,MAAM;EACf;EACA;EACA,MAAM;CACR,CAAC;AACH;AAEA,OAAO,oBAAoB,UAAU,kBACnC,OACA,SAC4C;CAC5C,IAAI,CAAC,yBAA4B,OAAO,GACtC,MAAM,IAAI,MAAM,uCAAuC;CAGzD,MAAM,EAAE,OAAO,UAAU,iBAAiB;CAC1C,MAAM,WAAW,SAAS;CAE1B,IAAI,YAAY,MAAM,iBAAiB;CAEvC,IAAI,OAAO,aAAa,YAAY,aAAa,IAC/C,YAAY;CAGd,IAAI,MAAM,cAAc,KAAA,KAAa,MAAM,cAAc,IACvD,CAAC,CAAE,aAAc;CAGnB,MAAM,YAAY,MAAM;EACtB,CAAC,aAAa;GACZ,IAAI,cACF,KAAK,MAAM,SAAS,cAClB,MAAM;IACJ,MAAM;IACN,OAAO;GACT;QAEG,IAAI,WAAW,KAAK,GAAG;IAC5B,MAAM,oBAAsC,CAAC;IAE7C,KAAK,MAAM,SAAS,mBAAmB,QAAQ,GAC7C,kBAAkB,KAAK;KACrB,SAAS;KACT,MAAM;IACR,CAAC;IAGH,OAAO;GACT;EACF;EACA,eACE,CAAC,CAAC,gBACD,QAAQ,KAAK,KAAK,mBAAmB,QAAQ,CAAC,CAAC,SAAS;EAC3D;EACA;EACA,iBAAiB,YAA+B;GAC9C,IAAI,CAAC,yBAA4B,UAAU,GACzC,OAAO;GAMT,cAAc,UAAU;GAExB,OAAO;EACT;EACA;EACA,MAAM;CACR;CAEA,SAAS,cAAc,cAA2C;EAEhE,KAAK,MAAM,QAAQ,WACjB,IAAI,CAAC,KAAK,eACR,aAAa,QAAQ,KAAK,IAAI;CAGpC;CAEA,cAAc,OAAO;AACvB"}

package/dist/table/create-table-column-resize-state.d.ts

@@ -0,0 +1,65 @@
+/*
+ * Copyright 2022 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/table/useTableColumnResizeState.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 { GridNode } from "../grid/grid-collection.js";
+import { ColumnSize } from "./column.js";
+import { TableState } from "./create-table-state.js";
+import { Key } from "@solid2-aria/types-shared";
+export interface TableColumnResizeStateProps<T> {
+  /**
+   * Current width of the table or table viewport that the columns
+   * should be calculated against.
+   */
+  tableWidth: number;
+  /** A function that is called to find the default width for a given column. */
+  getDefaultWidth?: (node: GridNode<T>) => ColumnSize | null | undefined;
+  /** A function that is called to find the default minWidth for a given column. */
+  getDefaultMinWidth?: (node: GridNode<T>) => ColumnSize | null | undefined;
+}
+export interface TableColumnResizeState<T> {
+  /**
+   * Called to update the state that a resize event has occurred.
+   * Returns the new widths for all columns based on the resized column.
+   */
+  updateResizedColumns: (key: Key, width: number) => Map<Key, ColumnSize>;
+  /** Callback for when onColumnResize has started. */
+  startResize: (key: Key) => void;
+  /** Callback for when onColumnResize has ended. */
+  endResize: () => void;
+  /** Gets the current width for the specified column. */
+  getColumnWidth: (key: Key) => number;
+  /** Gets the current minWidth for the specified column. */
+  getColumnMinWidth: (key: Key) => number;
+  /** Gets the current maxWidth for the specified column. */
+  getColumnMaxWidth: (key: Key) => number;
+  /** Key of the currently resizing column. */
+  resizingColumn: Key | null;
+  /** A reference to the table state. */
+  tableState: TableState<T>;
+  /** A map of the current column widths. */
+  columnWidths: Map<Key, number>;
+}
+/**
+ * Provides column width state management for a table component with column resizing support.
+ * Handles building a map of column widths calculated from the table's width and any provided column
+ * width information from the collection. In addition, it tracks the currently resizing column and
+ * provides callbacks for updating the widths upon resize operations.
+ *
+ * @param props - Props for the table.
+ * @param state - State for the table, as returned by `createTableState`.
+ */
+export declare function createTableColumnResizeState<T>(props: TableColumnResizeStateProps<T>, state: TableState<T>): TableColumnResizeState<T>;
+//# sourceMappingURL=create-table-column-resize-state.d.ts.map

package/dist/table/create-table-column-resize-state.js

@@ -0,0 +1,100 @@
+/*
+ * Copyright 2022 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/table/useTableColumnResizeState.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 { requireValue } from "../utils/require-value.js";
+import { TableColumnLayout } from "./table-column-layout.js";
+import { createMemo, createRenderEffect, createSignal, untrack } from "solid-js";
+// src/table/create-table-column-resize-state.ts
+/**
+* Provides column width state management for a table component with column resizing support.
+* Handles building a map of column widths calculated from the table's width and any provided column
+* width information from the collection. In addition, it tracks the currently resizing column and
+* provides callbacks for updating the widths upon resize operations.
+*
+* @param props - Props for the table.
+* @param state - State for the table, as returned by `createTableState`.
+*/
+function createTableColumnResizeState(props, state) {
+	const [resizingColumn, setResizingColumn] = createSignal(null, { ownedWrite: true });
+	const columnLayout = createMemo(() => new TableColumnLayout({
+		get getDefaultMinWidth() {
+			return props.getDefaultMinWidth;
+		},
+		get getDefaultWidth() {
+			return props.getDefaultWidth;
+		}
+	}));
+	const columnGroups = createMemo(() => columnLayout().splitColumnsIntoControlledAndUncontrolled(state.collection.columns));
+	const [uncontrolledWidths, setUncontrolledWidths] = createSignal(untrack(() => columnLayout().getInitialUncontrolledWidths(columnGroups()[1])), { ownedWrite: true });
+	let lastColumns = untrack(() => state.collection.columns);
+	createRenderEffect(() => {
+		const { columns } = state.collection;
+		return {
+			columns,
+			widths: columns.length !== lastColumns.length || columns.some((column, i) => column.key !== lastColumns[i]?.key) ? columnLayout().getInitialUncontrolledWidths(columnGroups()[1]) : void 0
+		};
+	}, ({ columns, widths }) => {
+		if (widths) setUncontrolledWidths(widths);
+		lastColumns = columns;
+	});
+	const colWidths = createMemo(() => columnLayout().recombineColumns(state.collection.columns, uncontrolledWidths(), columnGroups()[1], columnGroups()[0]));
+	const startResize = (key) => {
+		setResizingColumn(key);
+	};
+	const updateResizedColumns = (key, width) => {
+		const newSizes = columnLayout().resizeColumnWidth(state.collection, uncontrolledWidths(), key, width);
+		const map = new Map([...columnGroups()[1]].map(([localKey]) => [localKey, requireValue(newSizes.get(localKey), "Resizing must produce a width for each column.")]));
+		map.set(key, width);
+		setUncontrolledWidths(map);
+		return newSizes;
+	};
+	const endResize = () => {
+		setResizingColumn(null);
+	};
+	const columnWidths = createMemo(() => columnLayout().buildColumnWidths(props.tableWidth ?? 0, state.collection, colWidths()));
+	return {
+		get columnWidths() {
+			return columnWidths();
+		},
+		get endResize() {
+			return endResize;
+		},
+		get getColumnMaxWidth() {
+			return (key) => columnLayout().getColumnMaxWidth(key);
+		},
+		get getColumnMinWidth() {
+			return (key) => columnLayout().getColumnMinWidth(key);
+		},
+		get getColumnWidth() {
+			return (key) => columnLayout().getColumnWidth(key);
+		},
+		get resizingColumn() {
+			return resizingColumn();
+		},
+		get startResize() {
+			return startResize;
+		},
+		get tableState() {
+			return state;
+		},
+		get updateResizedColumns() {
+			return updateResizedColumns;
+		}
+	};
+}
+export { createTableColumnResizeState };
+
+//# sourceMappingURL=create-table-column-resize-state.js.map

package/dist/table/create-table-column-resize-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-table-column-resize-state.js","names":[],"sources":["../../src/table/create-table-column-resize-state.ts"],"sourcesContent":["/*\n * Copyright 2022 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/table/useTableColumnResizeState.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 { Key } from \"@solid2-aria/types-shared\";\nimport {\n  createMemo,\n  createSignal,\n  createRenderEffect,\n  untrack,\n} from \"solid-js\";\n\nimport type { GridNode } from \"../grid/grid-collection\";\nimport { requireValue } from \"../utils/require-value\";\nimport type { ColumnSize } from \"./column\";\nimport type { TableState } from \"./create-table-state\";\nimport { TableColumnLayout } from \"./table-column-layout\";\n\nexport interface TableColumnResizeStateProps<T> {\n  /**\n   * Current width of the table or table viewport that the columns\n   * should be calculated against.\n   */\n  tableWidth: number;\n  /** A function that is called to find the default width for a given column. */\n  getDefaultWidth?: (node: GridNode<T>) => ColumnSize | null | undefined;\n  /** A function that is called to find the default minWidth for a given column. */\n  getDefaultMinWidth?: (node: GridNode<T>) => ColumnSize | null | undefined;\n}\n\nexport interface TableColumnResizeState<T> {\n  /**\n   * Called to update the state that a resize event has occurred.\n   * Returns the new widths for all columns based on the resized column.\n   */\n  updateResizedColumns: (key: Key, width: number) => Map<Key, ColumnSize>;\n  /** Callback for when onColumnResize has started. */\n  startResize: (key: Key) => void;\n  /** Callback for when onColumnResize has ended. */\n  endResize: () => void;\n  /** Gets the current width for the specified column. */\n  getColumnWidth: (key: Key) => number;\n  /** Gets the current minWidth for the specified column. */\n  getColumnMinWidth: (key: Key) => number;\n  /** Gets the current maxWidth for the specified column. */\n  getColumnMaxWidth: (key: Key) => number;\n  /** Key of the currently resizing column. */\n  resizingColumn: Key | null;\n  /** A reference to the table state. */\n  tableState: TableState<T>;\n  /** A map of the current column widths. */\n  columnWidths: Map<Key, number>;\n}\n\n/**\n * Provides column width state management for a table component with column resizing support.\n * Handles building a map of column widths calculated from the table's width and any provided column\n * width information from the collection. In addition, it tracks the currently resizing column and\n * provides callbacks for updating the widths upon resize operations.\n *\n * @param props - Props for the table.\n * @param state - State for the table, as returned by `createTableState`.\n */\nexport function createTableColumnResizeState<T>(\n  props: TableColumnResizeStateProps<T>,\n  state: TableState<T>\n): TableColumnResizeState<T> {\n  const [resizingColumn, setResizingColumn] = createSignal<Key | null>(null, {\n    ownedWrite: true,\n  });\n\n  const columnLayout = createMemo(\n    () =>\n      new TableColumnLayout({\n        get getDefaultMinWidth() {\n          return props.getDefaultMinWidth;\n        },\n        get getDefaultWidth() {\n          return props.getDefaultWidth;\n        },\n      })\n  );\n\n  const columnGroups = createMemo(() =>\n    columnLayout().splitColumnsIntoControlledAndUncontrolled(\n      state.collection.columns\n    )\n  );\n\n  // uncontrolled column widths\n  const [uncontrolledWidths, setUncontrolledWidths] = createSignal(\n    untrack(() =>\n      columnLayout().getInitialUncontrolledWidths(columnGroups()[1])\n    ),\n    { ownedWrite: true }\n  );\n\n  // Update uncontrolled widths if the columns changed.\n  let lastColumns = untrack(() => state.collection.columns);\n\n  createRenderEffect(\n    () => {\n      const { columns } = state.collection;\n\n      const changed =\n        columns.length !== lastColumns.length ||\n        columns.some((column, i) => column.key !== lastColumns[i]?.key);\n\n      return {\n        columns,\n        widths: changed\n          ? columnLayout().getInitialUncontrolledWidths(columnGroups()[1])\n          : undefined,\n      };\n    },\n    ({ columns, widths }) => {\n      if (widths) {\n        setUncontrolledWidths(widths);\n      }\n\n      lastColumns = columns;\n    }\n  );\n\n  // combine columns back into one map that maintains same order as the columns\n  const colWidths = createMemo(() =>\n    columnLayout().recombineColumns(\n      state.collection.columns,\n      uncontrolledWidths(),\n      columnGroups()[1],\n      columnGroups()[0]\n    )\n  );\n\n  const startResize = (key: Key) => {\n    setResizingColumn(key);\n  };\n\n  const updateResizedColumns = (\n    key: Key,\n    width: number\n  ): Map<Key, ColumnSize> => {\n    const newSizes = columnLayout().resizeColumnWidth(\n      state.collection,\n      uncontrolledWidths(),\n      key,\n      width\n    );\n\n    const map = new Map(\n      [...columnGroups()[1]].map(([localKey]) => [\n        localKey,\n        requireValue(\n          newSizes.get(localKey),\n          \"Resizing must produce a width for each column.\"\n        ),\n      ])\n    );\n\n    map.set(key, width);\n    setUncontrolledWidths(map);\n\n    return newSizes;\n  };\n\n  const endResize = () => {\n    setResizingColumn(null);\n  };\n\n  const columnWidths = createMemo(() =>\n    columnLayout().buildColumnWidths(\n      props.tableWidth ?? 0,\n      state.collection,\n      colWidths()\n    )\n  );\n\n  return {\n    get columnWidths() {\n      return columnWidths();\n    },\n    get endResize() {\n      return endResize;\n    },\n    get getColumnMaxWidth() {\n      return (key: Key) => columnLayout().getColumnMaxWidth(key);\n    },\n    get getColumnMinWidth() {\n      return (key: Key) => columnLayout().getColumnMinWidth(key);\n    },\n    get getColumnWidth() {\n      return (key: Key) => columnLayout().getColumnWidth(key);\n    },\n    get resizingColumn() {\n      return resizingColumn();\n    },\n    get startResize() {\n      return startResize;\n    },\n    get tableState() {\n      return state;\n    },\n    get updateResizedColumns() {\n      return updateResizedColumns;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4EA,SAAgB,6BACd,OACA,OAC2B;CAC3B,MAAM,CAAC,gBAAgB,qBAAqB,aAAyB,MAAM,EACzE,YAAY,KACd,CAAC;CAED,MAAM,eAAe,iBAEjB,IAAI,kBAAkB;EACpB,IAAI,qBAAqB;GACvB,OAAO,MAAM;EACf;EACA,IAAI,kBAAkB;GACpB,OAAO,MAAM;EACf;CACF,CAAC,CACL;CAEA,MAAM,eAAe,iBACnB,aAAa,CAAC,CAAC,0CACb,MAAM,WAAW,OACnB,CACF;CAGA,MAAM,CAAC,oBAAoB,yBAAyB,aAClD,cACE,aAAa,CAAC,CAAC,6BAA6B,aAAa,CAAC,CAAC,EAAE,CAC/D,GACA,EAAE,YAAY,KAAK,CACrB;CAGA,IAAI,cAAc,cAAc,MAAM,WAAW,OAAO;CAExD,yBACQ;EACJ,MAAM,EAAE,YAAY,MAAM;EAM1B,OAAO;GACL;GACA,QALA,QAAQ,WAAW,YAAY,UAC/B,QAAQ,MAAM,QAAQ,MAAM,OAAO,QAAQ,YAAY,EAAE,EAAE,GAAG,IAK1D,aAAa,CAAC,CAAC,6BAA6B,aAAa,CAAC,CAAC,EAAE,IAC7D,KAAA;EACN;CACF,IACC,EAAE,SAAS,aAAa;EACvB,IAAI,QACF,sBAAsB,MAAM;EAG9B,cAAc;CAChB,CACF;CAGA,MAAM,YAAY,iBAChB,aAAa,CAAC,CAAC,iBACb,MAAM,WAAW,SACjB,mBAAmB,GACnB,aAAa,CAAC,CAAC,IACf,aAAa,CAAC,CAAC,EACjB,CACF;CAEA,MAAM,eAAe,QAAa;EAChC,kBAAkB,GAAG;CACvB;CAEA,MAAM,wBACJ,KACA,UACyB;EACzB,MAAM,WAAW,aAAa,CAAC,CAAC,kBAC9B,MAAM,YACN,mBAAmB,GACnB,KACA,KACF;EAEA,MAAM,MAAM,IAAI,IACd,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CACzC,UACA,aACE,SAAS,IAAI,QAAQ,GACrB,gDACF,CACF,CAAC,CACH;EAEA,IAAI,IAAI,KAAK,KAAK;EAClB,sBAAsB,GAAG;EAEzB,OAAO;CACT;CAEA,MAAM,kBAAkB;EACtB,kBAAkB,IAAI;CACxB;CAEA,MAAM,eAAe,iBACnB,aAAa,CAAC,CAAC,kBACb,MAAM,cAAc,GACpB,MAAM,YACN,UAAU,CACZ,CACF;CAEA,OAAO;EACL,IAAI,eAAe;GACjB,OAAO,aAAa;EACtB;EACA,IAAI,YAAY;GACd,OAAO;EACT;EACA,IAAI,oBAAoB;GACtB,QAAQ,QAAa,aAAa,CAAC,CAAC,kBAAkB,GAAG;EAC3D;EACA,IAAI,oBAAoB;GACtB,QAAQ,QAAa,aAAa,CAAC,CAAC,kBAAkB,GAAG;EAC3D;EACA,IAAI,iBAAiB;GACnB,QAAQ,QAAa,aAAa,CAAC,CAAC,eAAe,GAAG;EACxD;EACA,IAAI,iBAAiB;GACnB,OAAO,eAAe;EACxB;EACA,IAAI,cAAc;GAChB,OAAO;EACT;EACA,IAAI,aAAa;GACf,OAAO;EACT;EACA,IAAI,uBAAuB;GACzB,OAAO;EACT;CACF;AACF"}

package/dist/table/create-table-state.d.ts

@@ -0,0 +1,112 @@
+/*
+ * 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/table/useTableState.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 { MultipleSelectionState } from "../selection/types.js";
+import { MultipleSelectionStateProps } from "../selection/create-multiple-selection-state.js";
+import { GridState } from "../grid/create-grid-state.js";
+import { ITableCollection } from "./table-collection.js";
+import { Element } from "solid-js";
+import { Expandable, Key, MultipleSelection, Node, SelectionMode, SortDescriptor, Sortable } from "@solid2-aria/types-shared";
+export interface TableProps<_T> extends MultipleSelection, Sortable, Expandable {
+  /** The elements that make up the table. Includes the TableHeader, TableBody, Columns, and Rows. */
+  children: [Element, Element];
+  /** A list of row keys to disable. */
+  disabledKeys?: Iterable<Key>;
+  /**
+   * Whether pressing the escape key should clear selection in the table or not.
+   *
+   * Most experiences should not modify this option as it eliminates a keyboard user's ability to
+   * easily clear selection. Only use if the escape key is being handled externally or should not
+   * trigger selection clearing contextually.
+   *
+   * @default 'clearSelection'
+   */
+  escapeKeyBehavior?: "clearSelection" | "none";
+  /** Whether selection should occur on press up instead of press down. */
+  shouldSelectOnPressUp?: boolean;
+  /** The id of the column that displays hierarchical data. */
+  treeColumn?: Key;
+  /**
+   * Whether keyboard navigation to focusable elements within the cells is
+   * via the left/right arrow keys or the tab key.
+   *
+   * @default 'arrow'
+   */
+  keyboardNavigationBehavior?: "arrow" | "tab";
+}
+export interface TableState<T> extends GridState<T, ITableCollection<T>> {
+  /** A collection of rows and columns in the table. */
+  collection: ITableCollection<T>;
+  /** Whether the row selection checkboxes should be displayed. */
+  showSelectionCheckboxes: boolean;
+  /** The current sorted column and direction. */
+  sortDescriptor: SortDescriptor | null;
+  /** Calls the provided onSortChange handler with the provided column key and sort direction. */
+  sort: (columnKey: Key, direction?: "ascending" | "descending") => void;
+  /**
+   * Whether keyboard navigation is disabled, such as when the arrow keys should be handled by a
+   * component within a cell.
+   */
+  isKeyboardNavigationDisabled: boolean;
+  /**
+   * Set whether keyboard navigation is disabled, such as when the arrow keys should be handled by a
+   * component within a cell.
+   */
+  setKeyboardNavigationDisabled: (val: boolean) => void;
+  /** A set of keys for items that are expanded. */
+  expandedKeys: Set<Key>;
+  /** Toggles the expanded state for a row by its key. */
+  toggleKey: (key: Key) => void;
+  /** The id of the column that displays hierarchical data. */
+  treeColumn: Key | null;
+}
+export interface CollectionBuilderContext<T> {
+  showSelectionCheckboxes: boolean;
+  showDragButtons: boolean;
+  selectionMode: SelectionMode;
+  columns: Node<T>[];
+}
+export interface TableStateProps<T> extends MultipleSelectionStateProps, Expandable, Sortable {
+  /** The elements that make up the table. Includes the TableHeader, TableBody, Columns, and Rows. */
+  children?: [Element, Element];
+  /** A pre-constructed collection to use instead of building one from items and children. */
+  collection?: ITableCollection<T>;
+  /** Whether the row selection checkboxes should be displayed. */
+  showSelectionCheckboxes?: boolean;
+  /**
+   * Whether the row drag button should be displayed.
+   *
+   * @private
+   */
+  showDragButtons?: boolean;
+  /**
+   * Do not use unless you know what you're doing.
+   * @private
+   */
+  UNSAFE_selectionState?: MultipleSelectionState;
+  /** The id of the column that displays hierarchical data. */
+  treeColumn?: Key;
+}
+/**
+ * Provides state management for a table component. Handles building a collection of columns and
+ * rows from props. In addition, it tracks row selection and manages sort order changes.
+ */
+export declare function createTableState<T extends object>(props: TableStateProps<T>): TableState<T>;
+/**
+ * Filters a collection using the provided filter function and returns a new TableState.
+ */
+export declare function UNSTABLE_createFilteredTableState<T extends object>(state: TableState<T>, filterFn: ((nodeValue: string, node: Node<T>) => boolean) | null | undefined): TableState<T>;
+//# sourceMappingURL=create-table-state.d.ts.map

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

@@ -0,0 +1,122 @@
+/*
+ * 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/table/useTableState.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 { requireValue } from "../utils/require-value.js";
+import { createGridState } from "../grid/create-grid-state.js";
+import { TableCollection } from "./table-collection.js";
+import { createMemo, createSignal, merge, untrack } from "solid-js";
+// src/table/create-table-state.ts
+const OPPOSITE_SORT_DIRECTION = {
+	get ascending() {
+		return "descending";
+	},
+	get descending() {
+		return "ascending";
+	}
+};
+/**
+* Provides state management for a table component. Handles building a collection of columns and
+* rows from props. In addition, it tracks row selection and manages sort order changes.
+*/
+function createTableState(props) {
+	const [isKeyboardNavigationDisabled, setKeyboardNavigationDisabled] = createSignal(false, { ownedWrite: true });
+	const context = createMemo(() => {
+		props.children;
+		return {
+			columns: [],
+			selectionMode: props.selectionMode ?? "none",
+			showDragButtons: props.showDragButtons === true,
+			showSelectionCheckboxes: props.showSelectionCheckboxes === true && (props.selectionMode ?? "none") !== "none"
+		};
+	});
+	const collection = createCollection(props, (nodes) => new TableCollection(nodes, null, context()), context);
+	const gridState = createGridState(merge(props, {
+		get collection() {
+			return collection();
+		},
+		get disabledBehavior() {
+			return props.disabledBehavior ?? "selection";
+		}
+	}));
+	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);
+	});
+	return {
+		get collection() {
+			return collection();
+		},
+		get disabledKeys() {
+			return gridState.disabledKeys;
+		},
+		get expandedKeys() {
+			return expandedKeys();
+		},
+		get isKeyboardNavigationDisabled() {
+			return collection().size === 0 || isKeyboardNavigationDisabled();
+		},
+		get selectionManager() {
+			return gridState.selectionManager;
+		},
+		get setKeyboardNavigationDisabled() {
+			return setKeyboardNavigationDisabled;
+		},
+		get showSelectionCheckboxes() {
+			return props.showSelectionCheckboxes === true || false;
+		},
+		sort(columnKey, direction) {
+			const current = props.sortDescriptor;
+			const nextDirection = direction ?? (current?.column === columnKey ? OPPOSITE_SORT_DIRECTION[current.direction] : "ascending");
+			props.onSortChange?.({
+				column: columnKey,
+				direction: nextDirection
+			});
+		},
+		get sortDescriptor() {
+			return props.sortDescriptor ?? null;
+		},
+		toggleKey(key) {
+			setExpandedKeys((keys) => {
+				const newKeys = new Set(keys);
+				if (newKeys.has(key)) newKeys.delete(key);
+				else newKeys.add(key);
+				return newKeys;
+			});
+		},
+		get treeColumn() {
+			return props.treeColumn ?? null;
+		}
+	};
+}
+/**
+* Filters a collection using the provided filter function and returns a new TableState.
+*/
+function UNSTABLE_createFilteredTableState(state, filterFn) {
+	const collection = createMemo(() => filterFn ? requireValue(state.collection.filter, "Expected state.collection.filter to exist.")(filterFn) : state.collection);
+	const selectionManager = createMemo(() => state.selectionManager.withCollection(collection()));
+	return merge(state, {
+		get collection() {
+			return collection();
+		},
+		get selectionManager() {
+			return selectionManager();
+		}
+	});
+}
+export { UNSTABLE_createFilteredTableState, createTableState };
+
+//# sourceMappingURL=create-table-state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-table-state.js","names":[],"sources":["../../src/table/create-table-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/table/useTableState.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  Expandable,\n  Key,\n  MultipleSelection,\n  Node,\n  SelectionMode,\n  Sortable,\n  SortDescriptor,\n  SortDirection,\n} from \"@solid2-aria/types-shared\";\nimport type { Element as SolidElement } from \"solid-js\";\nimport { createMemo, createSignal, merge, untrack } from \"solid-js\";\n\nimport { createCollection } from \"../collections/create-collection\";\nimport { createGridState } from \"../grid/create-grid-state\";\nimport type { GridState } from \"../grid/create-grid-state\";\nimport type { MultipleSelectionStateProps } from \"../selection/create-multiple-selection-state\";\nimport type { MultipleSelectionState } from \"../selection/types\";\nimport { createControlledSignal } from \"../utils/create-controlled-signal\";\nimport { requireValue } from \"../utils/require-value\";\nimport { TableCollection } from \"./table-collection\";\nimport type { ITableCollection } from \"./table-collection\";\n\nexport interface TableProps<_T>\n  extends MultipleSelection, Sortable, Expandable {\n  /** The elements that make up the table. Includes the TableHeader, TableBody, Columns, and Rows. */\n  children: [SolidElement, SolidElement];\n  /** A list of row keys to disable. */\n  disabledKeys?: Iterable<Key>;\n  /**\n   * Whether pressing the escape key should clear selection in the table or not.\n   *\n   * Most experiences should not modify this option as it eliminates a keyboard user's ability to\n   * easily clear selection. Only use if the escape key is being handled externally or should not\n   * trigger selection clearing contextually.\n   *\n   * @default 'clearSelection'\n   */\n  escapeKeyBehavior?: \"clearSelection\" | \"none\";\n  /** Whether selection should occur on press up instead of press down. */\n  shouldSelectOnPressUp?: boolean;\n  /** The id of the column that displays hierarchical data. */\n  treeColumn?: Key;\n  /**\n   * Whether keyboard navigation to focusable elements within the cells is\n   * via the left/right arrow keys or the tab key.\n   *\n   * @default 'arrow'\n   */\n  keyboardNavigationBehavior?: \"arrow\" | \"tab\";\n}\n\nexport interface TableState<T> extends GridState<T, ITableCollection<T>> {\n  /** A collection of rows and columns in the table. */\n  collection: ITableCollection<T>;\n  /** Whether the row selection checkboxes should be displayed. */\n  showSelectionCheckboxes: boolean;\n  /** The current sorted column and direction. */\n  sortDescriptor: SortDescriptor | null;\n  /** Calls the provided onSortChange handler with the provided column key and sort direction. */\n  sort: (columnKey: Key, direction?: \"ascending\" | \"descending\") => void;\n  /**\n   * Whether keyboard navigation is disabled, such as when the arrow keys should be handled by a\n   * component within a cell.\n   */\n  isKeyboardNavigationDisabled: boolean;\n  /**\n   * Set whether keyboard navigation is disabled, such as when the arrow keys should be handled by a\n   * component within a cell.\n   */\n  setKeyboardNavigationDisabled: (val: boolean) => void;\n  /** A set of keys for items that are expanded. */\n  expandedKeys: Set<Key>;\n  /** Toggles the expanded state for a row by its key. */\n  toggleKey: (key: Key) => void;\n  /** The id of the column that displays hierarchical data. */\n  treeColumn: Key | null;\n}\n\nexport interface CollectionBuilderContext<T> {\n  showSelectionCheckboxes: boolean;\n  showDragButtons: boolean;\n  selectionMode: SelectionMode;\n  columns: Node<T>[];\n}\n\nexport interface TableStateProps<T>\n  extends MultipleSelectionStateProps, Expandable, Sortable {\n  /** The elements that make up the table. Includes the TableHeader, TableBody, Columns, and Rows. */\n  children?: [SolidElement, SolidElement];\n  /** A pre-constructed collection to use instead of building one from items and children. */\n  collection?: ITableCollection<T>;\n  /** Whether the row selection checkboxes should be displayed. */\n  showSelectionCheckboxes?: boolean;\n  /**\n   * Whether the row drag button should be displayed.\n   *\n   * @private\n   */\n  showDragButtons?: boolean;\n  /**\n   * Do not use unless you know what you're doing.\n   * @private\n   */\n  UNSAFE_selectionState?: MultipleSelectionState;\n  /** The id of the column that displays hierarchical data. */\n  treeColumn?: Key;\n}\n\nconst OPPOSITE_SORT_DIRECTION: Record<SortDirection, SortDirection> = {\n  get ascending(): SortDirection {\n    return \"descending\";\n  },\n  get descending(): SortDirection {\n    return \"ascending\";\n  },\n};\n\n/**\n * Provides state management for a table component. Handles building a collection of columns and\n * rows from props. In addition, it tracks row selection and manages sort order changes.\n */\nexport function createTableState<T extends object>(\n  props: TableStateProps<T>\n): TableState<T> {\n  const [isKeyboardNavigationDisabled, setKeyboardNavigationDisabled] =\n    createSignal(false, { ownedWrite: true });\n\n  const context = createMemo<CollectionBuilderContext<T>>(() => {\n    const _children = props.children;\n\n    return {\n      columns: [],\n      selectionMode: props.selectionMode ?? \"none\",\n      showDragButtons: props.showDragButtons === true,\n      showSelectionCheckboxes:\n        props.showSelectionCheckboxes === true &&\n        (props.selectionMode ?? \"none\") !== \"none\",\n    };\n  });\n\n  const collection = createCollection<T, ITableCollection<T>>(\n    props,\n    (nodes) => new TableCollection(nodes, null, context()),\n    context\n  );\n\n  const gridState = createGridState(\n    merge(props, {\n      get collection() {\n        return collection();\n      },\n      get disabledBehavior() {\n        return props.disabledBehavior ?? \"selection\";\n      },\n    })\n  );\n\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  return {\n    get collection() {\n      return collection();\n    },\n    get disabledKeys() {\n      return gridState.disabledKeys;\n    },\n    get expandedKeys() {\n      return expandedKeys();\n    },\n    get isKeyboardNavigationDisabled() {\n      return collection().size === 0 || isKeyboardNavigationDisabled();\n    },\n    get selectionManager() {\n      return gridState.selectionManager;\n    },\n    get setKeyboardNavigationDisabled() {\n      return setKeyboardNavigationDisabled;\n    },\n    get showSelectionCheckboxes() {\n      return props.showSelectionCheckboxes === true || false;\n    },\n    sort(columnKey: Key, direction?: \"ascending\" | \"descending\") {\n      const current = props.sortDescriptor;\n\n      const nextDirection =\n        direction ??\n        (current?.column === columnKey\n          ? OPPOSITE_SORT_DIRECTION[current.direction]\n          : \"ascending\");\n\n      props.onSortChange?.({ column: columnKey, direction: nextDirection });\n    },\n    get sortDescriptor() {\n      return props.sortDescriptor ?? null;\n    },\n    toggleKey(key) {\n      setExpandedKeys((keys) => {\n        const newKeys = new Set(keys);\n\n        if (newKeys.has(key)) {\n          newKeys.delete(key);\n        } else {\n          newKeys.add(key);\n        }\n\n        return newKeys;\n      });\n    },\n    get treeColumn() {\n      return props.treeColumn ?? null;\n    },\n  };\n}\n\n/**\n * Filters a collection using the provided filter function and returns a new TableState.\n */\nexport function UNSTABLE_createFilteredTableState<T extends object>(\n  state: TableState<T>,\n  filterFn: ((nodeValue: string, node: Node<T>) => boolean) | null | undefined\n): TableState<T> {\n  const collection = createMemo(() =>\n    filterFn\n      ? requireValue(\n          state.collection.filter,\n          \"Expected state.collection.filter to exist.\"\n        )(filterFn)\n      : state.collection\n  );\n\n  const selectionManager = createMemo(() =>\n    state.selectionManager.withCollection(collection())\n  );\n\n  // handle focus key reset? That logic is in createGridState\n  return merge(state, {\n    get collection() {\n      return collection();\n    },\n    get selectionManager() {\n      return selectionManager();\n    },\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA8HA,MAAM,0BAAgE;CACpE,IAAI,YAA2B;EAC7B,OAAO;CACT;CACA,IAAI,aAA4B;EAC9B,OAAO;CACT;AACF;;;;;AAMA,SAAgB,iBACd,OACe;CACf,MAAM,CAAC,8BAA8B,iCACnC,aAAa,OAAO,EAAE,YAAY,KAAK,CAAC;CAE1C,MAAM,UAAU,iBAA8C;EAC1C,MAAM;EAExB,OAAO;GACL,SAAS,CAAC;GACV,eAAe,MAAM,iBAAiB;GACtC,iBAAiB,MAAM,oBAAoB;GAC3C,yBACE,MAAM,4BAA4B,SACjC,MAAM,iBAAiB,YAAY;EACxC;CACF,CAAC;CAED,MAAM,aAAa,iBACjB,QACC,UAAU,IAAI,gBAAgB,OAAO,MAAM,QAAQ,CAAC,GACrD,OACF;CAEA,MAAM,YAAY,gBAChB,MAAM,OAAO;EACX,IAAI,aAAa;GACf,OAAO,WAAW;EACpB;EACA,IAAI,mBAAmB;GACrB,OAAO,MAAM,oBAAoB;EACnC;CACF,CAAC,CACH;CAEA,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,OAAO;EACL,IAAI,aAAa;GACf,OAAO,WAAW;EACpB;EACA,IAAI,eAAe;GACjB,OAAO,UAAU;EACnB;EACA,IAAI,eAAe;GACjB,OAAO,aAAa;EACtB;EACA,IAAI,+BAA+B;GACjC,OAAO,WAAW,CAAC,CAAC,SAAS,KAAK,6BAA6B;EACjE;EACA,IAAI,mBAAmB;GACrB,OAAO,UAAU;EACnB;EACA,IAAI,gCAAgC;GAClC,OAAO;EACT;EACA,IAAI,0BAA0B;GAC5B,OAAO,MAAM,4BAA4B,QAAQ;EACnD;EACA,KAAK,WAAgB,WAAwC;GAC3D,MAAM,UAAU,MAAM;GAEtB,MAAM,gBACJ,cACC,SAAS,WAAW,YACjB,wBAAwB,QAAQ,aAChC;GAEN,MAAM,eAAe;IAAE,QAAQ;IAAW,WAAW;GAAc,CAAC;EACtE;EACA,IAAI,iBAAiB;GACnB,OAAO,MAAM,kBAAkB;EACjC;EACA,UAAU,KAAK;GACb,iBAAiB,SAAS;IACxB,MAAM,UAAU,IAAI,IAAI,IAAI;IAE5B,IAAI,QAAQ,IAAI,GAAG,GACjB,QAAQ,OAAO,GAAG;SAElB,QAAQ,IAAI,GAAG;IAGjB,OAAO;GACT,CAAC;EACH;EACA,IAAI,aAAa;GACf,OAAO,MAAM,cAAc;EAC7B;CACF;AACF;;;;AAKA,SAAgB,kCACd,OACA,UACe;CACf,MAAM,aAAa,iBACjB,WACI,aACE,MAAM,WAAW,QACjB,4CACF,CAAC,CAAC,QAAQ,IACV,MAAM,UACZ;CAEA,MAAM,mBAAmB,iBACvB,MAAM,iBAAiB,eAAe,WAAW,CAAC,CACpD;CAGA,OAAO,MAAM,OAAO;EAClB,IAAI,aAAa;GACf,OAAO,WAAW;EACpB;EACA,IAAI,mBAAmB;GACrB,OAAO,iBAAiB;EAC1B;CACF,CAAC;AACH"}

package/dist/table/create-tree-grid-state.d.ts

@@ -0,0 +1,44 @@
+/*
+ * Copyright 2023 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/table/useTreeGridState.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 { GridNode } from "../grid/grid-collection.js";
+import { TableState, TableStateProps } from "./create-table-state.js";
+import { Key } from "@solid2-aria/types-shared";
+export interface TreeGridState<T> extends Omit<TableState<T>, "expandedKeys"> {
+  /** A set of keys for items that are expanded. */
+  expandedKeys: "all" | Set<Key>;
+  /** Toggles the expanded state for a row by its key. */
+  toggleKey: (key: Key) => void;
+  /** The key map containing nodes representing the collection's tree grid structure. */
+  keyMap: Map<Key, GridNode<T>>;
+  /** The number of leaf columns provided by the user. */
+  userColumnCount: number;
+}
+export interface TreeGridStateProps<T> extends Omit<TableStateProps<T>, "collection"> {
+  /** The currently expanded keys in the collection (controlled). */
+  UNSTABLE_expandedKeys?: "all" | Iterable<Key>;
+  /** The initial expanded keys in the collection (uncontrolled). */
+  UNSTABLE_defaultExpandedKeys?: "all" | Iterable<Key>;
+  /** Handler that is called when items are expanded or collapsed. */
+  UNSTABLE_onExpandedChange?: (keys: Set<Key>) => void;
+}
+/**
+ * Provides state management for a tree grid component. Handles building a collection of columns and
+ * rows from props. In addition, it tracks and manages expanded rows, row selection, and sort order
+ * changes.
+ */
+export declare function UNSTABLE_createTreeGridState<T extends object>(props: TreeGridStateProps<T>): TreeGridState<T>;
+//# sourceMappingURL=create-tree-grid-state.d.ts.map