handsontable 17.1.0 → 18.0.0-rc2

package/utils/licenseNotification.d.mts

@@ -0,0 +1 @@
+export * from './licenseNotification.js';

package/utils/licenseNotification.d.ts

@@ -0,0 +1,12 @@
+import type { HotInstance } from '../core/types';
+/**
+ * Initializes the built-in license notification: injects the product info message as the last
+ * element of the bottom slot when the license is invalid, expired, or missing, and registers
+ * a focus scope so keyboard navigation (Tab/Shift+Tab) includes the notification links.
+ * Only runs for the root Handsontable instance. It is not a layout-slot contributor, so it cannot
+ * be reordered, removed, or disabled by the user.
+ *
+ * @param {HotInstance} hotInstance The root Handsontable instance.
+ * @returns {void}
+ */
+export declare function initLicenseNotification(hotInstance: HotInstance): void;

package/utils/licenseNotification.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "initLicenseNotification", {
+    enumerable: true,
+    get: function() {
+        return initLicenseNotification;
+    }
+});
+const _mixed = require("../helpers/mixed");
+const _constants = require("../core/layout/constants");
+const SCOPE_ID = 'licenseNotification';
+const SHORTCUTS_CONTEXT_NAME = `plugin:${SCOPE_ID}`;
+const LICENSE_INFO_CLASS = 'hot-display-license-info';
+/**
+ * Returns the license notification DOM element when present.
+ *
+ * @param {HotInstance} hotInstance The Handsontable instance.
+ * @returns {HTMLElement | null} The notification element or `null` when absent.
+ */ function getNotificationElement(hotInstance) {
+    return hotInstance.rootSlotBottomElement?.querySelector(`.${LICENSE_INFO_CLASS}`) ?? null;
+}
+/**
+ * Returns focusable elements (links) within the license notification.
+ *
+ * @param {HotInstance} hotInstance The Handsontable instance.
+ * @returns {HTMLElement[]} The focusable elements within the notification.
+ */ function getFocusableElements(hotInstance) {
+    const notification = getNotificationElement(hotInstance);
+    if (!notification) {
+        return [];
+    }
+    return Array.from(notification.querySelectorAll('a[href]'));
+}
+function initLicenseNotification(hotInstance) {
+    const container = hotInstance.rootSlotBottomElement;
+    if (!container) {
+        return;
+    }
+    const licenseKey = hotInstance.getSettings().licenseKey;
+    const releaseDate = typeof process !== 'undefined' && process.env?.HOT_RELEASE_DATE ? "22/06/2026" : '';
+    const notificationElement = (0, _mixed._injectProductInfo)({
+        className: LICENSE_INFO_CLASS,
+        key: licenseKey,
+        element: container,
+        releaseDate
+    });
+    if (!notificationElement) {
+        return;
+    }
+    // `_injectProductInfo` appended this element into the bottom slot element and returned it. The
+    // notification is intentionally NOT registered with the LayoutManager: it must always sit last in
+    // the bottom slot and must not be removable or reorderable through the `layout` setting or
+    // `getLayoutManager().unregister`. Re-append it so it is the last child, and carry the shared
+    // slot-item class so it gets the same separator styling as registered slot items. Because it is a
+    // foreign (unregistered) node, `DomSlot` always inserts registered items before it, keeping it last
+    // as other contributors (for example pagination) register or reorder.
+    notificationElement.classList.add(_constants.SLOT_ITEM_CLASS);
+    container.appendChild(notificationElement);
+    // The scope is intentionally never unregistered: the license notification is created once during
+    // init, cannot be disabled, and lives for the whole instance lifetime. It is cleaned up when
+    // `getFocusScopeManager().destroy()` runs on `hot.destroy()`.
+    hotInstance.getFocusScopeManager().registerScope(SCOPE_ID, notificationElement, {
+        shortcutsContextName: SHORTCUTS_CONTEXT_NAME,
+        runOnlyIf: ()=>getNotificationElement(hotInstance) !== null,
+        onActivate: (focusSource)=>{
+            const focusableElements = getFocusableElements(hotInstance);
+            if (focusableElements.length > 0) {
+                if (focusSource === 'tab_from_above') {
+                    focusableElements.at(0)?.focus();
+                } else if (focusSource === 'tab_from_below') {
+                    focusableElements.at(-1)?.focus();
+                }
+            }
+        }
+    });
+}

