@ackplus/mui-tanstack-data-grid 1.0.0

package/dist/theme/index.d.ts

@@ -0,0 +1,7 @@
+import './mui-augmentation';
+export * from './tokens';
+export * from './palette';
+export * from './use-data-table-tokens';
+export * from './create-data-table-theme';
+export type { DataTableClassKey } from './mui-augmentation';
+//# sourceMappingURL=index.d.ts.map

package/dist/theme/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AACA,OAAO,oBAAoB,CAAC;AAE5B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/theme/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Side-effect import ensures the MUI module augmentation is included.
+require("./mui-augmentation");
+__exportStar(require("./tokens"), exports);
+__exportStar(require("./palette"), exports);
+__exportStar(require("./use-data-table-tokens"), exports);
+__exportStar(require("./create-data-table-theme"), exports);

package/dist/theme/mui-augmentation.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Registers the grid as a first-class MUI themeable component, so consumers
+ * override it with the SAME standard patterns as `MuiButton` / `MuiDataGrid`:
+ *
+ *   createTheme({
+ *     palette: { tanstackDataGrid: { headerBg: '#eaeff5' } },
+ *     components: {
+ *       MuiTanstackDataGrid: {
+ *         defaultProps: { density: 'compact' },
+ *         styleOverrides: { root: { '--dt-border-color': '#e3e8ef' }, cell: { paddingInline: 12 } },
+ *       },
+ *     },
+ *   })
+ */
+import type { ComponentsOverrides } from '@mui/material/styles';
+import type { TanstackDataGridPalette } from './palette';
+import type { DataTableProps } from '../types/data-table.types';
+/** styleOverrides slot keys (the grid's themeable parts). */
+export type DataTableClassKey = 'root' | 'scroller' | 'grid' | 'toolbar' | 'header' | 'headerRow' | 'headerCell' | 'body' | 'row' | 'cell' | 'detailPanel' | 'footer' | 'pagination' | 'loadingOverlay' | 'noRowsOverlay';
+declare module '@mui/material/styles' {
+    interface ComponentNameToClassKey {
+        MuiTanstackDataGrid: DataTableClassKey;
+    }
+    interface ComponentsPropsList {
+        MuiTanstackDataGrid: Partial<DataTableProps<any>>;
+    }
+    interface Components<Theme = unknown> {
+        MuiTanstackDataGrid?: {
+            defaultProps?: ComponentsPropsList['MuiTanstackDataGrid'];
+            styleOverrides?: ComponentsOverrides<Theme>['MuiTanstackDataGrid'];
+        };
+    }
+    interface Palette {
+        tanstackDataGrid: TanstackDataGridPalette;
+    }
+    interface PaletteOptions {
+        tanstackDataGrid?: Partial<TanstackDataGridPalette>;
+    }
+}
+//# sourceMappingURL=mui-augmentation.d.ts.map

package/dist/theme/mui-augmentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mui-augmentation.d.ts","sourceRoot":"","sources":["../../src/theme/mui-augmentation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAuB,MAAM,sBAAsB,CAAC;AAErF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,6DAA6D;AAC7D,MAAM,MAAM,iBAAiB,GACvB,MAAM,GACN,UAAU,GACV,MAAM,GACN,SAAS,GACT,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,MAAM,GACN,KAAK,GACL,MAAM,GACN,aAAa,GACb,QAAQ,GACR,YAAY,GACZ,gBAAgB,GAChB,eAAe,CAAC;AAEtB,OAAO,QAAQ,sBAAsB,CAAC;IAElC,UAAU,uBAAuB;QAC7B,mBAAmB,EAAE,iBAAiB,CAAC;KAC1C;IAGD,UAAU,mBAAmB;QACzB,mBAAmB,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;KACrD;IAGD,UAAU,UAAU,CAAC,KAAK,GAAG,OAAO;QAChC,mBAAmB,CAAC,EAAE;YAClB,YAAY,CAAC,EAAE,mBAAmB,CAAC,qBAAqB,CAAC,CAAC;YAC1D,cAAc,CAAC,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAC,qBAAqB,CAAC,CAAC;SACtE,CAAC;KACL;IAGD,UAAU,OAAO;QACb,gBAAgB,EAAE,uBAAuB,CAAC;KAC7C;IACD,UAAU,cAAc;QACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;KACvD;CACJ"}

