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

package/dist/core/columns/coreColumnsFeature.types.d.ts

@@ -0,0 +1,94 @@
+import { CellData, RowData } from "../../types/type-utils.js";
+import { Column } from "../../types/Column.js";
+import { AccessorFn, ColumnDef } from "../../types/ColumnDef.js";
+import { TableFeatures } from "../../types/TableFeatures.js";
+import { Table_Internal } from "../../types/Table.js";
+
+//#region src/core/columns/coreColumnsFeature.types.d.ts
+interface Column_CoreProperties<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> {
+  /**
+   * The resolved accessor function to use when extracting the value for the column from each row. Will only be defined if the column def has a valid accessor key or function defined.
+   */
+  accessorFn?: AccessorFn<TData, TValue>;
+  /**
+   * The original column def used to create the column.
+   */
+  columnDef: ColumnDef<TFeatures, TData, TValue>;
+  /**
+   * The child column (if the column is a group column). Will be an empty array if the column is not a group column.
+   */
+  columns: Array<Column<TFeatures, TData, TValue>>;
+  /**
+   * The depth of the column (if grouped) relative to the root column def array.
+   */
+  depth: number;
+  /**
+   * The resolved unique identifier for the column resolved in this priority:
+      - A manual `id` property from the column def
+      - The accessor key from the column def
+      - The header string from the column def
+   */
+  id: string;
+  /**
+   * The parent column for this column. Will be undefined if this is a root column.
+   */
+  parent?: Column<TFeatures, TData, TValue>;
+  /**
+   * Reference to the parent table instance.
+   */
+  table: Table_Internal<TFeatures, TData>;
+}
+interface Column_Column<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> extends Column_CoreProperties<TFeatures, TData, TValue> {
+  /**
+   * Flattens this column and every descendant column into a single array.
+   */
+  getFlatColumns: () => Array<Column<TFeatures, TData, TValue>>;
+  /**
+   * Collects the terminal leaf columns below this column, or the column itself
+   * when it has no children.
+   */
+  getLeafColumns: () => Array<Column<TFeatures, TData, TValue>>;
+}
+interface TableOptions_Columns<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> {
+  /**
+   * The array of column defs to use for the table.
+   */
+  columns: ReadonlyArray<ColumnDef<TFeatures, TData, TValue>>;
+  /**
+   * Default column options to use for all column defs supplied to the table.
+   */
+  defaultColumn?: Partial<ColumnDef<TFeatures, TData, TValue>>;
+}
+interface Table_Columns<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * Returns a map of all flat columns by their ID.
+   */
+  getAllFlatColumnsById: () => Record<string, Column<TFeatures, TData, unknown>>;
+  /**
+   * Resolves built-in, feature-level, and user-defined default column options.
+   */
+  getDefaultColumnDef: () => Partial<ColumnDef<TFeatures, TData, unknown>>;
+  /**
+   * Normalizes `options.columns` into the table's nested column hierarchy.
+   */
+  getAllColumns: () => Array<Column<TFeatures, TData, unknown>>;
+  /**
+   * Flattens the nested column hierarchy, including parent/group columns.
+   */
+  getAllFlatColumns: () => Array<Column<TFeatures, TData, unknown>>;
+  /**
+   * Collects all terminal leaf columns, excluding parent/group columns.
+   */
+  getAllLeafColumns: () => Array<Column<TFeatures, TData, unknown>>;
+  /**
+   * Returns a map of all leaf-node columns by their ID. This does not include parent columns.
+   */
+  getAllLeafColumnsById: () => Record<string, Column<TFeatures, TData, unknown>>;
+  /**
+   * Returns a single column by its ID.
+   */
+  getColumn: (columnId: string) => Column<TFeatures, TData, unknown> | undefined;
+}
+//#endregion
+export { Column_Column, Column_CoreProperties, TableOptions_Columns, Table_Columns };
+//# sourceMappingURL=coreColumnsFeature.types.d.ts.map

package/dist/core/columns/coreColumnsFeature.utils.cjs

