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

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

@@ -0,0 +1 @@
+{"version":3,"file":"rowSelectionFeature.utils.cjs","names":["cloneState"],"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 * Creates the default row selection state.\n *\n * The feature default is an empty map, meaning no rows are selected. Reset APIs\n * use this value when `defaultState` is `true`.\n *\n * @example\n * ```ts\n * const selection = getDefaultRowSelectionState()\n * ```\n */\nexport function getDefaultRowSelectionState(): RowSelectionState {\n  return {}\n}\n\n/**\n * Routes a row selection updater through the table's selection change handler.\n *\n * The updater may be a next selection map or a function of the previous map,\n * matching the instance `table.setRowSelection` behavior.\n *\n * @example\n * ```ts\n * table_setRowSelection(table, (old) => ({ ...old, [rowId]: true }))\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 `rowSelection` to the configured initial state or feature default.\n *\n * With no argument, the reset clones `table.initialState.rowSelection` when it\n * exists. Passing `true` ignores initial state and resets to `{}`.\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 * Selects or deselects every selectable row before grouping.\n *\n * Omitting `value` toggles based on `table_getIsAllRowsSelected(table)`.\n * Deselecting removes matching ids from the existing selection map.\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 * Selects or deselects every selectable row on the current page.\n *\n * Omitting `value` toggles based on `table_getIsAllPageRowsSelected(table)`.\n * Child rows are included when sub-row selection allows it.\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 * Reads the row model before row selection is projected into selected rows.\n *\n * Selection does not alter the base row pipeline, so this returns the core row\n * model.\n *\n * @example\n * ```ts\n * const rowsBeforeSelection = 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 * Builds a row model containing selected rows from the core row model.\n *\n * If no row ids are selected, an empty row model is returned without walking\n * the rows.\n *\n * @example\n * ```ts\n * const selectedRows = 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 * Builds a row model containing selected rows from the filtered row model.\n *\n * If no row ids are selected, an empty row model is returned without walking\n * the rows.\n *\n * @example\n * ```ts\n * const selectedRows = 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 * Builds a row model containing selected rows from the grouped row model.\n *\n * If no row ids are selected, an empty row model is returned without walking\n * the rows.\n *\n * @example\n * ```ts\n * const selectedRows = 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 * Checks whether every selectable filtered row is selected.\n *\n * The result is false when there are no filtered rows or when selection state is\n * empty.\n *\n * @example\n * ```ts\n * const allSelected = 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 * Checks whether every selectable row on the current page is selected.\n *\n * Non-selectable rows are ignored for this calculation.\n *\n * @example\n * ```ts\n * const allPageRowsSelected = 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 * Checks whether selection is partially applied across filtered rows.\n *\n * The result is true when at least one row id is selected but fewer ids are\n * selected than the current filtered flat row count.\n *\n * @example\n * ```ts\n * const someRowsSelected = 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 * Checks whether the current page has a partial selection.\n *\n * This is false when all selectable page rows are selected. Otherwise it is true\n * if any selectable page row or descendant is selected.\n *\n * @example\n * ```ts\n * const somePageRowsSelected = 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 * Creates a checkbox-style handler that selects or deselects all rows.\n *\n * The handler reads `event.target.checked`, so it is intended for controls whose\n * checked state means \"all rows selected\".\n *\n * @example\n * ```ts\n * const onChange = 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 * Creates a checkbox-style handler that selects or deselects current page rows.\n *\n * The handler reads `event.target.checked`, so it is intended for controls whose\n * checked state means \"all page rows selected\".\n *\n * @example\n * ```ts\n * const onChange = 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 * Selects or deselects this row.\n *\n * Omitting `value` toggles the row. Child rows are selected recursively unless\n * `opts.selectChildren` is `false` or sub-row selection is disabled.\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 * Checks whether this row id is selected in `state.rowSelection`.\n *\n * Missing row ids are treated as not selected.\n *\n * @example\n * ```ts\n * const selected = 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 * Checks whether some, but not all, selectable descendants are selected.\n *\n * This supports indeterminate selection UI for parent rows.\n *\n * @example\n * ```ts\n * const partial = 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 * Checks whether all selectable descendants are selected.\n *\n * Rows without selectable descendants return false.\n *\n * @example\n * ```ts\n * const allChildrenSelected = 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 * Checks whether this row can be selected.\n *\n * `options.enableRowSelection` may be a boolean or a row predicate; it defaults\n * to `true`.\n *\n * @example\n * ```ts\n * const canSelect = 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 * Checks whether selecting this row should also select its subRows.\n *\n * `options.enableSubRowSelection` may be a boolean or a row predicate; it\n * defaults to `true`.\n *\n * @example\n * ```ts\n * const canSelectChildren = 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 * Checks whether this row can be selected alongside other rows.\n *\n * `options.enableMultiRowSelection` may be a boolean or a row predicate; it\n * defaults to `true`.\n *\n * @example\n * ```ts\n * const canMultiSelect = 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 * Creates a checkbox-style handler that selects or deselects this row.\n *\n * The handler is a no-op when the row cannot be selected and reads\n * `event.target.checked`.\n *\n * @example\n * ```ts\n * const onChange = 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\n * that model are not materialized as rows.\n *\n * @example\n * ```ts\n * const selectedRows = selectRowsFn(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      const 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        // Always recurse — selected descendants of unselected parents must\n        // still be collected into flatRows/rowsById.\n        const newSubRows = recurseRows(row.subRows, depth + 1)\n\n        if (isSelected) {\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 = newSubRows\n          result.push(cloned)\n        }\n      } else 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)\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)\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-selection/rowSelectionFeature.utils.d.cts

@@ -0,0 +1,318 @@
+import { RowData, Updater } from "../../types/type-utils.cjs";
+import { RowSelectionState } from "./rowSelectionFeature.types.cjs";
+import { Row } from "../../types/Row.cjs";
+import { Table_Internal } from "../../types/Table.cjs";
+import { TableFeatures } from "../../types/TableFeatures.cjs";
+import { RowModel } from "../../core/row-models/coreRowModelsFeature.types.cjs";
+
+//#region src/features/row-selection/rowSelectionFeature.utils.d.ts
+/**
+ * Creates the default row selection state.
+ *
+ * The feature default is an empty map, meaning no rows are selected. Reset APIs
+ * use this value when `defaultState` is `true`.
+ *
+ * @example
+ * ```ts
+ * const selection = getDefaultRowSelectionState()
+ * ```
+ */
+declare function getDefaultRowSelectionState(): RowSelectionState;
+/**
+ * Routes a row selection updater through the table's selection change handler.
+ *
+ * The updater may be a next selection map or a function of the previous map,
+ * matching the instance `table.setRowSelection` behavior.
+ *
+ * @example
+ * ```ts
+ * table_setRowSelection(table, (old) => ({ ...old, [rowId]: true }))
+ * ```
+ */
+declare function table_setRowSelection<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, updater: Updater<RowSelectionState>): void;
+/**
+ * Resets `rowSelection` to the configured initial state or feature default.
+ *
+ * With no argument, the reset clones `table.initialState.rowSelection` when it
+ * exists. Passing `true` ignores initial state and resets to `{}`.
+ *
+ * @example
+ * ```ts
+ * table_resetRowSelection(table)
+ * table_resetRowSelection(table, true)
+ * ```
+ */
+declare function table_resetRowSelection<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean): void;
+/**
+ * Selects or deselects every selectable row before grouping.
+ *
+ * Omitting `value` toggles based on `table_getIsAllRowsSelected(table)`.
+ * Deselecting removes matching ids from the existing selection map.
+ *
+ * @example
+ * ```ts
+ * table_toggleAllRowsSelected(table)
+ * ```
+ */
+declare function table_toggleAllRowsSelected<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, value?: boolean): void;
+/**
+ * Selects or deselects every selectable row on the current page.
+ *
+ * Omitting `value` toggles based on `table_getIsAllPageRowsSelected(table)`.
+ * Child rows are included when sub-row selection allows it.
+ *
+ * @example
+ * ```ts
+ * table_toggleAllPageRowsSelected(table)
+ * ```
+ */
+declare function table_toggleAllPageRowsSelected<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, value?: boolean): void;
+/**
+ * Reads the row model before row selection is projected into selected rows.
+ *
+ * Selection does not alter the base row pipeline, so this returns the core row
+ * model.
+ *
+ * @example
+ * ```ts
+ * const rowsBeforeSelection = table_getPreSelectedRowModel(table)
+ * ```
+ */
+declare function table_getPreSelectedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
+/**
+ * Builds a row model containing selected rows from the core row model.
+ *
+ * If no row ids are selected, an empty row model is returned without walking
+ * the rows.
+ *
+ * @example
+ * ```ts
+ * const selectedRows = table_getSelectedRowModel(table)
+ * ```
+ */
+declare function table_getSelectedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
+/**
+ * Builds a row model containing selected rows from the filtered row model.
+ *
+ * If no row ids are selected, an empty row model is returned without walking
+ * the rows.
+ *
+ * @example
+ * ```ts
+ * const selectedRows = table_getFilteredSelectedRowModel(table)
+ * ```
+ */
+declare function table_getFilteredSelectedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
+/**
+ * Builds a row model containing selected rows from the grouped row model.
+ *
+ * If no row ids are selected, an empty row model is returned without walking
+ * the rows.
+ *
+ * @example
+ * ```ts
+ * const selectedRows = table_getGroupedSelectedRowModel(table)
+ * ```
+ */
+declare function table_getGroupedSelectedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
+/**
+ * Checks whether every selectable filtered row is selected.
+ *
+ * The result is false when there are no filtered rows or when selection state is
+ * empty.
+ *
+ * @example
+ * ```ts
+ * const allSelected = table_getIsAllRowsSelected(table)
+ * ```
+ */
+declare function table_getIsAllRowsSelected<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): boolean;
+/**
+ * Checks whether every selectable row on the current page is selected.
+ *
+ * Non-selectable rows are ignored for this calculation.
+ *
+ * @example
+ * ```ts
+ * const allPageRowsSelected = table_getIsAllPageRowsSelected(table)
+ * ```
+ */
+declare function table_getIsAllPageRowsSelected<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): boolean;
+/**
+ * Checks whether selection is partially applied across filtered rows.
+ *
+ * The result is true when at least one row id is selected but fewer ids are
+ * selected than the current filtered flat row count.
+ *
+ * @example
+ * ```ts
+ * const someRowsSelected = table_getIsSomeRowsSelected(table)
+ * ```
+ */
+declare function table_getIsSomeRowsSelected<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): boolean;
+/**
+ * Checks whether the current page has a partial selection.
+ *
+ * This is false when all selectable page rows are selected. Otherwise it is true
+ * if any selectable page row or descendant is selected.
+ *
+ * @example
+ * ```ts
+ * const somePageRowsSelected = table_getIsSomePageRowsSelected(table)
+ * ```
+ */
+declare function table_getIsSomePageRowsSelected<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): boolean;
+/**
+ * Creates a checkbox-style handler that selects or deselects all rows.
+ *
+ * The handler reads `event.target.checked`, so it is intended for controls whose
+ * checked state means "all rows selected".
+ *
+ * @example
+ * ```ts
+ * const onChange = table_getToggleAllRowsSelectedHandler(table)
+ * ```
+ */
+declare function table_getToggleAllRowsSelectedHandler<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): (e: unknown) => void;
+/**
+ * Creates a checkbox-style handler that selects or deselects current page rows.
+ *
+ * The handler reads `event.target.checked`, so it is intended for controls whose
+ * checked state means "all page rows selected".
+ *
+ * @example
+ * ```ts
+ * const onChange = table_getToggleAllPageRowsSelectedHandler(table)
+ * ```
+ */
+declare function table_getToggleAllPageRowsSelectedHandler<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): (e: unknown) => void;
+/**
+ * Selects or deselects this row.
+ *
+ * Omitting `value` toggles the row. Child rows are selected recursively unless
+ * `opts.selectChildren` is `false` or sub-row selection is disabled.
+ *
+ * @example
+ * ```ts
+ * row_toggleSelected(row)
+ * ```
+ */
+declare function row_toggleSelected<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, value?: boolean, opts?: {
+  selectChildren?: boolean;
+}): void;
+/**
+ * Checks whether this row id is selected in `state.rowSelection`.
+ *
+ * Missing row ids are treated as not selected.
+ *
+ * @example
+ * ```ts
+ * const selected = row_getIsSelected(row)
+ * ```
+ */
+declare function row_getIsSelected<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): boolean;
+/**
+ * Checks whether some, but not all, selectable descendants are selected.
+ *
+ * This supports indeterminate selection UI for parent rows.
+ *
+ * @example
+ * ```ts
+ * const partial = row_getIsSomeSelected(row)
+ * ```
+ */
+declare function row_getIsSomeSelected<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): boolean;
+/**
+ * Checks whether all selectable descendants are selected.
+ *
+ * Rows without selectable descendants return false.
+ *
+ * @example
+ * ```ts
+ * const allChildrenSelected = row_getIsAllSubRowsSelected(row)
+ * ```
+ */
+declare function row_getIsAllSubRowsSelected<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): boolean;
+/**
+ * Checks whether this row can be selected.
+ *
+ * `options.enableRowSelection` may be a boolean or a row predicate; it defaults
+ * to `true`.
+ *
+ * @example
+ * ```ts
+ * const canSelect = row_getCanSelect(row)
+ * ```
+ */
+declare function row_getCanSelect<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): boolean;
+/**
+ * Checks whether selecting this row should also select its subRows.
+ *
+ * `options.enableSubRowSelection` may be a boolean or a row predicate; it
+ * defaults to `true`.
+ *
+ * @example
+ * ```ts
+ * const canSelectChildren = row_getCanSelectSubRows(row)
+ * ```
+ */
+declare function row_getCanSelectSubRows<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): boolean;
+/**
+ * Checks whether this row can be selected alongside other rows.
+ *
+ * `options.enableMultiRowSelection` may be a boolean or a row predicate; it
+ * defaults to `true`.
+ *
+ * @example
+ * ```ts
+ * const canMultiSelect = row_getCanMultiSelect(row)
+ * ```
+ */
+declare function row_getCanMultiSelect<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): boolean;
+/**
+ * Creates a checkbox-style handler that selects or deselects this row.
+ *
+ * The handler is a no-op when the row cannot be selected and reads
+ * `event.target.checked`.
+ *
+ * @example
+ * ```ts
+ * const onChange = row_getToggleSelectedHandler(row)
+ * ```
+ */
+declare function row_getToggleSelectedHandler<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): (e: unknown) => void;
+/**
+ * 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
+ * that model are not materialized as rows.
+ *
+ * @example
+ * ```ts
+ * const selectedRows = selectRowsFn(rowModel)
+ * ```
+ */
+declare function selectRowsFn<TFeatures extends TableFeatures, TData extends RowData>(rowModel: RowModel<TFeatures, TData>): RowModel<TFeatures, TData>;
+/**
+ * Returns whether a row id is selected in the current row selection state.
+ *
+ * @example
+ * ```ts
+ * const selected = isRowSelected(row)
+ * ```
+ */
+declare function isRowSelected<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): boolean;
+/**
+ * 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)
+ * ```
+ */
+declare function isSubRowSelected<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): boolean | 'some' | 'all';
+//#endregion
+export { getDefaultRowSelectionState, isRowSelected, isSubRowSelected, row_getCanMultiSelect, row_getCanSelect, row_getCanSelectSubRows, row_getIsAllSubRowsSelected, row_getIsSelected, row_getIsSomeSelected, row_getToggleSelectedHandler, row_toggleSelected, selectRowsFn, 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 };
+//# sourceMappingURL=rowSelectionFeature.utils.d.cts.map