package/dist/theme/mui-augmentation.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/theme/palette.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Grid palette namespace — the "set colours once, in the theme" path.
+ *
+ * Mirrors MUI X DataGrid's `palette.DataGrid`. Every key DEFAULTS from the base
+ * MUI palette, so it is never a second source of truth: set `palette.divider`
+ * (or `palette.tanstackDataGrid.borderColor`) once and the grid follows.
+ */
+import type { Theme } from '@mui/material/styles';
+export interface TanstackDataGridPalette {
+    headerBg: string;
+    headerColor: string;
+    borderColor: string;
+    pinnedBg: string;
+    rowHoverBg: string;
+    selectedBg: string;
+    stripeBg: string;
+}
+/**
+ * Resolve the effective grid palette: user overrides
+ * (`theme.palette.tanstackDataGrid`) layered on defaults derived from the base
+ * MUI palette.
+ */
+export declare function resolveDataGridPalette(theme: Theme): TanstackDataGridPalette;
+//# sourceMappingURL=palette.d.ts.map

package/dist/theme/palette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.d.ts","sourceRoot":"","sources":["../../src/theme/palette.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,WAAW,uBAAuB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,GAAG,uBAAuB,CAa5E"}

package/dist/theme/palette.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveDataGridPalette = resolveDataGridPalette;
+/**
+ * Resolve the effective grid palette: user overrides
+ * (`theme.palette.tanstackDataGrid`) layered on defaults derived from the base
+ * MUI palette.
+ */
+function resolveDataGridPalette(theme) {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    const p = theme.palette;
+    const user = (_a = p.tanstackDataGrid) !== null && _a !== void 0 ? _a : {};
+    const dark = p.mode === 'dark';
+    return {
+        headerBg: (_b = user.headerBg) !== null && _b !== void 0 ? _b : (dark ? p.grey[900] : p.grey[100]),
+        headerColor: (_c = user.headerColor) !== null && _c !== void 0 ? _c : p.text.secondary,
+        borderColor: (_d = user.borderColor) !== null && _d !== void 0 ? _d : p.divider,
+        pinnedBg: (_e = user.pinnedBg) !== null && _e !== void 0 ? _e : p.background.paper,
+        rowHoverBg: (_f = user.rowHoverBg) !== null && _f !== void 0 ? _f : p.action.hover,
+        selectedBg: (_g = user.selectedBg) !== null && _g !== void 0 ? _g : p.action.selected,
+        stripeBg: (_h = user.stripeBg) !== null && _h !== void 0 ? _h : (dark ? 'rgba(255,255,255,0.03)' : 'rgba(0,0,0,0.02)'),
+    };
+}

package/dist/theme/tokens.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Design tokens for the data grid.
+ *
+ * Tokens are CSS custom properties whose DEFAULTS derive from the MUI theme
+ * (see `use-data-table-tokens.ts`). They are an optional override surface — the
+ * MUI theme remains the single source of truth. This mirrors how MUI X DataGrid
+ * exposes `--DataGrid-*` variables that default from `palette.DataGrid`.
+ */
+export type DataTableDensity = 'compact' | 'standard' | 'comfortable';
+export interface DensityTokens {
+    rowHeight: number;
+    headerHeight: number;
+    cellPaddingX: number;
+    cellPaddingY: number;
+    fontSize: string;
+}
+export declare const DENSITY_PRESETS: Record<DataTableDensity, DensityTokens>;
+/**
+ * The themeable CSS-variable names. Keep this the single registry of token names
+ * so render components and the resolver never drift.
+ */
+export declare const DT_VARS: {
+    readonly borderColor: "--dt-border-color";
+    readonly headerBg: "--dt-header-bg";
+    readonly headerColor: "--dt-header-color";
+    readonly rowBg: "--dt-row-bg";
+    readonly rowBgHover: "--dt-row-bg-hover";
+    readonly rowBgSelected: "--dt-row-bg-selected";
+    readonly rowBgStripe: "--dt-row-bg-stripe";
+    readonly pinnedBg: "--dt-pinned-bg";
+    readonly pinnedShadow: "--dt-pinned-shadow";
+    readonly resizeHandle: "--dt-resize-handle";
+    readonly rowHeight: "--dt-row-height";
+    readonly headerHeight: "--dt-header-height";
+    readonly cellPaddingX: "--dt-cell-padding-x";
+    readonly cellPaddingY: "--dt-cell-padding-y";
+    readonly fontSize: "--dt-font-size";
+    readonly radius: "--dt-radius";
+    readonly zHeader: "--dt-z-header";
+    readonly zPinned: "--dt-z-pinned";
+};
+export type DataTableVarName = (typeof DT_VARS)[keyof typeof DT_VARS];
+//# sourceMappingURL=tokens.d.ts.map

