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

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

@@ -0,0 +1,99 @@
+import { RowData } from "../../types/type-utils.cjs";
+import { Row } from "../../types/Row.cjs";
+import { Table_Internal } from "../../types/Table.cjs";
+import { TableFeatures } from "../../types/TableFeatures.cjs";
+import { Cell } from "../../types/Cell.cjs";
+
+//#region src/core/rows/coreRowsFeature.types.d.ts
+interface Row_CoreProperties<TFeatures extends TableFeatures, TData extends RowData> {
+  _uniqueValuesCache: Record<string, unknown>;
+  _valuesCache: Record<string, unknown>;
+  /**
+   * The depth of the row (if nested or grouped) relative to the root row array.
+   */
+  depth: number;
+  /**
+   * The resolved unique identifier for the row resolved via the `options.getRowId` option. Defaults to the row's index (or relative index if it is a subRow).
+   */
+  id: string;
+  /**
+   * The index of the row within its parent array (or the root data array).
+   */
+  index: number;
+  /**
+   * The original row object provided to the table. If the row is a grouped row, the original row object will be the first original in the group.
+   */
+  original: TData;
+  /**
+   * An array of the original subRows as returned by the `options.getSubRows` option.
+   */
+  originalSubRows?: ReadonlyArray<TData>;
+  /**
+   * If nested, this row's parent row id.
+   */
+  parentId?: string;
+  /**
+   * An array of subRows for the row as returned and created by the `options.getSubRows` option.
+   */
+  subRows: Array<Row<TFeatures, TData>>;
+  /**
+   * Reference to the parent table instance.
+   */
+  table: Table_Internal<TFeatures, TData>;
+}
+interface Row_Row<TFeatures extends TableFeatures, TData extends RowData> extends Row_CoreProperties<TFeatures, TData> {
+  /**
+   * Builds a lookup of this row's cells keyed by leaf column id.
+   */
+  getAllCellsByColumnId: () => Record<string, Cell<TFeatures, TData, unknown>>;
+  /**
+   * Builds one cell for each leaf column, including cells for hidden columns.
+   */
+  getAllCells: () => Array<Cell<TFeatures, TData, unknown>>;
+  /**
+   * Returns the leaf rows for the row, not including any parent rows.
+   */
+  getLeafRows: () => Array<Row<TFeatures, TData>>;
+  /**
+   * Returns the parent row for the row, if it exists.
+   */
+  getParentRow: () => Row<TFeatures, TData> | undefined;
+  /**
+   * Returns the parent rows for the row, all the way up to a root row.
+   */
+  getParentRows: () => Array<Row<TFeatures, TData>>;
+  /**
+   * Reads the values this row contributes to faceting/grouping for a column.
+   */
+  getUniqueValues: <TValue>(columnId: string) => Array<TValue>;
+  /**
+   * Reads this row's accessor value for a column id and caches the result.
+   */
+  getValue: <TValue>(columnId: string) => TValue;
+  /**
+   * Renders the value for the row in a given columnId the same as `getValue`, but will return the `renderFallbackValue` if no value is found.
+   */
+  renderValue: <TValue>(columnId: string) => TValue;
+}
+interface TableOptions_Rows<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * This optional function is used to derive a unique ID for any given row. If not provided the rows index is used (nested rows join together with `.` using their grandparents' index eg. `index.index.index`). If you need to identify individual rows that are originating from any server-side operations, it's suggested you use this function to return an ID that makes sense regardless of network IO/ambiguity eg. a userId, taskId, database ID field, etc.
+   * @example getRowId: row => row.userId
+   */
+  getRowId?: (originalRow: TData, index: number, parent?: Row<TFeatures, TData>) => string;
+  /**
+   * This optional function is used to access the sub rows for any given row. If you are using nested rows, you will need to use this function to return the sub rows object (or undefined) from the row.
+   * @example getSubRows: row => row.subRows
+   */
+  getSubRows?: (originalRow: TData, index: number) => undefined | ReadonlyArray<TData>;
+}
+interface Table_Rows<TFeatures extends TableFeatures, TData extends RowData> {
+  getRowId: (_: TData, index: number, parent?: Row<TFeatures, TData>) => string;
+  /**
+   * Returns the row with the given ID.
+   */
+  getRow: (id: string, searchAll?: boolean) => Row<TFeatures, TData>;
+}
+//#endregion
+export { Row_CoreProperties, Row_Row, TableOptions_Rows, Table_Rows };
+//# sourceMappingURL=coreRowsFeature.types.d.cts.map

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

