@tanstack/table-core 9.0.0-alpha.16 → 9.0.0-alpha.23

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

@@ -0,0 +1,113 @@
+import { RowData, Updater } from "../../types/type-utils.cjs";
+import { CoreFeatures } from "../coreFeatures.cjs";
+import { RowModelFns } from "../../types/RowModelFns.cjs";
+import { CachedRowModels, CreateRowModels_All } from "../../types/RowModel.cjs";
+import { TableState } from "../../types/TableState.cjs";
+import { TableOptions } from "../../types/TableOptions.cjs";
+import { TableFeatures } from "../../types/TableFeatures.cjs";
+import { ReadonlyStore, Store } from "@tanstack/store";
+
+//#region src/core/table/coreTablesFeature.types.d.ts
+interface TableMeta<TFeatures extends TableFeatures, TData extends RowData> {}
+interface TableOptions_Table<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * The features that you want to enable for the table.
+   */
+  _features: TFeatures;
+  /**
+   * The row model options that you want to enable for the table.
+   */
+  _rowModels?: CreateRowModels_All<TFeatures, TData>;
+  /**
+   * Set this option to override any of the `autoReset...` feature options.
+   */
+  autoResetAll?: boolean;
+  /**
+   * The data for the table to display. When the `data` option changes reference, the table will reprocess the data.
+   */
+  data: ReadonlyArray<TData>;
+  /**
+   * Use this option to optionally pass initial state to the table. This state will be used when resetting various table states either automatically by the table (eg. `options.autoResetPageIndex`) or via functions like `table.resetRowSelection()`. Most reset function allow you optionally pass a flag to reset to a blank/default state instead of the initial state.
+   * Table state will not be reset when this object changes, which also means that the initial state object does not need to be stable.
+   */
+  initialState?: Partial<TableState<TFeatures>>;
+  /**
+   * This option is used to optionally implement the merging of table options.
+   */
+  mergeOptions?: (defaultOptions: TableOptions<TFeatures, TData>, options: Partial<TableOptions<TFeatures, TData>>) => TableOptions<TFeatures, TData>;
+  /**
+   * You can pass any object to `options.meta` and access it anywhere the `table` is available via `table.options.meta`.
+   */
+  meta?: TableMeta<TFeatures, TData>;
+  /**
+   * Pass in individual self-managed state to the table.
+   */
+  state?: Partial<TableState<TFeatures>>;
+  /**
+   * Optionally, provide your own external TanStack Store instance if you want to manage the table state externally.
+   */
+  store?: Store<TableState<TFeatures>>;
+}
+interface Table_CoreProperties<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * The features that are enabled for the table.
+   */
+  _features: Partial<CoreFeatures> & TFeatures;
+  /**
+   * Prototype cache for Cell objects - shared by all cells in this table
+   */
+  _cellPrototype?: object;
+  /**
+   * Prototype cache for Column objects - shared by all columns in this table
+   */
+  _columnPrototype?: object;
+  /**
+   * Prototype cache for Header objects - shared by all headers in this table
+   */
+  _headerPrototype?: object;
+  /**
+   * The row model processing functions that are used to process the data by features.
+   */
+  _rowModelFns: RowModelFns<TFeatures, TData>;
+  /**
+   * The row models that are enabled for the table.
+   */
+  _rowModels: CachedRowModels<TFeatures, TData>;
+  /**
+   * Prototype cache for Row objects - shared by all rows in this table
+   */
+  _rowPrototype?: object;
+  /**
+   * The base store for the table. This can be used to write to the table state.
+   */
+  baseStore: Store<TableState<TFeatures>>;
+  /**
+   * The base store for the table options.
+   */
+  optionsStore: Store<TableOptions<TFeatures, TData>>;
+  /**
+   * This is the resolved initial state of the table.
+   */
+  initialState: TableState<TFeatures>;
+  /**
+   * A read-only reference to the table's current options.
+   */
+  readonly options: TableOptions<TFeatures, TData>;
+  /**
+   * Where the table state is stored.
+   */
+  store: ReadonlyStore<TableState<TFeatures>>;
+}
+interface Table_Table<TFeatures extends TableFeatures, TData extends RowData> extends Table_CoreProperties<TFeatures, TData> {
+  /**
+   * Call this function to reset the table state to the initial state.
+   */
+  reset: () => void;
+  /**
+   * This function can be used to update the table options.
+   */
+  setOptions: (newOptions: Updater<TableOptions<TFeatures, TData>>) => void;
+}
+//#endregion
+export { TableMeta, TableOptions_Table, Table_CoreProperties, Table_Table };
+//# sourceMappingURL=coreTablesFeature.types.d.cts.map

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

