@tanstack/table-core 9.0.0-beta.43 → 9.0.0-beta.44

package/dist/core/rows/coreRowsFeature.types.d.cts

@@ -8,6 +8,15 @@ import { TableFeatures } from "../../types/TableFeatures.cjs";
 //#region src/core/rows/coreRowsFeature.types.d.ts
 interface Row_CoreProperties<in out TFeatures extends TableFeatures, in out TData extends RowData> {
   _cellsCache?: WeakMap<Column<TFeatures, TData, unknown>, Cell<TFeatures, TData, unknown>>;
+  /**
+   * Internal cache used while resolving the current display order.
+   *
+   * This value may be stale until display order is recomputed. Use
+   * `row.getDisplayIndex()` instead; it refreshes and validates the cached
+   * position before returning it.
+   *
+   * @internal
+   */
   _displayIndexCache: number;
   _uniqueValuesCache: Record<string, unknown>;
   _valuesCache: Record<string, unknown>;
@@ -47,7 +56,9 @@ interface Row_CoreProperties<in out TFeatures extends TableFeatures, in out TDat
 interface Row_Row<in out TFeatures extends TableFeatures, in out TData extends RowData> extends Row_CoreProperties<TFeatures, TData> {
   /**
    * Returns the zero-based index of the row in the current display order
-   * before pagination, or `-1` if the row is not in that model.
+   * before pagination, or `-1` if the row is not in that model. Use this for
+   * display row-number columns instead of `row.index` or the internal
+   * `_displayIndexCache` field.
    */
   getDisplayIndex: () => number;
   /**

package/dist/core/rows/coreRowsFeature.types.d.ts

@@ -8,6 +8,15 @@ import { TableFeatures } from "../../types/TableFeatures.js";
 //#region src/core/rows/coreRowsFeature.types.d.ts
 interface Row_CoreProperties<in out TFeatures extends TableFeatures, in out TData extends RowData> {
   _cellsCache?: WeakMap<Column<TFeatures, TData, unknown>, Cell<TFeatures, TData, unknown>>;
+  /**
+   * Internal cache used while resolving the current display order.
+   *
+   * This value may be stale until display order is recomputed. Use
+   * `row.getDisplayIndex()` instead; it refreshes and validates the cached
+   * position before returning it.
+   *
+   * @internal
+   */
   _displayIndexCache: number;
   _uniqueValuesCache: Record<string, unknown>;
   _valuesCache: Record<string, unknown>;
@@ -47,7 +56,9 @@ interface Row_CoreProperties<in out TFeatures extends TableFeatures, in out TDat
 interface Row_Row<in out TFeatures extends TableFeatures, in out TData extends RowData> extends Row_CoreProperties<TFeatures, TData> {
   /**
    * Returns the zero-based index of the row in the current display order
-   * before pagination, or `-1` if the row is not in that model.
+   * before pagination, or `-1` if the row is not in that model. Use this for
+   * display row-number columns instead of `row.index` or the internal
+   * `_displayIndexCache` field.
    */
   getDisplayIndex: () => number;
   /**

package/dist/core/table/constructTable.cjs

@@ -95,6 +95,7 @@ function constructTable(tableOptions) {
 		}
 		return snapshot;
 	}, { debugName: "table/store" }));
+	for (let i = 0; i < featuresList.length; i++) featuresList[i].initTableInstanceData?.(table);
 	if (process.env.NODE_ENV === "development" && (tableOptions.debugAll || tableOptions.debugTable)) {
 		const features = Object.keys(table._features);
 		const rowModels = Object.entries({

package/dist/core/table/constructTable.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"constructTable.cjs","names":["cloneState","coreFeatures","atomToStore"],"sources":["../../../src/core/table/constructTable.ts"],"sourcesContent":["import { coreFeatures } from '../coreFeatures'\nimport { cloneState } from '../../utils'\nimport { atomToStore } from '../reactivity/coreReactivityFeature.utils'\nimport { table_syncExternalStateToBaseAtoms } from './coreTablesFeature.utils'\nimport type { Atom } from '@tanstack/store'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { TableOptions } from '../../types/TableOptions'\nimport type { TableState, TableState_All } from '../../types/TableState'\n\n/**\n * Builds the initial table state from registered features and user initial state.\n *\n * Each feature contributes its default state before user-provided `initialState` values are merged in.\n */\nexport function getInitialTableState<TFeatures extends TableFeatures>(\n  features: TFeatures,\n  initialState: Partial<TableState<TFeatures>> | undefined = {},\n): TableState<TFeatures> {\n  Object.values(features).forEach((feature) => {\n    initialState = feature.getInitialState?.(initialState) ?? initialState\n  })\n  return cloneState(initialState) as TableState<TFeatures>\n}\n\n/**\n * Constructs a table instance from normalized table internals.\n *\n * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.\n */\nexport function constructTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(tableOptions: TableOptions<TFeatures, TData>): Table<TFeatures, TData> {\n  const _reactivity = tableOptions.features.coreReactivityFeature!\n\n  // Strip the non-feature slots: type-only meta slots, row model factories,\n  // and row model fn registries all live on the `features` option but are not\n  // table features themselves.\n  const {\n    aggregationFns,\n    columnMeta: _columnMeta,\n    coreRowModel,\n    expandedRowModel,\n    facetedMinMaxValues,\n    facetedRowModel,\n    facetedUniqueValues,\n    filterFns,\n    filterMeta: _filterMeta,\n    filteredRowModel,\n    groupedRowModel,\n    paginatedRowModel,\n    sortFns,\n    sortedRowModel,\n    tableMeta: _tableMeta,\n    ...features\n  } = tableOptions.features\n\n  const table = {\n    _reactivity,\n    _features: { ...coreFeatures, ...features },\n    _rowModels: {},\n    _rowModelFns: { aggregationFns, filterFns, sortFns },\n    baseAtoms: {},\n    atoms: {},\n  } as unknown as Table_Internal<TFeatures, TData>\n\n  const featuresList: Array<TableFeature> = Object.values(table._features)\n\n  const defaultOptions = featuresList.reduce((obj, feature) => {\n    return Object.assign(obj, feature.getDefaultTableOptions?.(table))\n  }, {}) as TableOptions<TFeatures, TData>\n\n  const mergedOptions = { ...defaultOptions, ...tableOptions }\n\n  if (_reactivity.wrapExternalAtoms && mergedOptions.atoms) {\n    for (const [atomKey, _atom] of Object.entries(mergedOptions.atoms)) {\n      const atom = _atom as Atom<any>\n      const wrappedAtom = _reactivity.createWritableAtom(atom.get(), {\n        debugName: `externalAtom/${atomKey}`,\n      })\n      ;(mergedOptions.atoms as any)[atomKey] = wrappedAtom\n      // Two-way syncing between the original atom and the wrapped one.\n      let syncExternal = false\n      const syncAtomToWrappedSub = atom.subscribe((value) => {\n        if (syncExternal) return\n        wrappedAtom.set(value)\n      })\n      const syncWrappedToAtomSub = wrappedAtom.subscribe((value) => {\n        syncExternal = true\n        atom.set(value)\n        syncExternal = false\n      })\n      _reactivity.addSubscription(syncAtomToWrappedSub)\n      _reactivity.addSubscription(syncWrappedToAtomSub)\n    }\n  }\n\n  if (_reactivity.createOptionsStore) {\n    // @ts-ignore - direct set\n    table.optionsStore = _reactivity.createWritableAtom<\n      TableOptions<TFeatures, TData>\n    >(mergedOptions, { debugName: 'table/optionsStore' })\n    Object.defineProperty(table, 'options', {\n      configurable: true,\n      enumerable: true,\n      get() {\n        return table.optionsStore!.get()\n      },\n      set(value) {\n        table.optionsStore!.set(() => value) // or your real update shape\n      },\n    })\n  } else {\n    table.options = mergedOptions\n  }\n\n  table.initialState = getInitialTableState(\n    table._features,\n    table.options.initialState,\n  )\n\n  const stateKeys = Object.keys(table.initialState) as Array<\n    string & keyof TableState_All\n  >\n\n  for (let i = 0; i < stateKeys.length; i++) {\n    const key = stateKeys[i]!\n    table.baseAtoms[key] = _reactivity.createWritableAtom(\n      table.initialState[key],\n      {\n        debugName: `table/baseAtoms/${key}`,\n      },\n    ) as any\n\n    // create readonly derived atom: on each get(), read either external atom or base atom\n    ;(table.atoms as any)[key] = _reactivity.createReadonlyAtom(\n      () => {\n        const externalAtoms = table.options.atoms as\n          | Partial<Record<keyof TableState_All, Atom<unknown>>>\n          | undefined\n        const externalAtom = externalAtoms?.[key]\n        if (externalAtom) {\n          return externalAtom.get()\n        }\n        return table.baseAtoms[key]!.get()\n      },\n      { debugName: `table/atoms/${key}` },\n    )\n  }\n\n  table_syncExternalStateToBaseAtoms(table)\n\n  table.store = atomToStore(\n    _reactivity.createReadonlyAtom(\n      () => {\n        const snapshot = {} as TableState<TFeatures> & TableState_All\n        for (let i = 0; i < stateKeys.length; i++) {\n          const key = stateKeys[i]!\n          ;(snapshot as Record<string, unknown>)[key] = table.atoms[key]!.get()\n        }\n        return snapshot\n      },\n      { debugName: 'table/store' },\n    ),\n  )\n\n  if (\n    process.env.NODE_ENV === 'development' &&\n    (tableOptions.debugAll || tableOptions.debugTable)\n  ) {\n    const features = Object.keys(table._features)\n    const rowModels = Object.entries({\n      coreRowModel,\n      filteredRowModel,\n      groupedRowModel,\n      sortedRowModel,\n      expandedRowModel,\n      paginatedRowModel,\n      facetedRowModel,\n      facetedMinMaxValues,\n      facetedUniqueValues,\n    })\n      .filter(([, factory]) => factory)\n      .map(([key]) => key)\n    const states = Object.keys(table.initialState)\n\n    console.log(\n      `Constructing Table Instance\n\n  Features:   ${features.join('\\n              ')}\n\n  Row Models: ${rowModels.length ? rowModels.join('\\n              ') : '(none)'}\n\n  States:     ${states.join('\\n              ')}\\n`,\n      { table },\n    )\n  }\n\n  for (let i = 0; i < featuresList.length; i++) {\n    featuresList[i]!.constructTableAPIs?.(table)\n  }\n\n  return table as unknown as Table<TFeatures, TData>\n}\n"],"mappings":"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"}
+{"version":3,"file":"constructTable.cjs","names":["cloneState","coreFeatures","atomToStore"],"sources":["../../../src/core/table/constructTable.ts"],"sourcesContent":["import { coreFeatures } from '../coreFeatures'\nimport { cloneState } from '../../utils'\nimport { atomToStore } from '../reactivity/coreReactivityFeature.utils'\nimport { table_syncExternalStateToBaseAtoms } from './coreTablesFeature.utils'\nimport type { Atom } from '@tanstack/store'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { TableOptions } from '../../types/TableOptions'\nimport type { TableState, TableState_All } from '../../types/TableState'\n\n/**\n * Builds the initial table state from registered features and user initial state.\n *\n * Each feature contributes its default state before user-provided `initialState` values are merged in.\n */\nexport function getInitialTableState<TFeatures extends TableFeatures>(\n  features: TFeatures,\n  initialState: Partial<TableState<TFeatures>> | undefined = {},\n): TableState<TFeatures> {\n  Object.values(features).forEach((feature) => {\n    initialState = feature.getInitialState?.(initialState) ?? initialState\n  })\n  return cloneState(initialState) as TableState<TFeatures>\n}\n\n/**\n * Constructs a table instance from normalized table internals.\n *\n * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.\n */\nexport function constructTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(tableOptions: TableOptions<TFeatures, TData>): Table<TFeatures, TData> {\n  const _reactivity = tableOptions.features.coreReactivityFeature!\n\n  // Strip the non-feature slots: type-only meta slots, row model factories,\n  // and row model fn registries all live on the `features` option but are not\n  // table features themselves.\n  const {\n    aggregationFns,\n    columnMeta: _columnMeta,\n    coreRowModel,\n    expandedRowModel,\n    facetedMinMaxValues,\n    facetedRowModel,\n    facetedUniqueValues,\n    filterFns,\n    filterMeta: _filterMeta,\n    filteredRowModel,\n    groupedRowModel,\n    paginatedRowModel,\n    sortFns,\n    sortedRowModel,\n    tableMeta: _tableMeta,\n    ...features\n  } = tableOptions.features\n\n  const table = {\n    _reactivity,\n    _features: { ...coreFeatures, ...features },\n    _rowModels: {},\n    _rowModelFns: { aggregationFns, filterFns, sortFns },\n    baseAtoms: {},\n    atoms: {},\n  } as unknown as Table_Internal<TFeatures, TData>\n\n  const featuresList: Array<TableFeature> = Object.values(table._features)\n\n  const defaultOptions = featuresList.reduce((obj, feature) => {\n    return Object.assign(obj, feature.getDefaultTableOptions?.(table))\n  }, {}) as TableOptions<TFeatures, TData>\n\n  const mergedOptions = { ...defaultOptions, ...tableOptions }\n\n  if (_reactivity.wrapExternalAtoms && mergedOptions.atoms) {\n    for (const [atomKey, _atom] of Object.entries(mergedOptions.atoms)) {\n      const atom = _atom as Atom<any>\n      const wrappedAtom = _reactivity.createWritableAtom(atom.get(), {\n        debugName: `externalAtom/${atomKey}`,\n      })\n      ;(mergedOptions.atoms as any)[atomKey] = wrappedAtom\n      // Two-way syncing between the original atom and the wrapped one.\n      let syncExternal = false\n      const syncAtomToWrappedSub = atom.subscribe((value) => {\n        if (syncExternal) return\n        wrappedAtom.set(value)\n      })\n      const syncWrappedToAtomSub = wrappedAtom.subscribe((value) => {\n        syncExternal = true\n        atom.set(value)\n        syncExternal = false\n      })\n      _reactivity.addSubscription(syncAtomToWrappedSub)\n      _reactivity.addSubscription(syncWrappedToAtomSub)\n    }\n  }\n\n  if (_reactivity.createOptionsStore) {\n    // @ts-ignore - direct set\n    table.optionsStore = _reactivity.createWritableAtom<\n      TableOptions<TFeatures, TData>\n    >(mergedOptions, { debugName: 'table/optionsStore' })\n    Object.defineProperty(table, 'options', {\n      configurable: true,\n      enumerable: true,\n      get() {\n        return table.optionsStore!.get()\n      },\n      set(value) {\n        table.optionsStore!.set(() => value) // or your real update shape\n      },\n    })\n  } else {\n    table.options = mergedOptions\n  }\n\n  table.initialState = getInitialTableState(\n    table._features,\n    table.options.initialState,\n  )\n\n  const stateKeys = Object.keys(table.initialState) as Array<\n    string & keyof TableState_All\n  >\n\n  for (let i = 0; i < stateKeys.length; i++) {\n    const key = stateKeys[i]!\n    table.baseAtoms[key] = _reactivity.createWritableAtom(\n      table.initialState[key],\n      {\n        debugName: `table/baseAtoms/${key}`,\n      },\n    ) as any\n\n    // create readonly derived atom: on each get(), read either external atom or base atom\n    ;(table.atoms as any)[key] = _reactivity.createReadonlyAtom(\n      () => {\n        const externalAtoms = table.options.atoms as\n          | Partial<Record<keyof TableState_All, Atom<unknown>>>\n          | undefined\n        const externalAtom = externalAtoms?.[key]\n        if (externalAtom) {\n          return externalAtom.get()\n        }\n        return table.baseAtoms[key]!.get()\n      },\n      { debugName: `table/atoms/${key}` },\n    )\n  }\n\n  table_syncExternalStateToBaseAtoms(table)\n\n  table.store = atomToStore(\n    _reactivity.createReadonlyAtom(\n      () => {\n        const snapshot = {} as TableState<TFeatures> & TableState_All\n        for (let i = 0; i < stateKeys.length; i++) {\n          const key = stateKeys[i]!\n          ;(snapshot as Record<string, unknown>)[key] = table.atoms[key]!.get()\n        }\n        return snapshot\n      },\n      { debugName: 'table/store' },\n    ),\n  )\n\n  for (let i = 0; i < featuresList.length; i++) {\n    featuresList[i]!.initTableInstanceData?.(table)\n  }\n\n  if (\n    process.env.NODE_ENV === 'development' &&\n    (tableOptions.debugAll || tableOptions.debugTable)\n  ) {\n    const features = Object.keys(table._features)\n    const rowModels = Object.entries({\n      coreRowModel,\n      filteredRowModel,\n      groupedRowModel,\n      sortedRowModel,\n      expandedRowModel,\n      paginatedRowModel,\n      facetedRowModel,\n      facetedMinMaxValues,\n      facetedUniqueValues,\n    })\n      .filter(([, factory]) => factory)\n      .map(([key]) => key)\n    const states = Object.keys(table.initialState)\n\n    console.log(\n      `Constructing Table Instance\n\n  Features:   ${features.join('\\n              ')}\n\n  Row Models: ${rowModels.length ? rowModels.join('\\n              ') : '(none)'}\n\n  States:     ${states.join('\\n              ')}\\n`,\n      { table },\n    )\n  }\n\n  for (let i = 0; i < featuresList.length; i++) {\n    featuresList[i]!.constructTableAPIs?.(table)\n  }\n\n  return table as unknown as Table<TFeatures, TData>\n}\n"],"mappings":"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"}

package/dist/core/table/constructTable.js

@@ -95,6 +95,7 @@ function constructTable(tableOptions) {
 		}
 		return snapshot;
 	}, { debugName: "table/store" }));
+	for (let i = 0; i < featuresList.length; i++) featuresList[i].initTableInstanceData?.(table);
 	if (process.env.NODE_ENV === "development" && (tableOptions.debugAll || tableOptions.debugTable)) {
 		const features = Object.keys(table._features);
 		const rowModels = Object.entries({

package/dist/core/table/constructTable.js.map

@@ -1 +1 @@
-{"version":3,"file":"constructTable.js","names":[],"sources":["../../../src/core/table/constructTable.ts"],"sourcesContent":["import { coreFeatures } from '../coreFeatures'\nimport { cloneState } from '../../utils'\nimport { atomToStore } from '../reactivity/coreReactivityFeature.utils'\nimport { table_syncExternalStateToBaseAtoms } from './coreTablesFeature.utils'\nimport type { Atom } from '@tanstack/store'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { TableOptions } from '../../types/TableOptions'\nimport type { TableState, TableState_All } from '../../types/TableState'\n\n/**\n * Builds the initial table state from registered features and user initial state.\n *\n * Each feature contributes its default state before user-provided `initialState` values are merged in.\n */\nexport function getInitialTableState<TFeatures extends TableFeatures>(\n  features: TFeatures,\n  initialState: Partial<TableState<TFeatures>> | undefined = {},\n): TableState<TFeatures> {\n  Object.values(features).forEach((feature) => {\n    initialState = feature.getInitialState?.(initialState) ?? initialState\n  })\n  return cloneState(initialState) as TableState<TFeatures>\n}\n\n/**\n * Constructs a table instance from normalized table internals.\n *\n * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.\n */\nexport function constructTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(tableOptions: TableOptions<TFeatures, TData>): Table<TFeatures, TData> {\n  const _reactivity = tableOptions.features.coreReactivityFeature!\n\n  // Strip the non-feature slots: type-only meta slots, row model factories,\n  // and row model fn registries all live on the `features` option but are not\n  // table features themselves.\n  const {\n    aggregationFns,\n    columnMeta: _columnMeta,\n    coreRowModel,\n    expandedRowModel,\n    facetedMinMaxValues,\n    facetedRowModel,\n    facetedUniqueValues,\n    filterFns,\n    filterMeta: _filterMeta,\n    filteredRowModel,\n    groupedRowModel,\n    paginatedRowModel,\n    sortFns,\n    sortedRowModel,\n    tableMeta: _tableMeta,\n    ...features\n  } = tableOptions.features\n\n  const table = {\n    _reactivity,\n    _features: { ...coreFeatures, ...features },\n    _rowModels: {},\n    _rowModelFns: { aggregationFns, filterFns, sortFns },\n    baseAtoms: {},\n    atoms: {},\n  } as unknown as Table_Internal<TFeatures, TData>\n\n  const featuresList: Array<TableFeature> = Object.values(table._features)\n\n  const defaultOptions = featuresList.reduce((obj, feature) => {\n    return Object.assign(obj, feature.getDefaultTableOptions?.(table))\n  }, {}) as TableOptions<TFeatures, TData>\n\n  const mergedOptions = { ...defaultOptions, ...tableOptions }\n\n  if (_reactivity.wrapExternalAtoms && mergedOptions.atoms) {\n    for (const [atomKey, _atom] of Object.entries(mergedOptions.atoms)) {\n      const atom = _atom as Atom<any>\n      const wrappedAtom = _reactivity.createWritableAtom(atom.get(), {\n        debugName: `externalAtom/${atomKey}`,\n      })\n      ;(mergedOptions.atoms as any)[atomKey] = wrappedAtom\n      // Two-way syncing between the original atom and the wrapped one.\n      let syncExternal = false\n      const syncAtomToWrappedSub = atom.subscribe((value) => {\n        if (syncExternal) return\n        wrappedAtom.set(value)\n      })\n      const syncWrappedToAtomSub = wrappedAtom.subscribe((value) => {\n        syncExternal = true\n        atom.set(value)\n        syncExternal = false\n      })\n      _reactivity.addSubscription(syncAtomToWrappedSub)\n      _reactivity.addSubscription(syncWrappedToAtomSub)\n    }\n  }\n\n  if (_reactivity.createOptionsStore) {\n    // @ts-ignore - direct set\n    table.optionsStore = _reactivity.createWritableAtom<\n      TableOptions<TFeatures, TData>\n    >(mergedOptions, { debugName: 'table/optionsStore' })\n    Object.defineProperty(table, 'options', {\n      configurable: true,\n      enumerable: true,\n      get() {\n        return table.optionsStore!.get()\n      },\n      set(value) {\n        table.optionsStore!.set(() => value) // or your real update shape\n      },\n    })\n  } else {\n    table.options = mergedOptions\n  }\n\n  table.initialState = getInitialTableState(\n    table._features,\n    table.options.initialState,\n  )\n\n  const stateKeys = Object.keys(table.initialState) as Array<\n    string & keyof TableState_All\n  >\n\n  for (let i = 0; i < stateKeys.length; i++) {\n    const key = stateKeys[i]!\n    table.baseAtoms[key] = _reactivity.createWritableAtom(\n      table.initialState[key],\n      {\n        debugName: `table/baseAtoms/${key}`,\n      },\n    ) as any\n\n    // create readonly derived atom: on each get(), read either external atom or base atom\n    ;(table.atoms as any)[key] = _reactivity.createReadonlyAtom(\n      () => {\n        const externalAtoms = table.options.atoms as\n          | Partial<Record<keyof TableState_All, Atom<unknown>>>\n          | undefined\n        const externalAtom = externalAtoms?.[key]\n        if (externalAtom) {\n          return externalAtom.get()\n        }\n        return table.baseAtoms[key]!.get()\n      },\n      { debugName: `table/atoms/${key}` },\n    )\n  }\n\n  table_syncExternalStateToBaseAtoms(table)\n\n  table.store = atomToStore(\n    _reactivity.createReadonlyAtom(\n      () => {\n        const snapshot = {} as TableState<TFeatures> & TableState_All\n        for (let i = 0; i < stateKeys.length; i++) {\n          const key = stateKeys[i]!\n          ;(snapshot as Record<string, unknown>)[key] = table.atoms[key]!.get()\n        }\n        return snapshot\n      },\n      { debugName: 'table/store' },\n    ),\n  )\n\n  if (\n    process.env.NODE_ENV === 'development' &&\n    (tableOptions.debugAll || tableOptions.debugTable)\n  ) {\n    const features = Object.keys(table._features)\n    const rowModels = Object.entries({\n      coreRowModel,\n      filteredRowModel,\n      groupedRowModel,\n      sortedRowModel,\n      expandedRowModel,\n      paginatedRowModel,\n      facetedRowModel,\n      facetedMinMaxValues,\n      facetedUniqueValues,\n    })\n      .filter(([, factory]) => factory)\n      .map(([key]) => key)\n    const states = Object.keys(table.initialState)\n\n    console.log(\n      `Constructing Table Instance\n\n  Features:   ${features.join('\\n              ')}\n\n  Row Models: ${rowModels.length ? rowModels.join('\\n              ') : '(none)'}\n\n  States:     ${states.join('\\n              ')}\\n`,\n      { table },\n    )\n  }\n\n  for (let i = 0; i < featuresList.length; i++) {\n    featuresList[i]!.constructTableAPIs?.(table)\n  }\n\n  return table as unknown as Table<TFeatures, TData>\n}\n"],"mappings":"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"}
+{"version":3,"file":"constructTable.js","names":[],"sources":["../../../src/core/table/constructTable.ts"],"sourcesContent":["import { coreFeatures } from '../coreFeatures'\nimport { cloneState } from '../../utils'\nimport { atomToStore } from '../reactivity/coreReactivityFeature.utils'\nimport { table_syncExternalStateToBaseAtoms } from './coreTablesFeature.utils'\nimport type { Atom } from '@tanstack/store'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { TableOptions } from '../../types/TableOptions'\nimport type { TableState, TableState_All } from '../../types/TableState'\n\n/**\n * Builds the initial table state from registered features and user initial state.\n *\n * Each feature contributes its default state before user-provided `initialState` values are merged in.\n */\nexport function getInitialTableState<TFeatures extends TableFeatures>(\n  features: TFeatures,\n  initialState: Partial<TableState<TFeatures>> | undefined = {},\n): TableState<TFeatures> {\n  Object.values(features).forEach((feature) => {\n    initialState = feature.getInitialState?.(initialState) ?? initialState\n  })\n  return cloneState(initialState) as TableState<TFeatures>\n}\n\n/**\n * Constructs a table instance from normalized table internals.\n *\n * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.\n */\nexport function constructTable<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(tableOptions: TableOptions<TFeatures, TData>): Table<TFeatures, TData> {\n  const _reactivity = tableOptions.features.coreReactivityFeature!\n\n  // Strip the non-feature slots: type-only meta slots, row model factories,\n  // and row model fn registries all live on the `features` option but are not\n  // table features themselves.\n  const {\n    aggregationFns,\n    columnMeta: _columnMeta,\n    coreRowModel,\n    expandedRowModel,\n    facetedMinMaxValues,\n    facetedRowModel,\n    facetedUniqueValues,\n    filterFns,\n    filterMeta: _filterMeta,\n    filteredRowModel,\n    groupedRowModel,\n    paginatedRowModel,\n    sortFns,\n    sortedRowModel,\n    tableMeta: _tableMeta,\n    ...features\n  } = tableOptions.features\n\n  const table = {\n    _reactivity,\n    _features: { ...coreFeatures, ...features },\n    _rowModels: {},\n    _rowModelFns: { aggregationFns, filterFns, sortFns },\n    baseAtoms: {},\n    atoms: {},\n  } as unknown as Table_Internal<TFeatures, TData>\n\n  const featuresList: Array<TableFeature> = Object.values(table._features)\n\n  const defaultOptions = featuresList.reduce((obj, feature) => {\n    return Object.assign(obj, feature.getDefaultTableOptions?.(table))\n  }, {}) as TableOptions<TFeatures, TData>\n\n  const mergedOptions = { ...defaultOptions, ...tableOptions }\n\n  if (_reactivity.wrapExternalAtoms && mergedOptions.atoms) {\n    for (const [atomKey, _atom] of Object.entries(mergedOptions.atoms)) {\n      const atom = _atom as Atom<any>\n      const wrappedAtom = _reactivity.createWritableAtom(atom.get(), {\n        debugName: `externalAtom/${atomKey}`,\n      })\n      ;(mergedOptions.atoms as any)[atomKey] = wrappedAtom\n      // Two-way syncing between the original atom and the wrapped one.\n      let syncExternal = false\n      const syncAtomToWrappedSub = atom.subscribe((value) => {\n        if (syncExternal) return\n        wrappedAtom.set(value)\n      })\n      const syncWrappedToAtomSub = wrappedAtom.subscribe((value) => {\n        syncExternal = true\n        atom.set(value)\n        syncExternal = false\n      })\n      _reactivity.addSubscription(syncAtomToWrappedSub)\n      _reactivity.addSubscription(syncWrappedToAtomSub)\n    }\n  }\n\n  if (_reactivity.createOptionsStore) {\n    // @ts-ignore - direct set\n    table.optionsStore = _reactivity.createWritableAtom<\n      TableOptions<TFeatures, TData>\n    >(mergedOptions, { debugName: 'table/optionsStore' })\n    Object.defineProperty(table, 'options', {\n      configurable: true,\n      enumerable: true,\n      get() {\n        return table.optionsStore!.get()\n      },\n      set(value) {\n        table.optionsStore!.set(() => value) // or your real update shape\n      },\n    })\n  } else {\n    table.options = mergedOptions\n  }\n\n  table.initialState = getInitialTableState(\n    table._features,\n    table.options.initialState,\n  )\n\n  const stateKeys = Object.keys(table.initialState) as Array<\n    string & keyof TableState_All\n  >\n\n  for (let i = 0; i < stateKeys.length; i++) {\n    const key = stateKeys[i]!\n    table.baseAtoms[key] = _reactivity.createWritableAtom(\n      table.initialState[key],\n      {\n        debugName: `table/baseAtoms/${key}`,\n      },\n    ) as any\n\n    // create readonly derived atom: on each get(), read either external atom or base atom\n    ;(table.atoms as any)[key] = _reactivity.createReadonlyAtom(\n      () => {\n        const externalAtoms = table.options.atoms as\n          | Partial<Record<keyof TableState_All, Atom<unknown>>>\n          | undefined\n        const externalAtom = externalAtoms?.[key]\n        if (externalAtom) {\n          return externalAtom.get()\n        }\n        return table.baseAtoms[key]!.get()\n      },\n      { debugName: `table/atoms/${key}` },\n    )\n  }\n\n  table_syncExternalStateToBaseAtoms(table)\n\n  table.store = atomToStore(\n    _reactivity.createReadonlyAtom(\n      () => {\n        const snapshot = {} as TableState<TFeatures> & TableState_All\n        for (let i = 0; i < stateKeys.length; i++) {\n          const key = stateKeys[i]!\n          ;(snapshot as Record<string, unknown>)[key] = table.atoms[key]!.get()\n        }\n        return snapshot\n      },\n      { debugName: 'table/store' },\n    ),\n  )\n\n  for (let i = 0; i < featuresList.length; i++) {\n    featuresList[i]!.initTableInstanceData?.(table)\n  }\n\n  if (\n    process.env.NODE_ENV === 'development' &&\n    (tableOptions.debugAll || tableOptions.debugTable)\n  ) {\n    const features = Object.keys(table._features)\n    const rowModels = Object.entries({\n      coreRowModel,\n      filteredRowModel,\n      groupedRowModel,\n      sortedRowModel,\n      expandedRowModel,\n      paginatedRowModel,\n      facetedRowModel,\n      facetedMinMaxValues,\n      facetedUniqueValues,\n    })\n      .filter(([, factory]) => factory)\n      .map(([key]) => key)\n    const states = Object.keys(table.initialState)\n\n    console.log(\n      `Constructing Table Instance\n\n  Features:   ${features.join('\\n              ')}\n\n  Row Models: ${rowModels.length ? rowModels.join('\\n              ') : '(none)'}\n\n  States:     ${states.join('\\n              ')}\\n`,\n      { table },\n    )\n  }\n\n  for (let i = 0; i < featuresList.length; i++) {\n    featuresList[i]!.constructTableAPIs?.(table)\n  }\n\n  return table as unknown as Table<TFeatures, TData>\n}\n"],"mappings":"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"}

package/dist/core/table/coreTablesFeature.types.d.cts

@@ -184,7 +184,8 @@ interface Table_Table<in out TFeatures extends TableFeatures, in out TData exten
    *
    * Prefer feature-specific reset APIs, such as `resetPagination`, when a state
    * slice may be owned by an external atom or needs that feature's blank/default
-   * reset behavior.
+   * reset behavior. After resetting internal atoms, this also invokes feature
+   * reset hooks for mutable, transient table-instance data.
    */
   reset: () => void;
   /**

package/dist/core/table/coreTablesFeature.types.d.ts

@@ -184,7 +184,8 @@ interface Table_Table<in out TFeatures extends TableFeatures, in out TData exten
    *
    * Prefer feature-specific reset APIs, such as `resetPagination`, when a state
    * slice may be owned by an external atom or needs that feature's blank/default
-   * reset behavior.
+   * reset behavior. After resetting internal atoms, this also invokes feature
+   * reset hooks for mutable, transient table-instance data.
    */
   reset: () => void;
   /**

package/dist/core/table/coreTablesFeature.utils.cjs

@@ -25,7 +25,8 @@ function table_syncExternalStateToBaseAtoms(table) {
 	});
 }
 /**
-* Resets all internal table base atoms to `table.initialState`.
+* Resets all internal table base atoms to `table.initialState`, then clears
+* transient instance data through registered feature reset hooks.
 *
 * This resets internally owned state slices in a single reactivity batch. Use
 * feature-specific reset APIs when a slice may be externally owned.
@@ -44,6 +45,8 @@ function table_reset(table) {
 			table.baseAtoms[key].set(snap[key]);
 		}
 	});
+	const features = Object.values(table._features);
+	for (let i = 0; i < features.length; i++) features[i].resetTableInstanceData?.(table);
 }
 /**
 * Merges new table options with the current resolved options.

package/dist/core/table/coreTablesFeature.utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"coreTablesFeature.utils.cjs","names":["cloneState","functionalUpdate"],"sources":["../../../src/core/table/coreTablesFeature.utils.ts"],"sourcesContent":["import { cloneState, functionalUpdate } 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 { TableOptions } from '../../types/TableOptions'\n\n/**\n * Synchronizes externally controlled state slices into the table's base atoms.\n *\n * This keeps legacy `options.state` values reflected in the atom graph so\n * derived atoms, stores, and table APIs read a consistent snapshot.\n *\n * @example\n * ```ts\n * table_syncExternalStateToBaseAtoms(table)\n * ```\n */\nexport function table_syncExternalStateToBaseAtoms<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): void {\n  const state = table.options.state\n  if (!state) {\n    return\n  }\n\n  table._reactivity.batch(() => {\n    for (const key in state) {\n      const baseAtom = (table.baseAtoms as Record<string, any>)[key]\n      if (!baseAtom) {\n        continue\n      }\n\n      const externalState = state[key as keyof typeof state]\n      if (externalState !== table._reactivity.untrack(() => baseAtom.get())) {\n        baseAtom.set(() => externalState)\n      }\n    }\n  })\n}\n\n/**\n * Resets all internal table base atoms to `table.initialState`.\n *\n * This resets internally owned state slices in a single reactivity batch. Use\n * feature-specific reset APIs when a slice may be externally owned.\n *\n * @example\n * ```ts\n * table_reset(table)\n * ```\n */\nexport function table_reset<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): void {\n  const snap = cloneState(table.initialState)\n  table._reactivity.batch(() => {\n    const keys = Object.keys(snap) as Array<keyof typeof snap>\n    for (let i = 0; i < keys.length; i++) {\n      const key = keys[i]!\n      ;(table.baseAtoms as any)[key].set(snap[key])\n    }\n  })\n}\n\n/**\n * Merges new table options with the current resolved options.\n *\n * If `options.mergeOptions` is provided, it owns the merge behavior; otherwise\n * options are shallow-merged. Static options that should never change after\n * initialization are restored on a fresh object so framework merge helpers may\n * return readonly getter/proxy objects.\n *\n * @example\n * ```ts\n * const options = table_mergeOptions(table, nextOptions)\n * ```\n */\nexport function table_mergeOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  newOptions: TableOptions<TFeatures, TData>,\n) {\n  const { features, atoms, initialState } = table.options\n\n  // simple merge if no mergeOptions is provided - performant\n  if (!table.options.mergeOptions) {\n    return {\n      ...table.options,\n      ...newOptions,\n      features,\n      atoms,\n      initialState,\n    }\n  }\n\n  // else use the mergeOptions function and preserve getters/setters\n  const mergedOptions = table.options.mergeOptions(\n    table.options as TableOptions<TFeatures, TData>,\n    newOptions,\n  )\n  const descriptors: PropertyDescriptorMap = {\n    ...Object.getOwnPropertyDescriptors(mergedOptions),\n  }\n\n  return Object.defineProperties(\n    Object.create(Object.getPrototypeOf(mergedOptions)),\n    {\n      ...descriptors,\n      features: {\n        value: features,\n        enumerable: true,\n        configurable: true,\n        writable: true,\n      },\n      atoms: {\n        value: atoms,\n        enumerable: true,\n        configurable: true,\n        writable: true,\n      },\n      initialState: {\n        value: initialState,\n        enumerable: true,\n        configurable: true,\n        writable: true,\n      },\n    },\n  ) as TableOptions<TFeatures, TData>\n}\n\n/**\n * Updates the table options object.\n *\n * The updater receives the current resolved options and the merged result is\n * immediately assigned to the table instance.\n *\n * @example\n * ```ts\n * table_setOptions(table, (old) => old)\n * ```\n */\nexport function table_setOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  updater: Updater<TableOptions<TFeatures, TData>>,\n): void {\n  const newOptions = functionalUpdate(\n    updater,\n    table.options as TableOptions<TFeatures, TData>,\n  )\n  const mergedOptions = table_mergeOptions(table, newOptions)\n\n  if (table.optionsStore) {\n    table.optionsStore.set(() => mergedOptions)\n  } else {\n    table.options = mergedOptions\n  }\n  table_syncExternalStateToBaseAtoms(table)\n}\n"],"mappings":";;;;;;;;;;;;;;AAiBA,SAAgB,mCAGd,OAA+C;CAC/C,MAAM,QAAQ,MAAM,QAAQ;CAC5B,IAAI,CAAC,OACH;CAGF,MAAM,YAAY,YAAY;EAC5B,KAAK,MAAM,OAAO,OAAO;GACvB,MAAM,WAAY,MAAM,UAAkC;GAC1D,IAAI,CAAC,UACH;GAGF,MAAM,gBAAgB,MAAM;GAC5B,IAAI,kBAAkB,MAAM,YAAY,cAAc,SAAS,IAAI,CAAC,GAClE,SAAS,UAAU,aAAa;EAEpC;CACF,CAAC;AACH;;;;;;;;;;;;AAaA,SAAgB,YAGd,OAA+C;CAC/C,MAAM,OAAOA,yBAAW,MAAM,YAAY;CAC1C,MAAM,YAAY,YAAY;EAC5B,MAAM,OAAO,OAAO,KAAK,IAAI;EAC7B,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;GACpC,MAAM,MAAM,KAAK;GAChB,AAAC,MAAM,UAAkB,IAAI,CAAC,IAAI,KAAK,IAAI;EAC9C;CACF,CAAC;AACH;;;;;;;;;;;;;;AAeA,SAAgB,mBAId,OACA,YACA;CACA,MAAM,EAAE,UAAU,OAAO,iBAAiB,MAAM;CAGhD,IAAI,CAAC,MAAM,QAAQ,cACjB,OAAO;EACL,GAAG,MAAM;EACT,GAAG;EACH;EACA;EACA;CACF;CAIF,MAAM,gBAAgB,MAAM,QAAQ,aAClC,MAAM,SACN,UACF;CACA,MAAM,cAAqC,EACzC,GAAG,OAAO,0BAA0B,aAAa,EACnD;CAEA,OAAO,OAAO,iBACZ,OAAO,OAAO,OAAO,eAAe,aAAa,CAAC,GAClD;EACE,GAAG;EACH,UAAU;GACR,OAAO;GACP,YAAY;GACZ,cAAc;GACd,UAAU;EACZ;EACA,OAAO;GACL,OAAO;GACP,YAAY;GACZ,cAAc;GACd,UAAU;EACZ;EACA,cAAc;GACZ,OAAO;GACP,YAAY;GACZ,cAAc;GACd,UAAU;EACZ;CACF,CACF;AACF;;;;;;;;;;;;AAaA,SAAgB,iBAId,OACA,SACM;CAKN,MAAM,gBAAgB,mBAAmB,OAJtBC,+BACjB,SACA,MAAM,OAEiD,CAAC;CAE1D,IAAI,MAAM,cACR,MAAM,aAAa,UAAU,aAAa;MAE1C,MAAM,UAAU;CAElB,mCAAmC,KAAK;AAC1C"}
+{"version":3,"file":"coreTablesFeature.utils.cjs","names":["cloneState","functionalUpdate"],"sources":["../../../src/core/table/coreTablesFeature.utils.ts"],"sourcesContent":["import { cloneState, functionalUpdate } 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 { TableOptions } from '../../types/TableOptions'\n\n/**\n * Synchronizes externally controlled state slices into the table's base atoms.\n *\n * This keeps legacy `options.state` values reflected in the atom graph so\n * derived atoms, stores, and table APIs read a consistent snapshot.\n *\n * @example\n * ```ts\n * table_syncExternalStateToBaseAtoms(table)\n * ```\n */\nexport function table_syncExternalStateToBaseAtoms<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): void {\n  const state = table.options.state\n  if (!state) {\n    return\n  }\n\n  table._reactivity.batch(() => {\n    for (const key in state) {\n      const baseAtom = (table.baseAtoms as Record<string, any>)[key]\n      if (!baseAtom) {\n        continue\n      }\n\n      const externalState = state[key as keyof typeof state]\n      if (externalState !== table._reactivity.untrack(() => baseAtom.get())) {\n        baseAtom.set(() => externalState)\n      }\n    }\n  })\n}\n\n/**\n * Resets all internal table base atoms to `table.initialState`, then clears\n * transient instance data through registered feature reset hooks.\n *\n * This resets internally owned state slices in a single reactivity batch. Use\n * feature-specific reset APIs when a slice may be externally owned.\n *\n * @example\n * ```ts\n * table_reset(table)\n * ```\n */\nexport function table_reset<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): void {\n  const snap = cloneState(table.initialState)\n  table._reactivity.batch(() => {\n    const keys = Object.keys(snap) as Array<keyof typeof snap>\n    for (let i = 0; i < keys.length; i++) {\n      const key = keys[i]!\n      ;(table.baseAtoms as any)[key].set(snap[key])\n    }\n  })\n\n  const features = Object.values(table._features)\n  for (let i = 0; i < features.length; i++) {\n    features[i]!.resetTableInstanceData?.(table)\n  }\n}\n\n/**\n * Merges new table options with the current resolved options.\n *\n * If `options.mergeOptions` is provided, it owns the merge behavior; otherwise\n * options are shallow-merged. Static options that should never change after\n * initialization are restored on a fresh object so framework merge helpers may\n * return readonly getter/proxy objects.\n *\n * @example\n * ```ts\n * const options = table_mergeOptions(table, nextOptions)\n * ```\n */\nexport function table_mergeOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  newOptions: TableOptions<TFeatures, TData>,\n) {\n  const { features, atoms, initialState } = table.options\n\n  // simple merge if no mergeOptions is provided - performant\n  if (!table.options.mergeOptions) {\n    return {\n      ...table.options,\n      ...newOptions,\n      features,\n      atoms,\n      initialState,\n    }\n  }\n\n  // else use the mergeOptions function and preserve getters/setters\n  const mergedOptions = table.options.mergeOptions(\n    table.options as TableOptions<TFeatures, TData>,\n    newOptions,\n  )\n  const descriptors: PropertyDescriptorMap = {\n    ...Object.getOwnPropertyDescriptors(mergedOptions),\n  }\n\n  return Object.defineProperties(\n    Object.create(Object.getPrototypeOf(mergedOptions)),\n    {\n      ...descriptors,\n      features: {\n        value: features,\n        enumerable: true,\n        configurable: true,\n        writable: true,\n      },\n      atoms: {\n        value: atoms,\n        enumerable: true,\n        configurable: true,\n        writable: true,\n      },\n      initialState: {\n        value: initialState,\n        enumerable: true,\n        configurable: true,\n        writable: true,\n      },\n    },\n  ) as TableOptions<TFeatures, TData>\n}\n\n/**\n * Updates the table options object.\n *\n * The updater receives the current resolved options and the merged result is\n * immediately assigned to the table instance.\n *\n * @example\n * ```ts\n * table_setOptions(table, (old) => old)\n * ```\n */\nexport function table_setOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  updater: Updater<TableOptions<TFeatures, TData>>,\n): void {\n  const newOptions = functionalUpdate(\n    updater,\n    table.options as TableOptions<TFeatures, TData>,\n  )\n  const mergedOptions = table_mergeOptions(table, newOptions)\n\n  if (table.optionsStore) {\n    table.optionsStore.set(() => mergedOptions)\n  } else {\n    table.options = mergedOptions\n  }\n  table_syncExternalStateToBaseAtoms(table)\n}\n"],"mappings":";;;;;;;;;;;;;;AAiBA,SAAgB,mCAGd,OAA+C;CAC/C,MAAM,QAAQ,MAAM,QAAQ;CAC5B,IAAI,CAAC,OACH;CAGF,MAAM,YAAY,YAAY;EAC5B,KAAK,MAAM,OAAO,OAAO;GACvB,MAAM,WAAY,MAAM,UAAkC;GAC1D,IAAI,CAAC,UACH;GAGF,MAAM,gBAAgB,MAAM;GAC5B,IAAI,kBAAkB,MAAM,YAAY,cAAc,SAAS,IAAI,CAAC,GAClE,SAAS,UAAU,aAAa;EAEpC;CACF,CAAC;AACH;;;;;;;;;;;;;AAcA,SAAgB,YAGd,OAA+C;CAC/C,MAAM,OAAOA,yBAAW,MAAM,YAAY;CAC1C,MAAM,YAAY,YAAY;EAC5B,MAAM,OAAO,OAAO,KAAK,IAAI;EAC7B,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;GACpC,MAAM,MAAM,KAAK;GAChB,AAAC,MAAM,UAAkB,IAAI,CAAC,IAAI,KAAK,IAAI;EAC9C;CACF,CAAC;CAED,MAAM,WAAW,OAAO,OAAO,MAAM,SAAS;CAC9C,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KACnC,SAAS,EAAE,CAAE,yBAAyB,KAAK;AAE/C;;;;;;;;;;;;;;AAeA,SAAgB,mBAId,OACA,YACA;CACA,MAAM,EAAE,UAAU,OAAO,iBAAiB,MAAM;CAGhD,IAAI,CAAC,MAAM,QAAQ,cACjB,OAAO;EACL,GAAG,MAAM;EACT,GAAG;EACH;EACA;EACA;CACF;CAIF,MAAM,gBAAgB,MAAM,QAAQ,aAClC,MAAM,SACN,UACF;CACA,MAAM,cAAqC,EACzC,GAAG,OAAO,0BAA0B,aAAa,EACnD;CAEA,OAAO,OAAO,iBACZ,OAAO,OAAO,OAAO,eAAe,aAAa,CAAC,GAClD;EACE,GAAG;EACH,UAAU;GACR,OAAO;GACP,YAAY;GACZ,cAAc;GACd,UAAU;EACZ;EACA,OAAO;GACL,OAAO;GACP,YAAY;GACZ,cAAc;GACd,UAAU;EACZ;EACA,cAAc;GACZ,OAAO;GACP,YAAY;GACZ,cAAc;GACd,UAAU;EACZ;CACF,CACF;AACF;;;;;;;;;;;;AAaA,SAAgB,iBAId,OACA,SACM;CAKN,MAAM,gBAAgB,mBAAmB,OAJtBC,+BACjB,SACA,MAAM,OAEiD,CAAC;CAE1D,IAAI,MAAM,cACR,MAAM,aAAa,UAAU,aAAa;MAE1C,MAAM,UAAU;CAElB,mCAAmC,KAAK;AAC1C"}

package/dist/core/table/coreTablesFeature.utils.d.cts

@@ -17,7 +17,8 @@ import { TableFeatures } from "../../types/TableFeatures.cjs";
  */
 declare function table_syncExternalStateToBaseAtoms<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): void;
 /**
- * Resets all internal table base atoms to `table.initialState`.
+ * Resets all internal table base atoms to `table.initialState`, then clears
+ * transient instance data through registered feature reset hooks.
  *
  * This resets internally owned state slices in a single reactivity batch. Use
  * feature-specific reset APIs when a slice may be externally owned.

package/dist/core/table/coreTablesFeature.utils.d.ts

@@ -17,7 +17,8 @@ import { TableFeatures } from "../../types/TableFeatures.js";
  */
 declare function table_syncExternalStateToBaseAtoms<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): void;
 /**
- * Resets all internal table base atoms to `table.initialState`.
+ * Resets all internal table base atoms to `table.initialState`, then clears
+ * transient instance data through registered feature reset hooks.
  *
  * This resets internally owned state slices in a single reactivity batch. Use
  * feature-specific reset APIs when a slice may be externally owned.

package/dist/core/table/coreTablesFeature.utils.js

@@ -25,7 +25,8 @@ function table_syncExternalStateToBaseAtoms(table) {
 	});
 }
 /**
-* Resets all internal table base atoms to `table.initialState`.
+* Resets all internal table base atoms to `table.initialState`, then clears
+* transient instance data through registered feature reset hooks.
 *
 * This resets internally owned state slices in a single reactivity batch. Use
 * feature-specific reset APIs when a slice may be externally owned.
@@ -44,6 +45,8 @@ function table_reset(table) {
 			table.baseAtoms[key].set(snap[key]);
 		}
 	});
+	const features = Object.values(table._features);
+	for (let i = 0; i < features.length; i++) features[i].resetTableInstanceData?.(table);
 }
 /**
 * Merges new table options with the current resolved options.

package/dist/core/table/coreTablesFeature.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"coreTablesFeature.utils.js","names":[],"sources":["../../../src/core/table/coreTablesFeature.utils.ts"],"sourcesContent":["import { cloneState, functionalUpdate } 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 { TableOptions } from '../../types/TableOptions'\n\n/**\n * Synchronizes externally controlled state slices into the table's base atoms.\n *\n * This keeps legacy `options.state` values reflected in the atom graph so\n * derived atoms, stores, and table APIs read a consistent snapshot.\n *\n * @example\n * ```ts\n * table_syncExternalStateToBaseAtoms(table)\n * ```\n */\nexport function table_syncExternalStateToBaseAtoms<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): void {\n  const state = table.options.state\n  if (!state) {\n    return\n  }\n\n  table._reactivity.batch(() => {\n    for (const key in state) {\n      const baseAtom = (table.baseAtoms as Record<string, any>)[key]\n      if (!baseAtom) {\n        continue\n      }\n\n      const externalState = state[key as keyof typeof state]\n      if (externalState !== table._reactivity.untrack(() => baseAtom.get())) {\n        baseAtom.set(() => externalState)\n      }\n    }\n  })\n}\n\n/**\n * Resets all internal table base atoms to `table.initialState`.\n *\n * This resets internally owned state slices in a single reactivity batch. Use\n * feature-specific reset APIs when a slice may be externally owned.\n *\n * @example\n * ```ts\n * table_reset(table)\n * ```\n */\nexport function table_reset<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): void {\n  const snap = cloneState(table.initialState)\n  table._reactivity.batch(() => {\n    const keys = Object.keys(snap) as Array<keyof typeof snap>\n    for (let i = 0; i < keys.length; i++) {\n      const key = keys[i]!\n      ;(table.baseAtoms as any)[key].set(snap[key])\n    }\n  })\n}\n\n/**\n * Merges new table options with the current resolved options.\n *\n * If `options.mergeOptions` is provided, it owns the merge behavior; otherwise\n * options are shallow-merged. Static options that should never change after\n * initialization are restored on a fresh object so framework merge helpers may\n * return readonly getter/proxy objects.\n *\n * @example\n * ```ts\n * const options = table_mergeOptions(table, nextOptions)\n * ```\n */\nexport function table_mergeOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  newOptions: TableOptions<TFeatures, TData>,\n) {\n  const { features, atoms, initialState } = table.options\n\n  // simple merge if no mergeOptions is provided - performant\n  if (!table.options.mergeOptions) {\n    return {\n      ...table.options,\n      ...newOptions,\n      features,\n      atoms,\n      initialState,\n    }\n  }\n\n  // else use the mergeOptions function and preserve getters/setters\n  const mergedOptions = table.options.mergeOptions(\n    table.options as TableOptions<TFeatures, TData>,\n    newOptions,\n  )\n  const descriptors: PropertyDescriptorMap = {\n    ...Object.getOwnPropertyDescriptors(mergedOptions),\n  }\n\n  return Object.defineProperties(\n    Object.create(Object.getPrototypeOf(mergedOptions)),\n    {\n      ...descriptors,\n      features: {\n        value: features,\n        enumerable: true,\n        configurable: true,\n        writable: true,\n      },\n      atoms: {\n        value: atoms,\n        enumerable: true,\n        configurable: true,\n        writable: true,\n      },\n      initialState: {\n        value: initialState,\n        enumerable: true,\n        configurable: true,\n        writable: true,\n      },\n    },\n  ) as TableOptions<TFeatures, TData>\n}\n\n/**\n * Updates the table options object.\n *\n * The updater receives the current resolved options and the merged result is\n * immediately assigned to the table instance.\n *\n * @example\n * ```ts\n * table_setOptions(table, (old) => old)\n * ```\n */\nexport function table_setOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  updater: Updater<TableOptions<TFeatures, TData>>,\n): void {\n  const newOptions = functionalUpdate(\n    updater,\n    table.options as TableOptions<TFeatures, TData>,\n  )\n  const mergedOptions = table_mergeOptions(table, newOptions)\n\n  if (table.optionsStore) {\n    table.optionsStore.set(() => mergedOptions)\n  } else {\n    table.options = mergedOptions\n  }\n  table_syncExternalStateToBaseAtoms(table)\n}\n"],"mappings":";;;;;;;;;;;;;;AAiBA,SAAgB,mCAGd,OAA+C;CAC/C,MAAM,QAAQ,MAAM,QAAQ;CAC5B,IAAI,CAAC,OACH;CAGF,MAAM,YAAY,YAAY;EAC5B,KAAK,MAAM,OAAO,OAAO;GACvB,MAAM,WAAY,MAAM,UAAkC;GAC1D,IAAI,CAAC,UACH;GAGF,MAAM,gBAAgB,MAAM;GAC5B,IAAI,kBAAkB,MAAM,YAAY,cAAc,SAAS,IAAI,CAAC,GAClE,SAAS,UAAU,aAAa;EAEpC;CACF,CAAC;AACH;;;;;;;;;;;;AAaA,SAAgB,YAGd,OAA+C;CAC/C,MAAM,OAAO,WAAW,MAAM,YAAY;CAC1C,MAAM,YAAY,YAAY;EAC5B,MAAM,OAAO,OAAO,KAAK,IAAI;EAC7B,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;GACpC,MAAM,MAAM,KAAK;GAChB,AAAC,MAAM,UAAkB,IAAI,CAAC,IAAI,KAAK,IAAI;EAC9C;CACF,CAAC;AACH;;;;;;;;;;;;;;AAeA,SAAgB,mBAId,OACA,YACA;CACA,MAAM,EAAE,UAAU,OAAO,iBAAiB,MAAM;CAGhD,IAAI,CAAC,MAAM,QAAQ,cACjB,OAAO;EACL,GAAG,MAAM;EACT,GAAG;EACH;EACA;EACA;CACF;CAIF,MAAM,gBAAgB,MAAM,QAAQ,aAClC,MAAM,SACN,UACF;CACA,MAAM,cAAqC,EACzC,GAAG,OAAO,0BAA0B,aAAa,EACnD;CAEA,OAAO,OAAO,iBACZ,OAAO,OAAO,OAAO,eAAe,aAAa,CAAC,GAClD;EACE,GAAG;EACH,UAAU;GACR,OAAO;GACP,YAAY;GACZ,cAAc;GACd,UAAU;EACZ;EACA,OAAO;GACL,OAAO;GACP,YAAY;GACZ,cAAc;GACd,UAAU;EACZ;EACA,cAAc;GACZ,OAAO;GACP,YAAY;GACZ,cAAc;GACd,UAAU;EACZ;CACF,CACF;AACF;;;;;;;;;;;;AAaA,SAAgB,iBAId,OACA,SACM;CAKN,MAAM,gBAAgB,mBAAmB,OAJtB,iBACjB,SACA,MAAM,OAEiD,CAAC;CAE1D,IAAI,MAAM,cACR,MAAM,aAAa,UAAU,aAAa;MAE1C,MAAM,UAAU;CAElB,mCAAmC,KAAK;AAC1C"}
+{"version":3,"file":"coreTablesFeature.utils.js","names":[],"sources":["../../../src/core/table/coreTablesFeature.utils.ts"],"sourcesContent":["import { cloneState, functionalUpdate } 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 { TableOptions } from '../../types/TableOptions'\n\n/**\n * Synchronizes externally controlled state slices into the table's base atoms.\n *\n * This keeps legacy `options.state` values reflected in the atom graph so\n * derived atoms, stores, and table APIs read a consistent snapshot.\n *\n * @example\n * ```ts\n * table_syncExternalStateToBaseAtoms(table)\n * ```\n */\nexport function table_syncExternalStateToBaseAtoms<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): void {\n  const state = table.options.state\n  if (!state) {\n    return\n  }\n\n  table._reactivity.batch(() => {\n    for (const key in state) {\n      const baseAtom = (table.baseAtoms as Record<string, any>)[key]\n      if (!baseAtom) {\n        continue\n      }\n\n      const externalState = state[key as keyof typeof state]\n      if (externalState !== table._reactivity.untrack(() => baseAtom.get())) {\n        baseAtom.set(() => externalState)\n      }\n    }\n  })\n}\n\n/**\n * Resets all internal table base atoms to `table.initialState`, then clears\n * transient instance data through registered feature reset hooks.\n *\n * This resets internally owned state slices in a single reactivity batch. Use\n * feature-specific reset APIs when a slice may be externally owned.\n *\n * @example\n * ```ts\n * table_reset(table)\n * ```\n */\nexport function table_reset<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): void {\n  const snap = cloneState(table.initialState)\n  table._reactivity.batch(() => {\n    const keys = Object.keys(snap) as Array<keyof typeof snap>\n    for (let i = 0; i < keys.length; i++) {\n      const key = keys[i]!\n      ;(table.baseAtoms as any)[key].set(snap[key])\n    }\n  })\n\n  const features = Object.values(table._features)\n  for (let i = 0; i < features.length; i++) {\n    features[i]!.resetTableInstanceData?.(table)\n  }\n}\n\n/**\n * Merges new table options with the current resolved options.\n *\n * If `options.mergeOptions` is provided, it owns the merge behavior; otherwise\n * options are shallow-merged. Static options that should never change after\n * initialization are restored on a fresh object so framework merge helpers may\n * return readonly getter/proxy objects.\n *\n * @example\n * ```ts\n * const options = table_mergeOptions(table, nextOptions)\n * ```\n */\nexport function table_mergeOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  newOptions: TableOptions<TFeatures, TData>,\n) {\n  const { features, atoms, initialState } = table.options\n\n  // simple merge if no mergeOptions is provided - performant\n  if (!table.options.mergeOptions) {\n    return {\n      ...table.options,\n      ...newOptions,\n      features,\n      atoms,\n      initialState,\n    }\n  }\n\n  // else use the mergeOptions function and preserve getters/setters\n  const mergedOptions = table.options.mergeOptions(\n    table.options as TableOptions<TFeatures, TData>,\n    newOptions,\n  )\n  const descriptors: PropertyDescriptorMap = {\n    ...Object.getOwnPropertyDescriptors(mergedOptions),\n  }\n\n  return Object.defineProperties(\n    Object.create(Object.getPrototypeOf(mergedOptions)),\n    {\n      ...descriptors,\n      features: {\n        value: features,\n        enumerable: true,\n        configurable: true,\n        writable: true,\n      },\n      atoms: {\n        value: atoms,\n        enumerable: true,\n        configurable: true,\n        writable: true,\n      },\n      initialState: {\n        value: initialState,\n        enumerable: true,\n        configurable: true,\n        writable: true,\n      },\n    },\n  ) as TableOptions<TFeatures, TData>\n}\n\n/**\n * Updates the table options object.\n *\n * The updater receives the current resolved options and the merged result is\n * immediately assigned to the table instance.\n *\n * @example\n * ```ts\n * table_setOptions(table, (old) => old)\n * ```\n */\nexport function table_setOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  updater: Updater<TableOptions<TFeatures, TData>>,\n): void {\n  const newOptions = functionalUpdate(\n    updater,\n    table.options as TableOptions<TFeatures, TData>,\n  )\n  const mergedOptions = table_mergeOptions(table, newOptions)\n\n  if (table.optionsStore) {\n    table.optionsStore.set(() => mergedOptions)\n  } else {\n    table.options = mergedOptions\n  }\n  table_syncExternalStateToBaseAtoms(table)\n}\n"],"mappings":";;;;;;;;;;;;;;AAiBA,SAAgB,mCAGd,OAA+C;CAC/C,MAAM,QAAQ,MAAM,QAAQ;CAC5B,IAAI,CAAC,OACH;CAGF,MAAM,YAAY,YAAY;EAC5B,KAAK,MAAM,OAAO,OAAO;GACvB,MAAM,WAAY,MAAM,UAAkC;GAC1D,IAAI,CAAC,UACH;GAGF,MAAM,gBAAgB,MAAM;GAC5B,IAAI,kBAAkB,MAAM,YAAY,cAAc,SAAS,IAAI,CAAC,GAClE,SAAS,UAAU,aAAa;EAEpC;CACF,CAAC;AACH;;;;;;;;;;;;;AAcA,SAAgB,YAGd,OAA+C;CAC/C,MAAM,OAAO,WAAW,MAAM,YAAY;CAC1C,MAAM,YAAY,YAAY;EAC5B,MAAM,OAAO,OAAO,KAAK,IAAI;EAC7B,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;GACpC,MAAM,MAAM,KAAK;GAChB,AAAC,MAAM,UAAkB,IAAI,CAAC,IAAI,KAAK,IAAI;EAC9C;CACF,CAAC;CAED,MAAM,WAAW,OAAO,OAAO,MAAM,SAAS;CAC9C,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KACnC,SAAS,EAAE,CAAE,yBAAyB,KAAK;AAE/C;;;;;;;;;;;;;;AAeA,SAAgB,mBAId,OACA,YACA;CACA,MAAM,EAAE,UAAU,OAAO,iBAAiB,MAAM;CAGhD,IAAI,CAAC,MAAM,QAAQ,cACjB,OAAO;EACL,GAAG,MAAM;EACT,GAAG;EACH;EACA;EACA;CACF;CAIF,MAAM,gBAAgB,MAAM,QAAQ,aAClC,MAAM,SACN,UACF;CACA,MAAM,cAAqC,EACzC,GAAG,OAAO,0BAA0B,aAAa,EACnD;CAEA,OAAO,OAAO,iBACZ,OAAO,OAAO,OAAO,eAAe,aAAa,CAAC,GAClD;EACE,GAAG;EACH,UAAU;GACR,OAAO;GACP,YAAY;GACZ,cAAc;GACd,UAAU;EACZ;EACA,OAAO;GACL,OAAO;GACP,YAAY;GACZ,cAAc;GACd,UAAU;EACZ;EACA,cAAc;GACZ,OAAO;GACP,YAAY;GACZ,cAAc;GACd,UAAU;EACZ;CACF,CACF;AACF;;;;;;;;;;;;AAaA,SAAgB,iBAId,OACA,SACM;CAKN,MAAM,gBAAgB,mBAAmB,OAJtB,iBACjB,SACA,MAAM,OAEiD,CAAC;CAE1D,IAAI,MAAM,cACR,MAAM,aAAa,UAAU,aAAa;MAE1C,MAAM,UAAU;CAElB,mCAAmC,KAAK;AAC1C"}

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

@@ -6,6 +6,12 @@ const require_rowSelectionFeature_utils = require('./rowSelectionFeature.utils.c
 * Feature that adds row selection state and APIs for row and page selection.
 */
 const rowSelectionFeature = {
+	initTableInstanceData: (table) => {
+		table._lastSelectedRowId = null;
+	},
+	resetTableInstanceData: (table) => {
+		table._lastSelectedRowId = null;
+	},
 	getInitialState: (initialState) => {
 		return {
 			rowSelection: require_rowSelectionFeature_utils.getDefaultRowSelectionState(),
@@ -17,7 +23,12 @@ const rowSelectionFeature = {
 			onRowSelectionChange: require_utils.makeStateUpdater("rowSelection", table),
 			enableRowSelection: true,
 			enableMultiRowSelection: true,
-			enableSubRowSelection: true
+			enableRowRangeSelection: true,
+			enableSubRowSelection: true,
+			isRowRangeSelectionEvent: (event) => {
+				const rangeEvent = event;
+				return Boolean(rangeEvent.shiftKey || rangeEvent.nativeEvent?.shiftKey);
+			}
 		};
 	},
 	assignRowPrototype: (prototype, table) => {
@@ -43,7 +54,7 @@ const rowSelectionFeature = {
 			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) }
+			row_getToggleSelectedHandler: { fn: (row, opts) => require_rowSelectionFeature_utils.row_getToggleSelectedHandler(row, opts) }
 		});
 	},
 	constructTableAPIs: (table) => {

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

@@ -1 +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_getSelectedRowIds","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_getSelectedRowIds,\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 { TableFeature } from '../../types/TableFeatures'\n\n/**\n * Feature that adds row selection state and APIs for row and page selection.\n */\nexport const rowSelectionFeature: TableFeature = {\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        memoDeps: (row) => [\n          row.subRows,\n          row.table.atoms.rowSelection?.get(),\n          row.table.options.enableRowSelection,\n        ],\n      },\n      row_getIsAllSubRowsSelected: {\n        fn: (row) => row_getIsAllSubRowsSelected(row),\n        memoDeps: (row) => [\n          row.subRows,\n          row.table.atoms.rowSelection?.get(),\n          row.table.options.enableRowSelection,\n        ],\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, opts) => table_toggleAllRowsSelected(table, value, opts),\n      },\n      table_toggleAllPageRowsSelected: {\n        fn: (value, opts) =>\n          table_toggleAllPageRowsSelected(table, value, opts),\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_getSelectedRowIds: {\n        fn: () => table_getSelectedRowIds(table),\n        memoDeps: () => [table.atoms.rowSelection?.get()],\n      },\n      table_getIsAllRowsSelected: {\n        fn: () => table_getIsAllRowsSelected(table),\n        memoDeps: () => [\n          table.atoms.rowSelection?.get(),\n          table.getFilteredRowModel(),\n          table.options.enableRowSelection,\n        ],\n      },\n      table_getIsAllPageRowsSelected: {\n        fn: () => table_getIsAllPageRowsSelected(table),\n        memoDeps: () => [\n          table.atoms.rowSelection?.get(),\n          table.getPaginatedRowModel(),\n          table.options.enableRowSelection,\n        ],\n      },\n      table_getIsSomeRowsSelected: {\n        fn: () => table_getIsSomeRowsSelected(table),\n        memoDeps: () => [table.atoms.rowSelection?.get()],\n      },\n      table_getIsSomePageRowsSelected: {\n        fn: () => table_getIsSomePageRowsSelected(table),\n        memoDeps: () => [\n          table.atoms.rowSelection?.get(),\n          table.getPaginatedRowModel(),\n          table.options.enableRowSelection,\n        ],\n      },\n      table_getToggleAllRowsSelectedHandler: {\n        fn: () => table_getToggleAllRowsSelectedHandler(table),\n      },\n      table_getToggleAllPageRowsSelectedHandler: {\n        fn: () => table_getToggleAllPageRowsSelectedHandler(table),\n      },\n    })\n  },\n}\n"],"mappings":"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"}
+{"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_getSelectedRowIds","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_getSelectedRowIds,\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 { TableFeature } from '../../types/TableFeatures'\n\n/**\n * Feature that adds row selection state and APIs for row and page selection.\n */\nexport const rowSelectionFeature: TableFeature = {\n  initTableInstanceData: (table) => {\n    // @ts-ignore - _lastSelectedRowId is row selection table instance data\n    table._lastSelectedRowId = null\n  },\n\n  resetTableInstanceData: (table) => {\n    // @ts-ignore - _lastSelectedRowId is row selection table instance data\n    table._lastSelectedRowId = null\n  },\n\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      enableRowRangeSelection: true,\n      enableSubRowSelection: true,\n      isRowRangeSelectionEvent: (event) => {\n        const rangeEvent = event as {\n          shiftKey?: boolean\n          nativeEvent?: { shiftKey?: boolean }\n        }\n        return Boolean(rangeEvent.shiftKey || rangeEvent.nativeEvent?.shiftKey)\n      },\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        memoDeps: (row) => [\n          row.subRows,\n          row.table.atoms.rowSelection?.get(),\n          row.table.options.enableRowSelection,\n        ],\n      },\n      row_getIsAllSubRowsSelected: {\n        fn: (row) => row_getIsAllSubRowsSelected(row),\n        memoDeps: (row) => [\n          row.subRows,\n          row.table.atoms.rowSelection?.get(),\n          row.table.options.enableRowSelection,\n        ],\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, opts) => row_getToggleSelectedHandler(row, opts),\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, opts) => table_toggleAllRowsSelected(table, value, opts),\n      },\n      table_toggleAllPageRowsSelected: {\n        fn: (value, opts) =>\n          table_toggleAllPageRowsSelected(table, value, opts),\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_getSelectedRowIds: {\n        fn: () => table_getSelectedRowIds(table),\n        memoDeps: () => [table.atoms.rowSelection?.get()],\n      },\n      table_getIsAllRowsSelected: {\n        fn: () => table_getIsAllRowsSelected(table),\n        memoDeps: () => [\n          table.atoms.rowSelection?.get(),\n          table.getFilteredRowModel(),\n          table.options.enableRowSelection,\n        ],\n      },\n      table_getIsAllPageRowsSelected: {\n        fn: () => table_getIsAllPageRowsSelected(table),\n        memoDeps: () => [\n          table.atoms.rowSelection?.get(),\n          table.getPaginatedRowModel(),\n          table.options.enableRowSelection,\n        ],\n      },\n      table_getIsSomeRowsSelected: {\n        fn: () => table_getIsSomeRowsSelected(table),\n        memoDeps: () => [table.atoms.rowSelection?.get()],\n      },\n      table_getIsSomePageRowsSelected: {\n        fn: () => table_getIsSomePageRowsSelected(table),\n        memoDeps: () => [\n          table.atoms.rowSelection?.get(),\n          table.getPaginatedRowModel(),\n          table.options.enableRowSelection,\n        ],\n      },\n      table_getToggleAllRowsSelectedHandler: {\n        fn: () => table_getToggleAllRowsSelectedHandler(table),\n      },\n      table_getToggleAllPageRowsSelectedHandler: {\n        fn: () => table_getToggleAllPageRowsSelectedHandler(table),\n      },\n    })\n  },\n}\n"],"mappings":"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"}

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

