@tanstack/table-core 9.0.0-alpha.8 → 9.0.0-beta.1

package/dist/features/row-pinning/rowPinningFeature.utils.js

@@ -0,0 +1,219 @@
+import { callMemoOrStaticFn, cloneState } from "../../utils.js";
+import { row_getIsAllParentsExpanded } from "../row-expanding/rowExpandingFeature.utils.js";
+
+//#region src/features/row-pinning/rowPinningFeature.utils.ts
+/**
+* Creates the default row pinning state.
+*
+* Both pinning regions start empty. Reset APIs use this value when
+* `defaultState` is `true`.
+*
+* @example
+* ```ts
+* const pinning = getDefaultRowPinningState()
+* ```
+*/
+function getDefaultRowPinningState() {
+	return {
+		top: [],
+		bottom: []
+	};
+}
+/**
+* Routes a row pinning updater through the table's row-pinning change handler.
+*
+* The updater may be a next `{ top, bottom }` state or a function of the
+* previous state, matching the instance `table.setRowPinning` behavior.
+*
+* @example
+* ```ts
+* table_setRowPinning(table, (old) => ({ ...old, top: [rowId] }))
+* ```
+*/
+function table_setRowPinning(table, updater) {
+	var _table$options$onRowP, _table$options;
+	(_table$options$onRowP = (_table$options = table.options).onRowPinningChange) === null || _table$options$onRowP === void 0 || _table$options$onRowP.call(_table$options, updater);
+}
+/**
+* Resets `rowPinning` to the configured initial state or feature default.
+*
+* With no argument, the reset clones `table.initialState.rowPinning` when it
+* exists. Passing `true` ignores initial state and resets to empty top/bottom
+* arrays.
+*
+* @example
+* ```ts
+* table_resetRowPinning(table)
+* table_resetRowPinning(table, true)
+* ```
+*/
+function table_resetRowPinning(table, defaultState) {
+	table_setRowPinning(table, defaultState ? getDefaultRowPinningState() : cloneState(table.initialState.rowPinning ?? getDefaultRowPinningState()));
+}
+/**
+* Checks whether any rows are pinned.
+*
+* Omit `position` to check both regions, or pass `'top'`/`'bottom'` to inspect
+* one region.
+*
+* @example
+* ```ts
+* const hasPinnedRows = table_getIsSomeRowsPinned(table)
+* ```
+*/
+function table_getIsSomeRowsPinned(table, position) {
+	var _table$atoms$rowPinni;
+	const rowPinning = (_table$atoms$rowPinni = table.atoms.rowPinning) === null || _table$atoms$rowPinni === void 0 ? void 0 : _table$atoms$rowPinni.get();
+	if (!position) return Boolean((rowPinning === null || rowPinning === void 0 ? void 0 : rowPinning.top.length) || (rowPinning === null || rowPinning === void 0 ? void 0 : rowPinning.bottom.length));
+	return Boolean(rowPinning === null || rowPinning === void 0 ? void 0 : rowPinning[position].length);
+}
+function table_getPinnedRows(table, position) {
+	var _table$atoms$rowPinni2;
+	const visibleRows = table.getRowModel().rows;
+	const pinnedRowIds = ((_table$atoms$rowPinni2 = table.atoms.rowPinning) === null || _table$atoms$rowPinni2 === void 0 || (_table$atoms$rowPinni2 = _table$atoms$rowPinni2.get()) === null || _table$atoms$rowPinni2 === void 0 ? void 0 : _table$atoms$rowPinni2[position]) ?? [];
+	const keepPinnedRows = table.options.keepPinnedRows ?? true;
+	const result = [];
+	for (let i = 0; i < pinnedRowIds.length; i++) {
+		const rowId = pinnedRowIds[i];
+		let row;
+		if (keepPinnedRows) {
+			const fullRow = table.getRow(rowId, true);
+			if (row_getIsAllParentsExpanded(fullRow)) row = fullRow;
+		} else row = visibleRows.find((r) => r.id === rowId);
+		if (!row) continue;
+		row.position = position;
+		result.push(row);
+	}
+	return result;
+}
+/**
+* Resolves the visible rows pinned to the top region.
+*
+* The result follows `state.rowPinning.top` order and marks each row with
+* `position = 'top'`.
+*
+* @example
+* ```ts
+* const rows = table_getTopRows(table)
+* ```
+*/
+function table_getTopRows(table) {
+	return table_getPinnedRows(table, "top");
+}
+/**
+* Resolves the visible rows pinned to the bottom region.
+*
+* The result follows `state.rowPinning.bottom` order and marks each row with
+* `position = 'bottom'`.
+*
+* @example
+* ```ts
+* const rows = table_getBottomRows(table)
+* ```
+*/
+function table_getBottomRows(table) {
+	return table_getPinnedRows(table, "bottom");
+}
+/**
+* Resolves rows that are not pinned to top or bottom.
+*
+* The current row model is filtered by `state.rowPinning.top` and
+* `state.rowPinning.bottom`.
+*
+* @example
+* ```ts
+* const rows = table_getCenterRows(table)
+* ```
+*/
+function table_getCenterRows(table) {
+	var _table$atoms$rowPinni3;
+	const { top, bottom } = ((_table$atoms$rowPinni3 = table.atoms.rowPinning) === null || _table$atoms$rowPinni3 === void 0 ? void 0 : _table$atoms$rowPinni3.get()) ?? getDefaultRowPinningState();
+	const allRows = table.getRowModel().rows;
+	const topAndBottom = new Set([...top, ...bottom]);
+	return allRows.filter((d) => !topAndBottom.has(d.id));
+}
+/**
+* Checks whether this row can be pinned.
+*
+* `options.enableRowPinning` may be a boolean or a row predicate; it defaults
+* to `true`.
+*
+* @example
+* ```ts
+* const canPin = row_getCanPin(row)
+* ```
+*/
+function row_getCanPin(row) {
+	const { enableRowPinning } = row.table.options;
+	if (typeof enableRowPinning === "function") return enableRowPinning(row);
+	return enableRowPinning ?? true;
+}
+/**
+* Reads this row's current pinning region.
+*
+* Rows listed in `state.rowPinning.top` return `'top'`, rows listed in
+* `bottom` return `'bottom'`, and unpinned rows return `false`.
+*
+* @example
+* ```ts
+* const position = row_getIsPinned(row)
+* ```
+*/
+function row_getIsPinned(row) {
+	var _row$table$atoms$rowP;
+	const { top, bottom } = ((_row$table$atoms$rowP = row.table.atoms.rowPinning) === null || _row$table$atoms$rowP === void 0 ? void 0 : _row$table$atoms$rowP.get()) ?? getDefaultRowPinningState();
+	return top.includes(row.id) ? "top" : bottom.includes(row.id) ? "bottom" : false;
+}
+/**
+* Finds this row's visible index within its pinned region.
+*
+* Unpinned rows return `-1`.
+*
+* @example
+* ```ts
+* const index = row_getPinnedIndex(row)
+* ```
+*/
+function row_getPinnedIndex(row) {
+	const position = row_getIsPinned(row);
+	if (!position) return -1;
+	return (position === "top" ? callMemoOrStaticFn(row.table, "getTopRows", table_getTopRows) : callMemoOrStaticFn(row.table, "getBottomRows", table_getBottomRows)).map(({ id }) => id).indexOf(row.id);
+}
+/**
+* Pins or unpins a row.
+*
+* Optional flags let callers include parent rows or leaf rows when updating
+* the row pinning state.
+*
+* @example
+* ```ts
+* row_pin(row, 'top')
+* ```
+*/
+function row_pin(row, position, includeLeafRows, includeParentRows) {
+	const leafRowIds = includeLeafRows ? row.getLeafRows().map(({ id }) => id) : [];
+	const parentRowIds = includeParentRows ? row.getParentRows().map(({ id }) => id) : [];
+	const rowIds = new Set([
+		...parentRowIds,
+		row.id,
+		...leafRowIds
+	]);
+	table_setRowPinning(row.table, (old) => {
+		if (position === "bottom") return {
+			top: old.top.filter((d) => !rowIds.has(d)),
+			bottom: [...old.bottom.filter((d) => !rowIds.has(d)), ...Array.from(rowIds)]
+		};
+		if (position === "top") return {
+			top: [...old.top.filter((d) => !rowIds.has(d)), ...Array.from(rowIds)],
+			bottom: old.bottom.filter((d) => !rowIds.has(d))
+		};
+		return {
+			top: old.top.filter((d) => !rowIds.has(d)),
+			bottom: old.bottom.filter((d) => !rowIds.has(d))
+		};
+	});
+}
+
+//#endregion
+export { getDefaultRowPinningState, row_getCanPin, row_getIsPinned, row_getPinnedIndex, row_pin, table_getBottomRows, table_getCenterRows, table_getIsSomeRowsPinned, table_getTopRows, table_resetRowPinning, table_setRowPinning };
+//# sourceMappingURL=rowPinningFeature.utils.js.map