@@ -0,0 +1,99 @@
+import { RowData } from "../../types/type-utils.js";
+import { Row } from "../../types/Row.js";
+import { Table_Internal } from "../../types/Table.js";
+import { TableFeatures } from "../../types/TableFeatures.js";
+import { Cell } from "../../types/Cell.js";
+
+//#region src/core/rows/coreRowsFeature.types.d.ts
+interface Row_CoreProperties<TFeatures extends TableFeatures, TData extends RowData> {
+  _uniqueValuesCache: Record<string, unknown>;
+  _valuesCache: Record<string, unknown>;
+  /**
+   * The depth of the row (if nested or grouped) relative to the root row array.
+   */
+  depth: number;
+  /**
+   * The resolved unique identifier for the row resolved via the `options.getRowId` option. Defaults to the row's index (or relative index if it is a subRow).
+   */
+  id: string;
+  /**
+   * The index of the row within its parent array (or the root data array).
+   */
+  index: number;
+  /**
+   * The original row object provided to the table. If the row is a grouped row, the original row object will be the first original in the group.
+   */
+  original: TData;
+  /**
+   * An array of the original subRows as returned by the `options.getSubRows` option.
+   */
+  originalSubRows?: ReadonlyArray<TData>;
+  /**
+   * If nested, this row's parent row id.
+   */
+  parentId?: string;
+  /**
+   * An array of subRows for the row as returned and created by the `options.getSubRows` option.
+   */
+  subRows: Array<Row<TFeatures, TData>>;
+  /**
+   * Reference to the parent table instance.
+   */
+  table: Table_Internal<TFeatures, TData>;
+}
+interface Row_Row<TFeatures extends TableFeatures, TData extends RowData> extends Row_CoreProperties<TFeatures, TData> {
+  /**
+   * Builds a lookup of this row's cells keyed by leaf column id.
+   */
+  getAllCellsByColumnId: () => Record<string, Cell<TFeatures, TData, unknown>>;
+  /**
+   * Builds one cell for each leaf column, including cells for hidden columns.
+   */
+  getAllCells: () => Array<Cell<TFeatures, TData, unknown>>;
+  /**
+   * Returns the leaf rows for the row, not including any parent rows.
+   */
+  getLeafRows: () => Array<Row<TFeatures, TData>>;
+  /**
+   * Returns the parent row for the row, if it exists.
+   */
+  getParentRow: () => Row<TFeatures, TData> | undefined;
+  /**
+   * Returns the parent rows for the row, all the way up to a root row.
+   */
+  getParentRows: () => Array<Row<TFeatures, TData>>;
+  /**
+   * Reads the values this row contributes to faceting/grouping for a column.
+   */
+  getUniqueValues: <TValue>(columnId: string) => Array<TValue>;
+  /**
+   * Reads this row's accessor value for a column id and caches the result.
+   */
+  getValue: <TValue>(columnId: string) => TValue;
+  /**
+   * Renders the value for the row in a given columnId the same as `getValue`, but will return the `renderFallbackValue` if no value is found.
+   */
+  renderValue: <TValue>(columnId: string) => TValue;
+}
+interface TableOptions_Rows<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * This optional function is used to derive a unique ID for any given row. If not provided the rows index is used (nested rows join together with `.` using their grandparents' index eg. `index.index.index`). If you need to identify individual rows that are originating from any server-side operations, it's suggested you use this function to return an ID that makes sense regardless of network IO/ambiguity eg. a userId, taskId, database ID field, etc.
+   * @example getRowId: row => row.userId
+   */
+  getRowId?: (originalRow: TData, index: number, parent?: Row<TFeatures, TData>) => string;
+  /**
+   * This optional function is used to access the sub rows for any given row. If you are using nested rows, you will need to use this function to return the sub rows object (or undefined) from the row.
+   * @example getSubRows: row => row.subRows
+   */
+  getSubRows?: (originalRow: TData, index: number) => undefined | ReadonlyArray<TData>;
+}
+interface Table_Rows<TFeatures extends TableFeatures, TData extends RowData> {
+  getRowId: (_: TData, index: number, parent?: Row<TFeatures, TData>) => string;
+  /**
+   * Returns the row with the given ID.
+   */
+  getRow: (id: string, searchAll?: boolean) => Row<TFeatures, TData>;
+}
+//#endregion
+export { Row_CoreProperties, Row_Row, TableOptions_Rows, Table_Rows };
+//# sourceMappingURL=coreRowsFeature.types.d.ts.map

package/dist/core/rows/coreRowsFeature.utils.cjs

