@tanstack/table-core 9.0.0-alpha.43 → 9.0.0-alpha.47

package/dist/features/global-filtering/globalFilteringFeature.utils.d.cts

@@ -5,10 +5,61 @@ import { TableFeatures } from "../../types/TableFeatures.cjs";
 import { Table_Internal } from "../../types/Table.cjs";
 
 //#region src/features/global-filtering/globalFilteringFeature.utils.d.ts
+/**
+ * Returns whether a column can use global filter.
+ *
+ * This combines column options, table options, and any required accessor or feature state for the capability.
+ *
+ * @example
+ * ```ts
+ * const value = column_getCanGlobalFilter(column)
+ * ```
+ */
 declare function column_getCanGlobalFilter<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column_Internal<TFeatures, TData, TValue>): boolean;
+/**
+ * Returns global auto filter fn for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getGlobalAutoFilterFn(table)
+ * ```
+ */
 declare function table_getGlobalAutoFilterFn(): FilterFn<any, any>;
+/**
+ * Returns global filter fn for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getGlobalFilterFn(table)
+ * ```
+ */
 declare function table_getGlobalFilterFn<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): FilterFn<TFeatures, TData> | FilterFn<TFeatures, TData> | undefined;
+/**
+ * Updates the table's global filter state slice.
+ *
+ * The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.
+ *
+ * @example
+ * ```ts
+ * table_setGlobalFilter(table, (old) => old)
+ * ```
+ */
 declare function table_setGlobalFilter<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, updater: any): void;
+/**
+ * Resets the table's global filter state slice.
+ *
+ * By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.
+ *
+ * @example
+ * ```ts
+ * table_resetGlobalFilter(table)
+ * table_resetGlobalFilter(table, true)
+ * ```
+ */
 declare function table_resetGlobalFilter<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean): void;
 //#endregion
 export { column_getCanGlobalFilter, table_getGlobalAutoFilterFn, table_getGlobalFilterFn, table_resetGlobalFilter, table_setGlobalFilter };

package/dist/features/global-filtering/globalFilteringFeature.utils.d.ts

@@ -5,10 +5,61 @@ import { TableFeatures } from "../../types/TableFeatures.js";
 import { Table_Internal } from "../../types/Table.js";
 
 //#region src/features/global-filtering/globalFilteringFeature.utils.d.ts
+/**
+ * Returns whether a column can use global filter.
+ *
+ * This combines column options, table options, and any required accessor or feature state for the capability.
+ *
+ * @example
+ * ```ts
+ * const value = column_getCanGlobalFilter(column)
+ * ```
+ */
 declare function column_getCanGlobalFilter<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column_Internal<TFeatures, TData, TValue>): boolean;
+/**
+ * Returns global auto filter fn for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getGlobalAutoFilterFn(table)
+ * ```
+ */
 declare function table_getGlobalAutoFilterFn(): FilterFn<any, any>;
+/**
+ * Returns global filter fn for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = table_getGlobalFilterFn(table)
+ * ```
+ */
 declare function table_getGlobalFilterFn<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): FilterFn<TFeatures, TData> | FilterFn<TFeatures, TData> | undefined;
+/**
+ * Updates the table's global filter state slice.
+ *
+ * The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.
+ *
+ * @example
+ * ```ts
+ * table_setGlobalFilter(table, (old) => old)
+ * ```
+ */
 declare function table_setGlobalFilter<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, updater: any): void;
+/**
+ * Resets the table's global filter state slice.
+ *
+ * By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.
+ *
+ * @example
+ * ```ts
+ * table_resetGlobalFilter(table)
+ * table_resetGlobalFilter(table, true)
+ * ```
+ */
 declare function table_resetGlobalFilter<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean): void;
 //#endregion
 export { column_getCanGlobalFilter, table_getGlobalAutoFilterFn, table_getGlobalFilterFn, table_resetGlobalFilter, table_setGlobalFilter };

package/dist/features/global-filtering/globalFilteringFeature.utils.js

@@ -2,22 +2,73 @@ import { cloneState, isFunction } from "../../utils.js";
 import { filterFn_includesString } from "../../fns/filterFns.js";
 
 //#region src/features/global-filtering/globalFilteringFeature.utils.ts
+/**
+* Returns whether a column can use global filter.
+*
+* This combines column options, table options, and any required accessor or feature state for the capability.
+*
+* @example
+* ```ts
+* const value = column_getCanGlobalFilter(column)
+* ```
+*/
 function column_getCanGlobalFilter(column) {
 	var _column$table$options, _column$table$options2;
 	return (column.columnDef.enableGlobalFilter ?? true) && (column.table.options.enableGlobalFilter ?? true) && (column.table.options.enableFilters ?? true) && (((_column$table$options = (_column$table$options2 = column.table.options).getColumnCanGlobalFilter) === null || _column$table$options === void 0 ? void 0 : _column$table$options.call(_column$table$options2, column)) ?? true) && !!column.accessorFn;
 }
+/**
+* Returns global auto filter fn for the table.
+*
+* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+*
+* @example
+* ```ts
+* const value = table_getGlobalAutoFilterFn(table)
+* ```
+*/
 function table_getGlobalAutoFilterFn() {
 	return filterFn_includesString;
 }
+/**
+* Returns global filter fn for the table.
+*
+* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+*
+* @example
+* ```ts
+* const value = table_getGlobalFilterFn(table)
+* ```
+*/
 function table_getGlobalFilterFn(table) {
 	const { globalFilterFn } = table.options;
 	const filterFns = table._rowModelFns.filterFns;
 	return isFunction(globalFilterFn) ? globalFilterFn : globalFilterFn === "auto" ? table_getGlobalAutoFilterFn() : filterFns === null || filterFns === void 0 ? void 0 : filterFns[globalFilterFn];
 }
+/**
+* Updates the table's global filter state slice.
+*
+* The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.
+*
+* @example
+* ```ts
+* table_setGlobalFilter(table, (old) => old)
+* ```
+*/
 function table_setGlobalFilter(table, updater) {
 	var _table$options$onGlob, _table$options;
 	(_table$options$onGlob = (_table$options = table.options).onGlobalFilterChange) === null || _table$options$onGlob === void 0 || _table$options$onGlob.call(_table$options, updater);
 }
+/**
+* Resets the table's global filter state slice.
+*
+* By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.
+*
+* @example
+* ```ts
+* table_resetGlobalFilter(table)
+* table_resetGlobalFilter(table, true)
+* ```
+*/
 function table_resetGlobalFilter(table, defaultState) {
 	table_setGlobalFilter(table, defaultState ? void 0 : cloneState(table.initialState.globalFilter));
 }