@@ -0,0 +1,113 @@
+import { RowData, Updater } from "../../types/type-utils.js";
+import { CoreFeatures } from "../coreFeatures.js";
+import { RowModelFns } from "../../types/RowModelFns.js";
+import { CachedRowModels, CreateRowModels_All } from "../../types/RowModel.js";
+import { TableState } from "../../types/TableState.js";
+import { TableOptions } from "../../types/TableOptions.js";
+import { TableFeatures } from "../../types/TableFeatures.js";
+import { ReadonlyStore, Store } from "@tanstack/store";
+
+//#region src/core/table/coreTablesFeature.types.d.ts
+interface TableMeta<TFeatures extends TableFeatures, TData extends RowData> {}
+interface TableOptions_Table<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * The features that you want to enable for the table.
+   */
+  _features: TFeatures;
+  /**
+   * The row model options that you want to enable for the table.
+   */
+  _rowModels?: CreateRowModels_All<TFeatures, TData>;
+  /**
+   * Set this option to override any of the `autoReset...` feature options.
+   */
+  autoResetAll?: boolean;
+  /**
+   * The data for the table to display. When the `data` option changes reference, the table will reprocess the data.
+   */
+  data: ReadonlyArray<TData>;
+  /**
+   * Use this option to optionally pass initial state to the table. This state will be used when resetting various table states either automatically by the table (eg. `options.autoResetPageIndex`) or via functions like `table.resetRowSelection()`. Most reset function allow you optionally pass a flag to reset to a blank/default state instead of the initial state.
+   * Table state will not be reset when this object changes, which also means that the initial state object does not need to be stable.
+   */
+  initialState?: Partial<TableState<TFeatures>>;
+  /**
+   * This option is used to optionally implement the merging of table options.
+   */
+  mergeOptions?: (defaultOptions: TableOptions<TFeatures, TData>, options: Partial<TableOptions<TFeatures, TData>>) => TableOptions<TFeatures, TData>;
+  /**
+   * You can pass any object to `options.meta` and access it anywhere the `table` is available via `table.options.meta`.
+   */
+  meta?: TableMeta<TFeatures, TData>;
+  /**
+   * Pass in individual self-managed state to the table.
+   */
+  state?: Partial<TableState<TFeatures>>;
+  /**
+   * Optionally, provide your own external TanStack Store instance if you want to manage the table state externally.
+   */
+  store?: Store<TableState<TFeatures>>;
+}
+interface Table_CoreProperties<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * The features that are enabled for the table.
+   */
+  _features: Partial<CoreFeatures> & TFeatures;
+  /**
+   * Prototype cache for Cell objects - shared by all cells in this table
+   */
+  _cellPrototype?: object;
+  /**
+   * Prototype cache for Column objects - shared by all columns in this table
+   */
+  _columnPrototype?: object;
+  /**
+   * Prototype cache for Header objects - shared by all headers in this table
+   */
+  _headerPrototype?: object;
+  /**
+   * The row model processing functions that are used to process the data by features.
+   */
+  _rowModelFns: RowModelFns<TFeatures, TData>;
+  /**
+   * The row models that are enabled for the table.
+   */
+  _rowModels: CachedRowModels<TFeatures, TData>;
+  /**
+   * Prototype cache for Row objects - shared by all rows in this table
+   */
+  _rowPrototype?: object;
+  /**
+   * The base store for the table. This can be used to write to the table state.
+   */
+  baseStore: Store<TableState<TFeatures>>;
+  /**
+   * The base store for the table options.
+   */
+  optionsStore: Store<TableOptions<TFeatures, TData>>;
+  /**
+   * This is the resolved initial state of the table.
+   */
+  initialState: TableState<TFeatures>;
+  /**
+   * A read-only reference to the table's current options.
+   */
+  readonly options: TableOptions<TFeatures, TData>;
+  /**
+   * Where the table state is stored.
+   */
+  store: ReadonlyStore<TableState<TFeatures>>;
+}
+interface Table_Table<TFeatures extends TableFeatures, TData extends RowData> extends Table_CoreProperties<TFeatures, TData> {
+  /**
+   * Call this function to reset the table state to the initial state.
+   */
+  reset: () => void;
+  /**
+   * This function can be used to update the table options.
+   */
+  setOptions: (newOptions: Updater<TableOptions<TFeatures, TData>>) => void;
+}
+//#endregion
+export { TableMeta, TableOptions_Table, Table_CoreProperties, Table_Table };
+//# sourceMappingURL=coreTablesFeature.types.d.ts.map

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

@@ -0,0 +1,23 @@
+const require_utils = require('../../utils.cjs');
+
+//#region src/core/table/coreTablesFeature.utils.ts
+function table_reset(table) {
+	table.baseStore.setState(() => structuredClone(table.initialState));
+}
+function table_mergeOptions(table, newOptions) {
+	if (table.options.mergeOptions) return table.options.mergeOptions(table.options, newOptions);
+	return {
+		...table.options,
+		...newOptions
+	};
+}
+function table_setOptions(table, updater) {
+	const mergedOptions = table_mergeOptions(table, require_utils.functionalUpdate(updater, table.options));
+	table.optionsStore.setState(() => mergedOptions);
+}
+
+//#endregion
+exports.table_mergeOptions = table_mergeOptions;
+exports.table_reset = table_reset;
+exports.table_setOptions = table_setOptions;
+//# sourceMappingURL=coreTablesFeature.utils.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coreTablesFeature.utils.cjs","names":["functionalUpdate"],"sources":["../../../src/core/table/coreTablesFeature.utils.ts"],"sourcesContent":["import { functionalUpdate } from '../../utils'\nimport type { RowData, Updater } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Table_Internal } from '../../types/Table'\nimport type { TableOptions } from '../../types/TableOptions'\n\nexport function table_reset<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): void {\n  table.baseStore.setState(() => structuredClone(table.initialState))\n}\n\nexport function table_mergeOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  newOptions: TableOptions<TFeatures, TData>,\n) {\n  if (table.options.mergeOptions) {\n    return table.options.mergeOptions(table.options, newOptions)\n  }\n\n  return {\n    ...table.options,\n    ...newOptions,\n  }\n}\n\nexport function table_setOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  updater: Updater<TableOptions<TFeatures, TData>>,\n): void {\n  const newOptions = functionalUpdate(updater, table.options)\n  const mergedOptions = table_mergeOptions(table, newOptions)\n  table.optionsStore.setState(() => mergedOptions)\n}\n"],"mappings":";;;AAMA,SAAgB,YAGd,OAA+C;AAC/C,OAAM,UAAU,eAAe,gBAAgB,MAAM,aAAa,CAAC;;AAGrE,SAAgB,mBAId,OACA,YACA;AACA,KAAI,MAAM,QAAQ,aAChB,QAAO,MAAM,QAAQ,aAAa,MAAM,SAAS,WAAW;AAG9D,QAAO;EACL,GAAG,MAAM;EACT,GAAG;EACJ;;AAGH,SAAgB,iBAId,OACA,SACM;CAEN,MAAM,gBAAgB,mBAAmB,OADtBA,+BAAiB,SAAS,MAAM,QAAQ,CACA;AAC3D,OAAM,aAAa,eAAe,cAAc"}

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

