@ukic/canary-web-components 2.0.0-canary.31 → 2.0.0-canary.33

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, getSlotElements, checkResizeObserver, } 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,6 +45,7 @@ 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;
@@ -51,6 +53,10 @@ export class DataTable {
         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();
@@ -64,7 +70,7 @@ export class DataTable {
                     const headers = this.el.shadowRoot.querySelectorAll("th.column-header");
                     headers.forEach((header) => {
                         const tooltip = header.querySelector(this.IC_TOOLTIP_STRING);
-                        const typographyEls = header.querySelectorAll("ic-typography");
+                        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) {
@@ -132,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 &&
@@ -209,7 +216,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) {
@@ -285,11 +292,11 @@ export class DataTable {
             });
         };
         this.createCellContent = (columnProps, cell, cellSlotName, rowOptions, rowAlignment, hasIcon, currentRowHeight, cellValue, rowEmphasis) => {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+            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({ "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) ||
+                    : 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) ||
@@ -301,18 +308,25 @@ export class DataTable {
                         !!((_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.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()), { [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("ic-typography", { variant: "body", class: {
+                !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") }, cellValue("data"))) : (cellValue("data"))) : (this.getCellContent(cell, columnProps === null || columnProps === void 0 ? void 0 : columnProps.dataType))))))));
+                } }, this.isObject(cell) && (columnProps === null || columnProps === void 0 ? void 0 : columnProps.dataType) !== "date" ? (Object.keys(cell).includes("href") ? (h("ic-link", { href: cellValue("href"), 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;
@@ -347,41 +361,47 @@ export class DataTable {
                             ["table-cell"]: true,
                             [`table-density-${this.density}`]: this.notDefaultDensity(),
                             ["with-overflow"]: (columnProps === null || columnProps === void 0 ? void 0 : columnProps.dataType) === "element",
-                        }, style: Object.assign({}, this.getColumnWidth(columnProps.columnWidth)) }, 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") }))) : (this.createCellContent(columnProps, cell, cellSlotName, rowOptions, rowAlignment, hasIcon, currentRowHeight, cellValue, rowEmphasis))));
+                        }, 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
+                            ? () => this.handleClick(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 }, 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.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;
         };
@@ -412,7 +432,7 @@ export class DataTable {
                     // 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)));
             });
@@ -482,7 +502,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);
@@ -493,7 +514,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);
@@ -502,6 +523,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) {
@@ -518,22 +589,79 @@ export class DataTable {
             }
             return tableHostDimensions;
         };
+        this.fixCellTooltip = (element) => {
+            var _a;
+            const tooltipEl = (element.tagName === "IC-TOOLTIP"
+                ? element
+                : (_a = element.shadowRoot) === null || _a === void 0 ? void 0 : _a.querySelector(this.IC_TOOLTIP_STRING));
+            if (tooltipEl) {
+                tooltipEl.setExternalPopperProps({
+                    strategy: "fixed",
+                });
+            }
+        };
         this.fixCellTooltips = () => {
             const elements = this.el.shadowRoot.querySelectorAll(".data-type-element");
             elements.forEach((element) => {
                 const slotElements = getSlotElements(element);
-                slotElements.forEach((slottedEl) => {
-                    var _a;
-                    const tooltipEl = (slottedEl.tagName === "IC-TOOLTIP"
-                        ? slottedEl
-                        : (_a = slottedEl.shadowRoot) === null || _a === void 0 ? void 0 : _a.querySelector(this.IC_TOOLTIP_STRING));
-                    if (tooltipEl) {
-                        tooltipEl.setExternalPopperProps({
-                            strategy: "fixed",
-                        });
-                    }
+                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 = (callback) => callback();
+        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", { appearance: loadingOptions === null || loadingOptions === void 0 ? void 0 : loadingOptions.appearance, 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;
@@ -554,6 +682,7 @@ export class DataTable {
         this.embedded = false;
         this.globalRowHeight = "auto";
         this.height = undefined;
+        this.highlightSelectedRow = true;
         this.hideColumnHeaders = false;
         this.loading = false;
         this.loadingOptions = undefined;
@@ -576,6 +705,7 @@ export class DataTable {
             pageLabel: "Page",
             hideRangeLabel: false,
             hideAllFromItemsPerPage: false,
+            setToFirstPageOnPaginationChange: false,
         };
         this.showPagination = false;
         this.sortable = false;
@@ -612,13 +742,13 @@ export class DataTable {
         (_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;
     }
@@ -649,6 +779,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
@@ -660,6 +791,7 @@ export class DataTable {
     }
     componentDidRender() {
         this.fixCellTooltips();
+        this.updateCellHeightsWithDescriptions();
         this.adjustWidthForActionElement();
     }
     truncateUpdatedData() {
@@ -718,7 +850,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);
@@ -729,7 +861,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));
@@ -762,7 +895,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);
@@ -824,9 +957,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);
     }
@@ -933,7 +1074,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 -
@@ -960,7 +1102,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));
@@ -996,8 +1138,11 @@ export class DataTable {
         this.variableRowHeight = null;
     }
     showLoadingIndicator() {
-        var _a;
-        (_a = this.loadingIndicator) === null || _a === void 0 ? void 0 : _a.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");
@@ -1026,20 +1171,40 @@ 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);
         }
     }
     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(this.IC_TOOLTIP_STRING);
@@ -1050,12 +1215,13 @@ 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() {
         var _a;
-        const { caption, createColumnHeaders, createRows, createUpdatingIndicator, data, hideColumnHeaders, loading, loadingOptions, paginationBarOptions, scrollable, scrollOffset, showPagination, sortable, sortedColumnOrder, sortedColumn, stickyColumnHeaders, updateScrollOffset, updating, } = this;
+        const { caption, createColumnHeaders, 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: {
                 ["table-row-container"]: true,
                 scrollable,
@@ -1066,13 +1232,7 @@ export class DataTable {
                 ["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: (_a = data === null || data === void 0 ? void 0 : data.length) !== null && _a !== void 0 ? _a : 0, 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, hideAllFromItemsPerPage: paginationBarOptions.hideAllFromItemsPerPage })))), 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", { totalItems: (_a = data === null || data === void 0 ? void 0 : data.length) !== null && _a !== void 0 ? _a : 0, 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, hideAllFromItemsPerPage: paginationBarOptions.hideAllFromItemsPerPage, setToFirstPageOnPaginationChange: paginationBarOptions.setToFirstPageOnPaginationChange })))), sortable && (h("div", { class: "screen-reader-sort-text", "aria-live": "polite" }, sortedColumnOrder !== "unsorted" && sortedColumn
             ? `${sortedColumn} sorted ${sortedColumnOrder}`
             : "table unsorted")))));
     }
@@ -1250,6 +1410,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,
@@ -1290,8 +1468,8 @@ 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; }",
+                    "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    overlay?: boolean;\n  }",
+                    "resolved": "{ appearance?: IcThemeForegroundNoDefault; description?: string; label?: string; labelDuration?: number; max?: number; min?: number; progress?: number; showBackground?: boolean; overlay?: boolean; }",
                     "references": {
                         "IcThemeForegroundNoDefault": {
                             "location": "import",
@@ -1379,7 +1557,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    hideAllFromItemsPerPage: false,\n  }"
+                "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    hideAllFromItemsPerPage: false,\n    setToFirstPageOnPaginationChange: false,\n  }"
             },
             "showPagination": {
                 "type": "boolean",
@@ -1626,6 +1804,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",