@@ -0,0 +1,187 @@
+const require_utils = require('../../utils.cjs');
+const require_columnOrderingFeature_utils = require('../../features/column-ordering/columnOrderingFeature.utils.cjs');
+const require_constructColumn = require('./constructColumn.cjs');
+
+//#region src/core/columns/coreColumnsFeature.utils.ts
+/**
+* Flattens this column and every descendant column into a single array.
+*
+* Group columns appear before their child columns, which matches the normalized
+* column hierarchy produced during table construction.
+*
+* @example
+* ```ts
+* const flatColumns = column_getFlatColumns(column)
+* ```
+*/
+function column_getFlatColumns(column) {
+	return [column, ...column.columns.flatMap((col) => col.getFlatColumns())];
+}
+/**
+* Collects the terminal leaf columns below this column.
+*
+* Group columns return their ordered descendants. Non-group columns return an
+* array containing only the column itself.
+*
+* @example
+* ```ts
+* const leafColumns = column_getLeafColumns(column)
+* ```
+*/
+function column_getLeafColumns(column) {
+	if (column.columns.length) {
+		const leafColumns = column.columns.flatMap((col) => col.getLeafColumns());
+		return require_utils.callMemoOrStaticFn(column.table, "getOrderColumns", require_columnOrderingFeature_utils.table_getOrderColumnsFn)(leafColumns);
+	}
+	return [column];
+}
+/**
+* Merges built-in, feature, and user default column definitions.
+*
+* Built-in defaults provide a header and fallback cell renderer, feature
+* defaults can add feature-specific column options, and
+* `options.defaultColumn` wins last.
+*
+* @example
+* ```ts
+* const defaultColumn = table_getDefaultColumnDef(table)
+* ```
+*/
+function table_getDefaultColumnDef(table) {
+	return {
+		header: (props) => {
+			const resolvedColumnDef = props.header.column.columnDef;
+			if (resolvedColumnDef.accessorKey) return resolvedColumnDef.accessorKey;
+			if (resolvedColumnDef.accessorFn) return resolvedColumnDef.id;
+			return null;
+		},
+		cell: (props) => {
+			var _props$renderValue, _props$renderValue$to;
+			return ((_props$renderValue = props.renderValue()) === null || _props$renderValue === void 0 || (_props$renderValue$to = _props$renderValue.toString) === null || _props$renderValue$to === void 0 ? void 0 : _props$renderValue$to.call(_props$renderValue)) ?? null;
+		},
+		...Object.values(table._features).reduce((obj, feature) => {
+			var _feature$getDefaultCo;
+			return Object.assign(obj, (_feature$getDefaultCo = feature.getDefaultColumnDef) === null || _feature$getDefaultCo === void 0 ? void 0 : _feature$getDefaultCo.call(feature));
+		}, {}),
+		...table.options.defaultColumn
+	};
+}
+/**
+* Normalizes `options.columns` into the table's nested column tree.
+*
+* Each column definition is constructed with its parent and depth, and group
+* column children are recursively constructed.
+*
+* @example
+* ```ts
+* const columns = table_getAllColumns(table)
+* ```
+*/
+function table_getAllColumns(table) {
+	const recurseColumns = (colDefs, parent, depth = 0) => {
+		return colDefs.map((columnDef) => {
+			const column = require_constructColumn.constructColumn(table, columnDef, depth, parent);
+			const groupingColumnDef = columnDef;
+			column.columns = groupingColumnDef.columns ? recurseColumns(groupingColumnDef.columns, column, depth + 1) : [];
+			return column;
+		});
+	};
+	return recurseColumns(table.options.columns);
+}
+/**
+* Flattens every table column, including group columns and leaf columns.
+*
+* Use this when parent/group columns must be included in addition to data leaf
+* columns.
+*
+* @example
+* ```ts
+* const flatColumns = table_getAllFlatColumns(table)
+* ```
+*/
+function table_getAllFlatColumns(table) {
+	return table.getAllColumns().flatMap((column) => column.getFlatColumns());
+}
+/**
+* Builds an id lookup for every flat column in the table.
+*
+* Group columns and leaf columns are included. Later columns with the same id
+* replace earlier entries.
+*
+* @example
+* ```ts
+* const columnsById = table_getAllFlatColumnsById(table)
+* ```
+*/
+function table_getAllFlatColumnsById(table) {
+	const result = {};
+	const flatColumns = table.getAllFlatColumns();
+	for (let i = 0; i < flatColumns.length; i++) {
+		const column = flatColumns[i];
+		result[column.id] = column;
+	}
+	return result;
+}
+/**
+* Collects all terminal leaf columns in their current table order.
+*
+* Column ordering features can reorder the collected leaves before the result
+* is returned.
+*
+* @example
+* ```ts
+* const leafColumns = table_getAllLeafColumns(table)
+* ```
+*/
+function table_getAllLeafColumns(table) {
+	const leafColumns = table.getAllColumns().flatMap((c) => c.getLeafColumns());
+	return require_utils.callMemoOrStaticFn(table, "getOrderColumns", require_columnOrderingFeature_utils.table_getOrderColumnsFn)(leafColumns);
+}
+/**
+* Builds an id lookup for terminal leaf columns only.
+*
+* Parent/group columns are excluded, making this lookup appropriate for row
+* cells and feature state keyed by data columns.
+*
+* @example
+* ```ts
+* const leavesById = table_getAllLeafColumnsById(table)
+* ```
+*/
+function table_getAllLeafColumnsById(table) {
+	const result = {};
+	const leafColumns = table.getAllLeafColumns();
+	for (let i = 0; i < leafColumns.length; i++) {
+		const column = leafColumns[i];
+		result[column.id] = column;
+	}
+	return result;
+}
+/**
+* Looks up a column by id from the flat column map.
+*
+* The lookup can return group columns or leaf columns. In development, a
+* missing id logs a warning to help catch stale column references.
+*
+* @example
+* ```ts
+* const column = table_getColumn(table, 'firstName')
+* ```
+*/
+function table_getColumn(table, columnId) {
+	const column = table.getAllFlatColumnsById()[columnId];
+	if (process.env.NODE_ENV === "development" && !column) console.warn(`[Table] Column with id '${columnId}' does not exist.`);
+	return column;
+}
+
+//#endregion
+exports.column_getFlatColumns = column_getFlatColumns;
+exports.column_getLeafColumns = column_getLeafColumns;
+exports.table_getAllColumns = table_getAllColumns;
+exports.table_getAllFlatColumns = table_getAllFlatColumns;
+exports.table_getAllFlatColumnsById = table_getAllFlatColumnsById;
+exports.table_getAllLeafColumns = table_getAllLeafColumns;
+exports.table_getAllLeafColumnsById = table_getAllLeafColumnsById;
+exports.table_getColumn = table_getColumn;
+exports.table_getDefaultColumnDef = table_getDefaultColumnDef;
+//# sourceMappingURL=coreColumnsFeature.utils.cjs.map

