@tanstack/table-core 9.0.0-alpha.4 → 9.0.0-alpha.41

package/dist/types/TableFeatures.d.ts

@@ -0,0 +1,77 @@
+import { CellData, RowData, UnionToIntersection } from "./type-utils.js";
+import { CoreFeatures } from "../core/coreFeatures.js";
+import { Row } from "./Row.js";
+import { ColumnDefBase_All } from "./ColumnDef.js";
+import { TableState_All } from "./TableState.js";
+import { TableOptions_All } from "./TableOptions.js";
+import { StockFeatures } from "../features/stockFeatures.js";
+import { Table_Internal } from "./Table.js";
+
+//#region src/types/TableFeatures.d.ts
+type ExtractFeatureTypes<TKey extends keyof FeatureConstructors, TFeatures extends TableFeatures> = UnionToIntersection<{ [K in keyof TFeatures]: TFeatures[K] extends TableFeature<infer FeatureConstructorOptions> ? TKey extends keyof FeatureConstructorOptions ? FeatureConstructorOptions[TKey] : never : any }[keyof TFeatures]>;
+interface FeatureConstructors {
+  CachedRowModel?: any;
+  Cell?: any;
+  Column?: any;
+  ColumnDef?: any;
+  CreateRowModels?: any;
+  Header?: any;
+  HeaderGroup?: any;
+  Row?: any;
+  RowModelFns?: any;
+  Table?: any;
+  TableOptions?: any;
+  TableState?: any;
+}
+interface Plugins {}
+interface TableFeatures extends Partial<CoreFeatures>, Partial<StockFeatures>, Partial<Plugins> {}
+type ConstructTableAPIs<TConstructors extends FeatureConstructors> = <TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData> & Partial<TConstructors['Table']> & {
+  options: Partial<TConstructors['TableOptions']>;
+}) => void;
+type GetDefaultColumnDef<TConstructors extends FeatureConstructors> = <TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>() => ColumnDefBase_All<TFeatures, TData, TValue> & Partial<TConstructors['ColumnDef']>;
+type GetDefaultTableOptions<TConstructors extends FeatureConstructors> = <TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData> & Partial<TConstructors['Table']>) => Partial<TableOptions_All<TFeatures, TData>> & Partial<TConstructors['TableOptions']>;
+type GetInitialState<TConstructors extends FeatureConstructors> = (initialState: Partial<TableState_All> & Partial<TConstructors['TableState']>) => TableState_All & Partial<TConstructors['TableState']>;
+type GetDefaultStateSelector<TConstructors extends FeatureConstructors> = (state: TableState_All) => Partial<TableState_All> & Partial<TConstructors['TableState']>;
+type AssignCellPrototype<TConstructors extends FeatureConstructors> = <TFeatures extends TableFeatures, TData extends RowData>(prototype: Record<string, any>, table: Table_Internal<TFeatures, TData>) => void;
+type AssignColumnPrototype<TConstructors extends FeatureConstructors> = <TFeatures extends TableFeatures, TData extends RowData>(prototype: Record<string, any>, table: Table_Internal<TFeatures, TData>) => void;
+type AssignHeaderPrototype<TConstructors extends FeatureConstructors> = <TFeatures extends TableFeatures, TData extends RowData>(prototype: Record<string, any>, table: Table_Internal<TFeatures, TData>) => void;
+type AssignRowPrototype<TConstructors extends FeatureConstructors> = <TFeatures extends TableFeatures, TData extends RowData>(prototype: Record<string, any>, table: Table_Internal<TFeatures, TData>) => void;
+type InitRowInstanceData<TConstructors extends FeatureConstructors> = <TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData> & Partial<TConstructors['Row']>) => void;
+interface TableFeature<TConstructors extends FeatureConstructors> {
+  /**
+   * Assigns Cell APIs to the cell prototype for memory-efficient method sharing.
+   * This is called once per table to build a shared prototype for all cells.
+   */
+  assignCellPrototype?: AssignCellPrototype<TConstructors>;
+  /**
+   * Assigns Column APIs to the column prototype for memory-efficient method sharing.
+   * This is called once per table to build a shared prototype for all columns.
+   */
+  assignColumnPrototype?: AssignColumnPrototype<TConstructors>;
+  /**
+   * Assigns Header APIs to the header prototype for memory-efficient method sharing.
+   * This is called once per table to build a shared prototype for all headers.
+   */
+  assignHeaderPrototype?: AssignHeaderPrototype<TConstructors>;
+  /**
+   * Assigns Row APIs to the row prototype for memory-efficient method sharing.
+   * This is called once per table to build a shared prototype for all rows.
+   */
+  assignRowPrototype?: AssignRowPrototype<TConstructors>;
+  /**
+   * Assigns Table APIs to the table instance.
+   * Unlike row/cell/column/header, the table is a singleton so methods are assigned directly.
+   */
+  constructTableAPIs?: ConstructTableAPIs<TConstructors>;
+  getDefaultColumnDef?: GetDefaultColumnDef<TConstructors>;
+  getDefaultTableOptions?: GetDefaultTableOptions<TConstructors>;
+  getInitialState?: GetInitialState<TConstructors>;
+  /**
+   * Initializes instance-specific data on each row (e.g., caches).
+   * Methods should be assigned via assignRowPrototype instead.
+   */
+  initRowInstanceData?: InitRowInstanceData<TConstructors>;
+}
+//#endregion
+export { AssignCellPrototype, AssignColumnPrototype, AssignHeaderPrototype, AssignRowPrototype, ConstructTableAPIs, ExtractFeatureTypes, FeatureConstructors, GetDefaultColumnDef, GetDefaultStateSelector, GetDefaultTableOptions, GetInitialState, InitRowInstanceData, Plugins, TableFeature, TableFeatures };
+//# sourceMappingURL=TableFeatures.d.ts.map

package/dist/types/TableOptions.d.cts