package/dist/features/row-pinning/rowPinningFeature.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rowPinningFeature.utils.js","names":[],"sources":["../../../src/features/row-pinning/rowPinningFeature.utils.ts"],"sourcesContent":["import { row_getIsAllParentsExpanded } from '../row-expanding/rowExpandingFeature.utils'\nimport { callMemoOrStaticFn, cloneState } from '../../utils'\nimport type { RowData, Updater } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Table_Internal } from '../../types/Table'\nimport type { Row } from '../../types/Row'\nimport type {\n  RowPinningPosition,\n  RowPinningState,\n} from './rowPinningFeature.types'\n\n// State Utils\n\n/**\n * Creates the default row pinning state.\n *\n * Both pinning regions start empty. Reset APIs use this value when\n * `defaultState` is `true`.\n *\n * @example\n * ```ts\n * const pinning = getDefaultRowPinningState()\n * ```\n */\nexport function getDefaultRowPinningState(): RowPinningState {\n  return {\n    top: [],\n    bottom: [],\n  }\n}\n\n/**\n * Routes a row pinning updater through the table's row-pinning change handler.\n *\n * The updater may be a next `{ top, bottom }` state or a function of the\n * previous state, matching the instance `table.setRowPinning` behavior.\n *\n * @example\n * ```ts\n * table_setRowPinning(table, (old) => ({ ...old, top: [rowId] }))\n * ```\n */\nexport function table_setRowPinning<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  updater: Updater<RowPinningState>,\n): void {\n  table.options.onRowPinningChange?.(updater)\n}\n\n/**\n * Resets `rowPinning` to the configured initial state or feature default.\n *\n * With no argument, the reset clones `table.initialState.rowPinning` when it\n * exists. Passing `true` ignores initial state and resets to empty top/bottom\n * arrays.\n *\n * @example\n * ```ts\n * table_resetRowPinning(table)\n * table_resetRowPinning(table, true)\n * ```\n */\nexport function table_resetRowPinning<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean): void {\n  table_setRowPinning(\n    table,\n    defaultState\n      ? getDefaultRowPinningState()\n      : cloneState(\n          table.initialState.rowPinning ?? getDefaultRowPinningState(),\n        ),\n  )\n}\n\n// Table Utils\n\n/**\n * Checks whether any rows are pinned.\n *\n * Omit `position` to check both regions, or pass `'top'`/`'bottom'` to inspect\n * one region.\n *\n * @example\n * ```ts\n * const hasPinnedRows = table_getIsSomeRowsPinned(table)\n * ```\n */\nexport function table_getIsSomeRowsPinned<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  position?: RowPinningPosition,\n): boolean {\n  const rowPinning = table.atoms.rowPinning?.get()\n\n  if (!position) {\n    return Boolean(rowPinning?.top.length || rowPinning?.bottom.length)\n  }\n  return Boolean(rowPinning?.[position].length)\n}\n\nfunction table_getPinnedRows<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  position: 'top' | 'bottom',\n): Array<Row<TFeatures, TData>> {\n  const visibleRows = table.getRowModel().rows\n  const pinnedRowIds = table.atoms.rowPinning?.get()?.[position] ?? []\n  const keepPinnedRows = table.options.keepPinnedRows ?? true\n\n  const result: Array<Row<TFeatures, TData>> = []\n  for (let i = 0; i < pinnedRowIds.length; i++) {\n    const rowId = pinnedRowIds[i]!\n    let row: Row<TFeatures, TData> | undefined\n    if (keepPinnedRows) {\n      // get all rows that are pinned even if they would not be otherwise\n      // visible; account for expanded parent rows, but not pagination/filtering\n      const fullRow = table.getRow(rowId, true)\n      if (row_getIsAllParentsExpanded(fullRow)) row = fullRow\n    } else {\n      // else get only visible rows that are pinned\n      row = visibleRows.find((r) => r.id === rowId)\n    }\n    if (!row)\n      continue\n      // Assign position property directly to preserve prototype chain\n    ;(row as any).position = position\n    result.push(row)\n  }\n  return result\n}\n\n/**\n * Resolves the visible rows pinned to the top region.\n *\n * The result follows `state.rowPinning.top` order and marks each row with\n * `position = 'top'`.\n *\n * @example\n * ```ts\n * const rows = table_getTopRows(table)\n * ```\n */\nexport function table_getTopRows<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): Array<Row<TFeatures, TData>> {\n  return table_getPinnedRows(table, 'top')\n}\n\n/**\n * Resolves the visible rows pinned to the bottom region.\n *\n * The result follows `state.rowPinning.bottom` order and marks each row with\n * `position = 'bottom'`.\n *\n * @example\n * ```ts\n * const rows = table_getBottomRows(table)\n * ```\n */\nexport function table_getBottomRows<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): Array<Row<TFeatures, TData>> {\n  return table_getPinnedRows(table, 'bottom')\n}\n\n/**\n * Resolves rows that are not pinned to top or bottom.\n *\n * The current row model is filtered by `state.rowPinning.top` and\n * `state.rowPinning.bottom`.\n *\n * @example\n * ```ts\n * const rows = table_getCenterRows(table)\n * ```\n */\nexport function table_getCenterRows<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): Array<Row<TFeatures, TData>> {\n  const { top, bottom } =\n    table.atoms.rowPinning?.get() ?? getDefaultRowPinningState()\n  const allRows = table.getRowModel().rows\n\n  const topAndBottom = new Set([...top, ...bottom])\n  return allRows.filter((d) => !topAndBottom.has(d.id))\n}\n\n// Row Utils\n\n/**\n * Checks whether this row can be pinned.\n *\n * `options.enableRowPinning` may be a boolean or a row predicate; it defaults\n * to `true`.\n *\n * @example\n * ```ts\n * const canPin = row_getCanPin(row)\n * ```\n */\nexport function row_getCanPin<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>): boolean {\n  const { enableRowPinning } = row.table.options\n  if (typeof enableRowPinning === 'function') {\n    return enableRowPinning(row)\n  }\n  return enableRowPinning ?? true\n}\n\n/**\n * Reads this row's current pinning region.\n *\n * Rows listed in `state.rowPinning.top` return `'top'`, rows listed in\n * `bottom` return `'bottom'`, and unpinned rows return `false`.\n *\n * @example\n * ```ts\n * const position = row_getIsPinned(row)\n * ```\n */\nexport function row_getIsPinned<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>): RowPinningPosition {\n  const { top, bottom } =\n    row.table.atoms.rowPinning?.get() ?? getDefaultRowPinningState()\n\n  return top.includes(row.id)\n    ? 'top'\n    : bottom.includes(row.id)\n      ? 'bottom'\n      : false\n}\n\n/**\n * Finds this row's visible index within its pinned region.\n *\n * Unpinned rows return `-1`.\n *\n * @example\n * ```ts\n * const index = row_getPinnedIndex(row)\n * ```\n */\nexport function row_getPinnedIndex<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>): number {\n  const position = row_getIsPinned(row)\n  if (!position) return -1\n\n  const visiblePinnedRowIds = (\n    position === 'top'\n      ? callMemoOrStaticFn(row.table, 'getTopRows', table_getTopRows)\n      : callMemoOrStaticFn(row.table, 'getBottomRows', table_getBottomRows)\n  ).map(({ id }) => id)\n\n  return visiblePinnedRowIds.indexOf(row.id)\n}\n\n/**\n * Pins or unpins a row.\n *\n * Optional flags let callers include parent rows or leaf rows when updating\n * the row pinning state.\n *\n * @example\n * ```ts\n * row_pin(row, 'top')\n * ```\n */\nexport function row_pin<TFeatures extends TableFeatures, TData extends RowData>(\n  row: Row<TFeatures, TData>,\n  position: RowPinningPosition,\n  includeLeafRows?: boolean,\n  includeParentRows?: boolean,\n): void {\n  const leafRowIds = includeLeafRows\n    ? row.getLeafRows().map(({ id }) => id)\n    : []\n  const parentRowIds = includeParentRows\n    ? row.getParentRows().map(({ id }) => id)\n    : []\n  const rowIds: Set<string> = new Set([...parentRowIds, row.id, ...leafRowIds])\n\n  table_setRowPinning(row.table, (old) => {\n    if (position === 'bottom') {\n      return {\n        top: old.top.filter((d) => !rowIds.has(d)),\n        bottom: [\n          ...old.bottom.filter((d) => !rowIds.has(d)),\n          ...Array.from(rowIds),\n        ],\n      }\n    }\n\n    if (position === 'top') {\n      return {\n        top: [...old.top.filter((d) => !rowIds.has(d)), ...Array.from(rowIds)],\n        bottom: old.bottom.filter((d) => !rowIds.has(d)),\n      }\n    }\n\n    return {\n      top: old.top.filter((d) => !rowIds.has(d)),\n      bottom: old.bottom.filter((d) => !rowIds.has(d)),\n    }\n  })\n}\n"],"mappings":"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"}