@@ -6,6 +6,12 @@ import { getDefaultRowSelectionState, row_getCanMultiSelect, row_getCanSelect, r
 * Feature that adds row selection state and APIs for row and page selection.
 */
 const rowSelectionFeature = {
+	initTableInstanceData: (table) => {
+		table._lastSelectedRowId = null;
+	},
+	resetTableInstanceData: (table) => {
+		table._lastSelectedRowId = null;
+	},
 	getInitialState: (initialState) => {
 		return {
 			rowSelection: getDefaultRowSelectionState(),
@@ -17,7 +23,12 @@ const rowSelectionFeature = {
 			onRowSelectionChange: makeStateUpdater("rowSelection", table),
 			enableRowSelection: true,
 			enableMultiRowSelection: true,
-			enableSubRowSelection: true
+			enableRowRangeSelection: true,
+			enableSubRowSelection: true,
+			isRowRangeSelectionEvent: (event) => {
+				const rangeEvent = event;
+				return Boolean(rangeEvent.shiftKey || rangeEvent.nativeEvent?.shiftKey);
+			}
 		};
 	},
 	assignRowPrototype: (prototype, table) => {
@@ -43,7 +54,7 @@ const rowSelectionFeature = {
 			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) }
+			row_getToggleSelectedHandler: { fn: (row, opts) => row_getToggleSelectedHandler(row, opts) }
 		});
 	},
 	constructTableAPIs: (table) => {

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

@@ -1 +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_getSelectedRowIds,\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 { TableFeature } from '../../types/TableFeatures'\n\n/**\n * Feature that adds row selection state and APIs for row and page selection.\n */\nexport const rowSelectionFeature: TableFeature = {\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        memoDeps: (row) => [\n          row.subRows,\n          row.table.atoms.rowSelection?.get(),\n          row.table.options.enableRowSelection,\n        ],\n      },\n      row_getIsAllSubRowsSelected: {\n        fn: (row) => row_getIsAllSubRowsSelected(row),\n        memoDeps: (row) => [\n          row.subRows,\n          row.table.atoms.rowSelection?.get(),\n          row.table.options.enableRowSelection,\n        ],\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, opts) => table_toggleAllRowsSelected(table, value, opts),\n      },\n      table_toggleAllPageRowsSelected: {\n        fn: (value, opts) =>\n          table_toggleAllPageRowsSelected(table, value, opts),\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_getSelectedRowIds: {\n        fn: () => table_getSelectedRowIds(table),\n        memoDeps: () => [table.atoms.rowSelection?.get()],\n      },\n      table_getIsAllRowsSelected: {\n        fn: () => table_getIsAllRowsSelected(table),\n        memoDeps: () => [\n          table.atoms.rowSelection?.get(),\n          table.getFilteredRowModel(),\n          table.options.enableRowSelection,\n        ],\n      },\n      table_getIsAllPageRowsSelected: {\n        fn: () => table_getIsAllPageRowsSelected(table),\n        memoDeps: () => [\n          table.atoms.rowSelection?.get(),\n          table.getPaginatedRowModel(),\n          table.options.enableRowSelection,\n        ],\n      },\n      table_getIsSomeRowsSelected: {\n        fn: () => table_getIsSomeRowsSelected(table),\n        memoDeps: () => [table.atoms.rowSelection?.get()],\n      },\n      table_getIsSomePageRowsSelected: {\n        fn: () => table_getIsSomePageRowsSelected(table),\n        memoDeps: () => [\n          table.atoms.rowSelection?.get(),\n          table.getPaginatedRowModel(),\n          table.options.enableRowSelection,\n        ],\n      },\n      table_getToggleAllRowsSelectedHandler: {\n        fn: () => table_getToggleAllRowsSelectedHandler(table),\n      },\n      table_getToggleAllPageRowsSelectedHandler: {\n        fn: () => table_getToggleAllPageRowsSelectedHandler(table),\n      },\n    })\n  },\n}\n"],"mappings":"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"}
+{"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_getSelectedRowIds,\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 { TableFeature } from '../../types/TableFeatures'\n\n/**\n * Feature that adds row selection state and APIs for row and page selection.\n */\nexport const rowSelectionFeature: TableFeature = {\n  initTableInstanceData: (table) => {\n    // @ts-ignore - _lastSelectedRowId is row selection table instance data\n    table._lastSelectedRowId = null\n  },\n\n  resetTableInstanceData: (table) => {\n    // @ts-ignore - _lastSelectedRowId is row selection table instance data\n    table._lastSelectedRowId = null\n  },\n\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      enableRowRangeSelection: true,\n      enableSubRowSelection: true,\n      isRowRangeSelectionEvent: (event) => {\n        const rangeEvent = event as {\n          shiftKey?: boolean\n          nativeEvent?: { shiftKey?: boolean }\n        }\n        return Boolean(rangeEvent.shiftKey || rangeEvent.nativeEvent?.shiftKey)\n      },\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        memoDeps: (row) => [\n          row.subRows,\n          row.table.atoms.rowSelection?.get(),\n          row.table.options.enableRowSelection,\n        ],\n      },\n      row_getIsAllSubRowsSelected: {\n        fn: (row) => row_getIsAllSubRowsSelected(row),\n        memoDeps: (row) => [\n          row.subRows,\n          row.table.atoms.rowSelection?.get(),\n          row.table.options.enableRowSelection,\n        ],\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, opts) => row_getToggleSelectedHandler(row, opts),\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, opts) => table_toggleAllRowsSelected(table, value, opts),\n      },\n      table_toggleAllPageRowsSelected: {\n        fn: (value, opts) =>\n          table_toggleAllPageRowsSelected(table, value, opts),\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_getSelectedRowIds: {\n        fn: () => table_getSelectedRowIds(table),\n        memoDeps: () => [table.atoms.rowSelection?.get()],\n      },\n      table_getIsAllRowsSelected: {\n        fn: () => table_getIsAllRowsSelected(table),\n        memoDeps: () => [\n          table.atoms.rowSelection?.get(),\n          table.getFilteredRowModel(),\n          table.options.enableRowSelection,\n        ],\n      },\n      table_getIsAllPageRowsSelected: {\n        fn: () => table_getIsAllPageRowsSelected(table),\n        memoDeps: () => [\n          table.atoms.rowSelection?.get(),\n          table.getPaginatedRowModel(),\n          table.options.enableRowSelection,\n        ],\n      },\n      table_getIsSomeRowsSelected: {\n        fn: () => table_getIsSomeRowsSelected(table),\n        memoDeps: () => [table.atoms.rowSelection?.get()],\n      },\n      table_getIsSomePageRowsSelected: {\n        fn: () => table_getIsSomePageRowsSelected(table),\n        memoDeps: () => [\n          table.atoms.rowSelection?.get(),\n          table.getPaginatedRowModel(),\n          table.options.enableRowSelection,\n        ],\n      },\n      table_getToggleAllRowsSelectedHandler: {\n        fn: () => table_getToggleAllRowsSelectedHandler(table),\n      },\n      table_getToggleAllPageRowsSelectedHandler: {\n        fn: () => table_getToggleAllPageRowsSelectedHandler(table),\n      },\n    })\n  },\n}\n"],"mappings":"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"}

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

