@ackplus/react-tanstack-data-table 1.0.34 → 1.1.1

package/{src → dist}/lib/utils/column-helpers.d.ts

@@ -1,7 +1,17 @@
+/**
+ * Column utilities for DataTable components
+ */
 import { Column, ColumnDef } from "@tanstack/react-table";
 export type ColumnType = 'text' | 'number' | 'date' | 'boolean' | 'select' | 'actions';
+/**
+ * Get the type of a column from its metadata
+ */
 export declare function getColumnType(column: Column<any, unknown>): ColumnType;
 export declare function getCustomFilterComponent(column: Column<any, unknown>): any;
 export declare function getColumnOptions(column: Column<any, unknown>): any[];
 export declare function withIdsDeep<T>(cols: ColumnDef<T, any>[]): ColumnDef<T, any>[];
+/**
+ * Determine if a column should be filterable
+ */
 export declare function isColumnFilterable(column: Column<any, unknown>): boolean;
+//# sourceMappingURL=column-helpers.d.ts.map

package/dist/lib/utils/column-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-helpers.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/column-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAG1D,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEvF;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,UAAU,CAMtE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,GAAG,CAG1E;AAGD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,GAAG,EAAE,CAsBpE;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAQ7E;AAGD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,OAAO,CAQxE"}

package/{src → dist}/lib/utils/column-helpers.js

@@ -5,22 +5,29 @@ exports.getCustomFilterComponent = getCustomFilterComponent;
 exports.getColumnOptions = getColumnOptions;
 exports.withIdsDeep = withIdsDeep;
 exports.isColumnFilterable = isColumnFilterable;