package/dist/features/row-selection/rowSelectionFeature.cjs

@@ -0,0 +1,87 @@
+const require_utils = require('../../utils.cjs');
+const require_rowSelectionFeature_utils = require('./rowSelectionFeature.utils.cjs');
+
+//#region src/features/row-selection/rowSelectionFeature.ts
+/**
+* Creates the stock row selection feature.
+*
+* The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+*/
+function constructRowSelectionFeature() {
+	return {
+		getInitialState: (initialState) => {
+			return {
+				rowSelection: require_rowSelectionFeature_utils.getDefaultRowSelectionState(),
+				...initialState
+			};
+		},
+		getDefaultTableOptions: (table) => {
+			return {
+				onRowSelectionChange: require_utils.makeStateUpdater("rowSelection", table),
+				enableRowSelection: true,
+				enableMultiRowSelection: true,
+				enableSubRowSelection: true
+			};
+		},
+		assignRowPrototype: (prototype, table) => {
+			require_utils.assignPrototypeAPIs("rowSelectionFeature", prototype, table, {
+				row_toggleSelected: { fn: (row, value, opts) => require_rowSelectionFeature_utils.row_toggleSelected(row, value, opts) },
+				row_getIsSelected: { fn: (row) => require_rowSelectionFeature_utils.row_getIsSelected(row) },
+				row_getIsSomeSelected: { fn: (row) => require_rowSelectionFeature_utils.row_getIsSomeSelected(row) },
+				row_getIsAllSubRowsSelected: { fn: (row) => require_rowSelectionFeature_utils.row_getIsAllSubRowsSelected(row) },
+				row_getCanSelect: { fn: (row) => require_rowSelectionFeature_utils.row_getCanSelect(row) },
+				row_getCanSelectSubRows: { fn: (row) => require_rowSelectionFeature_utils.row_getCanSelectSubRows(row) },
+				row_getCanMultiSelect: { fn: (row) => require_rowSelectionFeature_utils.row_getCanMultiSelect(row) },
+				row_getToggleSelectedHandler: { fn: (row) => require_rowSelectionFeature_utils.row_getToggleSelectedHandler(row) }
+			});
+		},
+		constructTableAPIs: (table) => {
+			require_utils.assignTableAPIs("rowSelectionFeature", table, {
+				table_setRowSelection: { fn: (updater) => require_rowSelectionFeature_utils.table_setRowSelection(table, updater) },
+				table_resetRowSelection: { fn: (defaultState) => require_rowSelectionFeature_utils.table_resetRowSelection(table, defaultState) },
+				table_toggleAllRowsSelected: { fn: (value) => require_rowSelectionFeature_utils.table_toggleAllRowsSelected(table, value) },
+				table_toggleAllPageRowsSelected: { fn: (value) => require_rowSelectionFeature_utils.table_toggleAllPageRowsSelected(table, value) },
+				table_getPreSelectedRowModel: { fn: () => require_rowSelectionFeature_utils.table_getPreSelectedRowModel(table) },
+				table_getSelectedRowModel: {
+					fn: () => require_rowSelectionFeature_utils.table_getSelectedRowModel(table),
+					memoDeps: () => {
+						var _table$atoms$rowSelec;
+						return [(_table$atoms$rowSelec = table.atoms.rowSelection) === null || _table$atoms$rowSelec === void 0 ? void 0 : _table$atoms$rowSelec.get(), table.getCoreRowModel()];
+					}
+				},
+				table_getFilteredSelectedRowModel: {
+					fn: () => require_rowSelectionFeature_utils.table_getFilteredSelectedRowModel(table),
+					memoDeps: () => {
+						var _table$atoms$rowSelec2;
+						return [(_table$atoms$rowSelec2 = table.atoms.rowSelection) === null || _table$atoms$rowSelec2 === void 0 ? void 0 : _table$atoms$rowSelec2.get(), table.getFilteredRowModel()];
+					}
+				},
+				table_getGroupedSelectedRowModel: {
+					fn: () => require_rowSelectionFeature_utils.table_getGroupedSelectedRowModel(table),
+					memoDeps: () => {
+						var _table$atoms$rowSelec3;
+						return [(_table$atoms$rowSelec3 = table.atoms.rowSelection) === null || _table$atoms$rowSelec3 === void 0 ? void 0 : _table$atoms$rowSelec3.get(), table.getSortedRowModel()];
+					}
+				},
+				table_getIsAllRowsSelected: { fn: () => require_rowSelectionFeature_utils.table_getIsAllRowsSelected(table) },
+				table_getIsAllPageRowsSelected: { fn: () => require_rowSelectionFeature_utils.table_getIsAllPageRowsSelected(table) },
+				table_getIsSomeRowsSelected: { fn: () => require_rowSelectionFeature_utils.table_getIsSomeRowsSelected(table) },
+				table_getIsSomePageRowsSelected: { fn: () => require_rowSelectionFeature_utils.table_getIsSomePageRowsSelected(table) },
+				table_getToggleAllRowsSelectedHandler: { fn: () => require_rowSelectionFeature_utils.table_getToggleAllRowsSelectedHandler(table) },
+				table_getToggleAllPageRowsSelectedHandler: { fn: () => require_rowSelectionFeature_utils.table_getToggleAllPageRowsSelectedHandler(table) }
+			});
+		}
+	};
+}
+/**
+* The stock row selection feature.
+*
+* Register this feature to add row selection state, selected row-model helpers,
+* and table/row APIs for checkbox and bulk-selection UI.
+*/
+const rowSelectionFeature = constructRowSelectionFeature();
+
+//#endregion
+exports.constructRowSelectionFeature = constructRowSelectionFeature;
+exports.rowSelectionFeature = rowSelectionFeature;
+//# sourceMappingURL=rowSelectionFeature.cjs.map

