@ackplus/react-tanstack-data-table 1.1.12 → 1.1.13

package/dist/lib/data-table.js

@@ -89,7 +89,7 @@ const DEFAULT_INITIAL_STATE = {
  */
 exports.DataTable = (0, react_1.forwardRef)(function DataTable({ initialState, columns, data = [], totalRow = 0, idKey = 'id', extraFilter = null, footerFilter = null, 
 // Data management mode (MUI DataGrid style)
-dataMode = 'client', initialLoadData = true, onFetchData, onDataStateChange, 
+dataMode = 'client', initialLoadData = true, onFetchData, onRefreshData, onDataChange, onDataStateChange, 
 // Selection props
 enableRowSelection = false, enableMultiRowSelection = true, selectMode = 'page', isRowSelectable, onSelectionChange, 
 // Row click props
@@ -111,7 +111,7 @@ enablePagination = false, paginationMode = 'client',
 // Filtering props
 enableGlobalFilter = true, enableColumnFilter = false, filterMode = 'client', 
 // Sorting props
-enableSorting = true, sortingMode = 'client', onSortingChange, exportFilename = 'export', onExportProgress, onExportComplete, onExportError, onServerExport, onExportCancel, 
+enableSorting = true, sortingMode = 'client', onSortingChange, exportFilename = 'export', exportConcurrency = 'cancelAndRestart', exportChunkSize = 1000, exportStrictTotalCheck = false, exportSanitizeCSV = true, onExportProgress, onExportComplete, onExportError, onServerExport, onExportCancel, onExportStateChange, 
 // Styling props
 enableHover = true, enableStripes = false, tableProps = {}, fitToScreen = true, tableSize: initialTableSize = 'medium', 
 // Sticky header/footer props
@@ -184,14 +184,24 @@ logging, }, ref) {
     const [serverData, setServerData] = (0, react_1.useState)(null);
     const [serverTotal, setServerTotal] = (0, react_1.useState)(0);
     const [exportController, setExportController] = (0, react_1.useState)(null);
+    const [exportProgress, setExportProgress] = (0, react_1.useState)({});
+    const [exportPhase, setExportPhase] = (0, react_1.useState)(null);
+    const [queuedExportCount, setQueuedExportCount] = (0, react_1.useState)(0);
     // -------------------------------
     // Ref hooks (grouped together)
     // -------------------------------
     const tableContainerRef = (0, react_1.useRef)(null);
     const internalApiRef = (0, react_1.useRef)(null);
+    const exportControllerRef = (0, react_1.useRef)(null);
+    const exportQueueRef = (0, react_1.useRef)(Promise.resolve());
+    const isExternallyControlledData = (0, react_1.useMemo)(() => !onFetchData && (!!onDataChange || !!onRefreshData), [onFetchData, onDataChange, onRefreshData]);
     const { debouncedFetch, isLoading: fetchLoading } = (0, debounced_fetch_utils_1.useDebouncedFetch)(onFetchData);
-    const tableData = (0, react_1.useMemo)(() => serverData ? serverData : data, [serverData, data]);
-    const tableTotalRow = (0, react_1.useMemo)(() => serverData ? serverTotal : totalRow || data.length, [serverData, serverTotal, totalRow, data]);
+    const tableData = (0, react_1.useMemo)(() => {
+        if (isExternallyControlledData)
+            return data;
+        return serverData !== null ? serverData : data;
+    }, [isExternallyControlledData, serverData, data]);
+    const tableTotalRow = (0, react_1.useMemo)(() => (isExternallyControlledData ? (totalRow || data.length) : (serverData !== null ? serverTotal : totalRow || data.length)), [isExternallyControlledData, serverData, serverTotal, totalRow, data]);
     const tableLoading = (0, react_1.useMemo)(() => onFetchData ? (loading || fetchLoading) : loading, [onFetchData, loading, fetchLoading]);
     const enhancedColumns = (0, react_1.useMemo)(() => {
         let columnsMap = [...columns];
@@ -239,7 +249,7 @@ logging, }, ref) {
     // Callback hooks (grouped together)
     // -------------------------------
     const fetchData = (0, react_1.useCallback)(async (overrides = {}, options) => {
-        var _a, _b, _c;
+        var _a, _b, _c, _d, _e;
         if (!onFetchData) {
             if (logger.isLevelEnabled('debug')) {
                 logger.debug('onFetchData not provided, skipping fetch', { overrides, columnFilter, sorting, pagination });
@@ -253,20 +263,26 @@ logging, }, ref) {
             sorting,
             ...overrides,
         };
-        console.log('Fetching data', filters);
         if (logger.isLevelEnabled('info')) {
-            logger.info('Requesting data', { filters });
+            logger.info('Requesting data', {
+                filters,
+                reason: (_a = options === null || options === void 0 ? void 0 : options.meta) === null || _a === void 0 ? void 0 : _a.reason,
+                force: (_b = options === null || options === void 0 ? void 0 : options.meta) === null || _b === void 0 ? void 0 : _b.force,
+            });
         }
         try {
-            const delay = (_a = options === null || options === void 0 ? void 0 : options.delay) !== null && _a !== void 0 ? _a : 300; // respects 0
-            const result = await debouncedFetch(filters, delay);
+            const delay = (_c = options === null || options === void 0 ? void 0 : options.delay) !== null && _c !== void 0 ? _c : 300; // respects 0
+            const result = await debouncedFetch(filters, {
+                debounceDelay: delay,
+                meta: options === null || options === void 0 ? void 0 : options.meta,
+            });
             if (logger.isLevelEnabled('info')) {
                 logger.info('Fetch resolved', {
-                    rows: (_c = (_b = result === null || result === void 0 ? void 0 : result.data) === null || _b === void 0 ? void 0 : _b.length) !== null && _c !== void 0 ? _c : 0,
+                    rows: (_e = (_d = result === null || result === void 0 ? void 0 : result.data) === null || _d === void 0 ? void 0 : _d.length) !== null && _e !== void 0 ? _e : 0,
                     total: result === null || result === void 0 ? void 0 : result.total,
                 });
             }
-            if ((result === null || result === void 0 ? void 0 : result.data) && (result === null || result === void 0 ? void 0 : result.total) !== undefined) {
+            if (result && Array.isArray(result.data) && result.total !== undefined) {
                 setServerData(result.data);
                 setServerTotal(result.total);
             }
@@ -288,6 +304,21 @@ logging, }, ref) {
         debouncedFetch,
         logger,
     ]);
+    const normalizeRefreshOptions = (0, react_1.useCallback)((options, fallbackReason = 'refresh') => {
+        var _a, _b, _c;
+        if (typeof options === 'boolean') {
+            return {
+                resetPagination: options,
+                force: false,
+                reason: fallbackReason,
+            };
+        }
+        return {
+            resetPagination: (_a = options === null || options === void 0 ? void 0 : options.resetPagination) !== null && _a !== void 0 ? _a : false,
+            force: (_b = options === null || options === void 0 ? void 0 : options.force) !== null && _b !== void 0 ? _b : false,
+            reason: (_c = options === null || options === void 0 ? void 0 : options.reason) !== null && _c !== void 0 ? _c : fallbackReason,
+        };
+    }, []);
     const handleSelectionStateChange = (0, react_1.useCallback)((updaterOrValue) => {
         setSelectionState((prevState) => {
             const next = typeof updaterOrValue === 'function' ? updaterOrValue(prevState) : updaterOrValue;
@@ -525,12 +556,21 @@ logging, }, ref) {
     // -------------------------------
     // Effects (after callbacks)
     // -------------------------------
+    (0, react_1.useEffect)(() => {
+        if (!isExternallyControlledData || serverData === null)
+            return;
+        setServerData(null);
+        setServerTotal(0);
+    }, [isExternallyControlledData, serverData]);
     (0, react_1.useEffect)(() => {
         if (initialLoadData && onFetchData) {
             if (logger.isLevelEnabled('info')) {
                 logger.info('Initial data load triggered', { initialLoadData });
             }
-            fetchData({});
+            fetchData({}, {
+                delay: 0,
+                meta: { reason: 'initial' },
+            });
         }
         else if (logger.isLevelEnabled('debug')) {
             logger.debug('Skipping initial data load', {
@@ -559,12 +599,13 @@ logging, }, ref) {
         if (!onDataStateChange)
             return;
         const live = table.getState();
+        const liveColumnFilter = live.columnFilter;
         // only keep what you persist/store
         const payload = {
             sorting: live.sorting,
             pagination: live.pagination,
             globalFilter: live.globalFilter,
-            columnFilter: live.columnFilter,
+            columnFilter: liveColumnFilter,
             columnVisibility: live.columnVisibility,
             columnSizing: live.columnSizing,
             columnOrder: live.columnOrder,
@@ -593,7 +634,7 @@ logging, }, ref) {
         var _a;
         const resetSorting = initialStateConfig.sorting || [];
         const resetGlobalFilter = (_a = initialStateConfig.globalFilter) !== null && _a !== void 0 ? _a : '';
-        const resetColumnFilter = initialStateConfig.columnFilter || { filters: [], logic: 'AND', pendingFilters: [], pendingLogic: 'AND' };
+        const resetColumnFilter = initialStateConfig.columnFilter;
         const resetPagination = enablePagination
             ? (initialStateConfig.pagination || { pageIndex: 0, pageSize: 10 })
             : undefined;
@@ -604,14 +645,109 @@ logging, }, ref) {
             ...(resetPagination ? { pagination: resetPagination } : {}),
         };
     }, [initialStateConfig, enablePagination]);
+    const applyDataMutation = (0, react_1.useCallback)((action, updater, details = {}) => {
+        const previousData = [...tableData];
+        const nextData = updater(previousData);
+        if (nextData === previousData)
+            return nextData;
+        const nextTotal = Math.max(0, tableTotalRow + (nextData.length - previousData.length));
+        if (!isExternallyControlledData) {
+            setServerData(nextData);
+            setServerTotal(nextTotal);
+        }
+        onDataChange === null || onDataChange === void 0 ? void 0 : onDataChange(nextData, {
+            action,
+            previousData,
+            nextData,
+            totalRow: nextTotal,
+            ...details,
+        });
+        if (logger.isLevelEnabled('debug')) {
+            logger.debug('Applied data mutation', {
+                action,
+                previousCount: previousData.length,
+                nextCount: nextData.length,
+                totalRow: nextTotal,
+            });
+        }
+        return nextData;
+    }, [isExternallyControlledData, logger, onDataChange, tableData, tableTotalRow]);
+    const buildRefreshContext = (0, react_1.useCallback)((options, paginationOverride) => {
+        const state = table.getState();
+        const nextPagination = paginationOverride || state.pagination || pagination;
+        return {
+            filters: {
+                globalFilter,
+                pagination: nextPagination,
+                columnFilter,
+                sorting,
+            },
+            state: {
+                sorting,
+                pagination: nextPagination,
+                globalFilter,
+                columnFilter,
+                columnVisibility: state.columnVisibility,
+                columnSizing: state.columnSizing,
+                columnOrder: state.columnOrder,
+                columnPinning: state.columnPinning,
+            },
+            options,
+        };
+    }, [table, pagination, globalFilter, columnFilter, sorting]);
+    const triggerRefresh = (0, react_1.useCallback)(async (options, fallbackReason = 'refresh') => {
+        const normalizedOptions = normalizeRefreshOptions(options, fallbackReason);
+        const nextPagination = enablePagination
+            ? {
+                pageIndex: normalizedOptions.resetPagination ? 0 : pagination.pageIndex,
+                pageSize: pagination.pageSize,
+            }
+            : undefined;
+        const shouldUpdatePagination = !!nextPagination
+            && (nextPagination.pageIndex !== pagination.pageIndex || nextPagination.pageSize !== pagination.pageSize);
+        if (nextPagination && shouldUpdatePagination) {
+            setPagination(nextPagination);
+            onPaginationChange === null || onPaginationChange === void 0 ? void 0 : onPaginationChange(nextPagination);
+        }
+        const refreshContext = buildRefreshContext(normalizedOptions, nextPagination);
+        if (onRefreshData) {
+            await onRefreshData(refreshContext);
+            return;
+        }
+        if (onFetchData) {
+            await fetchData(nextPagination ? { pagination: nextPagination } : {}, {
+                delay: 0,
+                meta: {
+                    reason: normalizedOptions.reason,
+                    force: normalizedOptions.force,
+                },
+            });
+            return;
+        }
+        if (logger.isLevelEnabled('debug')) {
+            logger.debug('Refresh skipped because no refresh handler is configured', refreshContext);
+        }
+    }, [
+        normalizeRefreshOptions,
+        enablePagination,
+        pagination,
+        onPaginationChange,
+        buildRefreshContext,
+        onRefreshData,
+        onFetchData,
+        fetchData,
+        logger,
+    ]);
     const resetAllAndReload = (0, react_1.useCallback)(() => {
         var _a;
         const resetState = getResetState();
         setSorting(resetState.sorting || []);
         setGlobalFilter((_a = resetState.globalFilter) !== null && _a !== void 0 ? _a : '');
         setColumnFilter(resetState.columnFilter);
-        if (resetState.pagination)
+        if (resetState.pagination) {
             setPagination(resetState.pagination);
+            onPaginationChange === null || onPaginationChange === void 0 ? void 0 : onPaginationChange(resetState.pagination);
+        }
         setSelectionState(initialSelectionState);
         setExpanded({});
         // layout state
@@ -619,9 +755,114 @@ logging, }, ref) {
         setColumnSizing(initialStateConfig.columnSizing || {});
         setColumnOrder(initialStateConfig.columnOrder || []);
         setColumnPinning(initialStateConfig.columnPinning || { left: [], right: [] });
-        if (onFetchData)
-            fetchData(resetState, { delay: 0 });
-    }, [getResetState, initialSelectionState, initialStateConfig, onFetchData, fetchData]);
+        const resetOptions = normalizeRefreshOptions({
+            resetPagination: true,
+            force: true,
+            reason: 'reset',
+        }, 'reset');
+        const refreshContext = buildRefreshContext(resetOptions, resetState.pagination);
+        if (onRefreshData) {
+            void onRefreshData(refreshContext);
+            return;
+        }
+        if (onFetchData) {
+            void fetchData(resetState, {
+                delay: 0,
+                meta: {
+                    reason: resetOptions.reason,
+                    force: resetOptions.force,
+                },
+            });
+        }
+    }, [
+        getResetState,
+        initialSelectionState,
+        initialStateConfig,
+        onPaginationChange,
+        normalizeRefreshOptions,
+        buildRefreshContext,
+        onRefreshData,
+        onFetchData,
+        fetchData,
+    ]);
+    const setExportControllerSafely = (0, react_1.useCallback)((value) => {
+        setExportController((current) => {
+            const next = typeof value === 'function' ? value(current) : value;
+            exportControllerRef.current = next;
+            return next;
+        });
+    }, []);
+    const handleExportProgressInternal = (0, react_1.useCallback)((progress) => {
+        setExportProgress(progress || {});
+        onExportProgress === null || onExportProgress === void 0 ? void 0 : onExportProgress(progress);
+    }, [onExportProgress]);
+    const handleExportStateChangeInternal = (0, react_1.useCallback)((state) => {
+        setExportPhase(state.phase);
+        if (state.processedRows !== undefined
+            || state.totalRows !== undefined
+            || state.percentage !== undefined) {
+            setExportProgress({
+                processedRows: state.processedRows,
+                totalRows: state.totalRows,
+                percentage: state.percentage,
+            });
+        }
+        onExportStateChange === null || onExportStateChange === void 0 ? void 0 : onExportStateChange(state);
+    }, [onExportStateChange]);
+    const runExportWithPolicy = (0, react_1.useCallback)(async (options) => {
+        const { format, filename, mode, execute } = options;
+        const startExecution = async () => {
+            const controller = new AbortController();
+            setExportProgress({});
+            setExportControllerSafely(controller);
+            try {
+                await execute(controller);
+            }
+            finally {
+                setExportControllerSafely((current) => (current === controller ? null : current));
+            }
+        };
+        if (exportConcurrency === 'queue') {
+            setQueuedExportCount((prev) => prev + 1);
+            const runQueued = async () => {
+                setQueuedExportCount((prev) => Math.max(0, prev - 1));
+                await startExecution();
+            };
+            const queuedPromise = exportQueueRef.current
+                .catch(() => undefined)
+                .then(runQueued);
+            exportQueueRef.current = queuedPromise;
+            return queuedPromise;
+        }
+        const activeController = exportControllerRef.current;
+        if (activeController) {
+            if (exportConcurrency === 'ignoreIfRunning') {
+                handleExportStateChangeInternal({
+                    phase: 'error',
+                    mode,
+                    format,
+                    filename,
+                    message: 'An export is already running',
+                    code: 'EXPORT_IN_PROGRESS',
+                    endedAt: Date.now(),
+                });
+                onExportError === null || onExportError === void 0 ? void 0 : onExportError({
+                    message: 'An export is already running',
+                    code: 'EXPORT_IN_PROGRESS',
+                });
+                return;
+            }
+            if (exportConcurrency === 'cancelAndRestart') {
+                activeController.abort();
+            }
+        }
+        await startExecution();
+    }, [
+        exportConcurrency,
+        handleExportStateChangeInternal,
+        onExportError,
+        setExportControllerSafely,
+    ]);
     const dataTableApi = (0, react_1.useMemo)(() => {
         // helpers (avoid repeating boilerplate)
         const buildInitialOrder = () => enhancedColumns.map((col, index) => {
@@ -654,6 +895,12 @@ logging, }, ref) {
         const applyGlobalFilter = (next) => {
             handleGlobalFilterChange(next);
         };
+        const getRowIndexById = (rowsToSearch, rowId) => rowsToSearch.findIndex((row, index) => String((0, utils_1.generateRowId)(row, index, idKey)) === rowId);
+        const clampInsertIndex = (rowsToMutate, insertIndex) => {
+            if (insertIndex === undefined)
+                return rowsToMutate.length;
+            return Math.max(0, Math.min(insertIndex, rowsToMutate.length));
+        };
         return {
             table: {
                 getTable: () => table,
@@ -935,129 +1182,135 @@ logging, }, ref) {
             // Data Management (kept same, but ensure state changes go through handlers)
             // -------------------------------
             data: {
-                refresh: (resetPagination = false) => {
-                    var _a, _b, _c, _d;
-                    const allState = table.getState();
-                    const current = allState.pagination;
-                    const nextPagination = {
-                        pageIndex: resetPagination ? 0 : (_a = current === null || current === void 0 ? void 0 : current.pageIndex) !== null && _a !== void 0 ? _a : 0,
-                        pageSize: (_d = (_b = current === null || current === void 0 ? void 0 : current.pageSize) !== null && _b !== void 0 ? _b : (_c = initialStateConfig.pagination) === null || _c === void 0 ? void 0 : _c.pageSize) !== null && _d !== void 0 ? _d : 10,
-                    };
-                    // must go through handler so server fetch triggers
-                    applyPagination(nextPagination);
-                    // emit persisted state (your emitTableState effect will also do it)
-                    onDataStateChange === null || onDataStateChange === void 0 ? void 0 : onDataStateChange({ ...allState, pagination: nextPagination });
-                    fetchData === null || fetchData === void 0 ? void 0 : fetchData({ pagination: nextPagination });
-                    if (logger.isLevelEnabled("debug")) {
-                        logger.debug("Refreshing data", { nextPagination, allState });
-                    }
+                refresh: (options) => {
+                    void triggerRefresh(options, 'refresh');
                 },
-                reload: () => {
-                    const allState = table.getState();
-                    onDataStateChange === null || onDataStateChange === void 0 ? void 0 : onDataStateChange(allState);
-                    fetchData === null || fetchData === void 0 ? void 0 : fetchData();
-                    if (logger.isLevelEnabled("debug")) {
-                        logger.info("Reloading data", allState);
-                    }
+                reload: (options = {}) => {
+                    var _a, _b;
+                    void triggerRefresh({
+                        ...options,
+                        resetPagination: (_a = options.resetPagination) !== null && _a !== void 0 ? _a : false,
+                        reason: (_b = options.reason) !== null && _b !== void 0 ? _b : 'reload',
+                    }, 'reload');
                 },
-                resetAll: () => resetAllAndReload({ resetLayout: true }),
-                getAllData: () => { var _a; return ((_a = table.getRowModel().rows) === null || _a === void 0 ? void 0 : _a.map((row) => row.original)) || []; },
-                getRowData: (rowId) => { var _a, _b; return (_b = (_a = table.getRowModel().rows) === null || _a === void 0 ? void 0 : _a.find((row) => String(row.original[idKey]) === rowId)) === null || _b === void 0 ? void 0 : _b.original; },
-                getRowByIndex: (index) => { var _a, _b; return (_b = (_a = table.getRowModel().rows) === null || _a === void 0 ? void 0 : _a[index]) === null || _b === void 0 ? void 0 : _b.original; },
+                resetAll: () => resetAllAndReload(),
+                getAllData: () => [...tableData],
+                getRowData: (rowId) => {
+                    const rowIndex = getRowIndexById(tableData, rowId);
+                    return rowIndex === -1 ? undefined : tableData[rowIndex];
+                },
+                getRowByIndex: (index) => tableData[index],
                 updateRow: (rowId, updates) => {
-                    var _a;
-                    const newData = (_a = table.getRowModel().rows) === null || _a === void 0 ? void 0 : _a.map((row) => String(row.original[idKey]) === rowId ? { ...row.original, ...updates } : row.original);
-                    setServerData === null || setServerData === void 0 ? void 0 : setServerData(newData || []);
-                    if (logger.isLevelEnabled("debug"))
-                        logger.debug(`Updating row ${rowId}`, updates);
+                    applyDataMutation('updateRow', (rowsToMutate) => {
+                        const rowIndex = getRowIndexById(rowsToMutate, rowId);
+                        if (rowIndex === -1)
+                            return rowsToMutate;
+                        const nextData = [...rowsToMutate];
+                        nextData[rowIndex] = { ...nextData[rowIndex], ...updates };
+                        return nextData;
+                    }, { rowId });
                 },
                 updateRowByIndex: (index, updates) => {
-                    var _a;
-                    const newData = ((_a = table.getRowModel().rows) === null || _a === void 0 ? void 0 : _a.map((row) => row.original)) || [];
-                    if (newData[index]) {
-                        newData[index] = { ...newData[index], ...updates };
-                        setServerData(newData);
-                        if (logger.isLevelEnabled("debug"))
-                            logger.debug(`Updating row by index ${index}`, updates);
-                    }
+                    applyDataMutation('updateRowByIndex', (rowsToMutate) => {
+                        if (!rowsToMutate[index])
+                            return rowsToMutate;
+                        const nextData = [...rowsToMutate];
+                        nextData[index] = { ...nextData[index], ...updates };
+                        return nextData;
+                    }, { index });
                 },
                 insertRow: (newRow, index) => {
-                    var _a;
-                    const newData = ((_a = table.getRowModel().rows) === null || _a === void 0 ? void 0 : _a.map((row) => row.original)) || [];
-                    if (index !== undefined)
-                        newData.splice(index, 0, newRow);
-                    else
-                        newData.push(newRow);
-                    setServerData(newData || []);
-                    if (logger.isLevelEnabled("debug"))
-                        logger.debug("Inserting row", newRow);
+                    applyDataMutation('insertRow', (rowsToMutate) => {
+                        const nextData = [...rowsToMutate];
+                        nextData.splice(clampInsertIndex(nextData, index), 0, newRow);
+                        return nextData;
+                    }, { index });
                 },
                 deleteRow: (rowId) => {
-                    const newData = (table.getRowModel().rows || []).filter((row) => String(row.original[idKey]) !== rowId);
-                    setServerData === null || setServerData === void 0 ? void 0 : setServerData(newData.map((r) => r.original) || []);
-                    if (logger.isLevelEnabled("debug"))
-                        logger.debug(`Deleting row ${rowId}`);
+                    applyDataMutation('deleteRow', (rowsToMutate) => {
+                        const rowIndex = getRowIndexById(rowsToMutate, rowId);
+                        if (rowIndex === -1)
+                            return rowsToMutate;
+                        const nextData = [...rowsToMutate];
+                        nextData.splice(rowIndex, 1);
+                        return nextData;
+                    }, { rowId });
                 },
                 deleteRowByIndex: (index) => {
-                    const newData = (table.getRowModel().rows || []).map((row) => row.original);
-                    newData.splice(index, 1);
-                    setServerData(newData);
-                    if (logger.isLevelEnabled("debug"))
-                        logger.debug(`Deleting row by index ${index}`);
+                    applyDataMutation('deleteRowByIndex', (rowsToMutate) => {
+                        if (index < 0 || index >= rowsToMutate.length)
+                            return rowsToMutate;
+                        const nextData = [...rowsToMutate];
+                        nextData.splice(index, 1);
+                        return nextData;
+                    }, { index });
                 },
                 deleteSelectedRows: () => {
-                    var _a, _b;
-                    const selectedRows = ((_a = table.getSelectedRows) === null || _a === void 0 ? void 0 : _a.call(table)) || [];
-                    if (selectedRows.length === 0)
+                    var _a, _b, _c;
+                    const currentSelection = ((_a = table.getSelectionState) === null || _a === void 0 ? void 0 : _a.call(table)) || selectionState;
+                    const selectedIds = new Set((currentSelection.ids || []).map((id) => String(id)));
+                    const loadedRowIds = tableData.map((row, index) => String((0, utils_1.generateRowId)(row, index, idKey)));
+                    const deletableRowIds = currentSelection.type === 'exclude'
+                        ? loadedRowIds.filter((rowId) => !selectedIds.has(rowId))
+                        : loadedRowIds.filter((rowId) => selectedIds.has(rowId));
+                    if (deletableRowIds.length === 0)
                         return;
-                    const selectedIds = new Set(selectedRows.map((row) => String(row.original[idKey])));
-                    const newData = (table.getRowModel().rows || [])
-                        .filter((row) => !selectedIds.has(String(row.original[idKey])))
-                        .map((row) => row.original);
-                    setServerData(newData);
-                    (_b = table.deselectAll) === null || _b === void 0 ? void 0 : _b.call(table);
-                    if (logger.isLevelEnabled("debug"))
-                        logger.debug("Deleting selected rows");
+                    if (currentSelection.type === 'exclude'
+                        && table.getRowCount() > loadedRowIds.length
+                        && logger.isLevelEnabled('info')) {
+                        logger.info('deleteSelectedRows in exclude mode removed currently loaded rows only', {
+                            removedRows: deletableRowIds.length,
+                            totalSelected: (_b = table.getSelectedCount) === null || _b === void 0 ? void 0 : _b.call(table),
+                        });
+                    }
+                    const deletableRowIdSet = new Set(deletableRowIds);
+                    applyDataMutation('deleteSelectedRows', (rowsToMutate) => rowsToMutate.filter((row, index) => !deletableRowIdSet.has(String((0, utils_1.generateRowId)(row, index, idKey)))), { rowIds: deletableRowIds });
+                    (_c = table.deselectAll) === null || _c === void 0 ? void 0 : _c.call(table);
+                },
+                replaceAllData: (newData) => {
+                    applyDataMutation('replaceAllData', () => [...newData]);
                 },
-                replaceAllData: (newData) => setServerData === null || setServerData === void 0 ? void 0 : setServerData(newData),
                 updateMultipleRows: (updates) => {
-                    const updateMap = new Map(updates.map((u) => [u.rowId, u.data]));
-                    const newData = (table.getRowModel().rows || []).map((row) => {
-                        const rowId = String(row.original[idKey]);
-                        const updateData = updateMap.get(rowId);
-                        return updateData ? { ...row.original, ...updateData } : row.original;
-                    });
-                    setServerData(newData || []);
+                    const updateMap = new Map(updates.map((update) => [update.rowId, update.data]));
+                    applyDataMutation('updateMultipleRows', (rowsToMutate) => rowsToMutate.map((row, index) => {
+                        const currentRowId = String((0, utils_1.generateRowId)(row, index, idKey));
+                        const updateData = updateMap.get(currentRowId);
+                        return updateData ? { ...row, ...updateData } : row;
+                    }));
                 },
                 insertMultipleRows: (newRows, startIndex) => {
-                    const newData = (table.getRowModel().rows || []).map((row) => row.original);
-                    if (startIndex !== undefined)
-                        newData.splice(startIndex, 0, ...newRows);
-                    else
-                        newData.push(...newRows);
-                    setServerData === null || setServerData === void 0 ? void 0 : setServerData(newData);
+                    applyDataMutation('insertMultipleRows', (rowsToMutate) => {
+                        const nextData = [...rowsToMutate];
+                        nextData.splice(clampInsertIndex(nextData, startIndex), 0, ...newRows);
+                        return nextData;
+                    }, { index: startIndex });
                 },
                 deleteMultipleRows: (rowIds) => {
                     const idsToDelete = new Set(rowIds);
-                    const newData = (table.getRowModel().rows || [])
-                        .filter((row) => !idsToDelete.has(String(row.original[idKey])))
-                        .map((row) => row.original);
-                    setServerData(newData);
+                    applyDataMutation('deleteMultipleRows', (rowsToMutate) => rowsToMutate.filter((row, index) => !idsToDelete.has(String((0, utils_1.generateRowId)(row, index, idKey)))), { rowIds });
                 },
                 updateField: (rowId, fieldName, value) => {
-                    const newData = (table.getRowModel().rows || []).map((row) => String(row.original[idKey]) === rowId ? { ...row.original, [fieldName]: value } : row.original);
-                    setServerData === null || setServerData === void 0 ? void 0 : setServerData(newData);
+                    applyDataMutation('updateField', (rowsToMutate) => {
+                        const rowIndex = getRowIndexById(rowsToMutate, rowId);
+                        if (rowIndex === -1)
+                            return rowsToMutate;
+                        const nextData = [...rowsToMutate];
+                        nextData[rowIndex] = { ...nextData[rowIndex], [fieldName]: value };
+                        return nextData;
+                    }, { rowId });
                 },
                 updateFieldByIndex: (index, fieldName, value) => {
-                    const newData = (table.getRowModel().rows || []).map((row) => row.original);
-                    if (newData[index]) {
-                        newData[index] = { ...newData[index], [fieldName]: value };
-                        setServerData === null || setServerData === void 0 ? void 0 : setServerData(newData);
-                    }
+                    applyDataMutation('updateFieldByIndex', (rowsToMutate) => {
+                        if (!rowsToMutate[index])
+                            return rowsToMutate;
+                        const nextData = [...rowsToMutate];
+                        nextData[index] = { ...nextData[index], [fieldName]: value };
+                        return nextData;
+                    }, { index });
                 },
-                findRows: (predicate) => (table.getRowModel().rows || []).filter((row) => predicate(row.original)).map((row) => row.original),
-                findRowIndex: (predicate) => (table.getRowModel().rows || []).findIndex((row) => predicate(row.original)),
-                getDataCount: () => (table.getRowModel().rows || []).length || 0,
+                findRows: (predicate) => tableData.filter(predicate),
+                findRowIndex: (predicate) => tableData.findIndex(predicate),
+                getDataCount: () => tableData.length,
                 getFilteredDataCount: () => table.getFilteredRowModel().rows.length,
             },
             // -------------------------------
@@ -1072,7 +1325,7 @@ logging, }, ref) {
                     applySorting(initialStateConfig.sorting || []);
                     applyGlobalFilter((_a = initialStateConfig.globalFilter) !== null && _a !== void 0 ? _a : "");
                 },
-                resetAll: () => resetAllAndReload({ resetLayout: true }),
+                resetAll: () => resetAllAndReload(),
                 saveLayout: () => ({
                     columnVisibility: table.getState().columnVisibility,
                     columnSizing: table.getState().columnSizing,
@@ -1117,141 +1370,212 @@ logging, }, ref) {
             // -------------------------------
             export: {
                 exportCSV: async (options = {}) => {
-                    var _a;
-                    const { filename = exportFilename } = options;
-                    try {
-                        const controller = new AbortController();
-                        setExportController === null || setExportController === void 0 ? void 0 : setExportController(controller);
-                        if (dataMode === "server" && onServerExport) {
-                            const currentFilters = {
-                                globalFilter: table.getState().globalFilter,
-                                columnFilter: table.getState().columnFilter,
-                                sorting: table.getState().sorting,
-                                pagination: table.getState().pagination,
+                    const { filename = exportFilename, chunkSize = exportChunkSize, strictTotalCheck = exportStrictTotalCheck, sanitizeCSV = exportSanitizeCSV, } = options;
+                    const mode = dataMode === "server" && !!onServerExport ? 'server' : 'client';
+                    await runExportWithPolicy({
+                        format: 'csv',
+                        filename,
+                        mode,
+                        execute: async (controller) => {
+                            var _a;
+                            const toStateChange = (state) => {
+                                const isFinalPhase = state.phase === 'completed' || state.phase === 'cancelled' || state.phase === 'error';
+                                handleExportStateChangeInternal({
+                                    phase: state.phase,
+                                    mode,
+                                    format: 'csv',
+                                    filename,
+                                    processedRows: state.processedRows,
+                                    totalRows: state.totalRows,
+                                    percentage: state.percentage,
+                                    message: state.message,
+                                    code: state.code,
+                                    startedAt: state.phase === 'starting' ? Date.now() : undefined,
+                                    endedAt: isFinalPhase ? Date.now() : undefined,
+                                    queueLength: queuedExportCount,
+                                });
+                                if (state.phase === 'cancelled') {
+                                    onExportCancel === null || onExportCancel === void 0 ? void 0 : onExportCancel();
+                                }
                             };
-                            if (logger.isLevelEnabled("debug"))
-                                logger.debug("Server export CSV", { currentFilters });
-                            await (0, utils_1.exportServerData)(table, {
-                                format: "csv",
-                                filename,
-                                fetchData: (filters, selection) => onServerExport(filters, selection),
-                                currentFilters,
-                                selection: (_a = table.getSelectionState) === null || _a === void 0 ? void 0 : _a.call(table),
-                                onProgress: onExportProgress,
-                                onComplete: onExportComplete,
-                                onError: onExportError,
-                            });
-                        }
-                        else {
+                            if (mode === 'server' && onServerExport) {
+                                const currentFilters = {
+                                    globalFilter: table.getState().globalFilter,
+                                    columnFilter: table.getState().columnFilter,
+                                    sorting: table.getState().sorting,
+                                    pagination: table.getState().pagination,
+                                };
+                                if (logger.isLevelEnabled("debug"))
+                                    logger.debug("Server export CSV", { currentFilters });
+                                await (0, utils_1.exportServerData)(table, {
+                                    format: "csv",
+                                    filename,
+                                    fetchData: (filters, selection, signal) => onServerExport(filters, selection, signal),
+                                    currentFilters,
+                                    selection: (_a = table.getSelectionState) === null || _a === void 0 ? void 0 : _a.call(table),
+                                    onProgress: handleExportProgressInternal,
+                                    onComplete: onExportComplete,
+                                    onError: onExportError,
+                                    onStateChange: toStateChange,
+                                    signal: controller.signal,
+                                    chunkSize,
+                                    strictTotalCheck,
+                                    sanitizeCSV,
+                                });
+                                return;
+                            }
                             await (0, utils_1.exportClientData)(table, {
                                 format: "csv",
                                 filename,
-                                onProgress: onExportProgress,
+                                onProgress: handleExportProgressInternal,
                                 onComplete: onExportComplete,
                                 onError: onExportError,
+                                onStateChange: toStateChange,
+                                signal: controller.signal,
+                                sanitizeCSV,
                             });
                             if (logger.isLevelEnabled("debug"))
                                 logger.debug("Client export CSV", filename);
                         }
-                    }
-                    catch (error) {
-                        onExportError === null || onExportError === void 0 ? void 0 : onExportError({ message: error.message || "Export failed", code: "EXPORT_ERROR" });
-                    }
-                    finally {
-                        setExportController === null || setExportController === void 0 ? void 0 : setExportController(null);
-                    }
+                    });
                 },
                 exportExcel: async (options = {}) => {
-                    var _a;
-                    const { filename = exportFilename } = options;
-                    try {
-                        const controller = new AbortController();
-                        setExportController === null || setExportController === void 0 ? void 0 : setExportController(controller);
-                        if (dataMode === "server" && onServerExport) {
-                            const currentFilters = {
-                                globalFilter: table.getState().globalFilter,
-                                columnFilter: table.getState().columnFilter,
-                                sorting: table.getState().sorting,
-                                pagination: table.getState().pagination,
+                    const { filename = exportFilename, chunkSize = exportChunkSize, strictTotalCheck = exportStrictTotalCheck, sanitizeCSV = exportSanitizeCSV, } = options;
+                    const mode = dataMode === "server" && !!onServerExport ? 'server' : 'client';
+                    await runExportWithPolicy({
+                        format: 'excel',
+                        filename,
+                        mode,
+                        execute: async (controller) => {
+                            var _a;
+                            const toStateChange = (state) => {
+                                const isFinalPhase = state.phase === 'completed' || state.phase === 'cancelled' || state.phase === 'error';
+                                handleExportStateChangeInternal({
+                                    phase: state.phase,
+                                    mode,
+                                    format: 'excel',
+                                    filename,
+                                    processedRows: state.processedRows,
+                                    totalRows: state.totalRows,
+                                    percentage: state.percentage,
+                                    message: state.message,
+                                    code: state.code,
+                                    startedAt: state.phase === 'starting' ? Date.now() : undefined,
+                                    endedAt: isFinalPhase ? Date.now() : undefined,
+                                    queueLength: queuedExportCount,
+                                });
+                                if (state.phase === 'cancelled') {
+                                    onExportCancel === null || onExportCancel === void 0 ? void 0 : onExportCancel();
+                                }
                             };
-                            if (logger.isLevelEnabled("debug"))
-                                logger.debug("Server export Excel", { currentFilters });
-                            await (0, utils_1.exportServerData)(table, {
-                                format: "excel",
-                                filename,
-                                fetchData: (filters, selection) => onServerExport(filters, selection),
-                                currentFilters,
-                                selection: (_a = table.getSelectionState) === null || _a === void 0 ? void 0 : _a.call(table),
-                                onProgress: onExportProgress,
-                                onComplete: onExportComplete,
-                                onError: onExportError,
-                            });
-                        }
-                        else {
+                            if (mode === 'server' && onServerExport) {
+                                const currentFilters = {
+                                    globalFilter: table.getState().globalFilter,
+                                    columnFilter: table.getState().columnFilter,
+                                    sorting: table.getState().sorting,
+                                    pagination: table.getState().pagination,
+                                };
+                                if (logger.isLevelEnabled("debug"))
+                                    logger.debug("Server export Excel", { currentFilters });
+                                await (0, utils_1.exportServerData)(table, {
+                                    format: "excel",
+                                    filename,
+                                    fetchData: (filters, selection, signal) => onServerExport(filters, selection, signal),
+                                    currentFilters,
+                                    selection: (_a = table.getSelectionState) === null || _a === void 0 ? void 0 : _a.call(table),
+                                    onProgress: handleExportProgressInternal,
+                                    onComplete: onExportComplete,
+                                    onError: onExportError,
+                                    onStateChange: toStateChange,
+                                    signal: controller.signal,
+                                    chunkSize,
+                                    strictTotalCheck,
+                                    sanitizeCSV,
+                                });
+                                return;
+                            }
                             await (0, utils_1.exportClientData)(table, {
                                 format: "excel",
                                 filename,
-                                onProgress: onExportProgress,
+                                onProgress: handleExportProgressInternal,
                                 onComplete: onExportComplete,
                                 onError: onExportError,
+                                onStateChange: toStateChange,
+                                signal: controller.signal,
+                                sanitizeCSV,
                             });
                             if (logger.isLevelEnabled("debug"))
                                 logger.debug("Client export Excel", filename);
                         }
-                    }
-                    catch (error) {
-                        onExportError === null || onExportError === void 0 ? void 0 : onExportError({ message: error.message || "Export failed", code: "EXPORT_ERROR" });
-                        if (logger.isLevelEnabled("debug"))
-                            logger.debug("Server export Excel failed", error);
-                    }
-                    finally {
-                        setExportController === null || setExportController === void 0 ? void 0 : setExportController(null);
-                    }
+                    });
                 },
                 exportServerData: async (options) => {
-                    var _a;
-                    const { format, filename = exportFilename, fetchData: fetchFn = onServerExport } = options;
+                    const { format, filename = exportFilename, fetchData: fetchFn = onServerExport, chunkSize = exportChunkSize, strictTotalCheck = exportStrictTotalCheck, sanitizeCSV = exportSanitizeCSV, } = options;
                     if (!fetchFn) {
                         onExportError === null || onExportError === void 0 ? void 0 : onExportError({ message: "No server export function provided", code: "NO_SERVER_EXPORT" });
                         if (logger.isLevelEnabled("debug"))
                             logger.debug("Server export data failed", "No server export function provided");
                         return;
                     }
-                    try {
-                        const controller = new AbortController();
-                        setExportController === null || setExportController === void 0 ? void 0 : setExportController(controller);
-                        const currentFilters = {
-                            globalFilter: table.getState().globalFilter,
-                            columnFilter: table.getState().columnFilter,
-                            sorting: table.getState().sorting,
-                            pagination: table.getState().pagination,
-                        };
-                        if (logger.isLevelEnabled("debug"))
-                            logger.debug("Server export data", { currentFilters });
-                        await (0, utils_1.exportServerData)(table, {
-                            format,
-                            filename,
-                            fetchData: (filters, selection) => fetchFn(filters, selection),
-                            currentFilters,
-                            selection: (_a = table.getSelectionState) === null || _a === void 0 ? void 0 : _a.call(table),
-                            onProgress: onExportProgress,
-                            onComplete: onExportComplete,
-                            onError: onExportError,
-                        });
-                    }
-                    catch (error) {
-                        onExportError === null || onExportError === void 0 ? void 0 : onExportError({ message: error.message || "Export failed", code: "EXPORT_ERROR" });
-                        if (logger.isLevelEnabled("debug"))
-                            logger.debug("Server export data failed", error);
-                    }
-                    finally {
-                        setExportController === null || setExportController === void 0 ? void 0 : setExportController(null);
-                    }
+                    await runExportWithPolicy({
+                        format,
+                        filename,
+                        mode: 'server',
+                        execute: async (controller) => {
+                            var _a;
+                            const currentFilters = {
+                                globalFilter: table.getState().globalFilter,
+                                columnFilter: table.getState().columnFilter,
+                                sorting: table.getState().sorting,
+                                pagination: table.getState().pagination,
+                            };
+                            if (logger.isLevelEnabled("debug"))
+                                logger.debug("Server export data", { currentFilters });
+                            await (0, utils_1.exportServerData)(table, {
+                                format,
+                                filename,
+                                fetchData: (filters, selection, signal) => fetchFn(filters, selection, signal),
+                                currentFilters,
+                                selection: (_a = table.getSelectionState) === null || _a === void 0 ? void 0 : _a.call(table),
+                                onProgress: handleExportProgressInternal,
+                                onComplete: onExportComplete,
+                                onError: onExportError,
+                                onStateChange: (state) => {
+                                    const isFinalPhase = state.phase === 'completed' || state.phase === 'cancelled' || state.phase === 'error';
+                                    handleExportStateChangeInternal({
+                                        phase: state.phase,
+                                        mode: 'server',
+                                        format,
+                                        filename,
+                                        processedRows: state.processedRows,
+                                        totalRows: state.totalRows,
+                                        percentage: state.percentage,
+                                        message: state.message,
+                                        code: state.code,
+                                        startedAt: state.phase === 'starting' ? Date.now() : undefined,
+                                        endedAt: isFinalPhase ? Date.now() : undefined,
+                                        queueLength: queuedExportCount,
+                                    });
+                                    if (state.phase === 'cancelled') {
+                                        onExportCancel === null || onExportCancel === void 0 ? void 0 : onExportCancel();
+                                    }
+                                },
+                                signal: controller.signal,
+                                chunkSize,
+                                strictTotalCheck,
+                                sanitizeCSV,
+                            });
+                        }
+                    });
                 },
                 isExporting: () => isExporting || false,
                 cancelExport: () => {
-                    exportController === null || exportController === void 0 ? void 0 : exportController.abort();
-                    setExportController === null || setExportController === void 0 ? void 0 : setExportController(null);
+                    const activeController = exportControllerRef.current;
+                    if (!activeController) {
+                        return;
+                    }
+                    activeController.abort();
+                    setExportControllerSafely((current) => (current === activeController ? null : current));
                     if (logger.isLevelEnabled("debug"))
                         logger.debug("Export cancelled");
                 },
@@ -1272,17 +1596,26 @@ logging, }, ref) {
         initialStateConfig,
         enablePagination,
         idKey,
-        onDataStateChange,
-        fetchData,
+        triggerRefresh,
+        applyDataMutation,
+        tableData,
+        selectionState,
         // export
         exportFilename,
-        onExportProgress,
+        exportChunkSize,
+        exportStrictTotalCheck,
+        exportSanitizeCSV,
         onExportComplete,
         onExportError,
+        onExportCancel,
         onServerExport,
-        exportController,
+        queuedExportCount,
         isExporting,
         dataMode,
+        handleExportProgressInternal,
+        handleExportStateChangeInternal,
+        runExportWithPolicy,
+        setExportControllerSafely,
         logger,
         resetAllAndReload,
     ]);
@@ -1343,14 +1676,12 @@ logging, }, ref) {
     // Export cancel callback
     // -------------------------------
     const handleCancelExport = (0, react_1.useCallback)(() => {
-        if (exportController) {
-            exportController.abort();
-            setExportController(null);
-            if (onExportCancel) {
-                onExportCancel();
-            }
+        const activeController = exportControllerRef.current;
+        if (activeController) {
+            activeController.abort();
+            setExportControllerSafely((current) => (current === activeController ? null : current));
         }
-    }, [exportController, onExportCancel]);
+    }, [setExportControllerSafely]);
     // -------------------------------
     // Slot components
     // -------------------------------
@@ -1367,7 +1698,7 @@ logging, }, ref) {
     // -------------------------------
     return ((0, jsx_runtime_1.jsx)(data_table_context_1.DataTableProvider, { table: table, apiRef: internalApiRef, dataMode: dataMode, tableSize: tableSize, onTableSizeChange: (size) => {
             setTableSize(size);
-        }, columnFilter: columnFilter, onChangeColumnFilter: handleColumnFilterStateChange, slots: slots, slotProps: slotProps, isExporting: isExporting, exportController: exportController, onCancelExport: handleCancelExport, exportFilename: exportFilename, onExportProgress: onExportProgress, onExportComplete: onExportComplete, onExportError: onExportError, onServerExport: onServerExport, children: (0, jsx_runtime_1.jsxs)(RootComponent, { ...rootSlotProps, children: [(enableGlobalFilter || extraFilter) ? ((0, jsx_runtime_1.jsx)(ToolbarComponent, { extraFilter: extraFilter, enableGlobalFilter: enableGlobalFilter, enableColumnVisibility: enableColumnVisibility, enableColumnFilter: enableColumnFilter, enableExport: enableExport, enableReset: enableReset, enableTableSizeControl: enableTableSizeControl, enableColumnPinning: enableColumnPinning, enableRefresh: enableRefresh, ...toolbarSlotProps, refreshButtonProps: {
+        }, columnFilter: columnFilter, onChangeColumnFilter: handleColumnFilterStateChange, slots: slots, slotProps: slotProps, isExporting: isExporting, exportController: exportController, exportPhase: exportPhase, exportProgress: exportProgress, onCancelExport: handleCancelExport, exportFilename: exportFilename, onExportProgress: onExportProgress, onExportComplete: onExportComplete, onExportError: onExportError, onServerExport: onServerExport, children: (0, jsx_runtime_1.jsxs)(RootComponent, { ...rootSlotProps, children: [(enableGlobalFilter || extraFilter) ? ((0, jsx_runtime_1.jsx)(ToolbarComponent, { extraFilter: extraFilter, enableGlobalFilter: enableGlobalFilter, enableColumnVisibility: enableColumnVisibility, enableColumnFilter: enableColumnFilter, enableExport: enableExport, enableReset: enableReset, enableTableSizeControl: enableTableSizeControl, enableColumnPinning: enableColumnPinning, enableRefresh: enableRefresh, ...toolbarSlotProps, refreshButtonProps: {
                         loading: tableLoading, // disable while fetching
                         showSpinnerWhileLoading: false,
                         onRefresh: () => { var _a, _b, _c; return (_c = (_b = (_a = internalApiRef.current) === null || _a === void 0 ? void 0 : _a.data) === null || _b === void 0 ? void 0 : _b.refresh) === null || _c === void 0 ? void 0 : _c.call(_b, true); },