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

package/dist/features/row-pagination/rowPaginationFeature.utils.d.ts

@@ -5,20 +5,23 @@ import { Table_Internal } from "../../types/Table.js";
 
 //#region src/features/row-pagination/rowPaginationFeature.utils.d.ts
 /**
- * Returns the default pagination state.
+ * Creates the default pagination state used by the pagination feature.
  *
- * Feature constructors use this value to initialize the table state or option defaults when no user value is provided.
+ * The feature default starts at the first page with a page size of 10. Reset
+ * APIs use this value when `defaultState` is `true`.
  *
  * @example
  * ```ts
- * const initialValue = getDefaultPaginationState()
+ * const pagination = getDefaultPaginationState()
  * ```
  */
 declare function getDefaultPaginationState(): PaginationState;
 /**
- * Schedules an automatic reset for page index.
+ * Resets the page index when a page-altering change should return to page 0.
  *
- * The reset only runs when the related feature options allow automatic resets for the current table state change.
+ * The reset runs when `autoResetAll`, `autoResetPageIndex`, or the default
+ * client-side pagination behavior allows it. Manual pagination opts out unless
+ * the reset options explicitly opt back in.
  *
  * @example
  * ```ts
@@ -27,9 +30,11 @@ declare function getDefaultPaginationState(): PaginationState;
  */
 declare function table_autoResetPageIndex<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): void;
 /**
- * Updates the table's pagination state slice.
+ * Routes a pagination updater through the table's pagination change handler.
  *
- * The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.
+ * The updater may be a next state object or a function of the previous
+ * `PaginationState`; controlled state and external atoms observe the same
+ * updater path as the instance API.
  *
  * @example
  * ```ts
@@ -38,9 +43,11 @@ declare function table_autoResetPageIndex<TFeatures extends TableFeatures, TData
  */
 declare function table_setPagination<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, updater: Updater<PaginationState>): void | undefined;
 /**
- * Resets the table's pagination state slice.
+ * Resets `pagination` to the configured initial state or feature default.
  *
- * By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.
+ * With no argument, the reset clones `table.initialState.pagination` when it
+ * exists. Passing `true` ignores initial state and resets to
+ * `{ pageIndex: 0, pageSize: 10 }`.
  *
  * @example
  * ```ts
@@ -50,9 +57,10 @@ declare function table_setPagination<TFeatures extends TableFeatures, TData exte
  */
 declare function table_resetPagination<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean): void;
 /**
- * Updates the table's page index state slice.
+ * Updates `pagination.pageIndex` and clamps it to the known page range.
  *
- * The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.
+ * Unknown page counts (`undefined` or `-1`) allow any non-negative page index.
+ * Known page counts clamp the index between `0` and `pageCount - 1`.
  *
  * @example
  * ```ts
@@ -61,9 +69,10 @@ declare function table_resetPagination<TFeatures extends TableFeatures, TData ex
  */
 declare function table_setPageIndex<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, updater: Updater<number>): void;
 /**
- * Resets the table's page index state slice.
+ * Resets only `pagination.pageIndex`.
  *
- * By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.
+ * With no argument, the reset uses `table.initialState.pagination?.pageIndex`
+ * or `0`. Passing `true` always resets the page index to `0`.
  *
  * @example
  * ```ts
@@ -73,9 +82,10 @@ declare function table_setPageIndex<TFeatures extends TableFeatures, TData exten
  */
 declare function table_resetPageIndex<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean): void;
 /**
- * Resets the table's page size state slice.
+ * Resets only `pagination.pageSize`.
  *
- * By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.
+ * With no argument, the reset uses `table.initialState.pagination?.pageSize`
+ * or `10`. Passing `true` always resets the page size to `10`.
  *
  * @example
  * ```ts
@@ -85,9 +95,10 @@ declare function table_resetPageIndex<TFeatures extends TableFeatures, TData ext
  */
 declare function table_resetPageSize<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean): void;
 /**
- * Updates the table's page size state slice.
+ * Updates `pagination.pageSize` while preserving the current top row.
  *
- * The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.
+ * The new size is clamped to at least `1`, and `pageIndex` is recalculated so
+ * the row that was previously at the top of the page remains in view.
  *
  * @example
  * ```ts
@@ -96,35 +107,38 @@ declare function table_resetPageSize<TFeatures extends TableFeatures, TData exte
  */
 declare function table_setPageSize<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, updater: Updater<number>): void;
 /**
- * Returns page options for the table.
+ * Builds the zero-based page indexes available for the current page count.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * Unknown or empty page counts return an empty array; otherwise the result is
+ * `[0, 1, ...pageCount - 1]`.
  *
  * @example
  * ```ts
- * const value = table_getPageOptions(table)
+ * const pageIndexes = table_getPageOptions(table)
  * ```
  */
 declare function table_getPageOptions<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): number[];
 /**
- * Returns can previous page for the table.
+ * Checks whether the current page index can move backward.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * The first page is page index `0`, so only positive page indexes can navigate
+ * to a previous page.
  *
  * @example
  * ```ts
- * const value = table_getCanPreviousPage(table)
+ * const canGoBack = table_getCanPreviousPage(table)
  * ```
  */
 declare function table_getCanPreviousPage<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): boolean;
 /**
- * Returns can next page for the table.
+ * Checks whether the current page index can move forward.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * A `pageCount` of `-1` means the caller does not know the total page count, so
+ * this returns `true`. A page count of `0` returns `false`.
  *
  * @example
  * ```ts
- * const value = table_getCanNextPage(table)
+ * const canGoForward = table_getCanNextPage(table)
  * ```
  */
 declare function table_getCanNextPage<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): boolean;