@@ -0,0 +1,192 @@
+const require_utils = require('../../utils.cjs');
+const require_constructCell = require('../cells/constructCell.cjs');
+
+//#region src/core/rows/coreRowsFeature.utils.ts
+/**
+* Reads and caches this row's value for a column.
+*
+* The value is produced by the column accessor. Missing columns or display
+* columns without an accessor return `undefined`.
+*
+* @example
+* ```ts
+* const firstName = row_getValue(row, 'firstName')
+* ```
+*/
+function row_getValue(row, columnId) {
+	if (row._valuesCache.hasOwnProperty(columnId)) return row._valuesCache[columnId];
+	const column = row.table.getColumn(columnId);
+	if (!(column === null || column === void 0 ? void 0 : column.accessorFn)) return;
+	row._valuesCache[columnId] = column.accessorFn(row.original, row.index);
+	return row._valuesCache[columnId];
+}
+/**
+* Reads and caches the values used by faceting/grouping for a column.
+*
+* If the column defines `getUniqueValues`, that result is used. Otherwise the
+* row's accessor value is wrapped in a single-item array.
+*
+* @example
+* ```ts
+* const values = row_getUniqueValues(row, 'tags')
+* ```
+*/
+function row_getUniqueValues(row, columnId) {
+	if (row._uniqueValuesCache.hasOwnProperty(columnId)) return row._uniqueValuesCache[columnId];
+	const column = row.table.getColumn(columnId);
+	if (!(column === null || column === void 0 ? void 0 : column.accessorFn)) return;
+	if (!column.columnDef.getUniqueValues) {
+		row._uniqueValuesCache[columnId] = [row.getValue(columnId)];
+		return row._uniqueValuesCache[columnId];
+	}
+	row._uniqueValuesCache[columnId] = column.columnDef.getUniqueValues(row.original, row.index);
+	return row._uniqueValuesCache[columnId];
+}
+/**
+* Returns a renderable row value for a column.
+*
+* If the accessor value is nullish, the table's `renderFallbackValue` is used
+* instead.
+*
+* @example
+* ```ts
+* const value = row_renderValue(row, 'firstName')
+* ```
+*/
+function row_renderValue(row, columnId) {
+	return row.getValue(columnId) ?? row.table.options.renderFallbackValue;
+}
+/**
+* Flattens this row's descendant tree into leaf rows.
+*
+* The row itself is not included; only nested `subRows` are walked.
+*
+* @example
+* ```ts
+* const descendants = row_getLeafRows(row)
+* ```
+*/
+function row_getLeafRows(row) {
+	return require_utils.flattenBy(row.subRows, (d) => d.subRows);
+}
+/**
+* Looks up this row's direct parent, if it has one.
+*
+* Parent lookup searches the pre-pagination row model so parent relationships
+* are available even when the parent is not on the current page.
+*
+* @example
+* ```ts
+* const parent = row_getParentRow(row)
+* ```
+*/
+function row_getParentRow(row) {
+	return row.parentId ? row.table.getRow(row.parentId, true) : void 0;
+}
+/**
+* Collects this row's ancestor chain from root to direct parent.
+*
+* The current row is not included. Rows without a parent return an empty array.
+*
+* @example
+* ```ts
+* const ancestors = row_getParentRows(row)
+* ```
+*/
+function row_getParentRows(row) {
+	const parentRows = [];
+	let currentRow = row;
+	while (true) {
+		const parentRow = currentRow.getParentRow();
+		if (!parentRow) break;
+		parentRows.push(parentRow);
+		currentRow = parentRow;
+	}
+	return parentRows.reverse();
+}
+/**
+* Constructs one cell for each leaf column in this row.
+*
+* The result follows `table.getAllLeafColumns()` order and includes hidden
+* columns; visibility-specific APIs filter this list later.
+*
+* @example
+* ```ts
+* const cells = row_getAllCells(row)
+* ```
+*/
+function row_getAllCells(row) {
+	const columns = row.table.getAllLeafColumns();
+	const cells = new Array(columns.length);
+	for (let i = 0; i < columns.length; i++) cells[i] = require_constructCell.constructCell(columns[i], row, row.table);
+	return cells;
+}
+/**
+* Builds a lookup map of this row's cells keyed by column id.
+*
+* This is the static implementation behind `row.getAllCellsByColumnId()`.
+*
+* @example
+* ```ts
+* const cellsById = row_getAllCellsByColumnId(row)
+* ```
+*/
+function row_getAllCellsByColumnId(row) {
+	const result = {};
+	const cells = row.getAllCells();
+	for (let i = 0; i < cells.length; i++) {
+		const cell = cells[i];
+		result[cell.column.id] = cell;
+	}
+	return result;
+}
+/**
+* Resolves the stable id for a row.
+*
+* `options.getRowId` wins when provided. Otherwise root rows use their index
+* and child rows append their index to the parent id, such as `0.2`.
+*
+* @example
+* ```ts
+* const id = table_getRowId(originalRow, table, index, parentRow)
+* ```
+*/
+function table_getRowId(originalRow, table, index, parent) {
+	var _table$options$getRow, _table$options;
+	return ((_table$options$getRow = (_table$options = table.options).getRowId) === null || _table$options$getRow === void 0 ? void 0 : _table$options$getRow.call(_table$options, originalRow, index, parent)) ?? `${parent ? [parent.id, index].join(".") : index}`;
+}
+/**
+* Looks up a row by id from the current or full row model.
+*
+* By default this searches `table.getRowModel()`. Passing `searchAll` searches
+* the pre-pagination model first, then falls back to the core model.
+*
+* @example
+* ```ts
+* const row = table_getRow(table, rowId, true)
+* ```
+*/
+function table_getRow(table, rowId, searchAll) {
+	let row = (searchAll ? table.getPrePaginatedRowModel() : table.getRowModel()).rowsById[rowId];
+	if (!row) {
+		row = table.getCoreRowModel().rowsById[rowId];
+		if (!row) {
+			if (process.env.NODE_ENV === "development") throw new Error(`getRow could not find row with ID: ${rowId}`);
+			throw new Error();
+		}
+	}
+	return row;
+}
+
+//#endregion
+exports.row_getAllCells = row_getAllCells;
+exports.row_getAllCellsByColumnId = row_getAllCellsByColumnId;
+exports.row_getLeafRows = row_getLeafRows;
+exports.row_getParentRow = row_getParentRow;
+exports.row_getParentRows = row_getParentRows;
+exports.row_getUniqueValues = row_getUniqueValues;
+exports.row_getValue = row_getValue;
+exports.row_renderValue = row_renderValue;
+exports.table_getRow = table_getRow;
+exports.table_getRowId = table_getRowId;
+//# sourceMappingURL=coreRowsFeature.utils.cjs.map