@@ -0,0 +1,39 @@
+import { RowData, UnionToIntersection } from "./type-utils.cjs";
+import { CoreFeatures } from "../core/coreFeatures.cjs";
+import { TableOptions_RowSorting } from "../features/row-sorting/rowSortingFeature.types.cjs";
+import { TableOptions_ColumnFiltering } from "../features/column-filtering/columnFilteringFeature.types.cjs";
+import { TableOptions_ColumnSizing } from "../features/column-sizing/columnSizingFeature.types.cjs";
+import { TableOptions_ColumnResizing } from "../features/column-resizing/columnResizingFeature.types.cjs";
+import { TableOptions_ColumnPinning } from "../features/column-pinning/columnPinningFeature.types.cjs";
+import { TableOptions_ColumnOrdering } from "../features/column-ordering/columnOrderingFeature.types.cjs";
+import { TableOptions_GlobalFiltering } from "../features/global-filtering/globalFilteringFeature.types.cjs";
+import { TableOptions_Columns } from "../core/columns/coreColumnsFeature.types.cjs";
+import { TableOptions_ColumnVisibility } from "../features/column-visibility/columnVisibilityFeature.types.cjs";
+import { TableOptions_RowExpanding } from "../features/row-expanding/rowExpandingFeature.types.cjs";
+import { TableOptions_RowPinning } from "../features/row-pinning/rowPinningFeature.types.cjs";
+import { TableOptions_RowSelection } from "../features/row-selection/rowSelectionFeature.types.cjs";
+import { TableOptions_Rows } from "../core/rows/coreRowsFeature.types.cjs";
+import { TableOptions_Cell } from "../core/cells/coreCellsFeature.types.cjs";
+import { TableOptions_RowPagination } from "../features/row-pagination/rowPaginationFeature.types.cjs";
+import { TableOptions_Table } from "../core/table/coreTablesFeature.types.cjs";
+import { ExtractFeatureTypes, TableFeatures } from "./TableFeatures.cjs";
+import { TableOptions_ColumnGrouping } from "../features/column-grouping/columnGroupingFeature.types.cjs";
+
+//#region src/types/TableOptions.d.ts
+interface TableOptions_Plugins<TFeatures extends TableFeatures, TData extends RowData> {}
+interface TableOptions_Core<TFeatures extends TableFeatures, TData extends RowData> extends TableOptions_Table<TFeatures, TData>, TableOptions_Cell, TableOptions_Columns<TFeatures, TData>, TableOptions_Rows<TFeatures, TData> {}
+type DebugKeysFor<TFeatures extends TableFeatures> = { [K in keyof TFeatures & string as `debug${Capitalize<K>}`]?: boolean };
+type DebugOptions<TFeatures extends TableFeatures> = {
+  debugAll?: boolean;
+  debugCache?: boolean;
+  debugCells?: boolean;
+  debugColumns?: boolean;
+  debugHeaders?: boolean;
+  debugRows?: boolean;
+  debugTable?: boolean;
+} & DebugKeysFor<CoreFeatures & TFeatures>;
+type TableOptions<TFeatures extends TableFeatures, TData extends RowData> = TableOptions_Core<TFeatures, TData> & UnionToIntersection<('columnFilteringFeature' extends keyof TFeatures ? TableOptions_ColumnFiltering<TFeatures, TData> : never) | ('columnGroupingFeature' extends keyof TFeatures ? TableOptions_ColumnGrouping : never) | ('columnOrderingFeature' extends keyof TFeatures ? TableOptions_ColumnOrdering : never) | ('columnPinningFeature' extends keyof TFeatures ? TableOptions_ColumnPinning : never) | ('columnResizingFeature' extends keyof TFeatures ? TableOptions_ColumnResizing : never) | ('columnSizingFeature' extends keyof TFeatures ? TableOptions_ColumnSizing : never) | ('columnVisibilityFeature' extends keyof TFeatures ? TableOptions_ColumnVisibility : never) | ('globalFilteringFeature' extends keyof TFeatures ? TableOptions_GlobalFiltering<TFeatures, TData> : never) | ('rowExpandingFeature' extends keyof TFeatures ? TableOptions_RowExpanding<TFeatures, TData> : never) | ('rowPaginationFeature' extends keyof TFeatures ? TableOptions_RowPagination : never) | ('rowPinningFeature' extends keyof TFeatures ? TableOptions_RowPinning<TFeatures, TData> : never) | ('rowSelectionFeature' extends keyof TFeatures ? TableOptions_RowSelection<TFeatures, TData> : never) | ('rowSortingFeature' extends keyof TFeatures ? TableOptions_RowSorting : never)> & ExtractFeatureTypes<'TableOptions', TFeatures> & TableOptions_Plugins<TFeatures, TData> & DebugOptions<TFeatures>;
+type TableOptions_All<TFeatures extends TableFeatures, TData extends RowData> = TableOptions_Core<TFeatures, TData> & Partial<TableOptions_ColumnFiltering<TFeatures, TData> & TableOptions_ColumnGrouping & TableOptions_ColumnOrdering & TableOptions_ColumnPinning & TableOptions_ColumnResizing & TableOptions_ColumnSizing & TableOptions_ColumnVisibility & TableOptions_GlobalFiltering<TFeatures, TData> & TableOptions_RowExpanding<TFeatures, TData> & TableOptions_RowPagination & TableOptions_RowPinning<TFeatures, TData> & TableOptions_RowSelection<TFeatures, TData> & TableOptions_RowSorting>;
+//#endregion
+export { DebugOptions, TableOptions, TableOptions_All, TableOptions_Core, TableOptions_Plugins };
+//# sourceMappingURL=TableOptions.d.cts.map

package/dist/types/TableOptions.d.ts

@@ -0,0 +1,39 @@
+import { RowData, UnionToIntersection } from "./type-utils.js";
+import { CoreFeatures } from "../core/coreFeatures.js";
+import { TableOptions_RowSorting } from "../features/row-sorting/rowSortingFeature.types.js";
+import { TableOptions_ColumnFiltering } from "../features/column-filtering/columnFilteringFeature.types.js";
+import { TableOptions_ColumnSizing } from "../features/column-sizing/columnSizingFeature.types.js";
+import { TableOptions_ColumnResizing } from "../features/column-resizing/columnResizingFeature.types.js";
+import { TableOptions_ColumnPinning } from "../features/column-pinning/columnPinningFeature.types.js";
+import { TableOptions_ColumnOrdering } from "../features/column-ordering/columnOrderingFeature.types.js";
+import { TableOptions_GlobalFiltering } from "../features/global-filtering/globalFilteringFeature.types.js";
+import { TableOptions_Columns } from "../core/columns/coreColumnsFeature.types.js";
+import { TableOptions_ColumnVisibility } from "../features/column-visibility/columnVisibilityFeature.types.js";
+import { TableOptions_RowExpanding } from "../features/row-expanding/rowExpandingFeature.types.js";
+import { TableOptions_RowPinning } from "../features/row-pinning/rowPinningFeature.types.js";
+import { TableOptions_RowSelection } from "../features/row-selection/rowSelectionFeature.types.js";
+import { TableOptions_Rows } from "../core/rows/coreRowsFeature.types.js";
+import { TableOptions_Cell } from "../core/cells/coreCellsFeature.types.js";
+import { TableOptions_RowPagination } from "../features/row-pagination/rowPaginationFeature.types.js";
+import { TableOptions_Table } from "../core/table/coreTablesFeature.types.js";
+import { ExtractFeatureTypes, TableFeatures } from "./TableFeatures.js";
+import { TableOptions_ColumnGrouping } from "../features/column-grouping/columnGroupingFeature.types.js";
+
+//#region src/types/TableOptions.d.ts
+interface TableOptions_Plugins<TFeatures extends TableFeatures, TData extends RowData> {}
+interface TableOptions_Core<TFeatures extends TableFeatures, TData extends RowData> extends TableOptions_Table<TFeatures, TData>, TableOptions_Cell, TableOptions_Columns<TFeatures, TData>, TableOptions_Rows<TFeatures, TData> {}
+type DebugKeysFor<TFeatures extends TableFeatures> = { [K in keyof TFeatures & string as `debug${Capitalize<K>}`]?: boolean };
+type DebugOptions<TFeatures extends TableFeatures> = {
+  debugAll?: boolean;
+  debugCache?: boolean;
+  debugCells?: boolean;
+  debugColumns?: boolean;
+  debugHeaders?: boolean;
+  debugRows?: boolean;
+  debugTable?: boolean;
+} & DebugKeysFor<CoreFeatures & TFeatures>;
+type TableOptions<TFeatures extends TableFeatures, TData extends RowData> = TableOptions_Core<TFeatures, TData> & UnionToIntersection<('columnFilteringFeature' extends keyof TFeatures ? TableOptions_ColumnFiltering<TFeatures, TData> : never) | ('columnGroupingFeature' extends keyof TFeatures ? TableOptions_ColumnGrouping : never) | ('columnOrderingFeature' extends keyof TFeatures ? TableOptions_ColumnOrdering : never) | ('columnPinningFeature' extends keyof TFeatures ? TableOptions_ColumnPinning : never) | ('columnResizingFeature' extends keyof TFeatures ? TableOptions_ColumnResizing : never) | ('columnSizingFeature' extends keyof TFeatures ? TableOptions_ColumnSizing : never) | ('columnVisibilityFeature' extends keyof TFeatures ? TableOptions_ColumnVisibility : never) | ('globalFilteringFeature' extends keyof TFeatures ? TableOptions_GlobalFiltering<TFeatures, TData> : never) | ('rowExpandingFeature' extends keyof TFeatures ? TableOptions_RowExpanding<TFeatures, TData> : never) | ('rowPaginationFeature' extends keyof TFeatures ? TableOptions_RowPagination : never) | ('rowPinningFeature' extends keyof TFeatures ? TableOptions_RowPinning<TFeatures, TData> : never) | ('rowSelectionFeature' extends keyof TFeatures ? TableOptions_RowSelection<TFeatures, TData> : never) | ('rowSortingFeature' extends keyof TFeatures ? TableOptions_RowSorting : never)> & ExtractFeatureTypes<'TableOptions', TFeatures> & TableOptions_Plugins<TFeatures, TData> & DebugOptions<TFeatures>;
+type TableOptions_All<TFeatures extends TableFeatures, TData extends RowData> = TableOptions_Core<TFeatures, TData> & Partial<TableOptions_ColumnFiltering<TFeatures, TData> & TableOptions_ColumnGrouping & TableOptions_ColumnOrdering & TableOptions_ColumnPinning & TableOptions_ColumnResizing & TableOptions_ColumnSizing & TableOptions_ColumnVisibility & TableOptions_GlobalFiltering<TFeatures, TData> & TableOptions_RowExpanding<TFeatures, TData> & TableOptions_RowPagination & TableOptions_RowPinning<TFeatures, TData> & TableOptions_RowSelection<TFeatures, TData> & TableOptions_RowSorting>;
+//#endregion
+export { DebugOptions, TableOptions, TableOptions_All, TableOptions_Core, TableOptions_Plugins };
+//# sourceMappingURL=TableOptions.d.ts.map