package/dist/theme/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/theme/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,CAAC;AAEtE,MAAM,WAAW,aAAa;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,gBAAgB,EAAE,aAAa,CAInE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;CAmBV,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,CAAC"}

package/dist/theme/tokens.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * Design tokens for the data grid.
+ *
+ * Tokens are CSS custom properties whose DEFAULTS derive from the MUI theme
+ * (see `use-data-table-tokens.ts`). They are an optional override surface — the
+ * MUI theme remains the single source of truth. This mirrors how MUI X DataGrid
+ * exposes `--DataGrid-*` variables that default from `palette.DataGrid`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DT_VARS = exports.DENSITY_PRESETS = void 0;
+exports.DENSITY_PRESETS = {
+    compact: { rowHeight: 36, headerHeight: 40, cellPaddingX: 8, cellPaddingY: 4, fontSize: '0.8125rem' },
+    standard: { rowHeight: 48, headerHeight: 52, cellPaddingX: 12, cellPaddingY: 8, fontSize: '0.875rem' },
+    comfortable: { rowHeight: 60, headerHeight: 64, cellPaddingX: 16, cellPaddingY: 12, fontSize: '0.9375rem' },
+};
+/**
+ * The themeable CSS-variable names. Keep this the single registry of token names
+ * so render components and the resolver never drift.
+ */
+exports.DT_VARS = {
+    borderColor: '--dt-border-color',
+    headerBg: '--dt-header-bg',
+    headerColor: '--dt-header-color',
+    rowBg: '--dt-row-bg',
+    rowBgHover: '--dt-row-bg-hover',
+    rowBgSelected: '--dt-row-bg-selected',
+    rowBgStripe: '--dt-row-bg-stripe',
+    pinnedBg: '--dt-pinned-bg',
+    pinnedShadow: '--dt-pinned-shadow',
+    resizeHandle: '--dt-resize-handle',
+    rowHeight: '--dt-row-height',
+    headerHeight: '--dt-header-height',
+    cellPaddingX: '--dt-cell-padding-x',
+    cellPaddingY: '--dt-cell-padding-y',
+    fontSize: '--dt-font-size',
+    radius: '--dt-radius',
+    zHeader: '--dt-z-header',
+    zPinned: '--dt-z-pinned',
+};

package/dist/theme/use-data-table-tokens.d.ts

@@ -0,0 +1,4 @@
+import type { CSSProperties } from 'react';
+import { type DataTableDensity } from './tokens';
+export declare function useDataTableTokens(density?: DataTableDensity): CSSProperties;
+//# sourceMappingURL=use-data-table-tokens.d.ts.map

package/dist/theme/use-data-table-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-data-table-tokens.d.ts","sourceRoot":"","sources":["../../src/theme/use-data-table-tokens.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,OAAO,EAA4B,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG3E,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,gBAA6B,GAAG,aAAa,CA2BxF"}

package/dist/theme/use-data-table-tokens.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useDataTableTokens = useDataTableTokens;
+/**
+ * Resolves the full set of `--dt-*` CSS variables from the MUI theme + density.
+ * Apply the returned object to the grid root's `style`; every cell/row/header
+ * then reads its visuals from `var(--dt-*)`, so a theme change restyles the grid
+ * with no per-cell work.
+ */
+const styles_1 = require("@mui/material/styles");
+const react_1 = require("react");
+const tokens_1 = require("./tokens");
+const palette_1 = require("./palette");
+function useDataTableTokens(density = 'standard') {
+    const theme = (0, styles_1.useTheme)();
+    return (0, react_1.useMemo)(() => {
+        var _a;
+        const pal = (0, palette_1.resolveDataGridPalette)(theme);
+        const d = (_a = tokens_1.DENSITY_PRESETS[density]) !== null && _a !== void 0 ? _a : tokens_1.DENSITY_PRESETS.standard;
+        const vars = {
+            [tokens_1.DT_VARS.borderColor]: pal.borderColor,
+            [tokens_1.DT_VARS.headerBg]: pal.headerBg,
+            [tokens_1.DT_VARS.headerColor]: pal.headerColor,
+            [tokens_1.DT_VARS.rowBg]: theme.palette.background.paper,
+            [tokens_1.DT_VARS.rowBgHover]: pal.rowHoverBg,
+            [tokens_1.DT_VARS.rowBgSelected]: pal.selectedBg,
+            [tokens_1.DT_VARS.rowBgStripe]: pal.stripeBg,
+            [tokens_1.DT_VARS.pinnedBg]: pal.pinnedBg,
+            [tokens_1.DT_VARS.pinnedShadow]: theme.palette.mode === 'dark' ? 'rgba(0,0,0,0.5)' : 'rgba(0,0,0,0.18)',
+            [tokens_1.DT_VARS.resizeHandle]: theme.palette.primary.main,
+            [tokens_1.DT_VARS.rowHeight]: `${d.rowHeight}px`,
+            [tokens_1.DT_VARS.headerHeight]: `${d.headerHeight}px`,
+            [tokens_1.DT_VARS.cellPaddingX]: `${d.cellPaddingX}px`,
+            [tokens_1.DT_VARS.cellPaddingY]: `${d.cellPaddingY}px`,
+            [tokens_1.DT_VARS.fontSize]: d.fontSize,
+            [tokens_1.DT_VARS.radius]: `${theme.shape.borderRadius}px`,
+            [tokens_1.DT_VARS.zHeader]: 3,
+            [tokens_1.DT_VARS.zPinned]: 2,
+        };
+        return vars;
+    }, [theme, density]);
+}

