@keenthemes/ktui 1.2.6 → 1.2.7

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) {

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * KTUI - Free & Open-Source Tailwind UI Components by Keenthemes
+ * Copyright 2025 by Keenthemes Inc
+ */
+/**
+ * Strip HTML tags and   entities from a value, returning plain text.
+ * Used by sort, search, and filter pipelines.
+ */
+export declare function stripHtml(value: unknown): string;
+//# sourceMappingURL=datatable-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"datatable-utils.d.ts","sourceRoot":"","sources":["../../../../src/components/datatable/datatable-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEhD"}

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

@@ -0,0 +1,12 @@
+/**
+ * KTUI - Free & Open-Source Tailwind UI Components by Keenthemes
+ * Copyright 2025 by Keenthemes Inc
+ */
+/**
+ * Strip HTML tags and   entities from a value, returning plain text.
+ * Used by sort, search, and filter pipelines.
+ */
+export function stripHtml(value) {
+    return String(value).replace(/<[^>]*>|&nbsp;/g, '');
+}
+//# sourceMappingURL=datatable-utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"datatable-utils.js","sourceRoot":"","sources":["../../../../src/components/datatable/datatable-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACvC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;AACrD,CAAC"}

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

@@ -3,30 +3,15 @@
  * Copyright 2025 by Keenthemes Inc
  */
 import KTComponent from '../component';
-import { KTDataTableDataInterface, KTDataTableInterface, KTDataTableConfigInterface as KTDataTableConfigInterface, KTDataTableStateInterface, KTDataTableColumnFilterInterface } from './types';
-/**
- * Custom DataTable plugin class with server-side API, pagination, and sorting
- * @classdesc A custom KTComponent class that integrates server-side API, pagination, and sorting functionality into a table.
- * It supports fetching data from a server-side API, pagination, and sorting of the fetched data.
- * @class
- * @extends {KTComponent}
- * @param {HTMLElement} element The table element
- * @param {KTDataTableConfigInterface} [config] Additional configuration options
- */
+import { KTDataTableDataInterface, KTDataTableInterface, KTDataTableConfigInterface as KTDataTableConfigInterface, KTDataTableSortOrderInterface, KTDataTableStateInterface, KTDataTableColumnFilterInterface } from './types';
 export declare class KTDataTable<T extends KTDataTableDataInterface> extends KTComponent implements KTDataTableInterface {
-    private static asElementWithInstance;
-    private static asSearchElementWithDebounce;
     protected _name: string;
     protected _config: KTDataTableConfigInterface;
     protected _defaultConfig: KTDataTableConfigInterface;
     private _tableElement;
     private _tbodyElement;
     private _theadElement;
-    private _originalTbodyClass;
-    private _originalTrClasses;
-    private _originalTheadClass;
-    private _originalTdClasses;
-    private _originalThClasses;
+    private _originalClasses;
     private _infoElement;
     private _sizeElement;
     private _paginationElement;
@@ -40,6 +25,9 @@ export declare class KTDataTable<T extends KTDataTableDataInterface> extends KTC
     private _tableRenderer;
     private _paginationRenderer;
     private _cleanupCallbacks;
+    private _searchHandler;
+    private _statePersistence;
+    private _spinner;
     private _data;
     private _isFetching;
     constructor(element: HTMLElement, config?: KTDataTableConfigInterface);
@@ -58,6 +46,7 @@ export declare class KTDataTable<T extends KTDataTableDataInterface> extends KTC
      * @param config User-provided configuration options
      * @returns Default configuration merged with user-provided options
      */
+    private _createDefaultSearchCallback;
     private _initDefaultConfig;
     /**
      * Initialize table, tbody, thead, info, size, and pagination elements
@@ -79,11 +68,6 @@ export declare class KTDataTable<T extends KTDataTableDataInterface> extends KTC
      * @returns {void}
      */
     private _finalize;
-    /**
-     * Attach search event to the search input element
-     * @returns {void}
-     */
-    private _attachSearchEvent;
     /**
      * Returns the logical data column count (number of data columns), used for multi-row headers
      * where querySelectorAll('th') would overcount. Prefers state.originalData, then first tbody row td count.
@@ -133,9 +117,6 @@ export declare class KTDataTable<T extends KTDataTableDataInterface> extends KTC
      * @param page - The page number to navigate to
      */
     private _paginateData;
-    private _showSpinner;
-    private _hideSpinner;
-    private _createSpinner;
     /**
      * Saves the current state of the table to local storage.
      * @returns {void}
@@ -161,8 +142,17 @@ export declare class KTDataTable<T extends KTDataTableDataInterface> extends KTC
      * Clean up all event listeners, handlers, and DOM nodes created by this instance.
      * This method is called before re-rendering or when disposing the component.
      */
+    /**
+     * Clean up event listeners and DOM artifacts for a redraw cycle.
+     * Does NOT remove the instance from the registry — the datatable
+     * remains accessible via getInstance() during the redraw window.
+     */
+    private _cleanupForRedraw;
+    /**
+     * Full disposal — cleans up listeners AND removes the instance from
+     * the registry. Only called when the component is being destroyed.
+     */
     private _dispose;
-    private _debounce;
     /**
      * Gets the current state of the table.
      * @returns {KTDataTableStateInterface} The current state of the table.
@@ -170,9 +160,11 @@ export declare class KTDataTable<T extends KTDataTableDataInterface> extends KTC
     getState(): KTDataTableStateInterface;
     /**
      * Sorts the data in the table by the specified field.
+     * When `order` is provided, applies that sort direction instead of toggling.
      * @param field The field to sort by.
+     * @param order Optional sort direction (`asc`, `desc`, or `''` to clear).
      */
-    sort(field: keyof T | number): void;
+    sort(field: keyof T | number, order?: KTDataTableSortOrderInterface): void;
     /**
      * Navigates to the specified page in the data table.
      * @param page The page number to navigate to.
@@ -184,8 +176,8 @@ export declare class KTDataTable<T extends KTDataTableDataInterface> extends KTC
      */
     setPageSize(pageSize: number): void;
     /**
-     * Reloads the data from the server and updates the table.
-     * Triggers the 'reload' event and the 'kt.datatable.reload' custom event.
+     * Reloads the data from the source (API or DOM) and redraws the table.
+     * @returns {Promise<void>}
      */
     reload(): void;
     redraw(page?: number): void;
@@ -207,10 +199,6 @@ export declare class KTDataTable<T extends KTDataTableDataInterface> extends KTC
     setFilter(filter: KTDataTableColumnFilterInterface): KTDataTable<T>;
     dispose(): void;
     search(query: string | object): void;
-    /**
-     * Static variables
-     */
-    private static _instances;
     /**
      * Create KTDataTable instances for all elements with a data-kt-datatable="true" attribute.
      * This function is now browser-guarded and must be called explicitly.
@@ -259,9 +247,13 @@ export declare class KTDataTable<T extends KTDataTableDataInterface> extends KTC
      */
     getChecked(): string[];
     /**
-     * Reapply checked state to visible checkboxes (after redraw/pagination)
+     * Re-apply checkbox checked states to visible rows after a redraw or pagination change.
      * @returns {void}
      */
+    refreshCheckboxes(): void;
+    /**
+     * @deprecated Use {@link refreshCheckboxes} instead.
+     */
     update(): void;
 }
 /**

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

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