@@ -5,10 +5,25 @@ import { TableFeatures } from "../../types/TableFeatures.cjs";
 
 //#region src/features/row-selection/rowSelectionFeature.types.d.ts
 type RowSelectionState = Record<string, true>;
+/**
+ * Controls how toggling a row affects its descendants.
+ */
+interface ToggleSelectedOptions {
+  /**
+   * Whether selectable child rows should be toggled recursively. Defaults to
+   * `true`.
+   */
+  selectChildren?: boolean;
+}
 interface TableState_RowSelection {
   rowSelection: RowSelectionState;
 }
 interface TableOptions_RowSelection<in out TFeatures extends TableFeatures, in out TData extends RowData> {
+  /**
+   * Enables inclusive row range selection through
+   * `row.getToggleSelectedHandler()`. Defaults to `true`.
+   */
+  enableRowRangeSelection?: boolean;
   /**
    * Allows rows to be selected alongside other rows.
    *
@@ -28,6 +43,14 @@ interface TableOptions_RowSelection<in out TFeatures extends TableFeatures, in o
    * grouping features and defaults to `true`.
    */
   enableSubRowSelection?: boolean | ((row: Row<TFeatures, TData>) => boolean);
+  /**
+   * Determines whether a row-selection handler event should select or
+   * deselect the inclusive range from the most recent handler interaction.
+   *
+   * By default, events with `shiftKey` directly on the event or on
+   * `event.nativeEvent` are treated as range-selection events.
+   */
+  isRowRangeSelectionEvent?: (event: unknown) => boolean;
   /**
    * Called with an updater when row selection state changes. Pair this with
    * `state.rowSelection` when using external state; external atoms can own the
@@ -62,16 +85,23 @@ interface Row_RowSelection {
   getIsSomeSelected: () => boolean;
   /**
    * Creates a checkbox-style handler that toggles this row's selected state.
+   * Pass the original checkbox click event, or a framework event whose
+   * `nativeEvent` is that click, so Shift range selection can detect the
+   * modifier key.
    */
-  getToggleSelectedHandler: () => (event: unknown) => void;
+  getToggleSelectedHandler: (opts?: ToggleSelectedOptions) => (event: unknown) => void;
   /**
    * Selects/deselects the row.
    */
-  toggleSelected: (value?: boolean, opts?: {
-    selectChildren?: boolean;
-  }) => void;
+  toggleSelected: (value?: boolean, opts?: ToggleSelectedOptions) => void;
 }
 interface Table_RowSelection<in out TFeatures extends TableFeatures, in out TData extends RowData> {
+  /**
+   * The most recent row interacted with through the row selection handler.
+   *
+   * @internal
+   */
+  _lastSelectedRowId: string | null;
   /**
    * Builds a selected-row model from rows after filtering.
    */
@@ -140,5 +170,5 @@ interface Table_RowSelection<in out TFeatures extends TableFeatures, in out TDat
   }) => void;
 }
 //#endregion
-export { RowSelectionState, Row_RowSelection, TableOptions_RowSelection, TableState_RowSelection, Table_RowSelection };
+export { RowSelectionState, Row_RowSelection, TableOptions_RowSelection, TableState_RowSelection, Table_RowSelection, ToggleSelectedOptions };
 //# sourceMappingURL=rowSelectionFeature.types.d.cts.map