package/dist/types/TableState.d.cts

@@ -0,0 +1,27 @@
+import { UnionToIntersection } from "./type-utils.cjs";
+import { TableState_RowSorting } from "../features/row-sorting/rowSortingFeature.types.cjs";
+import { TableState_ColumnFiltering } from "../features/column-filtering/columnFilteringFeature.types.cjs";
+import { TableState_ColumnSizing } from "../features/column-sizing/columnSizingFeature.types.cjs";
+import { TableState_ColumnResizing } from "../features/column-resizing/columnResizingFeature.types.cjs";
+import { TableState_ColumnPinning } from "../features/column-pinning/columnPinningFeature.types.cjs";
+import { TableState_ColumnOrdering } from "../features/column-ordering/columnOrderingFeature.types.cjs";
+import { TableState_GlobalFiltering } from "../features/global-filtering/globalFilteringFeature.types.cjs";
+import { TableState_ColumnVisibility } from "../features/column-visibility/columnVisibilityFeature.types.cjs";
+import { TableState_RowExpanding } from "../features/row-expanding/rowExpandingFeature.types.cjs";
+import { TableState_RowPinning } from "../features/row-pinning/rowPinningFeature.types.cjs";
+import { TableState_RowSelection } from "../features/row-selection/rowSelectionFeature.types.cjs";
+import { TableState_RowPagination } from "../features/row-pagination/rowPaginationFeature.types.cjs";
+import { ExtractFeatureTypes, TableFeatures } from "./TableFeatures.cjs";
+import { TableState_ColumnGrouping } from "../features/column-grouping/columnGroupingFeature.types.cjs";
+
+//#region src/types/TableState.d.ts
+/**
+ * Use this interface as a target for declaration merging to add your own state properties.
+ * Note: This will affect the types of all tables in your project.
+ */
+interface TableState_Plugins<TFeatures extends TableFeatures> {}
+type TableState<TFeatures extends TableFeatures> = UnionToIntersection<('columnFilteringFeature' extends keyof TFeatures ? TableState_ColumnFiltering : never) | ('columnGroupingFeature' extends keyof TFeatures ? TableState_ColumnGrouping : never) | ('columnOrderingFeature' extends keyof TFeatures ? TableState_ColumnOrdering : never) | ('columnPinningFeature' extends keyof TFeatures ? TableState_ColumnPinning : never) | ('columnResizingFeature' extends keyof TFeatures ? TableState_ColumnResizing : never) | ('columnSizingFeature' extends keyof TFeatures ? TableState_ColumnSizing : never) | ('columnVisibilityFeature' extends keyof TFeatures ? TableState_ColumnVisibility : never) | ('globalFilteringFeature' extends keyof TFeatures ? TableState_GlobalFiltering : never) | ('rowExpandingFeature' extends keyof TFeatures ? TableState_RowExpanding : never) | ('rowPaginationFeature' extends keyof TFeatures ? TableState_RowPagination : never) | ('rowPinningFeature' extends keyof TFeatures ? TableState_RowPinning : never) | ('rowSelectionFeature' extends keyof TFeatures ? TableState_RowSelection : never) | ('rowSortingFeature' extends keyof TFeatures ? TableState_RowSorting : never)> & ExtractFeatureTypes<'TableState', TFeatures> & TableState_Plugins<TFeatures>;
+type TableState_All = Partial<TableState_ColumnFiltering & TableState_ColumnGrouping & TableState_ColumnOrdering & TableState_ColumnPinning & TableState_ColumnResizing & TableState_ColumnSizing & TableState_ColumnVisibility & TableState_GlobalFiltering & TableState_RowExpanding & TableState_RowPagination & TableState_RowPinning & TableState_RowSelection & TableState_RowSorting>;
+//#endregion
+export { TableState, TableState_All, TableState_Plugins };
+//# sourceMappingURL=TableState.d.cts.map

package/dist/types/TableState.d.ts

