@ackplus/mui-tanstack-data-grid 1.0.0

package/dist/utils/export-utils.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Export subsystem — CSV + Excel, client + server (chunked), with cancellation
+ * and progress/state callbacks. Ported from v1; `xlsx` is now **lazy-loaded**
+ * via dynamic `import()` inside the Excel branch, so it's not pulled into the
+ * initial bundle and only loads when an Excel export actually runs.
+ */
+import type { Table } from '@tanstack/react-table';
+import type { SelectionState } from '../types/selection.types';
+import type { ExportPhase, ServerExportResult } from '../types/export.types';
+export interface ExportOptions {
+    format: 'csv' | 'excel';
+    filename: string;
+    onProgress?: (progress: {
+        processedRows?: number;
+        totalRows?: number;
+        percentage?: number;
+    }) => void;
+    onComplete?: (result: {
+        success: boolean;
+        filename: string;
+        totalRows: number;
+    }) => void;
+    onError?: (error: {
+        message: string;
+        code: string;
+    }) => void;
+    onStateChange?: (state: {
+        phase: ExportPhase;
+        processedRows?: number;
+        totalRows?: number;
+        percentage?: number;
+        message?: string;
+        code?: string;
+    }) => void;
+    signal?: AbortSignal;
+    sanitizeCSV?: boolean;
+}
+export interface ServerExportOptions extends ExportOptions {
+    fetchData: (filters?: any, selection?: SelectionState, signal?: AbortSignal) => Promise<ServerExportResult<any>>;
+    currentFilters?: any;
+    selection?: SelectionState;
+    chunkSize?: number;
+    strictTotalCheck?: boolean;
+}
+/** Client export: selected rows if any, else filtered rows; visible non-hidden columns. */
+export declare function exportClientData<TData>(table: Table<TData>, options: ExportOptions): Promise<void>;
+/** Server export: chunked fetch (or direct blob/fileUrl), then build the file. */
+export declare function exportServerData<TData>(table: Table<TData>, options: ServerExportOptions): Promise<void>;
+//# sourceMappingURL=export-utils.d.ts.map

package/dist/utils/export-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-utils.d.ts","sourceRoot":"","sources":["../../src/utils/export-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACrG,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACzF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7D,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QACpB,KAAK,EAAE,WAAW,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;KACjB,KAAK,IAAI,CAAC;IACX,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACtD,SAAS,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC;IACjH,cAAc,CAAC,EAAE,GAAG,CAAC;IACrB,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AA4FD,2FAA2F;AAC3F,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDxG;AAED,kFAAkF;AAClF,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4H9G"}

package/dist/utils/export-utils.js

