@ukic/canary-web-components 3.0.0-canary.1 → 3.0.0-canary.10

package/dist/collection/components/ic-data-table/ic-data-table.js

@@ -4,7 +4,8 @@ import unsortedIcon from "./assets/unsorted-icon.svg";
 import ascendingIcon from "./assets/ascending-icon.svg";
 import descendingIcon from "./assets/descending-icon.svg";
 // Unable to import helper functions via @ukic/web-components
-import { isEmptyString, isSlotUsed, pxToRem, addDataToPosition, dynamicDebounce, } from "../../utils/helpers";
+import { isEmptyString, isSlotUsed, pxToRem, addDataToPosition, dynamicDebounce, getSlotElements, checkResizeObserver, deviceSizeMatches, } from "../../utils/helpers";
+import { IC_DEVICE_SIZES } from "../../utils/constants";
 /**
  * @slot empty-state - Content is slotted below the table header when there is no data and the table is not loading.
  * @slot {COLUMN_KEY}-{ROW_INDEX}[-icon] - Each cell should have its own slot, named using the column tag and the row index, allowing for custom elements to be displayed. Include `-icon` at the end for that cell's icon slot.
@@ -44,10 +45,43 @@ export class DataTable {
         this.itemsPerPageChange = false;
         this.DATA_ROW_HEIGHT_STRING = "data-row-height";
         this.ROW_HEIGHT_CSS_VARIABLE = "--row-height";
+        this.LINE_CLAMP_CSS_VARIABLE = "--ic-line-clamp";
         this.DEFAULT_LINE_HEIGHT = 24;
         this.densityUpdate = false;
         this.truncationPatternUpdated = false;
         this.isNewDebounceDelaySet = false;
+        this.headerResizeObserver = null;
+        this.IC_TOOLTIP_STRING = "ic-tooltip";
+        this.SHOW_TRUNC_TOOLTIP_STRING = "show-trunc-tooltip";
+        this.CELL_DESCRIPTION_STRING = ".cell-description";
+        this.CELL_CONTAINER_WITH_DESCRIPTION_STRING = "cell-container-with-description";
+        this.CELL_TEXT_WRAPPER_STRING = ".cell-text-wrapper";
+        this.IC_TYPOGRAPHY_STRING = "ic-typography";
+        this.runHeaderResizeObserver = () => {
+            this.headerResizeObserver = new ResizeObserver(() => {
+                this.headerResizeCallback();
+            });
+            this.headerResizeObserver.observe(this.el);
+        };
+        this.headerResizeCallback = () => {
+            if (!this.hideColumnHeaders && this.columnHeaderTruncation) {
+                const tableContainerWidth = this.el.shadowRoot.querySelector(".table-container").clientWidth;
+                if (tableContainerWidth !== this.prevTableContainerWidth) {
+                    const headers = this.el.shadowRoot.querySelectorAll("th.column-header");
+                    headers.forEach((header) => {
+                        const tooltip = header.querySelector(this.IC_TOOLTIP_STRING);
+                        const typographyEls = header.querySelectorAll(this.IC_TYPOGRAPHY_STRING);
+                        if (tooltip && typographyEls && typographyEls.length === 2) {
+                            tooltip.classList.remove(this.SHOW_TRUNC_TOOLTIP_STRING);
+                            if (typographyEls[1].clientWidth > typographyEls[0].clientWidth) {
+                                tooltip.classList.add(this.SHOW_TRUNC_TOOLTIP_STRING);
+                            }
+                        }
+                    });
+                    this.prevTableContainerWidth = tableContainerWidth;
+                }
+            }
+        };
         this.updateSetRowHeight = (typographyEl) => {
             const fontSize = parseInt(getComputedStyle(document.documentElement).fontSize);
             if (typographyEl) {
@@ -104,8 +138,9 @@ export class DataTable {
             }
             else {
                 if (this.truncationPattern === this.TOOLTIP_STRING && tooltip) {
-                    typographyEl.setAttribute("style", `--ic-line-clamp: 0`);
-                    cellContainer.appendChild(typographyEl);
+                    typographyEl.setAttribute("style", `${this.LINE_CLAMP_CSS_VARIABLE}: 0`);
+                    const cellTextWrapper = cellContainer.querySelector(this.CELL_TEXT_WRAPPER_STRING);
+                    cellTextWrapper.prepend(typographyEl);
                     tooltip.remove();
                 }
                 if (this.truncationPattern === this.SHOW_HIDE_STRING &&
@@ -160,6 +195,7 @@ export class DataTable {
             }
             this.truncate(typographyEl, cellContainer, tooltip);
         };
+        this.getTruncWrapper = (typographyEl) => typographyEl.shadowRoot.querySelector(".trunc-wrapper");
         this.removeTextWrap = () => {
             this.getTypographyElements().forEach((typographyEl) => {
                 const tableCell = typographyEl.closest("td");
@@ -181,7 +217,7 @@ export class DataTable {
                 this.timerStarted = null;
             }, this.minimumLoadingDisplayDuration);
         };
-        this.isObject = (value) => typeof value === "object";
+        this.isObject = (value) => value !== undefined && value !== null && typeof value === "object";
         this.notDefaultDensity = () => this.density !== "default";
         this.getCellContent = (cell, dataType) => {
             switch (dataType) {
@@ -204,19 +240,16 @@ export class DataTable {
             return this.getObjectValue(cell, key);
         };
         this.createUpdatingIndicator = () => {
-            const { appearance, description, max, min, progress } = this.updatingOptions || {};
-            return (h("th", { colSpan: this.columns.length, class: "updating-state" }, h("ic-loading-indicator", { appearance: appearance, description: description || "Updating table data", fullWidth: true, max: max, min: min, progress: progress, type: "linear", size: "small" })));
+            const { description, max, min, progress, monochrome } = this.updatingOptions || {};
+            return (h("th", { colSpan: this.columns.length, class: "updating-state" }, h("ic-loading-indicator", { theme: this.theme, monochrome: monochrome, description: description || "Updating table data", fullWidth: true, max: max, min: min, progress: progress, type: "linear", size: "small" })));
         };
         this.setRowHeight = (height) => {
             return pxToRem(`${height * this.DENSITY_HEIGHT_MULTIPLIER[this.density] -
                 this.DENSITY_PADDING_HEIGHT_DIFF[this.density]}px`);
         };
-        this.setTruncationClass = () => {
-            if (this.truncationPattern) {
-                return { [`truncation-${this.truncationPattern}`]: true };
-            }
-            return {};
-        };
+        this.setTruncationClass = () => this.truncationPattern
+            ? { [`truncation-${this.truncationPattern}`]: true }
+            : {};
         this.getColumnWidth = (columnWidth) => {
             // TODO: Setting max width on columns
             let columnWidthStyling = {};
@@ -247,6 +280,56 @@ export class DataTable {
             }
             return {};
         };
+        this.adjustWidthForActionElement = () => {
+            const elements = this.el.shadowRoot.querySelectorAll(".action-element");
+            elements.forEach((element) => {
+                const width = element.firstChild.getBoundingClientRect()
+                    .width;
+                const gridWrapper = element.closest(".cell-grid-wrapper");
+                gridWrapper.style.gridTemplateColumns = `auto calc(${width}px + var(--ic-space-xs))`;
+            });
+        };
+        this.createCellContent = (columnProps, cell, cellSlotName, rowOptions, rowAlignment, hasIcon, currentRowHeight, cellValue, rowEmphasis) => {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
+            return (h("div", { innerHTML: (columnProps === null || columnProps === void 0 ? void 0 : columnProps.dataType) === "element" &&
+                    !isSlotUsed(this.el, cellSlotName)
+                    ? cell
+                    : null, class: Object.assign(Object.assign({ "cell-container": (columnProps === null || columnProps === void 0 ? void 0 : columnProps.dataType) !== "element", [`cell-alignment-${((_a = columnProps === null || columnProps === void 0 ? void 0 : columnProps.columnAlignment) === null || _a === void 0 ? void 0 : _a.vertical) ||
+                        ((_b = rowOptions === null || rowOptions === void 0 ? void 0 : rowOptions.rowAlignment) === null || _b === void 0 ? void 0 : _b.vertical) ||
+                        rowAlignment ||
+                        this.getCellAlignment(cell, "vertical")}`]: !!((_c = columnProps === null || columnProps === void 0 ? void 0 : columnProps.columnAlignment) === null || _c === void 0 ? void 0 : _c.vertical) ||
+                        !!((_d = rowOptions === null || rowOptions === void 0 ? void 0 : rowOptions.rowAlignment) === null || _d === void 0 ? void 0 : _d.vertical) ||
+                        !!rowAlignment ||
+                        !!this.getCellAlignment(cell, "vertical"), [`cell-alignment-${((_e = columnProps === null || columnProps === void 0 ? void 0 : columnProps.columnAlignment) === null || _e === void 0 ? void 0 : _e.horizontal) ||
+                        ((_f = rowOptions === null || rowOptions === void 0 ? void 0 : rowOptions.rowAlignment) === null || _f === void 0 ? void 0 : _f.horizontal) ||
+                        this.getCellAlignment(cell, "horizontal")}`]: !!((_g = columnProps === null || columnProps === void 0 ? void 0 : columnProps.columnAlignment) === null || _g === void 0 ? void 0 : _g.horizontal) ||
+                        !!((_h = rowOptions === null || rowOptions === void 0 ? void 0 : rowOptions.rowAlignment) === null || _h === void 0 ? void 0 : _h.horizontal) ||
+                        !!this.getCellAlignment(cell, "horizontal"), [`data-type-${columnProps === null || columnProps === void 0 ? void 0 : columnProps.dataType}`]: true, [this.TEXT_WRAP_STRING]: (columnProps === null || columnProps === void 0 ? void 0 : columnProps.textWrap) ||
+                        (rowOptions === null || rowOptions === void 0 ? void 0 : rowOptions.textWrap) ||
+                        !!this.getCellOptions(cell, "textWrap"), ["cell-icon"]: hasIcon || !!((_j = columnProps === null || columnProps === void 0 ? void 0 : columnProps.icon) === null || _j === void 0 ? void 0 : _j.icon), [`cell-emphasis-${(this.isObject(cell) && cellValue("emphasis")) ||
+                        (columnProps === null || columnProps === void 0 ? void 0 : columnProps.emphasis) ||
+                        rowEmphasis}`]: (this.isObject(cell) && !!cellValue("emphasis")) ||
+                        !!(columnProps === null || columnProps === void 0 ? void 0 : columnProps.emphasis) ||
+                        !!rowEmphasis }, this.setTruncationClass()), { [this.CELL_CONTAINER_WITH_DESCRIPTION_STRING]: this.isObject(cell) && Object.keys(cell).includes("description") }), style: Object.assign(Object.assign({}, this.getRowHeight(currentRowHeight, columnProps, rowOptions === null || rowOptions === void 0 ? void 0 : rowOptions.textWrap, cell)), this.getColumnWidth(columnProps === null || columnProps === void 0 ? void 0 : columnProps.columnWidth)), "data-row-height": this.truncationPattern || currentRowHeight
+                    ? this.setRowHeight(currentRowHeight)
+                    : null }, isSlotUsed(this.el, cellSlotName) ? (h("slot", { name: cellSlotName })) : (h(Fragment, null, isSlotUsed(this.el, `${cellSlotName}-icon`) ? (h("slot", { name: `${cellSlotName}-icon` })) : ((hasIcon || ((_k = columnProps === null || columnProps === void 0 ? void 0 : columnProps.icon) === null || _k === void 0 ? void 0 : _k.onAllCells)) &&
+                (cellValue("icon") || ((_l = columnProps === null || columnProps === void 0 ? void 0 : columnProps.icon) === null || _l === void 0 ? void 0 : _l.icon)) && (h("span", { class: "icon", innerHTML: cellValue("icon") || ((_m = columnProps === null || columnProps === void 0 ? void 0 : columnProps.icon) === null || _m === void 0 ? void 0 : _m.icon) }))), (columnProps === null || columnProps === void 0 ? void 0 : columnProps.dataType) !== "element" &&
+                !isSlotUsed(this.el, cellSlotName) && (h("div", { class: {
+                    "cell-text-wrapper": true,
+                    "cell-text-no-wrap": !this.truncationPattern,
+                } }, h("ic-typography", { variant: "body", class: {
+                    [`cell-emphasis-${(this.isObject(cell) && cellValue("emphasis")) ||
+                        (columnProps === null || columnProps === void 0 ? void 0 : columnProps.emphasis) ||
+                        rowEmphasis}`]: (this.isObject(cell) && !!cellValue("emphasis")) ||
+                        !!(columnProps === null || columnProps === void 0 ? void 0 : columnProps.emphasis) ||
+                        !!rowEmphasis,
+                    [`text-${this.density}`]: this.notDefaultDensity(),
+                } }, this.isObject(cell) && (columnProps === null || columnProps === void 0 ? void 0 : columnProps.dataType) !== "date" ? (Object.keys(cell).includes("href") ? (h("ic-link", { href: cellValue("href"), theme: this.theme, target: cellValue("target") || undefined, rel: cellValue("rel") || undefined }, cellValue("data"))) : (cellValue("data"))) : (this.getCellContent(cell, columnProps === null || columnProps === void 0 ? void 0 : columnProps.dataType))), this.isObject(cell) &&
+                Object.keys(cell).includes("description") && (h("div", { class: {
+                    ["cell-description"]: true,
+                    [`data-type-${columnProps === null || columnProps === void 0 ? void 0 : columnProps.dataType}`]: true,
+                } }, ((_o = cellValue("description")) === null || _o === void 0 ? void 0 : _o.icon) && (h("span", { class: "cell-description-icon", innerHTML: cellValue("description").icon })), h("ic-typography", { variant: "caption", class: "cell-description-text" }, (_q = (_p = cellValue("description")) === null || _p === void 0 ? void 0 : _p.data) !== null && _q !== void 0 ? _q : cellValue("description"))))))))));
+        };
         this.createCells = (row, rowIndex) => {
             var _a;
             const rowValues = Object.values(row);
@@ -264,7 +347,6 @@ export class DataTable {
                 ? variableRowHeightVal !== "auto" && variableRowHeightVal
                 : this.globalRowHeight !== "auto" && this.globalRowHeight;
             return rowValues.map((cell, index) => {
-                var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
                 const columnProps = this.columns[index];
                 const cellSlotName = `${columnProps === null || columnProps === void 0 ? void 0 : columnProps.key}-${rowIndex}`;
                 const hasIcon = this.isObject(cell) && Object.keys(cell).includes("icon");
@@ -280,59 +362,48 @@ export class DataTable {
                     return (h("td", { class: {
                             ["table-cell"]: true,
                             [`table-density-${this.density}`]: this.notDefaultDensity(),
-                        }, style: Object.assign({}, this.getColumnWidth(columnProps.columnWidth)) }, h("div", { innerHTML: (columnProps === null || columnProps === void 0 ? void 0 : columnProps.dataType) === "element" &&
-                            !isSlotUsed(this.el, cellSlotName)
-                            ? cell
-                            : null, class: Object.assign({ "cell-container": (columnProps === null || columnProps === void 0 ? void 0 : columnProps.dataType) !== "element", [`cell-alignment-${((_a = columnProps === null || columnProps === void 0 ? void 0 : columnProps.columnAlignment) === null || _a === void 0 ? void 0 : _a.vertical) ||
-                                ((_b = rowOptions === null || rowOptions === void 0 ? void 0 : rowOptions.rowAlignment) === null || _b === void 0 ? void 0 : _b.vertical) ||
-                                rowAlignment ||
-                                this.getCellAlignment(cell, "vertical")}`]: !!((_c = columnProps === null || columnProps === void 0 ? void 0 : columnProps.columnAlignment) === null || _c === void 0 ? void 0 : _c.vertical) ||
-                                !!((_d = rowOptions === null || rowOptions === void 0 ? void 0 : rowOptions.rowAlignment) === null || _d === void 0 ? void 0 : _d.vertical) ||
-                                !!rowAlignment ||
-                                !!this.getCellAlignment(cell, "vertical"), [`cell-alignment-${((_e = columnProps === null || columnProps === void 0 ? void 0 : columnProps.columnAlignment) === null || _e === void 0 ? void 0 : _e.horizontal) ||
-                                ((_f = rowOptions === null || rowOptions === void 0 ? void 0 : rowOptions.rowAlignment) === null || _f === void 0 ? void 0 : _f.horizontal) ||
-                                this.getCellAlignment(cell, "horizontal")}`]: !!((_g = columnProps === null || columnProps === void 0 ? void 0 : columnProps.columnAlignment) === null || _g === void 0 ? void 0 : _g.horizontal) ||
-                                !!((_h = rowOptions === null || rowOptions === void 0 ? void 0 : rowOptions.rowAlignment) === null || _h === void 0 ? void 0 : _h.horizontal) ||
-                                !!this.getCellAlignment(cell, "horizontal"), [`data-type-${columnProps === null || columnProps === void 0 ? void 0 : columnProps.dataType}`]: true, [this.TEXT_WRAP_STRING]: (columnProps === null || columnProps === void 0 ? void 0 : columnProps.textWrap) ||
-                                (rowOptions === null || rowOptions === void 0 ? void 0 : rowOptions.textWrap) ||
-                                !!this.getCellOptions(cell, "textWrap"), ["cell-icon"]: hasIcon || !!((_j = columnProps === null || columnProps === void 0 ? void 0 : columnProps.icon) === null || _j === void 0 ? void 0 : _j.icon) }, this.setTruncationClass()), style: Object.assign(Object.assign({}, this.getRowHeight(currentRowHeight, columnProps, rowOptions === null || rowOptions === void 0 ? void 0 : rowOptions.textWrap, cell)), this.getColumnWidth(columnProps === null || columnProps === void 0 ? void 0 : columnProps.columnWidth)), "data-row-height": this.truncationPattern || currentRowHeight
-                            ? this.setRowHeight(currentRowHeight)
-                            : null }, isSlotUsed(this.el, cellSlotName) ? (h("slot", { name: cellSlotName })) : (h(Fragment, null, isSlotUsed(this.el, `${cellSlotName}-icon`) ? (h("slot", { name: `${cellSlotName}-icon` })) : ((hasIcon || ((_k = columnProps === null || columnProps === void 0 ? void 0 : columnProps.icon) === null || _k === void 0 ? void 0 : _k.onAllCells)) && (h("span", { class: "icon", innerHTML: cellValue("icon") || (columnProps === null || columnProps === void 0 ? void 0 : columnProps.icon.icon) }))), (columnProps === null || columnProps === void 0 ? void 0 : columnProps.dataType) !== "element" &&
-                        !isSlotUsed(this.el, cellSlotName) && (h("ic-typography", { variant: "body", class: {
-                            [`cell-emphasis-${(this.isObject(cell) && cellValue("emphasis")) ||
-                                (columnProps === null || columnProps === void 0 ? void 0 : columnProps.emphasis) ||
-                                rowEmphasis}`]: (this.isObject(cell) && !!cellValue("emphasis")) ||
-                                !!(columnProps === null || columnProps === void 0 ? void 0 : columnProps.emphasis) ||
-                                !!rowEmphasis,
-                            [`text-${this.density}`]: this.notDefaultDensity(),
-                        } }, this.isObject(cell) &&
-                        (columnProps === null || columnProps === void 0 ? void 0 : columnProps.dataType) !== "date" ? (Object.keys(cell).includes("href") ? (h("ic-link", { href: cellValue("href") }, cellValue("data"))) : (cellValue("data"))) : (this.getCellContent(cell, columnProps === null || columnProps === void 0 ? void 0 : columnProps.dataType)))))))));
+                            ["with-overflow"]: (columnProps === null || columnProps === void 0 ? void 0 : columnProps.dataType) === "element",
+                        }, style: Object.assign({}, this.getColumnWidth(columnProps.columnWidth)) }, this.isObject(cell) &&
+                        Object.keys(cell).includes("actionElement") ? (h("div", { class: "cell-grid-wrapper" }, this.createCellContent(columnProps, cell, cellSlotName, rowOptions, rowAlignment, hasIcon, currentRowHeight, cellValue, rowEmphasis), h("span", { class: "action-element", innerHTML: cellValue("actionElement"),
+                        // eslint-disable-next-line react/jsx-no-bind
+                        onClick: cell.actionOnClick
+                            ? (event) => this.handleClick(event, cell.actionOnClick)
+                            : undefined }))) : (this.createCellContent(columnProps, cell, cellSlotName, rowOptions, rowAlignment, hasIcon, currentRowHeight, cellValue, rowEmphasis))));
                 }
             });
         };
-        this.createColumnHeaders = () => {
-            return this.columns.map(({ cellAlignment, colspan, icon, key, title, columnWidth }) => (h("th", { scope: "col", class: {
-                    ["column-header"]: true,
-                    [`table-density-${this.density}`]: this.notDefaultDensity(),
-                    ["updating-state-headers"]: this.updating && !this.loading,
-                }, style: Object.assign({}, this.getColumnWidth(columnWidth)), colSpan: colspan }, h("div", { class: {
-                    "column-header-inner-container": true,
-                    [`column-header-alignment-${cellAlignment}`]: !!cellAlignment,
-                } }, isSlotUsed(this.el, `${key}-column-icon`) ? (h("slot", { name: `${key}-column-icon` })) : (icon &&
-                !icon.hideOnHeader && (h("span", { class: "icon", innerHTML: icon.icon }))), h("ic-typography", { variant: "body", class: {
-                    ["column-header-text"]: true,
-                    [`text-${this.density}`]: this.notDefaultDensity(),
-                } }, title), this.sortable && (h("ic-button", { variant: "icon", id: `sort-button-${key}`, "aria-label": this.getSortButtonLabel(key),
-                // eslint-disable-next-line react/jsx-no-bind
-                onClick: () => this.sortRows(key), innerHTML: this.SORT_ICONS[this.sortedColumn === key
-                    ? this.sortedColumnOrder
-                    : "unsorted"], class: {
-                    ["sort-button"]: true,
-                    ["sort-button-unsorted"]: this.sortedColumn !== key ||
-                        this.sortedColumnOrder === "unsorted",
-                } }))))));
-        };
+        this.createColumnHeaders = () => (this.columns || []).map(({ cellAlignment, colspan, icon, key, title, columnWidth }, index) => (h("th", { scope: "col", class: {
+                ["column-header"]: true,
+                [`table-density-${this.density}`]: this.notDefaultDensity(),
+                ["updating-state-headers"]: this.updating && !this.loading,
+            }, style: Object.assign({}, this.getColumnWidth(columnWidth)), colSpan: colspan }, h("div", { class: {
+                "column-header-inner-container": true,
+                "truncation-tooltip": this.columnHeaderTruncation,
+                [`column-header-alignment-${cellAlignment}`]: !!cellAlignment,
+            } }, isSlotUsed(this.el, `${key}-column-icon`) ? (h("slot", { name: `${key}-column-icon` })) : (icon &&
+            !icon.hideOnHeader && (h("span", { class: "icon", innerHTML: icon.icon }))), this.columnHeaderTruncation ? (h("ic-tooltip", { label: title, target: `column-header-${index}` }, h("ic-typography", { id: `column-header-${index}`, variant: "body", class: {
+                ["column-header-text"]: true,
+                [`text-${this.density}`]: this.notDefaultDensity(),
+            } }, title))) : (h("ic-typography", { variant: "body", class: {
+                ["column-header-text"]: true,
+                [`text-${this.density}`]: this.notDefaultDensity(),
+            } }, title)), this.sortable && (h("ic-button", { variant: "icon", id: `sort-button-${key}`, "aria-label": this.getSortButtonLabel(key),
+            // eslint-disable-next-line react/jsx-no-bind
+            onClick: () => this.sortRows(key), innerHTML: this.SORT_ICONS[this.sortedColumn === key
+                ? this.sortedColumnOrder
+                : "unsorted"], class: {
+                ["sort-button"]: true,
+                ["sort-button-unsorted"]: this.sortedColumn !== key ||
+                    this.sortedColumnOrder === "unsorted",
+            } }))), this.columnHeaderTruncation && (h("ic-typography", { variant: "body", "aria-hidden": "true", class: {
+                ["column-header-text"]: true,
+                ["dummy-column-header-text"]: this.columnHeaderTruncation,
+                [`text-${this.density}`]: this.notDefaultDensity(),
+            } }, title)))));
         this.onRowClick = (row) => {
+            if (!this.loading && !this.updating) {
+                this.icSelectedRowChange.emit(this.selectedRow !== row ? row : null);
+            }
             this.selectedRow =
                 this.selectedRow !== row && !this.loading && !this.updating && row;
         };
@@ -349,26 +420,28 @@ export class DataTable {
             const organisedData = data.map((row, rowIndex) => {
                 const slottedColumns = this.columns
                     .map(({ key }, index) => isSlotUsed(this.el, `${key}-${rowIndex}`) && { key, index })
-                    .filter((col) => !!col);
+                    .filter((col) => !!col &&
+                    // skip the column if its already in the row
+                    !Object.prototype.hasOwnProperty.call(row, col.key));
                 return slottedColumns.length > 0
                     ? addDataToPosition(row, slottedColumns, "")
                     : row;
             });
             return organisedData
-                .sort(!this.sortable ? undefined : this.getSortFunction())
+                .sort(!this.sortable || this.disableAutoSort
+                ? undefined
+                : this.getSortFunction())
                 .map((row, index) => {
                 return (h("tr", {
                     // eslint-disable-next-line react/jsx-no-bind
                     onClick: () => this.onRowClick(row), class: {
                         ["table-row"]: true,
-                        ["table-row-selected"]: this.selectedRow === row,
+                        ["table-row-selected"]: this.highlightSelectedRow && this.selectedRow === row,
                     }
                 }, this.createCells(row, index)));
             });
         };
-        this.getObjectValue = (cell, key) => {
-            return Object.values(cell)[Object.keys(cell).indexOf(key)];
-        };
+        this.getObjectValue = (cell, key) => Object.values(cell)[Object.keys(cell).indexOf(key)];
         this.getSortButtonLabel = (key) => {
             let label = "";
             const getNextSortOption = (option) => {
@@ -431,7 +504,8 @@ export class DataTable {
             });
         };
         this.getTypographyElements = () => {
-            return Array.from(this.el.shadowRoot.querySelectorAll("ic-typography:not(.column-header-text)"));
+            // Filter out column headers and cell descriptions
+            return Array.from(this.el.shadowRoot.querySelectorAll("ic-typography:not(.column-header-text,.cell-description-text)"));
         };
         this.getTooltip = (typographyEl) => {
             return typographyEl.closest(this.TOOLTIP);
@@ -442,7 +516,7 @@ export class DataTable {
                 const cellContainer = this.getCellContainer(typographyEl);
                 if (typographyEl.closest(this.TEXT_WRAP_CLASS)) {
                     this.removeTooltip(cellContainer, typographyEl, tooltip);
-                    typographyEl.setAttribute("style", `--ic-line-clamp: 0`);
+                    typographyEl.setAttribute("style", `${this.LINE_CLAMP_CSS_VARIABLE}: 0`);
                     return;
                 }
                 this.regenerateTooltip(cellContainer, typographyEl, tooltip, removeTooltipOnly);
@@ -451,6 +525,56 @@ export class DataTable {
         this.updateScrollOffset = () => {
             this.scrollOffset = this.el.shadowRoot.querySelector(".table-row-container").scrollTop;
         };
+        this.updateRowHeightForDescriptions = (rowHeight, cellContainer) => {
+            cellContainer.setAttribute("data-row-height", rowHeight.toString());
+            cellContainer.setAttribute("style", `${this.ROW_HEIGHT_CSS_VARIABLE}: ${rowHeight}px`);
+        };
+        // Method to update the row heights on cells with descriptions and tooltip truncation
+        this.updateCellHeightsWithDescriptions = () => {
+            const descriptions = this.el.shadowRoot.querySelectorAll(this.CELL_DESCRIPTION_STRING);
+            descriptions.forEach((description) => {
+                const cellContainer = description.closest(`.${this.CELL_CONTAINER_WITH_DESCRIPTION_STRING}`);
+                const typography = cellContainer.querySelector(this.IC_TYPOGRAPHY_STRING);
+                const descriptionMarginTop = window
+                    .getComputedStyle(description)
+                    .getPropertyValue("margin-top");
+                const descriptionHeight = description.clientHeight + parseInt(descriptionMarginTop, 10);
+                if (this.globalRowHeight && this.globalRowHeight !== "auto") {
+                    if (!typography.textContent &&
+                        descriptionHeight + this.DEFAULT_LINE_HEIGHT > this.globalRowHeight) {
+                        this.updateRowHeightForDescriptions(descriptionHeight, cellContainer);
+                    }
+                    else if (this.truncationPattern === this.TOOLTIP_STRING) {
+                        if (descriptionHeight + this.DEFAULT_LINE_HEIGHT >
+                            this.globalRowHeight) {
+                            const cellIcon = cellContainer === null || cellContainer === void 0 ? void 0 : cellContainer.querySelector(".icon");
+                            if (deviceSizeMatches(IC_DEVICE_SIZES.XS) && cellIcon) {
+                                // recalculate descriptionHeight as when a word break occurs this value changes
+                                // Additional spacing given for 300-400% zoom
+                                this.updateRowHeightForDescriptions(descriptionHeight +
+                                    this.DEFAULT_LINE_HEIGHT +
+                                    cellIcon.clientHeight, cellContainer);
+                            }
+                            else {
+                                this.updateRowHeightForDescriptions(descriptionHeight + this.DEFAULT_LINE_HEIGHT, cellContainer);
+                            }
+                        }
+                        this.addLineClampCSS(typography, cellContainer);
+                        // Additional case for show/hide truncation for when a description is present, but the text
+                        // isn't overflowing the cell to trigger the show more button to appear.
+                    }
+                    else if (this.truncationPattern === this.SHOW_HIDE_STRING &&
+                        descriptionHeight + this.DEFAULT_LINE_HEIGHT > this.globalRowHeight &&
+                        typography.style.getPropertyValue("--truncation-max-lines") !==
+                            "initial") {
+                        this.updateRowHeightForDescriptions(descriptionHeight + this.DEFAULT_LINE_HEIGHT, cellContainer);
+                        if (descriptionHeight) {
+                            this.createShowHideTruncation(typography, cellContainer, descriptionHeight);
+                        }
+                    }
+                }
+            });
+        };
         this.setTableDimensions = () => {
             let tableHostDimensions = {};
             if (this.width) {
@@ -467,6 +591,94 @@ export class DataTable {
             }
             return tableHostDimensions;
         };
+        this.fixCellTooltip = (element) => {
+            var _a, _b, _c;
+            let tooltip;
+            if (element.tagName === "IC-TOOLTIP") {
+                tooltip = element;
+            }
+            else if ((_a = element.shadowRoot) === null || _a === void 0 ? void 0 : _a.querySelector(this.IC_TOOLTIP_STRING)) {
+                tooltip = (_b = element.shadowRoot) === null || _b === void 0 ? void 0 : _b.querySelector(this.IC_TOOLTIP_STRING);
+            }
+            else {
+                if (((_c = element.children) === null || _c === void 0 ? void 0 : _c.length) > 0) {
+                    Array.from(element.children).forEach((el) => {
+                        this.fixCellTooltip(el);
+                    });
+                }
+                else {
+                    return;
+                }
+            }
+            if (tooltip) {
+                tooltip.setExternalPopperProps({
+                    strategy: "fixed",
+                });
+            }
+        };
+        this.fixCellTooltips = () => {
+            const elements = this.el.shadowRoot.querySelectorAll(".data-type-element");
+            elements.forEach((element) => {
+                const slotElements = getSlotElements(element);
+                slotElements === null || slotElements === void 0 ? void 0 : slotElements.forEach((slottedEl) => {
+                    this.fixCellTooltip(slottedEl);
+                });
+            });
+            const actionElements = this.el.shadowRoot.querySelectorAll(".action-element");
+            actionElements === null || actionElements === void 0 ? void 0 : actionElements.forEach((actionElementSpan) => {
+                const actionElement = actionElementSpan.firstChild;
+                if (actionElement) {
+                    this.fixCellTooltip(actionElement);
+                }
+            });
+        };
+        this.handleClick = (event, callback) => callback(event);
+        this.renderTableBody = (data, loading, overlay) => {
+            if (!(data === null || data === void 0 ? void 0 : data.length))
+                return;
+            if (overlay && loading) {
+                return h("tbody", null, this.createRows());
+            }
+            else if (loading && !overlay) {
+                return null;
+            }
+            else {
+                return h("tbody", null, this.createRows());
+            }
+        };
+        this.renderLoadingIndicator = (isLoading, loadingOptions) => {
+            if (!isLoading)
+                return null;
+            return (h(Fragment, null, h("div", { class: "loading-overlay", ref: (el) => (this.loadingOverlay = el) }), h("ic-loading-indicator", { theme: this.theme, monochrome: loadingOptions === null || loadingOptions === void 0 ? void 0 : loadingOptions.monochrome, class: {
+                    "loading-empty": isLoading,
+                    loading: true,
+                    "show-background": loadingOptions.showBackground || loadingOptions.overlay,
+                }, description: loadingOptions.description || "Loading table data", label: loadingOptions.label || "Loading...", labelDuration: loadingOptions === null || loadingOptions === void 0 ? void 0 : loadingOptions.labelDuration, max: loadingOptions === null || loadingOptions === void 0 ? void 0 : loadingOptions.max, min: loadingOptions === null || loadingOptions === void 0 ? void 0 : loadingOptions.min, progress: loadingOptions === null || loadingOptions === void 0 ? void 0 : loadingOptions.progress, ref: (el) => (this.loadingIndicator = el) })));
+        };
+        this.renderAriaLiveLoading = () => {
+            var _a, _b;
+            if (this.loading) {
+                return ((_a = this.loadingOptions) === null || _a === void 0 ? void 0 : _a.label) || "Loading...";
+            }
+            else if (this.updating) {
+                return ((_b = this.updatingOptions) === null || _b === void 0 ? void 0 : _b.description) || "Updating table data";
+            }
+            else {
+                return "";
+            }
+        };
+        this.renderEmptyState = (data, loading, overlay) => {
+            const emptyStateEl = isSlotUsed(this.el, "empty-state") ? (h("slot", { name: "empty-state" })) : (h("ic-empty-state", { aligned: "center", heading: "No Data", class: "loading-empty" }));
+            if (loading && !(data === null || data === void 0 ? void 0 : data.length) && overlay) {
+                return emptyStateEl;
+            }
+            else if (!loading && !(data === null || data === void 0 ? void 0 : data.length)) {
+                return emptyStateEl;
+            }
+            else {
+                return null;
+            }
+        };
         this.fromRow = 0;
         this.previousRowsPerPage = undefined;
         this.rowsPerPage = undefined;
@@ -479,12 +691,15 @@ export class DataTable {
         this.currentRowHeight = undefined;
         this.debounceDelay = 0;
         this.caption = undefined;
+        this.columnHeaderTruncation = false;
         this.columns = undefined;
         this.data = undefined;
+        this.disableAutoSort = false;
         this.density = "default";
         this.embedded = false;
         this.globalRowHeight = "auto";
         this.height = undefined;
+        this.highlightSelectedRow = true;
         this.hideColumnHeaders = false;
         this.loading = false;
         this.loadingOptions = undefined;
@@ -492,20 +707,23 @@ export class DataTable {
         this.minWidth = undefined;
         this.minimumLoadingDisplayDuration = 1000;
         this.paginationBarOptions = {
+            alignment: "right",
+            hideAllFromItemsPerPage: false,
+            hideRangeLabel: false,
+            itemLabel: "Item",
             itemsPerPageOptions: [
                 { label: "10", value: "10" },
                 { label: "25", value: "25" },
                 { label: "50", value: "50" },
             ],
+            monochrome: false,
+            pageLabel: "Page",
             rangeLabelType: "page",
-            type: "simple",
-            showItemsPerPageControl: true,
+            selectedItemsPerPage: 10,
+            setToFirstPageOnPaginationChange: false,
             showGoToPageControl: true,
-            alignment: "right",
-            appearance: "default",
-            itemLabel: "Item",
-            pageLabel: "Page",
-            hideRangeLabel: false,
+            showItemsPerPageControl: true,
+            type: "simple",
         };
         this.showPagination = false;
         this.sortable = false;
@@ -516,30 +734,47 @@ export class DataTable {
         this.stickyColumnHeaders = false;
         this.stickyRowHeaders = false;
         this.tableLayout = "fixed";
+        this.theme = "inherit";
         this.truncationPattern = undefined;
         this.updating = false;
         this.updatingOptions = undefined;
         this.variableRowHeight = undefined;
         this.width = undefined;
     }
+    headerTruncationChangeHandler() {
+        if (this.columnHeaderTruncation) {
+            this.prevTableContainerWidth = 0;
+        }
+        else {
+            const headers = this.el.shadowRoot.querySelectorAll("th.column-header");
+            headers.forEach((header) => {
+                const tooltip = header.querySelector(this.IC_TOOLTIP_STRING);
+                if (tooltip) {
+                    tooltip.classList.remove(this.SHOW_TRUNC_TOOLTIP_STRING);
+                }
+            });
+        }
+    }
     disconnectedCallback() {
-        var _a;
+        var _a, _b;
         (_a = this.resizeObserver) === null || _a === void 0 ? void 0 : _a.disconnect();
+        (_b = this.headerResizeObserver) === null || _b === void 0 ? void 0 : _b.disconnect();
     }
     componentWillLoad() {
-        var _a;
+        var _a, _b;
         this.rowsPerPage = Number(this.paginationBarOptions.itemsPerPageOptions[0].value);
         this.previousRowsPerPage = this.rowsPerPage;
         this.toRow = this.rowsPerPage;
         this.sortedColumn = this.sortOptions.defaultColumn;
         this.sortedColumnOrder = this.sortOptions.sortOrders[0];
-        this.loadingOptions = Object.assign(Object.assign({}, this.loadingOptions), { showBackground: ((_a = this.data) === null || _a === void 0 ? void 0 : _a.length) > 0 });
+        this.loadingOptions = Object.assign(Object.assign({}, this.loadingOptions), { showBackground: ((_a = this.data) === null || _a === void 0 ? void 0 : _a.length) > 0 || !!((_b = this.loadingOptions) === null || _b === void 0 ? void 0 : _b.overlay) });
         this.initialLoad = true;
         this.previousItemsPerPage = this.rowsPerPage;
     }
     componentDidLoad() {
         const tableElement = this.el.shadowRoot.querySelector("table");
         const tableContainer = this.el.shadowRoot.querySelector(".table-container");
+        checkResizeObserver(this.runHeaderResizeObserver);
         if (this.dataUpdated) {
             this.dataUpdated = false;
         }
@@ -563,6 +798,7 @@ export class DataTable {
         if (this.globalRowHeight !== "auto") {
             this.updateSetRowHeight();
         }
+        window.addEventListener("resize", this.updateCellHeightsWithDescriptions);
     }
     componentDidUpdate() {
         // truncation updates invoked here once new/updated data has
@@ -572,6 +808,11 @@ export class DataTable {
             this.truncateUpdatedData();
         }
     }
+    componentDidRender() {
+        this.fixCellTooltips();
+        this.updateCellHeightsWithDescriptions();
+        this.adjustWidthForActionElement();
+    }
     truncateUpdatedData() {
         if (this.dataUpdated) {
             if (this.truncationPattern === this.SHOW_HIDE_STRING) {
@@ -628,7 +869,7 @@ export class DataTable {
                     cellContainer.style.height = null;
                     if (this.truncationPattern === this.TOOLTIP_STRING) {
                         this.removeTooltip(cellContainer, typographyEl, tooltipEl);
-                        typographyEl.setAttribute("style", `--ic-line-clamp: 0`);
+                        typographyEl.setAttribute("style", `${this.LINE_CLAMP_CSS_VARIABLE}: 0`);
                     }
                     else if (this.truncationPattern === this.SHOW_HIDE_STRING) {
                         this.resetShowHideTruncation(typographyEl);
@@ -639,7 +880,8 @@ export class DataTable {
                     parseFloat(cellContainer.getAttribute(this.DATA_ROW_HEIGHT_STRING));
                 // If the set row height is bigger than the cell container even
                 // with textWrap, set the row height
-                if (!((_a = cellContainer === null || cellContainer === void 0 ? void 0 : cellContainer.style) === null || _a === void 0 ? void 0 : _a.height) &&
+                if (!cellContainer.classList.contains(this.CELL_CONTAINER_WITH_DESCRIPTION_STRING) &&
+                    !((_a = cellContainer === null || cellContainer === void 0 ? void 0 : cellContainer.style) === null || _a === void 0 ? void 0 : _a.height) &&
                     rowHeight > cellContainer.clientHeight &&
                     !cellContainer.classList.contains(this.TEXT_WRAP_STRING)) {
                     cellContainer.style.setProperty(this.ROW_HEIGHT_CSS_VARIABLE, cellContainer.getAttribute(this.DATA_ROW_HEIGHT_STRING));
@@ -672,7 +914,7 @@ export class DataTable {
                 const newRows = Array.from(allRows).slice(this.previousItemsPerPage);
                 newRows.forEach((row) => {
                     row
-                        .querySelectorAll("ic-typography")
+                        .querySelectorAll(this.IC_TYPOGRAPHY_STRING)
                         .forEach((typographyEl) => {
                         const cellContainer = this.getCellContainer(typographyEl);
                         const tooltipEl = this.getTooltip(typographyEl);
@@ -734,9 +976,17 @@ export class DataTable {
             }
         }
     }
-    createShowHideTruncation(typographyEl, cellContainer) {
+    createShowHideTruncation(typographyEl, cellContainer, descriptionHeight) {
         typographyEl.checkMaxLines(typographyEl.scrollHeight);
         typographyEl.setAttribute("max-lines", `${Math.floor((cellContainer === null || cellContainer === void 0 ? void 0 : cellContainer.clientHeight) / this.DEFAULT_LINE_HEIGHT)}`);
+        if (cellContainer.classList.contains(this.CELL_CONTAINER_WITH_DESCRIPTION_STRING) &&
+            descriptionHeight) {
+            typographyEl.setAttribute("max-lines", `${Math.floor(((cellContainer === null || cellContainer === void 0 ? void 0 : cellContainer.clientHeight) - descriptionHeight) /
+                this.DEFAULT_LINE_HEIGHT)}`);
+        }
+        else {
+            typographyEl.setAttribute("max-lines", `${Math.floor((cellContainer === null || cellContainer === void 0 ? void 0 : cellContainer.clientHeight) / this.DEFAULT_LINE_HEIGHT)}`);
+        }
         typographyEl.setShowHideExpanded(false);
         cellContainer.style.setProperty(this.ROW_HEIGHT_CSS_VARIABLE, null);
     }
@@ -750,9 +1000,6 @@ export class DataTable {
         cellContainer.classList.add(this.SHOW_HIDE_CSS_CLASS);
         this.createShowHideTruncation(typographyEl, cellContainer);
     }
-    getTruncWrapper(typographyEl) {
-        return typographyEl.shadowRoot.querySelector(".trunc-wrapper");
-    }
     // Set the height to initial if row height is set and the show / hide truncation
     // is clicked
     handleTypographyTruncationExpandToggle({ detail, }) {
@@ -843,7 +1090,8 @@ export class DataTable {
         this.truncationPatternUpdated = true;
     }
     async dataHandler(newData) {
-        this.loadingOptions = Object.assign(Object.assign({}, this.loadingOptions), { showBackground: (newData === null || newData === void 0 ? void 0 : newData.length) > 0 });
+        var _a;
+        this.loadingOptions = Object.assign(Object.assign({}, this.loadingOptions), { showBackground: (newData === null || newData === void 0 ? void 0 : newData.length) > 0 || !!((_a = this.loadingOptions) === null || _a === void 0 ? void 0 : _a.overlay) });
         if (this.loading) {
             !this.hasLoadedForOneSecond
                 ? setTimeout(() => (this.loading = false), this.minimumLoadingDisplayDuration -
@@ -870,7 +1118,7 @@ export class DataTable {
                 typographyEl.setShowHideExpanded(false);
                 cellContainer.style.setProperty(this.ROW_HEIGHT_CSS_VARIABLE, null);
             }
-            else {
+            else if (!cellContainer.classList.contains(this.CELL_CONTAINER_WITH_DESCRIPTION_STRING)) {
                 typographyEl.resetTruncation().then(() => {
                     if (!typographyEl.closest(this.TEXT_WRAP_CLASS)) {
                         cellContainer.style.setProperty(this.ROW_HEIGHT_CSS_VARIABLE, cellContainer.getAttribute(this.DATA_ROW_HEIGHT_STRING));
@@ -906,7 +1154,11 @@ export class DataTable {
         this.variableRowHeight = null;
     }
     showLoadingIndicator() {
-        this.loadingIndicator.classList.add("show");
+        var _a, _b, _c;
+        if ((_a = this.loadingOptions) === null || _a === void 0 ? void 0 : _a.overlay) {
+            (_b = this.loadingOverlay) === null || _b === void 0 ? void 0 : _b.classList.add("show");
+        }
+        (_c = this.loadingIndicator) === null || _c === void 0 ? void 0 : _c.classList.add("show");
     }
     getRowOptions(rowKeys, rowValues) {
         const rowOptionsIndex = rowKeys.indexOf("rowOptions");
@@ -935,23 +1187,44 @@ export class DataTable {
         if ((typographyEl === null || typographyEl === void 0 ? void 0 : typographyEl.scrollHeight) > (cellContainer === null || cellContainer === void 0 ? void 0 : cellContainer.clientHeight) &&
             this.truncationPattern === this.TOOLTIP_STRING) {
             if (!typographyEl.getAttribute("style") ||
-                typographyEl.style.cssText.includes("--ic-line-clamp: 0;")) {
+                typographyEl.style.cssText.includes(`${this.LINE_CLAMP_CSS_VARIABLE}: 0;`)) {
                 this.addLineClampCSS(typographyEl, cellContainer);
             }
-            this.createTruncationTooltip(typographyEl, cellContainer);
+            if (!cellContainer.querySelector(this.IC_TOOLTIP_STRING))
+                this.createTruncationTooltip(typographyEl, cellContainer);
         }
     }
     removeTooltip(cellContainer, typographyEl, tooltip) {
-        cellContainer.appendChild(typographyEl);
+        const cellTextWrapper = cellContainer.querySelector(this.CELL_TEXT_WRAPPER_STRING);
+        cellTextWrapper.prepend(typographyEl);
         if (tooltip) {
             tooltip.remove();
         }
     }
     addLineClampCSS(typographyEl, cellContainer) {
-        typographyEl.setAttribute("style", `--ic-line-clamp: ${this.getLines(cellContainer === null || cellContainer === void 0 ? void 0 : cellContainer.clientHeight)}`);
+        var _a, _b;
+        const descriptionCellHeight = (_a = cellContainer.querySelector(this.CELL_DESCRIPTION_STRING)) === null || _a === void 0 ? void 0 : _a.clientHeight;
+        if (cellContainer.classList.contains(this.CELL_CONTAINER_WITH_DESCRIPTION_STRING) &&
+            (cellContainer === null || cellContainer === void 0 ? void 0 : cellContainer.clientHeight) > descriptionCellHeight) {
+            let iconHeight;
+            if (deviceSizeMatches(IC_DEVICE_SIZES.XS)) {
+                const cellIcon = cellContainer === null || cellContainer === void 0 ? void 0 : cellContainer.querySelector(".icon");
+                iconHeight = cellIcon ? cellIcon.clientHeight : 0;
+            }
+            else {
+                iconHeight = 0;
+            }
+            const height = (cellContainer === null || cellContainer === void 0 ? void 0 : cellContainer.clientHeight) -
+                ((_b = cellContainer.querySelector(this.CELL_DESCRIPTION_STRING)) === null || _b === void 0 ? void 0 : _b.clientHeight) -
+                iconHeight;
+            typographyEl.setAttribute("style", `${this.LINE_CLAMP_CSS_VARIABLE}: ${this.getLines(height || 0)}`);
+        }
+        else {
+            typographyEl.setAttribute("style", `${this.LINE_CLAMP_CSS_VARIABLE}: ${this.getLines(cellContainer === null || cellContainer === void 0 ? void 0 : cellContainer.clientHeight)}`);
+        }
     }
     createTruncationTooltip(typographyEl, cellContainer) {
-        const tooltipEl = document.createElement("ic-tooltip");
+        const tooltipEl = document.createElement(this.IC_TOOLTIP_STRING);
         tooltipEl.setAttribute("target", typographyEl.id);
         tooltipEl.setAttribute("label", typographyEl.textContent);
         tooltipEl.classList.add("ic-tooltip-overflow");
@@ -959,28 +1232,24 @@ export class DataTable {
             // This might need reverting back to absolute if the tooltip doesn't dynamically position itself correctly
             strategy: "fixed",
         });
-        cellContainer.appendChild(tooltipEl);
-        tooltipEl.appendChild(typographyEl);
+        const cellTextWrapper = cellContainer.querySelector(this.CELL_TEXT_WRAPPER_STRING);
+        cellTextWrapper.prepend(tooltipEl);
+        tooltipEl.prepend(typographyEl);
     }
     render() {
-        const { caption, createColumnHeaders, createRows, createUpdatingIndicator, data, hideColumnHeaders, loading, loadingOptions, paginationBarOptions, scrollable, scrollOffset, showPagination, sortable, sortedColumnOrder, sortedColumn, stickyColumnHeaders, updateScrollOffset, updating, } = this;
-        return (h(Host, { style: Object.assign({}, this.setTableDimensions()) }, h("div", { class: "table-container" }, isSlotUsed(this.el, "title-bar") && h("slot", { name: "title-bar" }), h("div", { class: {
+        var _a;
+        const { caption, createColumnHeaders, createUpdatingIndicator, data, hideColumnHeaders, loading, loadingOptions, paginationBarOptions, scrollable, scrollOffset, showPagination, sortable, sortedColumn, sortedColumnOrder, stickyColumnHeaders, updateScrollOffset, updating, theme, } = this;
+        return (h(Host, { style: Object.assign({}, this.setTableDimensions()), class: { [`ic-theme-${theme}`]: theme !== "inherit" } }, h("div", { class: "table-container" }, isSlotUsed(this.el, "title-bar") && h("slot", { name: "title-bar" }), h("div", { class: {
                 ["table-row-container"]: true,
                 scrollable,
-            }, tabIndex: scrollable ? 0 : null, onScroll: updateScrollOffset }, isSlotUsed(this.el, "title-bar") && h("slot", { name: "title-bar" }), h("table", { style: {
+            }, tabIndex: scrollable ? 0 : null, onScroll: updateScrollOffset }, h("table", { style: {
                 ["--table-layout"]: this.tableLayout,
             } }, h("caption", { class: "table-caption" }, caption), !hideColumnHeaders && (h("thead", { class: {
                 ["column-header-sticky"]: stickyColumnHeaders,
                 ["column-header-overlay"]: stickyColumnHeaders && scrollOffset !== 0,
             } }, h("tr", null, createColumnHeaders()))), updating &&
             !loading &&
-            (hideColumnHeaders ? (h("thead", null, createUpdatingIndicator())) : (createUpdatingIndicator())), (data === null || data === void 0 ? void 0 : data.length) > 0 && !loading && h("tbody", null, createRows())), !(data === null || data === void 0 ? void 0 : data.length) &&
-            !loading &&
-            (isSlotUsed(this.el, "empty-state") ? (h("slot", { name: "empty-state" })) : (h("ic-empty-state", { aligned: "center", heading: "No Data", class: "loading-empty" })))), loading && (h("ic-loading-indicator", { appearance: loadingOptions === null || loadingOptions === void 0 ? void 0 : loadingOptions.appearance, class: {
-                "loading-empty": loading,
-                loading: true,
-                "show-background": loadingOptions.showBackground,
-            }, description: loadingOptions.description || "Loading table data", label: loadingOptions.label || "Loading...", labelDuration: loadingOptions === null || loadingOptions === void 0 ? void 0 : loadingOptions.labelDuration, max: loadingOptions === null || loadingOptions === void 0 ? void 0 : loadingOptions.max, min: loadingOptions === null || loadingOptions === void 0 ? void 0 : loadingOptions.min, progress: loadingOptions === null || loadingOptions === void 0 ? void 0 : loadingOptions.progress, ref: (el) => (this.loadingIndicator = el) })), (showPagination || isSlotUsed(this.el, "pagination-bar")) && (h("div", { class: "pagination-container" }, isSlotUsed(this.el, "pagination-bar") ? (h("slot", { name: "pagination-bar" })) : (h("ic-pagination-bar", { totalItems: data.length, type: paginationBarOptions.type, rangeLabelType: paginationBarOptions.rangeLabelType, showItemsPerPageControl: paginationBarOptions.showItemsPerPageControl, showGoToPageControl: paginationBarOptions.showGoToPageControl, itemsPerPageOptions: paginationBarOptions.itemsPerPageOptions, alignment: paginationBarOptions.alignment, appearance: paginationBarOptions.appearance, itemLabel: paginationBarOptions.itemLabel, pageLabel: paginationBarOptions.pageLabel, hideRangeLabel: paginationBarOptions.hideRangeLabel })))), sortable && (h("div", { class: "screen-reader-sort-text", "aria-live": "polite" }, sortedColumnOrder !== "unsorted" && sortedColumn
+            (hideColumnHeaders ? (h("thead", null, createUpdatingIndicator())) : (createUpdatingIndicator())), this.renderTableBody(data, loading, loadingOptions.overlay)), this.renderEmptyState(data, loading, loadingOptions.overlay)), h("div", { "aria-live": "assertive", class: "sr-only" }, this.renderAriaLiveLoading()), this.renderLoadingIndicator(loading, loadingOptions), (showPagination || isSlotUsed(this.el, "pagination-bar")) && (h("div", { class: "pagination-container" }, isSlotUsed(this.el, "pagination-bar") ? (h("slot", { name: "pagination-bar" })) : (h("ic-pagination-bar", { alignment: paginationBarOptions.alignment, hideAllFromItemsPerPage: paginationBarOptions.hideAllFromItemsPerPage, hideRangeLabel: paginationBarOptions.hideRangeLabel, itemLabel: paginationBarOptions.itemLabel, itemsPerPageOptions: paginationBarOptions.itemsPerPageOptions, monochrome: paginationBarOptions.monochrome, pageLabel: paginationBarOptions.pageLabel, rangeLabelType: paginationBarOptions.rangeLabelType, selectedItemsPerPage: paginationBarOptions.selectedItemsPerPage, setToFirstPageOnPaginationChange: paginationBarOptions.setToFirstPageOnPaginationChange, showGoToPageControl: paginationBarOptions.showGoToPageControl, showItemsPerPageControl: paginationBarOptions.showItemsPerPageControl, theme: theme, totalItems: (_a = data === null || data === void 0 ? void 0 : data.length) !== null && _a !== void 0 ? _a : 0, type: paginationBarOptions.type })))), sortable && (h("div", { class: "screen-reader-sort-text", "aria-live": "polite" }, sortedColumnOrder !== "unsorted" && sortedColumn
             ? `${sortedColumn} sorted ${sortedColumnOrder}`
             : "table unsorted")))));
     }
@@ -1015,6 +1284,24 @@ export class DataTable {
                 "attribute": "caption",
                 "reflect": false
             },
+            "columnHeaderTruncation": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Determines whether the column header should be truncated and display a tooltip. Default is `false`."
+                },
+                "attribute": "column-header-truncation",
+                "reflect": false,
+                "defaultValue": "false"
+            },
             "columns": {
                 "type": "unknown",
                 "mutable": false,
@@ -1051,12 +1338,30 @@ export class DataTable {
                     }
                 },
                 "required": false,
-                "optional": false,
+                "optional": true,
                 "docs": {
                     "tags": [],
                     "text": "The row content for the table."
                 }
             },
+            "disableAutoSort": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "If `true`, the built in sort functionality will be disabled. For example, if rows will already be sorted from an external source."
+                },
+                "attribute": "disable-auto-sort",
+                "reflect": false,
+                "defaultValue": "false"
+            },
             "density": {
                 "type": "string",
                 "mutable": true,
@@ -1140,6 +1445,24 @@ export class DataTable {
                 "attribute": "height",
                 "reflect": false
             },
+            "highlightSelectedRow": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "If `true`, the selected row is highlighted using a background colour."
+                },
+                "attribute": "highlight-selected-row",
+                "reflect": false,
+                "defaultValue": "true"
+            },
             "hideColumnHeaders": {
                 "type": "boolean",
                 "mutable": false,
@@ -1180,15 +1503,9 @@ export class DataTable {
                 "type": "unknown",
                 "mutable": false,
                 "complexType": {
-                    "original": "{\n    appearance?: IcThemeForegroundNoDefault;\n    description?: string;\n    label?: string;\n    labelDuration?: number;\n    max?: number;\n    min?: number;\n    progress?: number;\n    showBackground?: boolean;\n  }",
-                    "resolved": "{ appearance?: IcThemeForegroundNoDefault; description?: string; label?: string; labelDuration?: number; max?: number; min?: number; progress?: number; showBackground?: boolean; }",
-                    "references": {
-                        "IcThemeForegroundNoDefault": {
-                            "location": "import",
-                            "path": "@ukic/web-components/dist/types/utils/types",
-                            "id": "../web-components/dist/types/utils/types.d.ts::IcThemeForegroundNoDefault"
-                        }
-                    }
+                    "original": "{\n    description?: string;\n    label?: string;\n    labelDuration?: number;\n    max?: number;\n    min?: number;\n    progress?: number;\n    showBackground?: boolean;\n    monochrome?: boolean;\n    overlay?: boolean;\n  }",
+                    "resolved": "{ description?: string; label?: string; labelDuration?: number; max?: number; min?: number; progress?: number; showBackground?: boolean; monochrome?: boolean; overlay?: boolean; }",
+                    "references": {}
                 },
                 "required": false,
                 "optional": true,
@@ -1269,7 +1586,7 @@ export class DataTable {
                     "tags": [],
                     "text": "Sets the props for the built-in pagination bar. If the `pagination-bar` slot is used then this prop is ignored."
                 },
-                "defaultValue": "{\n    itemsPerPageOptions: [\n      { label: \"10\", value: \"10\" },\n      { label: \"25\", value: \"25\" },\n      { label: \"50\", value: \"50\" },\n    ],\n    rangeLabelType: \"page\",\n    type: \"simple\",\n    showItemsPerPageControl: true,\n    showGoToPageControl: true,\n    alignment: \"right\",\n    appearance: \"default\",\n    itemLabel: \"Item\",\n    pageLabel: \"Page\",\n    hideRangeLabel: false,\n  }"
+                "defaultValue": "{\n    alignment: \"right\",\n    hideAllFromItemsPerPage: false,\n    hideRangeLabel: false,\n    itemLabel: \"Item\",\n    itemsPerPageOptions: [\n      { label: \"10\", value: \"10\" },\n      { label: \"25\", value: \"25\" },\n      { label: \"50\", value: \"50\" },\n    ],\n    monochrome: false,\n    pageLabel: \"Page\",\n    rangeLabelType: \"page\",\n    selectedItemsPerPage: 10,\n    setToFirstPageOnPaginationChange: false,\n    showGoToPageControl: true,\n    showItemsPerPageControl: true,\n    type: \"simple\",\n  }"
             },
             "showPagination": {
                 "type": "boolean",
@@ -1383,6 +1700,30 @@ export class DataTable {
                 "reflect": false,
                 "defaultValue": "\"fixed\""
             },
+            "theme": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "IcThemeMode",
+                    "resolved": "\"dark\" | \"inherit\" | \"light\"",
+                    "references": {
+                        "IcThemeMode": {
+                            "location": "import",
+                            "path": "../../utils/types",
+                            "id": "src/utils/types.ts::IcThemeMode"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Sets the theme color to the dark or light theme color. \"inherit\" will set the color based on the system settings or ic-theme component."
+                },
+                "attribute": "theme",
+                "reflect": false,
+                "defaultValue": "\"inherit\""
+            },
             "truncationPattern": {
                 "type": "string",
                 "mutable": false,
@@ -1428,15 +1769,9 @@ export class DataTable {
                 "type": "unknown",
                 "mutable": false,
                 "complexType": {
-                    "original": "{\n    appearance?: IcThemeForegroundNoDefault;\n    description?: string;\n    max?: number;\n    min?: number;\n    progress?: number;\n  }",
-                    "resolved": "{ appearance?: IcThemeForegroundNoDefault; description?: string; max?: number; min?: number; progress?: number; }",
-                    "references": {
-                        "IcThemeForegroundNoDefault": {
-                            "location": "import",
-                            "path": "@ukic/web-components/dist/types/utils/types",
-                            "id": "../web-components/dist/types/utils/types.d.ts::IcThemeForegroundNoDefault"
-                        }
-                    }
+                    "original": "{\n    description?: string;\n    max?: number;\n    min?: number;\n    progress?: number;\n    monochrome?: boolean;\n  }",
+                    "resolved": "{ description?: string; max?: number; min?: number; progress?: number; monochrome?: boolean; }",
+                    "references": {}
                 },
                 "required": false,
                 "optional": true,
@@ -1516,6 +1851,21 @@ export class DataTable {
                     "resolved": "void",
                     "references": {}
                 }
+            }, {
+                "method": "icSelectedRowChange",
+                "name": "icSelectedRowChange",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Emitted when the selected row changes in the data table."
+                },
+                "complexType": {
+                    "original": "object",
+                    "resolved": "object",
+                    "references": {}
+                }
             }, {
                 "method": "icSortChange",
                 "name": "icSortChange",
@@ -1567,6 +1917,9 @@ export class DataTable {
     static get elementRef() { return "el"; }
     static get watchers() {
         return [{
+                "propName": "columnHeaderTruncation",
+                "methodName": "headerTruncationChangeHandler"
+            }, {
                 "propName": "loading",
                 "methodName": "loadingHandler"
             }, {