package/dist/features/row-selection/rowSelectionFeature.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"rowSelectionFeature.cjs","names":["getDefaultRowSelectionState","makeStateUpdater","row_toggleSelected","row_getIsSelected","row_getIsSomeSelected","row_getIsAllSubRowsSelected","row_getCanSelect","row_getCanSelectSubRows","row_getCanMultiSelect","row_getToggleSelectedHandler","table_setRowSelection","table_resetRowSelection","table_toggleAllRowsSelected","table_toggleAllPageRowsSelected","table_getPreSelectedRowModel","table_getSelectedRowModel","table_getFilteredSelectedRowModel","table_getGroupedSelectedRowModel","table_getIsAllRowsSelected","table_getIsAllPageRowsSelected","table_getIsSomeRowsSelected","table_getIsSomePageRowsSelected","table_getToggleAllRowsSelectedHandler","table_getToggleAllPageRowsSelectedHandler"],"sources":["../../../src/features/row-selection/rowSelectionFeature.ts"],"sourcesContent":["import {\n  assignPrototypeAPIs,\n  assignTableAPIs,\n  makeStateUpdater,\n} from '../../utils'\nimport {\n  getDefaultRowSelectionState,\n  row_getCanMultiSelect,\n  row_getCanSelect,\n  row_getCanSelectSubRows,\n  row_getIsAllSubRowsSelected,\n  row_getIsSelected,\n  row_getIsSomeSelected,\n  row_getToggleSelectedHandler,\n  row_toggleSelected,\n  table_getFilteredSelectedRowModel,\n  table_getGroupedSelectedRowModel,\n  table_getIsAllPageRowsSelected,\n  table_getIsAllRowsSelected,\n  table_getIsSomePageRowsSelected,\n  table_getIsSomeRowsSelected,\n  table_getPreSelectedRowModel,\n  table_getSelectedRowModel,\n  table_getToggleAllPageRowsSelectedHandler,\n  table_getToggleAllRowsSelectedHandler,\n  table_resetRowSelection,\n  table_setRowSelection,\n  table_toggleAllPageRowsSelected,\n  table_toggleAllRowsSelected,\n} from './rowSelectionFeature.utils'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\n// import type {\n//   Row_RowSelection,\n//   TableOptions_RowSelection,\n//   TableState_RowSelection,\n//   Table_RowSelection,\n// } from './rowSelectionFeature.types'\n\nexport interface RowSelectionFeatureConstructors<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  // Row: Row_RowSelection\n  // Table: Table_RowSelection<TFeatures, TData>\n  // TableOptions: TableOptions_RowSelection<TFeatures, TData>\n  // TableState: TableState_RowSelection\n}\n\n/**\n * Creates the stock row selection 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 constructRowSelectionFeature<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): TableFeature<RowSelectionFeatureConstructors<TFeatures, TData>> {\n  return {\n    getInitialState: (initialState) => {\n      return {\n        rowSelection: getDefaultRowSelectionState(),\n        ...initialState,\n      }\n    },\n\n    getDefaultTableOptions: (table) => {\n      return {\n        onRowSelectionChange: makeStateUpdater('rowSelection', table),\n        enableRowSelection: true,\n        enableMultiRowSelection: true,\n        enableSubRowSelection: true,\n      }\n    },\n\n    assignRowPrototype: (prototype, table) => {\n      assignPrototypeAPIs('rowSelectionFeature', prototype, table, {\n        row_toggleSelected: {\n          fn: (row, value, opts) => row_toggleSelected(row, value, opts),\n        },\n        row_getIsSelected: {\n          fn: (row) => row_getIsSelected(row),\n        },\n        row_getIsSomeSelected: {\n          fn: (row) => row_getIsSomeSelected(row),\n        },\n        row_getIsAllSubRowsSelected: {\n          fn: (row) => row_getIsAllSubRowsSelected(row),\n        },\n        row_getCanSelect: {\n          fn: (row) => row_getCanSelect(row),\n        },\n        row_getCanSelectSubRows: {\n          fn: (row) => row_getCanSelectSubRows(row),\n        },\n        row_getCanMultiSelect: {\n          fn: (row) => row_getCanMultiSelect(row),\n        },\n        row_getToggleSelectedHandler: {\n          fn: (row) => row_getToggleSelectedHandler(row),\n        },\n      })\n    },\n\n    constructTableAPIs: (table) => {\n      assignTableAPIs('rowSelectionFeature', table, {\n        table_setRowSelection: {\n          fn: (updater) => table_setRowSelection(table, updater),\n        },\n        table_resetRowSelection: {\n          fn: (defaultState) => table_resetRowSelection(table, defaultState),\n        },\n        table_toggleAllRowsSelected: {\n          fn: (value) => table_toggleAllRowsSelected(table, value),\n        },\n        table_toggleAllPageRowsSelected: {\n          fn: (value) => table_toggleAllPageRowsSelected(table, value),\n        },\n        table_getPreSelectedRowModel: {\n          fn: () => table_getPreSelectedRowModel(table),\n        },\n        table_getSelectedRowModel: {\n          fn: () => table_getSelectedRowModel(table),\n          memoDeps: () => [\n            table.atoms.rowSelection?.get(),\n            table.getCoreRowModel(),\n          ],\n        },\n        table_getFilteredSelectedRowModel: {\n          fn: () => table_getFilteredSelectedRowModel(table),\n          memoDeps: () => [\n            table.atoms.rowSelection?.get(),\n            table.getFilteredRowModel(),\n          ],\n        },\n        table_getGroupedSelectedRowModel: {\n          fn: () => table_getGroupedSelectedRowModel(table),\n          memoDeps: () => [\n            table.atoms.rowSelection?.get(),\n            table.getSortedRowModel(),\n          ],\n        },\n        table_getIsAllRowsSelected: {\n          fn: () => table_getIsAllRowsSelected(table),\n        },\n        table_getIsAllPageRowsSelected: {\n          fn: () => table_getIsAllPageRowsSelected(table),\n        },\n        table_getIsSomeRowsSelected: {\n          fn: () => table_getIsSomeRowsSelected(table),\n        },\n        table_getIsSomePageRowsSelected: {\n          fn: () => table_getIsSomePageRowsSelected(table),\n        },\n        table_getToggleAllRowsSelectedHandler: {\n          fn: () => table_getToggleAllRowsSelectedHandler(table),\n        },\n        table_getToggleAllPageRowsSelectedHandler: {\n          fn: () => table_getToggleAllPageRowsSelectedHandler(table),\n        },\n      })\n    },\n  }\n}\n\n/**\n * The stock row selection feature.\n *\n * Register this feature to add row selection state, selected row-model helpers,\n * and table/row APIs for checkbox and bulk-selection UI.\n */\nexport const rowSelectionFeature = constructRowSelectionFeature()\n"],"mappings":";;;;;;;;;AAsDA,SAAgB,+BAGqD;CACnE,OAAO;EACL,kBAAkB,iBAAiB;GACjC,OAAO;IACL,cAAcA,8DAA4B;IAC1C,GAAG;GACL;EACF;EAEA,yBAAyB,UAAU;GACjC,OAAO;IACL,sBAAsBC,+BAAiB,gBAAgB,KAAK;IAC5D,oBAAoB;IACpB,yBAAyB;IACzB,uBAAuB;GACzB;EACF;EAEA,qBAAqB,WAAW,UAAU;GACxC,kCAAoB,uBAAuB,WAAW,OAAO;IAC3D,oBAAoB,EAClB,KAAK,KAAK,OAAO,SAASC,qDAAmB,KAAK,OAAO,IAAI,EAC/D;IACA,mBAAmB,EACjB,KAAK,QAAQC,oDAAkB,GAAG,EACpC;IACA,uBAAuB,EACrB,KAAK,QAAQC,wDAAsB,GAAG,EACxC;IACA,6BAA6B,EAC3B,KAAK,QAAQC,8DAA4B,GAAG,EAC9C;IACA,kBAAkB,EAChB,KAAK,QAAQC,mDAAiB,GAAG,EACnC;IACA,yBAAyB,EACvB,KAAK,QAAQC,0DAAwB,GAAG,EAC1C;IACA,uBAAuB,EACrB,KAAK,QAAQC,wDAAsB,GAAG,EACxC;IACA,8BAA8B,EAC5B,KAAK,QAAQC,+DAA6B,GAAG,EAC/C;GACF,CAAC;EACH;EAEA,qBAAqB,UAAU;GAC7B,8BAAgB,uBAAuB,OAAO;IAC5C,uBAAuB,EACrB,KAAK,YAAYC,wDAAsB,OAAO,OAAO,EACvD;IACA,yBAAyB,EACvB,KAAK,iBAAiBC,0DAAwB,OAAO,YAAY,EACnE;IACA,6BAA6B,EAC3B,KAAK,UAAUC,8DAA4B,OAAO,KAAK,EACzD;IACA,iCAAiC,EAC/B,KAAK,UAAUC,kEAAgC,OAAO,KAAK,EAC7D;IACA,8BAA8B,EAC5B,UAAUC,+DAA6B,KAAK,EAC9C;IACA,2BAA2B;KACzB,UAAUC,4DAA0B,KAAK;KACzC,gBAAgB;;uCACd,MAAM,MAAM,4FAAc,IAAI,GAC9B,MAAM,gBAAgB,CACxB;;IACF;IACA,mCAAmC;KACjC,UAAUC,oEAAkC,KAAK;KACjD,gBAAgB;;wCACd,MAAM,MAAM,8FAAc,IAAI,GAC9B,MAAM,oBAAoB,CAC5B;;IACF;IACA,kCAAkC;KAChC,UAAUC,mEAAiC,KAAK;KAChD,gBAAgB;;wCACd,MAAM,MAAM,8FAAc,IAAI,GAC9B,MAAM,kBAAkB,CAC1B;;IACF;IACA,4BAA4B,EAC1B,UAAUC,6DAA2B,KAAK,EAC5C;IACA,gCAAgC,EAC9B,UAAUC,iEAA+B,KAAK,EAChD;IACA,6BAA6B,EAC3B,UAAUC,8DAA4B,KAAK,EAC7C;IACA,iCAAiC,EAC/B,UAAUC,kEAAgC,KAAK,EACjD;IACA,uCAAuC,EACrC,UAAUC,wEAAsC,KAAK,EACvD;IACA,2CAA2C,EACzC,UAAUC,4EAA0C,KAAK,EAC3D;GACF,CAAC;EACH;CACF;AACF;;;;;;;AAQA,MAAa,sBAAsB,6BAA6B"}