package/dist/core/rows/coreRowsFeature.utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"coreRowsFeature.utils.cjs","names":["flattenBy","constructCell"],"sources":["../../../src/core/rows/coreRowsFeature.utils.ts"],"sourcesContent":["import { flattenBy } from '../../utils'\nimport { constructCell } from '../cells/constructCell'\nimport type { Table_Internal } from '../../types/Table'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Row } from '../../types/Row'\nimport type { Cell } from '../../types/Cell'\n\n/**\n * Reads and caches this row's value for a column.\n *\n * The value is produced by the column accessor. Missing columns or display\n * columns without an accessor return `undefined`.\n *\n * @example\n * ```ts\n * const firstName = row_getValue(row, 'firstName')\n * ```\n */\nexport function row_getValue<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>, columnId: string) {\n  if (row._valuesCache.hasOwnProperty(columnId)) {\n    return row._valuesCache[columnId]\n  }\n\n  const column = row.table.getColumn(columnId)\n\n  if (!column?.accessorFn) {\n    return undefined\n  }\n\n  row._valuesCache[columnId] = column.accessorFn(row.original, row.index)\n\n  return row._valuesCache[columnId]\n}\n\n/**\n * Reads and caches the values used by faceting/grouping for a column.\n *\n * If the column defines `getUniqueValues`, that result is used. Otherwise the\n * row's accessor value is wrapped in a single-item array.\n *\n * @example\n * ```ts\n * const values = row_getUniqueValues(row, 'tags')\n * ```\n */\nexport function row_getUniqueValues<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>, columnId: string) {\n  if (row._uniqueValuesCache.hasOwnProperty(columnId)) {\n    return row._uniqueValuesCache[columnId]\n  }\n\n  const column = row.table.getColumn(columnId)\n\n  if (!column?.accessorFn) {\n    return undefined\n  }\n\n  if (!column.columnDef.getUniqueValues) {\n    row._uniqueValuesCache[columnId] = [row.getValue(columnId)]\n    return row._uniqueValuesCache[columnId]\n  }\n\n  row._uniqueValuesCache[columnId] = column.columnDef.getUniqueValues(\n    row.original,\n    row.index,\n  )\n\n  return row._uniqueValuesCache[columnId]\n}\n\n/**\n * Returns a renderable row value for a column.\n *\n * If the accessor value is nullish, the table's `renderFallbackValue` is used\n * instead.\n *\n * @example\n * ```ts\n * const value = row_renderValue(row, 'firstName')\n * ```\n */\nexport function row_renderValue<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>, columnId: string) {\n  return row.getValue(columnId) ?? row.table.options.renderFallbackValue\n}\n\n/**\n * Flattens this row's descendant tree into leaf rows.\n *\n * The row itself is not included; only nested `subRows` are walked.\n *\n * @example\n * ```ts\n * const descendants = row_getLeafRows(row)\n * ```\n */\nexport function row_getLeafRows<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>): Array<Row<TFeatures, TData>> {\n  return flattenBy(row.subRows, (d) => d.subRows)\n}\n\n/**\n * Looks up this row's direct parent, if it has one.\n *\n * Parent lookup searches the pre-pagination row model so parent relationships\n * are available even when the parent is not on the current page.\n *\n * @example\n * ```ts\n * const parent = row_getParentRow(row)\n * ```\n */\nexport function row_getParentRow<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>) {\n  return row.parentId ? row.table.getRow(row.parentId, true) : undefined\n}\n\n/**\n * Collects this row's ancestor chain from root to direct parent.\n *\n * The current row is not included. Rows without a parent return an empty array.\n *\n * @example\n * ```ts\n * const ancestors = row_getParentRows(row)\n * ```\n */\nexport function row_getParentRows<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>) {\n  const parentRows: Array<Row<TFeatures, TData>> = []\n  let currentRow = row\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  while (true) {\n    const parentRow = currentRow.getParentRow()\n    if (!parentRow) break\n    parentRows.push(parentRow)\n    currentRow = parentRow\n  }\n  return parentRows.reverse()\n}\n\n/**\n * Constructs one cell for each leaf column in this row.\n *\n * The result follows `table.getAllLeafColumns()` order and includes hidden\n * columns; visibility-specific APIs filter this list later.\n *\n * @example\n * ```ts\n * const cells = row_getAllCells(row)\n * ```\n */\nexport function row_getAllCells<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>): Array<Cell<TFeatures, TData, unknown>> {\n  const columns = row.table.getAllLeafColumns()\n  const cells: Array<Cell<TFeatures, TData, unknown>> = new Array(\n    columns.length,\n  )\n  for (let i = 0; i < columns.length; i++) {\n    cells[i] = constructCell(columns[i]!, row, row.table)\n  }\n  return cells\n}\n\n/**\n * Builds a lookup map of this row's cells keyed by column id.\n *\n * This is the static implementation behind `row.getAllCellsByColumnId()`.\n *\n * @example\n * ```ts\n * const cellsById = row_getAllCellsByColumnId(row)\n * ```\n */\nexport function row_getAllCellsByColumnId<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(row: Row<TFeatures, TData>) {\n  const result: Record<string, Cell<TFeatures, TData, unknown>> = {}\n  const cells = row.getAllCells()\n  for (let i = 0; i < cells.length; i++) {\n    const cell = cells[i]!\n    result[cell.column.id] = cell\n  }\n  return result\n}\n\n/**\n * Resolves the stable id for a row.\n *\n * `options.getRowId` wins when provided. Otherwise root rows use their index\n * and child rows append their index to the parent id, such as `0.2`.\n *\n * @example\n * ```ts\n * const id = table_getRowId(originalRow, table, index, parentRow)\n * ```\n */\nexport function table_getRowId<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  originalRow: TData,\n  table: Table_Internal<TFeatures, TData>,\n  index: number,\n  parent?: Row<TFeatures, TData>,\n) {\n  return (\n    table.options.getRowId?.(originalRow, index, parent) ??\n    `${parent ? [parent.id, index].join('.') : index}`\n  )\n}\n\n/**\n * Looks up a row by id from the current or full row model.\n *\n * By default this searches `table.getRowModel()`. Passing `searchAll` searches\n * the pre-pagination model first, then falls back to the core model.\n *\n * @example\n * ```ts\n * const row = table_getRow(table, rowId, true)\n * ```\n */\nexport function table_getRow<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  rowId: string,\n  searchAll?: boolean,\n): Row<TFeatures, TData> {\n  // TODO - simplify this across different row models\n  let row = (searchAll ? table.getPrePaginatedRowModel() : table.getRowModel())\n    .rowsById[rowId]\n\n  if (!row) {\n    row = table.getCoreRowModel().rowsById[rowId]\n    if (!row) {\n      if (process.env.NODE_ENV === 'development') {\n        throw new Error(`getRow could not find row with ID: ${rowId}`)\n      }\n      throw new Error()\n    }\n  }\n\n  return row\n}\n"],"mappings":";;;;;;;;;;;;;;;AAmBA,SAAgB,aAGd,KAA4B,UAAkB;CAC9C,IAAI,IAAI,aAAa,eAAe,QAAQ,GAC1C,OAAO,IAAI,aAAa;CAG1B,MAAM,SAAS,IAAI,MAAM,UAAU,QAAQ;CAE3C,IAAI,kDAAC,OAAQ,aACX;CAGF,IAAI,aAAa,YAAY,OAAO,WAAW,IAAI,UAAU,IAAI,KAAK;CAEtE,OAAO,IAAI,aAAa;AAC1B;;;;;;;;;;;;AAaA,SAAgB,oBAGd,KAA4B,UAAkB;CAC9C,IAAI,IAAI,mBAAmB,eAAe,QAAQ,GAChD,OAAO,IAAI,mBAAmB;CAGhC,MAAM,SAAS,IAAI,MAAM,UAAU,QAAQ;CAE3C,IAAI,kDAAC,OAAQ,aACX;CAGF,IAAI,CAAC,OAAO,UAAU,iBAAiB;EACrC,IAAI,mBAAmB,YAAY,CAAC,IAAI,SAAS,QAAQ,CAAC;EAC1D,OAAO,IAAI,mBAAmB;CAChC;CAEA,IAAI,mBAAmB,YAAY,OAAO,UAAU,gBAClD,IAAI,UACJ,IAAI,KACN;CAEA,OAAO,IAAI,mBAAmB;AAChC;;;;;;;;;;;;AAaA,SAAgB,gBAGd,KAA4B,UAAkB;CAC9C,OAAO,IAAI,SAAS,QAAQ,KAAK,IAAI,MAAM,QAAQ;AACrD;;;;;;;;;;;AAYA,SAAgB,gBAGd,KAA0D;CAC1D,OAAOA,wBAAU,IAAI,UAAU,MAAM,EAAE,OAAO;AAChD;;;;;;;;;;;;AAaA,SAAgB,iBAGd,KAA4B;CAC5B,OAAO,IAAI,WAAW,IAAI,MAAM,OAAO,IAAI,UAAU,IAAI,IAAI;AAC/D;;;;;;;;;;;AAYA,SAAgB,kBAGd,KAA4B;CAC5B,MAAM,aAA2C,CAAC;CAClD,IAAI,aAAa;CAEjB,OAAO,MAAM;EACX,MAAM,YAAY,WAAW,aAAa;EAC1C,IAAI,CAAC,WAAW;EAChB,WAAW,KAAK,SAAS;EACzB,aAAa;CACf;CACA,OAAO,WAAW,QAAQ;AAC5B;;;;;;;;;;;;AAaA,SAAgB,gBAGd,KAAoE;CACpE,MAAM,UAAU,IAAI,MAAM,kBAAkB;CAC5C,MAAM,QAAgD,IAAI,MACxD,QAAQ,MACV;CACA,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAClC,MAAM,KAAKC,oCAAc,QAAQ,IAAK,KAAK,IAAI,KAAK;CAEtD,OAAO;AACT;;;;;;;;;;;AAYA,SAAgB,0BAGd,KAA4B;CAC5B,MAAM,SAA0D,CAAC;CACjE,MAAM,QAAQ,IAAI,YAAY;CAC9B,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;EACrC,MAAM,OAAO,MAAM;EACnB,OAAO,KAAK,OAAO,MAAM;CAC3B;CACA,OAAO;AACT;;;;;;;;;;;;AAaA,SAAgB,eAId,aACA,OACA,OACA,QACA;;CACA,mDACE,MAAM,SAAQ,6GAAW,aAAa,OAAO,MAAM,MACnD,GAAG,SAAS,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC,KAAK,GAAG,IAAI;AAE/C;;;;;;;;;;;;AAaA,SAAgB,aAId,OACA,OACA,WACuB;CAEvB,IAAI,OAAO,YAAY,MAAM,wBAAwB,IAAI,MAAM,YAAY,EAAC,CACzE,SAAS;CAEZ,IAAI,CAAC,KAAK;EACR,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS;EACvC,IAAI,CAAC,KAAK;GACR,IAAI,QAAQ,IAAI,aAAa,eAC3B,MAAM,IAAI,MAAM,sCAAsC,OAAO;GAE/D,MAAM,IAAI,MAAM;EAClB;CACF;CAEA,OAAO;AACT"}

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

