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

package/dist/features/row-selection/rowSelectionFeature.utils.js

@@ -1,16 +1,57 @@
 import { cloneState } from "../../utils.js";
 
 //#region src/features/row-selection/rowSelectionFeature.utils.ts
+/**
+* Returns the default row selection state.
+*
+* Feature constructors use this value to initialize the table state or option defaults when no user value is provided.
+*
+* @example
+* ```ts
+* const initialValue = getDefaultRowSelectionState()
+* ```
+*/
 function getDefaultRowSelectionState() {
 	return {};
 }
+/**
+* Updates the table's row selection state slice.
+*
+* The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.
+*
+* @example
+* ```ts
+* table_setRowSelection(table, (old) => old)
+* ```
+*/
 function table_setRowSelection(table, updater) {
 	var _table$options$onRowS, _table$options;
 	(_table$options$onRowS = (_table$options = table.options).onRowSelectionChange) === null || _table$options$onRowS === void 0 || _table$options$onRowS.call(_table$options, updater);
 }
+/**
+* Resets the table's row selection state slice.
+*
+* By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.
+*
+* @example
+* ```ts
+* table_resetRowSelection(table)
+* table_resetRowSelection(table, true)
+* ```
+*/
 function table_resetRowSelection(table, defaultState) {
 	table_setRowSelection(table, defaultState ? {} : cloneState(table.initialState.rowSelection ?? {}));
 }