package/utils/licenseNotification.mjs

@@ -0,0 +1,77 @@
+import { _injectProductInfo } from '../helpers/mixed.mjs';
+import { SLOT_ITEM_CLASS } from '../core/layout/constants.mjs';
+const SCOPE_ID = 'licenseNotification';
+const SHORTCUTS_CONTEXT_NAME = `plugin:${SCOPE_ID}`;
+const LICENSE_INFO_CLASS = 'hot-display-license-info';
+/**
+ * Returns the license notification DOM element when present.
+ *
+ * @param {HotInstance} hotInstance The Handsontable instance.
+ * @returns {HTMLElement | null} The notification element or `null` when absent.
+ */ function getNotificationElement(hotInstance) {
+    return hotInstance.rootSlotBottomElement?.querySelector(`.${LICENSE_INFO_CLASS}`) ?? null;
+}
+/**
+ * Returns focusable elements (links) within the license notification.
+ *
+ * @param {HotInstance} hotInstance The Handsontable instance.
+ * @returns {HTMLElement[]} The focusable elements within the notification.
+ */ function getFocusableElements(hotInstance) {
+    const notification = getNotificationElement(hotInstance);
+    if (!notification) {
+        return [];
+    }
+    return Array.from(notification.querySelectorAll('a[href]'));
+}
+/**
+ * Initializes the built-in license notification: injects the product info message as the last
+ * element of the bottom slot when the license is invalid, expired, or missing, and registers
+ * a focus scope so keyboard navigation (Tab/Shift+Tab) includes the notification links.
+ * Only runs for the root Handsontable instance. It is not a layout-slot contributor, so it cannot
+ * be reordered, removed, or disabled by the user.
+ *
+ * @param {HotInstance} hotInstance The root Handsontable instance.
+ * @returns {void}
+ */ export function initLicenseNotification(hotInstance) {
+    const container = hotInstance.rootSlotBottomElement;
+    if (!container) {
+        return;
+    }
+    const licenseKey = hotInstance.getSettings().licenseKey;
+    const releaseDate = typeof process !== 'undefined' && process.env?.HOT_RELEASE_DATE ? "22/06/2026" : '';
+    const notificationElement = _injectProductInfo({
+        className: LICENSE_INFO_CLASS,
+        key: licenseKey,
+        element: container,
+        releaseDate
+    });
+    if (!notificationElement) {
+        return;
+    }
+    // `_injectProductInfo` appended this element into the bottom slot element and returned it. The
+    // notification is intentionally NOT registered with the LayoutManager: it must always sit last in
+    // the bottom slot and must not be removable or reorderable through the `layout` setting or
+    // `getLayoutManager().unregister`. Re-append it so it is the last child, and carry the shared
+    // slot-item class so it gets the same separator styling as registered slot items. Because it is a
+    // foreign (unregistered) node, `DomSlot` always inserts registered items before it, keeping it last
+    // as other contributors (for example pagination) register or reorder.
+    notificationElement.classList.add(SLOT_ITEM_CLASS);
+    container.appendChild(notificationElement);
+    // The scope is intentionally never unregistered: the license notification is created once during
+    // init, cannot be disabled, and lives for the whole instance lifetime. It is cleaned up when
+    // `getFocusScopeManager().destroy()` runs on `hot.destroy()`.
+    hotInstance.getFocusScopeManager().registerScope(SCOPE_ID, notificationElement, {
+        shortcutsContextName: SHORTCUTS_CONTEXT_NAME,
+        runOnlyIf: ()=>getNotificationElement(hotInstance) !== null,
+        onActivate: (focusSource)=>{
+            const focusableElements = getFocusableElements(hotInstance);
+            if (focusableElements.length > 0) {
+                if (focusSource === 'tab_from_above') {
+                    focusableElements.at(0)?.focus();
+                } else if (focusSource === 'tab_from_below') {
+                    focusableElements.at(-1)?.focus();
+                }
+            }
+        }
+    });
+}