package/dist/features/row-selection/rowSelectionFeature.d.cts

@@ -0,0 +1,21 @@
+import { RowData } from "../../types/type-utils.cjs";
+import { TableFeature, TableFeatures } from "../../types/TableFeatures.cjs";
+
+//#region src/features/row-selection/rowSelectionFeature.d.ts
+interface RowSelectionFeatureConstructors<TFeatures extends TableFeatures, TData extends RowData> {}
+/**
+ * Creates the stock row selection feature.
+ *
+ * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+ */
+declare function constructRowSelectionFeature<TFeatures extends TableFeatures, TData extends RowData>(): TableFeature<RowSelectionFeatureConstructors<TFeatures, TData>>;
+/**
+ * The stock row selection feature.
+ *
+ * Register this feature to add row selection state, selected row-model helpers,
+ * and table/row APIs for checkbox and bulk-selection UI.
+ */
+declare const rowSelectionFeature: TableFeature<RowSelectionFeatureConstructors<TableFeatures, RowData>>;
+//#endregion
+export { RowSelectionFeatureConstructors, constructRowSelectionFeature, rowSelectionFeature };
+//# sourceMappingURL=rowSelectionFeature.d.cts.map

package/dist/features/row-selection/rowSelectionFeature.d.ts

@@ -0,0 +1,21 @@
+import { RowData } from "../../types/type-utils.js";
+import { TableFeature, TableFeatures } from "../../types/TableFeatures.js";
+
+//#region src/features/row-selection/rowSelectionFeature.d.ts
+interface RowSelectionFeatureConstructors<TFeatures extends TableFeatures, TData extends RowData> {}
+/**
+ * Creates the stock row selection feature.
+ *
+ * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+ */
+declare function constructRowSelectionFeature<TFeatures extends TableFeatures, TData extends RowData>(): TableFeature<RowSelectionFeatureConstructors<TFeatures, TData>>;
+/**
+ * The stock row selection feature.
+ *
+ * Register this feature to add row selection state, selected row-model helpers,
+ * and table/row APIs for checkbox and bulk-selection UI.
+ */
+declare const rowSelectionFeature: TableFeature<RowSelectionFeatureConstructors<TableFeatures, RowData>>;
+//#endregion
+export { RowSelectionFeatureConstructors, constructRowSelectionFeature, rowSelectionFeature };
+//# sourceMappingURL=rowSelectionFeature.d.ts.map

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