@@ -0,0 +1,12 @@
+import { RowData, Updater } from "../../types/type-utils.cjs";
+import { TableOptions } from "../../types/TableOptions.cjs";
+import { TableFeatures } from "../../types/TableFeatures.cjs";
+import { Table_Internal } from "../../types/Table.cjs";
+
+//#region src/core/table/coreTablesFeature.utils.d.ts
+declare function table_reset<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): void;
+declare function table_mergeOptions<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, newOptions: TableOptions<TFeatures, TData>): TableOptions<TFeatures, TData>;
+declare function table_setOptions<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, updater: Updater<TableOptions<TFeatures, TData>>): void;
+//#endregion
+export { table_mergeOptions, table_reset, table_setOptions };
+//# sourceMappingURL=coreTablesFeature.utils.d.cts.map

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

@@ -0,0 +1,12 @@
+import { RowData, Updater } from "../../types/type-utils.js";
+import { TableOptions } from "../../types/TableOptions.js";
+import { TableFeatures } from "../../types/TableFeatures.js";
+import { Table_Internal } from "../../types/Table.js";
+
+//#region src/core/table/coreTablesFeature.utils.d.ts
+declare function table_reset<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): void;
+declare function table_mergeOptions<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, newOptions: TableOptions<TFeatures, TData>): TableOptions<TFeatures, TData>;
+declare function table_setOptions<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, updater: Updater<TableOptions<TFeatures, TData>>): void;
+//#endregion
+export { table_mergeOptions, table_reset, table_setOptions };
+//# sourceMappingURL=coreTablesFeature.utils.d.ts.map

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

@@ -0,0 +1,21 @@
+import { functionalUpdate } from "../../utils.js";
+
+//#region src/core/table/coreTablesFeature.utils.ts
+function table_reset(table) {
+	table.baseStore.setState(() => structuredClone(table.initialState));
+}
+function table_mergeOptions(table, newOptions) {
+	if (table.options.mergeOptions) return table.options.mergeOptions(table.options, newOptions);
+	return {
+		...table.options,
+		...newOptions
+	};
+}
+function table_setOptions(table, updater) {
+	const mergedOptions = table_mergeOptions(table, functionalUpdate(updater, table.options));
+	table.optionsStore.setState(() => mergedOptions);
+}
+
+//#endregion
+export { table_mergeOptions, table_reset, table_setOptions };
+//# sourceMappingURL=coreTablesFeature.utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coreTablesFeature.utils.js","names":[],"sources":["../../../src/core/table/coreTablesFeature.utils.ts"],"sourcesContent":["import { functionalUpdate } from '../../utils'\nimport type { RowData, Updater } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Table_Internal } from '../../types/Table'\nimport type { TableOptions } from '../../types/TableOptions'\n\nexport function table_reset<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): void {\n  table.baseStore.setState(() => structuredClone(table.initialState))\n}\n\nexport function table_mergeOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  newOptions: TableOptions<TFeatures, TData>,\n) {\n  if (table.options.mergeOptions) {\n    return table.options.mergeOptions(table.options, newOptions)\n  }\n\n  return {\n    ...table.options,\n    ...newOptions,\n  }\n}\n\nexport function table_setOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  updater: Updater<TableOptions<TFeatures, TData>>,\n): void {\n  const newOptions = functionalUpdate(updater, table.options)\n  const mergedOptions = table_mergeOptions(table, newOptions)\n  table.optionsStore.setState(() => mergedOptions)\n}\n"],"mappings":";;;AAMA,SAAgB,YAGd,OAA+C;AAC/C,OAAM,UAAU,eAAe,gBAAgB,MAAM,aAAa,CAAC;;AAGrE,SAAgB,mBAId,OACA,YACA;AACA,KAAI,MAAM,QAAQ,aAChB,QAAO,MAAM,QAAQ,aAAa,MAAM,SAAS,WAAW;AAG9D,QAAO;EACL,GAAG,MAAM;EACT,GAAG;EACJ;;AAGH,SAAgB,iBAId,OACA,SACM;CAEN,MAAM,gBAAgB,mBAAmB,OADtB,iBAAiB,SAAS,MAAM,QAAQ,CACA;AAC3D,OAAM,aAAa,eAAe,cAAc"}

package/dist/features/column-faceting/columnFacetingFeature.cjs