+/**
+* Toggles all rows selected for the table.
+*
+* This is the table-level convenience API used by UI controls that affect many columns or rows at once.
+*
+* @example
+* ```ts
+* table_toggleAllRowsSelected(table)
+* ```
+*/
 function table_toggleAllRowsSelected(table, value) {
 	table_setRowSelection(table, (old) => {
 		value = typeof value !== "undefined" ? value : !table_getIsAllRowsSelected(table);
@@ -26,6 +67,16 @@ function table_toggleAllRowsSelected(table, value) {
 		return rowSelection;
 	});
 }
+/**
+* Toggles all page rows selected for the table.
+*
+* This is the table-level convenience API used by UI controls that affect many columns or rows at once.
+*
+* @example
+* ```ts
+* table_toggleAllPageRowsSelected(table)
+* ```
+*/
 function table_toggleAllPageRowsSelected(table, value) {
 	table_setRowSelection(table, (old) => {
 		const resolvedValue = typeof value !== "undefined" ? value : !table_getIsAllPageRowsSelected(table);
@@ -36,9 +87,29 @@ function table_toggleAllPageRowsSelected(table, value) {
 		return rowSelection;
 	});
 }
+/**
+* Returns pre selected row model 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_getPreSelectedRowModel(table)
+* ```
+*/
 function table_getPreSelectedRowModel(table) {
 	return table.getCoreRowModel();
 }
+/**
+* Returns selected row model 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_getSelectedRowModel(table)
+* ```
+*/
 function table_getSelectedRowModel(table) {
 	var _table$atoms$rowSelec;
 	const rowModel = table.getCoreRowModel();
@@ -49,6 +120,16 @@ function table_getSelectedRowModel(table) {
 	};
 	return selectRowsFn(rowModel);
 }
+/**
+* Returns filtered selected row model 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_getFilteredSelectedRowModel(table)
+* ```
+*/
 function table_getFilteredSelectedRowModel(table) {
 	var _table$atoms$rowSelec2;
 	const rowModel = table.getCoreRowModel();
@@ -59,6 +140,16 @@ function table_getFilteredSelectedRowModel(table) {
 	};
 	return selectRowsFn(rowModel);
 }
+/**
+* Returns grouped selected row model 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_getGroupedSelectedRowModel(table)
+* ```
+*/
 function table_getGroupedSelectedRowModel(table) {
 	var _table$atoms$rowSelec3;
 	const rowModel = table.getCoreRowModel();
@@ -69,6 +160,16 @@ function table_getGroupedSelectedRowModel(table) {
 	};
 	return selectRowsFn(rowModel);
 }
+/**
+* Returns is all rows selected 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_getIsAllRowsSelected(table)
+* ```
+*/
 function table_getIsAllRowsSelected(table) {
 	var _table$atoms$rowSelec4;
 	const preGroupedFlatRows = table.getFilteredRowModel().flatRows;
@@ -79,6 +180,16 @@ function table_getIsAllRowsSelected(table) {
 	}
 	return isAllRowsSelected;
 }
+/**
+* Returns is all page rows selected 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_getIsAllPageRowsSelected(table)
+* ```
+*/
 function table_getIsAllPageRowsSelected(table) {
 	var _table$atoms$rowSelec5;
 	const paginationFlatRows = table.getPaginatedRowModel().flatRows.filter((row) => row_getCanSelect(row));
@@ -87,25 +198,75 @@ function table_getIsAllPageRowsSelected(table) {
 	if (isAllPageRowsSelected && paginationFlatRows.some((row) => !rowSelection[row.id])) isAllPageRowsSelected = false;
 	return isAllPageRowsSelected;
 }
+/**
+* Returns is some rows selected 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_getIsSomeRowsSelected(table)
+* ```
+*/
 function table_getIsSomeRowsSelected(table) {
 	var _table$atoms$rowSelec6;
 	const totalSelected = Object.keys(((_table$atoms$rowSelec6 = table.atoms.rowSelection) === null || _table$atoms$rowSelec6 === void 0 ? void 0 : _table$atoms$rowSelec6.get()) ?? {}).length;
 	return totalSelected > 0 && totalSelected < table.getFilteredRowModel().flatRows.length;
 }
+/**
+* Returns is some page rows selected 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_getIsSomePageRowsSelected(table)
+* ```
+*/
 function table_getIsSomePageRowsSelected(table) {
 	const paginationFlatRows = table.getPaginatedRowModel().flatRows;
 	return table_getIsAllPageRowsSelected(table) ? false : paginationFlatRows.filter((row) => row_getCanSelect(row)).some((row) => row_getIsSelected(row) || row_getIsSomeSelected(row));
 }
+/**
+* Returns an event handler for all rows selected handler.
+*
+* The handler calls the matching table toggle API and can be attached directly to checkbox or button UI.
+*
+* @example
+* ```ts
+* const value = table_getToggleAllRowsSelectedHandler(table)
+* ```
+*/
 function table_getToggleAllRowsSelectedHandler(table) {
 	return (e) => {
 		table_toggleAllRowsSelected(table, e.target.checked);
 	};
 }
+/**
+* Returns an event handler for all page rows selected handler.
+*
+* The handler calls the matching table toggle API and can be attached directly to checkbox or button UI.
+*
+* @example
+* ```ts
+* const value = table_getToggleAllPageRowsSelectedHandler(table)
+* ```
+*/
 function table_getToggleAllPageRowsSelectedHandler(table) {
 	return (e) => {
 		table_toggleAllPageRowsSelected(table, e.target.checked);
 	};
 }
+/**
+* Toggles selected for a row.
+*
+* The update is routed through the table state updater for the owning feature state slice.
+*
+* @example
+* ```ts
+* row_toggleSelected(row)
+* ```
+*/
 function row_toggleSelected(row, value, opts) {
 	const isSelected = row_getIsSelected(row);
 	table_setRowSelection(row.table, (old) => {
@@ -116,30 +277,100 @@ function row_toggleSelected(row, value, opts) {
 		return selectedRowIds;
 	});
 }
+/**
+* Returns is selected for a row.
+*
+* This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+*
+* @example
+* ```ts
+* const value = row_getIsSelected(row)
+* ```
+*/
 function row_getIsSelected(row) {
 	return isRowSelected(row);
 }
+/**
+* Returns is some selected for a row.
+*
+* This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+*
+* @example
+* ```ts
+* const value = row_getIsSomeSelected(row)
+* ```
+*/
 function row_getIsSomeSelected(row) {
 	return isSubRowSelected(row) === "some";
 }
+/**
+* Returns is all sub rows selected for a row.
+*
+* This is the static implementation behind the matching row instance API and may read row caches or table state atoms.
+*
+* @example
+* ```ts
+* const value = row_getIsAllSubRowsSelected(row)
+* ```
+*/
 function row_getIsAllSubRowsSelected(row) {
 	return isSubRowSelected(row) === "all";
 }
+/**
+* Returns whether a row can use select.
+*
+* This evaluates row data, table options, and feature-specific enablement rules.
+*
+* @example
+* ```ts
+* const value = row_getCanSelect(row)
+* ```
+*/
 function row_getCanSelect(row) {
 	const options = row.table.options;
 	if (typeof options.enableRowSelection === "function") return options.enableRowSelection(row);
 	return options.enableRowSelection ?? true;
 }
+/**
+* Returns whether a row can use select sub rows.
+*
+* This evaluates row data, table options, and feature-specific enablement rules.
+*
+* @example
+* ```ts
+* const value = row_getCanSelectSubRows(row)
+* ```
+*/
 function row_getCanSelectSubRows(row) {
 	const options = row.table.options;
 	if (typeof options.enableSubRowSelection === "function") return options.enableSubRowSelection(row);
 	return options.enableSubRowSelection ?? true;
 }
+/**
+* Returns whether a row can use multi select.
+*
+* This evaluates row data, table options, and feature-specific enablement rules.
+*
+* @example
+* ```ts
+* const value = row_getCanMultiSelect(row)
+* ```
+*/
 function row_getCanMultiSelect(row) {
 	const options = row.table.options;
 	if (typeof options.enableMultiRowSelection === "function") return options.enableMultiRowSelection(row);
 	return options.enableMultiRowSelection ?? true;
 }
+/**
+* Returns an event handler for toggling selected handler.
+*
+* The handler is intended for direct use in row-level controls such as expansion or selection buttons.
+*
+* @example
+* ```ts
+* const value = row_getToggleSelectedHandler(row)
+* ```
+*/
 function row_getToggleSelectedHandler(row) {
 	const canSelect = row_getCanSelect(row);
 	return (e) => {
@@ -155,11 +386,23 @@ const mutateRowIsSelected = (selectedRowIds, rowId, value, includeChildren, tabl
 	} else delete selectedRowIds[rowId];
 	if (includeChildren && row.subRows.length && row_getCanSelectSubRows(row)) row.subRows.forEach((r) => mutateRowIsSelected(selectedRowIds, r.id, value, includeChildren, table));
 };
+/**
+* Builds a row model containing rows selected by the current row selection state.
+*
+* The result is derived from the supplied row model, so selected ids absent from the current data are not materialized as rows.
+*
+* @example
+* ```ts
+* const selectedRows = selectRowsFn(table, rowModel)
+* ```
+*/
 function selectRowsFn(rowModel) {
 	const newSelectedFlatRows = [];
 	const newSelectedRowsById = {};
 	const recurseRows = (rows, depth = 0) => {
-		return rows.map((row) => {
+		const result = [];
+		for (let i = 0; i < rows.length; i++) {
+			let row = rows[i];
 			const isSelected = isRowSelected(row);
 			if (isSelected) {
 				newSelectedFlatRows.push(row);
@@ -169,8 +412,9 @@ function selectRowsFn(rowModel) {
 				...row,
 				subRows: recurseRows(row.subRows, depth + 1)
 			};
-			if (isSelected) return row;
-		}).filter((x) => !!x);
+			if (isSelected) result.push(row);
+		}
+		return result;
 	};
 	return {
 		rows: recurseRows(rowModel.rows),
@@ -178,10 +422,28 @@ function selectRowsFn(rowModel) {
 		rowsById: newSelectedRowsById
 	};
 }
+/**
+* Returns whether a row id is selected in the current row selection state.
+*
+* @example
+* ```ts
+* const selected = isRowSelected(row, selection)
+* ```
+*/
 function isRowSelected(row) {
 	var _row$table$atoms$rowS;
 	return (((_row$table$atoms$rowS = row.table.atoms.rowSelection) === null || _row$table$atoms$rowS === void 0 ? void 0 : _row$table$atoms$rowS.get()) ?? {})[row.id] ?? false;
 }
+/**
+* Returns whether all, some, or none of a row's selectable descendants are selected.
+*
+* The result is used to drive indeterminate row selection UI.
+*
+* @example
+* ```ts
+* const selectedState = isSubRowSelected(row, selection, table)
+* ```
+*/
 function isSubRowSelected(row) {
 	if (!row.subRows.length) return false;
 	let allChildrenSelected = true;

package/dist/features/row-selection/rowSelectionFeature.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"rowSelectionFeature.utils.js","names":[],"sources":["../../../src/features/row-selection/rowSelectionFeature.utils.ts"],"sourcesContent":["import { cloneState } from '../../utils'\nimport type { RowData, Updater } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { RowModel } from '../../core/row-models/coreRowModelsFeature.types'\nimport type { Table_Internal } from '../../types/Table'\nimport type { Row } from '../../types/Row'\nimport type { RowSelectionState } from './rowSelectionFeature.types'\n\n// State APIs\n\nexport function getDefaultRowSelectionState(): RowSelectionState {\n  return {}\n}\n\nexport function table_setRowSelection<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  updater: Updater<RowSelectionState>,\n) {\n  table.options.onRowSelectionChange?.(updater)\n}\n\nexport function table_resetRowSelection<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean) {\n  table_setRowSelection(\n    table,\n    defaultState ? {} : cloneState(table.initialState.rowSelection ?? {}),\n  )\n}\n\n// Table APIs\n\nexport function table_toggleAllRowsSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, value?: boolean) {\n  table_setRowSelection(table, (old) => {\n    value =\n      typeof value !== 'undefined' ? value : !table_getIsAllRowsSelected(table)\n\n    const rowSelection = { ...old }\n\n    const preGroupedFlatRows = table.getPreGroupedRowModel().flatRows\n\n    // We don't use `mutateRowIsSelected` here for performance reasons.\n    // All of the rows are flat already, so it wouldn't be worth it\n    if (value) {\n      preGroupedFlatRows.forEach((row) => {\n        if (!row_getCanSelect(row)) {\n          return\n        }\n        rowSelection[row.id] = true\n      })\n    } else {\n      preGroupedFlatRows.forEach((row) => {\n        delete rowSelection[row.id]\n      })\n    }\n\n    return rowSelection\n  })\n}\n\nexport function table_toggleAllPageRowsSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, value?: boolean) {\n  table_setRowSelection(table, (old) => {\n    const resolvedValue =\n      typeof value !== 'undefined'\n        ? value\n        : !table_getIsAllPageRowsSelected(table)\n\n    const rowSelection: RowSelectionState = { ...old }\n\n    table.getRowModel().rows.forEach((row) => {\n      mutateRowIsSelected(rowSelection, row.id, resolvedValue, true, table)\n    })\n\n    return rowSelection\n  })\n}\n\nexport function table_getPreSelectedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  return table.getCoreRowModel()\n}\n\nexport function table_getSelectedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const rowModel = table.getCoreRowModel()\n\n  if (!Object.keys(table.atoms.rowSelection?.get() ?? {}).length) {\n    return {\n      rows: [],\n      flatRows: [],\n      rowsById: {},\n    }\n  }\n\n  return selectRowsFn(rowModel)\n}\n\nexport function table_getFilteredSelectedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const rowModel = table.getCoreRowModel()\n\n  if (!Object.keys(table.atoms.rowSelection?.get() ?? {}).length) {\n    return {\n      rows: [],\n      flatRows: [],\n      rowsById: {},\n    }\n  }\n\n  return selectRowsFn(rowModel)\n}\n\nexport function table_getGroupedSelectedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const rowModel = table.getCoreRowModel()\n\n  if (!Object.keys(table.atoms.rowSelection?.get() ?? {}).length) {\n    return {\n      rows: [],\n      flatRows: [],\n      rowsById: {},\n    }\n  }\n\n  return selectRowsFn(rowModel)\n}\n\nexport function table_getIsAllRowsSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const preGroupedFlatRows = table.getFilteredRowModel().flatRows\n  const rowSelection: RowSelectionState = table.atoms.rowSelection?.get() ?? {}\n\n  let isAllRowsSelected = Boolean(\n    preGroupedFlatRows.length && Object.keys(rowSelection).length,\n  )\n\n  if (isAllRowsSelected) {\n    if (\n      preGroupedFlatRows.some(\n        (row) => row_getCanSelect(row) && !rowSelection[row.id],\n      )\n    ) {\n      isAllRowsSelected = false\n    }\n  }\n\n  return isAllRowsSelected\n}\n\nexport function table_getIsAllPageRowsSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const paginationFlatRows = table\n    .getPaginatedRowModel()\n    .flatRows.filter((row) => row_getCanSelect(row))\n  const rowSelection: RowSelectionState = table.atoms.rowSelection?.get() ?? {}\n\n  let isAllPageRowsSelected = !!paginationFlatRows.length\n\n  if (\n    isAllPageRowsSelected &&\n    paginationFlatRows.some((row) => !rowSelection[row.id])\n  ) {\n    isAllPageRowsSelected = false\n  }\n\n  return isAllPageRowsSelected\n}\n\nexport function table_getIsSomeRowsSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const totalSelected = Object.keys(\n    table.atoms.rowSelection?.get() ?? {},\n  ).length\n  return (\n    totalSelected > 0 &&\n    totalSelected < table.getFilteredRowModel().flatRows.length\n  )\n}\n\nexport function table_getIsSomePageRowsSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const paginationFlatRows = table.getPaginatedRowModel().flatRows\n  return table_getIsAllPageRowsSelected(table)\n    ? false\n    : paginationFlatRows\n        .filter((row) => row_getCanSelect(row))\n        .some((row) => row_getIsSelected(row) || row_getIsSomeSelected(row))\n}\n\nexport function table_getToggleAllRowsSelectedHandler<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  return (e: unknown) => {\n    table_toggleAllRowsSelected(\n      table,\n      ((e as MouseEvent).target as HTMLInputElement).checked,\n    )\n  }\n}\n\nexport function table_getToggleAllPageRowsSelectedHandler<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  return (e: unknown) => {\n    table_toggleAllPageRowsSelected(\n      table,\n      ((e as MouseEvent).target as HTMLInputElement).checked,\n    )\n  }\n}\n\n// Row APIs\n\nexport function row_toggleSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  value?: boolean,\n  opts?: {\n    selectChildren?: boolean\n  },\n) {\n  const isSelected = row_getIsSelected(row)\n\n  table_setRowSelection(row.table, (old) => {\n    value = typeof value !== 'undefined' ? value : !isSelected\n\n    if (row_getCanSelect(row) && isSelected === value) {\n      return old\n    }\n\n    const selectedRowIds = { ...old }\n\n    mutateRowIsSelected(\n      selectedRowIds,\n      row.id,\n      value,\n      opts?.selectChildren ?? true,\n      row.table,\n    )\n\n    return selectedRowIds\n  })\n}\n\nexport function row_getIsSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>) {\n  return isRowSelected(row)\n}\n\nexport function row_getIsSomeSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>) {\n  return isSubRowSelected(row) === 'some'\n}\n\nexport function row_getIsAllSubRowsSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>) {\n  return isSubRowSelected(row) === 'all'\n}\n\nexport function row_getCanSelect<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>) {\n  const options = row.table.options\n  if (typeof options.enableRowSelection === 'function') {\n    return options.enableRowSelection(row)\n  }\n\n  return options.enableRowSelection ?? true\n}\n\nexport function row_getCanSelectSubRows<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>) {\n  const options = row.table.options\n  if (typeof options.enableSubRowSelection === 'function') {\n    return options.enableSubRowSelection(row)\n  }\n\n  return options.enableSubRowSelection ?? true\n}\n\nexport function row_getCanMultiSelect<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>) {\n  const options = row.table.options\n  if (typeof options.enableMultiRowSelection === 'function') {\n    return options.enableMultiRowSelection(row)\n  }\n\n  return options.enableMultiRowSelection ?? true\n}\n\nexport function row_getToggleSelectedHandler<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>) {\n  const canSelect = row_getCanSelect(row)\n\n  return (e: unknown) => {\n    if (!canSelect) return\n    row_toggleSelected(\n      row,\n      ((e as MouseEvent).target as HTMLInputElement).checked,\n    )\n  }\n}\n\nconst mutateRowIsSelected = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  selectedRowIds: Record<string, boolean | undefined>,\n  rowId: string,\n  value: boolean,\n  includeChildren: boolean,\n  table: Table_Internal<TFeatures, TData>,\n) => {\n  const row = table.getRow(rowId, true)\n\n  if (value) {\n    if (!row_getCanMultiSelect(row)) {\n      Object.keys(selectedRowIds).forEach((key) => delete selectedRowIds[key])\n    }\n    if (row_getCanSelect(row)) {\n      selectedRowIds[rowId] = true\n    }\n  } else {\n    delete selectedRowIds[rowId]\n  }\n\n  if (includeChildren && row.subRows.length && row_getCanSelectSubRows(row)) {\n    row.subRows.forEach((r) =>\n      mutateRowIsSelected(selectedRowIds, r.id, value, includeChildren, table),\n    )\n  }\n}\n\nexport function selectRowsFn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(rowModel: RowModel<TFeatures, TData>): RowModel<TFeatures, TData> {\n  const newSelectedFlatRows: Array<Row<TFeatures, TData>> = []\n  const newSelectedRowsById: Record<string, Row<TFeatures, TData>> = {}\n\n  // Filters top level and nested rows\n  const recurseRows = (\n    rows: Array<Row<TFeatures, TData>>,\n    depth = 0,\n  ): Array<Row<TFeatures, TData>> => {\n    return rows\n      .map((row) => {\n        const isSelected = isRowSelected(row)\n\n        if (isSelected) {\n          newSelectedFlatRows.push(row)\n          newSelectedRowsById[row.id] = row\n        }\n\n        if (row.subRows.length) {\n          row = {\n            ...row,\n            subRows: recurseRows(row.subRows, depth + 1),\n          }\n        }\n\n        if (isSelected) {\n          return row\n        }\n      })\n      .filter((x) => !!x)\n  }\n\n  return {\n    rows: recurseRows(rowModel.rows),\n    flatRows: newSelectedFlatRows,\n    rowsById: newSelectedRowsById,\n  }\n}\n\nexport function isRowSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>): boolean {\n  return (row.table.atoms.rowSelection?.get() ?? {})[row.id] ?? false\n}\n\nexport function isSubRowSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>): boolean | 'some' | 'all' {\n  if (!row.subRows.length) return false\n\n  let allChildrenSelected = true\n  let someSelected = false\n\n  row.subRows.forEach((subRow) => {\n    // Bail out early if we know both of these\n    if (someSelected && !allChildrenSelected) {\n      return\n    }\n\n    if (row_getCanSelect(subRow)) {\n      if (isRowSelected(subRow)) {\n        someSelected = true\n      } else {\n        allChildrenSelected = false\n      }\n    }\n\n    // Check row selection of nested subrows\n    if (subRow.subRows.length) {\n      const subRowChildrenSelected = isSubRowSelected(subRow)\n      if (subRowChildrenSelected === 'all') {\n        someSelected = true\n      } else if (subRowChildrenSelected === 'some') {\n        someSelected = true\n        allChildrenSelected = false\n      } else {\n        allChildrenSelected = false\n      }\n    }\n  })\n\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  return allChildrenSelected ? 'all' : someSelected ? 'some' : false\n}\n"],"mappings":"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"}
+{"version":3,"file":"rowSelectionFeature.utils.js","names":[],"sources":["../../../src/features/row-selection/rowSelectionFeature.utils.ts"],"sourcesContent":["import { cloneState } from '../../utils'\nimport type { RowData, Updater } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { RowModel } from '../../core/row-models/coreRowModelsFeature.types'\nimport type { Table_Internal } from '../../types/Table'\nimport type { Row } from '../../types/Row'\nimport type { RowSelectionState } from './rowSelectionFeature.types'\n\n// State APIs\n\n/**\n * Returns the default row selection state.\n *\n * Feature constructors use this value to initialize the table state or option defaults when no user value is provided.\n *\n * @example\n * ```ts\n * const initialValue = getDefaultRowSelectionState()\n * ```\n */\nexport function getDefaultRowSelectionState(): RowSelectionState {\n  return {}\n}\n\n/**\n * Updates the table's row selection 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_setRowSelection(table, (old) => old)\n * ```\n */\nexport function table_setRowSelection<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  updater: Updater<RowSelectionState>,\n) {\n  table.options.onRowSelectionChange?.(updater)\n}\n\n/**\n * Resets the table's row selection 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_resetRowSelection(table)\n * table_resetRowSelection(table, true)\n * ```\n */\nexport function table_resetRowSelection<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean) {\n  table_setRowSelection(\n    table,\n    defaultState ? {} : cloneState(table.initialState.rowSelection ?? {}),\n  )\n}\n\n// Table APIs\n\n/**\n * Toggles all rows selected for the table.\n *\n * This is the table-level convenience API used by UI controls that affect many columns or rows at once.\n *\n * @example\n * ```ts\n * table_toggleAllRowsSelected(table)\n * ```\n */\nexport function table_toggleAllRowsSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, value?: boolean) {\n  table_setRowSelection(table, (old) => {\n    value =\n      typeof value !== 'undefined' ? value : !table_getIsAllRowsSelected(table)\n\n    const rowSelection = { ...old }\n\n    const preGroupedFlatRows = table.getPreGroupedRowModel().flatRows\n\n    // We don't use `mutateRowIsSelected` here for performance reasons.\n    // All of the rows are flat already, so it wouldn't be worth it\n    if (value) {\n      preGroupedFlatRows.forEach((row) => {\n        if (!row_getCanSelect(row)) {\n          return\n        }\n        rowSelection[row.id] = true\n      })\n    } else {\n      preGroupedFlatRows.forEach((row) => {\n        delete rowSelection[row.id]\n      })\n    }\n\n    return rowSelection\n  })\n}\n\n/**\n * Toggles all page rows selected for the table.\n *\n * This is the table-level convenience API used by UI controls that affect many columns or rows at once.\n *\n * @example\n * ```ts\n * table_toggleAllPageRowsSelected(table)\n * ```\n */\nexport function table_toggleAllPageRowsSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, value?: boolean) {\n  table_setRowSelection(table, (old) => {\n    const resolvedValue =\n      typeof value !== 'undefined'\n        ? value\n        : !table_getIsAllPageRowsSelected(table)\n\n    const rowSelection: RowSelectionState = { ...old }\n\n    table.getRowModel().rows.forEach((row) => {\n      mutateRowIsSelected(rowSelection, row.id, resolvedValue, true, table)\n    })\n\n    return rowSelection\n  })\n}\n\n/**\n * Returns pre selected row model 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_getPreSelectedRowModel(table)\n * ```\n */\nexport function table_getPreSelectedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  return table.getCoreRowModel()\n}\n\n/**\n * Returns selected row model 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_getSelectedRowModel(table)\n * ```\n */\nexport function table_getSelectedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const rowModel = table.getCoreRowModel()\n\n  if (!Object.keys(table.atoms.rowSelection?.get() ?? {}).length) {\n    return {\n      rows: [],\n      flatRows: [],\n      rowsById: {},\n    }\n  }\n\n  return selectRowsFn(rowModel)\n}\n\n/**\n * Returns filtered selected row model 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_getFilteredSelectedRowModel(table)\n * ```\n */\nexport function table_getFilteredSelectedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const rowModel = table.getCoreRowModel()\n\n  if (!Object.keys(table.atoms.rowSelection?.get() ?? {}).length) {\n    return {\n      rows: [],\n      flatRows: [],\n      rowsById: {},\n    }\n  }\n\n  return selectRowsFn(rowModel)\n}\n\n/**\n * Returns grouped selected row model 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_getGroupedSelectedRowModel(table)\n * ```\n */\nexport function table_getGroupedSelectedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const rowModel = table.getCoreRowModel()\n\n  if (!Object.keys(table.atoms.rowSelection?.get() ?? {}).length) {\n    return {\n      rows: [],\n      flatRows: [],\n      rowsById: {},\n    }\n  }\n\n  return selectRowsFn(rowModel)\n}\n\n/**\n * Returns is all rows selected 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_getIsAllRowsSelected(table)\n * ```\n */\nexport function table_getIsAllRowsSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const preGroupedFlatRows = table.getFilteredRowModel().flatRows\n  const rowSelection: RowSelectionState = table.atoms.rowSelection?.get() ?? {}\n\n  let isAllRowsSelected = Boolean(\n    preGroupedFlatRows.length && Object.keys(rowSelection).length,\n  )\n\n  if (isAllRowsSelected) {\n    if (\n      preGroupedFlatRows.some(\n        (row) => row_getCanSelect(row) && !rowSelection[row.id],\n      )\n    ) {\n      isAllRowsSelected = false\n    }\n  }\n\n  return isAllRowsSelected\n}\n\n/**\n * Returns is all page rows selected 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_getIsAllPageRowsSelected(table)\n * ```\n */\nexport function table_getIsAllPageRowsSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const paginationFlatRows = table\n    .getPaginatedRowModel()\n    .flatRows.filter((row) => row_getCanSelect(row))\n  const rowSelection: RowSelectionState = table.atoms.rowSelection?.get() ?? {}\n\n  let isAllPageRowsSelected = !!paginationFlatRows.length\n\n  if (\n    isAllPageRowsSelected &&\n    paginationFlatRows.some((row) => !rowSelection[row.id])\n  ) {\n    isAllPageRowsSelected = false\n  }\n\n  return isAllPageRowsSelected\n}\n\n/**\n * Returns is some rows selected 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_getIsSomeRowsSelected(table)\n * ```\n */\nexport function table_getIsSomeRowsSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const totalSelected = Object.keys(\n    table.atoms.rowSelection?.get() ?? {},\n  ).length\n  return (\n    totalSelected > 0 &&\n    totalSelected < table.getFilteredRowModel().flatRows.length\n  )\n}\n\n/**\n * Returns is some page rows selected 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_getIsSomePageRowsSelected(table)\n * ```\n */\nexport function table_getIsSomePageRowsSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const paginationFlatRows = table.getPaginatedRowModel().flatRows\n  return table_getIsAllPageRowsSelected(table)\n    ? false\n    : paginationFlatRows\n        .filter((row) => row_getCanSelect(row))\n        .some((row) => row_getIsSelected(row) || row_getIsSomeSelected(row))\n}\n\n/**\n * Returns an event handler for all rows selected handler.\n *\n * The handler calls the matching table toggle API and can be attached directly to checkbox or button UI.\n *\n * @example\n * ```ts\n * const value = table_getToggleAllRowsSelectedHandler(table)\n * ```\n */\nexport function table_getToggleAllRowsSelectedHandler<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  return (e: unknown) => {\n    table_toggleAllRowsSelected(\n      table,\n      ((e as MouseEvent).target as HTMLInputElement).checked,\n    )\n  }\n}\n\n/**\n * Returns an event handler for all page rows selected handler.\n *\n * The handler calls the matching table toggle API and can be attached directly to checkbox or button UI.\n *\n * @example\n * ```ts\n * const value = table_getToggleAllPageRowsSelectedHandler(table)\n * ```\n */\nexport function table_getToggleAllPageRowsSelectedHandler<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  return (e: unknown) => {\n    table_toggleAllPageRowsSelected(\n      table,\n      ((e as MouseEvent).target as HTMLInputElement).checked,\n    )\n  }\n}\n\n// Row APIs\n\n/**\n * Toggles selected for a row.\n *\n * The update is routed through the table state updater for the owning feature state slice.\n *\n * @example\n * ```ts\n * row_toggleSelected(row)\n * ```\n */\nexport function row_toggleSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  value?: boolean,\n  opts?: {\n    selectChildren?: boolean\n  },\n) {\n  const isSelected = row_getIsSelected(row)\n\n  table_setRowSelection(row.table, (old) => {\n    value = typeof value !== 'undefined' ? value : !isSelected\n\n    if (row_getCanSelect(row) && isSelected === value) {\n      return old\n    }\n\n    const selectedRowIds = { ...old }\n\n    mutateRowIsSelected(\n      selectedRowIds,\n      row.id,\n      value,\n      opts?.selectChildren ?? true,\n      row.table,\n    )\n\n    return selectedRowIds\n  })\n}\n\n/**\n * Returns is selected for a row.\n *\n * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.\n *\n * @example\n * ```ts\n * const value = row_getIsSelected(row)\n * ```\n */\nexport function row_getIsSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>) {\n  return isRowSelected(row)\n}\n\n/**\n * Returns is some selected for a row.\n *\n * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.\n *\n * @example\n * ```ts\n * const value = row_getIsSomeSelected(row)\n * ```\n */\nexport function row_getIsSomeSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>) {\n  return isSubRowSelected(row) === 'some'\n}\n\n/**\n * Returns is all sub rows selected for a row.\n *\n * This is the static implementation behind the matching row instance API and may read row caches or table state atoms.\n *\n * @example\n * ```ts\n * const value = row_getIsAllSubRowsSelected(row)\n * ```\n */\nexport function row_getIsAllSubRowsSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>) {\n  return isSubRowSelected(row) === 'all'\n}\n\n/**\n * Returns whether a row can use select.\n *\n * This evaluates row data, table options, and feature-specific enablement rules.\n *\n * @example\n * ```ts\n * const value = row_getCanSelect(row)\n * ```\n */\nexport function row_getCanSelect<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>) {\n  const options = row.table.options\n  if (typeof options.enableRowSelection === 'function') {\n    return options.enableRowSelection(row)\n  }\n\n  return options.enableRowSelection ?? true\n}\n\n/**\n * Returns whether a row can use select sub rows.\n *\n * This evaluates row data, table options, and feature-specific enablement rules.\n *\n * @example\n * ```ts\n * const value = row_getCanSelectSubRows(row)\n * ```\n */\nexport function row_getCanSelectSubRows<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>) {\n  const options = row.table.options\n  if (typeof options.enableSubRowSelection === 'function') {\n    return options.enableSubRowSelection(row)\n  }\n\n  return options.enableSubRowSelection ?? true\n}\n\n/**\n * Returns whether a row can use multi select.\n *\n * This evaluates row data, table options, and feature-specific enablement rules.\n *\n * @example\n * ```ts\n * const value = row_getCanMultiSelect(row)\n * ```\n */\nexport function row_getCanMultiSelect<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>) {\n  const options = row.table.options\n  if (typeof options.enableMultiRowSelection === 'function') {\n    return options.enableMultiRowSelection(row)\n  }\n\n  return options.enableMultiRowSelection ?? true\n}\n\n/**\n * Returns an event handler for toggling selected handler.\n *\n * The handler is intended for direct use in row-level controls such as expansion or selection buttons.\n *\n * @example\n * ```ts\n * const value = row_getToggleSelectedHandler(row)\n * ```\n */\nexport function row_getToggleSelectedHandler<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>) {\n  const canSelect = row_getCanSelect(row)\n\n  return (e: unknown) => {\n    if (!canSelect) return\n    row_toggleSelected(\n      row,\n      ((e as MouseEvent).target as HTMLInputElement).checked,\n    )\n  }\n}\n\nconst mutateRowIsSelected = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  selectedRowIds: Record<string, boolean | undefined>,\n  rowId: string,\n  value: boolean,\n  includeChildren: boolean,\n  table: Table_Internal<TFeatures, TData>,\n) => {\n  const row = table.getRow(rowId, true)\n\n  if (value) {\n    if (!row_getCanMultiSelect(row)) {\n      Object.keys(selectedRowIds).forEach((key) => delete selectedRowIds[key])\n    }\n    if (row_getCanSelect(row)) {\n      selectedRowIds[rowId] = true\n    }\n  } else {\n    delete selectedRowIds[rowId]\n  }\n\n  if (includeChildren && row.subRows.length && row_getCanSelectSubRows(row)) {\n    row.subRows.forEach((r) =>\n      mutateRowIsSelected(selectedRowIds, r.id, value, includeChildren, table),\n    )\n  }\n}\n\n/**\n * Builds a row model containing rows selected by the current row selection state.\n *\n * The result is derived from the supplied row model, so selected ids absent from the current data are not materialized as rows.\n *\n * @example\n * ```ts\n * const selectedRows = selectRowsFn(table, rowModel)\n * ```\n */\nexport function selectRowsFn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(rowModel: RowModel<TFeatures, TData>): RowModel<TFeatures, TData> {\n  const newSelectedFlatRows: Array<Row<TFeatures, TData>> = []\n  const newSelectedRowsById: Record<string, Row<TFeatures, TData>> = {}\n\n  // Filters top level and nested rows.\n  const recurseRows = (\n    rows: Array<Row<TFeatures, TData>>,\n    depth = 0,\n  ): Array<Row<TFeatures, TData>> => {\n    const result: Array<Row<TFeatures, TData>> = []\n    for (let i = 0; i < rows.length; i++) {\n      let row = rows[i]!\n      const isSelected = isRowSelected(row)\n\n      if (isSelected) {\n        newSelectedFlatRows.push(row)\n        newSelectedRowsById[row.id] = row\n      }\n\n      if (row.subRows.length) {\n        row = {\n          ...row,\n          subRows: recurseRows(row.subRows, depth + 1),\n        }\n      }\n\n      if (isSelected) {\n        result.push(row)\n      }\n    }\n    return result\n  }\n\n  return {\n    rows: recurseRows(rowModel.rows),\n    flatRows: newSelectedFlatRows,\n    rowsById: newSelectedRowsById,\n  }\n}\n\n/**\n * Returns whether a row id is selected in the current row selection state.\n *\n * @example\n * ```ts\n * const selected = isRowSelected(row, selection)\n * ```\n */\nexport function isRowSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>): boolean {\n  return (row.table.atoms.rowSelection?.get() ?? {})[row.id] ?? false\n}\n\n/**\n * Returns whether all, some, or none of a row's selectable descendants are selected.\n *\n * The result is used to drive indeterminate row selection UI.\n *\n * @example\n * ```ts\n * const selectedState = isSubRowSelected(row, selection, table)\n * ```\n */\nexport function isSubRowSelected<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>): boolean | 'some' | 'all' {\n  if (!row.subRows.length) return false\n\n  let allChildrenSelected = true\n  let someSelected = false\n\n  row.subRows.forEach((subRow) => {\n    // Bail out early if we know both of these\n    if (someSelected && !allChildrenSelected) {\n      return\n    }\n\n    if (row_getCanSelect(subRow)) {\n      if (isRowSelected(subRow)) {\n        someSelected = true\n      } else {\n        allChildrenSelected = false\n      }\n    }\n\n    // Check row selection of nested subrows\n    if (subRow.subRows.length) {\n      const subRowChildrenSelected = isSubRowSelected(subRow)\n      if (subRowChildrenSelected === 'all') {\n        someSelected = true\n      } else if (subRowChildrenSelected === 'some') {\n        someSelected = true\n        allChildrenSelected = false\n      } else {\n        allChildrenSelected = false\n      }\n    }\n  })\n\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  return allChildrenSelected ? 'all' : someSelected ? 'some' : false\n}\n"],"mappings":"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"}

package/dist/features/row-sorting/createSortedRowModel.cjs

@@ -3,6 +3,11 @@ const require_rowPaginationFeature_utils = require('../row-pagination/rowPaginat
 const require_rowSortingFeature_utils = require('./rowSortingFeature.utils.cjs');
 
 //#region src/features/row-sorting/createSortedRowModel.ts
+/**
+* Creates a memoized sorted 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 createSortedRowModel(sortFns) {
 	return (_table) => {
 		const table = _table;
@@ -38,11 +43,10 @@ function _createSortedRowModel(table) {
 		};
 	});
 	const sortData = (rows) => {
-		const sortedData = rows.map((row) => {
-			return Object.assign(Object.create(Object.getPrototypeOf(row)), row);
-		});
+		const sortedData = rows.slice();
 		sortedData.sort((rowA, rowB) => {
-			for (const sortEntry of availableSorting) {
+			for (let i = 0; i < availableSorting.length; i++) {
+				const sortEntry = availableSorting[i];
 				const columnInfo = columnInfoById[sortEntry.id];
 				const sortUndefined = columnInfo.sortUndefined;
 				const isDesc = sortEntry.desc;
@@ -67,10 +71,16 @@ function _createSortedRowModel(table) {
 			}
 			return rowA.index - rowB.index;
 		});
-		sortedData.forEach((row) => {
-			sortedFlatRows.push(row);
-			if (row.subRows.length) row.subRows = sortData(row.subRows);
-		});
+		for (let i = 0; i < sortedData.length; i++) {
+			const row = sortedData[i];
+			if (row.subRows.length) {
+				const cloned = Object.create(Object.getPrototypeOf(row));
+				Object.assign(cloned, row);
+				cloned.subRows = sortData(row.subRows);
+				sortedData[i] = cloned;
+				sortedFlatRows.push(cloned);
+			} else sortedFlatRows.push(row);
+		}
 		return sortedData;
 	};
 	return {

package/dist/features/row-sorting/createSortedRowModel.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"createSortedRowModel.cjs","names":["tableMemo","table_autoResetPageIndex","column_getCanSort","column_getSortFn"],"sources":["../../../src/features/row-sorting/createSortedRowModel.ts"],"sourcesContent":["import { tableMemo } from '../../utils'\nimport { table_autoResetPageIndex } from '../row-pagination/rowPaginationFeature.utils'\nimport { column_getCanSort, column_getSortFn } from './rowSortingFeature.utils'\nimport type { Column_Internal } from '../../types/Column'\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 { SortFn, SortFns } from './rowSortingFeature.types'\nimport type { RowData } from '../../types/type-utils'\n\nexport function createSortedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  sortFns: Record<keyof SortFns, SortFn<TFeatures, TData>>,\n): (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData> {\n  return (_table) => {\n    const table: Table_Internal<TFeatures, TData> = _table\n    if (!table._rowModelFns.sortFns) table._rowModelFns.sortFns = sortFns\n    return tableMemo({\n      feature: 'rowSortingFeature',\n      table,\n      fnName: 'table.getSortedRowModel',\n      memoDeps: () => [\n        table.atoms.sorting?.get(),\n        table.getPreSortedRowModel(),\n      ],\n      fn: () => _createSortedRowModel(table),\n      onAfterUpdate: () => table_autoResetPageIndex(table),\n    })\n  }\n}\n\nfunction _createSortedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  const preSortedRowModel = table.getPreSortedRowModel()\n  const sorting = table.atoms.sorting?.get()\n\n  if (!preSortedRowModel.rows.length || !sorting?.length) {\n    return preSortedRowModel\n  }\n\n  const sortedFlatRows: Array<Row<TFeatures, TData>> = []\n\n  // Filter out sortings that correspond to non existing columns\n  const availableSorting = sorting.filter((sort) =>\n    column_getCanSort(\n      table.getColumn(sort.id) as Column_Internal<TFeatures, TData>,\n    ),\n  )\n\n  const columnInfoById: Record<\n    string,\n    {\n      sortUndefined?: false | -1 | 1 | 'first' | 'last'\n      invertSorting?: boolean\n      sortFn: SortFn<TFeatures, TData>\n    }\n  > = {}\n\n  availableSorting.forEach((sortEntry) => {\n    const column: Column_Internal<TFeatures, TData> | undefined =\n      table.getColumn(sortEntry.id)\n    if (!column) return\n\n    columnInfoById[sortEntry.id] = {\n      sortUndefined: column.columnDef.sortUndefined,\n      invertSorting: column.columnDef.invertSorting,\n      sortFn: column_getSortFn(column),\n    }\n  })\n\n  const sortData = (rows: Array<Row<TFeatures, TData>>) => {\n    // This will also perform a stable sorting using the row index\n    // if needed.\n    // Preserve prototype chain so methods like getValue() remain accessible\n    const sortedData = rows.map((row) => {\n      const cloned = Object.create(Object.getPrototypeOf(row))\n      return Object.assign(cloned, row)\n    })\n\n    sortedData.sort((rowA, rowB) => {\n      for (const sortEntry of availableSorting) {\n        const columnInfo = columnInfoById[sortEntry.id]!\n        const sortUndefined = columnInfo.sortUndefined\n        const isDesc = sortEntry.desc\n\n        let sortInt = 0\n\n        // All sorting ints should always return in ascending order\n        if (sortUndefined) {\n          const aValue = rowA.getValue(sortEntry.id)\n          const bValue = rowB.getValue(sortEntry.id)\n\n          const aUndefined = aValue === undefined\n          const bUndefined = bValue === undefined\n\n          if (aUndefined || bUndefined) {\n            if (sortUndefined === 'first') return aUndefined ? -1 : 1\n            if (sortUndefined === 'last') return aUndefined ? 1 : -1\n            sortInt =\n              aUndefined && bUndefined\n                ? 0\n                : aUndefined\n                  ? sortUndefined\n                  : -sortUndefined\n          }\n        }\n\n        if (sortInt === 0) {\n          sortInt = columnInfo.sortFn(rowA, rowB, sortEntry.id)\n        }\n\n        // If sorting is non-zero, take care of desc and inversion\n        if (sortInt !== 0) {\n          if (isDesc) {\n            sortInt *= -1\n          }\n\n          if (columnInfo.invertSorting) {\n            sortInt *= -1\n          }\n\n          return sortInt\n        }\n      }\n      return rowA.index - rowB.index\n    })\n\n    // If there are sub-rows, sort them\n    sortedData.forEach((row) => {\n      sortedFlatRows.push(row)\n      if (row.subRows.length) {\n        row.subRows = sortData(row.subRows)\n      }\n    })\n\n    return sortedData\n  }\n\n  return {\n    rows: sortData(preSortedRowModel.rows),\n    flatRows: sortedFlatRows,\n    rowsById: preSortedRowModel.rowsById,\n  }\n}\n"],"mappings":";;;;;AAWA,SAAgB,qBAId,SACsE;AACtE,SAAQ,WAAW;EACjB,MAAM,QAA0C;AAChD,MAAI,CAAC,MAAM,aAAa,QAAS,OAAM,aAAa,UAAU;AAC9D,SAAOA,wBAAU;GACf,SAAS;GACT;GACA,QAAQ;GACR,gBAAgB;;oCACd,MAAM,MAAM,qFAAS,KAAK,EAC1B,MAAM,sBAAsB,CAC7B;;GACD,UAAU,sBAAsB,MAAM;GACtC,qBAAqBC,4DAAyB,MAAM;GACrD,CAAC;;;AAIN,SAAS,sBAGP,OAAqE;;CACrE,MAAM,oBAAoB,MAAM,sBAAsB;CACtD,MAAM,mCAAU,MAAM,MAAM,uFAAS,KAAK;AAE1C,KAAI,CAAC,kBAAkB,KAAK,UAAU,oDAAC,QAAS,QAC9C,QAAO;CAGT,MAAM,iBAA+C,EAAE;CAGvD,MAAM,mBAAmB,QAAQ,QAAQ,SACvCC,kDACE,MAAM,UAAU,KAAK,GAAG,CACzB,CACF;CAED,MAAM,iBAOF,EAAE;AAEN,kBAAiB,SAAS,cAAc;EACtC,MAAM,SACJ,MAAM,UAAU,UAAU,GAAG;AAC/B,MAAI,CAAC,OAAQ;AAEb,iBAAe,UAAU,MAAM;GAC7B,eAAe,OAAO,UAAU;GAChC,eAAe,OAAO,UAAU;GAChC,QAAQC,iDAAiB,OAAO;GACjC;GACD;CAEF,MAAM,YAAY,SAAuC;EAIvD,MAAM,aAAa,KAAK,KAAK,QAAQ;AAEnC,UAAO,OAAO,OADC,OAAO,OAAO,OAAO,eAAe,IAAI,CAC5B,EAAE,IAAI;IACjC;AAEF,aAAW,MAAM,MAAM,SAAS;AAC9B,QAAK,MAAM,aAAa,kBAAkB;IACxC,MAAM,aAAa,eAAe,UAAU;IAC5C,MAAM,gBAAgB,WAAW;IACjC,MAAM,SAAS,UAAU;IAEzB,IAAI,UAAU;AAGd,QAAI,eAAe;KACjB,MAAM,SAAS,KAAK,SAAS,UAAU,GAAG;KAC1C,MAAM,SAAS,KAAK,SAAS,UAAU,GAAG;KAE1C,MAAM,aAAa,WAAW;KAC9B,MAAM,aAAa,WAAW;AAE9B,SAAI,cAAc,YAAY;AAC5B,UAAI,kBAAkB,QAAS,QAAO,aAAa,KAAK;AACxD,UAAI,kBAAkB,OAAQ,QAAO,aAAa,IAAI;AACtD,gBACE,cAAc,aACV,IACA,aACE,gBACA,CAAC;;;AAIb,QAAI,YAAY,EACd,WAAU,WAAW,OAAO,MAAM,MAAM,UAAU,GAAG;AAIvD,QAAI,YAAY,GAAG;AACjB,SAAI,OACF,YAAW;AAGb,SAAI,WAAW,cACb,YAAW;AAGb,YAAO;;;AAGX,UAAO,KAAK,QAAQ,KAAK;IACzB;AAGF,aAAW,SAAS,QAAQ;AAC1B,kBAAe,KAAK,IAAI;AACxB,OAAI,IAAI,QAAQ,OACd,KAAI,UAAU,SAAS,IAAI,QAAQ;IAErC;AAEF,SAAO;;AAGT,QAAO;EACL,MAAM,SAAS,kBAAkB,KAAK;EACtC,UAAU;EACV,UAAU,kBAAkB;EAC7B"}
+{"version":3,"file":"createSortedRowModel.cjs","names":["tableMemo","table_autoResetPageIndex","column_getCanSort","column_getSortFn"],"sources":["../../../src/features/row-sorting/createSortedRowModel.ts"],"sourcesContent":["import { tableMemo } from '../../utils'\nimport { table_autoResetPageIndex } from '../row-pagination/rowPaginationFeature.utils'\nimport { column_getCanSort, column_getSortFn } from './rowSortingFeature.utils'\nimport type { Column_Internal } from '../../types/Column'\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 { SortFn, SortFns } from './rowSortingFeature.types'\nimport type { RowData } from '../../types/type-utils'\n\n/**\n * Creates a memoized sorted 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 createSortedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  sortFns: Record<keyof SortFns, SortFn<TFeatures, TData>>,\n): (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData> {\n  return (_table) => {\n    const table: Table_Internal<TFeatures, TData> = _table\n    if (!table._rowModelFns.sortFns) table._rowModelFns.sortFns = sortFns\n    return tableMemo({\n      feature: 'rowSortingFeature',\n      table,\n      fnName: 'table.getSortedRowModel',\n      memoDeps: () => [\n        table.atoms.sorting?.get(),\n        table.getPreSortedRowModel(),\n      ],\n      fn: () => _createSortedRowModel(table),\n      onAfterUpdate: () => table_autoResetPageIndex(table),\n    })\n  }\n}\n\nfunction _createSortedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  const preSortedRowModel = table.getPreSortedRowModel()\n  const sorting = table.atoms.sorting?.get()\n\n  if (!preSortedRowModel.rows.length || !sorting?.length) {\n    return preSortedRowModel\n  }\n\n  const sortedFlatRows: Array<Row<TFeatures, TData>> = []\n\n  // Filter out sortings that correspond to non existing columns\n  const availableSorting = sorting.filter((sort) =>\n    column_getCanSort(\n      table.getColumn(sort.id) as Column_Internal<TFeatures, TData>,\n    ),\n  )\n\n  const columnInfoById: Record<\n    string,\n    {\n      sortUndefined?: false | -1 | 1 | 'first' | 'last'\n      invertSorting?: boolean\n      sortFn: SortFn<TFeatures, TData>\n    }\n  > = {}\n\n  availableSorting.forEach((sortEntry) => {\n    const column: Column_Internal<TFeatures, TData> | undefined =\n      table.getColumn(sortEntry.id)\n    if (!column) return\n\n    columnInfoById[sortEntry.id] = {\n      sortUndefined: column.columnDef.sortUndefined,\n      invertSorting: column.columnDef.invertSorting,\n      sortFn: column_getSortFn(column),\n    }\n  })\n\n  const sortData = (rows: Array<Row<TFeatures, TData>>) => {\n    const sortedData = rows.slice()\n\n    sortedData.sort((rowA, rowB) => {\n      for (let i = 0; i < availableSorting.length; i++) {\n        const sortEntry = availableSorting[i]!\n        const columnInfo = columnInfoById[sortEntry.id]!\n        const sortUndefined = columnInfo.sortUndefined\n        const isDesc = sortEntry.desc\n\n        let sortInt = 0\n\n        // All sorting ints should always return in ascending order\n        if (sortUndefined) {\n          const aValue = rowA.getValue(sortEntry.id)\n          const bValue = rowB.getValue(sortEntry.id)\n\n          const aUndefined = aValue === undefined\n          const bUndefined = bValue === undefined\n\n          if (aUndefined || bUndefined) {\n            if (sortUndefined === 'first') return aUndefined ? -1 : 1\n            if (sortUndefined === 'last') return aUndefined ? 1 : -1\n            sortInt =\n              aUndefined && bUndefined\n                ? 0\n                : aUndefined\n                  ? sortUndefined\n                  : -sortUndefined\n          }\n        }\n\n        if (sortInt === 0) {\n          sortInt = columnInfo.sortFn(rowA, rowB, sortEntry.id)\n        }\n\n        // If sorting is non-zero, take care of desc and inversion\n        if (sortInt !== 0) {\n          if (isDesc) {\n            sortInt *= -1\n          }\n\n          if (columnInfo.invertSorting) {\n            sortInt *= -1\n          }\n\n          return sortInt\n        }\n      }\n      return rowA.index - rowB.index\n    })\n\n    // If there are sub-rows, sort them. Clone only rows that need mutation\n    // (i.e. have subRows) so we don't corrupt the source row model.\n    for (let i = 0; i < sortedData.length; i++) {\n      const row = sortedData[i]!\n      if (row.subRows.length) {\n        // Preserve prototype chain so methods like getValue() remain accessible\n        const cloned = Object.create(Object.getPrototypeOf(row))\n        Object.assign(cloned, row)\n        cloned.subRows = sortData(row.subRows)\n        sortedData[i] = cloned\n        sortedFlatRows.push(cloned)\n      } else {\n        sortedFlatRows.push(row)\n      }\n    }\n\n    return sortedData\n  }\n\n  return {\n    rows: sortData(preSortedRowModel.rows),\n    flatRows: sortedFlatRows,\n    rowsById: preSortedRowModel.rowsById,\n  }\n}\n"],"mappings":";;;;;;;;;;AAgBA,SAAgB,qBAId,SACsE;CACtE,QAAQ,WAAW;EACjB,MAAM,QAA0C;EAChD,IAAI,CAAC,MAAM,aAAa,SAAS,MAAM,aAAa,UAAU;EAC9D,OAAOA,wBAAU;GACf,SAAS;GACT;GACA,QAAQ;GACR,gBAAgB;;oCACd,MAAM,MAAM,qFAAS,KAAK,EAC1B,MAAM,sBAAsB,CAC7B;;GACD,UAAU,sBAAsB,MAAM;GACtC,qBAAqBC,4DAAyB,MAAM;GACrD,CAAC;;;AAIN,SAAS,sBAGP,OAAqE;;CACrE,MAAM,oBAAoB,MAAM,sBAAsB;CACtD,MAAM,mCAAU,MAAM,MAAM,uFAAS,KAAK;CAE1C,IAAI,CAAC,kBAAkB,KAAK,UAAU,oDAAC,QAAS,SAC9C,OAAO;CAGT,MAAM,iBAA+C,EAAE;CAGvD,MAAM,mBAAmB,QAAQ,QAAQ,SACvCC,kDACE,MAAM,UAAU,KAAK,GAAG,CACzB,CACF;CAED,MAAM,iBAOF,EAAE;CAEN,iBAAiB,SAAS,cAAc;EACtC,MAAM,SACJ,MAAM,UAAU,UAAU,GAAG;EAC/B,IAAI,CAAC,QAAQ;EAEb,eAAe,UAAU,MAAM;GAC7B,eAAe,OAAO,UAAU;GAChC,eAAe,OAAO,UAAU;GAChC,QAAQC,iDAAiB,OAAO;GACjC;GACD;CAEF,MAAM,YAAY,SAAuC;EACvD,MAAM,aAAa,KAAK,OAAO;EAE/B,WAAW,MAAM,MAAM,SAAS;GAC9B,KAAK,IAAI,IAAI,GAAG,IAAI,iBAAiB,QAAQ,KAAK;IAChD,MAAM,YAAY,iBAAiB;IACnC,MAAM,aAAa,eAAe,UAAU;IAC5C,MAAM,gBAAgB,WAAW;IACjC,MAAM,SAAS,UAAU;IAEzB,IAAI,UAAU;IAGd,IAAI,eAAe;KACjB,MAAM,SAAS,KAAK,SAAS,UAAU,GAAG;KAC1C,MAAM,SAAS,KAAK,SAAS,UAAU,GAAG;KAE1C,MAAM,aAAa,WAAW;KAC9B,MAAM,aAAa,WAAW;KAE9B,IAAI,cAAc,YAAY;MAC5B,IAAI,kBAAkB,SAAS,OAAO,aAAa,KAAK;MACxD,IAAI,kBAAkB,QAAQ,OAAO,aAAa,IAAI;MACtD,UACE,cAAc,aACV,IACA,aACE,gBACA,CAAC;;;IAIb,IAAI,YAAY,GACd,UAAU,WAAW,OAAO,MAAM,MAAM,UAAU,GAAG;IAIvD,IAAI,YAAY,GAAG;KACjB,IAAI,QACF,WAAW;KAGb,IAAI,WAAW,eACb,WAAW;KAGb,OAAO;;;GAGX,OAAO,KAAK,QAAQ,KAAK;IACzB;EAIF,KAAK,IAAI,IAAI,GAAG,IAAI,WAAW,QAAQ,KAAK;GAC1C,MAAM,MAAM,WAAW;GACvB,IAAI,IAAI,QAAQ,QAAQ;IAEtB,MAAM,SAAS,OAAO,OAAO,OAAO,eAAe,IAAI,CAAC;IACxD,OAAO,OAAO,QAAQ,IAAI;IAC1B,OAAO,UAAU,SAAS,IAAI,QAAQ;IACtC,WAAW,KAAK;IAChB,eAAe,KAAK,OAAO;UAE3B,eAAe,KAAK,IAAI;;EAI5B,OAAO;;CAGT,OAAO;EACL,MAAM,SAAS,kBAAkB,KAAK;EACtC,UAAU;EACV,UAAU,kBAAkB;EAC7B"}

package/dist/features/row-sorting/createSortedRowModel.d.cts

@@ -5,6 +5,11 @@ import { Table } from "../../types/Table.cjs";
 import { RowModel } from "../../core/row-models/coreRowModelsFeature.types.cjs";
 
 //#region src/features/row-sorting/createSortedRowModel.d.ts
+/**
+ * Creates a memoized sorted 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 createSortedRowModel<TFeatures extends TableFeatures, TData extends RowData>(sortFns: Record<keyof SortFns, SortFn<TFeatures, TData>>): (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData>;
 //#endregion
 export { createSortedRowModel };

package/dist/features/row-sorting/createSortedRowModel.d.ts

@@ -5,6 +5,11 @@ import { Table } from "../../types/Table.js";
 import { RowModel } from "../../core/row-models/coreRowModelsFeature.types.js";
 
 //#region src/features/row-sorting/createSortedRowModel.d.ts
+/**
+ * Creates a memoized sorted 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 createSortedRowModel<TFeatures extends TableFeatures, TData extends RowData>(sortFns: Record<keyof SortFns, SortFn<TFeatures, TData>>): (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData>;
 //#endregion
 export { createSortedRowModel };