@keenthemes/ktui 1.2.5 → 1.2.7

package/lib/esm/components/datatable/datatable-sort.js

@@ -2,11 +2,20 @@
  * KTUI - Free & Open-Source Tailwind UI Components by Keenthemes
  * Copyright 2025 by Keenthemes Inc
  */
-export function createSortHandler(config, theadElement, getState, setState, fireEvent, dispatchEvent, updateData) {
-    // Helper to compare values for sorting (string)
-    function compareValues(a, b, sortOrder) {
-        var aText = String(a).replace(/<[^>]*>|&nbsp;/g, '');
-        var bText = String(b).replace(/<[^>]*>|&nbsp;/g, '');
+import { stripHtml } from './datatable-utils';
+var KTDataTableSortHandler = /** @class */ (function () {
+    function KTDataTableSortHandler(deps) {
+        this._sortAbortController = null;
+        this._config = deps.config;
+        this._theadElement = deps.theadElement;
+        this._getState = deps.getState;
+        this._setState = deps.setState;
+        this._emit = deps.emit;
+        this._updateData = deps.updateData;
+    }
+    KTDataTableSortHandler._compareValues = function (a, b, sortOrder) {
+        var aText = stripHtml(a);
+        var bText = stripHtml(b);
         return aText > bText
             ? sortOrder === 'asc'
                 ? 1
@@ -16,18 +25,16 @@ export function createSortHandler(config, theadElement, getState, setState, fire
                     ? -1
                     : 1
                 : 0;
-    }
-    // Parse value for numeric sort: strip currency/commas, then parseFloat
-    function parseNumeric(value) {
+    };
+    KTDataTableSortHandler._parseNumeric = function (value) {
         if (value === null || value === undefined || value === '') {
             return Number.NaN;
         }
         var s = String(value).replace(/[^0-9.-]/g, '');
         var n = parseFloat(s);
         return Number.isNaN(n) ? Number.NaN : n;
-    }
-    // Compare two numbers; NaN sorts to the end for both asc and desc
-    function compareNumeric(aNum, bNum, sortOrder) {
+    };
+    KTDataTableSortHandler._compareNumeric = function (aNum, bNum, sortOrder) {
         var aNaN = Number.isNaN(aNum);
         var bNaN = Number.isNaN(bNum);
         if (aNaN && bNaN)
@@ -41,42 +48,56 @@ export function createSortHandler(config, theadElement, getState, setState, fire
         if (aNum > bNum)
             return sortOrder === 'asc' ? 1 : -1;
         return 0;
-    }
-    function getColumnDef(sortField) {
-        var columns = config.columns;
+    };
+    KTDataTableSortHandler.prototype._getColumnDef = function (sortField) {
+        var columns = this._config.columns;
         if (!columns)
             return undefined;
         var key = typeof sortField === 'number'
             ? Object.keys(columns)[sortField]
             : sortField;
         return key !== undefined ? columns[key] : undefined;
-    }
-    function sortData(data, sortField, sortOrder) {
-        var columnDef = getColumnDef(sortField);
+    };
+    KTDataTableSortHandler.prototype.sortData = function (data, sortField, sortOrder) {
+        var columnDef = this._getColumnDef(sortField);
         var sortValueFn = columnDef === null || columnDef === void 0 ? void 0 : columnDef.sortValue;
         var useNumeric = !sortValueFn && (columnDef === null || columnDef === void 0 ? void 0 : columnDef.sortType) === 'numeric';
+        // Pre-strip HTML from cell values once (instead of on every comparison).
+        // For N rows this runs N regex replacements instead of N*log(N).
+        var strippedCache = new Map();
+        if (!sortValueFn) {
+            for (var _i = 0, data_1 = data; _i < data_1.length; _i++) {
+                var item = data_1[_i];
+                strippedCache.set(item, stripHtml(item[sortField]));
+            }
+        }
         return data.sort(function (a, b) {
+            var _a, _b, _c, _d;
             var aRaw = a[sortField];
             var bRaw = b[sortField];
             if (typeof sortValueFn === 'function') {
                 var aVal = sortValueFn(aRaw, a);
                 var bVal = sortValueFn(bRaw, b);
-                var aNum = typeof aVal === 'number' ? aVal : parseNumeric(aVal);
-                var bNum = typeof bVal === 'number' ? bVal : parseNumeric(bVal);
+                var aNum = typeof aVal === 'number'
+                    ? aVal
+                    : KTDataTableSortHandler._parseNumeric(aVal);
+                var bNum = typeof bVal === 'number'
+                    ? bVal
+                    : KTDataTableSortHandler._parseNumeric(bVal);
                 if (typeof aVal === 'number' && typeof bVal === 'number') {
-                    return compareNumeric(aNum, bNum, sortOrder);
+                    return KTDataTableSortHandler._compareNumeric(aNum, bNum, sortOrder);
                 }
-                return compareValues(aVal, bVal, sortOrder);
+                return KTDataTableSortHandler._compareValues(aVal, bVal, sortOrder);
             }
             if (useNumeric) {
-                var aNum = parseNumeric(aRaw);
-                var bNum = parseNumeric(bRaw);
-                return compareNumeric(aNum, bNum, sortOrder);
+                var aNum = KTDataTableSortHandler._parseNumeric((_a = strippedCache.get(a)) !== null && _a !== void 0 ? _a : aRaw);
+                var bNum = KTDataTableSortHandler._parseNumeric((_b = strippedCache.get(b)) !== null && _b !== void 0 ? _b : bRaw);
+                return KTDataTableSortHandler._compareNumeric(aNum, bNum, sortOrder);
             }
-            return compareValues(aRaw, bRaw, sortOrder);
+            return KTDataTableSortHandler._compareValues((_c = strippedCache.get(a)) !== null && _c !== void 0 ? _c : aRaw, (_d = strippedCache.get(b)) !== null && _d !== void 0 ? _d : bRaw, sortOrder);
         });
-    }
-    function toggleSortOrder(currentField, currentOrder, newField) {
+    };
+    KTDataTableSortHandler.prototype.toggleSortOrder = function (currentField, currentOrder, newField) {
         if (currentField === newField) {
             switch (currentOrder) {
                 case 'asc':
@@ -88,17 +109,16 @@ export function createSortHandler(config, theadElement, getState, setState, fire
             }
         }
         return 'asc';
-    }
-    function setSortIcon(sortField, sortOrder) {
+    };
+    KTDataTableSortHandler.prototype.setSortIcon = function (sortField, sortOrder) {
         var _a, _b, _c, _d, _e, _f;
-        var baseClass = ((_b = (_a = config.sort) === null || _a === void 0 ? void 0 : _a.classes) === null || _b === void 0 ? void 0 : _b.base) || '';
+        var baseClass = ((_b = (_a = this._config.sort) === null || _a === void 0 ? void 0 : _a.classes) === null || _b === void 0 ? void 0 : _b.base) || '';
         var sortClass = sortOrder
             ? sortOrder === 'asc'
-                ? ((_d = (_c = config.sort) === null || _c === void 0 ? void 0 : _c.classes) === null || _d === void 0 ? void 0 : _d.asc) || ''
-                : ((_f = (_e = config.sort) === null || _e === void 0 ? void 0 : _e.classes) === null || _f === void 0 ? void 0 : _f.desc) || ''
+                ? ((_d = (_c = this._config.sort) === null || _c === void 0 ? void 0 : _c.classes) === null || _d === void 0 ? void 0 : _d.asc) || ''
+                : ((_f = (_e = this._config.sort) === null || _e === void 0 ? void 0 : _e.classes) === null || _f === void 0 ? void 0 : _f.desc) || ''
             : '';
-        // Clear all headers: remove sort state so only the active column shows highlighted arrow
-        var allTh = theadElement.querySelectorAll('th');
+        var allTh = this._theadElement.querySelectorAll('th');
         allTh.forEach(function (header) {
             var el = header;
             el.setAttribute('aria-sort', 'none');
@@ -107,10 +127,9 @@ export function createSortHandler(config, theadElement, getState, setState, fire
                 sortElement.className = baseClass;
             }
         });
-        // Apply sort state to the active column so table.css [aria-sort='asc'] / [aria-sort='desc'] can highlight the arrow
         var th = typeof sortField === 'number'
             ? allTh[sortField]
-            : theadElement.querySelector("th[data-kt-datatable-column=\"".concat(String(sortField), "\"], th[data-kt-datatable-column-sort=\"").concat(String(sortField), "\"]"));
+            : this._theadElement.querySelector("th[data-kt-datatable-column=\"".concat(String(sortField), "\"], th[data-kt-datatable-column-sort=\"").concat(String(sortField), "\"]"));
         if (th) {
             var sortElement = th.querySelector(".".concat(baseClass));
             if (sortElement) {
@@ -123,20 +142,23 @@ export function createSortHandler(config, theadElement, getState, setState, fire
                 th.setAttribute('aria-sort', 'none');
             }
         }
-    }
-    function initSort() {
-        if (!theadElement)
+    };
+    KTDataTableSortHandler.prototype.initSort = function () {
+        var _this = this;
+        if (!this._theadElement)
             return;
-        // Set the initial sort icon
-        setSortIcon(getState().sortField, getState().sortOrder);
-        // Get all the table headers
-        var headers = Array.from(theadElement.querySelectorAll('th'));
+        // Abort previous sort listeners before attaching new ones
+        if (this._sortAbortController) {
+            this._sortAbortController.abort();
+        }
+        this._sortAbortController = new AbortController();
+        var signal = this._sortAbortController.signal;
+        this.setSortIcon(this._getState().sortField, this._getState().sortOrder);
+        var headers = Array.from(this._theadElement.querySelectorAll('th'));
         headers.forEach(function (header) {
             var _a, _b;
-            // If the sort class is not found, it's not a sortable column
-            if (!header.querySelector(".".concat((_b = (_a = config.sort) === null || _a === void 0 ? void 0 : _a.classes) === null || _b === void 0 ? void 0 : _b.base)))
+            if (!header.querySelector(".".concat((_b = (_a = _this._config.sort) === null || _a === void 0 ? void 0 : _a.classes) === null || _b === void 0 ? void 0 : _b.base)))
                 return;
-            // Check if sorting is disabled for this column
             var sortDisabled = header.getAttribute('data-kt-datatable-column-sort') === 'false';
             if (sortDisabled)
                 return;
@@ -146,16 +168,22 @@ export function createSortHandler(config, theadElement, getState, setState, fire
                 ? sortAttribute
                 : header.cellIndex;
             header.addEventListener('click', function () {
-                var state = getState();
-                var sortOrder = toggleSortOrder(state.sortField, state.sortOrder, sortField);
-                setSortIcon(sortField, sortOrder);
-                setState(sortField, sortOrder);
-                fireEvent('sort', { field: sortField, order: sortOrder });
-                dispatchEvent('sort', { field: sortField, order: sortOrder });
-                updateData();
-            });
+                var state = _this._getState();
+                var sortOrder = _this.toggleSortOrder(state.sortField, state.sortOrder, sortField);
+                _this.setSortIcon(sortField, sortOrder);
+                _this._setState(sortField, sortOrder);
+                _this._emit('sort', { field: sortField, order: sortOrder });
+                _this._updateData();
+            }, { signal: signal });
         });
-    }
-    return { initSort: initSort, sortData: sortData, toggleSortOrder: toggleSortOrder, setSortIcon: setSortIcon };
-}
+    };
+    KTDataTableSortHandler.prototype.dispose = function () {
+        if (this._sortAbortController) {
+            this._sortAbortController.abort();
+            this._sortAbortController = null;
+        }
+    };
+    return KTDataTableSortHandler;
+}());
+export { KTDataTableSortHandler };
 //# sourceMappingURL=datatable-sort.js.map

package/lib/esm/components/datatable/datatable-sort.js.map

@@ -1 +1 @@
-{"version":3,"file":"datatable-sort.js","sourceRoot":"","sources":["../../../../src/components/datatable/datatable-sort.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"datatable-sort.js","sourceRoot":"","sources":["../../../../src/components/datatable/datatable-sort.ts"],"names":[],"mappings":"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"}

package/lib/esm/components/datatable/datatable-spinner.d.ts

@@ -0,0 +1,30 @@
+/**
+ * KTUI - Free & Open-Source Tailwind UI Components by Keenthemes
+ * Copyright 2025 by Keenthemes Inc
+ */
+export interface KTDataTableSpinner {
+    show(root: HTMLElement | null, config: {
+        attributes?: {
+            spinner?: string;
+        };
+        loadingClass?: string;
+        loading?: {
+            template: string;
+            content: string;
+        };
+    }, tableElement: HTMLTableElement): void;
+    hide(root: HTMLElement | null, config: {
+        attributes?: {
+            spinner?: string;
+        };
+        loadingClass?: string;
+    }): void;
+    remove(root: HTMLElement | null, config: {
+        attributes?: {
+            spinner?: string;
+        };
+        loadingClass?: string;
+    }): void;
+}
+export declare function createSpinner(): KTDataTableSpinner;
+//# sourceMappingURL=datatable-spinner.d.ts.map

package/lib/esm/components/datatable/datatable-spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datatable-spinner.d.ts","sourceRoot":"","sources":["../../../../src/components/datatable/datatable-spinner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,kBAAkB;IAClC,IAAI,CACH,IAAI,EAAE,WAAW,GAAG,IAAI,EACxB,MAAM,EAAE;QACP,UAAU,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAClC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;KAChD,EACD,YAAY,EAAE,gBAAgB,GAC5B,IAAI,CAAC;IACR,IAAI,CACH,IAAI,EAAE,WAAW,GAAG,IAAI,EACxB,MAAM,EAAE;QACP,UAAU,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAClC,YAAY,CAAC,EAAE,MAAM,CAAC;KACtB,GACC,IAAI,CAAC;IACR,MAAM,CACL,IAAI,EAAE,WAAW,GAAG,IAAI,EACxB,MAAM,EAAE;QACP,UAAU,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAClC,YAAY,CAAC,EAAE,MAAM,CAAC;KACtB,GACC,IAAI,CAAC;CACR;AAED,wBAAgB,aAAa,IAAI,kBAAkB,CAuElD"}

package/lib/esm/components/datatable/datatable-spinner.js

@@ -0,0 +1,51 @@
+/**
+ * KTUI - Free & Open-Source Tailwind UI Components by Keenthemes
+ * Copyright 2025 by Keenthemes Inc
+ */
+export function createSpinner() {
+    function findSpinner(root, spinnerSel) {
+        return root && spinnerSel
+            ? root.querySelector(spinnerSel)
+            : null;
+    }
+    function createSpinnerElement(tableElement, loading) {
+        var template = document.createElement('template');
+        template.innerHTML = loading.template
+            .trim()
+            .replace('{content}', loading.content);
+        var first = template.content.firstChild;
+        if (!first || !(first instanceof HTMLElement))
+            return null;
+        var spinner = first;
+        spinner.setAttribute('data-kt-datatable-spinner', 'true');
+        tableElement.appendChild(spinner);
+        return spinner;
+    }
+    function show(root, config, tableElement) {
+        var _a, _b;
+        var spinnerSel = (_a = config.attributes) === null || _a === void 0 ? void 0 : _a.spinner;
+        var fromDom = findSpinner(root, spinnerSel);
+        var spinner = fromDom !== null && fromDom !== void 0 ? fromDom : (config.loading
+            ? createSpinnerElement(tableElement, config.loading)
+            : null);
+        if (spinner)
+            spinner.style.display = 'block';
+        root === null || root === void 0 ? void 0 : root.classList.add((_b = config.loadingClass) !== null && _b !== void 0 ? _b : 'loading');
+    }
+    function hide(root, config) {
+        var _a, _b;
+        var spinner = findSpinner(root, (_a = config.attributes) === null || _a === void 0 ? void 0 : _a.spinner);
+        if (spinner)
+            spinner.style.display = 'none';
+        root === null || root === void 0 ? void 0 : root.classList.remove((_b = config.loadingClass) !== null && _b !== void 0 ? _b : 'loading');
+    }
+    function remove(root, config) {
+        var _a, _b;
+        var spinner = findSpinner(root, (_a = config.attributes) === null || _a === void 0 ? void 0 : _a.spinner);
+        if (spinner === null || spinner === void 0 ? void 0 : spinner.parentNode)
+            spinner.parentNode.removeChild(spinner);
+        root === null || root === void 0 ? void 0 : root.classList.remove((_b = config.loadingClass) !== null && _b !== void 0 ? _b : 'loading');
+    }
+    return { show: show, hide: hide, remove: remove };
+}
+//# sourceMappingURL=datatable-spinner.js.map

package/lib/esm/components/datatable/datatable-spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datatable-spinner.js","sourceRoot":"","sources":["../../../../src/components/datatable/datatable-spinner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4BH,MAAM,UAAU,aAAa;IAC5B,SAAS,WAAW,CACnB,IAAwB,EACxB,UAA8B;QAE9B,OAAO,IAAI,IAAI,UAAU;YACxB,CAAC,CAAC,IAAI,CAAC,aAAa,CAAc,UAAU,CAAC;YAC7C,CAAC,CAAC,IAAI,CAAC;IACT,CAAC;IAED,SAAS,oBAAoB,CAC5B,YAA8B,EAC9B,OAA8C;QAE9C,IAAM,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACpD,QAAQ,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ;aACnC,IAAI,EAAE;aACN,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACxC,IAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC;QAC1C,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,YAAY,WAAW,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3D,IAAM,OAAO,GAAG,KAAK,CAAC;QACtB,OAAO,CAAC,YAAY,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC;QAC1D,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAClC,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,SAAS,IAAI,CACZ,IAAwB,EACxB,MAIC,EACD,YAA8B;;QAE9B,IAAM,UAAU,GAAG,MAAA,MAAM,CAAC,UAAU,0CAAE,OAAO,CAAC;QAC9C,IAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC9C,IAAM,OAAO,GACZ,OAAO,aAAP,OAAO,cAAP,OAAO,GACP,CAAC,MAAM,CAAC,OAAO;YACd,CAAC,CAAC,oBAAoB,CAAC,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC;YACpD,CAAC,CAAC,IAAI,CAAC,CAAC;QACV,IAAI,OAAO;YAAE,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;QAC7C,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,SAAS,CAAC,GAAG,CAAC,MAAA,MAAM,CAAC,YAAY,mCAAI,SAAS,CAAC,CAAC;IACvD,CAAC;IAED,SAAS,IAAI,CACZ,IAAwB,EACxB,MAGC;;QAED,IAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,MAAA,MAAM,CAAC,UAAU,0CAAE,OAAO,CAAC,CAAC;QAC9D,IAAI,OAAO;YAAE,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;QAC5C,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,SAAS,CAAC,MAAM,CAAC,MAAA,MAAM,CAAC,YAAY,mCAAI,SAAS,CAAC,CAAC;IAC1D,CAAC;IAED,SAAS,MAAM,CACd,IAAwB,EACxB,MAGC;;QAED,IAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,MAAA,MAAM,CAAC,UAAU,0CAAE,OAAO,CAAC,CAAC;QAC9D,IAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,UAAU;YAAE,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACjE,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,SAAS,CAAC,MAAM,CAAC,MAAA,MAAM,CAAC,YAAY,mCAAI,SAAS,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,EAAE,IAAI,MAAA,EAAE,IAAI,MAAA,EAAE,MAAM,QAAA,EAAE,CAAC;AAC/B,CAAC"}

package/lib/esm/components/datatable/datatable-state-persistence.d.ts

@@ -0,0 +1,19 @@
+/**
+ * KTUI - Free & Open-Source Tailwind UI Components by Keenthemes
+ * Copyright 2025 by Keenthemes Inc
+ */
+import { KTDataTableStateInterface } from './types';
+export interface KTDataTableStatePersistence {
+    save(namespace: string, state: KTDataTableStateInterface): void;
+    load(namespace: string): KTDataTableStateInterface | null;
+    remove(namespace: string): void;
+}
+export declare function createStatePersistence(): KTDataTableStatePersistence;
+/**
+ * Resolve the namespace for a datatable state key.
+ * Priority: config.stateNamespace > table element ID > root element ID > fallback name.
+ */
+export declare function resolveTableNamespace(config: {
+    stateNamespace?: string;
+}, tableElement: HTMLTableElement | null, rootElement: HTMLElement | null, fallbackName: string): string;
+//# sourceMappingURL=datatable-state-persistence.d.ts.map

package/lib/esm/components/datatable/datatable-state-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datatable-state-persistence.d.ts","sourceRoot":"","sources":["../../../../src/components/datatable/datatable-state-persistence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEpD,MAAM,WAAW,2BAA2B;IAC3C,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAChE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,yBAAyB,GAAG,IAAI,CAAC;IAC1D,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,wBAAgB,sBAAsB,IAAI,2BAA2B,CAiCpE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACpC,MAAM,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,EACnC,YAAY,EAAE,gBAAgB,GAAG,IAAI,EACrC,WAAW,EAAE,WAAW,GAAG,IAAI,EAC/B,YAAY,EAAE,MAAM,GAClB,MAAM,CASR"}

package/lib/esm/components/datatable/datatable-state-persistence.js

@@ -0,0 +1,55 @@
+/**
+ * KTUI - Free & Open-Source Tailwind UI Components by Keenthemes
+ * Copyright 2025 by Keenthemes Inc
+ */
+export function createStatePersistence() {
+    function save(namespace, state) {
+        if (namespace) {
+            try {
+                localStorage.setItem(namespace, JSON.stringify(state));
+            }
+            catch (_a) {
+                // localStorage unavailable (e.g. Node.js without --localstorage-file)
+            }
+        }
+    }
+    function load(namespace) {
+        try {
+            var stateString = localStorage.getItem(namespace);
+            if (!stateString)
+                return null;
+            return JSON.parse(stateString);
+        }
+        catch (_a) {
+            return null;
+        }
+    }
+    function remove(namespace) {
+        if (namespace) {
+            try {
+                localStorage.removeItem(namespace);
+            }
+            catch (_a) {
+                // localStorage unavailable
+            }
+        }
+    }
+    return { save: save, load: load, remove: remove };
+}
+/**
+ * Resolve the namespace for a datatable state key.
+ * Priority: config.stateNamespace > table element ID > root element ID > fallback name.
+ */
+export function resolveTableNamespace(config, tableElement, rootElement, fallbackName) {
+    if (config.stateNamespace) {
+        return config.stateNamespace;
+    }
+    var tableIdAttr = tableElement === null || tableElement === void 0 ? void 0 : tableElement.getAttribute('id');
+    if (tableIdAttr)
+        return tableIdAttr;
+    var rootIdAttr = rootElement === null || rootElement === void 0 ? void 0 : rootElement.getAttribute('id');
+    if (rootIdAttr)
+        return rootIdAttr;
+    return fallbackName;
+}
+//# sourceMappingURL=datatable-state-persistence.js.map

package/lib/esm/components/datatable/datatable-state-persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datatable-state-persistence.js","sourceRoot":"","sources":["../../../../src/components/datatable/datatable-state-persistence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,UAAU,sBAAsB;IACrC,SAAS,IAAI,CAAC,SAAiB,EAAE,KAAgC;QAChE,IAAI,SAAS,EAAE,CAAC;YACf,IAAI,CAAC;gBACJ,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YACxD,CAAC;YAAC,WAAM,CAAC;gBACR,sEAAsE;YACvE,CAAC;QACF,CAAC;IACF,CAAC;IAED,SAAS,IAAI,CAAC,SAAiB;QAC9B,IAAI,CAAC;YACJ,IAAM,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACpD,IAAI,CAAC,WAAW;gBAAE,OAAO,IAAI,CAAC;YAE9B,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAA8B,CAAC;QAC7D,CAAC;QAAC,WAAM,CAAC;YACR,OAAO,IAAI,CAAC;QACb,CAAC;IACF,CAAC;IAED,SAAS,MAAM,CAAC,SAAiB;QAChC,IAAI,SAAS,EAAE,CAAC;YACf,IAAI,CAAC;gBACJ,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YACpC,CAAC;YAAC,WAAM,CAAC;gBACR,2BAA2B;YAC5B,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,EAAE,IAAI,MAAA,EAAE,IAAI,MAAA,EAAE,MAAM,QAAA,EAAE,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACpC,MAAmC,EACnC,YAAqC,EACrC,WAA+B,EAC/B,YAAoB;IAEpB,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC,cAAc,CAAC;IAC9B,CAAC;IACD,IAAM,WAAW,GAAG,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,YAAY,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,IAAM,UAAU,GAAG,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,YAAY,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAClC,OAAO,YAAY,CAAC;AACrB,CAAC"}

package/lib/esm/components/datatable/datatable-table-renderer.d.ts

@@ -7,6 +7,8 @@ import { KTDataTableTableRenderer, KTDataTableTableRendererInput } from './datat
 export declare class KTDataTableDomTableRenderer<T extends KTDataTableDataInterface> implements KTDataTableTableRenderer<T> {
     render(input: KTDataTableTableRendererInput<T>): HTMLTableSectionElement;
     notice(tableElement: HTMLTableElement, getLogicalColumnCount: () => number, message?: string): void;
+    private applyTableLayout;
+    private updateColgroup;
     private renderContent;
     private renderImplicitColumns;
     private renderConfiguredColumns;

package/lib/esm/components/datatable/datatable-table-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"datatable-table-renderer.d.ts","sourceRoot":"","sources":["../../../../src/components/datatable/datatable-table-renderer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACN,wBAAwB,EAExB,MAAM,SAAS,CAAC;AACjB,OAAO,EACN,wBAAwB,EACxB,6BAA6B,EAC7B,MAAM,uBAAuB,CAAC;AAE/B,qBAAa,2BAA2B,CACvC,CAAC,SAAS,wBAAwB,CACjC,YAAW,wBAAwB,CAAC,CAAC,CAAC;IAChC,MAAM,CACZ,KAAK,EAAE,6BAA6B,CAAC,CAAC,CAAC,GACrC,uBAAuB;IAiBnB,MAAM,CACZ,YAAY,EAAE,gBAAgB,EAC9B,qBAAqB,EAAE,MAAM,MAAM,EACnC,OAAO,GAAE,MAAW,GAClB,IAAI;IAQP,OAAO,CAAC,aAAa;IAsDrB,OAAO,CAAC,qBAAqB;IAmC7B,OAAO,CAAC,uBAAuB;IAiD/B,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,sBAAsB;CAW9B"}
+{"version":3,"file":"datatable-table-renderer.d.ts","sourceRoot":"","sources":["../../../../src/components/datatable/datatable-table-renderer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACN,wBAAwB,EAExB,MAAM,SAAS,CAAC;AACjB,OAAO,EACN,wBAAwB,EACxB,6BAA6B,EAC7B,MAAM,uBAAuB,CAAC;AAG/B,qBAAa,2BAA2B,CACvC,CAAC,SAAS,wBAAwB,CACjC,YAAW,wBAAwB,CAAC,CAAC,CAAC;IAChC,MAAM,CACZ,KAAK,EAAE,6BAA6B,CAAC,CAAC,CAAC,GACrC,uBAAuB;IAmBnB,MAAM,CACZ,YAAY,EAAE,gBAAgB,EAC9B,qBAAqB,EAAE,MAAM,MAAM,EACnC,OAAO,GAAE,MAAW,GAClB,IAAI;IASP,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,cAAc;IAwCtB,OAAO,CAAC,aAAa;IA8CrB,OAAO,CAAC,qBAAqB;IAmC7B,OAAO,CAAC,uBAAuB;IAuD/B,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,sBAAsB;CAW9B"}

package/lib/esm/components/datatable/datatable-table-renderer.js

@@ -2,6 +2,7 @@
  * KTUI - Free & Open-Source Tailwind UI Components by Keenthemes
  * Copyright 2025 by Keenthemes Inc
  */
+import { resolveColumns } from './datatable-column-utils';
 var KTDataTableDomTableRenderer = /** @class */ (function () {
     function KTDataTableDomTableRenderer() {
     }
@@ -10,9 +11,10 @@ var KTDataTableDomTableRenderer = /** @class */ (function () {
             input.tableElement.removeChild(input.tableElement.tBodies[0]);
         }
         var tbodyElement = input.tableElement.createTBody();
-        if (input.originalTbodyClass) {
-            tbodyElement.className = input.originalTbodyClass;
+        if (input.originalClasses.tbody) {
+            tbodyElement.className = input.originalClasses.tbody;
         }
+        this.applyTableLayout(input);
         this.renderContent(input, tbodyElement);
         return tbodyElement;
     };
@@ -22,8 +24,64 @@ var KTDataTableDomTableRenderer = /** @class */ (function () {
         var cell = row.insertCell();
         var logicalCount = getLogicalColumnCount();
         cell.colSpan = logicalCount > 0 ? logicalCount : 1;
+        cell.style.textAlign = 'center';
         cell.innerHTML = message;
     };
+    KTDataTableDomTableRenderer.prototype.applyTableLayout = function (input) {
+        var tableLayout = input.config.tableLayout || 'auto';
+        var tableElement = input.tableElement;
+        tableElement.style.tableLayout = tableLayout;
+        if (tableLayout === 'fixed') {
+            if (!tableElement.style.width) {
+                tableElement.style.width = '100%';
+            }
+            this.updateColgroup(input);
+        }
+        else {
+            var existingColgroup = tableElement.querySelector('colgroup');
+            if (existingColgroup) {
+                tableElement.removeChild(existingColgroup);
+            }
+        }
+    };
+    KTDataTableDomTableRenderer.prototype.updateColgroup = function (input) {
+        var tableElement = input.tableElement;
+        var existingColgroup = tableElement.querySelector('colgroup');
+        if (existingColgroup) {
+            tableElement.removeChild(existingColgroup);
+        }
+        var colgroup = document.createElement('colgroup');
+        if (input.config.columns) {
+            var columns = input.config.columns;
+            for (var _i = 0, _a = Object.keys(columns); _i < _a.length; _i++) {
+                var key = _a[_i];
+                var col = document.createElement('col');
+                if (columns[key].width) {
+                    col.style.width = columns[key].width;
+                }
+                colgroup.appendChild(col);
+            }
+        }
+        else {
+            var columnsByIndex = resolveColumns(input.theadElement).columnsByIndex;
+            for (var _b = 0, columnsByIndex_1 = columnsByIndex; _b < columnsByIndex_1.length; _b++) {
+                var th = columnsByIndex_1[_b];
+                var col = document.createElement('col');
+                var width = th.getAttribute('data-kt-datatable-column-width');
+                if (width) {
+                    col.style.width = width;
+                }
+                colgroup.appendChild(col);
+            }
+        }
+        var thead = tableElement.querySelector('thead');
+        if (thead) {
+            tableElement.insertBefore(colgroup, thead);
+        }
+        else {
+            tableElement.appendChild(colgroup);
+        }
+    };
     KTDataTableDomTableRenderer.prototype.renderContent = function (input, tbodyElement) {
         var _this = this;
         var fragment = document.createDocumentFragment();
@@ -32,20 +90,14 @@ var KTDataTableDomTableRenderer = /** @class */ (function () {
             this.notice(input.tableElement, input.getLogicalColumnCount, input.config.infoEmpty || '');
             return tbodyElement;
         }
-        var allThs = input.theadElement
-            ? input.theadElement.querySelectorAll('th')
-            : [];
-        var ths = Array.from(allThs).filter(function (th) {
-            return th.hasAttribute('data-kt-datatable-column');
-        });
-        var columnsToRender = ths.length > 0 && ths.length !== allThs.length ? Array.from(allThs) : ths;
+        var columnsToRender = resolveColumns(input.theadElement).columnsByIndex;
         var logicalColumnCount = columnsToRender.length > 0
             ? columnsToRender.length
             : input.getLogicalColumnCount();
         input.data.forEach(function (item, rowIndex) {
             var row = document.createElement('tr');
-            if (input.originalTrClasses && input.originalTrClasses[rowIndex]) {
-                row.className = input.originalTrClasses[rowIndex];
+            if (input.originalClasses.tr && input.originalClasses.tr[rowIndex]) {
+                row.className = input.originalClasses.tr[rowIndex];
             }
             if (!input.config.columns) {
                 _this.renderImplicitColumns(input, row, item, rowIndex, {
@@ -110,7 +162,14 @@ var KTDataTableDomTableRenderer = /** @class */ (function () {
                 }
             }
             else {
-                td.textContent = item[colKey];
+                var cellValue = item[colKey];
+                if (cellValue === null || cellValue === undefined) {
+                    td.textContent = '';
+                }
+                else {
+                    // Match implicit column rendering: preserve HTML from DOM extraction.
+                    td.innerHTML = String(cellValue);
+                }
             }
             if (typeof columnDef.createdCell === 'function') {
                 columnDef.createdCell.call(input.context, td, item[colKey], item, row);
@@ -119,10 +178,10 @@ var KTDataTableDomTableRenderer = /** @class */ (function () {
         });
     };
     KTDataTableDomTableRenderer.prototype.applyOriginalTdClass = function (input, td, rowIndex, colIndex) {
-        if (input.originalTdClasses &&
-            input.originalTdClasses[rowIndex] &&
-            input.originalTdClasses[rowIndex][colIndex]) {
-            td.className = input.originalTdClasses[rowIndex][colIndex];
+        if (input.originalClasses.td &&
+            input.originalClasses.td[rowIndex] &&
+            input.originalClasses.td[rowIndex][colIndex]) {
+            td.className = input.originalClasses.td[rowIndex][colIndex];
         }
     };
     KTDataTableDomTableRenderer.prototype.applyDataRowAttributes = function (td, dataRowAttributes, colIndex) {