@@ -0,0 +1,59 @@
+const require_utils = require('../../utils.cjs');
+const require_columnFacetingFeature_utils = require('./columnFacetingFeature.utils.cjs');
+
+//#region src/features/column-faceting/columnFacetingFeature.ts
+function constructColumnFacetingFeature() {
+	return {
+		assignColumnPrototype: (prototype, table) => {
+			require_utils.assignPrototypeAPIs("columnFacetingFeature", prototype, table, {
+				column_getFacetedRowModel: {
+					memoDeps: () => [
+						table.getPreFilteredRowModel().rows,
+						table.store.state.columnFilters,
+						table.store.state.globalFilter,
+						table.getFilteredRowModel().rows
+					],
+					fn: (column) => require_columnFacetingFeature_utils.column_getFacetedRowModel(column, column.table)
+				},
+				column_getFacetedMinMaxValues: {
+					memoDeps: (column) => [require_utils.callMemoOrStaticFn(column, "getFacetedRowModel", require_columnFacetingFeature_utils.column_getFacetedRowModel, column.table).flatRows],
+					fn: (column) => require_columnFacetingFeature_utils.column_getFacetedMinMaxValues(column, column.table)
+				},
+				column_getFacetedUniqueValues: {
+					memoDeps: (column) => [require_utils.callMemoOrStaticFn(column, "getFacetedRowModel", require_columnFacetingFeature_utils.column_getFacetedRowModel, column.table).flatRows],
+					fn: (column) => require_columnFacetingFeature_utils.column_getFacetedUniqueValues(column, column.table)
+				}
+			});
+		},
+		constructTableAPIs: (table) => {
+			require_utils.assignTableAPIs("columnFacetingFeature", table, {
+				table_getGlobalFacetedRowModel: {
+					memoDeps: () => [
+						table.getPreFilteredRowModel().rows,
+						table.store.state.columnFilters,
+						table.store.state.globalFilter,
+						table.getFilteredRowModel().rows
+					],
+					fn: () => require_columnFacetingFeature_utils.table_getGlobalFacetedRowModel(table)
+				},
+				table_getGlobalFacetedMinMaxValues: {
+					memoDeps: () => [require_utils.callMemoOrStaticFn(table, "getGlobalFacetedRowModel", require_columnFacetingFeature_utils.table_getGlobalFacetedRowModel).flatRows],
+					fn: () => require_columnFacetingFeature_utils.table_getGlobalFacetedMinMaxValues(table)
+				},
+				table_getGlobalFacetedUniqueValues: {
+					memoDeps: () => [require_utils.callMemoOrStaticFn(table, "getGlobalFacetedRowModel", require_columnFacetingFeature_utils.table_getGlobalFacetedRowModel).flatRows],
+					fn: () => require_columnFacetingFeature_utils.table_getGlobalFacetedUniqueValues(table)
+				}
+			});
+		}
+	};
+}
+/**
+* The Column Faceting feature adds column faceting APIs to the column objects.
+*/
+const columnFacetingFeature = constructColumnFacetingFeature();
+
+//#endregion
+exports.columnFacetingFeature = columnFacetingFeature;
+exports.constructColumnFacetingFeature = constructColumnFacetingFeature;
+//# sourceMappingURL=columnFacetingFeature.cjs.map

package/dist/features/column-faceting/columnFacetingFeature.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"columnFacetingFeature.cjs","names":["column_getFacetedRowModel","callMemoOrStaticFn","column_getFacetedMinMaxValues","column_getFacetedUniqueValues","table_getGlobalFacetedRowModel","table_getGlobalFacetedMinMaxValues","table_getGlobalFacetedUniqueValues"],"sources":["../../../src/features/column-faceting/columnFacetingFeature.ts"],"sourcesContent":["import {\n  assignPrototypeAPIs,\n  assignTableAPIs,\n  callMemoOrStaticFn,\n} from '../../utils'\nimport {\n  column_getFacetedMinMaxValues,\n  column_getFacetedRowModel,\n  column_getFacetedUniqueValues,\n  table_getGlobalFacetedMinMaxValues,\n  table_getGlobalFacetedRowModel,\n  table_getGlobalFacetedUniqueValues,\n} from './columnFacetingFeature.utils'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\nimport type { Column_Internal } from '../../types/Column'\n// import type {\n//   CachedRowModel_Faceted,\n//   Column_ColumnFaceting,\n//   CreateRowModel_Faceted,\n// } from './columnFacetingFeature.types'\n\ninterface ColumnFacetingFeatureConstructors<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  // CachedRowModel: CachedRowModel_Faceted<TFeatures, TData>\n  // Column: Column_ColumnFaceting<TFeatures, TData>\n  // CreateRowModels: CreateRowModel_Faceted<TFeatures, TData>\n}\n\nexport function constructColumnFacetingFeature<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): TableFeature<ColumnFacetingFeatureConstructors<TFeatures, TData>> {\n  return {\n    assignColumnPrototype: (prototype, table) => {\n      assignPrototypeAPIs('columnFacetingFeature', prototype, table, {\n        column_getFacetedRowModel: {\n          memoDeps: () => [\n            table.getPreFilteredRowModel().rows,\n            table.store.state.columnFilters,\n            table.store.state.globalFilter,\n            table.getFilteredRowModel().rows,\n          ],\n          fn: (column) => column_getFacetedRowModel(column, column.table),\n        },\n        column_getFacetedMinMaxValues: {\n          memoDeps: (column: Column_Internal<TFeatures, TData>) => [\n            callMemoOrStaticFn(\n              column,\n              'getFacetedRowModel',\n              column_getFacetedRowModel,\n              column.table,\n            ).flatRows,\n          ],\n          fn: (column) => column_getFacetedMinMaxValues(column, column.table),\n        },\n        column_getFacetedUniqueValues: {\n          memoDeps: (column: Column_Internal<TFeatures, TData>) => [\n            callMemoOrStaticFn(\n              column,\n              'getFacetedRowModel',\n              column_getFacetedRowModel,\n              column.table,\n            ).flatRows,\n          ],\n          fn: (column) => column_getFacetedUniqueValues(column, column.table),\n        },\n      })\n    },\n\n    constructTableAPIs: (table) => {\n      assignTableAPIs('columnFacetingFeature', table, {\n        table_getGlobalFacetedRowModel: {\n          memoDeps: () => [\n            table.getPreFilteredRowModel().rows,\n            table.store.state.columnFilters,\n            table.store.state.globalFilter,\n            table.getFilteredRowModel().rows,\n          ],\n          fn: () => table_getGlobalFacetedRowModel(table),\n        },\n        table_getGlobalFacetedMinMaxValues: {\n          memoDeps: () => [\n            callMemoOrStaticFn(\n              table,\n              'getGlobalFacetedRowModel',\n              table_getGlobalFacetedRowModel,\n            ).flatRows,\n          ],\n          fn: () => table_getGlobalFacetedMinMaxValues(table),\n        },\n        table_getGlobalFacetedUniqueValues: {\n          memoDeps: () => [\n            callMemoOrStaticFn(\n              table,\n              'getGlobalFacetedRowModel',\n              table_getGlobalFacetedRowModel,\n            ).flatRows,\n          ],\n          fn: () => table_getGlobalFacetedUniqueValues(table),\n        },\n      })\n    },\n  }\n}\n\n/**\n * The Column Faceting feature adds column faceting APIs to the column objects.\n */\nexport const columnFacetingFeature = constructColumnFacetingFeature()\n"],"mappings":";;;;AA+BA,SAAgB,iCAGuD;AACrE,QAAO;EACL,wBAAwB,WAAW,UAAU;AAC3C,qCAAoB,yBAAyB,WAAW,OAAO;IAC7D,2BAA2B;KACzB,gBAAgB;MACd,MAAM,wBAAwB,CAAC;MAC/B,MAAM,MAAM,MAAM;MAClB,MAAM,MAAM,MAAM;MAClB,MAAM,qBAAqB,CAAC;MAC7B;KACD,KAAK,WAAWA,8DAA0B,QAAQ,OAAO,MAAM;KAChE;IACD,+BAA+B;KAC7B,WAAW,WAA8C,CACvDC,iCACE,QACA,sBACAD,+DACA,OAAO,MACR,CAAC,SACH;KACD,KAAK,WAAWE,kEAA8B,QAAQ,OAAO,MAAM;KACpE;IACD,+BAA+B;KAC7B,WAAW,WAA8C,CACvDD,iCACE,QACA,sBACAD,+DACA,OAAO,MACR,CAAC,SACH;KACD,KAAK,WAAWG,kEAA8B,QAAQ,OAAO,MAAM;KACpE;IACF,CAAC;;EAGJ,qBAAqB,UAAU;AAC7B,iCAAgB,yBAAyB,OAAO;IAC9C,gCAAgC;KAC9B,gBAAgB;MACd,MAAM,wBAAwB,CAAC;MAC/B,MAAM,MAAM,MAAM;MAClB,MAAM,MAAM,MAAM;MAClB,MAAM,qBAAqB,CAAC;MAC7B;KACD,UAAUC,mEAA+B,MAAM;KAChD;IACD,oCAAoC;KAClC,gBAAgB,CACdH,iCACE,OACA,4BACAG,mEACD,CAAC,SACH;KACD,UAAUC,uEAAmC,MAAM;KACpD;IACD,oCAAoC;KAClC,gBAAgB,CACdJ,iCACE,OACA,4BACAG,mEACD,CAAC,SACH;KACD,UAAUE,uEAAmC,MAAM;KACpD;IACF,CAAC;;EAEL;;;;;AAMH,MAAa,wBAAwB,gCAAgC"}