@@ -0,0 +1,127 @@
+import { RowData } from "../../types/type-utils.cjs";
+import { Row } from "../../types/Row.cjs";
+import { Table_Internal } from "../../types/Table.cjs";
+import { TableFeatures } from "../../types/TableFeatures.cjs";
+import { Cell } from "../../types/Cell.cjs";
+
+//#region src/core/rows/coreRowsFeature.utils.d.ts
+/**
+ * Reads and caches this row's value for a column.
+ *
+ * The value is produced by the column accessor. Missing columns or display
+ * columns without an accessor return `undefined`.
+ *
+ * @example
+ * ```ts
+ * const firstName = row_getValue(row, 'firstName')
+ * ```
+ */
+declare function row_getValue<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string): unknown;
+/**
+ * Reads and caches the values used by faceting/grouping for a column.
+ *
+ * If the column defines `getUniqueValues`, that result is used. Otherwise the
+ * row's accessor value is wrapped in a single-item array.
+ *
+ * @example
+ * ```ts
+ * const values = row_getUniqueValues(row, 'tags')
+ * ```
+ */
+declare function row_getUniqueValues<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string): unknown;
+/**
+ * Returns a renderable row value for a column.
+ *
+ * If the accessor value is nullish, the table's `renderFallbackValue` is used
+ * instead.
+ *
+ * @example
+ * ```ts
+ * const value = row_renderValue(row, 'firstName')
+ * ```
+ */
+declare function row_renderValue<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string): any;
+/**
+ * Flattens this row's descendant tree into leaf rows.
+ *
+ * The row itself is not included; only nested `subRows` are walked.
+ *
+ * @example
+ * ```ts
+ * const descendants = row_getLeafRows(row)
+ * ```
+ */
+declare function row_getLeafRows<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): Array<Row<TFeatures, TData>>;
+/**
+ * Looks up this row's direct parent, if it has one.
+ *
+ * Parent lookup searches the pre-pagination row model so parent relationships
+ * are available even when the parent is not on the current page.
+ *
+ * @example
+ * ```ts
+ * const parent = row_getParentRow(row)
+ * ```
+ */
+declare function row_getParentRow<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): Row<TFeatures, TData> | undefined;
+/**
+ * Collects this row's ancestor chain from root to direct parent.
+ *
+ * The current row is not included. Rows without a parent return an empty array.
+ *
+ * @example
+ * ```ts
+ * const ancestors = row_getParentRows(row)
+ * ```
+ */
+declare function row_getParentRows<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): Row<TFeatures, TData>[];
+/**
+ * Constructs one cell for each leaf column in this row.
+ *
+ * The result follows `table.getAllLeafColumns()` order and includes hidden
+ * columns; visibility-specific APIs filter this list later.
+ *
+ * @example
+ * ```ts
+ * const cells = row_getAllCells(row)
+ * ```
+ */
+declare function row_getAllCells<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): Array<Cell<TFeatures, TData, unknown>>;
+/**
+ * Builds a lookup map of this row's cells keyed by column id.
+ *
+ * This is the static implementation behind `row.getAllCellsByColumnId()`.
+ *
+ * @example
+ * ```ts
+ * const cellsById = row_getAllCellsByColumnId(row)
+ * ```
+ */
+declare function row_getAllCellsByColumnId<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): Record<string, Cell<TFeatures, TData, unknown>>;
+/**
+ * Resolves the stable id for a row.
+ *
+ * `options.getRowId` wins when provided. Otherwise root rows use their index
+ * and child rows append their index to the parent id, such as `0.2`.
+ *
+ * @example
+ * ```ts
+ * const id = table_getRowId(originalRow, table, index, parentRow)
+ * ```
+ */
+declare function table_getRowId<TFeatures extends TableFeatures, TData extends RowData>(originalRow: TData, table: Table_Internal<TFeatures, TData>, index: number, parent?: Row<TFeatures, TData>): string;
+/**
+ * Looks up a row by id from the current or full row model.
+ *
+ * By default this searches `table.getRowModel()`. Passing `searchAll` searches
+ * the pre-pagination model first, then falls back to the core model.
+ *
+ * @example
+ * ```ts
+ * const row = table_getRow(table, rowId, true)
+ * ```
+ */
+declare function table_getRow<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, rowId: string, searchAll?: boolean): Row<TFeatures, TData>;
+//#endregion
+export { row_getAllCells, row_getAllCellsByColumnId, row_getLeafRows, row_getParentRow, row_getParentRows, row_getUniqueValues, row_getValue, row_renderValue, table_getRow, table_getRowId };
+//# sourceMappingURL=coreRowsFeature.utils.d.cts.map

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