package/utils/paginator.d.mts

@@ -0,0 +1 @@
+export * from './paginator.js';

package/utils/paginator.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @typedef Paginator
+ * @property {function(number): void} setCurrentPage Sets the current index to the specific page.
+ * @property {function(): number} getCurrentPage Gets the current page.
+ * @property {function(): number} getSize Gets the total number of pages.
+ * @property {function(): void} toFirstItem Move the index to the first page.
+ * @property {function(): void} toLastItem Move the index to the last page.
+ * @property {function(): void} toNextItem Move the index to the next page.
+ * @property {function(): void} toPreviousItem Move the index to the previous page.
+ * @property {function(): void} clear Clear the internal state of the paginator.
+ */
+/**
+ * @param {object} options Paginator options.
+ * @param {number} [options.initialPage] Initial index from which paging starts. Also, after clearing the paginator
+ * the page is cleared to the initial page.
+ * @param {function(): number} [options.size] Sets the max size of the pages.
+ * @param {function(number): boolean | void} [options.onItemSelect] Fires the function on each page change.
+ * @param {function(): void} [options.onClear] Fires the function after clearing the state.
+ * @returns {Paginator}
+ */
+export declare function createPaginator({ initialPage, size, onItemSelect, onClear, }: {
+    initialPage?: number | undefined;
+    size?: (() => number) | undefined;
+    onItemSelect?: ((index: number, commit: boolean) => boolean | void) | undefined;
+    onClear?: (() => void) | undefined;
+}): {
+    setCurrentPage: (index: number) => void;
+    setPageCursorAt: (index: number) => void;
+    getCurrentPage: () => number;
+    toFirstItem: () => void;
+    toLastItem: () => void;
+    toNextItem: () => void;
+    toPreviousItem: () => void;
+    getSize: () => number;
+    clear: () => void;
+};

package/utils/parseTable.d.mts

@@ -0,0 +1 @@
+export * from './parseTable.js';

package/utils/parseTable.d.ts

@@ -1,5 +1,33 @@
-import Core from '../core';
-import { GridSettings } from '../settings';
-
-export function instanceToHTML(instance: Core): string;
-export function htmlToGridSettings(element: HTMLTableElement | string, rootDocument?: Document): GridSettings;
+import type { HotInstance } from '../core/types';
+/**
+ * Converts Handsontable into HTMLTableElement.
+ *
+ * @param {Core} instance The Handsontable instance.
+ * @returns {string} OuterHTML of the HTMLTableElement.
+ */
+export declare function instanceToHTML(instance: HotInstance): string;
+/**
+ * Converts 2D array into HTMLTableElement.
+ *
+ * @param {Array} input Input array which will be converted to HTMLTable.
+ * @returns {string} OuterHTML of the HTMLTableElement.
+ */
+export declare function _dataToHTML(input: unknown[][]): string;
+/**
+ * Replaces each `<td>...</td>` in the HTML string with a normalized version that keeps only
+ * text-like content (strips nested tables, VML/shapes, etc.). Uses matching close-tag search
+ * so that nested `<td>` (e.g. from Excel paste with shapes) do not truncate the payload.
+ * Exported so clipboard HTML can be normalized before sanitization.
+ *
+ * @param {string} html Raw HTML (e.g. from clipboard text/html).
+ * @returns {string} HTML with each cell replaced by opening tag + stripped text + `</td>`.
+ */
+export declare function replaceTdCellsWithTextContent(html: string): string;
+/**
+ * Converts HTMLTable or string into Handsontable configuration object.
+ *
+ * @param {Element|string} element Node element which should contain `<table>...</table>`.
+ * @param {Document} [rootDocument] The document window owner.
+ * @returns {object} Return configuration object. Contains keys as DefaultSettings.
+ */
+export declare function htmlToGridSettings(element: HTMLTableElement | string, rootDocument?: Document): Record<string, unknown> | undefined;

package/utils/parseTable.js