@@ -0,0 +1,372 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exportClientData = exportClientData;
+exports.exportServerData = exportServerData;
+const EXPORT_CANCELLED_CODE = 'CANCELLED';
+const DEFAULT_CHUNK_SIZE = 1000;
+const MAX_SERVER_EXPORT_PAGES = 10000;
+function createCancelledExportError() {
+    const error = new Error('Export cancelled');
+    error.name = 'AbortError';
+    error.code = EXPORT_CANCELLED_CODE;
+    return error;
+}
+function isCancelledError(error) {
+    if (!(error instanceof Error))
+        return false;
+    return error.name === 'AbortError' || error.code === EXPORT_CANCELLED_CODE;
+}
+function throwIfExportCancelled(signal) {
+    if (signal === null || signal === void 0 ? void 0 : signal.aborted)
+        throw createCancelledExportError();
+}
+function waitWithAbort(ms, signal) {
+    if (!signal)
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            signal.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            signal.removeEventListener('abort', onAbort);
+            reject(createCancelledExportError());
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+    });
+}
+function notifyState(onStateChange, state) {
+    onStateChange === null || onStateChange === void 0 ? void 0 : onStateChange(state);
+}
+function isServerExportDataResult(result) {
+    return !!result && typeof result === 'object' && 'data' in result && Array.isArray(result.data);
+}
+function isServerExportBlobResult(result) {
+    return !!result && typeof result === 'object' && 'blob' in result && result.blob instanceof Blob;
+}
+function isServerExportFileUrlResult(result) {
+    return !!result && typeof result === 'object' && typeof result.fileUrl === 'string';
+}
+function resolveExportHeader(columnDef, columnId) {
+    var _a;
+    const defaultHeader = typeof (columnDef === null || columnDef === void 0 ? void 0 : columnDef.header) === 'string' ? columnDef.header : columnId;
+    if ((columnDef === null || columnDef === void 0 ? void 0 : columnDef.exportHeader) === undefined || (columnDef === null || columnDef === void 0 ? void 0 : columnDef.exportHeader) === null)
+        return defaultHeader;
+    if (typeof columnDef.exportHeader === 'function') {
+        return String((_a = columnDef.exportHeader({ columnId, defaultHeader, columnDef })) !== null && _a !== void 0 ? _a : defaultHeader);
+    }
+    return String(columnDef.exportHeader);
+}
+function applyExportValueTransform(columnDef, value, row, rowIndex, columnId) {
+    if (typeof (columnDef === null || columnDef === void 0 ? void 0 : columnDef.exportValue) === 'function') {
+        return columnDef.exportValue({ value, row, rowIndex, columnId, columnDef });
+    }
+    return value;
+}
+function applyExportFormatTransform(columnDef, value, row, rowIndex, columnId) {
+    const format = columnDef === null || columnDef === void 0 ? void 0 : columnDef.exportFormat;
+    if (!format || format === 'auto')
+        return value;
+    if (typeof format === 'function')
+        return format({ value, row, rowIndex, columnId, columnDef });
+    if (value === null || value === undefined)
+        return '';
+    switch (format) {
+        case 'string': return String(value);
+        case 'number': return Number(value);
+        case 'boolean': return Boolean(value);
+        case 'json': return JSON.stringify(value);
+        case 'date': return value instanceof Date ? value.toISOString() : String(value);
+        default: return value;
+    }
+}
+function normalizeExportValue(value) {
+    if (value === null || value === undefined)
+        return '';
+    if (value instanceof Date)
+        return value.toISOString();
+    if (typeof value === 'object')
+        return JSON.stringify(value);
+    return value;
+}
+/** Client export: selected rows if any, else filtered rows; visible non-hidden columns. */
+async function exportClientData(table, options) {
+    var _a;
+    const { format, filename, onProgress, onComplete, onError, onStateChange, signal, sanitizeCSV = true } = options;
+    try {
+        throwIfExportCancelled(signal);
+        notifyState(onStateChange, { phase: 'starting' });
+        const selectedRows = table.getSelectedRows ? table.getSelectedRows() : [];
+        const rowsToExport = selectedRows.length > 0 ? selectedRows : table.getFilteredRowModel().rows;
+        const exportData = [];
+        const visibleColumns = table.getVisibleLeafColumns().filter((col) => col.columnDef.hideInExport !== true);
+        for (let index = 0; index < rowsToExport.length; index++) {
+            throwIfExportCancelled(signal);
+            const row = rowsToExport[index];
+            const percentage = Math.round(((index + 1) / rowsToExport.length) * 100);
+            onProgress === null || onProgress === void 0 ? void 0 : onProgress({ processedRows: index + 1, totalRows: rowsToExport.length, percentage });
+            notifyState(onStateChange, { phase: 'processing', processedRows: index + 1, totalRows: rowsToExport.length, percentage });
+            const rowData = {};
+            for (const column of visibleColumns) {
+                const columnDef = column.columnDef;
+                const header = resolveExportHeader(columnDef, column.id);
+                const cell = row.getVisibleCells().find((c) => c.column.id === column.id);
+                const baseValue = cell ? cell.getValue() : (_a = row === null || row === void 0 ? void 0 : row.original) === null || _a === void 0 ? void 0 : _a[column.id];
+                const transformedValue = applyExportFormatTransform(columnDef, applyExportValueTransform(columnDef, baseValue, row.original, index, column.id), row.original, index, column.id);
+                rowData[header] = normalizeExportValue(transformedValue);
+            }
+            exportData.push(rowData);
+        }
+        notifyState(onStateChange, { phase: 'downloading', processedRows: exportData.length, totalRows: exportData.length, percentage: 100 });
+        await exportToFile(exportData, format, filename, signal, sanitizeCSV);
+        const resolvedName = `${filename}.${format === 'excel' ? 'xlsx' : 'csv'}`;
+        onComplete === null || onComplete === void 0 ? void 0 : onComplete({ success: true, filename: resolvedName, totalRows: exportData.length });
+        notifyState(onStateChange, { phase: 'completed', processedRows: exportData.length, totalRows: exportData.length, percentage: 100 });
+    }
+    catch (error) {
+        if (isCancelledError(error)) {
+            notifyState(onStateChange, { phase: 'cancelled', code: EXPORT_CANCELLED_CODE });
+            return;
+        }
+        // eslint-disable-next-line no-console
+        console.error('Client export failed:', error);
+        const message = error instanceof Error ? error.message : 'Export failed';
+        notifyState(onStateChange, { phase: 'error', message, code: 'CLIENT_EXPORT_ERROR' });
+        onError === null || onError === void 0 ? void 0 : onError({ message, code: 'CLIENT_EXPORT_ERROR' });
+    }
+}
+/** Server export: chunked fetch (or direct blob/fileUrl), then build the file. */
+async function exportServerData(table, options) {
+    var _a, _b, _c, _d;
+    const { format, filename, fetchData, currentFilters, selection, onProgress, onComplete, onError, onStateChange, signal, chunkSize = DEFAULT_CHUNK_SIZE, strictTotalCheck = false, sanitizeCSV = true, } = options;
+    try {
+        throwIfExportCancelled(signal);
+        notifyState(onStateChange, { phase: 'starting' });
+        onProgress === null || onProgress === void 0 ? void 0 : onProgress({});
+        notifyState(onStateChange, { phase: 'fetching' });
+        const initialResponse = await fetchData({ ...currentFilters, pagination: { pageIndex: 0, pageSize: 1 } }, selection, signal);
+        if (isServerExportBlobResult(initialResponse)) {
+            throwIfExportCancelled(signal);
+            const resolvedName = initialResponse.filename || `${filename}.${format === 'excel' ? 'xlsx' : 'csv'}`;
+            notifyState(onStateChange, { phase: 'downloading' });
+            downloadFile(initialResponse.blob, resolvedName, initialResponse.mimeType || initialResponse.blob.type || 'application/octet-stream');
+            onComplete === null || onComplete === void 0 ? void 0 : onComplete({ success: true, filename: resolvedName, totalRows: (_a = initialResponse.total) !== null && _a !== void 0 ? _a : 0 });
+            notifyState(onStateChange, { phase: 'completed' });
+            return;
+        }
+        if (isServerExportFileUrlResult(initialResponse)) {
+            throwIfExportCancelled(signal);
+            const resolvedName = initialResponse.filename || `${filename}.${format === 'excel' ? 'xlsx' : 'csv'}`;
+            notifyState(onStateChange, { phase: 'downloading' });
+            await downloadFromUrl(initialResponse.fileUrl, resolvedName, initialResponse.mimeType || 'application/octet-stream', signal);
+            onComplete === null || onComplete === void 0 ? void 0 : onComplete({ success: true, filename: resolvedName, totalRows: (_b = initialResponse.total) !== null && _b !== void 0 ? _b : 0 });
+            notifyState(onStateChange, { phase: 'completed' });
+            return;
+        }
+        if (!isServerExportDataResult(initialResponse))
+            throw new Error('Invalid data received from server');
+        const totalRows = typeof initialResponse.total === 'number' ? initialResponse.total : initialResponse.data.length;
+        const hasTotal = typeof totalRows === 'number' && totalRows >= 0;
+        let allData = [];
+        for (let page = 0; page < MAX_SERVER_EXPORT_PAGES; page++) {
+            throwIfExportCancelled(signal);
+            const chunkResponse = await fetchData({ ...currentFilters, pagination: { pageIndex: page, pageSize: chunkSize } }, selection, signal);
+            if (isServerExportBlobResult(chunkResponse)) {
+                throwIfExportCancelled(signal);
+                const resolvedName = chunkResponse.filename || `${filename}.${format === 'excel' ? 'xlsx' : 'csv'}`;
+                notifyState(onStateChange, { phase: 'downloading' });
+                downloadFile(chunkResponse.blob, resolvedName, chunkResponse.mimeType || chunkResponse.blob.type || 'application/octet-stream');
+                onComplete === null || onComplete === void 0 ? void 0 : onComplete({ success: true, filename: resolvedName, totalRows: (_c = chunkResponse.total) !== null && _c !== void 0 ? _c : allData.length });
+                notifyState(onStateChange, { phase: 'completed' });
+                return;
+            }
+            if (isServerExportFileUrlResult(chunkResponse)) {
+                throwIfExportCancelled(signal);
+                const resolvedName = chunkResponse.filename || `${filename}.${format === 'excel' ? 'xlsx' : 'csv'}`;
+                notifyState(onStateChange, { phase: 'downloading' });
+                await downloadFromUrl(chunkResponse.fileUrl, resolvedName, chunkResponse.mimeType || 'application/octet-stream', signal);
+                onComplete === null || onComplete === void 0 ? void 0 : onComplete({ success: true, filename: resolvedName, totalRows: (_d = chunkResponse.total) !== null && _d !== void 0 ? _d : allData.length });
+                notifyState(onStateChange, { phase: 'completed' });
+                return;
+            }
+            if (!isServerExportDataResult(chunkResponse))
+                throw new Error(`Failed to fetch chunk ${page + 1}`);
+            const chunkData = chunkResponse.data;
+            if (chunkData.length === 0)
+                break;
+            allData.push(...chunkData);
+            const percentage = hasTotal && totalRows > 0 ? Math.min(100, Math.round((allData.length / totalRows) * 100)) : undefined;
+            onProgress === null || onProgress === void 0 ? void 0 : onProgress({ processedRows: allData.length, totalRows: hasTotal ? totalRows : undefined, percentage });
+            notifyState(onStateChange, { phase: 'fetching', processedRows: allData.length, totalRows: hasTotal ? totalRows : undefined, percentage });
+            if (hasTotal) {
+                if (allData.length >= totalRows)
+                    break;
+            }
+            else if (chunkData.length < chunkSize) {
+                break;
+            }
+            await waitWithAbort(100, signal);
+        }
+        if (hasTotal && allData.length > totalRows)
+            allData = allData.slice(0, totalRows);
+        if (hasTotal && strictTotalCheck && allData.length < totalRows) {
+            throw new Error(`Expected ${totalRows} rows for export but received ${allData.length}`);
+        }
+        throwIfExportCancelled(signal);
+        const visibleColumns = table.getVisibleLeafColumns().filter((col) => col.getIsVisible() && col.columnDef.hideInExport !== true);
+        const exportData = [];
+        for (let index = 0; index < allData.length; index++) {
+            throwIfExportCancelled(signal);
+            const rowData = allData[index];
+            const exportRow = {};
+            visibleColumns.forEach((column) => {
+                const columnDef = column.columnDef;
+                const header = resolveExportHeader(columnDef, column.id);
+                let value = rowData[column.id];
+                if (typeof column.accessorFn === 'function')
+                    value = column.accessorFn(rowData, index);
+                value = applyExportValueTransform(columnDef, value, rowData, index, column.id);
+                value = applyExportFormatTransform(columnDef, value, rowData, index, column.id);
+                exportRow[header] = normalizeExportValue(value);
+            });
+            exportData.push(exportRow);
+            if (allData.length > 0) {
+                notifyState(onStateChange, { phase: 'processing', processedRows: index + 1, totalRows: allData.length, percentage: Math.round(((index + 1) / allData.length) * 100) });
+            }
+        }
+        notifyState(onStateChange, { phase: 'downloading' });
+        await exportToFile(exportData, format, filename, signal, sanitizeCSV);
+        const resolvedName = `${filename}.${format === 'excel' ? 'xlsx' : 'csv'}`;
+        onComplete === null || onComplete === void 0 ? void 0 : onComplete({ success: true, filename: resolvedName, totalRows: exportData.length });
+        notifyState(onStateChange, { phase: 'completed', processedRows: exportData.length, totalRows: exportData.length, percentage: 100 });
+    }
+    catch (error) {
+        if (isCancelledError(error)) {
+            notifyState(onStateChange, { phase: 'cancelled', code: EXPORT_CANCELLED_CODE });
+            return;
+        }
+        // eslint-disable-next-line no-console
+        console.error('Server export failed:', error);
+        const message = error instanceof Error ? error.message : 'Export failed';
+        notifyState(onStateChange, { phase: 'error', message, code: 'SERVER_EXPORT_ERROR' });
+        onError === null || onError === void 0 ? void 0 : onError({ message, code: 'SERVER_EXPORT_ERROR' });
+    }
+}
+async function exportToFile(data, format, filename, signal, sanitizeCSV = true) {
+    throwIfExportCancelled(signal);
+    if (data.length === 0)
+        throw new Error('No data to export');
+    if (format === 'csv') {
+        const csv = convertToCSV(data, sanitizeCSV);
+        throwIfExportCancelled(signal);
+        downloadFile(csv, `${filename}.csv`, 'text/csv');
+    }
+    else {
+        // Lazy-load xlsx only when an Excel export actually runs.
+        const XLSX = await Promise.resolve().then(() => __importStar(require('xlsx')));
+        const workbook = XLSX.utils.book_new();
+        const worksheet = XLSX.utils.json_to_sheet(data);
+        XLSX.utils.book_append_sheet(workbook, worksheet, 'Data');
+        const excelBuffer = XLSX.write(workbook, { bookType: 'xlsx', type: 'array' });
+        const blob = new Blob([excelBuffer], { type: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' });
+        throwIfExportCancelled(signal);
+        downloadFile(blob, `${filename}.xlsx`, 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
+    }
+}
+function convertToCSV(data, sanitizeCSV) {
+    if (data.length === 0)
+        return '';
+    const headers = Object.keys(data[0]);
+    const csvRows = [headers.join(',')];
+    for (const row of data) {
+        const values = headers.map((header) => {
+            var _a;
+            const rawValue = (_a = row[header]) !== null && _a !== void 0 ? _a : '';
+            const normalizedValue = sanitizeCSV ? sanitizeCSVCellValue(rawValue) : rawValue;
+            const value = normalizedValue === null || normalizedValue === undefined ? '' : String(normalizedValue);
+            if (value.includes(',') || value.includes('"') || value.includes('\n')) {
+                return `"${value.replace(/"/g, '""')}"`;
+            }
+            return value;
+        });
+        csvRows.push(values.join(','));
+    }
+    return csvRows.join('\n');
+}
+function sanitizeCSVCellValue(value) {
+    if (typeof value !== 'string' || value.length === 0)
+        return value;
+    const first = value[0];
+    if (first === '=' || first === '+' || first === '-' || first === '@')
+        return `'${value}`;
+    return value;
+}
+async function downloadFromUrl(url, filename, mimeType, signal) {
+    throwIfExportCancelled(signal);
+    try {
+        const response = await fetch(url, { signal });
+        if (!response.ok)
+            throw new Error(`Failed to download export file from URL (${response.status})`);
+        const blob = await response.blob();
+        throwIfExportCancelled(signal);
+        downloadFile(blob, filename, mimeType || blob.type || 'application/octet-stream');
+    }
+    catch (error) {
+        if (isCancelledError(error))
+            throw error;
+        // Fallback for URLs that block fetch (CORS) — let the browser handle it.
+        const link = document.createElement('a');
+        link.href = url;
+        link.download = filename;
+        link.style.display = 'none';
+        document.body.appendChild(link);
+        link.click();
+        document.body.removeChild(link);
+    }
+}
+function downloadFile(content, filename, mimeType) {
+    const blob = content instanceof Blob ? content : new Blob([content], { type: mimeType });
+    const url = URL.createObjectURL(blob);
+    const link = document.createElement('a');
+    link.href = url;
+    link.download = filename;
+    link.style.display = 'none';
+    document.body.appendChild(link);
+    link.click();
+    document.body.removeChild(link);
+    URL.revokeObjectURL(url);
+}

package/dist/utils/index.d.ts

@@ -0,0 +1,7 @@
+export * from './table-helpers';
+export * from './debounced-fetch.utils';
+export * from './column-helpers';
+export * from './special-columns';
+export * from './logger';
+export * from './export-utils';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC"}

package/dist/utils/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 });
+__exportStar(require("./table-helpers"), exports);
+__exportStar(require("./debounced-fetch.utils"), exports);
+__exportStar(require("./column-helpers"), exports);
+__exportStar(require("./special-columns"), exports);
+__exportStar(require("./logger"), exports);
+__exportStar(require("./export-utils"), exports);

package/dist/utils/logger.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Lightweight, configurable console wrapper (global or per-instance). Ported
+ * from v1 unchanged; option/level types now live in `../types/logging.types`.
+ */
+import type { LogLevel, ConsoleLike, DataTableLoggingOptions } from '../types/logging.types';
+type LoggerInput = boolean | DataTableLoggingOptions;
+type ResolvedLoggerConfig = Required<Omit<DataTableLoggingOptions, 'logger'>> & {
+    logger: ConsoleLike;
+};
+type LogMethodLevel = Exclude<LogLevel, 'silent'>;
+export interface LoggerInstance {
+    debug: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+    child: (scope: string, overrides?: LoggerInput) => LoggerInstance;
+    isLevelEnabled: (level: LogMethodLevel) => boolean;
+    config: ResolvedLoggerConfig;
+}
+export declare const createLogger: (scope?: string, input?: LoggerInput, parentConfig?: ResolvedLoggerConfig) => LoggerInstance;
+export declare const configureDataTableLogging: (options: DataTableLoggingOptions) => void;
+export declare const getDataTableLoggingConfig: () => ResolvedLoggerConfig;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAE7F,KAAK,WAAW,GAAG,OAAO,GAAG,uBAAuB,CAAC;AAErD,KAAK,oBAAoB,GAAG,QAAQ,CAAC,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC,CAAC,GAAG;IAC5E,MAAM,EAAE,WAAW,CAAC;CACvB,CAAC;AAEF,KAAK,cAAc,GAAG,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAwElD,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,WAAW,KAAK,cAAc,CAAC;IAClE,cAAc,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC;IACnD,MAAM,EAAE,oBAAoB,CAAC;CAChC;AAoBD,eAAO,MAAM,YAAY,GACrB,QAAQ,MAAM,EACd,QAAQ,WAAW,EACnB,eAAe,oBAAoB,KACpC,cAiBF,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,SAAS,uBAAuB,SAEzE,CAAC;AAEF,eAAO,MAAM,yBAAyB,QAAO,oBAA6C,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDataTableLoggingConfig = exports.configureDataTableLogging = exports.createLogger = void 0;
+const LOG_LEVEL_ORDER = {
+    silent: 0,
+    error: 1,
+    warn: 2,
+    info: 3,
+    debug: 4,
+};
+const defaultConsole = typeof console !== 'undefined'
+    ? console
+    : {
+        log: () => undefined,
+        debug: () => undefined,
+        info: () => undefined,
+        warn: () => undefined,
+        error: () => undefined,
+    };
+let globalConfig = {
+    enabled: false,
+    level: 'warn',
+    prefix: 'DataTable',
+    scope: '',
+    includeTimestamp: false,
+    logger: defaultConsole,
+};
+const isLevelEnabled = (level, config) => {
+    if (!config.enabled)
+        return false;
+    return LOG_LEVEL_ORDER[level] <= LOG_LEVEL_ORDER[config.level];
+};
+const formatPrefix = (level, config) => {
+    const segments = [];
+    if (config.prefix)
+        segments.push(config.prefix);
+    if (config.scope)
+        segments.push(config.scope);
+    const prefix = segments.length > 0 ? `[${segments.join(':')}]` : '';
+    return config.includeTimestamp
+        ? `[${new Date().toISOString()}]${prefix ? ` ${prefix}` : ''} [${level.toUpperCase()}]`
+        : `${prefix ? `${prefix} ` : ''}[${level.toUpperCase()}]`;
+};
+const getConsoleMethod = (level, logger) => {
+    var _a, _b, _c;
+    const methodName = level === 'debug' ? 'debug' : level;
+    return (_c = (_b = (_a = logger[methodName]) !== null && _a !== void 0 ? _a : logger.log) !== null && _b !== void 0 ? _b : defaultConsole.log) !== null && _c !== void 0 ? _c : (() => undefined);
+};
+const normaliseInput = (input) => {
+    if (typeof input === 'boolean')
+        return { enabled: input };
+    return input !== null && input !== void 0 ? input : {};
+};
+const resolveConfig = (scope, input, parent) => {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+    const overrides = normaliseInput(input);
+    const base = parent !== null && parent !== void 0 ? parent : globalConfig;
+    return {
+        enabled: (_a = overrides.enabled) !== null && _a !== void 0 ? _a : base.enabled,
+        level: (_b = overrides.level) !== null && _b !== void 0 ? _b : base.level,
+        prefix: (_c = overrides.prefix) !== null && _c !== void 0 ? _c : base.prefix,
+        scope: (_f = (_e = (_d = overrides.scope) !== null && _d !== void 0 ? _d : scope) !== null && _e !== void 0 ? _e : base.scope) !== null && _f !== void 0 ? _f : '',
+        includeTimestamp: (_g = overrides.includeTimestamp) !== null && _g !== void 0 ? _g : base.includeTimestamp,
+        logger: (_j = (_h = overrides.logger) !== null && _h !== void 0 ? _h : base.logger) !== null && _j !== void 0 ? _j : defaultConsole,
+    };
+};
+const createLoggerMethods = (config) => {
+    const logWithLevel = (level) => {
+        const consoleMethod = getConsoleMethod(level, config.logger);
+        return (...args) => {
+            if (!isLevelEnabled(level, config))
+                return;
+            consoleMethod(formatPrefix(level, config), ...args);
+        };
+    };
+    return {
+        debug: logWithLevel('debug'),
+        info: logWithLevel('info'),
+        warn: logWithLevel('warn'),
+        error: logWithLevel('error'),
+    };
+};
+const createLogger = (scope, input, parentConfig) => {
+    const resolvedConfig = resolveConfig(scope, input, parentConfig);
+    const methods = createLoggerMethods(resolvedConfig);
+    const child = (childScope, overrides) => {
+        const combinedScope = childScope
+            ? resolvedConfig.scope
+                ? `${resolvedConfig.scope}.${childScope}`
+                : childScope
+            : resolvedConfig.scope;
+        return (0, exports.createLogger)(combinedScope, overrides, resolvedConfig);
+    };
+    return {
+        ...methods,
+        child,
+        isLevelEnabled: (level) => isLevelEnabled(level, resolvedConfig),
+        config: resolvedConfig,
+    };
+};
+exports.createLogger = createLogger;
+const configureDataTableLogging = (options) => {
+    globalConfig = resolveConfig(options.scope, options, globalConfig);
+};
+exports.configureDataTableLogging = configureDataTableLogging;
+const getDataTableLoggingConfig = () => ({ ...globalConfig });
+exports.getDataTableLoggingConfig = getDataTableLoggingConfig;

package/dist/utils/special-columns.d.ts

@@ -0,0 +1,9 @@
+import type { DataTableColumn } from '../types/column.types';
+export interface SelectionColumnConfig {
+    multiSelect?: boolean;
+}
+/** Auto-generated checkbox selection column, driven by the SelectionFeature. */
+export declare const createSelectionColumn: <T>(config: Partial<DataTableColumn<T>> & SelectionColumnConfig) => DataTableColumn<T, any>;
+/** Auto-generated expand/collapse column for row detail panels. */
+export declare const createExpandingColumn: <T>(config: Partial<DataTableColumn<T>>) => DataTableColumn<T>;
+//# sourceMappingURL=special-columns.d.ts.map

package/dist/utils/special-columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"special-columns.d.ts","sourceRoot":"","sources":["../../src/utils/special-columns.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IAClC,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,GAAI,CAAC,EACnC,QAAQ,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GAAG,qBAAqB,KAC5D,eAAe,CAAC,CAAC,EAAE,GAAG,CAwCvB,CAAC;AAEH,mEAAmE;AACnE,eAAO,MAAM,qBAAqB,GAAI,CAAC,EAAE,QAAQ,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,KAAG,eAAe,CAAC,CAAC,CA2B9F,CAAC"}