package/dist/features/column-faceting/columnFacetingFeature.d.cts

@@ -0,0 +1,13 @@
+import { RowData } from "../../types/type-utils.cjs";
+import { TableFeature, TableFeatures } from "../../types/TableFeatures.cjs";
+
+//#region src/features/column-faceting/columnFacetingFeature.d.ts
+interface ColumnFacetingFeatureConstructors<TFeatures extends TableFeatures, TData extends RowData> {}
+declare function constructColumnFacetingFeature<TFeatures extends TableFeatures, TData extends RowData>(): TableFeature<ColumnFacetingFeatureConstructors<TFeatures, TData>>;
+/**
+ * The Column Faceting feature adds column faceting APIs to the column objects.
+ */
+declare const columnFacetingFeature: TableFeature<ColumnFacetingFeatureConstructors<TableFeatures, RowData>>;
+//#endregion
+export { columnFacetingFeature, constructColumnFacetingFeature };
+//# sourceMappingURL=columnFacetingFeature.d.cts.map

package/dist/features/column-faceting/columnFacetingFeature.d.ts

@@ -0,0 +1,13 @@
+import { RowData } from "../../types/type-utils.js";
+import { TableFeature, TableFeatures } from "../../types/TableFeatures.js";
+
+//#region src/features/column-faceting/columnFacetingFeature.d.ts
+interface ColumnFacetingFeatureConstructors<TFeatures extends TableFeatures, TData extends RowData> {}
+declare function constructColumnFacetingFeature<TFeatures extends TableFeatures, TData extends RowData>(): TableFeature<ColumnFacetingFeatureConstructors<TFeatures, TData>>;
+/**
+ * The Column Faceting feature adds column faceting APIs to the column objects.
+ */
+declare const columnFacetingFeature: TableFeature<ColumnFacetingFeatureConstructors<TableFeatures, RowData>>;
+//#endregion
+export { columnFacetingFeature, constructColumnFacetingFeature };
+//# sourceMappingURL=columnFacetingFeature.d.ts.map

package/dist/features/column-faceting/columnFacetingFeature.js