@@ -88,7 +88,7 @@ function instanceToHTML(instance) {
                     if ((0, _mixed.isEmpty)(cellData)) {
                         cell = `<td ${attrs.join(' ')}></td>`;
                     } else {
-                        const value = cellData.toString().replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/(<br(\s*|\/)>(\r\n|\n)?|\r\n|\n)/g, '<br>\r\n').replace(/\x20/gi, '&nbsp;').replace(/\t/gi, '&#9;');
+                        const value = String(cellData).replaceAll('<', '&lt;').replaceAll('>', '&gt;').replace(/(<br(\s*|\/)>(\r\n|\n)?|\r\n|\n)/g, '<br>\r\n').replace(/\x20/gi, '&nbsp;').replace(/\t/gi, '&#9;');
                         cell = `<td ${attrs.join(' ')}>${value}</td>`;
                     }
                 }
@@ -123,7 +123,7 @@ function _dataToHTML(input) {
         }
         for(let column = 0; column < columnsLen; column += 1){
             const cellData = rowData[column];
-            const parsedCellData = (0, _mixed.isEmpty)(cellData) ? '' : cellData.toString().replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/(<br(\s*|\/)>(\r\n|\n)?|\r\n|\n)/g, '<br>\r\n').replace(/\x20{2,}/gi, (substring)=>{
+            const parsedCellData = (0, _mixed.isEmpty)(cellData) ? '' : cellData.toString().replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;').replace(/(<br(\s*|\/)>(\r\n|\n)?|\r\n|\n)/g, '<br>\r\n').replace(/\x20{2,}/gi, (substring)=>{
                 // The way how Excel serializes data with at least two spaces.
                 return `<span style="mso-spacerun: yes">${'&nbsp;'.repeat(substring.length - 1)} </span>`;
             }).replace(/\t/gi, '&#9;');
@@ -157,12 +157,12 @@ const paragraphRegexp = /<p.*?>/g;
         if (!closeMatch) {
             return null;
         }
-        const closeIndex = searchStart + closeMatch.index;
+        const closeIndex = searchStart + (closeMatch.index ?? 0);
         const closeTagLength = closeMatch[0].length;