@@ -0,0 +1,27 @@
+import { UnionToIntersection } from "./type-utils.js";
+import { TableState_RowSorting } from "../features/row-sorting/rowSortingFeature.types.js";
+import { TableState_ColumnFiltering } from "../features/column-filtering/columnFilteringFeature.types.js";
+import { TableState_ColumnSizing } from "../features/column-sizing/columnSizingFeature.types.js";
+import { TableState_ColumnResizing } from "../features/column-resizing/columnResizingFeature.types.js";
+import { TableState_ColumnPinning } from "../features/column-pinning/columnPinningFeature.types.js";
+import { TableState_ColumnOrdering } from "../features/column-ordering/columnOrderingFeature.types.js";
+import { TableState_GlobalFiltering } from "../features/global-filtering/globalFilteringFeature.types.js";
+import { TableState_ColumnVisibility } from "../features/column-visibility/columnVisibilityFeature.types.js";
+import { TableState_RowExpanding } from "../features/row-expanding/rowExpandingFeature.types.js";
+import { TableState_RowPinning } from "../features/row-pinning/rowPinningFeature.types.js";
+import { TableState_RowSelection } from "../features/row-selection/rowSelectionFeature.types.js";
+import { TableState_RowPagination } from "../features/row-pagination/rowPaginationFeature.types.js";
+import { ExtractFeatureTypes, TableFeatures } from "./TableFeatures.js";
+import { TableState_ColumnGrouping } from "../features/column-grouping/columnGroupingFeature.types.js";
+
+//#region src/types/TableState.d.ts
+/**
+ * Use this interface as a target for declaration merging to add your own state properties.
+ * Note: This will affect the types of all tables in your project.
+ */
+interface TableState_Plugins<TFeatures extends TableFeatures> {}
+type TableState<TFeatures extends TableFeatures> = UnionToIntersection<('columnFilteringFeature' extends keyof TFeatures ? TableState_ColumnFiltering : never) | ('columnGroupingFeature' extends keyof TFeatures ? TableState_ColumnGrouping : never) | ('columnOrderingFeature' extends keyof TFeatures ? TableState_ColumnOrdering : never) | ('columnPinningFeature' extends keyof TFeatures ? TableState_ColumnPinning : never) | ('columnResizingFeature' extends keyof TFeatures ? TableState_ColumnResizing : never) | ('columnSizingFeature' extends keyof TFeatures ? TableState_ColumnSizing : never) | ('columnVisibilityFeature' extends keyof TFeatures ? TableState_ColumnVisibility : never) | ('globalFilteringFeature' extends keyof TFeatures ? TableState_GlobalFiltering : never) | ('rowExpandingFeature' extends keyof TFeatures ? TableState_RowExpanding : never) | ('rowPaginationFeature' extends keyof TFeatures ? TableState_RowPagination : never) | ('rowPinningFeature' extends keyof TFeatures ? TableState_RowPinning : never) | ('rowSelectionFeature' extends keyof TFeatures ? TableState_RowSelection : never) | ('rowSortingFeature' extends keyof TFeatures ? TableState_RowSorting : never)> & ExtractFeatureTypes<'TableState', TFeatures> & TableState_Plugins<TFeatures>;
+type TableState_All = Partial<TableState_ColumnFiltering & TableState_ColumnGrouping & TableState_ColumnOrdering & TableState_ColumnPinning & TableState_ColumnResizing & TableState_ColumnSizing & TableState_ColumnVisibility & TableState_GlobalFiltering & TableState_RowExpanding & TableState_RowPagination & TableState_RowPinning & TableState_RowSelection & TableState_RowSorting>;
+//#endregion
+export { TableState, TableState_All, TableState_Plugins };
+//# sourceMappingURL=TableState.d.ts.map

package/dist/types/type-utils.d.cts

@@ -0,0 +1,23 @@
+//#region src/types/type-utils.d.ts
+type Updater<T> = T | ((old: T) => T);
+type OnChangeFn<T> = (updaterOrValue: Updater<T>) => void;
+type RowData = Record<string, any> | Array<any>;
+type CellData = unknown;
+type PartialKeys<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+type RequiredKeys<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
+type UnionToIntersection<T> = (T extends any ? (x: T) => any : never) extends ((x: infer R) => any) ? R : never;
+type ComputeRange<N extends number, Result extends Array<unknown> = []> = Result['length'] extends N ? Result : ComputeRange<N, [...Result, Result['length']]>;
+type Index40 = ComputeRange<40>[number];
+type IsTuple<T> = T extends ReadonlyArray<any> & {
+  length: infer Length;
+} ? Length extends Index40 ? T : never : never;
+type AllowedIndexes<Tuple extends ReadonlyArray<any>, Keys extends number = never> = Tuple extends readonly [] ? Keys : Tuple extends readonly [infer _, ...infer Tail] ? AllowedIndexes<Tail, Keys | Tail['length']> : Keys;
+type DeepKeys<T, TDepth extends Array<any> = []> = TDepth['length'] extends 5 ? never : unknown extends T ? string : T extends ReadonlyArray<any> & IsTuple<T> ? AllowedIndexes<T> | DeepKeysPrefix<T, AllowedIndexes<T>, TDepth> : T extends Array<any> ? DeepKeys<T[number], [...TDepth, any]> : T extends Date ? never : T extends object ? (keyof T & string) | DeepKeysPrefix<T, keyof T, TDepth> : never;
+type DeepKeysPrefix<T, TPrefix, TDepth extends Array<any>> = TPrefix extends keyof T & (number | string) ? `${TPrefix}.${DeepKeys<T[TPrefix], [...TDepth, any]> & string}` : never;
+type DeepValue<T, TProp> = T extends Record<string | number, any> ? TProp extends `${infer TBranch}.${infer TDeepProp}` ? DeepValue<T[TBranch], TDeepProp> : T[TProp & string] : never;
+type NoInfer<T> = [T][T extends any ? 0 : never];
+type Getter<TValue> = <TTValue = TValue>() => NoInfer<TTValue>;
+type Prettify<T> = { [K in keyof T]: T[K] } & unknown;
+//#endregion
+export { CellData, DeepKeys, DeepValue, Getter, NoInfer, OnChangeFn, PartialKeys, Prettify, RequiredKeys, RowData, UnionToIntersection, Updater };
+//# sourceMappingURL=type-utils.d.cts.map

package/dist/types/type-utils.d.ts

@@ -0,0 +1,23 @@
+//#region src/types/type-utils.d.ts
+type Updater<T> = T | ((old: T) => T);
+type OnChangeFn<T> = (updaterOrValue: Updater<T>) => void;
+type RowData = Record<string, any> | Array<any>;
+type CellData = unknown;
+type PartialKeys<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+type RequiredKeys<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
+type UnionToIntersection<T> = (T extends any ? (x: T) => any : never) extends ((x: infer R) => any) ? R : never;
+type ComputeRange<N extends number, Result extends Array<unknown> = []> = Result['length'] extends N ? Result : ComputeRange<N, [...Result, Result['length']]>;
+type Index40 = ComputeRange<40>[number];
+type IsTuple<T> = T extends ReadonlyArray<any> & {
+  length: infer Length;
+} ? Length extends Index40 ? T : never : never;
+type AllowedIndexes<Tuple extends ReadonlyArray<any>, Keys extends number = never> = Tuple extends readonly [] ? Keys : Tuple extends readonly [infer _, ...infer Tail] ? AllowedIndexes<Tail, Keys | Tail['length']> : Keys;
+type DeepKeys<T, TDepth extends Array<any> = []> = TDepth['length'] extends 5 ? never : unknown extends T ? string : T extends ReadonlyArray<any> & IsTuple<T> ? AllowedIndexes<T> | DeepKeysPrefix<T, AllowedIndexes<T>, TDepth> : T extends Array<any> ? DeepKeys<T[number], [...TDepth, any]> : T extends Date ? never : T extends object ? (keyof T & string) | DeepKeysPrefix<T, keyof T, TDepth> : never;
+type DeepKeysPrefix<T, TPrefix, TDepth extends Array<any>> = TPrefix extends keyof T & (number | string) ? `${TPrefix}.${DeepKeys<T[TPrefix], [...TDepth, any]> & string}` : never;
+type DeepValue<T, TProp> = T extends Record<string | number, any> ? TProp extends `${infer TBranch}.${infer TDeepProp}` ? DeepValue<T[TBranch], TDeepProp> : T[TProp & string] : never;
+type NoInfer<T> = [T][T extends any ? 0 : never];
+type Getter<TValue> = <TTValue = TValue>() => NoInfer<TTValue>;
+type Prettify<T> = { [K in keyof T]: T[K] } & unknown;
+//#endregion
+export { CellData, DeepKeys, DeepValue, Getter, NoInfer, OnChangeFn, PartialKeys, Prettify, RequiredKeys, RowData, UnionToIntersection, Updater };
+//# sourceMappingURL=type-utils.d.ts.map