@@ -0,0 +1,58 @@
+import { assignPrototypeAPIs, assignTableAPIs, callMemoOrStaticFn } from "../../utils.js";
+import { column_getFacetedMinMaxValues, column_getFacetedRowModel, column_getFacetedUniqueValues, table_getGlobalFacetedMinMaxValues, table_getGlobalFacetedRowModel, table_getGlobalFacetedUniqueValues } from "./columnFacetingFeature.utils.js";
+
+//#region src/features/column-faceting/columnFacetingFeature.ts
+function constructColumnFacetingFeature() {
+	return {
+		assignColumnPrototype: (prototype, table) => {
+			assignPrototypeAPIs("columnFacetingFeature", prototype, table, {
+				column_getFacetedRowModel: {
+					memoDeps: () => [
+						table.getPreFilteredRowModel().rows,
+						table.store.state.columnFilters,
+						table.store.state.globalFilter,
+						table.getFilteredRowModel().rows
+					],
+					fn: (column) => column_getFacetedRowModel(column, column.table)
+				},
+				column_getFacetedMinMaxValues: {
+					memoDeps: (column) => [callMemoOrStaticFn(column, "getFacetedRowModel", column_getFacetedRowModel, column.table).flatRows],
+					fn: (column) => column_getFacetedMinMaxValues(column, column.table)
+				},
+				column_getFacetedUniqueValues: {
+					memoDeps: (column) => [callMemoOrStaticFn(column, "getFacetedRowModel", column_getFacetedRowModel, column.table).flatRows],
+					fn: (column) => column_getFacetedUniqueValues(column, column.table)
+				}
+			});
+		},
+		constructTableAPIs: (table) => {
+			assignTableAPIs("columnFacetingFeature", table, {
+				table_getGlobalFacetedRowModel: {
+					memoDeps: () => [
+						table.getPreFilteredRowModel().rows,
+						table.store.state.columnFilters,
+						table.store.state.globalFilter,
+						table.getFilteredRowModel().rows
+					],
+					fn: () => table_getGlobalFacetedRowModel(table)
+				},
+				table_getGlobalFacetedMinMaxValues: {
+					memoDeps: () => [callMemoOrStaticFn(table, "getGlobalFacetedRowModel", table_getGlobalFacetedRowModel).flatRows],
+					fn: () => table_getGlobalFacetedMinMaxValues(table)
+				},
+				table_getGlobalFacetedUniqueValues: {
+					memoDeps: () => [callMemoOrStaticFn(table, "getGlobalFacetedRowModel", table_getGlobalFacetedRowModel).flatRows],
+					fn: () => table_getGlobalFacetedUniqueValues(table)
+				}
+			});
+		}
+	};
+}
+/**
+* The Column Faceting feature adds column faceting APIs to the column objects.
+*/
+const columnFacetingFeature = constructColumnFacetingFeature();
+
+//#endregion
+export { columnFacetingFeature, constructColumnFacetingFeature };
+//# sourceMappingURL=columnFacetingFeature.js.map

package/dist/features/column-faceting/columnFacetingFeature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"columnFacetingFeature.js","names":[],"sources":["../../../src/features/column-faceting/columnFacetingFeature.ts"],"sourcesContent":["import {\n  assignPrototypeAPIs,\n  assignTableAPIs,\n  callMemoOrStaticFn,\n} from '../../utils'\nimport {\n  column_getFacetedMinMaxValues,\n  column_getFacetedRowModel,\n  column_getFacetedUniqueValues,\n  table_getGlobalFacetedMinMaxValues,\n  table_getGlobalFacetedRowModel,\n  table_getGlobalFacetedUniqueValues,\n} from './columnFacetingFeature.utils'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\nimport type { Column_Internal } from '../../types/Column'\n// import type {\n//   CachedRowModel_Faceted,\n//   Column_ColumnFaceting,\n//   CreateRowModel_Faceted,\n// } from './columnFacetingFeature.types'\n\ninterface ColumnFacetingFeatureConstructors<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  // CachedRowModel: CachedRowModel_Faceted<TFeatures, TData>\n  // Column: Column_ColumnFaceting<TFeatures, TData>\n  // CreateRowModels: CreateRowModel_Faceted<TFeatures, TData>\n}\n\nexport function constructColumnFacetingFeature<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): TableFeature<ColumnFacetingFeatureConstructors<TFeatures, TData>> {\n  return {\n    assignColumnPrototype: (prototype, table) => {\n      assignPrototypeAPIs('columnFacetingFeature', prototype, table, {\n        column_getFacetedRowModel: {\n          memoDeps: () => [\n            table.getPreFilteredRowModel().rows,\n            table.store.state.columnFilters,\n            table.store.state.globalFilter,\n            table.getFilteredRowModel().rows,\n          ],\n          fn: (column) => column_getFacetedRowModel(column, column.table),\n        },\n        column_getFacetedMinMaxValues: {\n          memoDeps: (column: Column_Internal<TFeatures, TData>) => [\n            callMemoOrStaticFn(\n              column,\n              'getFacetedRowModel',\n              column_getFacetedRowModel,\n              column.table,\n            ).flatRows,\n          ],\n          fn: (column) => column_getFacetedMinMaxValues(column, column.table),\n        },\n        column_getFacetedUniqueValues: {\n          memoDeps: (column: Column_Internal<TFeatures, TData>) => [\n            callMemoOrStaticFn(\n              column,\n              'getFacetedRowModel',\n              column_getFacetedRowModel,\n              column.table,\n            ).flatRows,\n          ],\n          fn: (column) => column_getFacetedUniqueValues(column, column.table),\n        },\n      })\n    },\n\n    constructTableAPIs: (table) => {\n      assignTableAPIs('columnFacetingFeature', table, {\n        table_getGlobalFacetedRowModel: {\n          memoDeps: () => [\n            table.getPreFilteredRowModel().rows,\n            table.store.state.columnFilters,\n            table.store.state.globalFilter,\n            table.getFilteredRowModel().rows,\n          ],\n          fn: () => table_getGlobalFacetedRowModel(table),\n        },\n        table_getGlobalFacetedMinMaxValues: {\n          memoDeps: () => [\n            callMemoOrStaticFn(\n              table,\n              'getGlobalFacetedRowModel',\n              table_getGlobalFacetedRowModel,\n            ).flatRows,\n          ],\n          fn: () => table_getGlobalFacetedMinMaxValues(table),\n        },\n        table_getGlobalFacetedUniqueValues: {\n          memoDeps: () => [\n            callMemoOrStaticFn(\n              table,\n              'getGlobalFacetedRowModel',\n              table_getGlobalFacetedRowModel,\n            ).flatRows,\n          ],\n          fn: () => table_getGlobalFacetedUniqueValues(table),\n        },\n      })\n    },\n  }\n}\n\n/**\n * The Column Faceting feature adds column faceting APIs to the column objects.\n */\nexport const columnFacetingFeature = constructColumnFacetingFeature()\n"],"mappings":";;;;AA+BA,SAAgB,iCAGuD;AACrE,QAAO;EACL,wBAAwB,WAAW,UAAU;AAC3C,uBAAoB,yBAAyB,WAAW,OAAO;IAC7D,2BAA2B;KACzB,gBAAgB;MACd,MAAM,wBAAwB,CAAC;MAC/B,MAAM,MAAM,MAAM;MAClB,MAAM,MAAM,MAAM;MAClB,MAAM,qBAAqB,CAAC;MAC7B;KACD,KAAK,WAAW,0BAA0B,QAAQ,OAAO,MAAM;KAChE;IACD,+BAA+B;KAC7B,WAAW,WAA8C,CACvD,mBACE,QACA,sBACA,2BACA,OAAO,MACR,CAAC,SACH;KACD,KAAK,WAAW,8BAA8B,QAAQ,OAAO,MAAM;KACpE;IACD,+BAA+B;KAC7B,WAAW,WAA8C,CACvD,mBACE,QACA,sBACA,2BACA,OAAO,MACR,CAAC,SACH;KACD,KAAK,WAAW,8BAA8B,QAAQ,OAAO,MAAM;KACpE;IACF,CAAC;;EAGJ,qBAAqB,UAAU;AAC7B,mBAAgB,yBAAyB,OAAO;IAC9C,gCAAgC;KAC9B,gBAAgB;MACd,MAAM,wBAAwB,CAAC;MAC/B,MAAM,MAAM,MAAM;MAClB,MAAM,MAAM,MAAM;MAClB,MAAM,qBAAqB,CAAC;MAC7B;KACD,UAAU,+BAA+B,MAAM;KAChD;IACD,oCAAoC;KAClC,gBAAgB,CACd,mBACE,OACA,4BACA,+BACD,CAAC,SACH;KACD,UAAU,mCAAmC,MAAM;KACpD;IACD,oCAAoC;KAClC,gBAAgB,CACd,mBACE,OACA,4BACA,+BACD,CAAC,SACH;KACD,UAAU,mCAAmC,MAAM;KACpD;IACF,CAAC;;EAEL;;;;;AAMH,MAAa,wBAAwB,gCAAgC"}