package/dist/core/columns/coreColumnsFeature.utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"coreColumnsFeature.utils.cjs","names":["callMemoOrStaticFn","table_getOrderColumnsFn","constructColumn"],"sources":["../../../src/core/columns/coreColumnsFeature.utils.ts"],"sourcesContent":["import { callMemoOrStaticFn } from '../../utils'\nimport { table_getOrderColumnsFn } from '../../features/column-ordering/columnOrderingFeature.utils'\nimport { constructColumn } from './constructColumn'\nimport type { Table_Internal } from '../../types/Table'\nimport type { CellData, RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type {\n  ColumnDef,\n  ColumnDefResolved,\n  GroupColumnDef,\n} from '../../types/ColumnDef'\nimport type { Column } from '../../types/Column'\n\n/**\n * Flattens this column and every descendant column into a single array.\n *\n * Group columns appear before their child columns, which matches the normalized\n * column hierarchy produced during table construction.\n *\n * @example\n * ```ts\n * const flatColumns = column_getFlatColumns(column)\n * ```\n */\nexport function column_getFlatColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  column: Column<TFeatures, TData, TValue>,\n): Array<Column<TFeatures, TData, TValue>> {\n  return [column, ...column.columns.flatMap((col) => col.getFlatColumns())]\n}\n\n/**\n * Collects the terminal leaf columns below this column.\n *\n * Group columns return their ordered descendants. Non-group columns return an\n * array containing only the column itself.\n *\n * @example\n * ```ts\n * const leafColumns = column_getLeafColumns(column)\n * ```\n */\nexport function column_getLeafColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  column: Column<TFeatures, TData, TValue>,\n): Array<Column<TFeatures, TData, TValue>> {\n  if (column.columns.length) {\n    const leafColumns = column.columns.flatMap(\n      (col) => col.getLeafColumns(), // recursive\n    )\n\n    return callMemoOrStaticFn(\n      column.table,\n      'getOrderColumns',\n      table_getOrderColumnsFn,\n    )(leafColumns as any) as any\n  }\n\n  return [column]\n}\n\n/**\n * Merges built-in, feature, and user default column definitions.\n *\n * Built-in defaults provide a header and fallback cell renderer, feature\n * defaults can add feature-specific column options, and\n * `options.defaultColumn` wins last.\n *\n * @example\n * ```ts\n * const defaultColumn = table_getDefaultColumnDef(table)\n * ```\n */\nexport function table_getDefaultColumnDef<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Partial<ColumnDef<TFeatures, TData, unknown>> {\n  return {\n    header: (props) => {\n      const resolvedColumnDef = props.header.column\n        .columnDef as ColumnDefResolved<{}, TData>\n\n      if (resolvedColumnDef.accessorKey) {\n        return resolvedColumnDef.accessorKey\n      }\n\n      if (resolvedColumnDef.accessorFn) {\n        return resolvedColumnDef.id\n      }\n\n      return null\n    },\n    cell: (props) => props.renderValue<any>()?.toString?.() ?? null,\n    ...Object.values(table._features).reduce((obj, feature) => {\n      return Object.assign(obj, feature.getDefaultColumnDef?.())\n    }, {}),\n    ...table.options.defaultColumn,\n  } as Partial<ColumnDef<TFeatures, TData, unknown>>\n}\n\n/**\n * Normalizes `options.columns` into the table's nested column tree.\n *\n * Each column definition is constructed with its parent and depth, and group\n * column children are recursively constructed.\n *\n * @example\n * ```ts\n * const columns = table_getAllColumns(table)\n * ```\n */\nexport function table_getAllColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Array<Column<TFeatures, TData, unknown>> {\n  const recurseColumns = (\n    colDefs: ReadonlyArray<ColumnDef<TFeatures, TData, unknown>>,\n    parent?: Column<TFeatures, TData, unknown>,\n    depth = 0,\n  ): Array<Column<TFeatures, TData, unknown>> => {\n    return colDefs.map((columnDef) => {\n      const column = constructColumn(table, columnDef, depth, parent)\n\n      const groupingColumnDef = columnDef as GroupColumnDef<\n        TFeatures,\n        TData,\n        unknown\n      >\n\n      column.columns = groupingColumnDef.columns\n        ? recurseColumns(groupingColumnDef.columns, column, depth + 1)\n        : []\n\n      return column\n    })\n  }\n\n  return recurseColumns(table.options.columns)\n}\n\n/**\n * Flattens every table column, including group columns and leaf columns.\n *\n * Use this when parent/group columns must be included in addition to data leaf\n * columns.\n *\n * @example\n * ```ts\n * const flatColumns = table_getAllFlatColumns(table)\n * ```\n */\nexport function table_getAllFlatColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Array<Column<TFeatures, TData, unknown>> {\n  return table.getAllColumns().flatMap((column) => column.getFlatColumns())\n}\n\n/**\n * Builds an id lookup for every flat column in the table.\n *\n * Group columns and leaf columns are included. Later columns with the same id\n * replace earlier entries.\n *\n * @example\n * ```ts\n * const columnsById = table_getAllFlatColumnsById(table)\n * ```\n */\nexport function table_getAllFlatColumnsById<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Record<string, Column<TFeatures, TData, unknown>> {\n  const result: Record<string, Column<TFeatures, TData, unknown>> = {}\n  const flatColumns = table.getAllFlatColumns()\n  for (let i = 0; i < flatColumns.length; i++) {\n    const column = flatColumns[i]!\n    result[column.id] = column\n  }\n  return result\n}\n\n/**\n * Collects all terminal leaf columns in their current table order.\n *\n * Column ordering features can reorder the collected leaves before the result\n * is returned.\n *\n * @example\n * ```ts\n * const leafColumns = table_getAllLeafColumns(table)\n * ```\n */\nexport function table_getAllLeafColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Array<Column<TFeatures, TData, unknown>> {\n  const leafColumns = table.getAllColumns().flatMap(\n    (c) => c.getLeafColumns(), // recursive\n  )\n  return callMemoOrStaticFn(\n    table,\n    'getOrderColumns',\n    table_getOrderColumnsFn,\n  )(leafColumns)\n}\n\n/**\n * Builds an id lookup for terminal leaf columns only.\n *\n * Parent/group columns are excluded, making this lookup appropriate for row\n * cells and feature state keyed by data columns.\n *\n * @example\n * ```ts\n * const leavesById = table_getAllLeafColumnsById(table)\n * ```\n */\nexport function table_getAllLeafColumnsById<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n): Record<string, Column<TFeatures, TData, unknown>> {\n  const result: Record<string, Column<TFeatures, TData, unknown>> = {}\n  const leafColumns = table.getAllLeafColumns()\n  for (let i = 0; i < leafColumns.length; i++) {\n    const column = leafColumns[i]!\n    result[column.id] = column\n  }\n  return result\n}\n\n/**\n * Looks up a column by id from the flat column map.\n *\n * The lookup can return group columns or leaf columns. In development, a\n * missing id logs a warning to help catch stale column references.\n *\n * @example\n * ```ts\n * const column = table_getColumn(table, 'firstName')\n * ```\n */\nexport function table_getColumn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  columnId: string,\n): Column<TFeatures, TData, unknown> | undefined {\n  const column = table.getAllFlatColumnsById()[columnId]\n\n  if (process.env.NODE_ENV === 'development' && !column) {\n    console.warn(`[Table] Column with id '${columnId}' does not exist.`)\n  }\n\n  return column\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAwBA,SAAgB,sBAKd,QACyC;CACzC,OAAO,CAAC,QAAQ,GAAG,OAAO,QAAQ,SAAS,QAAQ,IAAI,eAAe,CAAC,CAAC;AAC1E;;;;;;;;;;;;AAaA,SAAgB,sBAKd,QACyC;CACzC,IAAI,OAAO,QAAQ,QAAQ;EACzB,MAAM,cAAc,OAAO,QAAQ,SAChC,QAAQ,IAAI,eAAe,CAC9B;EAEA,OAAOA,iCACL,OAAO,OACP,mBACAC,2DACF,CAAC,CAAC,WAAkB;CACtB;CAEA,OAAO,CAAC,MAAM;AAChB;;;;;;;;;;;;;AAcA,SAAgB,0BAId,OAC+C;CAC/C,OAAO;EACL,SAAS,UAAU;GACjB,MAAM,oBAAoB,MAAM,OAAO,OACpC;GAEH,IAAI,kBAAkB,aACpB,OAAO,kBAAkB;GAG3B,IAAI,kBAAkB,YACpB,OAAO,kBAAkB;GAG3B,OAAO;EACT;EACA,OAAO,UAAU;;uCAAM,YAAiB,4FAAG,+GAAW,MAAK;EAAG;EAC9D,GAAG,OAAO,OAAO,MAAM,SAAS,CAAC,CAAC,QAAQ,KAAK,YAAY;;GACzD,OAAO,OAAO,OAAO,8BAAK,QAAQ,+GAAsB,CAAC;EAC3D,GAAG,CAAC,CAAC;EACL,GAAG,MAAM,QAAQ;CACnB;AACF;;;;;;;;;;;;AAaA,SAAgB,oBAId,OAC0C;CAC1C,MAAM,kBACJ,SACA,QACA,QAAQ,MACqC;EAC7C,OAAO,QAAQ,KAAK,cAAc;GAChC,MAAM,SAASC,wCAAgB,OAAO,WAAW,OAAO,MAAM;GAE9D,MAAM,oBAAoB;GAM1B,OAAO,UAAU,kBAAkB,UAC/B,eAAe,kBAAkB,SAAS,QAAQ,QAAQ,CAAC,IAC3D,CAAC;GAEL,OAAO;EACT,CAAC;CACH;CAEA,OAAO,eAAe,MAAM,QAAQ,OAAO;AAC7C;;;;;;;;;;;;AAaA,SAAgB,wBAId,OAC0C;CAC1C,OAAO,MAAM,cAAc,CAAC,CAAC,SAAS,WAAW,OAAO,eAAe,CAAC;AAC1E;;;;;;;;;;;;AAaA,SAAgB,4BAId,OACmD;CACnD,MAAM,SAA4D,CAAC;CACnE,MAAM,cAAc,MAAM,kBAAkB;CAC5C,KAAK,IAAI,IAAI,GAAG,IAAI,YAAY,QAAQ,KAAK;EAC3C,MAAM,SAAS,YAAY;EAC3B,OAAO,OAAO,MAAM;CACtB;CACA,OAAO;AACT;;;;;;;;;;;;AAaA,SAAgB,wBAId,OAC0C;CAC1C,MAAM,cAAc,MAAM,cAAc,CAAC,CAAC,SACvC,MAAM,EAAE,eAAe,CAC1B;CACA,OAAOF,iCACL,OACA,mBACAC,2DACF,CAAC,CAAC,WAAW;AACf;;;;;;;;;;;;AAaA,SAAgB,4BAId,OACmD;CACnD,MAAM,SAA4D,CAAC;CACnE,MAAM,cAAc,MAAM,kBAAkB;CAC5C,KAAK,IAAI,IAAI,GAAG,IAAI,YAAY,QAAQ,KAAK;EAC3C,MAAM,SAAS,YAAY;EAC3B,OAAO,OAAO,MAAM;CACtB;CACA,OAAO;AACT;;;;;;;;;;;;AAaA,SAAgB,gBAId,OACA,UAC+C;CAC/C,MAAM,SAAS,MAAM,sBAAsB,CAAC,CAAC;CAE7C,IAAI,QAAQ,IAAI,aAAa,iBAAiB,CAAC,QAC7C,QAAQ,KAAK,2BAA2B,SAAS,kBAAkB;CAGrE,OAAO;AACT"}