package/dist/utils.cjs

@@ -0,0 +1,218 @@
+
+//#region src/utils.ts
+function functionalUpdate(updater, input) {
+	return typeof updater === "function" ? updater(input) : updater;
+}
+function cloneState(value) {
+	if (Array.isArray(value)) return value.map(cloneState);
+	if (value && typeof value === "object") {
+		const proto = Object.getPrototypeOf(value);
+		if (proto !== Object.prototype && proto !== null) return value;
+		const copy = {};
+		for (const key of Object.keys(value)) copy[key] = cloneState(value[key]);
+		return copy;
+	}
+	return value;
+}
+function noop() {}
+function makeStateUpdater(key, instance) {
+	return (updater) => {
+		var _atoms;
+		(((_atoms = instance.options.atoms) === null || _atoms === void 0 ? void 0 : _atoms[key]) ?? instance.baseAtoms[key]).set((old) => functionalUpdate(updater, old));
+	};
+}
+function isFunction(d) {
+	return d instanceof Function;
+}
+function isNumberArray(d) {
+	return Array.isArray(d) && d.every((val) => typeof val === "number");
+}
+function flattenBy(arr, getChildren) {
+	const flat = [];
+	const recurse = (subArr) => {
+		subArr.forEach((item) => {
+			flat.push(item);
+			const children = getChildren(item);
+			if (children.length) recurse(children);
+		});
+	};
+	recurse(arr);
+	return flat;
+}
+const $internalMemoFnMeta = Symbol("memoFnMeta");
+/**
+* @internal
+*/
+function setMemoFnMeta(fn, meta) {
+	Object.defineProperty(fn, $internalMemoFnMeta, { value: meta });
+}
+/**
+* @internal
+*/
+function getMemoFnMeta(fn) {
+	return (typeof fn === "function" && fn[$internalMemoFnMeta]) ?? null;
+}
+const memo = ({ fn, memoDeps, onAfterCompare, onAfterUpdate, onBeforeCompare, onBeforeUpdate }) => {
+	let deps = [];
+	let result;
+	const memoizedFn = (depArgs) => {
+		onBeforeCompare === null || onBeforeCompare === void 0 || onBeforeCompare();
+		const newDeps = memoDeps === null || memoDeps === void 0 ? void 0 : memoDeps(depArgs);
+		const depsChanged = !newDeps || newDeps.length !== (deps === null || deps === void 0 ? void 0 : deps.length) || newDeps.some((dep, index) => (deps === null || deps === void 0 ? void 0 : deps[index]) !== dep);
+		onAfterCompare === null || onAfterCompare === void 0 || onAfterCompare(depsChanged);
+		if (!depsChanged) return result;
+		deps = newDeps;
+		onBeforeUpdate === null || onBeforeUpdate === void 0 || onBeforeUpdate();
+		result = fn(...newDeps ?? []);
+		onAfterUpdate === null || onAfterUpdate === void 0 || onAfterUpdate(result);
+		return result;
+	};
+	setMemoFnMeta(memoizedFn, { originalArgsLength: fn.length });
+	return memoizedFn;
+};
+const pad = (str, num) => {
+	str = String(str);
+	while (str.length < num) str = " " + str;
+	return str;
+};
+function tableMemo({ feature, fnName, objectId, onAfterUpdate, table, ...memoOptions }) {
+	let beforeCompareTime;
+	let afterCompareTime;
+	let startCalcTime;
+	let endCalcTime;
+	let runCount = 0;
+	let debug;
+	let debugCache;
+	if (process.env.NODE_ENV === "development") {
+		const { debugCache: _debugCache, debugAll } = table.options;
+		debugCache = _debugCache;
+		const { parentName } = getFunctionNameInfo(fnName, ".");
+		debug = debugAll || table.options[`debug${(parentName != "table" ? parentName + "s" : parentName).replace(parentName, parentName.charAt(0).toUpperCase() + parentName.slice(1))}`] || (feature ? table.options[`debug${feature.charAt(0).toUpperCase() + feature.slice(1)}`] : false);
+	}
+	function logTime(time, depsChanged) {
+		var _memoOptions$memoDeps;
+		const runType = runCount === 0 ? "(1st run)" : depsChanged ? "(rerun #" + runCount + ")" : "(cache)";
+		runCount++;
+		console.groupCollapsed(`%c⏱ ${pad(`${time.toFixed(1)} ms`, 12)} %c${runType}%c ${fnName}%c ${objectId ? `(${fnName.split(".")[0]}Id: ${objectId})` : ""}`, `font-size: .6rem; font-weight: bold; ${depsChanged ? `color: hsl(
+        ${Math.max(0, Math.min(120 - Math.log10(time) * 60, 120))}deg 100% 31%);` : ""} `, `color: ${runCount < 2 ? "#FF00FF" : "#FF1493"}`, "color: #666", "color: #87CEEB");
+		console.info({
+			feature,
+			state: table.store.state,
+			deps: (_memoOptions$memoDeps = memoOptions.memoDeps) === null || _memoOptions$memoDeps === void 0 ? void 0 : _memoOptions$memoDeps.toString()
+		});
+		console.trace();
+		console.groupEnd();
+	}
+	const debugOptions = process.env.NODE_ENV === "development" ? {
+		onBeforeCompare: () => {
+			if (debugCache) beforeCompareTime = performance.now();
+		},
+		onAfterCompare: (depsChanged) => {
+			if (debugCache) {
+				afterCompareTime = performance.now();
+				const compareTime = Math.round((afterCompareTime - beforeCompareTime) * 100) / 100;
+				if (!depsChanged) logTime(compareTime, depsChanged);
+			}
+		},
+		onBeforeUpdate: () => {
+			if (debug) startCalcTime = performance.now();
+		},
+		onAfterUpdate: () => {
+			if (debug) {
+				endCalcTime = performance.now();
+				logTime(Math.round((endCalcTime - startCalcTime) * 100) / 100, true);
+			}
+			queueMicrotask(() => onAfterUpdate === null || onAfterUpdate === void 0 ? void 0 : onAfterUpdate());
+		}
+	} : { onAfterUpdate: () => {
+		queueMicrotask(() => onAfterUpdate === null || onAfterUpdate === void 0 ? void 0 : onAfterUpdate());
+	} };
+	return memo({
+		...memoOptions,
+		...debugOptions
+	});
+}
+/**
+* Assumes that a function name is in the format of `parentName_fnKey` and returns the `fnKey` and `fnName` in the format of `parentName.fnKey`.
+*/
+function getFunctionNameInfo(staticFnName, splitBy = "_") {
+	const [parentName, fnKey] = staticFnName.split(splitBy);
+	return {
+		fnKey,
+		fnName: `${parentName}.${fnKey}`,
+		parentName
+	};
+}
+/**
+* Assigns Table API methods directly to the table instance.
+* Unlike row/cell/column/header, the table is a singleton so methods are assigned directly.
+*/
+function assignTableAPIs(feature, table, apis) {
+	for (const [staticFnName, { fn, memoDeps }] of Object.entries(apis)) {
+		const { fnKey, fnName } = getFunctionNameInfo(staticFnName);
+		table[fnKey] = memoDeps ? tableMemo({
+			memoDeps,
+			fn,
+			fnName,
+			table,
+			feature
+		}) : fn;
+	}
+}
+/**
+* Assigns API methods to a prototype object for memory-efficient method sharing.
+* All instances created with this prototype will share the same method references.
+*
+* For memoized methods, the memo state is lazily created and stored on each instance.
+* This provides the best of both worlds: shared method code + per-instance caching.
+*/
+function assignPrototypeAPIs(feature, prototype, table, apis) {
+	for (const [staticFnName, { fn, memoDeps }] of Object.entries(apis)) {
+		const { fnKey, fnName } = getFunctionNameInfo(staticFnName);
+		if (memoDeps) {
+			const memoKey = `_memo_${fnKey}`;
+			prototype[fnKey] = function(...args) {
+				if (!this[memoKey]) {
+					const self = this;
+					this[memoKey] = tableMemo({
+						memoDeps: (depArgs) => memoDeps(self, depArgs),
+						fn: (...deps) => fn(self, ...deps),
+						fnName,
+						objectId: self.id,
+						table,
+						feature
+					});
+				}
+				return this[memoKey](...args);
+			};
+		} else prototype[fnKey] = function(...args) {
+			return fn(this, ...args);
+		};
+		setMemoFnMeta(prototype[fnKey], { originalArgsLength: fn.length });
+	}
+}
+/**
+* Looks to run the memoized function with the builder pattern on the object if it exists, otherwise fallback to the static method passed in.
+*/
+function callMemoOrStaticFn(obj, fnKey, staticFn, ...args) {
+	var _obj$fnKey;
+	return ((_obj$fnKey = obj[fnKey]) === null || _obj$fnKey === void 0 ? void 0 : _obj$fnKey.call(obj, ...args)) ?? staticFn(obj, ...args);
+}
+
+//#endregion
+exports.$internalMemoFnMeta = $internalMemoFnMeta;
+exports.assignPrototypeAPIs = assignPrototypeAPIs;
+exports.assignTableAPIs = assignTableAPIs;
+exports.callMemoOrStaticFn = callMemoOrStaticFn;
+exports.cloneState = cloneState;
+exports.flattenBy = flattenBy;
+exports.functionalUpdate = functionalUpdate;
+exports.getFunctionNameInfo = getFunctionNameInfo;
+exports.getMemoFnMeta = getMemoFnMeta;
+exports.isFunction = isFunction;
+exports.isNumberArray = isNumberArray;
+exports.makeStateUpdater = makeStateUpdater;
+exports.memo = memo;
+exports.noop = noop;
+exports.tableMemo = tableMemo;
+//# sourceMappingURL=utils.cjs.map