@@ -175,24 +189,27 @@ declare function table_firstPage<TFeatures extends TableFeatures, TData extends
  */
 declare function table_lastPage<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): void;
 /**
- * Returns page count for the table.
+ * Resolves the number of pages for the current pagination state.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * `options.pageCount` wins for manual pagination. Otherwise the value is
+ * calculated from `table_getRowCount(table)` and the current `pageSize`.
  *
  * @example
  * ```ts
- * const value = table_getPageCount(table)
+ * const pages = table_getPageCount(table)
  * ```
  */
 declare function table_getPageCount<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): number;
 /**
- * Returns row count for the table.
+ * Resolves the total row count used for pagination math.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * `options.rowCount` wins for manual pagination. Otherwise the count comes
+ * from the pre-paginated row model so filtering, grouping, sorting, and
+ * expansion are reflected before the page slice is applied.
  *
  * @example
  * ```ts
- * const value = table_getRowCount(table)
+ * const rows = table_getRowCount(table)
  * ```
  */
 declare function table_getRowCount<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): number;

package/dist/features/row-pagination/rowPaginationFeature.utils.js

@@ -4,13 +4,14 @@ import { cloneState, functionalUpdate } from "../../utils.js";
 const defaultPageIndex = 0;
 const defaultPageSize = 10;
 /**
-* Returns the default pagination state.
+* Creates the default pagination state used by the pagination feature.
 *
-* Feature constructors use this value to initialize the table state or option defaults when no user value is provided.
+* The feature default starts at the first page with a page size of 10. Reset
+* APIs use this value when `defaultState` is `true`.
 *
 * @example
 * ```ts
-* const initialValue = getDefaultPaginationState()
+* const pagination = getDefaultPaginationState()
 * ```
 */
 function getDefaultPaginationState() {
@@ -20,9 +21,11 @@ function getDefaultPaginationState() {
 	};
 }
 /**
-* Schedules an automatic reset for page index.
+* Resets the page index when a page-altering change should return to page 0.
 *
-* The reset only runs when the related feature options allow automatic resets for the current table state change.
+* The reset runs when `autoResetAll`, `autoResetPageIndex`, or the default
+* client-side pagination behavior allows it. Manual pagination opts out unless
+* the reset options explicitly opt back in.
 *
 * @example
 * ```ts
@@ -33,9 +36,11 @@ function table_autoResetPageIndex(table) {
 	if (table.options.autoResetAll ?? table.options.autoResetPageIndex ?? !table.options.manualPagination) table_resetPageIndex(table);
 }
 /**
-* Updates the table's pagination state slice.
+* Routes a pagination updater through the table's pagination change handler.
 *
-* The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.
+* The updater may be a next state object or a function of the previous
+* `PaginationState`; controlled state and external atoms observe the same
+* updater path as the instance API.
 *
 * @example
 * ```ts
@@ -50,9 +55,11 @@ function table_setPagination(table, updater) {
 	return (_table$options$onPagi = (_table$options = table.options).onPaginationChange) === null || _table$options$onPagi === void 0 ? void 0 : _table$options$onPagi.call(_table$options, safeUpdater);
 }
 /**
-* Resets the table's pagination state slice.
+* Resets `pagination` to the configured initial state or feature default.
 *
-* By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.
+* With no argument, the reset clones `table.initialState.pagination` when it
+* exists. Passing `true` ignores initial state and resets to
+* `{ pageIndex: 0, pageSize: 10 }`.
 *
 * @example
 * ```ts
@@ -64,9 +71,10 @@ function table_resetPagination(table, defaultState) {
 	table_setPagination(table, defaultState ? getDefaultPaginationState() : cloneState(table.initialState.pagination ?? getDefaultPaginationState()));
 }
 /**
-* Updates the table's page index state slice.
+* Updates `pagination.pageIndex` and clamps it to the known page range.
 *
-* The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.
+* Unknown page counts (`undefined` or `-1`) allow any non-negative page index.
+* Known page counts clamp the index between `0` and `pageCount - 1`.
 *
 * @example
 * ```ts
@@ -85,9 +93,10 @@ function table_setPageIndex(table, updater) {
 	});
 }
 /**
-* Resets the table's page index state slice.
+* Resets only `pagination.pageIndex`.
 *
-* By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.
+* With no argument, the reset uses `table.initialState.pagination?.pageIndex`
+* or `0`. Passing `true` always resets the page index to `0`.
 *
 * @example
 * ```ts
@@ -103,9 +112,10 @@ function table_resetPageIndex(table, defaultState) {
 	table_setPageIndex(table, newPageIndex);
 }
 /**
-* Resets the table's page size state slice.
+* Resets only `pagination.pageSize`.
 *
-* By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.
+* With no argument, the reset uses `table.initialState.pagination?.pageSize`
+* or `10`. Passing `true` always resets the page size to `10`.
 *
 * @example
 * ```ts
@@ -121,9 +131,10 @@ function table_resetPageSize(table, defaultState) {
 	table_setPageSize(table, newPageSize);
 }
 /**
-* Updates the table's page size state slice.
+* Updates `pagination.pageSize` while preserving the current top row.
 *
-* The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.
+* The new size is clamped to at least `1`, and `pageIndex` is recalculated so
+* the row that was previously at the top of the page remains in view.
 *
 * @example
 * ```ts
@@ -143,13 +154,14 @@ function table_setPageSize(table, updater) {
 	});
 }
 /**
-* Returns page options for the table.
+* Builds the zero-based page indexes available for the current page count.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* Unknown or empty page counts return an empty array; otherwise the result is
+* `[0, 1, ...pageCount - 1]`.
 *
 * @example
 * ```ts
-* const value = table_getPageOptions(table)
+* const pageIndexes = table_getPageOptions(table)
 * ```
 */
 function table_getPageOptions(table) {
@@ -159,13 +171,14 @@ function table_getPageOptions(table) {
 	return pageOptions;
 }
 /**
-* Returns can previous page for the table.
+* Checks whether the current page index can move backward.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* The first page is page index `0`, so only positive page indexes can navigate
+* to a previous page.
 *
 * @example
 * ```ts
-* const value = table_getCanPreviousPage(table)
+* const canGoBack = table_getCanPreviousPage(table)
 * ```
 */
 function table_getCanPreviousPage(table) {
@@ -173,13 +186,14 @@ function table_getCanPreviousPage(table) {
 	return (((_table$atoms$paginati3 = table.atoms.pagination) === null || _table$atoms$paginati3 === void 0 || (_table$atoms$paginati3 = _table$atoms$paginati3.get()) === null || _table$atoms$paginati3 === void 0 ? void 0 : _table$atoms$paginati3.pageIndex) ?? 0) > 0;
 }
 /**
-* Returns can next page for the table.
+* Checks whether the current page index can move forward.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* A `pageCount` of `-1` means the caller does not know the total page count, so
+* this returns `true`. A page count of `0` returns `false`.
 *
 * @example
 * ```ts
-* const value = table_getCanNextPage(table)
+* const canGoForward = table_getCanNextPage(table)
 * ```
 */
 function table_getCanNextPage(table) {
@@ -247,13 +261,14 @@ function table_lastPage(table) {
 	return table_setPageIndex(table, table_getPageCount(table) - 1);
 }
 /**
-* Returns page count for the table.
+* Resolves the number of pages for the current pagination state.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* `options.pageCount` wins for manual pagination. Otherwise the value is
+* calculated from `table_getRowCount(table)` and the current `pageSize`.
 *
 * @example
 * ```ts
-* const value = table_getPageCount(table)
+* const pages = table_getPageCount(table)
 * ```
 */
 function table_getPageCount(table) {
@@ -261,13 +276,15 @@ function table_getPageCount(table) {
 	return table.options.pageCount ?? Math.ceil(table_getRowCount(table) / (((_table$atoms$paginati5 = table.atoms.pagination) === null || _table$atoms$paginati5 === void 0 || (_table$atoms$paginati5 = _table$atoms$paginati5.get()) === null || _table$atoms$paginati5 === void 0 ? void 0 : _table$atoms$paginati5.pageSize) ?? defaultPageSize));
 }
 /**
-* Returns row count for the table.
+* Resolves the total row count used for pagination math.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* `options.rowCount` wins for manual pagination. Otherwise the count comes
+* from the pre-paginated row model so filtering, grouping, sorting, and
+* expansion are reflected before the page slice is applied.
 *
 * @example
 * ```ts
-* const value = table_getRowCount(table)
+* const rows = table_getRowCount(table)
 * ```
 */
 function table_getRowCount(table) {

package/dist/features/row-pagination/rowPaginationFeature.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"rowPaginationFeature.utils.js","names":[],"sources":["../../../src/features/row-pagination/rowPaginationFeature.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 { PaginationState } from './rowPaginationFeature.types'\n\nconst defaultPageIndex = 0\nconst defaultPageSize = 10\n\n/**\n * Returns the default pagination state.\n *\n * Feature constructors use this value to initialize the table state or option defaults when no user value is provided.\n *\n * @example\n * ```ts\n * const initialValue = getDefaultPaginationState()\n * ```\n */\nexport function getDefaultPaginationState(): PaginationState {\n  return {\n    pageIndex: defaultPageIndex,\n    pageSize: defaultPageSize,\n  }\n}\n\n/**\n * Schedules an automatic reset for page index.\n *\n * The reset only runs when the related feature options allow automatic resets for the current table state change.\n *\n * @example\n * ```ts\n * table_autoResetPageIndex(table)\n * ```\n */\nexport function table_autoResetPageIndex<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  if (\n    table.options.autoResetAll ??\n    table.options.autoResetPageIndex ??\n    !table.options.manualPagination\n  ) {\n    table_resetPageIndex(table)\n  }\n}\n\n/**\n * Updates the table's pagination state slice.\n *\n * The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.\n *\n * @example\n * ```ts\n * table_setPagination(table, (old) => old)\n * ```\n */\nexport function table_setPagination<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, updater: Updater<PaginationState>) {\n  const safeUpdater: Updater<PaginationState> = (old) => {\n    const newState = functionalUpdate(updater, old)\n\n    return newState\n  }\n\n  return table.options.onPaginationChange?.(safeUpdater)\n}\n\n/**\n * Resets the table's pagination state slice.\n *\n * By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.\n *\n * @example\n * ```ts\n * table_resetPagination(table)\n * table_resetPagination(table, true)\n * ```\n */\nexport function table_resetPagination<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean) {\n  table_setPagination(\n    table,\n    defaultState\n      ? getDefaultPaginationState()\n      : cloneState(\n          table.initialState.pagination ?? getDefaultPaginationState(),\n        ),\n  )\n}\n\n/**\n * Updates the table's page index state slice.\n *\n * The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.\n *\n * @example\n * ```ts\n * table_setPageIndex(table, (old) => old)\n * ```\n */\nexport function table_setPageIndex<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, updater: Updater<number>) {\n  table_setPagination(table, (old) => {\n    let pageIndex = functionalUpdate(updater, old.pageIndex)\n\n    const maxPageIndex =\n      typeof table.options.pageCount === 'undefined' ||\n      table.options.pageCount === -1\n        ? Number.MAX_SAFE_INTEGER\n        : table.options.pageCount - 1\n\n    pageIndex = Math.max(0, Math.min(pageIndex, maxPageIndex))\n\n    return {\n      ...old,\n      pageIndex,\n    }\n  })\n}\n\n/**\n * Resets the table's page index state slice.\n *\n * By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.\n *\n * @example\n * ```ts\n * table_resetPageIndex(table)\n * table_resetPageIndex(table, true)\n * ```\n */\nexport function table_resetPageIndex<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean) {\n  const currentPageIndex =\n    table.atoms.pagination?.get()?.pageIndex ?? defaultPageIndex\n  const newPageIndex = defaultState\n    ? defaultPageIndex\n    : (table.initialState.pagination?.pageIndex ?? defaultPageIndex)\n  if (newPageIndex === currentPageIndex) return\n  table_setPageIndex(table, newPageIndex)\n}\n\n/**\n * Resets the table's page size state slice.\n *\n * By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.\n *\n * @example\n * ```ts\n * table_resetPageSize(table)\n * table_resetPageSize(table, true)\n * ```\n */\nexport function table_resetPageSize<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean) {\n  const currentPageSize =\n    table.atoms.pagination?.get()?.pageSize ?? defaultPageSize\n  const newPageSize = defaultState\n    ? defaultPageSize\n    : (table.initialState.pagination?.pageSize ?? defaultPageSize)\n  if (newPageSize === currentPageSize) return\n  table_setPageSize(table, newPageSize)\n}\n\n/**\n * Updates the table's page size state slice.\n *\n * The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.\n *\n * @example\n * ```ts\n * table_setPageSize(table, (old) => old)\n * ```\n */\nexport function table_setPageSize<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, updater: Updater<number>) {\n  table_setPagination(table, (old) => {\n    const pageSize = Math.max(1, functionalUpdate(updater, old.pageSize))\n    const topRowIndex = old.pageSize * old.pageIndex\n    const pageIndex = Math.floor(topRowIndex / pageSize)\n\n    return {\n      ...old,\n      pageIndex,\n      pageSize,\n    }\n  })\n}\n\n/**\n * Returns page options for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getPageOptions(table)\n * ```\n */\nexport function table_getPageOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const pageCount = table_getPageCount(table)\n  let pageOptions: Array<number> = []\n  if (pageCount && pageCount > 0) {\n    pageOptions = [...new Array(pageCount)].fill(null).map((_, i) => i)\n  }\n  return pageOptions\n}\n\n/**\n * Returns can previous page for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getCanPreviousPage(table)\n * ```\n */\nexport function table_getCanPreviousPage<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  return (table.atoms.pagination?.get()?.pageIndex ?? 0) > 0\n}\n\n/**\n * Returns can next page for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getCanNextPage(table)\n * ```\n */\nexport function table_getCanNextPage<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const pageIndex = table.atoms.pagination?.get()?.pageIndex ?? defaultPageIndex\n\n  const pageCount = table_getPageCount(table)\n\n  if (pageCount === -1) {\n    return true\n  }\n\n  if (pageCount === 0) {\n    return false\n  }\n\n  return pageIndex < pageCount - 1\n}\n\n/**\n * Moves the table to the previous page.\n *\n * This delegates to `table_setPageIndex` so pagination state ownership and\n * updater semantics remain consistent.\n *\n * @example\n * ```ts\n * table_previousPage(table)\n * ```\n */\nexport function table_previousPage<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  return table_setPageIndex(table, (old) => old - 1)\n}\n\n/**\n * Moves the table to the next page.\n *\n * This delegates to `table_setPageIndex` so pagination state ownership and\n * updater semantics remain consistent.\n *\n * @example\n * ```ts\n * table_nextPage(table)\n * ```\n */\nexport function table_nextPage<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  return table_setPageIndex(table, (old) => {\n    return old + 1\n  })\n}\n\n/**\n * Moves the table to the first page.\n *\n * This is a convenience wrapper around `table_setPageIndex(table, 0)`.\n *\n * @example\n * ```ts\n * table_firstPage(table)\n * ```\n */\nexport function table_firstPage<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  return table_setPageIndex(table, 0)\n}\n\n/**\n * Moves the table to the last known page.\n *\n * The target page is derived from `table_getPageCount(table) - 1`.\n *\n * @example\n * ```ts\n * table_lastPage(table)\n * ```\n */\nexport function table_lastPage<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  return table_setPageIndex(table, table_getPageCount(table) - 1)\n}\n\n/**\n * Returns page count for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getPageCount(table)\n * ```\n */\nexport function table_getPageCount<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  return (\n    table.options.pageCount ??\n    Math.ceil(\n      table_getRowCount(table) /\n        (table.atoms.pagination?.get()?.pageSize ?? defaultPageSize),\n    )\n  )\n}\n\n/**\n * Returns row count for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getRowCount(table)\n * ```\n */\nexport function table_getRowCount<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  return table.options.rowCount ?? table.getPrePaginatedRowModel().rows.length\n}\n"],"mappings":";;;AAMA,MAAM,mBAAmB;AACzB,MAAM,kBAAkB;;;;;;;;;;;AAYxB,SAAgB,4BAA6C;CAC3D,OAAO;EACL,WAAW;EACX,UAAU;EACX;;;;;;;;;;;;AAaH,SAAgB,yBAGd,OAAyC;CACzC,IACE,MAAM,QAAQ,gBACd,MAAM,QAAQ,sBACd,CAAC,MAAM,QAAQ,kBAEf,qBAAqB,MAAM;;;;;;;;;;;;AAc/B,SAAgB,oBAGd,OAAyC,SAAmC;;CAC5E,MAAM,eAAyC,QAAQ;EAGrD,OAFiB,iBAAiB,SAAS,IAE5B;;CAGjB,kDAAO,MAAM,SAAQ,uHAAqB,YAAY;;;;;;;;;;;;;AAcxD,SAAgB,sBAGd,OAAyC,cAAwB;CACjE,oBACE,OACA,eACI,2BAA2B,GAC3B,WACE,MAAM,aAAa,cAAc,2BAA2B,CAC7D,CACN;;;;;;;;;;;;AAaH,SAAgB,mBAGd,OAAyC,SAA0B;CACnE,oBAAoB,QAAQ,QAAQ;EAClC,IAAI,YAAY,iBAAiB,SAAS,IAAI,UAAU;EAExD,MAAM,eACJ,OAAO,MAAM,QAAQ,cAAc,eACnC,MAAM,QAAQ,cAAc,KACxB,OAAO,mBACP,MAAM,QAAQ,YAAY;EAEhC,YAAY,KAAK,IAAI,GAAG,KAAK,IAAI,WAAW,aAAa,CAAC;EAE1D,OAAO;GACL,GAAG;GACH;GACD;GACD;;;;;;;;;;;;;AAcJ,SAAgB,qBAGd,OAAyC,cAAwB;;CACjE,MAAM,6CACJ,MAAM,MAAM,2GAAY,KAAK,gFAAE,cAAa;CAC9C,MAAM,eAAe,eACjB,6CACC,MAAM,aAAa,0FAAY,cAAa;CACjD,IAAI,iBAAiB,kBAAkB;CACvC,mBAAmB,OAAO,aAAa;;;;;;;;;;;;;AAczC,SAAgB,oBAGd,OAAyC,cAAwB;;CACjE,MAAM,6CACJ,MAAM,MAAM,8GAAY,KAAK,kFAAE,aAAY;CAC7C,MAAM,cAAc,eAChB,6CACC,MAAM,aAAa,4FAAY,aAAY;CAChD,IAAI,gBAAgB,iBAAiB;CACrC,kBAAkB,OAAO,YAAY;;;;;;;;;;;;AAavC,SAAgB,kBAGd,OAAyC,SAA0B;CACnE,oBAAoB,QAAQ,QAAQ;EAClC,MAAM,WAAW,KAAK,IAAI,GAAG,iBAAiB,SAAS,IAAI,SAAS,CAAC;EACrE,MAAM,cAAc,IAAI,WAAW,IAAI;EACvC,MAAM,YAAY,KAAK,MAAM,cAAc,SAAS;EAEpD,OAAO;GACL,GAAG;GACH;GACA;GACD;GACD;;;;;;;;;;;;AAaJ,SAAgB,qBAGd,OAAyC;CACzC,MAAM,YAAY,mBAAmB,MAAM;CAC3C,IAAI,cAA6B,EAAE;CACnC,IAAI,aAAa,YAAY,GAC3B,cAAc,CAAC,GAAG,IAAI,MAAM,UAAU,CAAC,CAAC,KAAK,KAAK,CAAC,KAAK,GAAG,MAAM,EAAE;CAErE,OAAO;;;;;;;;;;;;AAaT,SAAgB,yBAGd,OAAyC;;CACzC,mCAAQ,MAAM,MAAM,8GAAY,KAAK,kFAAE,cAAa,KAAK;;;;;;;;;;;;AAa3D,SAAgB,qBAGd,OAAyC;;CACzC,MAAM,uCAAY,MAAM,MAAM,8GAAY,KAAK,kFAAE,cAAa;CAE9D,MAAM,YAAY,mBAAmB,MAAM;CAE3C,IAAI,cAAc,IAChB,OAAO;CAGT,IAAI,cAAc,GAChB,OAAO;CAGT,OAAO,YAAY,YAAY;;;;;;;;;;;;;AAcjC,SAAgB,mBAGd,OAAyC;CACzC,OAAO,mBAAmB,QAAQ,QAAQ,MAAM,EAAE;;;;;;;;;;;;;AAcpD,SAAgB,eAGd,OAAyC;CACzC,OAAO,mBAAmB,QAAQ,QAAQ;EACxC,OAAO,MAAM;GACb;;;;;;;;;;;;AAaJ,SAAgB,gBAGd,OAAyC;CACzC,OAAO,mBAAmB,OAAO,EAAE;;;;;;;;;;;;AAarC,SAAgB,eAGd,OAAyC;CACzC,OAAO,mBAAmB,OAAO,mBAAmB,MAAM,GAAG,EAAE;;;;;;;;;;;;AAajE,SAAgB,mBAGd,OAAyC;;CACzC,OACE,MAAM,QAAQ,aACd,KAAK,KACH,kBAAkB,MAAM,+BACrB,MAAM,MAAM,8GAAY,KAAK,kFAAE,aAAY,iBAC/C;;;;;;;;;;;;AAcL,SAAgB,kBAGd,OAAyC;CACzC,OAAO,MAAM,QAAQ,YAAY,MAAM,yBAAyB,CAAC,KAAK"}
+{"version":3,"file":"rowPaginationFeature.utils.js","names":[],"sources":["../../../src/features/row-pagination/rowPaginationFeature.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 { PaginationState } from './rowPaginationFeature.types'\n\nconst defaultPageIndex = 0\nconst defaultPageSize = 10\n\n/**\n * Creates the default pagination state used by the pagination feature.\n *\n * The feature default starts at the first page with a page size of 10. Reset\n * APIs use this value when `defaultState` is `true`.\n *\n * @example\n * ```ts\n * const pagination = getDefaultPaginationState()\n * ```\n */\nexport function getDefaultPaginationState(): PaginationState {\n  return {\n    pageIndex: defaultPageIndex,\n    pageSize: defaultPageSize,\n  }\n}\n\n/**\n * Resets the page index when a page-altering change should return to page 0.\n *\n * The reset runs when `autoResetAll`, `autoResetPageIndex`, or the default\n * client-side pagination behavior allows it. Manual pagination opts out unless\n * the reset options explicitly opt back in.\n *\n * @example\n * ```ts\n * table_autoResetPageIndex(table)\n * ```\n */\nexport function table_autoResetPageIndex<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  if (\n    table.options.autoResetAll ??\n    table.options.autoResetPageIndex ??\n    !table.options.manualPagination\n  ) {\n    table_resetPageIndex(table)\n  }\n}\n\n/**\n * Routes a pagination updater through the table's pagination change handler.\n *\n * The updater may be a next state object or a function of the previous\n * `PaginationState`; controlled state and external atoms observe the same\n * updater path as the instance API.\n *\n * @example\n * ```ts\n * table_setPagination(table, (old) => old)\n * ```\n */\nexport function table_setPagination<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, updater: Updater<PaginationState>) {\n  const safeUpdater: Updater<PaginationState> = (old) => {\n    const newState = functionalUpdate(updater, old)\n\n    return newState\n  }\n\n  return table.options.onPaginationChange?.(safeUpdater)\n}\n\n/**\n * Resets `pagination` to the configured initial state or feature default.\n *\n * With no argument, the reset clones `table.initialState.pagination` when it\n * exists. Passing `true` ignores initial state and resets to\n * `{ pageIndex: 0, pageSize: 10 }`.\n *\n * @example\n * ```ts\n * table_resetPagination(table)\n * table_resetPagination(table, true)\n * ```\n */\nexport function table_resetPagination<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean) {\n  table_setPagination(\n    table,\n    defaultState\n      ? getDefaultPaginationState()\n      : cloneState(\n          table.initialState.pagination ?? getDefaultPaginationState(),\n        ),\n  )\n}\n\n/**\n * Updates `pagination.pageIndex` and clamps it to the known page range.\n *\n * Unknown page counts (`undefined` or `-1`) allow any non-negative page index.\n * Known page counts clamp the index between `0` and `pageCount - 1`.\n *\n * @example\n * ```ts\n * table_setPageIndex(table, (old) => old)\n * ```\n */\nexport function table_setPageIndex<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, updater: Updater<number>) {\n  table_setPagination(table, (old) => {\n    let pageIndex = functionalUpdate(updater, old.pageIndex)\n\n    const maxPageIndex =\n      typeof table.options.pageCount === 'undefined' ||\n      table.options.pageCount === -1\n        ? Number.MAX_SAFE_INTEGER\n        : table.options.pageCount - 1\n\n    pageIndex = Math.max(0, Math.min(pageIndex, maxPageIndex))\n\n    return {\n      ...old,\n      pageIndex,\n    }\n  })\n}\n\n/**\n * Resets only `pagination.pageIndex`.\n *\n * With no argument, the reset uses `table.initialState.pagination?.pageIndex`\n * or `0`. Passing `true` always resets the page index to `0`.\n *\n * @example\n * ```ts\n * table_resetPageIndex(table)\n * table_resetPageIndex(table, true)\n * ```\n */\nexport function table_resetPageIndex<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean) {\n  const currentPageIndex =\n    table.atoms.pagination?.get()?.pageIndex ?? defaultPageIndex\n  const newPageIndex = defaultState\n    ? defaultPageIndex\n    : (table.initialState.pagination?.pageIndex ?? defaultPageIndex)\n  if (newPageIndex === currentPageIndex) return\n  table_setPageIndex(table, newPageIndex)\n}\n\n/**\n * Resets only `pagination.pageSize`.\n *\n * With no argument, the reset uses `table.initialState.pagination?.pageSize`\n * or `10`. Passing `true` always resets the page size to `10`.\n *\n * @example\n * ```ts\n * table_resetPageSize(table)\n * table_resetPageSize(table, true)\n * ```\n */\nexport function table_resetPageSize<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean) {\n  const currentPageSize =\n    table.atoms.pagination?.get()?.pageSize ?? defaultPageSize\n  const newPageSize = defaultState\n    ? defaultPageSize\n    : (table.initialState.pagination?.pageSize ?? defaultPageSize)\n  if (newPageSize === currentPageSize) return\n  table_setPageSize(table, newPageSize)\n}\n\n/**\n * Updates `pagination.pageSize` while preserving the current top row.\n *\n * The new size is clamped to at least `1`, and `pageIndex` is recalculated so\n * the row that was previously at the top of the page remains in view.\n *\n * @example\n * ```ts\n * table_setPageSize(table, (old) => old)\n * ```\n */\nexport function table_setPageSize<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, updater: Updater<number>) {\n  table_setPagination(table, (old) => {\n    const pageSize = Math.max(1, functionalUpdate(updater, old.pageSize))\n    const topRowIndex = old.pageSize * old.pageIndex\n    const pageIndex = Math.floor(topRowIndex / pageSize)\n\n    return {\n      ...old,\n      pageIndex,\n      pageSize,\n    }\n  })\n}\n\n/**\n * Builds the zero-based page indexes available for the current page count.\n *\n * Unknown or empty page counts return an empty array; otherwise the result is\n * `[0, 1, ...pageCount - 1]`.\n *\n * @example\n * ```ts\n * const pageIndexes = table_getPageOptions(table)\n * ```\n */\nexport function table_getPageOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const pageCount = table_getPageCount(table)\n  let pageOptions: Array<number> = []\n  if (pageCount && pageCount > 0) {\n    pageOptions = [...new Array(pageCount)].fill(null).map((_, i) => i)\n  }\n  return pageOptions\n}\n\n/**\n * Checks whether the current page index can move backward.\n *\n * The first page is page index `0`, so only positive page indexes can navigate\n * to a previous page.\n *\n * @example\n * ```ts\n * const canGoBack = table_getCanPreviousPage(table)\n * ```\n */\nexport function table_getCanPreviousPage<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  return (table.atoms.pagination?.get()?.pageIndex ?? 0) > 0\n}\n\n/**\n * Checks whether the current page index can move forward.\n *\n * A `pageCount` of `-1` means the caller does not know the total page count, so\n * this returns `true`. A page count of `0` returns `false`.\n *\n * @example\n * ```ts\n * const canGoForward = table_getCanNextPage(table)\n * ```\n */\nexport function table_getCanNextPage<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const pageIndex = table.atoms.pagination?.get()?.pageIndex ?? defaultPageIndex\n\n  const pageCount = table_getPageCount(table)\n\n  if (pageCount === -1) {\n    return true\n  }\n\n  if (pageCount === 0) {\n    return false\n  }\n\n  return pageIndex < pageCount - 1\n}\n\n/**\n * Moves the table to the previous page.\n *\n * This delegates to `table_setPageIndex` so pagination state ownership and\n * updater semantics remain consistent.\n *\n * @example\n * ```ts\n * table_previousPage(table)\n * ```\n */\nexport function table_previousPage<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  return table_setPageIndex(table, (old) => old - 1)\n}\n\n/**\n * Moves the table to the next page.\n *\n * This delegates to `table_setPageIndex` so pagination state ownership and\n * updater semantics remain consistent.\n *\n * @example\n * ```ts\n * table_nextPage(table)\n * ```\n */\nexport function table_nextPage<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  return table_setPageIndex(table, (old) => {\n    return old + 1\n  })\n}\n\n/**\n * Moves the table to the first page.\n *\n * This is a convenience wrapper around `table_setPageIndex(table, 0)`.\n *\n * @example\n * ```ts\n * table_firstPage(table)\n * ```\n */\nexport function table_firstPage<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  return table_setPageIndex(table, 0)\n}\n\n/**\n * Moves the table to the last known page.\n *\n * The target page is derived from `table_getPageCount(table) - 1`.\n *\n * @example\n * ```ts\n * table_lastPage(table)\n * ```\n */\nexport function table_lastPage<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  return table_setPageIndex(table, table_getPageCount(table) - 1)\n}\n\n/**\n * Resolves the number of pages for the current pagination state.\n *\n * `options.pageCount` wins for manual pagination. Otherwise the value is\n * calculated from `table_getRowCount(table)` and the current `pageSize`.\n *\n * @example\n * ```ts\n * const pages = table_getPageCount(table)\n * ```\n */\nexport function table_getPageCount<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  return (\n    table.options.pageCount ??\n    Math.ceil(\n      table_getRowCount(table) /\n        (table.atoms.pagination?.get()?.pageSize ?? defaultPageSize),\n    )\n  )\n}\n\n/**\n * Resolves the total row count used for pagination math.\n *\n * `options.rowCount` wins for manual pagination. Otherwise the count comes\n * from the pre-paginated row model so filtering, grouping, sorting, and\n * expansion are reflected before the page slice is applied.\n *\n * @example\n * ```ts\n * const rows = table_getRowCount(table)\n * ```\n */\nexport function table_getRowCount<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  return table.options.rowCount ?? table.getPrePaginatedRowModel().rows.length\n}\n"],"mappings":"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"}

package/dist/features/row-pinning/rowPinningFeature.types.d.cts

@@ -13,7 +13,9 @@ interface TableState_RowPinning {
 }
 interface TableOptions_RowPinning<TFeatures extends TableFeatures, TData extends RowData> {
   /**
-   * Enables/disables row pinning for the table. Defaults to `true`.
+   * Allows rows to be pinned to top or bottom regions.
+   *
+   * Provide a predicate to decide per row. Defaults to `true`.
    */
   enableRowPinning?: boolean | ((row: Row<TFeatures, TData>) => boolean);
   /**
@@ -32,7 +34,7 @@ interface RowPinningDefaultOptions {
 }
 interface Row_RowPinning {
   /**
-   * Returns whether or not the row can be pinned.
+   * Checks whether this row can be pinned.
    */
   getCanPin: () => boolean;
   /**
@@ -50,27 +52,29 @@ interface Row_RowPinning {
 }
 interface Table_RowPinning<TFeatures extends TableFeatures, TData extends RowData> {
   /**
-   * Returns all bottom pinned rows.
+   * Gets rows pinned to the bottom region.
    */
   getBottomRows: () => Array<Row<TFeatures, TData>>;
   /**
-   * Returns all rows that are not pinned to the top or bottom.
+   * Gets rows that are not pinned to the top or bottom region.
    */
   getCenterRows: () => Array<Row<TFeatures, TData>>;
   /**
-   * Returns whether or not any rows are pinned. Optionally specify to only check for pinned rows in either the `top` or `bottom` position.
+   * Checks whether any rows are pinned, optionally limited to one region.
    */
   getIsSomeRowsPinned: (position?: RowPinningPosition) => boolean;
   /**
-   * Returns all top pinned rows.
+   * Gets rows pinned to the top region.
    */
   getTopRows: () => Array<Row<TFeatures, TData>>;
   /**
-   * Resets the **rowPinning** state to `initialState.rowPinning`, or `true` can be passed to force a default blank state reset to `{ top: [], bottom: [], }`.
+   * Resets `rowPinning` to `initialState.rowPinning`.
+   *
+   * Pass `true` to ignore initial state and reset to empty top/bottom arrays.
    */
   resetRowPinning: (defaultState?: boolean) => void;
   /**
-   * Sets row pinning state using a value or updater.
+   * Updates row pinning state with a next state or updater function.
    */
   setRowPinning: (updater: Updater<RowPinningState>) => void;
 }

package/dist/features/row-pinning/rowPinningFeature.types.d.ts

@@ -13,7 +13,9 @@ interface TableState_RowPinning {
 }
 interface TableOptions_RowPinning<TFeatures extends TableFeatures, TData extends RowData> {
   /**
-   * Enables/disables row pinning for the table. Defaults to `true`.
+   * Allows rows to be pinned to top or bottom regions.
+   *
+   * Provide a predicate to decide per row. Defaults to `true`.
    */
   enableRowPinning?: boolean | ((row: Row<TFeatures, TData>) => boolean);
   /**
@@ -32,7 +34,7 @@ interface RowPinningDefaultOptions {
 }
 interface Row_RowPinning {
   /**
-   * Returns whether or not the row can be pinned.
+   * Checks whether this row can be pinned.
    */
   getCanPin: () => boolean;
   /**
@@ -50,27 +52,29 @@ interface Row_RowPinning {
 }
 interface Table_RowPinning<TFeatures extends TableFeatures, TData extends RowData> {
   /**
-   * Returns all bottom pinned rows.
+   * Gets rows pinned to the bottom region.
    */
   getBottomRows: () => Array<Row<TFeatures, TData>>;
   /**
-   * Returns all rows that are not pinned to the top or bottom.
+   * Gets rows that are not pinned to the top or bottom region.
    */
   getCenterRows: () => Array<Row<TFeatures, TData>>;
   /**
-   * Returns whether or not any rows are pinned. Optionally specify to only check for pinned rows in either the `top` or `bottom` position.
+   * Checks whether any rows are pinned, optionally limited to one region.
    */
   getIsSomeRowsPinned: (position?: RowPinningPosition) => boolean;
   /**
-   * Returns all top pinned rows.
+   * Gets rows pinned to the top region.
    */
   getTopRows: () => Array<Row<TFeatures, TData>>;
   /**
-   * Resets the **rowPinning** state to `initialState.rowPinning`, or `true` can be passed to force a default blank state reset to `{ top: [], bottom: [], }`.
+   * Resets `rowPinning` to `initialState.rowPinning`.
+   *
+   * Pass `true` to ignore initial state and reset to empty top/bottom arrays.
    */
   resetRowPinning: (defaultState?: boolean) => void;
   /**
-   * Sets row pinning state using a value or updater.
+   * Updates row pinning state with a next state or updater function.
    */
   setRowPinning: (updater: Updater<RowPinningState>) => void;
 }