package/dist/types/api.types.d.ts

@@ -0,0 +1,156 @@
+import type { ColumnPinningState, SortingState, ColumnOrderState, Row, Table } from '@tanstack/react-table';
+import type { ColumnFilterState } from './filter.types';
+import type { SelectionState } from './selection.types';
+import type { ServerExportResult } from './export.types';
+import type { TableState, TableFilters, PaginationModel } from './state.types';
+export interface DataRefreshApiOptions {
+    resetPagination?: boolean;
+    force?: boolean;
+    reason?: string;
+}
+export type DataRefreshApiInput = boolean | DataRefreshApiOptions;
+export interface DataTableExportApiOptions {
+    filename?: string;
+    onlyVisibleColumns?: boolean;
+    onlySelectedRows?: boolean;
+    includeHeaders?: boolean;
+    chunkSize?: number;
+    strictTotalCheck?: boolean;
+    sanitizeCSV?: boolean;
+}
+/** Serializable layout snapshot returned by `api.layout.saveLayout()`. */
+export interface SavedLayout {
+    columnVisibility: Record<string, boolean>;
+    columnOrder: string[];
+    columnSizing: Record<string, number>;
+    columnPinning: ColumnPinningState;
+    pagination?: PaginationModel;
+    globalFilter?: string;
+    columnFilter?: ColumnFilterState;
+}
+/** Imperative handle exposed via `apiRef`. */
+export interface DataTableApi<T = any> {
+    table: {
+        getTable: () => Table<T>;
+    };
+    columnVisibility: {
+        showColumn: (columnId: string) => void;
+        hideColumn: (columnId: string) => void;
+        toggleColumn: (columnId: string) => void;
+        showAllColumns: () => void;
+        hideAllColumns: () => void;
+        resetColumnVisibility: () => void;
+    };
+    columnOrdering: {
+        setColumnOrder: (columnOrder: ColumnOrderState) => void;
+        moveColumn: (columnId: string, toIndex: number) => void;
+        resetColumnOrder: () => void;
+    };
+    columnPinning: {
+        pinColumnLeft: (columnId: string) => void;
+        pinColumnRight: (columnId: string) => void;
+        unpinColumn: (columnId: string) => void;
+        setPinning: (pinning: ColumnPinningState) => void;
+        resetColumnPinning: () => void;
+    };
+    columnResizing: {
+        resizeColumn: (columnId: string, width: number) => void;
+        autoSizeColumn: (columnId: string) => void;
+        autoSizeAllColumns: () => void;
+        resetColumnSizing: () => void;
+    };
+    filtering: {
+        setGlobalFilter: (filter: string) => void;
+        clearGlobalFilter: () => void;
+        setColumnFilters: (filters: ColumnFilterState, isApply?: boolean) => void;
+        addColumnFilter: (columnId: string, operator: string, value: any) => void;
+        removeColumnFilter: (filterId: string) => void;
+        clearAllFilters: () => void;
+        resetFilters: () => void;
+    };
+    sorting: {
+        setSorting: (sorting: SortingState) => void;
+        sortColumn: (columnId: string, direction: 'asc' | 'desc' | false) => void;
+        clearSorting: () => void;
+        resetSorting: () => void;
+    };
+    pagination: {
+        goToPage: (pageIndex: number) => void;
+        nextPage: () => void;
+        previousPage: () => void;
+        setPageSize: (pageSize: number) => void;
+        goToFirstPage: () => void;
+        goToLastPage: () => void;
+        resetPagination?: () => void;
+    };
+    selection: {
+        selectRow: (rowId: string) => void;
+        deselectRow: (rowId: string) => void;
+        toggleRowSelection: (rowId: string) => void;
+        selectAll: () => void;
+        deselectAll: () => void;
+        toggleSelectAll: () => void;
+        getSelectionState: () => SelectionState;
+        getSelectedCount: () => number;
+        getSelectedRows: () => Row<T>[];
+        isRowSelected: (rowId: string) => boolean;
+    };
+    data: {
+        refresh: (options?: DataRefreshApiInput) => void;
+        reload: (options?: DataRefreshApiOptions) => void;
+        resetAll: () => void;
+        getAllData: () => T[];
+        getRowData: (rowId: string) => T | undefined;
+        getRowByIndex: (index: number) => T | undefined;
+        updateRow: (rowId: string, updates: Partial<T>) => void;
+        updateRowByIndex: (index: number, updates: Partial<T>) => void;
+        insertRow: (newRow: T, index?: number) => void;
+        deleteRow: (rowId: string) => void;
+        deleteRowByIndex: (index: number) => void;
+        deleteSelectedRows: () => void;
+        replaceAllData: (newData: T[]) => void;
+        updateMultipleRows: (updates: Array<{
+            rowId: string;
+            data: Partial<T>;
+        }>) => void;
+        insertMultipleRows: (newRows: T[], startIndex?: number) => void;
+        deleteMultipleRows: (rowIds: string[]) => void;
+        updateField: (rowId: string, fieldName: keyof T, value: any) => void;
+        updateFieldByIndex: (index: number, fieldName: keyof T, value: any) => void;
+        findRows: (predicate: (row: T) => boolean) => T[];
+        findRowIndex: (predicate: (row: T) => boolean) => number;
+        getDataCount: () => number;
+        getFilteredDataCount: () => number;
+    };
+    layout: {
+        resetLayout: () => void;
+        resetAll: () => void;
+        saveLayout: () => SavedLayout;
+        restoreLayout: (layout: Partial<SavedLayout>) => void;
+    };
+    state: {
+        getTableState: () => Partial<TableState>;
+        getCurrentFilters: () => ColumnFilterState;
+        getCurrentSorting: () => SortingState;
+        getCurrentPagination: () => PaginationModel;
+        getCurrentSelection: () => SelectionState;
+        getGlobalFilter: () => string;
+    };
+    export: {
+        exportCSV: (options?: DataTableExportApiOptions) => Promise<void>;
+        exportExcel: (options?: DataTableExportApiOptions) => Promise<void>;
+        exportServerData: (options: {
+            format: 'csv' | 'excel';
+            filename?: string;
+            fetchData: (filters?: Partial<TableFilters>, selection?: SelectionState, signal?: AbortSignal) => Promise<ServerExportResult<T>>;
+            pageSize?: number;
+            includeHeaders?: boolean;
+            chunkSize?: number;
+            strictTotalCheck?: boolean;
+            sanitizeCSV?: boolean;
+        }) => Promise<void>;
+        isExporting: () => boolean;
+        cancelExport: () => void;
+    };
+}
+//# sourceMappingURL=api.types.d.ts.map