-        const openIndex = openMatch ? searchStart + openMatch.index : html.length;
+        const openIndex = openMatch ? searchStart + (openMatch.index ?? 0) : html.length;
         if (openIndex < closeIndex) {
             depth += 1;
-            searchStart = openIndex + openMatch[0].length;
+            searchStart = openIndex + (openMatch?.[0].length ?? 0);
         } else {
             depth -= 1;
             if (depth === 0) {
@@ -185,7 +185,7 @@ function replaceTdCellsWithTextContent(html) {
             result.push(html.substring(pos));
             break;
         }
-        const openStart = pos + openMatch.index;
+        const openStart = pos + (openMatch.index ?? 0);
         const openTag = openMatch[0];
         const openEnd = openStart + openTag.length;
         result.push(html.substring(pos, openStart));
@@ -197,12 +197,17 @@ function replaceTdCellsWithTextContent(html) {
         }
         const cellFragment = html.substring(openStart, closeInfo.start + closeInfo.length);
         const contentEnd = closeInfo.start - openStart;
-        const rawContent = cellFragment.substring(openTag.length, contentEnd).trim().replaceAll(/\n\s+/g, ' ') // HTML tags may be split using multiple new lines and whitespaces
+        let rawContent = cellFragment.substring(openTag.length, contentEnd).trim().replaceAll(/\n\s+/g, ' ') // HTML tags may be split using multiple new lines and whitespaces
         .replaceAll(paragraphRegexp, '\n') // Only paragraphs should split text using new line characters
         .replace(/^\n+/, '') // First paragraph shouldn't start with new line characters
-        .replaceAll(/<\/(.*)>\s+$/mg, '</$1>') // HTML tags may end with whitespace.
-        .replace(/(<(?!br)([^>]+)>)/gi, '') // Removing HTML tags
-        .replaceAll(/^&nbsp;$/mg, ''); // Removing single &nbsp; characters separating new lines
+        .replaceAll(/<\/(.*)>\s+$/mg, '</$1>'); // HTML tags may end with whitespace.
+        // Iterative tag removal prevents crafted inputs (e.g. <<script>script>) from re-forming tags after one pass.
+        let prev;
+        do {
+            prev = rawContent;
+            rawContent = rawContent.replace(/<(?!br\b)[^>]+>/gi, '');
+        }while (rawContent !== prev)
+        rawContent = rawContent.replaceAll(/^&nbsp;$/mg, ''); // Removing single &nbsp; characters separating new lines
         result.push(`${openTag}${rawContent}</td>`);
         pos = closeInfo.start + closeInfo.length;
     }
@@ -215,24 +220,26 @@ function htmlToGridSettings(element, rootDocument = document) {
     fragment.appendChild(tempElem);
     let checkElement = element;
     if (typeof checkElement === 'string') {
-        const escapedAdjacentHTML = replaceTdCellsWithTextContent(checkElement);
-        tempElem.insertAdjacentHTML('afterbegin', `${escapedAdjacentHTML}`);
+        // Use replaceTdCellsWithTextContent so nested <td> (e.g. Excel shape cells) are matched correctly
+        const normalizedHTML = replaceTdCellsWithTextContent(checkElement);
+        tempElem.insertAdjacentHTML('afterbegin', normalizedHTML);
         checkElement = tempElem.querySelector('table');
     }
     if (!checkElement || !isHTMLTable(checkElement)) {
         return;
     }
+    const el = checkElement;
     const generator = tempElem.querySelector('meta[name$="enerator"]');
-    const hasRowHeaders = checkElement.querySelector('tbody th') !== null;
-    const trElement = checkElement.querySelector('tr');
+    const hasRowHeaders = el.querySelector('tbody th') !== null;
+    const trElement = el.querySelector('tr');
     const countCols = !trElement ? 0 : Array.from(trElement.cells).reduce((cols, cell)=>cols + cell.colSpan, 0) - (hasRowHeaders ? 1 : 0);
-    const fixedRowsBottom = checkElement.tFoot && Array.from(checkElement.tFoot.rows) || [];
+    const fixedRowsBottom = el.tFoot && Array.from(el.tFoot.rows) || [];
     const fixedRowsTop = [];
     let hasColHeaders = false;
     let thRowsLen = 0;
     let countRows = 0;
-    if (checkElement.tHead) {
-        const thRows = Array.from(checkElement.tHead.rows).filter((tr)=>{
+    if (el.tHead) {
+        const thRows = Array.from(el.tHead.rows).filter((tr)=>{
             const isDataRow = tr.querySelector('td') !== null;
             if (isDataRow) {
                 fixedRowsTop.push(tr);
@@ -276,7 +283,7 @@ function htmlToGridSettings(element, rootDocument = document) {
     }
     const dataRows = [
         ...fixedRowsTop,
-        ...Array.from(checkElement.tBodies).reduce((sections, section)=>{
+        ...Array.from(el.tBodies).reduce((sections, section)=>{
             Array.from(section.rows).forEach((row)=>{
                 sections.push(row);
             });
@@ -285,10 +292,11 @@ function htmlToGridSettings(element, rootDocument = document) {
         ...fixedRowsBottom
     ];
     countRows = dataRows.length;
-    const dataArr = new Array(countRows);
-    for(let r = 0; r < countRows; r++){
-        dataArr[r] = new Array(countCols);
-    }
+    const dataArr = Array.from({
+        length: countRows
+    }, ()=>Array.from({
+            length: countCols
+        }));
     const mergeCells = [];
     const rowHeaders = [];
     for(let row = 0; row < countRows; row++){

package/utils/parseTable.mjs

@@ -69,7 +69,7 @@ const regEscapedChars = new RegExp(Object.keys(ESCAPED_HTML_CHARS).map((key)=>`(
                     if (isEmpty(cellData)) {
                         cell = `<td ${attrs.join(' ')}></td>`;
                     } else {
-                        const value = cellData.toString().replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/(<br(\s*|\/)>(\r\n|\n)?|\r\n|\n)/g, '<br>\r\n').replace(/\x20/gi, '&nbsp;').replace(/\t/gi, '&#9;');
+                        const value = String(cellData).replaceAll('<', '&lt;').replaceAll('>', '&gt;').replace(/(<br(\s*|\/)>(\r\n|\n)?|\r\n|\n)/g, '<br>\r\n').replace(/\x20/gi, '&nbsp;').replace(/\t/gi, '&#9;');
                         cell = `<td ${attrs.join(' ')}>${value}</td>`;
                     }
                 }
@@ -110,7 +110,7 @@ export function _dataToHTML(input) {
         }
         for(let column = 0; column < columnsLen; column += 1){
             const cellData = rowData[column];
-            const parsedCellData = isEmpty(cellData) ? '' : cellData.toString().replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/(<br(\s*|\/)>(\r\n|\n)?|\r\n|\n)/g, '<br>\r\n').replace(/\x20{2,}/gi, (substring)=>{
+            const parsedCellData = isEmpty(cellData) ? '' : cellData.toString().replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;').replace(/(<br(\s*|\/)>(\r\n|\n)?|\r\n|\n)/g, '<br>\r\n').replace(/\x20{2,}/gi, (substring)=>{
                 // The way how Excel serializes data with at least two spaces.
                 return `<span style="mso-spacerun: yes">${'&nbsp;'.repeat(substring.length - 1)} </span>`;
             }).replace(/\t/gi, '&#9;');
@@ -144,12 +144,12 @@ const paragraphRegexp = /<p.*?>/g;
         if (!closeMatch) {
             return null;
         }
-        const closeIndex = searchStart + closeMatch.index;
+        const closeIndex = searchStart + (closeMatch.index ?? 0);
         const closeTagLength = closeMatch[0].length;
-        const openIndex = openMatch ? searchStart + openMatch.index : html.length;
+        const openIndex = openMatch ? searchStart + (openMatch.index ?? 0) : html.length;
         if (openIndex < closeIndex) {
             depth += 1;
-            searchStart = openIndex + openMatch[0].length;
+            searchStart = openIndex + (openMatch?.[0].length ?? 0);
         } else {
             depth -= 1;
             if (depth === 0) {
@@ -180,7 +180,7 @@ const paragraphRegexp = /<p.*?>/g;
             result.push(html.substring(pos));
             break;
         }
-        const openStart = pos + openMatch.index;
+        const openStart = pos + (openMatch.index ?? 0);
         const openTag = openMatch[0];
         const openEnd = openStart + openTag.length;
         result.push(html.substring(pos, openStart));
@@ -192,12 +192,17 @@ const paragraphRegexp = /<p.*?>/g;
         }
         const cellFragment = html.substring(openStart, closeInfo.start + closeInfo.length);
         const contentEnd = closeInfo.start - openStart;
-        const rawContent = cellFragment.substring(openTag.length, contentEnd).trim().replaceAll(/\n\s+/g, ' ') // HTML tags may be split using multiple new lines and whitespaces
+        let rawContent = cellFragment.substring(openTag.length, contentEnd).trim().replaceAll(/\n\s+/g, ' ') // HTML tags may be split using multiple new lines and whitespaces
         .replaceAll(paragraphRegexp, '\n') // Only paragraphs should split text using new line characters
         .replace(/^\n+/, '') // First paragraph shouldn't start with new line characters
-        .replaceAll(/<\/(.*)>\s+$/mg, '</$1>') // HTML tags may end with whitespace.
-        .replace(/(<(?!br)([^>]+)>)/gi, '') // Removing HTML tags
-        .replaceAll(/^&nbsp;$/mg, ''); // Removing single &nbsp; characters separating new lines
+        .replaceAll(/<\/(.*)>\s+$/mg, '</$1>'); // HTML tags may end with whitespace.
+        // Iterative tag removal prevents crafted inputs (e.g. <<script>script>) from re-forming tags after one pass.
+        let prev;
+        do {
+            prev = rawContent;
+            rawContent = rawContent.replace(/<(?!br\b)[^>]+>/gi, '');
+        }while (rawContent !== prev)
+        rawContent = rawContent.replaceAll(/^&nbsp;$/mg, ''); // Removing single &nbsp; characters separating new lines
         result.push(`${openTag}${rawContent}</td>`);
         pos = closeInfo.start + closeInfo.length;
     }
@@ -217,24 +222,26 @@ export function htmlToGridSettings(element, rootDocument = document) {
     fragment.appendChild(tempElem);
     let checkElement = element;
     if (typeof checkElement === 'string') {
-        const escapedAdjacentHTML = replaceTdCellsWithTextContent(checkElement);
-        tempElem.insertAdjacentHTML('afterbegin', `${escapedAdjacentHTML}`);
+        // Use replaceTdCellsWithTextContent so nested <td> (e.g. Excel shape cells) are matched correctly
+        const normalizedHTML = replaceTdCellsWithTextContent(checkElement);
+        tempElem.insertAdjacentHTML('afterbegin', normalizedHTML);
         checkElement = tempElem.querySelector('table');
     }
     if (!checkElement || !isHTMLTable(checkElement)) {
         return;
     }
+    const el = checkElement;
     const generator = tempElem.querySelector('meta[name$="enerator"]');
-    const hasRowHeaders = checkElement.querySelector('tbody th') !== null;
-    const trElement = checkElement.querySelector('tr');
+    const hasRowHeaders = el.querySelector('tbody th') !== null;
+    const trElement = el.querySelector('tr');
     const countCols = !trElement ? 0 : Array.from(trElement.cells).reduce((cols, cell)=>cols + cell.colSpan, 0) - (hasRowHeaders ? 1 : 0);
-    const fixedRowsBottom = checkElement.tFoot && Array.from(checkElement.tFoot.rows) || [];
+    const fixedRowsBottom = el.tFoot && Array.from(el.tFoot.rows) || [];
     const fixedRowsTop = [];
     let hasColHeaders = false;
     let thRowsLen = 0;
     let countRows = 0;
-    if (checkElement.tHead) {
-        const thRows = Array.from(checkElement.tHead.rows).filter((tr)=>{
+    if (el.tHead) {
+        const thRows = Array.from(el.tHead.rows).filter((tr)=>{
             const isDataRow = tr.querySelector('td') !== null;
             if (isDataRow) {
                 fixedRowsTop.push(tr);
@@ -278,7 +285,7 @@ export function htmlToGridSettings(element, rootDocument = document) {
     }
     const dataRows = [
         ...fixedRowsTop,
-        ...Array.from(checkElement.tBodies).reduce((sections, section)=>{
+        ...Array.from(el.tBodies).reduce((sections, section)=>{
             Array.from(section.rows).forEach((row)=>{
                 sections.push(row);
             });
@@ -287,10 +294,11 @@ export function htmlToGridSettings(element, rootDocument = document) {
         ...fixedRowsBottom
     ];
     countRows = dataRows.length;
-    const dataArr = new Array(countRows);
-    for(let r = 0; r < countRows; r++){
-        dataArr[r] = new Array(countCols);
-    }
+    const dataArr = Array.from({
+        length: countRows
+    }, ()=>Array.from({
+            length: countCols
+        }));
     const mergeCells = [];
     const rowHeaders = [];
     for(let row = 0; row < countRows; row++){

package/utils/rootInstance.d.mts

@@ -0,0 +1 @@
+export * from './rootInstance.js';

package/utils/rootInstance.d.ts

@@ -0,0 +1,22 @@
+export declare const holder: WeakMap<object, any>;
+export declare const rootInstanceSymbol: unique symbol;
+/**
+ * Register an object as a root instance.
+ *
+ * @param  {object} object An object to associate with root instance flag.
+ */
+export declare function registerAsRootInstance(object: object): void;
+/**
+ * Check if the source of the root indication call is valid.
+ *
+ * @param  {symbol} rootSymbol A symbol as a source of truth.
+ * @returns {boolean}
+ */
+export declare function hasValidParameter(rootSymbol: unknown): rootSymbol is typeof rootInstanceSymbol;
+/**
+ * Check if passed an object was flagged as a root instance.
+ *
+ * @param  {object} object An object to check.
+ * @returns {boolean}
+ */
+export declare function isRootInstance(object: object): boolean;

package/utils/samplesGenerator.d.mts

@@ -0,0 +1,2 @@
+export * from './samplesGenerator.js';
+export { default } from './samplesGenerator.js';