package/dist/features/column-faceting/columnFacetingFeature.types.d.cts

@@ -0,0 +1,73 @@
+import { RowData } from "../../types/type-utils.cjs";
+import { TableFeatures } from "../../types/TableFeatures.cjs";
+import { Table } from "../../types/Table.cjs";
+import { RowModel } from "../../core/row-models/coreRowModelsFeature.types.cjs";
+
+//#region src/features/column-faceting/columnFacetingFeature.types.d.ts
+interface Column_ColumnFaceting<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * A function that **computes and returns** a min/max tuple derived from `column.getFacetedRowModel`. Useful for displaying faceted result values.
+   */
+  getFacetedMinMaxValues: () => undefined | [number, number];
+  /**
+   * A function that **computes and returns** a row model with all other column filters applied, excluding its own filter. Useful for displaying faceted result counts.
+   */
+  getFacetedRowModel: () => RowModel<TFeatures, TData>;
+  /**
+   * Returns a `Map` of unique values and their occurrences derived from `column.getFacetedRowModel`. Useful for displaying faceted result values.
+   */
+  getFacetedUniqueValues: () => Map<any, number>;
+}
+interface Table_RowModels_Faceted<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * A function that **computes and returns** a min/max tuple derived from `column.getFacetedRowModel`. Useful for displaying faceted result values.
+   * > ⚠️ Requires that you pass a valid `getFacetedMinMaxValues` function to `options.getFacetedMinMaxValues`. A default implementation is provided via the exported `getFacetedMinMaxValues` function.
+   */
+  getFacetedMinMaxValues: () => undefined | [number, number];
+  /**
+   * Returns the row model with all other column filters applied, excluding its own filter. Useful for displaying faceted result counts.
+   * > ⚠️ Requires that you pass a valid `getFacetedRowModel` function to `options.facetedRowModel`. A default implementation is provided via the exported `getFacetedRowModel` function.
+   */
+  getFacetedRowModel: () => RowModel<TFeatures, TData>;
+  /**
+   * A function that **computes and returns** a `Map` of unique values and their occurrences derived from `column.getFacetedRowModel`. Useful for displaying faceted result values.
+   * > ⚠️ Requires that you pass a valid `getFacetedUniqueValues` function to `options.getFacetedUniqueValues`. A default implementation is provided via the exported `getFacetedUniqueValues` function.
+   */
+  getFacetedUniqueValues: () => Map<any, number>;
+}
+interface CreateRowModel_Faceted<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * This function is used to retrieve the faceted min/max values. If using server-side faceting, this function is not required. To use client-side faceting, pass the exported `getFacetedMinMaxValues()` from your adapter to your table or implement your own.
+   */
+  facetedMinMaxValues?: (table: Table<TFeatures, TData>, columnId: string) => () => [number, number] | undefined;
+  /**
+   * This function is used to retrieve the faceted row model. If using server-side faceting, this function is not required. To use client-side faceting, pass the exported `getFacetedRowModel()` from your adapter to your table or implement your own.
+   */
+  facetedRowModel?: (table: Table<TFeatures, TData>, columnId: string) => () => RowModel<TFeatures, TData>;
+  /**
+   * This function is used to retrieve the faceted unique values. If using server-side faceting, this function is not required. To use client-side faceting, pass the exported `getFacetedUniqueValues()` from your adapter to your table or implement your own.
+   */
+  facetedUniqueValues?: (table: Table<TFeatures, TData>, columnId: string) => () => Map<any, number>;
+}
+interface CachedRowModel_Faceted<TFeatures extends TableFeatures, TData extends RowData> {
+  facetedRowModel?: (columnId: string) => () => RowModel<TFeatures, TData>;
+  facetedMinMaxValues?: (columnId: string) => [number, number];
+  facetedUniqueValues?: (columnId: string) => Map<any, number>;
+}
+interface Table_ColumnFaceting<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * Returns the min and max values for the global filter.
+   */
+  getGlobalFacetedMinMaxValues: () => undefined | [number, number];
+  /**
+   * Returns the row model for the table after **global** filtering has been applied.
+   */
+  getGlobalFacetedRowModel: () => RowModel<TFeatures, TData>;
+  /**
+   * Returns the faceted unique values for the global filter.
+   */
+  getGlobalFacetedUniqueValues: () => Map<any, number>;
+}
+//#endregion
+export { CachedRowModel_Faceted, Column_ColumnFaceting, CreateRowModel_Faceted, Table_ColumnFaceting, Table_RowModels_Faceted };
+//# sourceMappingURL=columnFacetingFeature.types.d.cts.map