+/**
+ * Get the type of a column from its metadata
+ */
 function getColumnType(column) {
     var _a;
+    // Check if column has explicit type in columnDef
     if ((_a = column === null || column === void 0 ? void 0 : column.columnDef) === null || _a === void 0 ? void 0 : _a.type) {
         return column.columnDef.type;
     }
-    return 'text';
+    return 'text'; // Default to text
 }
 function getCustomFilterComponent(column) {
     var _a, _b;
+    // Check if column has custom filter component in meta
     return ((_a = column === null || column === void 0 ? void 0 : column.columnDef) === null || _a === void 0 ? void 0 : _a.filterComponent) || ((_b = column === null || column === void 0 ? void 0 : column.columnDef) === null || _b === void 0 ? void 0 : _b.editComponent);
 }
 function getColumnOptions(column) {
     var _a;
+    // Check if column has explicit options in meta
     if ((_a = column === null || column === void 0 ? void 0 : column.columnDef) === null || _a === void 0 ? void 0 : _a.options) {
         return (column === null || column === void 0 ? void 0 : column.columnDef.options) || [];
     }
+    // Default options for boolean type
     const columnType = getColumnType(column);
     if (columnType === 'boolean') {
         return [
@@ -39,15 +46,24 @@ function getColumnOptions(column) {
 function withIdsDeep(cols) {
     return cols.map((c, i) => {
         var _a, _b;
-        return (Object.assign(Object.assign(Object.assign({}, c), { id: (_b = (_a = c.id) !== null && _a !== void 0 ? _a : c.accessorKey) !== null && _b !== void 0 ? _b : `col_${i}` }), (Array.isArray(c.columns) && {
-            columns: withIdsDeep(c.columns)
-        })));
+        return ({
+            ...c,
+            id: (_b = (_a = c.id) !== null && _a !== void 0 ? _a : c.accessorKey) !== null && _b !== void 0 ? _b : `col_${i}`,
+            ...(Array.isArray(c.columns) && {
+                columns: withIdsDeep(c.columns)
+            }),
+        });
     });
 }
+/**
+ * Determine if a column should be filterable
+ */
 function isColumnFilterable(column) {
     var _a, _b;
+    // Check if column is explicitly marked as filterable
     if (((_a = column === null || column === void 0 ? void 0 : column.columnDef) === null || _a === void 0 ? void 0 : _a.filterable) !== undefined) {
         return (_b = column === null || column === void 0 ? void 0 : column.columnDef) === null || _b === void 0 ? void 0 : _b.filterable;
     }
+    // Default to filterable for data columns
     return true;
 }

package/{src → dist}/lib/utils/debounced-fetch.utils.d.ts

@@ -3,9 +3,7 @@ export declare function useDebouncedFetch<T extends Record<string, any>>(onFetch
     data: T[];
     total: number;
 }>) | undefined, delay?: number): {
-    debouncedFetch: (filters: TableFiltersForFetch) => Promise<{
-        data: T[];
-        total: number;
-    }>;
-    isLoading: boolean;
+    debouncedFetch: any;
+    isLoading: any;
 };
+//# sourceMappingURL=debounced-fetch.utils.d.ts.map

package/dist/lib/utils/debounced-fetch.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounced-fetch.utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/debounced-fetch.utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAGhD,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3D,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC;IAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,GAAG,SAAS,EACnG,KAAK,SAAM;;;EA8Cd"}

package/{src → dist}/lib/utils/debounced-fetch.utils.js

@@ -1,34 +1,40 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useDebouncedFetch = useDebouncedFetch;
-const tslib_1 = require("tslib");
 const react_1 = require("react");
 function useDebouncedFetch(onFetchData, delay = 300) {
     const [isLoading, setIsLoading] = (0, react_1.useState)(false);
     const debounceTimer = (0, react_1.useRef)(null);
-    const debouncedFetch = (0, react_1.useCallback)((filters) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+    const debouncedFetch = (0, react_1.useCallback)(async (filters) => {
         if (!onFetchData)
             return null;
+        // Create a unique key for the current fetch parameters
+        // const currentParams = JSON.stringify(filters);
+        // Clear existing timer
         if (debounceTimer.current) {
             clearTimeout(debounceTimer.current);
         }
         return new Promise((resolve) => {
-            debounceTimer.current = setTimeout(() => tslib_1.__awaiter(this, void 0, void 0, function* () {
+            debounceTimer.current = setTimeout(async () => {
                 setIsLoading(true);
                 try {
-                    const result = yield onFetchData(filters);
+                    const result = await onFetchData(filters);
                     resolve(result);
                 }
                 catch (error) {
+                    // Handle fetch error silently or could be passed to onError callback
+                    console.error('Error fetching data:', error);
                     resolve(null);
                 }
                 finally {
                     setIsLoading(false);
                 }
-            }), delay);
+            }, delay);
         });
-    }), [onFetchData, delay]);
+    }, [onFetchData, delay]);
+    // Cleanup timer on unmount
     (0, react_1.useEffect)(() => {
+        // Fetch data when dependencies change
         return () => {
             if (debounceTimer.current) {
                 clearTimeout(debounceTimer.current);

package/{src → dist}/lib/utils/export-utils.d.ts

@@ -26,5 +26,18 @@ export interface ServerExportOptions extends ExportOptions {
     currentFilters?: any;
     selection?: SelectionState;
 }
+/**
+ * Export data for client-side tables
+ * - If rows are selected, export only selected rows
+ * - Otherwise export all filtered/visible rows
+ * - Only export visible columns
+ */
 export declare function exportClientData<TData>(table: Table<TData>, options: ExportOptions): Promise<void>;
+/**
+ * Export data for server-side tables
+ * - Fetch data using provided fetchData function
+ * - Pass selection information to server for filtering
+ * - Export all returned data (server handles selection/filtering)
+ */
 export declare function exportServerData<TData>(table: Table<TData>, options: ServerExportOptions): Promise<void>;
+//# sourceMappingURL=export-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/export-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,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;CAChE;AAGD,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACtD,SAAS,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClG,cAAc,CAAC,EAAE,GAAG,CAAC;IACrB,SAAS,CAAC,EAAE,cAAc,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EACxC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,EACnB,OAAO,EAAE,aAAa,GACvB,OAAO,CAAC,IAAI,CAAC,CA6Df;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EACxC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,EACnB,OAAO,EAAE,mBAAmB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAkHf"}

package/dist/lib/utils/export-utils.js

@@ -0,0 +1,252 @@
+"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 XLSX = __importStar(require("xlsx"));
+/**
+ * Export data for client-side tables
+ * - If rows are selected, export only selected rows
+ * - Otherwise export all filtered/visible rows
+ * - Only export visible columns
+ */
+async function exportClientData(table, options) {
+    const { format, filename, onProgress, onComplete, onError } = options;
+    try {
+        // Get selected rows if any are selected
+        // const selectedRowIds = Object.keys(table.getState().rowSelection).filter(
+        //     key => table.getState().rowSelection[key]
+        // );
+        // const hasSelectedRows = selectedRowIds.length > 0;
+        // // Get the rows to export
+        // const rowsToExport = hasSelectedRows ? table.getSelectedRowModel().rows : table.getFilteredRowModel().rows;
+        const selectedRows = table.getSelectedRows ? table.getSelectedRows() : [];
+        const hasSelectedRows = selectedRows.length > 0;
+        const rowsToExport = hasSelectedRows ? selectedRows : table.getFilteredRowModel().rows;
+        // Prepare data for export - get all visible columns and their values, excluding hideInExport columns
+        const exportData = rowsToExport.map((row, index) => {
+            onProgress === null || onProgress === void 0 ? void 0 : onProgress({
+                processedRows: index + 1,
+                totalRows: rowsToExport.length,
+                percentage: Math.round(((index + 1) / rowsToExport.length) * 100),
+            });
+            const rowData = {};
+            // Get all visible cells for this row, excluding columns marked as hideInExport
+            row.getVisibleCells().forEach(cell => {
+                const columnDef = cell.column.columnDef;
+                // Skip columns marked as hideInExport
+                if (columnDef.hideInExport === true) {
+                    return;
+                }
+                const header = typeof columnDef.header === 'string' ? columnDef.header : cell.column.id;
+                // Use getValue() - it already handles all formatting
+                rowData[header] = cell.getValue() || '';
+            });
+            return rowData;
+        });
+        // Export the data
+        await exportToFile(exportData, format, filename);
+        onComplete === null || onComplete === void 0 ? void 0 : onComplete({
+            success: true,
+            filename: `${filename}.${format === 'excel' ? 'xlsx' : 'csv'}`,
+            totalRows: exportData.length,
+        });
+    }
+    catch (error) {
+        console.error('Client export failed:', error);
+        onError === null || onError === void 0 ? void 0 : onError({
+            message: error instanceof Error ? error.message : 'Export failed',
+            code: 'CLIENT_EXPORT_ERROR',
+        });
+    }
+}
+/**
+ * Export data for server-side tables
+ * - Fetch data using provided fetchData function
+ * - Pass selection information to server for filtering
+ * - Export all returned data (server handles selection/filtering)
+ */
+async function exportServerData(table, options) {
+    const { format, filename, fetchData, currentFilters, selection, onProgress, onComplete, onError } = options;
+    try {
+        // Initial progress
+        onProgress === null || onProgress === void 0 ? void 0 : onProgress({});
+        // First, get total count to determine if we need chunking
+        const initialResponse = await fetchData({
+            ...currentFilters,
+            pagination: { pageIndex: 0, pageSize: 1 }
+        }, selection);
+        if (!initialResponse || !initialResponse.data || !Array.isArray(initialResponse.data)) {
+            throw new Error('Invalid data received from server');
+        }
+        const totalRows = initialResponse.total || initialResponse.data.length;
+        const CHUNK_SIZE = 1000; // Fetch 1000 rows per request
+        const needsChunking = totalRows > CHUNK_SIZE;
+        let allData = [];
+        if (needsChunking) {
+            // Fetch data in chunks (no progress events during fetching)
+            const totalPages = Math.ceil(totalRows / CHUNK_SIZE);
+            for (let page = 1; page <= totalPages; page++) {
+                // Fetch current chunk
+                const chunkFilters = {
+                    ...currentFilters,
+                    pagination: {
+                        pageIndex: page - 1,
+                        pageSize: CHUNK_SIZE,
+                    },
+                };
+                const chunkResponse = await fetchData(chunkFilters, selection);
+                if (!chunkResponse || !chunkResponse.data || !Array.isArray(chunkResponse.data)) {
+                    throw new Error(`Failed to fetch chunk ${page}`);
+                }
+                allData = [...allData, ...chunkResponse.data];
+                // Small delay to prevent overwhelming the server
+                if (page < totalPages) {
+                    await new Promise(resolve => setTimeout(resolve, 100));
+                }
+            }
+        }
+        else {
+            // Small dataset, use single request
+            allData = initialResponse.data;
+        }
+        // Get visible columns for proper headers and data processing, excluding hideInExport columns
+        const visibleColumns = table.getVisibleLeafColumns().filter(col => {
+            const columnDef = col.columnDef;
+            return col.getIsVisible() && columnDef.hideInExport !== true;
+        });
+        // Prepare data for export with proper column processing
+        const exportData = [];
+        for (let index = 0; index < allData.length; index++) {
+            const rowData = allData[index];
+            const exportRow = {};
+            visibleColumns.forEach(column => {
+                var _a;
+                const columnId = column.id;
+                const columnDef = column.columnDef;
+                const header = typeof columnDef.header === 'string'
+                    ? columnDef.header
+                    : columnId;
+                // Get value from raw data
+                let value = rowData[columnId];
+                // Apply accessorFn if defined
+                if (column.accessorFn && typeof column.accessorFn === 'function') {
+                    value = ((_a = (column.accessorFn(rowData, index) || '')) === null || _a === void 0 ? void 0 : _a.toString()) || '';
+                }
+                // Convert to string for export
+                if (value === null || value === undefined) {
+                    value = '';
+                }
+                else if (typeof value === 'object') {
+                    value = JSON.stringify(value);
+                }
+                else {
+                    value = String(value);
+                }
+                exportRow[header] = value;
+            });
+            exportData.push(exportRow);
+        }
+        await exportToFile(exportData, format, filename);
+        onComplete === null || onComplete === void 0 ? void 0 : onComplete({
+            success: true,
+            filename: `${filename}.${format === 'excel' ? 'xlsx' : 'csv'}`,
+            totalRows: exportData.length,
+        });
+    }
+    catch (error) {
+        console.error('Server export failed:', error);
+        onError === null || onError === void 0 ? void 0 : onError({
+            message: error instanceof Error ? error.message : 'Export failed',
+            code: 'SERVER_EXPORT_ERROR',
+        });
+    }
+}
+/**
+ * Export data to file (CSV or Excel)
+ */
+async function exportToFile(data, format, filename) {
+    if (data.length === 0) {
+        throw new Error('No data to export');
+    }
+    if (format === 'csv') {
+        const csv = convertToCSV(data);
+        downloadFile(csv, `${filename}.csv`, 'text/csv');
+    }
+    else {
+        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' });
+        downloadFile(blob, `${filename}.xlsx`, 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
+    }
+}
+/**
+ * Convert data to CSV format
+ */
+function convertToCSV(data) {
+    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 => {
+            const value = row[header] || '';
+            // Escape quotes and wrap in quotes if contains comma or quote
+            if (typeof value === 'string' && (value.includes(',') || value.includes('"') || value.includes('\n'))) {
+                return `"${value.replace(/"/g, '""')}"`;
+            }
+            return value;
+        });
+        csvRows.push(values.join(','));
+    }
+    return csvRows.join('\n');
+}
+/**
+ * Download file to user's device
+ */
+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/{src → dist}/lib/utils/index.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Utility functions for DataTable components
+ */
 export * from './styling-helpers';
 export * from './table-helpers';
 export * from './column-helpers';
@@ -6,3 +9,4 @@ export * from './special-columns.utils';
 export * from './debounced-fetch.utils';
 export * from './slot-helpers';
 export * from './logger';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,mBAAmB,CAAC;AAGlC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,yBAAyB,CAAC;AAGxC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,UAAU,CAAC"}

package/dist/lib/utils/index.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * Utility functions for DataTable components
+ */
+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 });
+// Styling utilities
+__exportStar(require("./styling-helpers"), exports);
+// Table utilities
+__exportStar(require("./table-helpers"), exports);
+// Column utilities
+__exportStar(require("./column-helpers"), exports);
+// Export utilities
+__exportStar(require("./export-utils"), exports);
+// Special columns utilities
+__exportStar(require("./special-columns.utils"), exports);
+// Debounced fetch utilities
+__exportStar(require("./debounced-fetch.utils"), exports);
+// Slot helper utilities
+__exportStar(require("./slot-helpers"), exports);
+// Logging utilities
+__exportStar(require("./logger"), exports);

package/{src → dist}/lib/utils/logger.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Logging utilities for the DataTable package.
+ *
+ * Provides a lightweight wrapper around `console` that can be configured globally
+ * or per-instance to help troubleshoot behaviour in consuming applications.
+ */
 export type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'debug';
 interface ConsoleLike {
     debug?: (...args: unknown[]) => void;
@@ -7,11 +13,29 @@ interface ConsoleLike {
     log?: (...args: unknown[]) => void;
 }
 export interface DataTableLoggingOptions {
+    /**
+     * Whether logging should be enabled.
+     */
     enabled?: boolean;
+    /**
+     * Minimum level that will be emitted. Defaults to `warn`.
+     */
     level?: LogLevel;
+    /**
+     * Prefix prepended to every log message. Defaults to `DataTable`.
+     */
     prefix?: string;
+    /**
+     * Optional scope that will be appended after the prefix when present.
+     */
     scope?: string;
+    /**
+     * Include an ISO timestamp ahead of each log line.
+     */
     includeTimestamp?: boolean;
+    /**
+     * A custom logger implementation. Defaults to `console`.
+     */
     logger?: ConsoleLike;
 }
 type LoggerInput = boolean | DataTableLoggingOptions;
@@ -24,11 +48,30 @@ export interface LoggerInstance {
     info: (...args: unknown[]) => void;
     warn: (...args: unknown[]) => void;
     error: (...args: unknown[]) => void;
+    /**
+     * Create a new logger that inherits configuration and extends the scope.
+     */
     child: (scope: string, overrides?: LoggerInput) => LoggerInstance;
+    /**
+     * Check whether a level would emit given current configuration.
+     */
     isLevelEnabled: (level: LogMethodLevel) => boolean;
+    /**
+     * Access the resolved configuration for inspection.
+     */
     config: ResolvedLoggerConfig;
 }
+/**
+ * Create a new logger instance. Configuration cascades from the global config unless overridden.
+ */
 export declare const createLogger: (scope?: string, input?: LoggerInput, parentConfig?: ResolvedLoggerConfig) => LoggerInstance;
+/**
+ * Configure the global logger defaults for every DataTable instance.
+ */
 export declare const configureDataTableLogging: (options: DataTableLoggingOptions) => void;
+/**
+ * Read the current global logging configuration.
+ */
 export declare const getDataTableLoggingConfig: () => ResolvedLoggerConfig;
 export {};
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtE,UAAU,WAAW;IACjB,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACrC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACrC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,uBAAuB;IACpC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB;AAED,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;AAgFlD,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;;OAEG;IACH,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,WAAW,KAAK,cAAc,CAAC;IAClE;;OAEG;IACH,cAAc,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC;IACnD;;OAEG;IACH,MAAM,EAAE,oBAAoB,CAAC;CAChC;AAsBD;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,EAAE,QAAQ,WAAW,EAAE,eAAe,oBAAoB,KAAG,cAiBvG,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,SAAS,uBAAuB,SAEzE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,QAAO,oBAA6C,CAAC"}

package/{src → dist}/lib/utils/logger.js

@@ -1,4 +1,10 @@
 "use strict";
+/**
+ * Logging utilities for the DataTable package.
+ *
+ * Provides a lightweight wrapper around `console` that can be configured globally
+ * or per-instance to help troubleshoot behaviour in consuming applications.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getDataTableLoggingConfig = exports.configureDataTableLogging = exports.createLogger = void 0;
 const LOG_LEVEL_ORDER = {
@@ -86,6 +92,9 @@ const createLoggerMethods = (config) => {
         error: logWithLevel('error'),
     };
 };
+/**
+ * Create a new logger instance. Configuration cascades from the global config unless overridden.
+ */
 const createLogger = (scope, input, parentConfig) => {
     const resolvedConfig = resolveConfig(scope, input, parentConfig);
     const methods = createLoggerMethods(resolvedConfig);
@@ -95,12 +104,23 @@ const createLogger = (scope, input, parentConfig) => {
             : resolvedConfig.scope;
         return (0, exports.createLogger)(combinedScope, overrides, resolvedConfig);
     };
-    return Object.assign(Object.assign({}, methods), { child, isLevelEnabled: (level) => isLevelEnabled(level, resolvedConfig), config: resolvedConfig });
+    return {
+        ...methods,
+        child,
+        isLevelEnabled: (level) => isLevelEnabled(level, resolvedConfig),
+        config: resolvedConfig,
+    };
 };
 exports.createLogger = createLogger;
+/**
+ * Configure the global logger defaults for every DataTable instance.
+ */
 const configureDataTableLogging = (options) => {
     globalConfig = resolveConfig(options.scope, options, globalConfig);
 };
 exports.configureDataTableLogging = configureDataTableLogging;
-const getDataTableLoggingConfig = () => (Object.assign({}, globalConfig));
+/**
+ * Read the current global logging configuration.
+ */
+const getDataTableLoggingConfig = () => ({ ...globalConfig });
 exports.getDataTableLoggingConfig = getDataTableLoggingConfig;

package/{src → dist}/lib/utils/slot-helpers.d.ts

@@ -1,15 +1,53 @@
+/**
+ * Enhanced Slot Helper Utilities
+ *
+ * Utilities to help with rendering slotted components with enhanced prop merging,
+ * type safety, and full customization support.
+ */
 import { ComponentType } from 'react';
 import { DataTableSlots } from '../types/slots.types';
+/**
+ * Enhanced slot component retrieval with better type safety
+ */
 export declare function getSlotComponent<T, K extends keyof DataTableSlots<T>>(slots: Partial<DataTableSlots<T>> | undefined, slotName: K, fallback: ComponentType<any>): ComponentType<any>;
+/**
+ * Merge slot props with default props and user overrides
+ * Handles special cases for MUI sx prop, style prop, and className
+ */
 export declare function mergeSlotProps(defaultProps?: Record<string, any>, slotProps?: Record<string, any>, userProps?: Record<string, any>): Record<string, any>;
+/**
+ * Enhanced slot component retrieval with automatic prop merging
+ */
 export declare function getSlotComponentWithProps<T, K extends keyof DataTableSlots<T>>(slots: Partial<DataTableSlots<T>> | undefined, slotProps: Record<string, any>, slotName: K, fallback: ComponentType<any>, defaultProps?: Record<string, any>): {
     component: ComponentType<any>;
     props: Record<string, any>;
 };
+/**
+ * Utility to check if a slot is overridden by user
+ */
 export declare function isSlotOverridden<T, K extends keyof DataTableSlots<T>>(slots: Partial<DataTableSlots<T>> | undefined, slotName: K): boolean;
+/**
+ * Utility to get all overridden slots
+ */
 export declare function getOverriddenSlots<T>(slots: Partial<DataTableSlots<T>> | undefined): Array<keyof DataTableSlots<T>>;
+/**
+ * Type-safe slot prop extractor
+ */
 export declare function extractSlotProps<T, K extends keyof DataTableSlots<T>>(slotProps: Record<string, any> | undefined, slotName: K): Record<string, any>;
+/**
+ * Enhanced slot component with better prop handling
+ */
 export declare function createEnhancedSlotComponent<T, K extends keyof DataTableSlots<T>>(slots: Partial<DataTableSlots<T>> | undefined, slotName: K, fallback: ComponentType<any>, baseProps?: Record<string, any>): ComponentType<any>;
+/**
+ * Utility to validate slot props at runtime (development only)
+ */
 export declare function validateSlotProps<T, K extends keyof DataTableSlots<T>>(slotName: K, props: any, requiredProps?: string[]): boolean;
+/**
+ * Helper to create slot props with proper typing
+ */
 export declare function createSlotProps<T>(table: any, additionalProps?: Record<string, any>): Record<string, any>;
-export declare function withSlotProps<T, K extends keyof DataTableSlots<T>>(slots: Partial<DataTableSlots<T>> | undefined, slotProps: Record<string, any>, slotName: K, fallback: ComponentType<any>): (props: any) => import("react").ReactElement<any, string | import("react").JSXElementConstructor<any>>;
+/**
+ * Enhanced slot component wrapper that handles all prop merging automatically
+ */
+export declare function withSlotProps<T, K extends keyof DataTableSlots<T>>(slots: Partial<DataTableSlots<T>> | undefined, slotProps: Record<string, any>, slotName: K, fallback: ComponentType<any>): (props: any) => any;
+//# sourceMappingURL=slot-helpers.d.ts.map

package/dist/lib/utils/slot-helpers.d.ts.map

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