package/dist/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.cjs","names":[],"sources":["../src/utils.ts"],"sourcesContent":["import type { Table, Table_Internal } from './types/Table'\nimport type { NoInfer, RowData, Updater } from './types/type-utils'\nimport type { TableFeatures } from './types/TableFeatures'\nimport type { TableState, TableState_All } from './types/TableState'\n\nexport function functionalUpdate<T>(updater: Updater<T>, input: T): T {\n  return typeof updater === 'function'\n    ? (updater as (i: T) => T)(input)\n    : updater\n}\n\nexport function cloneState<T>(value: T): T {\n  if (Array.isArray(value)) {\n    return value.map(cloneState) as T\n  }\n\n  if (value && typeof value === 'object') {\n    const proto = Object.getPrototypeOf(value)\n\n    if (proto !== Object.prototype && proto !== null) {\n      return value\n    }\n\n    const copy: Record<string, unknown> = {}\n\n    for (const key of Object.keys(value)) {\n      copy[key] = cloneState((value as Record<string, unknown>)[key])\n    }\n\n    return copy as T\n  }\n\n  return value\n}\n\nexport function noop() {}\n\nexport function makeStateUpdater<\n  TFeatures extends TableFeatures,\n  K extends (string & {}) | keyof TableState_All | keyof TableState<TFeatures>,\n>(key: K, instance: Table<TFeatures, any>) {\n  return (updater: Updater<TableState<any>[K & keyof TableState<any>]>) => {\n    const externalAtom = (instance.options as any).atoms?.[key]\n    const targetAtom = externalAtom ?? (instance.baseAtoms as any)[key]\n    targetAtom.set((old: any) => functionalUpdate(updater, old))\n  }\n}\n\ntype AnyFunction = (...args: any) => any\n\nexport function isFunction<T extends AnyFunction>(d: any): d is T {\n  return d instanceof Function\n}\n\nexport function isNumberArray(d: any): d is Array<number> {\n  return Array.isArray(d) && d.every((val) => typeof val === 'number')\n}\n\nexport function flattenBy<TNode>(\n  arr: Array<TNode>,\n  getChildren: (item: TNode) => Array<TNode>,\n) {\n  const flat: Array<TNode> = []\n\n  const recurse = (subArr: Array<TNode>) => {\n    subArr.forEach((item) => {\n      flat.push(item)\n      const children = getChildren(item)\n      if (children.length) {\n        recurse(children)\n      }\n    })\n  }\n\n  recurse(arr)\n\n  return flat\n}\n\nexport const $internalMemoFnMeta = Symbol('memoFnMeta')\nexport type MemoFnMeta = { originalArgsLength?: number }\n\n/**\n * @internal\n */\nfunction setMemoFnMeta(fn: Function, meta: MemoFnMeta) {\n  Object.defineProperty(fn, $internalMemoFnMeta, { value: meta })\n}\n\n/**\n * @internal\n */\nexport function getMemoFnMeta(fn: any): MemoFnMeta | null {\n  return (typeof fn === 'function' && fn[$internalMemoFnMeta]) ?? null\n}\n\ninterface MemoOptions<TDeps extends ReadonlyArray<any>, TDepArgs, TResult> {\n  fn: (...args: NoInfer<TDeps>) => TResult\n  memoDeps?: (depArgs?: TDepArgs) => [...TDeps] | undefined\n  onAfterCompare?: (depsChanged: boolean) => void\n  onAfterUpdate?: (result: TResult) => void\n  onBeforeCompare?: () => void\n  onBeforeUpdate?: () => void\n}\n\nexport const memo = <TDeps extends ReadonlyArray<any>, TDepArgs, TResult>({\n  fn,\n  memoDeps,\n  onAfterCompare,\n  onAfterUpdate,\n  onBeforeCompare,\n  onBeforeUpdate,\n}: MemoOptions<TDeps, TDepArgs, TResult>): ((\n  depArgs?: TDepArgs,\n) => TResult) => {\n  let deps: Array<any> | undefined = []\n  let result: TResult | undefined\n\n  const memoizedFn = (depArgs?: TDepArgs): TResult => {\n    onBeforeCompare?.()\n    const newDeps = memoDeps?.(depArgs)\n    const depsChanged =\n      !newDeps ||\n      newDeps.length !== deps?.length ||\n      newDeps.some((dep: any, index: number) => deps?.[index] !== dep)\n    onAfterCompare?.(depsChanged)\n\n    if (!depsChanged) {\n      return result!\n    }\n\n    deps = newDeps\n\n    onBeforeUpdate?.()\n    result = fn(...(newDeps ?? ([] as any)))\n    onAfterUpdate?.(result)\n\n    return result\n  }\n\n  setMemoFnMeta(memoizedFn, { originalArgsLength: fn.length })\n\n  return memoizedFn\n}\n\ninterface TableMemoOptions<\n  TFeatures extends TableFeatures,\n  TDeps extends ReadonlyArray<any>,\n  TDepArgs,\n  TResult,\n> extends MemoOptions<TDeps, TDepArgs, TResult> {\n  feature?: keyof TFeatures & string\n  fnName: string\n  objectId?: string\n  onAfterUpdate?: () => void\n  table: Table_Internal<TFeatures, any>\n}\n\nconst pad = (str: number | string, num: number) => {\n  str = String(str)\n  while (str.length < num) {\n    str = ' ' + str\n  }\n  return str\n}\n\nexport function tableMemo<\n  TFeatures extends TableFeatures,\n  TDeps extends ReadonlyArray<any>,\n  TDepArgs,\n  TResult,\n>({\n  feature,\n  fnName,\n  objectId,\n  onAfterUpdate,\n  table,\n  ...memoOptions\n}: TableMemoOptions<TFeatures, TDeps, TDepArgs, TResult>) {\n  let beforeCompareTime: number\n  let afterCompareTime: number\n  let startCalcTime: number\n  let endCalcTime: number\n  let runCount = 0\n  let debug: boolean | undefined\n  let debugCache: boolean | undefined\n\n  if (process.env.NODE_ENV === 'development') {\n    const { debugCache: _debugCache, debugAll } = table.options\n    debugCache = _debugCache\n    const { parentName } = getFunctionNameInfo(fnName, '.')\n\n    const debugByParent =\n      // @ts-expect-error\n      table.options[\n        `debug${(parentName != 'table' ? parentName + 's' : parentName).replace(\n          parentName,\n          parentName.charAt(0).toUpperCase() + parentName.slice(1),\n        )}`\n      ]\n    const debugByFeature = feature\n      ? // @ts-expect-error\n        table.options[\n          `debug${feature.charAt(0).toUpperCase() + feature.slice(1)}`\n        ]\n      : false\n\n    debug = debugAll || debugByParent || debugByFeature\n  }\n\n  function logTime(time: number, depsChanged: boolean) {\n    const runType =\n      runCount === 0\n        ? '(1st run)'\n        : depsChanged\n          ? '(rerun #' + runCount + ')'\n          : '(cache)'\n    runCount++\n\n    console.groupCollapsed(\n      `%c⏱ ${pad(`${time.toFixed(1)} ms`, 12)} %c${runType}%c ${fnName}%c ${objectId ? `(${fnName.split('.')[0]}Id: ${objectId})` : ''}`,\n      `font-size: .6rem; font-weight: bold; ${\n        depsChanged\n          ? `color: hsl(\n        ${Math.max(0, Math.min(120 - Math.log10(time) * 60, 120))}deg 100% 31%);`\n          : ''\n      } `,\n      `color: ${runCount < 2 ? '#FF00FF' : '#FF1493'}`,\n      'color: #666',\n      'color: #87CEEB',\n    )\n    console.info({\n      feature,\n      state: table.store.state,\n      deps: memoOptions.memoDeps?.toString(),\n    })\n    console.trace()\n    console.groupEnd()\n  }\n\n  const debugOptions =\n    process.env.NODE_ENV === 'development'\n      ? {\n          onBeforeCompare: () => {\n            if (debugCache) {\n              beforeCompareTime = performance.now()\n            }\n          },\n          onAfterCompare: (depsChanged: boolean) => {\n            if (debugCache) {\n              afterCompareTime = performance.now()\n              const compareTime =\n                Math.round((afterCompareTime - beforeCompareTime) * 100) / 100\n              if (!depsChanged) {\n                logTime(compareTime, depsChanged)\n              }\n            }\n          },\n          onBeforeUpdate: () => {\n            if (debug) {\n              startCalcTime = performance.now()\n            }\n          },\n          onAfterUpdate: () => {\n            if (debug) {\n              endCalcTime = performance.now()\n              const executionTime =\n                Math.round((endCalcTime - startCalcTime) * 100) / 100\n              logTime(executionTime, true)\n            }\n            queueMicrotask(() => onAfterUpdate?.())\n          },\n        }\n      : {\n          onAfterUpdate: () => {\n            queueMicrotask(() => onAfterUpdate?.())\n          },\n        }\n\n  return memo({\n    ...memoOptions,\n    ...debugOptions,\n  })\n}\n\nexport interface API<TDeps extends ReadonlyArray<any>, TDepArgs> {\n  fn: (...args: any) => any\n  memoDeps?: (depArgs?: any) => [...any] | undefined\n}\n\nexport type APIObject<TDeps extends ReadonlyArray<any>, TDepArgs> = Record<\n  string,\n  API<TDeps, TDepArgs>\n>\n\n/**\n * Assumes that a function name is in the format of `parentName_fnKey` and returns the `fnKey` and `fnName` in the format of `parentName.fnKey`.\n */\nexport function getFunctionNameInfo(\n  staticFnName: string,\n  splitBy: '_' | '.' = '_',\n) {\n  const [parentName, fnKey] = staticFnName.split(splitBy)\n  const fnName = `${parentName}.${fnKey}`\n  return { fnKey, fnName, parentName } as {\n    fnKey: string\n    fnName: string\n    parentName: string\n  }\n}\n\n/**\n * Assigns Table API methods directly to the table instance.\n * Unlike row/cell/column/header, the table is a singleton so methods are assigned directly.\n */\nexport function assignTableAPIs<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TDeps extends ReadonlyArray<any>,\n  TDepArgs,\n>(\n  feature: keyof TFeatures & string,\n  table: Table_Internal<TFeatures, TData>,\n  apis: APIObject<TDeps, NoInfer<TDepArgs>>,\n): void {\n  for (const [staticFnName, { fn, memoDeps }] of Object.entries(apis)) {\n    const { fnKey, fnName } = getFunctionNameInfo(staticFnName)\n\n    ;(table as Record<string, any>)[fnKey] = memoDeps\n      ? tableMemo({\n          memoDeps,\n          fn,\n          fnName,\n          table,\n          feature,\n        })\n      : fn\n  }\n}\n\nexport interface PrototypeAPI<TDeps extends ReadonlyArray<any>, TDepArgs> {\n  fn: (self: any, ...args: any) => any\n  memoDeps?: (self: any, depArgs?: any) => [...any] | undefined\n}\n\nexport type PrototypeAPIObject<\n  TDeps extends ReadonlyArray<any>,\n  TDepArgs,\n> = Record<string, PrototypeAPI<TDeps, TDepArgs>>\n\n/**\n * Assigns API methods to a prototype object for memory-efficient method sharing.\n * All instances created with this prototype will share the same method references.\n *\n * For memoized methods, the memo state is lazily created and stored on each instance.\n * This provides the best of both worlds: shared method code + per-instance caching.\n */\nexport function assignPrototypeAPIs<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TDeps extends ReadonlyArray<any>,\n  TDepArgs,\n>(\n  feature: keyof TFeatures & string,\n  prototype: Record<string, any>,\n  table: Table_Internal<TFeatures, TData>,\n  apis: PrototypeAPIObject<TDeps, NoInfer<TDepArgs>>,\n): void {\n  for (const [staticFnName, { fn, memoDeps }] of Object.entries(apis)) {\n    const { fnKey, fnName } = getFunctionNameInfo(staticFnName)\n\n    if (memoDeps) {\n      // For memoized methods, create a function that lazily initializes\n      // the memo on first access and stores it on the instance\n      const memoKey = `_memo_${fnKey}`\n\n      prototype[fnKey] = function (this: any, ...args: Array<any>) {\n        // Lazily create memo on first access for this instance\n        if (!this[memoKey]) {\n          const self = this\n          this[memoKey] = tableMemo({\n            memoDeps: (depArgs) => memoDeps(self, depArgs),\n            fn: (...deps) => fn(self, ...deps),\n            fnName,\n            objectId: self.id,\n            table,\n            feature,\n          })\n        }\n        return this[memoKey](...args)\n      }\n    } else {\n      // Non-memoized methods just call the static function with `this`\n      prototype[fnKey] = function (this: any, ...args: Array<any>) {\n        return fn(this, ...args)\n      }\n    }\n\n    setMemoFnMeta(prototype[fnKey], { originalArgsLength: fn.length })\n  }\n}\n\n/**\n * Looks to run the memoized function with the builder pattern on the object if it exists, otherwise fallback to the static method passed in.\n */\nexport function callMemoOrStaticFn<\n  TObject extends Record<string, any>,\n  TStaticFn extends AnyFunction,\n>(\n  obj: TObject,\n  fnKey: string,\n  staticFn: TStaticFn,\n  ...args: Parameters<TStaticFn> extends [any, ...infer Rest] ? Rest : never\n): ReturnType<TStaticFn> {\n  return (\n    (obj[fnKey] as Function | undefined)?.(...args) ?? staticFn(obj, ...args)\n  )\n}\n"],"mappings":"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"}

package/dist/utils.d.cts

@@ -0,0 +1,91 @@
+import { NoInfer, RowData, Updater } from "./types/type-utils.cjs";
+import { TableState, TableState_All } from "./types/TableState.cjs";
+import { TableFeatures } from "./types/TableFeatures.cjs";
+import { Table, Table_Internal } from "./types/Table.cjs";
+
+//#region src/utils.d.ts
+declare function functionalUpdate<T>(updater: Updater<T>, input: T): T;
+declare function cloneState<T>(value: T): T;
+declare function noop(): void;
+declare function makeStateUpdater<TFeatures extends TableFeatures, K extends (string & {}) | keyof TableState_All | keyof TableState<TFeatures>>(key: K, instance: Table<TFeatures, any>): (updater: Updater<TableState<any>[K & keyof TableState<any>]>) => void;
+type AnyFunction = (...args: any) => any;
+declare function isFunction<T extends AnyFunction>(d: any): d is T;
+declare function isNumberArray(d: any): d is Array<number>;
+declare function flattenBy<TNode>(arr: Array<TNode>, getChildren: (item: TNode) => Array<TNode>): TNode[];
+declare const $internalMemoFnMeta: unique symbol;
+type MemoFnMeta = {
+  originalArgsLength?: number;
+};
+/**
+ * @internal
+ */
+declare function getMemoFnMeta(fn: any): MemoFnMeta | null;
+interface MemoOptions<TDeps extends ReadonlyArray<any>, TDepArgs, TResult> {
+  fn: (...args: NoInfer<TDeps>) => TResult;
+  memoDeps?: (depArgs?: TDepArgs) => [...TDeps] | undefined;
+  onAfterCompare?: (depsChanged: boolean) => void;
+  onAfterUpdate?: (result: TResult) => void;
+  onBeforeCompare?: () => void;
+  onBeforeUpdate?: () => void;
+}
+declare const memo: <TDeps extends ReadonlyArray<any>, TDepArgs, TResult>({
+  fn,
+  memoDeps,
+  onAfterCompare,
+  onAfterUpdate,
+  onBeforeCompare,
+  onBeforeUpdate
+}: MemoOptions<TDeps, TDepArgs, TResult>) => ((depArgs?: TDepArgs) => TResult);
+interface TableMemoOptions<TFeatures extends TableFeatures, TDeps extends ReadonlyArray<any>, TDepArgs, TResult> extends MemoOptions<TDeps, TDepArgs, TResult> {
+  feature?: keyof TFeatures & string;
+  fnName: string;
+  objectId?: string;
+  onAfterUpdate?: () => void;
+  table: Table_Internal<TFeatures, any>;
+}
+declare function tableMemo<TFeatures extends TableFeatures, TDeps extends ReadonlyArray<any>, TDepArgs, TResult>({
+  feature,
+  fnName,
+  objectId,
+  onAfterUpdate,
+  table,
+  ...memoOptions
+}: TableMemoOptions<TFeatures, TDeps, TDepArgs, TResult>): (depArgs?: TDepArgs | undefined) => TResult;
+interface API<TDeps extends ReadonlyArray<any>, TDepArgs> {
+  fn: (...args: any) => any;
+  memoDeps?: (depArgs?: any) => [...any] | undefined;
+}
+type APIObject<TDeps extends ReadonlyArray<any>, TDepArgs> = Record<string, API<TDeps, TDepArgs>>;
+/**
+ * Assumes that a function name is in the format of `parentName_fnKey` and returns the `fnKey` and `fnName` in the format of `parentName.fnKey`.
+ */
+declare function getFunctionNameInfo(staticFnName: string, splitBy?: '_' | '.'): {
+  fnKey: string;
+  fnName: string;
+  parentName: string;
+};
+/**
+ * Assigns Table API methods directly to the table instance.
+ * Unlike row/cell/column/header, the table is a singleton so methods are assigned directly.
+ */
+declare function assignTableAPIs<TFeatures extends TableFeatures, TData extends RowData, TDeps extends ReadonlyArray<any>, TDepArgs>(feature: keyof TFeatures & string, table: Table_Internal<TFeatures, TData>, apis: APIObject<TDeps, NoInfer<TDepArgs>>): void;
+interface PrototypeAPI<TDeps extends ReadonlyArray<any>, TDepArgs> {
+  fn: (self: any, ...args: any) => any;
+  memoDeps?: (self: any, depArgs?: any) => [...any] | undefined;
+}
+type PrototypeAPIObject<TDeps extends ReadonlyArray<any>, TDepArgs> = Record<string, PrototypeAPI<TDeps, TDepArgs>>;
+/**
+ * Assigns API methods to a prototype object for memory-efficient method sharing.
+ * All instances created with this prototype will share the same method references.
+ *
+ * For memoized methods, the memo state is lazily created and stored on each instance.
+ * This provides the best of both worlds: shared method code + per-instance caching.
+ */
+declare function assignPrototypeAPIs<TFeatures extends TableFeatures, TData extends RowData, TDeps extends ReadonlyArray<any>, TDepArgs>(feature: keyof TFeatures & string, prototype: Record<string, any>, table: Table_Internal<TFeatures, TData>, apis: PrototypeAPIObject<TDeps, NoInfer<TDepArgs>>): void;
+/**
+ * Looks to run the memoized function with the builder pattern on the object if it exists, otherwise fallback to the static method passed in.
+ */
+declare function callMemoOrStaticFn<TObject extends Record<string, any>, TStaticFn extends AnyFunction>(obj: TObject, fnKey: string, staticFn: TStaticFn, ...args: Parameters<TStaticFn> extends [any, ...infer Rest] ? Rest : never): ReturnType<TStaticFn>;
+//#endregion
+export { $internalMemoFnMeta, API, APIObject, MemoFnMeta, PrototypeAPI, PrototypeAPIObject, assignPrototypeAPIs, assignTableAPIs, callMemoOrStaticFn, cloneState, flattenBy, functionalUpdate, getFunctionNameInfo, getMemoFnMeta, isFunction, isNumberArray, makeStateUpdater, memo, noop, tableMemo };
+//# sourceMappingURL=utils.d.cts.map