@@ -0,0 +1,127 @@
+import { RowData } from "../../types/type-utils.js";
+import { Row } from "../../types/Row.js";
+import { Table_Internal } from "../../types/Table.js";
+import { TableFeatures } from "../../types/TableFeatures.js";
+import { Cell } from "../../types/Cell.js";
+
+//#region src/core/rows/coreRowsFeature.utils.d.ts
+/**
+ * Reads and caches this row's value for a column.
+ *
+ * The value is produced by the column accessor. Missing columns or display
+ * columns without an accessor return `undefined`.
+ *
+ * @example
+ * ```ts
+ * const firstName = row_getValue(row, 'firstName')
+ * ```
+ */
+declare function row_getValue<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string): unknown;
+/**
+ * Reads and caches the values used by faceting/grouping for a column.
+ *
+ * If the column defines `getUniqueValues`, that result is used. Otherwise the
+ * row's accessor value is wrapped in a single-item array.
+ *
+ * @example
+ * ```ts
+ * const values = row_getUniqueValues(row, 'tags')
+ * ```
+ */
+declare function row_getUniqueValues<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string): unknown;
+/**
+ * Returns a renderable row value for a column.
+ *
+ * If the accessor value is nullish, the table's `renderFallbackValue` is used
+ * instead.
+ *
+ * @example
+ * ```ts
+ * const value = row_renderValue(row, 'firstName')
+ * ```
+ */
+declare function row_renderValue<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string): any;
+/**
+ * Flattens this row's descendant tree into leaf rows.
+ *
+ * The row itself is not included; only nested `subRows` are walked.
+ *
+ * @example
+ * ```ts
+ * const descendants = row_getLeafRows(row)
+ * ```
+ */
+declare function row_getLeafRows<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): Array<Row<TFeatures, TData>>;
+/**
+ * Looks up this row's direct parent, if it has one.
+ *
+ * Parent lookup searches the pre-pagination row model so parent relationships
+ * are available even when the parent is not on the current page.
+ *
+ * @example
+ * ```ts
+ * const parent = row_getParentRow(row)
+ * ```
+ */
+declare function row_getParentRow<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): Row<TFeatures, TData> | undefined;
+/**
+ * Collects this row's ancestor chain from root to direct parent.
+ *
+ * The current row is not included. Rows without a parent return an empty array.
+ *
+ * @example
+ * ```ts
+ * const ancestors = row_getParentRows(row)
+ * ```
+ */
+declare function row_getParentRows<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): Row<TFeatures, TData>[];
+/**
+ * Constructs one cell for each leaf column in this row.
+ *
+ * The result follows `table.getAllLeafColumns()` order and includes hidden
+ * columns; visibility-specific APIs filter this list later.
+ *
+ * @example
+ * ```ts
+ * const cells = row_getAllCells(row)
+ * ```
+ */
+declare function row_getAllCells<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): Array<Cell<TFeatures, TData, unknown>>;
+/**
+ * Builds a lookup map of this row's cells keyed by column id.
+ *
+ * This is the static implementation behind `row.getAllCellsByColumnId()`.
+ *
+ * @example
+ * ```ts
+ * const cellsById = row_getAllCellsByColumnId(row)
+ * ```
+ */
+declare function row_getAllCellsByColumnId<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>): Record<string, Cell<TFeatures, TData, unknown>>;
+/**
+ * Resolves the stable id for a row.
+ *
+ * `options.getRowId` wins when provided. Otherwise root rows use their index
+ * and child rows append their index to the parent id, such as `0.2`.
+ *
+ * @example
+ * ```ts
+ * const id = table_getRowId(originalRow, table, index, parentRow)
+ * ```
+ */
+declare function table_getRowId<TFeatures extends TableFeatures, TData extends RowData>(originalRow: TData, table: Table_Internal<TFeatures, TData>, index: number, parent?: Row<TFeatures, TData>): string;
+/**
+ * Looks up a row by id from the current or full row model.
+ *
+ * By default this searches `table.getRowModel()`. Passing `searchAll` searches
+ * the pre-pagination model first, then falls back to the core model.
+ *
+ * @example
+ * ```ts
+ * const row = table_getRow(table, rowId, true)
+ * ```
+ */
+declare function table_getRow<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, rowId: string, searchAll?: boolean): Row<TFeatures, TData>;
+//#endregion
+export { row_getAllCells, row_getAllCellsByColumnId, row_getLeafRows, row_getParentRow, row_getParentRows, row_getUniqueValues, row_getValue, row_renderValue, table_getRow, table_getRowId };
+//# sourceMappingURL=coreRowsFeature.utils.d.ts.map