package/dist/core/columns/coreColumnsFeature.utils.d.cts

@@ -0,0 +1,119 @@
+import { CellData, RowData } from "../../types/type-utils.cjs";
+import { Column } from "../../types/Column.cjs";
+import { ColumnDef } from "../../types/ColumnDef.cjs";
+import { TableFeatures } from "../../types/TableFeatures.cjs";
+import { Table_Internal } from "../../types/Table.cjs";
+
+//#region src/core/columns/coreColumnsFeature.utils.d.ts
+/**
+ * Flattens this column and every descendant column into a single array.
+ *
+ * Group columns appear before their child columns, which matches the normalized
+ * column hierarchy produced during table construction.
+ *
+ * @example
+ * ```ts
+ * const flatColumns = column_getFlatColumns(column)
+ * ```
+ */
+declare function column_getFlatColumns<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column<TFeatures, TData, TValue>): Array<Column<TFeatures, TData, TValue>>;
+/**
+ * Collects the terminal leaf columns below this column.
+ *
+ * Group columns return their ordered descendants. Non-group columns return an
+ * array containing only the column itself.
+ *
+ * @example
+ * ```ts
+ * const leafColumns = column_getLeafColumns(column)
+ * ```
+ */
+declare function column_getLeafColumns<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column<TFeatures, TData, TValue>): Array<Column<TFeatures, TData, TValue>>;
+/**
+ * Merges built-in, feature, and user default column definitions.
+ *
+ * Built-in defaults provide a header and fallback cell renderer, feature
+ * defaults can add feature-specific column options, and
+ * `options.defaultColumn` wins last.
+ *
+ * @example
+ * ```ts
+ * const defaultColumn = table_getDefaultColumnDef(table)
+ * ```
+ */
+declare function table_getDefaultColumnDef<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): Partial<ColumnDef<TFeatures, TData, unknown>>;
+/**
+ * Normalizes `options.columns` into the table's nested column tree.
+ *
+ * Each column definition is constructed with its parent and depth, and group
+ * column children are recursively constructed.
+ *
+ * @example
+ * ```ts
+ * const columns = table_getAllColumns(table)
+ * ```
+ */
+declare function table_getAllColumns<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): Array<Column<TFeatures, TData, unknown>>;
+/**
+ * Flattens every table column, including group columns and leaf columns.
+ *
+ * Use this when parent/group columns must be included in addition to data leaf
+ * columns.
+ *
+ * @example
+ * ```ts
+ * const flatColumns = table_getAllFlatColumns(table)
+ * ```
+ */
+declare function table_getAllFlatColumns<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): Array<Column<TFeatures, TData, unknown>>;
+/**
+ * Builds an id lookup for every flat column in the table.
+ *
+ * Group columns and leaf columns are included. Later columns with the same id
+ * replace earlier entries.
+ *
+ * @example
+ * ```ts
+ * const columnsById = table_getAllFlatColumnsById(table)
+ * ```
+ */
+declare function table_getAllFlatColumnsById<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): Record<string, Column<TFeatures, TData, unknown>>;
+/**
+ * Collects all terminal leaf columns in their current table order.
+ *
+ * Column ordering features can reorder the collected leaves before the result
+ * is returned.
+ *
+ * @example
+ * ```ts
+ * const leafColumns = table_getAllLeafColumns(table)
+ * ```
+ */
+declare function table_getAllLeafColumns<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): Array<Column<TFeatures, TData, unknown>>;
+/**
+ * Builds an id lookup for terminal leaf columns only.
+ *
+ * Parent/group columns are excluded, making this lookup appropriate for row
+ * cells and feature state keyed by data columns.
+ *
+ * @example
+ * ```ts
+ * const leavesById = table_getAllLeafColumnsById(table)
+ * ```
+ */
+declare function table_getAllLeafColumnsById<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): Record<string, Column<TFeatures, TData, unknown>>;
+/**
+ * Looks up a column by id from the flat column map.
+ *
+ * The lookup can return group columns or leaf columns. In development, a
+ * missing id logs a warning to help catch stale column references.
+ *
+ * @example
+ * ```ts
+ * const column = table_getColumn(table, 'firstName')
+ * ```
+ */
+declare function table_getColumn<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, columnId: string): Column<TFeatures, TData, unknown> | undefined;
+//#endregion
+export { column_getFlatColumns, column_getLeafColumns, table_getAllColumns, table_getAllFlatColumns, table_getAllFlatColumnsById, table_getAllLeafColumns, table_getAllLeafColumnsById, table_getColumn, table_getDefaultColumnDef };
+//# sourceMappingURL=coreColumnsFeature.utils.d.cts.map