package/dist/types/api.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.types.d.ts","sourceRoot":"","sources":["../../src/types/api.types.ts"],"names":[],"mappings":"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"}

package/dist/types/api.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/column.types.d.ts

@@ -0,0 +1,60 @@
+import type { ColumnDef, ColumnDefBase, RowData, Column } from '@tanstack/react-table';
+import type { ComponentType } from 'react';
+import type { ColumnFilterRule } from './filter.types';
+export declare const DEFAULT_SELECTION_COLUMN_ID = "_selection";
+export declare const DEFAULT_EXPAND_COLUMN_ID = "_expanding";
+interface ColumnExportContext<TData, TValue> {
+    value: any;
+    row: TData;
+    rowIndex: number;
+    columnId: string;
+    columnDef: ColumnDefBase<TData, TValue>;
+}
+interface ColumnInputProps<TData extends RowData, TValue> {
+    value: any;
+    onChange: (value: any) => void;
+    filter: ColumnFilterRule;
+    column: Column<TData, TValue>;
+}
+/**
+ * Extra column-definition options, augmented onto every TanStack `ColumnDef`.
+ * (TanStack's own `size`, `minSize`, `maxSize`, `enableResizing`, `enableSorting`,
+ * `header`, `cell` remain available too.)
+ */
+declare module '@tanstack/react-table' {
+    interface ColumnDefBase<TData extends RowData, TValue> {
+        /** Data type — drives default filter operators/inputs. */
+        type?: 'boolean' | 'number' | 'date' | 'select' | 'text';
+        /** Options for `type: 'select'` columns. */
+        options?: {
+            label: string;
+            value: string;
+        }[];
+        /** Cell + header text alignment. */
+        align?: 'left' | 'center' | 'right';
+        /** Mark the column as filterable in the column-filter UI. */
+        filterable?: boolean;
+        /** Wrap cell text instead of truncating with an ellipsis (default: false). */
+        wrapText?: boolean;
+        /** Conditional class for body cells (DataGrid-style). */
+        cellClassName?: string | ((context: {
+            value: any;
+            row: TData;
+        }) => string);
+        /** Conditional class for the header cell. */
+        headerClassName?: string;
+        hideInExport?: boolean;
+        exportHeader?: string | ((context: {
+            columnId: string;
+            defaultHeader: string;
+            columnDef: ColumnDefBase<TData, TValue>;
+        }) => string);
+        exportValue?: (context: ColumnExportContext<TData, TValue>) => any;
+        exportFormat?: 'auto' | 'string' | 'number' | 'boolean' | 'json' | 'date' | ((context: ColumnExportContext<TData, TValue>) => any);
+        editComponent?: ComponentType<ColumnInputProps<TData, TValue>>;
+        filterComponent?: ComponentType<ColumnInputProps<TData, TValue>>;
+    }
+}
+export type DataTableColumn<TData extends RowData, TValue = unknown> = ColumnDef<TData, TValue>;
+export {};
+//# sourceMappingURL=column.types.d.ts.map