package/dist/features/global-filtering/globalFilteringFeature.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"globalFilteringFeature.utils.js","names":[],"sources":["../../../src/features/global-filtering/globalFilteringFeature.utils.ts"],"sourcesContent":["import { filterFn_includesString } from '../../fns/filterFns'\nimport { cloneState, isFunction } from '../../utils'\nimport type { Column_Internal } from '../../types/Column'\nimport type { FilterFn } from '../column-filtering/columnFilteringFeature.types'\nimport type { CellData, RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Table_Internal } from '../../types/Table'\n\nexport function column_getCanGlobalFilter<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>): boolean {\n  return (\n    (column.columnDef.enableGlobalFilter ?? true) &&\n    (column.table.options.enableGlobalFilter ?? true) &&\n    (column.table.options.enableFilters ?? true) &&\n    (column.table.options.getColumnCanGlobalFilter?.(column) ?? true) &&\n    !!column.accessorFn\n  )\n}\n\nexport function table_getGlobalAutoFilterFn() {\n  return filterFn_includesString\n}\n\nexport function table_getGlobalFilterFn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): FilterFn<TFeatures, TData> | FilterFn<TFeatures, TData> | undefined {\n  const { globalFilterFn: globalFilterFn } = table.options\n  const filterFns: Record<string, FilterFn<TFeatures, TData>> | undefined =\n    table._rowModelFns.filterFns\n\n  return isFunction(globalFilterFn)\n    ? globalFilterFn\n    : globalFilterFn === 'auto'\n      ? table_getGlobalAutoFilterFn()\n      : filterFns?.[globalFilterFn as string]\n}\n\nexport function table_setGlobalFilter<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, updater: any) {\n  table.options.onGlobalFilterChange?.(updater)\n}\n\nexport function table_resetGlobalFilter<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean) {\n  table_setGlobalFilter(\n    table,\n    defaultState ? undefined : cloneState(table.initialState.globalFilter),\n  )\n}\n"],"mappings":";;;;AAQA,SAAgB,0BAId,QAA4D;;AAC5D,SACG,OAAO,UAAU,sBAAsB,UACvC,OAAO,MAAM,QAAQ,sBAAsB,UAC3C,OAAO,MAAM,QAAQ,iBAAiB,8DACtC,OAAO,MAAM,SAAQ,qIAA2B,OAAO,KAAI,SAC5D,CAAC,CAAC,OAAO;;AAIb,SAAgB,8BAA8B;AAC5C,QAAO;;AAGT,SAAgB,wBAId,OACqE;CACrE,MAAM,EAAkB,mBAAmB,MAAM;CACjD,MAAM,YACJ,MAAM,aAAa;AAErB,QAAO,WAAW,eAAe,GAC7B,iBACA,mBAAmB,SACjB,6BAA6B,yDAC7B,UAAY;;AAGpB,SAAgB,sBAGd,OAAyC,SAAc;;AACvD,kDAAM,SAAQ,iHAAuB,QAAQ;;AAG/C,SAAgB,wBAGd,OAAyC,cAAwB;AACjE,uBACE,OACA,eAAe,SAAY,WAAW,MAAM,aAAa,aAAa,CACvE"}
+{"version":3,"file":"globalFilteringFeature.utils.js","names":[],"sources":["../../../src/features/global-filtering/globalFilteringFeature.utils.ts"],"sourcesContent":["import { filterFn_includesString } from '../../fns/filterFns'\nimport { cloneState, isFunction } from '../../utils'\nimport type { Column_Internal } from '../../types/Column'\nimport type { FilterFn } from '../column-filtering/columnFilteringFeature.types'\nimport type { CellData, RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Table_Internal } from '../../types/Table'\n\n/**\n * Returns whether a column can use global filter.\n *\n * This combines column options, table options, and any required accessor or feature state for the capability.\n *\n * @example\n * ```ts\n * const value = column_getCanGlobalFilter(column)\n * ```\n */\nexport function column_getCanGlobalFilter<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>): boolean {\n  return (\n    (column.columnDef.enableGlobalFilter ?? true) &&\n    (column.table.options.enableGlobalFilter ?? true) &&\n    (column.table.options.enableFilters ?? true) &&\n    (column.table.options.getColumnCanGlobalFilter?.(column) ?? true) &&\n    !!column.accessorFn\n  )\n}\n\n/**\n * Returns global auto filter fn for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getGlobalAutoFilterFn(table)\n * ```\n */\nexport function table_getGlobalAutoFilterFn() {\n  return filterFn_includesString\n}\n\n/**\n * Returns global filter fn for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getGlobalFilterFn(table)\n * ```\n */\nexport function table_getGlobalFilterFn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): FilterFn<TFeatures, TData> | FilterFn<TFeatures, TData> | undefined {\n  const { globalFilterFn: globalFilterFn } = table.options\n  const filterFns: Record<string, FilterFn<TFeatures, TData>> | undefined =\n    table._rowModelFns.filterFns\n\n  return isFunction(globalFilterFn)\n    ? globalFilterFn\n    : globalFilterFn === 'auto'\n      ? table_getGlobalAutoFilterFn()\n      : filterFns?.[globalFilterFn as string]\n}\n\n/**\n * Updates the table's global filter state slice.\n *\n * The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.\n *\n * @example\n * ```ts\n * table_setGlobalFilter(table, (old) => old)\n * ```\n */\nexport function table_setGlobalFilter<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, updater: any) {\n  table.options.onGlobalFilterChange?.(updater)\n}\n\n/**\n * Resets the table's global filter state slice.\n *\n * By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.\n *\n * @example\n * ```ts\n * table_resetGlobalFilter(table)\n * table_resetGlobalFilter(table, true)\n * ```\n */\nexport function table_resetGlobalFilter<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean) {\n  table_setGlobalFilter(\n    table,\n    defaultState ? undefined : cloneState(table.initialState.globalFilter),\n  )\n}\n"],"mappings":";;;;;;;;;;;;;;AAkBA,SAAgB,0BAId,QAA4D;;CAC5D,QACG,OAAO,UAAU,sBAAsB,UACvC,OAAO,MAAM,QAAQ,sBAAsB,UAC3C,OAAO,MAAM,QAAQ,iBAAiB,8DACtC,OAAO,MAAM,SAAQ,qIAA2B,OAAO,KAAI,SAC5D,CAAC,CAAC,OAAO;;;;;;;;;;;;AAcb,SAAgB,8BAA8B;CAC5C,OAAO;;;;;;;;;;;;AAaT,SAAgB,wBAId,OACqE;CACrE,MAAM,EAAkB,mBAAmB,MAAM;CACjD,MAAM,YACJ,MAAM,aAAa;CAErB,OAAO,WAAW,eAAe,GAC7B,iBACA,mBAAmB,SACjB,6BAA6B,yDAC7B,UAAY;;;;;;;;;;;;AAapB,SAAgB,sBAGd,OAAyC,SAAc;;CACvD,iDAAM,SAAQ,iHAAuB,QAAQ;;;;;;;;;;;;;AAc/C,SAAgB,wBAGd,OAAyC,cAAwB;CACjE,sBACE,OACA,eAAe,SAAY,WAAW,MAAM,aAAa,aAAa,CACvE"}

package/dist/features/row-expanding/createExpandedRowModel.cjs

@@ -2,6 +2,11 @@ const require_utils = require('../../utils.cjs');
 const require_rowExpandingFeature_utils = require('./rowExpandingFeature.utils.cjs');
 
 //#region src/features/row-expanding/createExpandedRowModel.ts