@@ -0,0 +1,86 @@
+import { assignPrototypeAPIs, assignTableAPIs, makeStateUpdater } from "../../utils.js";
+import { getDefaultRowSelectionState, row_getCanMultiSelect, row_getCanSelect, row_getCanSelectSubRows, row_getIsAllSubRowsSelected, row_getIsSelected, row_getIsSomeSelected, row_getToggleSelectedHandler, row_toggleSelected, table_getFilteredSelectedRowModel, table_getGroupedSelectedRowModel, table_getIsAllPageRowsSelected, table_getIsAllRowsSelected, table_getIsSomePageRowsSelected, table_getIsSomeRowsSelected, table_getPreSelectedRowModel, table_getSelectedRowModel, table_getToggleAllPageRowsSelectedHandler, table_getToggleAllRowsSelectedHandler, table_resetRowSelection, table_setRowSelection, table_toggleAllPageRowsSelected, table_toggleAllRowsSelected } from "./rowSelectionFeature.utils.js";
+
+//#region src/features/row-selection/rowSelectionFeature.ts
+/**
+* Creates the stock row selection feature.
+*
+* The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+*/
+function constructRowSelectionFeature() {
+	return {
+		getInitialState: (initialState) => {
+			return {
+				rowSelection: getDefaultRowSelectionState(),
+				...initialState
+			};
+		},
+		getDefaultTableOptions: (table) => {
+			return {
+				onRowSelectionChange: makeStateUpdater("rowSelection", table),
+				enableRowSelection: true,
+				enableMultiRowSelection: true,
+				enableSubRowSelection: true
+			};
+		},
+		assignRowPrototype: (prototype, table) => {
+			assignPrototypeAPIs("rowSelectionFeature", prototype, table, {
+				row_toggleSelected: { fn: (row, value, opts) => row_toggleSelected(row, value, opts) },
+				row_getIsSelected: { fn: (row) => row_getIsSelected(row) },
+				row_getIsSomeSelected: { fn: (row) => row_getIsSomeSelected(row) },
+				row_getIsAllSubRowsSelected: { fn: (row) => row_getIsAllSubRowsSelected(row) },
+				row_getCanSelect: { fn: (row) => row_getCanSelect(row) },
+				row_getCanSelectSubRows: { fn: (row) => row_getCanSelectSubRows(row) },
+				row_getCanMultiSelect: { fn: (row) => row_getCanMultiSelect(row) },
+				row_getToggleSelectedHandler: { fn: (row) => row_getToggleSelectedHandler(row) }
+			});
+		},
+		constructTableAPIs: (table) => {
+			assignTableAPIs("rowSelectionFeature", table, {
+				table_setRowSelection: { fn: (updater) => table_setRowSelection(table, updater) },
+				table_resetRowSelection: { fn: (defaultState) => table_resetRowSelection(table, defaultState) },
+				table_toggleAllRowsSelected: { fn: (value) => table_toggleAllRowsSelected(table, value) },
+				table_toggleAllPageRowsSelected: { fn: (value) => table_toggleAllPageRowsSelected(table, value) },
+				table_getPreSelectedRowModel: { fn: () => table_getPreSelectedRowModel(table) },
+				table_getSelectedRowModel: {
+					fn: () => table_getSelectedRowModel(table),
+					memoDeps: () => {
+						var _table$atoms$rowSelec;
+						return [(_table$atoms$rowSelec = table.atoms.rowSelection) === null || _table$atoms$rowSelec === void 0 ? void 0 : _table$atoms$rowSelec.get(), table.getCoreRowModel()];
+					}
+				},
+				table_getFilteredSelectedRowModel: {
+					fn: () => table_getFilteredSelectedRowModel(table),
+					memoDeps: () => {
+						var _table$atoms$rowSelec2;
+						return [(_table$atoms$rowSelec2 = table.atoms.rowSelection) === null || _table$atoms$rowSelec2 === void 0 ? void 0 : _table$atoms$rowSelec2.get(), table.getFilteredRowModel()];
+					}
+				},
+				table_getGroupedSelectedRowModel: {
+					fn: () => table_getGroupedSelectedRowModel(table),
+					memoDeps: () => {
+						var _table$atoms$rowSelec3;
+						return [(_table$atoms$rowSelec3 = table.atoms.rowSelection) === null || _table$atoms$rowSelec3 === void 0 ? void 0 : _table$atoms$rowSelec3.get(), table.getSortedRowModel()];
+					}
+				},
+				table_getIsAllRowsSelected: { fn: () => table_getIsAllRowsSelected(table) },
+				table_getIsAllPageRowsSelected: { fn: () => table_getIsAllPageRowsSelected(table) },
+				table_getIsSomeRowsSelected: { fn: () => table_getIsSomeRowsSelected(table) },
+				table_getIsSomePageRowsSelected: { fn: () => table_getIsSomePageRowsSelected(table) },
+				table_getToggleAllRowsSelectedHandler: { fn: () => table_getToggleAllRowsSelectedHandler(table) },
+				table_getToggleAllPageRowsSelectedHandler: { fn: () => table_getToggleAllPageRowsSelectedHandler(table) }
+			});
+		}
+	};
+}
+/**
+* The stock row selection feature.
+*
+* Register this feature to add row selection state, selected row-model helpers,
+* and table/row APIs for checkbox and bulk-selection UI.
+*/
+const rowSelectionFeature = constructRowSelectionFeature();
+
+//#endregion
+export { constructRowSelectionFeature, rowSelectionFeature };
+//# sourceMappingURL=rowSelectionFeature.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rowSelectionFeature.js","names":[],"sources":["../../../src/features/row-selection/rowSelectionFeature.ts"],"sourcesContent":["import {\n  assignPrototypeAPIs,\n  assignTableAPIs,\n  makeStateUpdater,\n} from '../../utils'\nimport {\n  getDefaultRowSelectionState,\n  row_getCanMultiSelect,\n  row_getCanSelect,\n  row_getCanSelectSubRows,\n  row_getIsAllSubRowsSelected,\n  row_getIsSelected,\n  row_getIsSomeSelected,\n  row_getToggleSelectedHandler,\n  row_toggleSelected,\n  table_getFilteredSelectedRowModel,\n  table_getGroupedSelectedRowModel,\n  table_getIsAllPageRowsSelected,\n  table_getIsAllRowsSelected,\n  table_getIsSomePageRowsSelected,\n  table_getIsSomeRowsSelected,\n  table_getPreSelectedRowModel,\n  table_getSelectedRowModel,\n  table_getToggleAllPageRowsSelectedHandler,\n  table_getToggleAllRowsSelectedHandler,\n  table_resetRowSelection,\n  table_setRowSelection,\n  table_toggleAllPageRowsSelected,\n  table_toggleAllRowsSelected,\n} from './rowSelectionFeature.utils'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\n// import type {\n//   Row_RowSelection,\n//   TableOptions_RowSelection,\n//   TableState_RowSelection,\n//   Table_RowSelection,\n// } from './rowSelectionFeature.types'\n\nexport interface RowSelectionFeatureConstructors<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  // Row: Row_RowSelection\n  // Table: Table_RowSelection<TFeatures, TData>\n  // TableOptions: TableOptions_RowSelection<TFeatures, TData>\n  // TableState: TableState_RowSelection\n}\n\n/**\n * Creates the stock row selection 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 constructRowSelectionFeature<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): TableFeature<RowSelectionFeatureConstructors<TFeatures, TData>> {\n  return {\n    getInitialState: (initialState) => {\n      return {\n        rowSelection: getDefaultRowSelectionState(),\n        ...initialState,\n      }\n    },\n\n    getDefaultTableOptions: (table) => {\n      return {\n        onRowSelectionChange: makeStateUpdater('rowSelection', table),\n        enableRowSelection: true,\n        enableMultiRowSelection: true,\n        enableSubRowSelection: true,\n      }\n    },\n\n    assignRowPrototype: (prototype, table) => {\n      assignPrototypeAPIs('rowSelectionFeature', prototype, table, {\n        row_toggleSelected: {\n          fn: (row, value, opts) => row_toggleSelected(row, value, opts),\n        },\n        row_getIsSelected: {\n          fn: (row) => row_getIsSelected(row),\n        },\n        row_getIsSomeSelected: {\n          fn: (row) => row_getIsSomeSelected(row),\n        },\n        row_getIsAllSubRowsSelected: {\n          fn: (row) => row_getIsAllSubRowsSelected(row),\n        },\n        row_getCanSelect: {\n          fn: (row) => row_getCanSelect(row),\n        },\n        row_getCanSelectSubRows: {\n          fn: (row) => row_getCanSelectSubRows(row),\n        },\n        row_getCanMultiSelect: {\n          fn: (row) => row_getCanMultiSelect(row),\n        },\n        row_getToggleSelectedHandler: {\n          fn: (row) => row_getToggleSelectedHandler(row),\n        },\n      })\n    },\n\n    constructTableAPIs: (table) => {\n      assignTableAPIs('rowSelectionFeature', table, {\n        table_setRowSelection: {\n          fn: (updater) => table_setRowSelection(table, updater),\n        },\n        table_resetRowSelection: {\n          fn: (defaultState) => table_resetRowSelection(table, defaultState),\n        },\n        table_toggleAllRowsSelected: {\n          fn: (value) => table_toggleAllRowsSelected(table, value),\n        },\n        table_toggleAllPageRowsSelected: {\n          fn: (value) => table_toggleAllPageRowsSelected(table, value),\n        },\n        table_getPreSelectedRowModel: {\n          fn: () => table_getPreSelectedRowModel(table),\n        },\n        table_getSelectedRowModel: {\n          fn: () => table_getSelectedRowModel(table),\n          memoDeps: () => [\n            table.atoms.rowSelection?.get(),\n            table.getCoreRowModel(),\n          ],\n        },\n        table_getFilteredSelectedRowModel: {\n          fn: () => table_getFilteredSelectedRowModel(table),\n          memoDeps: () => [\n            table.atoms.rowSelection?.get(),\n            table.getFilteredRowModel(),\n          ],\n        },\n        table_getGroupedSelectedRowModel: {\n          fn: () => table_getGroupedSelectedRowModel(table),\n          memoDeps: () => [\n            table.atoms.rowSelection?.get(),\n            table.getSortedRowModel(),\n          ],\n        },\n        table_getIsAllRowsSelected: {\n          fn: () => table_getIsAllRowsSelected(table),\n        },\n        table_getIsAllPageRowsSelected: {\n          fn: () => table_getIsAllPageRowsSelected(table),\n        },\n        table_getIsSomeRowsSelected: {\n          fn: () => table_getIsSomeRowsSelected(table),\n        },\n        table_getIsSomePageRowsSelected: {\n          fn: () => table_getIsSomePageRowsSelected(table),\n        },\n        table_getToggleAllRowsSelectedHandler: {\n          fn: () => table_getToggleAllRowsSelectedHandler(table),\n        },\n        table_getToggleAllPageRowsSelectedHandler: {\n          fn: () => table_getToggleAllPageRowsSelectedHandler(table),\n        },\n      })\n    },\n  }\n}\n\n/**\n * The stock row selection feature.\n *\n * Register this feature to add row selection state, selected row-model helpers,\n * and table/row APIs for checkbox and bulk-selection UI.\n */\nexport const rowSelectionFeature = constructRowSelectionFeature()\n"],"mappings":";;;;;;;;;AAsDA,SAAgB,+BAGqD;CACnE,OAAO;EACL,kBAAkB,iBAAiB;GACjC,OAAO;IACL,cAAc,4BAA4B;IAC1C,GAAG;GACL;EACF;EAEA,yBAAyB,UAAU;GACjC,OAAO;IACL,sBAAsB,iBAAiB,gBAAgB,KAAK;IAC5D,oBAAoB;IACpB,yBAAyB;IACzB,uBAAuB;GACzB;EACF;EAEA,qBAAqB,WAAW,UAAU;GACxC,oBAAoB,uBAAuB,WAAW,OAAO;IAC3D,oBAAoB,EAClB,KAAK,KAAK,OAAO,SAAS,mBAAmB,KAAK,OAAO,IAAI,EAC/D;IACA,mBAAmB,EACjB,KAAK,QAAQ,kBAAkB,GAAG,EACpC;IACA,uBAAuB,EACrB,KAAK,QAAQ,sBAAsB,GAAG,EACxC;IACA,6BAA6B,EAC3B,KAAK,QAAQ,4BAA4B,GAAG,EAC9C;IACA,kBAAkB,EAChB,KAAK,QAAQ,iBAAiB,GAAG,EACnC;IACA,yBAAyB,EACvB,KAAK,QAAQ,wBAAwB,GAAG,EAC1C;IACA,uBAAuB,EACrB,KAAK,QAAQ,sBAAsB,GAAG,EACxC;IACA,8BAA8B,EAC5B,KAAK,QAAQ,6BAA6B,GAAG,EAC/C;GACF,CAAC;EACH;EAEA,qBAAqB,UAAU;GAC7B,gBAAgB,uBAAuB,OAAO;IAC5C,uBAAuB,EACrB,KAAK,YAAY,sBAAsB,OAAO,OAAO,EACvD;IACA,yBAAyB,EACvB,KAAK,iBAAiB,wBAAwB,OAAO,YAAY,EACnE;IACA,6BAA6B,EAC3B,KAAK,UAAU,4BAA4B,OAAO,KAAK,EACzD;IACA,iCAAiC,EAC/B,KAAK,UAAU,gCAAgC,OAAO,KAAK,EAC7D;IACA,8BAA8B,EAC5B,UAAU,6BAA6B,KAAK,EAC9C;IACA,2BAA2B;KACzB,UAAU,0BAA0B,KAAK;KACzC,gBAAgB;;uCACd,MAAM,MAAM,4FAAc,IAAI,GAC9B,MAAM,gBAAgB,CACxB;;IACF;IACA,mCAAmC;KACjC,UAAU,kCAAkC,KAAK;KACjD,gBAAgB;;wCACd,MAAM,MAAM,8FAAc,IAAI,GAC9B,MAAM,oBAAoB,CAC5B;;IACF;IACA,kCAAkC;KAChC,UAAU,iCAAiC,KAAK;KAChD,gBAAgB;;wCACd,MAAM,MAAM,8FAAc,IAAI,GAC9B,MAAM,kBAAkB,CAC1B;;IACF;IACA,4BAA4B,EAC1B,UAAU,2BAA2B,KAAK,EAC5C;IACA,gCAAgC,EAC9B,UAAU,+BAA+B,KAAK,EAChD;IACA,6BAA6B,EAC3B,UAAU,4BAA4B,KAAK,EAC7C;IACA,iCAAiC,EAC/B,UAAU,gCAAgC,KAAK,EACjD;IACA,uCAAuC,EACrC,UAAU,sCAAsC,KAAK,EACvD;IACA,2CAA2C,EACzC,UAAU,0CAA0C,KAAK,EAC3D;GACF,CAAC;EACH;CACF;AACF;;;;;;;AAQA,MAAa,sBAAsB,6BAA6B"}