package/dist/types/column.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column.types.d.ts","sourceRoot":"","sources":["../../src/types/column.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIvD,eAAO,MAAM,2BAA2B,eAAe,CAAC;AACxD,eAAO,MAAM,wBAAwB,eAAe,CAAC;AAErD,UAAU,mBAAmB,CAAC,KAAK,EAAE,MAAM;IACvC,KAAK,EAAE,GAAG,CAAC;IACX,GAAG,EAAE,KAAK,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IAGjB,SAAS,EAAE,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED,UAAU,gBAAgB,CAAC,KAAK,SAAS,OAAO,EAAE,MAAM;IACpD,KAAK,EAAE,GAAG,CAAC;IACX,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;;;GAIG;AACH,OAAO,QAAQ,uBAAuB,CAAC;IACnC,UAAU,aAAa,CAAC,KAAK,SAAS,OAAO,EAAE,MAAM;QACjD,0DAA0D;QAC1D,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;QACzD,4CAA4C;QAC5C,OAAO,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC7C,oCAAoC;QACpC,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;QACpC,6DAA6D;QAC7D,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,8EAA8E;QAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,yDAAyD;QACzD,aAAa,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE;YAAE,KAAK,EAAE,GAAG,CAAC;YAAC,GAAG,EAAE,KAAK,CAAA;SAAE,KAAK,MAAM,CAAC,CAAC;QAC3E,6CAA6C;QAC7C,eAAe,CAAC,EAAE,MAAM,CAAC;QAEzB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,aAAa,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;SAAE,KAAK,MAAM,CAAC,CAAC;QACpI,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,GAAG,CAAC;QACnE,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;QAEnI,aAAa,CAAC,EAAE,aAAa,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/D,eAAe,CAAC,EAAE,aAAa,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;KACpE;CACJ;AAED,MAAM,MAAM,eAAe,CAAC,KAAK,SAAS,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC"}

package/dist/types/column.types.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_EXPAND_COLUMN_ID = exports.DEFAULT_SELECTION_COLUMN_ID = void 0;
+// Values kept identical to v1 (`_selection` / `_expanding`) so persisted v1 layout
+// snapshots (columnOrder/visibility/pinning) still resolve after upgrade.
+exports.DEFAULT_SELECTION_COLUMN_ID = '_selection';
+exports.DEFAULT_EXPAND_COLUMN_ID = '_expanding';