+/**
+* Creates a memoized expanded row model factory.
+*
+* The factory reads the relevant table state atoms and options, then returns a row model function used by the table row-model pipeline.
+*/
 function createExpandedRowModel() {
 	return (_table) => {
 		const table = _table;
@@ -29,6 +34,11 @@ function _createExpandedRowModel(table) {
 	if (!table.options.paginateExpandedRows) return rowModel;
 	return expandRows(rowModel);
 }
+/**
+* Expands a row model according to the current expanded row state.
+*
+* Expanded sub-rows are inserted into the flattened row order while preserving the original row hierarchy.
+*/
 function expandRows(rowModel) {
 	const expandedRows = [];
 	const handleRow = (row) => {

package/dist/features/row-expanding/createExpandedRowModel.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"createExpandedRowModel.cjs","names":["tableMemo","row_getIsExpanded"],"sources":["../../../src/features/row-expanding/createExpandedRowModel.ts"],"sourcesContent":["import { tableMemo } from '../../utils'\nimport { row_getIsExpanded } from './rowExpandingFeature.utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { RowModel } from '../../core/row-models/coreRowModelsFeature.types'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { Row } from '../../types/Row'\nimport type { RowData } from '../../types/type-utils'\n\nexport function createExpandedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(): (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData> {\n  return (_table) => {\n    const table: Table_Internal<TFeatures, TData> = _table\n    return tableMemo({\n      feature: 'rowExpandingFeature',\n      table,\n      fnName: 'table.getExpandedRowModel',\n      memoDeps: () => [\n        table.atoms.expanded?.get(),\n        table.getPreExpandedRowModel(),\n        table.options.paginateExpandedRows,\n      ],\n      fn: () => _createExpandedRowModel(table),\n    })\n  }\n}\n\nfunction _createExpandedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  const rowModel = table.getPreExpandedRowModel()\n  const expanded = table.atoms.expanded?.get()\n\n  if (\n    !rowModel.rows.length ||\n    (expanded !== true && !Object.keys(expanded ?? {}).length)\n  ) {\n    return rowModel\n  }\n\n  if (!table.options.paginateExpandedRows) {\n    // Only expand rows at this point if they are being paginated\n    return rowModel\n  }\n\n  return expandRows(rowModel)\n}\n\nexport function expandRows<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(rowModel: RowModel<TFeatures, TData>): RowModel<TFeatures, TData> {\n  const expandedRows: Array<Row<TFeatures, TData>> = []\n\n  const handleRow = (row: Row<TFeatures, TData>) => {\n    expandedRows.push(row)\n\n    if (row.subRows.length && row_getIsExpanded(row)) {\n      row.subRows.forEach(handleRow)\n    }\n  }\n\n  rowModel.rows.forEach(handleRow)\n\n  return {\n    rows: expandedRows,\n    flatRows: rowModel.flatRows,\n    rowsById: rowModel.rowsById,\n  }\n}\n"],"mappings":";;;;AAQA,SAAgB,yBAG0D;AACxE,SAAQ,WAAW;EACjB,MAAM,QAA0C;AAChD,SAAOA,wBAAU;GACf,SAAS;GACT;GACA,QAAQ;GACR,gBAAgB;;;8BACd,MAAM,MAAM,wFAAU,KAAK;KAC3B,MAAM,wBAAwB;KAC9B,MAAM,QAAQ;KACf;;GACD,UAAU,wBAAwB,MAAM;GACzC,CAAC;;;AAIN,SAAS,wBAGP,OAAqE;;CACrE,MAAM,WAAW,MAAM,wBAAwB;CAC/C,MAAM,qCAAW,MAAM,MAAM,0FAAU,KAAK;AAE5C,KACE,CAAC,SAAS,KAAK,UACd,aAAa,QAAQ,CAAC,OAAO,KAAK,YAAY,EAAE,CAAC,CAAC,OAEnD,QAAO;AAGT,KAAI,CAAC,MAAM,QAAQ,qBAEjB,QAAO;AAGT,QAAO,WAAW,SAAS;;AAG7B,SAAgB,WAGd,UAAkE;CAClE,MAAM,eAA6C,EAAE;CAErD,MAAM,aAAa,QAA+B;AAChD,eAAa,KAAK,IAAI;AAEtB,MAAI,IAAI,QAAQ,UAAUC,oDAAkB,IAAI,CAC9C,KAAI,QAAQ,QAAQ,UAAU;;AAIlC,UAAS,KAAK,QAAQ,UAAU;AAEhC,QAAO;EACL,MAAM;EACN,UAAU,SAAS;EACnB,UAAU,SAAS;EACpB"}
+{"version":3,"file":"createExpandedRowModel.cjs","names":["tableMemo","row_getIsExpanded"],"sources":["../../../src/features/row-expanding/createExpandedRowModel.ts"],"sourcesContent":["import { tableMemo } from '../../utils'\nimport { row_getIsExpanded } from './rowExpandingFeature.utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { RowModel } from '../../core/row-models/coreRowModelsFeature.types'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { Row } from '../../types/Row'\nimport type { RowData } from '../../types/type-utils'\n\n/**\n * Creates a memoized expanded row model factory.\n *\n * The factory reads the relevant table state atoms and options, then returns a row model function used by the table row-model pipeline.\n */\nexport function createExpandedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(): (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData> {\n  return (_table) => {\n    const table: Table_Internal<TFeatures, TData> = _table\n    return tableMemo({\n      feature: 'rowExpandingFeature',\n      table,\n      fnName: 'table.getExpandedRowModel',\n      memoDeps: () => [\n        table.atoms.expanded?.get(),\n        table.getPreExpandedRowModel(),\n        table.options.paginateExpandedRows,\n      ],\n      fn: () => _createExpandedRowModel(table),\n    })\n  }\n}\n\nfunction _createExpandedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  const rowModel = table.getPreExpandedRowModel()\n  const expanded = table.atoms.expanded?.get()\n\n  if (\n    !rowModel.rows.length ||\n    (expanded !== true && !Object.keys(expanded ?? {}).length)\n  ) {\n    return rowModel\n  }\n\n  if (!table.options.paginateExpandedRows) {\n    // Only expand rows at this point if they are being paginated\n    return rowModel\n  }\n\n  return expandRows(rowModel)\n}\n\n/**\n * Expands a row model according to the current expanded row state.\n *\n * Expanded sub-rows are inserted into the flattened row order while preserving the original row hierarchy.\n */\nexport function expandRows<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(rowModel: RowModel<TFeatures, TData>): RowModel<TFeatures, TData> {\n  const expandedRows: Array<Row<TFeatures, TData>> = []\n\n  const handleRow = (row: Row<TFeatures, TData>) => {\n    expandedRows.push(row)\n\n    if (row.subRows.length && row_getIsExpanded(row)) {\n      row.subRows.forEach(handleRow)\n    }\n  }\n\n  rowModel.rows.forEach(handleRow)\n\n  return {\n    rows: expandedRows,\n    flatRows: rowModel.flatRows,\n    rowsById: rowModel.rowsById,\n  }\n}\n"],"mappings":";;;;;;;;;AAaA,SAAgB,yBAG0D;CACxE,QAAQ,WAAW;EACjB,MAAM,QAA0C;EAChD,OAAOA,wBAAU;GACf,SAAS;GACT;GACA,QAAQ;GACR,gBAAgB;;;8BACd,MAAM,MAAM,wFAAU,KAAK;KAC3B,MAAM,wBAAwB;KAC9B,MAAM,QAAQ;KACf;;GACD,UAAU,wBAAwB,MAAM;GACzC,CAAC;;;AAIN,SAAS,wBAGP,OAAqE;;CACrE,MAAM,WAAW,MAAM,wBAAwB;CAC/C,MAAM,qCAAW,MAAM,MAAM,0FAAU,KAAK;CAE5C,IACE,CAAC,SAAS,KAAK,UACd,aAAa,QAAQ,CAAC,OAAO,KAAK,YAAY,EAAE,CAAC,CAAC,QAEnD,OAAO;CAGT,IAAI,CAAC,MAAM,QAAQ,sBAEjB,OAAO;CAGT,OAAO,WAAW,SAAS;;;;;;;AAQ7B,SAAgB,WAGd,UAAkE;CAClE,MAAM,eAA6C,EAAE;CAErD,MAAM,aAAa,QAA+B;EAChD,aAAa,KAAK,IAAI;EAEtB,IAAI,IAAI,QAAQ,UAAUC,oDAAkB,IAAI,EAC9C,IAAI,QAAQ,QAAQ,UAAU;;CAIlC,SAAS,KAAK,QAAQ,UAAU;CAEhC,OAAO;EACL,MAAM;EACN,UAAU,SAAS;EACnB,UAAU,SAAS;EACpB"}

package/dist/features/row-expanding/createExpandedRowModel.d.cts

@@ -4,7 +4,17 @@ import { Table } from "../../types/Table.cjs";
 import { RowModel } from "../../core/row-models/coreRowModelsFeature.types.cjs";
 
 //#region src/features/row-expanding/createExpandedRowModel.d.ts
+/**
+ * Creates a memoized expanded row model factory.
+ *
+ * The factory reads the relevant table state atoms and options, then returns a row model function used by the table row-model pipeline.
+ */
 declare function createExpandedRowModel<TFeatures extends TableFeatures, TData extends RowData = any>(): (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData>;
+/**
+ * Expands a row model according to the current expanded row state.
+ *
+ * Expanded sub-rows are inserted into the flattened row order while preserving the original row hierarchy.
+ */
 declare function expandRows<TFeatures extends TableFeatures, TData extends RowData = any>(rowModel: RowModel<TFeatures, TData>): RowModel<TFeatures, TData>;
 //#endregion
 export { createExpandedRowModel, expandRows };

package/dist/features/row-expanding/createExpandedRowModel.d.ts

@@ -4,7 +4,17 @@ import { Table } from "../../types/Table.js";
 import { RowModel } from "../../core/row-models/coreRowModelsFeature.types.js";
 
 //#region src/features/row-expanding/createExpandedRowModel.d.ts
+/**
+ * Creates a memoized expanded row model factory.
+ *
+ * The factory reads the relevant table state atoms and options, then returns a row model function used by the table row-model pipeline.
+ */
 declare function createExpandedRowModel<TFeatures extends TableFeatures, TData extends RowData = any>(): (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData>;
+/**
+ * Expands a row model according to the current expanded row state.
+ *
+ * Expanded sub-rows are inserted into the flattened row order while preserving the original row hierarchy.
+ */
 declare function expandRows<TFeatures extends TableFeatures, TData extends RowData = any>(rowModel: RowModel<TFeatures, TData>): RowModel<TFeatures, TData>;
 //#endregion
 export { createExpandedRowModel, expandRows };

package/dist/features/row-expanding/createExpandedRowModel.js

@@ -2,6 +2,11 @@ import { tableMemo } from "../../utils.js";
 import { row_getIsExpanded } from "./rowExpandingFeature.utils.js";
 
 //#region src/features/row-expanding/createExpandedRowModel.ts
+/**
+* Creates a memoized expanded row model factory.
+*
+* The factory reads the relevant table state atoms and options, then returns a row model function used by the table row-model pipeline.
+*/
 function createExpandedRowModel() {
 	return (_table) => {
 		const table = _table;
@@ -29,6 +34,11 @@ function _createExpandedRowModel(table) {
 	if (!table.options.paginateExpandedRows) return rowModel;
 	return expandRows(rowModel);
 }
+/**
+* Expands a row model according to the current expanded row state.
+*
+* Expanded sub-rows are inserted into the flattened row order while preserving the original row hierarchy.
+*/
 function expandRows(rowModel) {
 	const expandedRows = [];
 	const handleRow = (row) => {

package/dist/features/row-expanding/createExpandedRowModel.js.map

@@ -1 +1 @@
-{"version":3,"file":"createExpandedRowModel.js","names":[],"sources":["../../../src/features/row-expanding/createExpandedRowModel.ts"],"sourcesContent":["import { tableMemo } from '../../utils'\nimport { row_getIsExpanded } from './rowExpandingFeature.utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { RowModel } from '../../core/row-models/coreRowModelsFeature.types'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { Row } from '../../types/Row'\nimport type { RowData } from '../../types/type-utils'\n\nexport function createExpandedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(): (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData> {\n  return (_table) => {\n    const table: Table_Internal<TFeatures, TData> = _table\n    return tableMemo({\n      feature: 'rowExpandingFeature',\n      table,\n      fnName: 'table.getExpandedRowModel',\n      memoDeps: () => [\n        table.atoms.expanded?.get(),\n        table.getPreExpandedRowModel(),\n        table.options.paginateExpandedRows,\n      ],\n      fn: () => _createExpandedRowModel(table),\n    })\n  }\n}\n\nfunction _createExpandedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  const rowModel = table.getPreExpandedRowModel()\n  const expanded = table.atoms.expanded?.get()\n\n  if (\n    !rowModel.rows.length ||\n    (expanded !== true && !Object.keys(expanded ?? {}).length)\n  ) {\n    return rowModel\n  }\n\n  if (!table.options.paginateExpandedRows) {\n    // Only expand rows at this point if they are being paginated\n    return rowModel\n  }\n\n  return expandRows(rowModel)\n}\n\nexport function expandRows<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(rowModel: RowModel<TFeatures, TData>): RowModel<TFeatures, TData> {\n  const expandedRows: Array<Row<TFeatures, TData>> = []\n\n  const handleRow = (row: Row<TFeatures, TData>) => {\n    expandedRows.push(row)\n\n    if (row.subRows.length && row_getIsExpanded(row)) {\n      row.subRows.forEach(handleRow)\n    }\n  }\n\n  rowModel.rows.forEach(handleRow)\n\n  return {\n    rows: expandedRows,\n    flatRows: rowModel.flatRows,\n    rowsById: rowModel.rowsById,\n  }\n}\n"],"mappings":";;;;AAQA,SAAgB,yBAG0D;AACxE,SAAQ,WAAW;EACjB,MAAM,QAA0C;AAChD,SAAO,UAAU;GACf,SAAS;GACT;GACA,QAAQ;GACR,gBAAgB;;;8BACd,MAAM,MAAM,wFAAU,KAAK;KAC3B,MAAM,wBAAwB;KAC9B,MAAM,QAAQ;KACf;;GACD,UAAU,wBAAwB,MAAM;GACzC,CAAC;;;AAIN,SAAS,wBAGP,OAAqE;;CACrE,MAAM,WAAW,MAAM,wBAAwB;CAC/C,MAAM,qCAAW,MAAM,MAAM,0FAAU,KAAK;AAE5C,KACE,CAAC,SAAS,KAAK,UACd,aAAa,QAAQ,CAAC,OAAO,KAAK,YAAY,EAAE,CAAC,CAAC,OAEnD,QAAO;AAGT,KAAI,CAAC,MAAM,QAAQ,qBAEjB,QAAO;AAGT,QAAO,WAAW,SAAS;;AAG7B,SAAgB,WAGd,UAAkE;CAClE,MAAM,eAA6C,EAAE;CAErD,MAAM,aAAa,QAA+B;AAChD,eAAa,KAAK,IAAI;AAEtB,MAAI,IAAI,QAAQ,UAAU,kBAAkB,IAAI,CAC9C,KAAI,QAAQ,QAAQ,UAAU;;AAIlC,UAAS,KAAK,QAAQ,UAAU;AAEhC,QAAO;EACL,MAAM;EACN,UAAU,SAAS;EACnB,UAAU,SAAS;EACpB"}
+{"version":3,"file":"createExpandedRowModel.js","names":[],"sources":["../../../src/features/row-expanding/createExpandedRowModel.ts"],"sourcesContent":["import { tableMemo } from '../../utils'\nimport { row_getIsExpanded } from './rowExpandingFeature.utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { RowModel } from '../../core/row-models/coreRowModelsFeature.types'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { Row } from '../../types/Row'\nimport type { RowData } from '../../types/type-utils'\n\n/**\n * Creates a memoized expanded row model factory.\n *\n * The factory reads the relevant table state atoms and options, then returns a row model function used by the table row-model pipeline.\n */\nexport function createExpandedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(): (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData> {\n  return (_table) => {\n    const table: Table_Internal<TFeatures, TData> = _table\n    return tableMemo({\n      feature: 'rowExpandingFeature',\n      table,\n      fnName: 'table.getExpandedRowModel',\n      memoDeps: () => [\n        table.atoms.expanded?.get(),\n        table.getPreExpandedRowModel(),\n        table.options.paginateExpandedRows,\n      ],\n      fn: () => _createExpandedRowModel(table),\n    })\n  }\n}\n\nfunction _createExpandedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  const rowModel = table.getPreExpandedRowModel()\n  const expanded = table.atoms.expanded?.get()\n\n  if (\n    !rowModel.rows.length ||\n    (expanded !== true && !Object.keys(expanded ?? {}).length)\n  ) {\n    return rowModel\n  }\n\n  if (!table.options.paginateExpandedRows) {\n    // Only expand rows at this point if they are being paginated\n    return rowModel\n  }\n\n  return expandRows(rowModel)\n}\n\n/**\n * Expands a row model according to the current expanded row state.\n *\n * Expanded sub-rows are inserted into the flattened row order while preserving the original row hierarchy.\n */\nexport function expandRows<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(rowModel: RowModel<TFeatures, TData>): RowModel<TFeatures, TData> {\n  const expandedRows: Array<Row<TFeatures, TData>> = []\n\n  const handleRow = (row: Row<TFeatures, TData>) => {\n    expandedRows.push(row)\n\n    if (row.subRows.length && row_getIsExpanded(row)) {\n      row.subRows.forEach(handleRow)\n    }\n  }\n\n  rowModel.rows.forEach(handleRow)\n\n  return {\n    rows: expandedRows,\n    flatRows: rowModel.flatRows,\n    rowsById: rowModel.rowsById,\n  }\n}\n"],"mappings":";;;;;;;;;AAaA,SAAgB,yBAG0D;CACxE,QAAQ,WAAW;EACjB,MAAM,QAA0C;EAChD,OAAO,UAAU;GACf,SAAS;GACT;GACA,QAAQ;GACR,gBAAgB;;;8BACd,MAAM,MAAM,wFAAU,KAAK;KAC3B,MAAM,wBAAwB;KAC9B,MAAM,QAAQ;KACf;;GACD,UAAU,wBAAwB,MAAM;GACzC,CAAC;;;AAIN,SAAS,wBAGP,OAAqE;;CACrE,MAAM,WAAW,MAAM,wBAAwB;CAC/C,MAAM,qCAAW,MAAM,MAAM,0FAAU,KAAK;CAE5C,IACE,CAAC,SAAS,KAAK,UACd,aAAa,QAAQ,CAAC,OAAO,KAAK,YAAY,EAAE,CAAC,CAAC,QAEnD,OAAO;CAGT,IAAI,CAAC,MAAM,QAAQ,sBAEjB,OAAO;CAGT,OAAO,WAAW,SAAS;;;;;;;AAQ7B,SAAgB,WAGd,UAAkE;CAClE,MAAM,eAA6C,EAAE;CAErD,MAAM,aAAa,QAA+B;EAChD,aAAa,KAAK,IAAI;EAEtB,IAAI,IAAI,QAAQ,UAAU,kBAAkB,IAAI,EAC9C,IAAI,QAAQ,QAAQ,UAAU;;CAIlC,SAAS,KAAK,QAAQ,UAAU;CAEhC,OAAO;EACL,MAAM;EACN,UAAU,SAAS;EACnB,UAAU,SAAS;EACpB"}

package/dist/features/row-expanding/rowExpandingFeature.cjs

@@ -2,6 +2,11 @@ const require_utils = require('../../utils.cjs');
 const require_rowExpandingFeature_utils = require('./rowExpandingFeature.utils.cjs');
 
 //#region src/features/row-expanding/rowExpandingFeature.ts
+/**
+* Creates the stock row expanding feature.
+*
+* The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+*/
 function constructRowExpandingFeature() {
 	return {
 		getInitialState: (initialState) => {
@@ -41,7 +46,10 @@ function constructRowExpandingFeature() {
 	};
 }
 /**
-* The Row Expanding feature adds row expanding state and APIs to the table and row objects.
+* The stock row expanding feature.
+*
+* Register this feature to add expanded row state, row expansion APIs, and
+* helpers for deriving expanded row models and expansion depth.
 */
 const rowExpandingFeature = constructRowExpandingFeature();
 

package/dist/features/row-expanding/rowExpandingFeature.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"rowExpandingFeature.cjs","names":["getDefaultExpandedState","makeStateUpdater","row_toggleExpanded","row_getIsExpanded","row_getCanExpand","row_getIsAllParentsExpanded","row_getToggleExpandedHandler","table_autoResetExpanded","table_setExpanded","table_toggleAllRowsExpanded","table_resetExpanded","table_getCanSomeRowsExpand","table_getToggleAllRowsExpandedHandler","table_getIsSomeRowsExpanded","table_getIsAllRowsExpanded","table_getExpandedDepth"],"sources":["../../../src/features/row-expanding/rowExpandingFeature.ts"],"sourcesContent":["import {\n  assignPrototypeAPIs,\n  assignTableAPIs,\n  makeStateUpdater,\n} from '../../utils'\nimport {\n  getDefaultExpandedState,\n  row_getCanExpand,\n  row_getIsAllParentsExpanded,\n  row_getIsExpanded,\n  row_getToggleExpandedHandler,\n  row_toggleExpanded,\n  table_autoResetExpanded,\n  table_getCanSomeRowsExpand,\n  table_getExpandedDepth,\n  table_getIsAllRowsExpanded,\n  table_getIsSomeRowsExpanded,\n  table_getToggleAllRowsExpandedHandler,\n  table_resetExpanded,\n  table_setExpanded,\n  table_toggleAllRowsExpanded,\n} from './rowExpandingFeature.utils'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\n// import type {\n//   CachedRowModel_Expanded,\n//   CreateRowModel_Expanded,\n//   Row_RowExpanding,\n//   TableOptions_RowExpanding,\n//   TableState_RowExpanding,\n//   Table_RowExpanding,\n// } from './rowExpandingFeature.types'\n\nexport interface RowExpandingFeatureConstructors<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  // CachedRowModel: CachedRowModel_Expanded<TFeatures, TData>\n  // CreateRowModels: CreateRowModel_Expanded<TFeatures, TData>\n  // Row: Row_RowExpanding\n  // Table: Table_RowExpanding<TFeatures, TData>\n  // TableOptions: TableOptions_RowExpanding<TFeatures, TData>\n  // TableState: TableState_RowExpanding\n}\n\nexport function constructRowExpandingFeature<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): TableFeature<RowExpandingFeatureConstructors<TFeatures, TData>> {\n  return {\n    getInitialState: (initialState) => {\n      return {\n        expanded: getDefaultExpandedState(),\n        ...initialState,\n      }\n    },\n\n    getDefaultTableOptions: (table) => {\n      return {\n        onExpandedChange: makeStateUpdater('expanded', table),\n        paginateExpandedRows: true,\n      }\n    },\n\n    assignRowPrototype: (prototype, table) => {\n      assignPrototypeAPIs('rowExpandingFeature', prototype, table, {\n        row_toggleExpanded: {\n          fn: (row, expanded) => row_toggleExpanded(row, expanded),\n        },\n        row_getIsExpanded: {\n          fn: (row) => row_getIsExpanded(row),\n        },\n        row_getCanExpand: {\n          fn: (row) => row_getCanExpand(row),\n        },\n        row_getIsAllParentsExpanded: {\n          fn: (row) => row_getIsAllParentsExpanded(row),\n        },\n        row_getToggleExpandedHandler: {\n          fn: (row) => row_getToggleExpandedHandler(row),\n        },\n      })\n    },\n\n    constructTableAPIs: (table) => {\n      assignTableAPIs('rowExpandingFeature', table, {\n        table_autoResetExpanded: {\n          fn: () => table_autoResetExpanded(table),\n        },\n        table_setExpanded: {\n          fn: (updater) => table_setExpanded(table, updater),\n        },\n        table_toggleAllRowsExpanded: {\n          fn: (expanded) => table_toggleAllRowsExpanded(table, expanded),\n        },\n        table_resetExpanded: {\n          fn: (defaultState) => table_resetExpanded(table, defaultState),\n        },\n        table_getCanSomeRowsExpand: {\n          fn: () => table_getCanSomeRowsExpand(table),\n        },\n        table_getToggleAllRowsExpandedHandler: {\n          fn: () => table_getToggleAllRowsExpandedHandler(table),\n        },\n        table_getIsSomeRowsExpanded: {\n          fn: () => table_getIsSomeRowsExpanded(table),\n        },\n        table_getIsAllRowsExpanded: {\n          fn: () => table_getIsAllRowsExpanded(table),\n        },\n        table_getExpandedDepth: {\n          fn: () => table_getExpandedDepth(table),\n        },\n      })\n    },\n  }\n}\n\n/**\n * The Row Expanding feature adds row expanding state and APIs to the table and row objects.\n */\nexport const rowExpandingFeature = constructRowExpandingFeature()\n"],"mappings":";;;;AA6CA,SAAgB,+BAGqD;AACnE,QAAO;EACL,kBAAkB,iBAAiB;AACjC,UAAO;IACL,UAAUA,2DAAyB;IACnC,GAAG;IACJ;;EAGH,yBAAyB,UAAU;AACjC,UAAO;IACL,kBAAkBC,+BAAiB,YAAY,MAAM;IACrD,sBAAsB;IACvB;;EAGH,qBAAqB,WAAW,UAAU;AACxC,qCAAoB,uBAAuB,WAAW,OAAO;IAC3D,oBAAoB,EAClB,KAAK,KAAK,aAAaC,qDAAmB,KAAK,SAAS,EACzD;IACD,mBAAmB,EACjB,KAAK,QAAQC,oDAAkB,IAAI,EACpC;IACD,kBAAkB,EAChB,KAAK,QAAQC,mDAAiB,IAAI,EACnC;IACD,6BAA6B,EAC3B,KAAK,QAAQC,8DAA4B,IAAI,EAC9C;IACD,8BAA8B,EAC5B,KAAK,QAAQC,+DAA6B,IAAI,EAC/C;IACF,CAAC;;EAGJ,qBAAqB,UAAU;AAC7B,iCAAgB,uBAAuB,OAAO;IAC5C,yBAAyB,EACvB,UAAUC,0DAAwB,MAAM,EACzC;IACD,mBAAmB,EACjB,KAAK,YAAYC,oDAAkB,OAAO,QAAQ,EACnD;IACD,6BAA6B,EAC3B,KAAK,aAAaC,8DAA4B,OAAO,SAAS,EAC/D;IACD,qBAAqB,EACnB,KAAK,iBAAiBC,sDAAoB,OAAO,aAAa,EAC/D;IACD,4BAA4B,EAC1B,UAAUC,6DAA2B,MAAM,EAC5C;IACD,uCAAuC,EACrC,UAAUC,wEAAsC,MAAM,EACvD;IACD,6BAA6B,EAC3B,UAAUC,8DAA4B,MAAM,EAC7C;IACD,4BAA4B,EAC1B,UAAUC,6DAA2B,MAAM,EAC5C;IACD,wBAAwB,EACtB,UAAUC,yDAAuB,MAAM,EACxC;IACF,CAAC;;EAEL;;;;;AAMH,MAAa,sBAAsB,8BAA8B"}
+{"version":3,"file":"rowExpandingFeature.cjs","names":["getDefaultExpandedState","makeStateUpdater","row_toggleExpanded","row_getIsExpanded","row_getCanExpand","row_getIsAllParentsExpanded","row_getToggleExpandedHandler","table_autoResetExpanded","table_setExpanded","table_toggleAllRowsExpanded","table_resetExpanded","table_getCanSomeRowsExpand","table_getToggleAllRowsExpandedHandler","table_getIsSomeRowsExpanded","table_getIsAllRowsExpanded","table_getExpandedDepth"],"sources":["../../../src/features/row-expanding/rowExpandingFeature.ts"],"sourcesContent":["import {\n  assignPrototypeAPIs,\n  assignTableAPIs,\n  makeStateUpdater,\n} from '../../utils'\nimport {\n  getDefaultExpandedState,\n  row_getCanExpand,\n  row_getIsAllParentsExpanded,\n  row_getIsExpanded,\n  row_getToggleExpandedHandler,\n  row_toggleExpanded,\n  table_autoResetExpanded,\n  table_getCanSomeRowsExpand,\n  table_getExpandedDepth,\n  table_getIsAllRowsExpanded,\n  table_getIsSomeRowsExpanded,\n  table_getToggleAllRowsExpandedHandler,\n  table_resetExpanded,\n  table_setExpanded,\n  table_toggleAllRowsExpanded,\n} from './rowExpandingFeature.utils'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\n// import type {\n//   CachedRowModel_Expanded,\n//   CreateRowModel_Expanded,\n//   Row_RowExpanding,\n//   TableOptions_RowExpanding,\n//   TableState_RowExpanding,\n//   Table_RowExpanding,\n// } from './rowExpandingFeature.types'\n\nexport interface RowExpandingFeatureConstructors<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  // CachedRowModel: CachedRowModel_Expanded<TFeatures, TData>\n  // CreateRowModels: CreateRowModel_Expanded<TFeatures, TData>\n  // Row: Row_RowExpanding\n  // Table: Table_RowExpanding<TFeatures, TData>\n  // TableOptions: TableOptions_RowExpanding<TFeatures, TData>\n  // TableState: TableState_RowExpanding\n}\n\n/**\n * Creates the stock row expanding feature.\n *\n * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.\n */\nexport function constructRowExpandingFeature<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): TableFeature<RowExpandingFeatureConstructors<TFeatures, TData>> {\n  return {\n    getInitialState: (initialState) => {\n      return {\n        expanded: getDefaultExpandedState(),\n        ...initialState,\n      }\n    },\n\n    getDefaultTableOptions: (table) => {\n      return {\n        onExpandedChange: makeStateUpdater('expanded', table),\n        paginateExpandedRows: true,\n      }\n    },\n\n    assignRowPrototype: (prototype, table) => {\n      assignPrototypeAPIs('rowExpandingFeature', prototype, table, {\n        row_toggleExpanded: {\n          fn: (row, expanded) => row_toggleExpanded(row, expanded),\n        },\n        row_getIsExpanded: {\n          fn: (row) => row_getIsExpanded(row),\n        },\n        row_getCanExpand: {\n          fn: (row) => row_getCanExpand(row),\n        },\n        row_getIsAllParentsExpanded: {\n          fn: (row) => row_getIsAllParentsExpanded(row),\n        },\n        row_getToggleExpandedHandler: {\n          fn: (row) => row_getToggleExpandedHandler(row),\n        },\n      })\n    },\n\n    constructTableAPIs: (table) => {\n      assignTableAPIs('rowExpandingFeature', table, {\n        table_autoResetExpanded: {\n          fn: () => table_autoResetExpanded(table),\n        },\n        table_setExpanded: {\n          fn: (updater) => table_setExpanded(table, updater),\n        },\n        table_toggleAllRowsExpanded: {\n          fn: (expanded) => table_toggleAllRowsExpanded(table, expanded),\n        },\n        table_resetExpanded: {\n          fn: (defaultState) => table_resetExpanded(table, defaultState),\n        },\n        table_getCanSomeRowsExpand: {\n          fn: () => table_getCanSomeRowsExpand(table),\n        },\n        table_getToggleAllRowsExpandedHandler: {\n          fn: () => table_getToggleAllRowsExpandedHandler(table),\n        },\n        table_getIsSomeRowsExpanded: {\n          fn: () => table_getIsSomeRowsExpanded(table),\n        },\n        table_getIsAllRowsExpanded: {\n          fn: () => table_getIsAllRowsExpanded(table),\n        },\n        table_getExpandedDepth: {\n          fn: () => table_getExpandedDepth(table),\n        },\n      })\n    },\n  }\n}\n\n/**\n * The stock row expanding feature.\n *\n * Register this feature to add expanded row state, row expansion APIs, and\n * helpers for deriving expanded row models and expansion depth.\n */\nexport const rowExpandingFeature = constructRowExpandingFeature()\n"],"mappings":";;;;;;;;;AAkDA,SAAgB,+BAGqD;CACnE,OAAO;EACL,kBAAkB,iBAAiB;GACjC,OAAO;IACL,UAAUA,2DAAyB;IACnC,GAAG;IACJ;;EAGH,yBAAyB,UAAU;GACjC,OAAO;IACL,kBAAkBC,+BAAiB,YAAY,MAAM;IACrD,sBAAsB;IACvB;;EAGH,qBAAqB,WAAW,UAAU;GACxC,kCAAoB,uBAAuB,WAAW,OAAO;IAC3D,oBAAoB,EAClB,KAAK,KAAK,aAAaC,qDAAmB,KAAK,SAAS,EACzD;IACD,mBAAmB,EACjB,KAAK,QAAQC,oDAAkB,IAAI,EACpC;IACD,kBAAkB,EAChB,KAAK,QAAQC,mDAAiB,IAAI,EACnC;IACD,6BAA6B,EAC3B,KAAK,QAAQC,8DAA4B,IAAI,EAC9C;IACD,8BAA8B,EAC5B,KAAK,QAAQC,+DAA6B,IAAI,EAC/C;IACF,CAAC;;EAGJ,qBAAqB,UAAU;GAC7B,8BAAgB,uBAAuB,OAAO;IAC5C,yBAAyB,EACvB,UAAUC,0DAAwB,MAAM,EACzC;IACD,mBAAmB,EACjB,KAAK,YAAYC,oDAAkB,OAAO,QAAQ,EACnD;IACD,6BAA6B,EAC3B,KAAK,aAAaC,8DAA4B,OAAO,SAAS,EAC/D;IACD,qBAAqB,EACnB,KAAK,iBAAiBC,sDAAoB,OAAO,aAAa,EAC/D;IACD,4BAA4B,EAC1B,UAAUC,6DAA2B,MAAM,EAC5C;IACD,uCAAuC,EACrC,UAAUC,wEAAsC,MAAM,EACvD;IACD,6BAA6B,EAC3B,UAAUC,8DAA4B,MAAM,EAC7C;IACD,4BAA4B,EAC1B,UAAUC,6DAA2B,MAAM,EAC5C;IACD,wBAAwB,EACtB,UAAUC,yDAAuB,MAAM,EACxC;IACF,CAAC;;EAEL;;;;;;;;AASH,MAAa,sBAAsB,8BAA8B"}

package/dist/features/row-expanding/rowExpandingFeature.d.cts

@@ -3,9 +3,17 @@ import { TableFeature, TableFeatures } from "../../types/TableFeatures.cjs";
 
 //#region src/features/row-expanding/rowExpandingFeature.d.ts
 interface RowExpandingFeatureConstructors<TFeatures extends TableFeatures, TData extends RowData> {}
+/**
+ * Creates the stock row expanding feature.
+ *
+ * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+ */
 declare function constructRowExpandingFeature<TFeatures extends TableFeatures, TData extends RowData>(): TableFeature<RowExpandingFeatureConstructors<TFeatures, TData>>;
 /**
- * The Row Expanding feature adds row expanding state and APIs to the table and row objects.
+ * The stock row expanding feature.
+ *
+ * Register this feature to add expanded row state, row expansion APIs, and
+ * helpers for deriving expanded row models and expansion depth.
  */
 declare const rowExpandingFeature: TableFeature<RowExpandingFeatureConstructors<TableFeatures, RowData>>;
 //#endregion

package/dist/features/row-expanding/rowExpandingFeature.d.ts

@@ -3,9 +3,17 @@ import { TableFeature, TableFeatures } from "../../types/TableFeatures.js";
 
 //#region src/features/row-expanding/rowExpandingFeature.d.ts
 interface RowExpandingFeatureConstructors<TFeatures extends TableFeatures, TData extends RowData> {}
+/**
+ * Creates the stock row expanding feature.
+ *
+ * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+ */
 declare function constructRowExpandingFeature<TFeatures extends TableFeatures, TData extends RowData>(): TableFeature<RowExpandingFeatureConstructors<TFeatures, TData>>;
 /**
- * The Row Expanding feature adds row expanding state and APIs to the table and row objects.
+ * The stock row expanding feature.
+ *
+ * Register this feature to add expanded row state, row expansion APIs, and
+ * helpers for deriving expanded row models and expansion depth.
  */
 declare const rowExpandingFeature: TableFeature<RowExpandingFeatureConstructors<TableFeatures, RowData>>;
 //#endregion

package/dist/features/row-expanding/rowExpandingFeature.js

@@ -2,6 +2,11 @@ import { assignPrototypeAPIs, assignTableAPIs, makeStateUpdater } from "../../ut
 import { getDefaultExpandedState, row_getCanExpand, row_getIsAllParentsExpanded, row_getIsExpanded, row_getToggleExpandedHandler, row_toggleExpanded, table_autoResetExpanded, table_getCanSomeRowsExpand, table_getExpandedDepth, table_getIsAllRowsExpanded, table_getIsSomeRowsExpanded, table_getToggleAllRowsExpandedHandler, table_resetExpanded, table_setExpanded, table_toggleAllRowsExpanded } from "./rowExpandingFeature.utils.js";
 
 //#region src/features/row-expanding/rowExpandingFeature.ts
+/**
+* Creates the stock row expanding feature.
+*
+* The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+*/
 function constructRowExpandingFeature() {
 	return {
 		getInitialState: (initialState) => {
@@ -41,7 +46,10 @@ function constructRowExpandingFeature() {
 	};
 }
 /**
-* The Row Expanding feature adds row expanding state and APIs to the table and row objects.
+* The stock row expanding feature.
+*
+* Register this feature to add expanded row state, row expansion APIs, and
+* helpers for deriving expanded row models and expansion depth.
 */
 const rowExpandingFeature = constructRowExpandingFeature();
 

package/dist/features/row-expanding/rowExpandingFeature.js.map

@@ -1 +1 @@
-{"version":3,"file":"rowExpandingFeature.js","names":[],"sources":["../../../src/features/row-expanding/rowExpandingFeature.ts"],"sourcesContent":["import {\n  assignPrototypeAPIs,\n  assignTableAPIs,\n  makeStateUpdater,\n} from '../../utils'\nimport {\n  getDefaultExpandedState,\n  row_getCanExpand,\n  row_getIsAllParentsExpanded,\n  row_getIsExpanded,\n  row_getToggleExpandedHandler,\n  row_toggleExpanded,\n  table_autoResetExpanded,\n  table_getCanSomeRowsExpand,\n  table_getExpandedDepth,\n  table_getIsAllRowsExpanded,\n  table_getIsSomeRowsExpanded,\n  table_getToggleAllRowsExpandedHandler,\n  table_resetExpanded,\n  table_setExpanded,\n  table_toggleAllRowsExpanded,\n} from './rowExpandingFeature.utils'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\n// import type {\n//   CachedRowModel_Expanded,\n//   CreateRowModel_Expanded,\n//   Row_RowExpanding,\n//   TableOptions_RowExpanding,\n//   TableState_RowExpanding,\n//   Table_RowExpanding,\n// } from './rowExpandingFeature.types'\n\nexport interface RowExpandingFeatureConstructors<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  // CachedRowModel: CachedRowModel_Expanded<TFeatures, TData>\n  // CreateRowModels: CreateRowModel_Expanded<TFeatures, TData>\n  // Row: Row_RowExpanding\n  // Table: Table_RowExpanding<TFeatures, TData>\n  // TableOptions: TableOptions_RowExpanding<TFeatures, TData>\n  // TableState: TableState_RowExpanding\n}\n\nexport function constructRowExpandingFeature<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): TableFeature<RowExpandingFeatureConstructors<TFeatures, TData>> {\n  return {\n    getInitialState: (initialState) => {\n      return {\n        expanded: getDefaultExpandedState(),\n        ...initialState,\n      }\n    },\n\n    getDefaultTableOptions: (table) => {\n      return {\n        onExpandedChange: makeStateUpdater('expanded', table),\n        paginateExpandedRows: true,\n      }\n    },\n\n    assignRowPrototype: (prototype, table) => {\n      assignPrototypeAPIs('rowExpandingFeature', prototype, table, {\n        row_toggleExpanded: {\n          fn: (row, expanded) => row_toggleExpanded(row, expanded),\n        },\n        row_getIsExpanded: {\n          fn: (row) => row_getIsExpanded(row),\n        },\n        row_getCanExpand: {\n          fn: (row) => row_getCanExpand(row),\n        },\n        row_getIsAllParentsExpanded: {\n          fn: (row) => row_getIsAllParentsExpanded(row),\n        },\n        row_getToggleExpandedHandler: {\n          fn: (row) => row_getToggleExpandedHandler(row),\n        },\n      })\n    },\n\n    constructTableAPIs: (table) => {\n      assignTableAPIs('rowExpandingFeature', table, {\n        table_autoResetExpanded: {\n          fn: () => table_autoResetExpanded(table),\n        },\n        table_setExpanded: {\n          fn: (updater) => table_setExpanded(table, updater),\n        },\n        table_toggleAllRowsExpanded: {\n          fn: (expanded) => table_toggleAllRowsExpanded(table, expanded),\n        },\n        table_resetExpanded: {\n          fn: (defaultState) => table_resetExpanded(table, defaultState),\n        },\n        table_getCanSomeRowsExpand: {\n          fn: () => table_getCanSomeRowsExpand(table),\n        },\n        table_getToggleAllRowsExpandedHandler: {\n          fn: () => table_getToggleAllRowsExpandedHandler(table),\n        },\n        table_getIsSomeRowsExpanded: {\n          fn: () => table_getIsSomeRowsExpanded(table),\n        },\n        table_getIsAllRowsExpanded: {\n          fn: () => table_getIsAllRowsExpanded(table),\n        },\n        table_getExpandedDepth: {\n          fn: () => table_getExpandedDepth(table),\n        },\n      })\n    },\n  }\n}\n\n/**\n * The Row Expanding feature adds row expanding state and APIs to the table and row objects.\n */\nexport const rowExpandingFeature = constructRowExpandingFeature()\n"],"mappings":";;;;AA6CA,SAAgB,+BAGqD;AACnE,QAAO;EACL,kBAAkB,iBAAiB;AACjC,UAAO;IACL,UAAU,yBAAyB;IACnC,GAAG;IACJ;;EAGH,yBAAyB,UAAU;AACjC,UAAO;IACL,kBAAkB,iBAAiB,YAAY,MAAM;IACrD,sBAAsB;IACvB;;EAGH,qBAAqB,WAAW,UAAU;AACxC,uBAAoB,uBAAuB,WAAW,OAAO;IAC3D,oBAAoB,EAClB,KAAK,KAAK,aAAa,mBAAmB,KAAK,SAAS,EACzD;IACD,mBAAmB,EACjB,KAAK,QAAQ,kBAAkB,IAAI,EACpC;IACD,kBAAkB,EAChB,KAAK,QAAQ,iBAAiB,IAAI,EACnC;IACD,6BAA6B,EAC3B,KAAK,QAAQ,4BAA4B,IAAI,EAC9C;IACD,8BAA8B,EAC5B,KAAK,QAAQ,6BAA6B,IAAI,EAC/C;IACF,CAAC;;EAGJ,qBAAqB,UAAU;AAC7B,mBAAgB,uBAAuB,OAAO;IAC5C,yBAAyB,EACvB,UAAU,wBAAwB,MAAM,EACzC;IACD,mBAAmB,EACjB,KAAK,YAAY,kBAAkB,OAAO,QAAQ,EACnD;IACD,6BAA6B,EAC3B,KAAK,aAAa,4BAA4B,OAAO,SAAS,EAC/D;IACD,qBAAqB,EACnB,KAAK,iBAAiB,oBAAoB,OAAO,aAAa,EAC/D;IACD,4BAA4B,EAC1B,UAAU,2BAA2B,MAAM,EAC5C;IACD,uCAAuC,EACrC,UAAU,sCAAsC,MAAM,EACvD;IACD,6BAA6B,EAC3B,UAAU,4BAA4B,MAAM,EAC7C;IACD,4BAA4B,EAC1B,UAAU,2BAA2B,MAAM,EAC5C;IACD,wBAAwB,EACtB,UAAU,uBAAuB,MAAM,EACxC;IACF,CAAC;;EAEL;;;;;AAMH,MAAa,sBAAsB,8BAA8B"}
+{"version":3,"file":"rowExpandingFeature.js","names":[],"sources":["../../../src/features/row-expanding/rowExpandingFeature.ts"],"sourcesContent":["import {\n  assignPrototypeAPIs,\n  assignTableAPIs,\n  makeStateUpdater,\n} from '../../utils'\nimport {\n  getDefaultExpandedState,\n  row_getCanExpand,\n  row_getIsAllParentsExpanded,\n  row_getIsExpanded,\n  row_getToggleExpandedHandler,\n  row_toggleExpanded,\n  table_autoResetExpanded,\n  table_getCanSomeRowsExpand,\n  table_getExpandedDepth,\n  table_getIsAllRowsExpanded,\n  table_getIsSomeRowsExpanded,\n  table_getToggleAllRowsExpandedHandler,\n  table_resetExpanded,\n  table_setExpanded,\n  table_toggleAllRowsExpanded,\n} from './rowExpandingFeature.utils'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\n// import type {\n//   CachedRowModel_Expanded,\n//   CreateRowModel_Expanded,\n//   Row_RowExpanding,\n//   TableOptions_RowExpanding,\n//   TableState_RowExpanding,\n//   Table_RowExpanding,\n// } from './rowExpandingFeature.types'\n\nexport interface RowExpandingFeatureConstructors<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  // CachedRowModel: CachedRowModel_Expanded<TFeatures, TData>\n  // CreateRowModels: CreateRowModel_Expanded<TFeatures, TData>\n  // Row: Row_RowExpanding\n  // Table: Table_RowExpanding<TFeatures, TData>\n  // TableOptions: TableOptions_RowExpanding<TFeatures, TData>\n  // TableState: TableState_RowExpanding\n}\n\n/**\n * Creates the stock row expanding feature.\n *\n * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.\n */\nexport function constructRowExpandingFeature<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): TableFeature<RowExpandingFeatureConstructors<TFeatures, TData>> {\n  return {\n    getInitialState: (initialState) => {\n      return {\n        expanded: getDefaultExpandedState(),\n        ...initialState,\n      }\n    },\n\n    getDefaultTableOptions: (table) => {\n      return {\n        onExpandedChange: makeStateUpdater('expanded', table),\n        paginateExpandedRows: true,\n      }\n    },\n\n    assignRowPrototype: (prototype, table) => {\n      assignPrototypeAPIs('rowExpandingFeature', prototype, table, {\n        row_toggleExpanded: {\n          fn: (row, expanded) => row_toggleExpanded(row, expanded),\n        },\n        row_getIsExpanded: {\n          fn: (row) => row_getIsExpanded(row),\n        },\n        row_getCanExpand: {\n          fn: (row) => row_getCanExpand(row),\n        },\n        row_getIsAllParentsExpanded: {\n          fn: (row) => row_getIsAllParentsExpanded(row),\n        },\n        row_getToggleExpandedHandler: {\n          fn: (row) => row_getToggleExpandedHandler(row),\n        },\n      })\n    },\n\n    constructTableAPIs: (table) => {\n      assignTableAPIs('rowExpandingFeature', table, {\n        table_autoResetExpanded: {\n          fn: () => table_autoResetExpanded(table),\n        },\n        table_setExpanded: {\n          fn: (updater) => table_setExpanded(table, updater),\n        },\n        table_toggleAllRowsExpanded: {\n          fn: (expanded) => table_toggleAllRowsExpanded(table, expanded),\n        },\n        table_resetExpanded: {\n          fn: (defaultState) => table_resetExpanded(table, defaultState),\n        },\n        table_getCanSomeRowsExpand: {\n          fn: () => table_getCanSomeRowsExpand(table),\n        },\n        table_getToggleAllRowsExpandedHandler: {\n          fn: () => table_getToggleAllRowsExpandedHandler(table),\n        },\n        table_getIsSomeRowsExpanded: {\n          fn: () => table_getIsSomeRowsExpanded(table),\n        },\n        table_getIsAllRowsExpanded: {\n          fn: () => table_getIsAllRowsExpanded(table),\n        },\n        table_getExpandedDepth: {\n          fn: () => table_getExpandedDepth(table),\n        },\n      })\n    },\n  }\n}\n\n/**\n * The stock row expanding feature.\n *\n * Register this feature to add expanded row state, row expansion APIs, and\n * helpers for deriving expanded row models and expansion depth.\n */\nexport const rowExpandingFeature = constructRowExpandingFeature()\n"],"mappings":";;;;;;;;;AAkDA,SAAgB,+BAGqD;CACnE,OAAO;EACL,kBAAkB,iBAAiB;GACjC,OAAO;IACL,UAAU,yBAAyB;IACnC,GAAG;IACJ;;EAGH,yBAAyB,UAAU;GACjC,OAAO;IACL,kBAAkB,iBAAiB,YAAY,MAAM;IACrD,sBAAsB;IACvB;;EAGH,qBAAqB,WAAW,UAAU;GACxC,oBAAoB,uBAAuB,WAAW,OAAO;IAC3D,oBAAoB,EAClB,KAAK,KAAK,aAAa,mBAAmB,KAAK,SAAS,EACzD;IACD,mBAAmB,EACjB,KAAK,QAAQ,kBAAkB,IAAI,EACpC;IACD,kBAAkB,EAChB,KAAK,QAAQ,iBAAiB,IAAI,EACnC;IACD,6BAA6B,EAC3B,KAAK,QAAQ,4BAA4B,IAAI,EAC9C;IACD,8BAA8B,EAC5B,KAAK,QAAQ,6BAA6B,IAAI,EAC/C;IACF,CAAC;;EAGJ,qBAAqB,UAAU;GAC7B,gBAAgB,uBAAuB,OAAO;IAC5C,yBAAyB,EACvB,UAAU,wBAAwB,MAAM,EACzC;IACD,mBAAmB,EACjB,KAAK,YAAY,kBAAkB,OAAO,QAAQ,EACnD;IACD,6BAA6B,EAC3B,KAAK,aAAa,4BAA4B,OAAO,SAAS,EAC/D;IACD,qBAAqB,EACnB,KAAK,iBAAiB,oBAAoB,OAAO,aAAa,EAC/D;IACD,4BAA4B,EAC1B,UAAU,2BAA2B,MAAM,EAC5C;IACD,uCAAuC,EACrC,UAAU,sCAAsC,MAAM,EACvD;IACD,6BAA6B,EAC3B,UAAU,4BAA4B,MAAM,EAC7C;IACD,4BAA4B,EAC1B,UAAU,2BAA2B,MAAM,EAC5C;IACD,wBAAwB,EACtB,UAAU,uBAAuB,MAAM,EACxC;IACF,CAAC;;EAEL;;;;;;;;AASH,MAAa,sBAAsB,8BAA8B"}

package/dist/features/row-expanding/rowExpandingFeature.types.d.cts

@@ -34,7 +34,7 @@ interface Row_RowExpanding {
 }
 interface TableOptions_RowExpanding<TFeatures extends TableFeatures, TData extends RowData> {
   /**
-   * Enable this setting to automatically reset the expanded state of the table when expanding state changes.
+   * Enables automatic expanded-state resets when page-altering table state changes.
    */
   autoResetExpanded?: boolean;
   /**
@@ -54,7 +54,9 @@ interface TableOptions_RowExpanding<TFeatures extends TableFeatures, TData exten
    */
   manualExpanding?: boolean;
   /**
-   * This function is called when the `expanded` table state changes. If a function is provided, you will be responsible for managing this state on your own. To pass the managed state back to the table, use the `tableOptions.state.expanded` option.
+   * Called with an updater when expanded state changes. Pair this with
+   * `state.expanded` when using external state; external atoms can own the
+   * slice without this callback.
    */
   onExpandedChange?: OnChangeFn<ExpandedState>;
   /**
@@ -85,11 +87,12 @@ interface Table_RowExpanding<TFeatures extends TableFeatures, TData extends RowD
    */
   getToggleAllRowsExpandedHandler: () => (event: unknown) => void;
   /**
-   * Resets the expanded state of the table to the initial state.
+   * Resets expanded state to `initialState.expanded`. Pass `true` to reset to
+   * the feature default of `{}`.
    */
   resetExpanded: (defaultState?: boolean) => void;
   /**
-   * Updates the expanded state of the table via an update function or value.
+   * Sets expanded state using a value or updater.
    */
   setExpanded: (updater: Updater<ExpandedState>) => void;
   /**
@@ -109,7 +112,9 @@ interface Table_RowModels_Expanded<TFeatures extends TableFeatures, TData extend
 }
 interface CreateRowModel_Expanded<TFeatures extends TableFeatures, TData extends RowData> {
   /**
-   * This function is responsible for returning the expanded row model. If this function is not provided, the table will not expand rows. You can use the default exported `getExpandedRowModel` function to get the expanded row model or implement your own.
+   * Factory used to retrieve the expanded row model. If this function is not
+   * provided, the table will not expand rows. To use client-side expansion,
+   * pass `createExpandedRowModel()` or implement your own factory.
    */
   expandedRowModel?: (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData>;
 }

package/dist/features/row-expanding/rowExpandingFeature.types.d.ts

@@ -34,7 +34,7 @@ interface Row_RowExpanding {
 }
 interface TableOptions_RowExpanding<TFeatures extends TableFeatures, TData extends RowData> {
   /**
-   * Enable this setting to automatically reset the expanded state of the table when expanding state changes.
+   * Enables automatic expanded-state resets when page-altering table state changes.
    */
   autoResetExpanded?: boolean;
   /**
@@ -54,7 +54,9 @@ interface TableOptions_RowExpanding<TFeatures extends TableFeatures, TData exten
    */
   manualExpanding?: boolean;
   /**
-   * This function is called when the `expanded` table state changes. If a function is provided, you will be responsible for managing this state on your own. To pass the managed state back to the table, use the `tableOptions.state.expanded` option.
+   * Called with an updater when expanded state changes. Pair this with
+   * `state.expanded` when using external state; external atoms can own the
+   * slice without this callback.
    */
   onExpandedChange?: OnChangeFn<ExpandedState>;
   /**
@@ -85,11 +87,12 @@ interface Table_RowExpanding<TFeatures extends TableFeatures, TData extends RowD
    */
   getToggleAllRowsExpandedHandler: () => (event: unknown) => void;
   /**
-   * Resets the expanded state of the table to the initial state.
+   * Resets expanded state to `initialState.expanded`. Pass `true` to reset to
+   * the feature default of `{}`.
    */
   resetExpanded: (defaultState?: boolean) => void;
   /**
-   * Updates the expanded state of the table via an update function or value.
+   * Sets expanded state using a value or updater.
    */
   setExpanded: (updater: Updater<ExpandedState>) => void;
   /**
@@ -109,7 +112,9 @@ interface Table_RowModels_Expanded<TFeatures extends TableFeatures, TData extend
 }
 interface CreateRowModel_Expanded<TFeatures extends TableFeatures, TData extends RowData> {
   /**
-   * This function is responsible for returning the expanded row model. If this function is not provided, the table will not expand rows. You can use the default exported `getExpandedRowModel` function to get the expanded row model or implement your own.
+   * Factory used to retrieve the expanded row model. If this function is not
+   * provided, the table will not expand rows. To use client-side expansion,
+   * pass `createExpandedRowModel()` or implement your own factory.
    */
   expandedRowModel?: (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData>;
 }