package/dist/core/columns/coreColumnsFeature.utils.d.ts

@@ -0,0 +1,119 @@
+import { CellData, RowData } from "../../types/type-utils.js";
+import { Column } from "../../types/Column.js";
+import { ColumnDef } from "../../types/ColumnDef.js";
+import { TableFeatures } from "../../types/TableFeatures.js";
+import { Table_Internal } from "../../types/Table.js";
+
+//#region src/core/columns/coreColumnsFeature.utils.d.ts
+/**
+ * Flattens this column and every descendant column into a single array.
+ *
+ * Group columns appear before their child columns, which matches the normalized
+ * column hierarchy produced during table construction.
+ *
+ * @example
+ * ```ts
+ * const flatColumns = column_getFlatColumns(column)
+ * ```
+ */
+declare function column_getFlatColumns<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column<TFeatures, TData, TValue>): Array<Column<TFeatures, TData, TValue>>;
+/**
+ * Collects the terminal leaf columns below this column.
+ *
+ * Group columns return their ordered descendants. Non-group columns return an
+ * array containing only the column itself.
+ *
+ * @example
+ * ```ts
+ * const leafColumns = column_getLeafColumns(column)
+ * ```
+ */
+declare function column_getLeafColumns<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column<TFeatures, TData, TValue>): Array<Column<TFeatures, TData, TValue>>;
+/**
+ * Merges built-in, feature, and user default column definitions.
+ *
+ * Built-in defaults provide a header and fallback cell renderer, feature
+ * defaults can add feature-specific column options, and
+ * `options.defaultColumn` wins last.
+ *
+ * @example
+ * ```ts
+ * const defaultColumn = table_getDefaultColumnDef(table)
+ * ```
+ */
+declare function table_getDefaultColumnDef<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): Partial<ColumnDef<TFeatures, TData, unknown>>;
+/**
+ * Normalizes `options.columns` into the table's nested column tree.
+ *
+ * Each column definition is constructed with its parent and depth, and group
+ * column children are recursively constructed.
+ *
+ * @example
+ * ```ts
+ * const columns = table_getAllColumns(table)
+ * ```
+ */
+declare function table_getAllColumns<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): Array<Column<TFeatures, TData, unknown>>;
+/**
+ * Flattens every table column, including group columns and leaf columns.
+ *
+ * Use this when parent/group columns must be included in addition to data leaf
+ * columns.
+ *
+ * @example
+ * ```ts
+ * const flatColumns = table_getAllFlatColumns(table)
+ * ```
+ */
+declare function table_getAllFlatColumns<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): Array<Column<TFeatures, TData, unknown>>;
+/**
+ * Builds an id lookup for every flat column in the table.
+ *
+ * Group columns and leaf columns are included. Later columns with the same id
+ * replace earlier entries.
+ *
+ * @example
+ * ```ts
+ * const columnsById = table_getAllFlatColumnsById(table)
+ * ```
+ */
+declare function table_getAllFlatColumnsById<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): Record<string, Column<TFeatures, TData, unknown>>;
+/**
+ * Collects all terminal leaf columns in their current table order.
+ *
+ * Column ordering features can reorder the collected leaves before the result
+ * is returned.
+ *
+ * @example
+ * ```ts
+ * const leafColumns = table_getAllLeafColumns(table)
+ * ```
+ */
+declare function table_getAllLeafColumns<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): Array<Column<TFeatures, TData, unknown>>;
+/**
+ * Builds an id lookup for terminal leaf columns only.
+ *
+ * Parent/group columns are excluded, making this lookup appropriate for row
+ * cells and feature state keyed by data columns.
+ *
+ * @example
+ * ```ts
+ * const leavesById = table_getAllLeafColumnsById(table)
+ * ```
+ */
+declare function table_getAllLeafColumnsById<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): Record<string, Column<TFeatures, TData, unknown>>;
+/**
+ * Looks up a column by id from the flat column map.
+ *
+ * The lookup can return group columns or leaf columns. In development, a
+ * missing id logs a warning to help catch stale column references.
+ *
+ * @example
+ * ```ts
+ * const column = table_getColumn(table, 'firstName')
+ * ```
+ */
+declare function table_getColumn<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, columnId: string): Column<TFeatures, TData, unknown> | undefined;
+//#endregion
+export { column_getFlatColumns, column_getLeafColumns, table_getAllColumns, table_getAllFlatColumns, table_getAllFlatColumnsById, table_getAllLeafColumns, table_getAllLeafColumnsById, table_getColumn, table_getDefaultColumnDef };
+//# sourceMappingURL=coreColumnsFeature.utils.d.ts.map