package/dist/features/column-faceting/columnFacetingFeature.types.d.ts

@@ -0,0 +1,73 @@
+import { RowData } from "../../types/type-utils.js";
+import { TableFeatures } from "../../types/TableFeatures.js";
+import { Table } from "../../types/Table.js";
+import { RowModel } from "../../core/row-models/coreRowModelsFeature.types.js";
+
+//#region src/features/column-faceting/columnFacetingFeature.types.d.ts
+interface Column_ColumnFaceting<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * A function that **computes and returns** a min/max tuple derived from `column.getFacetedRowModel`. Useful for displaying faceted result values.
+   */
+  getFacetedMinMaxValues: () => undefined | [number, number];
+  /**
+   * A function that **computes and returns** a row model with all other column filters applied, excluding its own filter. Useful for displaying faceted result counts.
+   */
+  getFacetedRowModel: () => RowModel<TFeatures, TData>;
+  /**
+   * Returns a `Map` of unique values and their occurrences derived from `column.getFacetedRowModel`. Useful for displaying faceted result values.
+   */
+  getFacetedUniqueValues: () => Map<any, number>;
+}
+interface Table_RowModels_Faceted<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * A function that **computes and returns** a min/max tuple derived from `column.getFacetedRowModel`. Useful for displaying faceted result values.
+   * > ⚠️ Requires that you pass a valid `getFacetedMinMaxValues` function to `options.getFacetedMinMaxValues`. A default implementation is provided via the exported `getFacetedMinMaxValues` function.
+   */
+  getFacetedMinMaxValues: () => undefined | [number, number];
+  /**
+   * Returns the row model with all other column filters applied, excluding its own filter. Useful for displaying faceted result counts.
+   * > ⚠️ Requires that you pass a valid `getFacetedRowModel` function to `options.facetedRowModel`. A default implementation is provided via the exported `getFacetedRowModel` function.
+   */
+  getFacetedRowModel: () => RowModel<TFeatures, TData>;
+  /**
+   * A function that **computes and returns** a `Map` of unique values and their occurrences derived from `column.getFacetedRowModel`. Useful for displaying faceted result values.
+   * > ⚠️ Requires that you pass a valid `getFacetedUniqueValues` function to `options.getFacetedUniqueValues`. A default implementation is provided via the exported `getFacetedUniqueValues` function.
+   */
+  getFacetedUniqueValues: () => Map<any, number>;
+}
+interface CreateRowModel_Faceted<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * This function is used to retrieve the faceted min/max values. If using server-side faceting, this function is not required. To use client-side faceting, pass the exported `getFacetedMinMaxValues()` from your adapter to your table or implement your own.
+   */
+  facetedMinMaxValues?: (table: Table<TFeatures, TData>, columnId: string) => () => [number, number] | undefined;
+  /**
+   * This function is used to retrieve the faceted row model. If using server-side faceting, this function is not required. To use client-side faceting, pass the exported `getFacetedRowModel()` from your adapter to your table or implement your own.
+   */
+  facetedRowModel?: (table: Table<TFeatures, TData>, columnId: string) => () => RowModel<TFeatures, TData>;
+  /**
+   * This function is used to retrieve the faceted unique values. If using server-side faceting, this function is not required. To use client-side faceting, pass the exported `getFacetedUniqueValues()` from your adapter to your table or implement your own.
+   */
+  facetedUniqueValues?: (table: Table<TFeatures, TData>, columnId: string) => () => Map<any, number>;
+}
+interface CachedRowModel_Faceted<TFeatures extends TableFeatures, TData extends RowData> {
+  facetedRowModel?: (columnId: string) => () => RowModel<TFeatures, TData>;
+  facetedMinMaxValues?: (columnId: string) => [number, number];
+  facetedUniqueValues?: (columnId: string) => Map<any, number>;
+}
+interface Table_ColumnFaceting<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * Returns the min and max values for the global filter.
+   */
+  getGlobalFacetedMinMaxValues: () => undefined | [number, number];
+  /**
+   * Returns the row model for the table after **global** filtering has been applied.
+   */
+  getGlobalFacetedRowModel: () => RowModel<TFeatures, TData>;
+  /**
+   * Returns the faceted unique values for the global filter.
+   */
+  getGlobalFacetedUniqueValues: () => Map<any, number>;
+}
+//#endregion
+export { CachedRowModel_Faceted, Column_ColumnFaceting, CreateRowModel_Faceted, Table_ColumnFaceting, Table_RowModels_Faceted };
+//# sourceMappingURL=columnFacetingFeature.types.d.ts.map