package/dist/features/row-selection/rowSelectionFeature.types.d.cts

@@ -0,0 +1,136 @@
+import { OnChangeFn, RowData, Updater } from "../../types/type-utils.cjs";
+import { Row } from "../../types/Row.cjs";
+import { TableFeatures } from "../../types/TableFeatures.cjs";
+import { RowModel } from "../../core/row-models/coreRowModelsFeature.types.cjs";
+
+//#region src/features/row-selection/rowSelectionFeature.types.d.ts
+type RowSelectionState = Record<string, boolean | undefined>;
+interface TableState_RowSelection {
+  rowSelection: RowSelectionState;
+}
+interface TableOptions_RowSelection<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * Allows rows to be selected alongside other rows.
+   *
+   * Provide a predicate to decide per row. Defaults to `true`.
+   */
+  enableMultiRowSelection?: boolean | ((row: Row<TFeatures, TData>) => boolean);
+  /**
+   * Allows rows to be selected.
+   *
+   * Provide a predicate to decide per row. Defaults to `true`.
+   */
+  enableRowSelection?: boolean | ((row: Row<TFeatures, TData>) => boolean);
+  /**
+   * Controls whether selecting a parent row also selects its subRows.
+   *
+   * Provide a predicate to decide per row. This is most useful with expanding or
+   * grouping features and defaults to `true`.
+   */
+  enableSubRowSelection?: boolean | ((row: Row<TFeatures, TData>) => boolean);
+  /**
+   * Called with an updater when row selection state changes. Pair this with
+   * `state.rowSelection` when using external state; external atoms can own the
+   * slice without this callback.
+   */
+  onRowSelectionChange?: OnChangeFn<RowSelectionState>;
+}
+interface Row_RowSelection {
+  /**
+   * Checks whether this row can be selected alongside other rows.
+   */
+  getCanMultiSelect: () => boolean;
+  /**
+   * Checks whether this row can currently be selected.
+   */
+  getCanSelect: () => boolean;
+  /**
+   * Checks whether selecting this row should also select its subRows.
+   */
+  getCanSelectSubRows: () => boolean;
+  /**
+   * Checks whether all selectable descendants are selected.
+   */
+  getIsAllSubRowsSelected: () => boolean;
+  /**
+   * Checks whether this row id is selected.
+   */
+  getIsSelected: () => boolean;
+  /**
+   * Checks whether some selectable descendants are selected.
+   */
+  getIsSomeSelected: () => boolean;
+  /**
+   * Creates a checkbox-style handler that toggles this row's selected state.
+   */
+  getToggleSelectedHandler: () => (event: unknown) => void;
+  /**
+   * Selects/deselects the row.
+   */
+  toggleSelected: (value?: boolean, opts?: {
+    selectChildren?: boolean;
+  }) => void;
+}
+interface Table_RowSelection<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * Builds a selected-row model from rows after filtering.
+   */
+  getFilteredSelectedRowModel: () => RowModel<TFeatures, TData>;
+  /**
+   * Builds a selected-row model from rows after grouping.
+   */
+  getGroupedSelectedRowModel: () => RowModel<TFeatures, TData>;
+  /**
+   * Checks whether every selectable row on the current page is selected.
+   */
+  getIsAllPageRowsSelected: () => boolean;
+  /**
+   * Checks whether every selectable filtered row is selected.
+   */
+  getIsAllRowsSelected: () => boolean;
+  /**
+   * Checks whether the current page has a partial row selection.
+   */
+  getIsSomePageRowsSelected: () => boolean;
+  /**
+   * Checks whether filtered rows have a partial row selection.
+   */
+  getIsSomeRowsSelected: () => boolean;
+  /**
+   * Returns the core row model of all rows before row selection has been applied.
+   */
+  getPreSelectedRowModel: () => RowModel<TFeatures, TData>;
+  /**
+   * Builds a selected-row model from the core row model.
+   */
+  getSelectedRowModel: () => RowModel<TFeatures, TData>;
+  /**
+   * Creates a checkbox-style handler that toggles all current-page rows.
+   */
+  getToggleAllPageRowsSelectedHandler: () => (event: unknown) => void;
+  /**
+   * Creates a checkbox-style handler that toggles all selectable rows.
+   */
+  getToggleAllRowsSelectedHandler: () => (event: unknown) => void;
+  /**
+   * Resets `rowSelection` to `initialState.rowSelection`.
+   *
+   * Pass `true` to ignore initial state and reset to `{}`.
+   */
+  resetRowSelection: (defaultState?: boolean) => void;
+  /**
+   * Updates row selection state with a next map or updater function.
+   */
+  setRowSelection: (updater: Updater<RowSelectionState>) => void;
+  /**
+   * Selects/deselects all rows on the current page.
+   */
+  toggleAllPageRowsSelected: (value?: boolean) => void;
+  /**
+   * Selects/deselects all rows in the table.
+   */
+  toggleAllRowsSelected: (value?: boolean) => void;
+}
+//#endregion
+export { RowSelectionState, Row_RowSelection, TableOptions_RowSelection, TableState_RowSelection, Table_RowSelection };
+//# sourceMappingURL=rowSelectionFeature.types.d.cts.map