handsontable 17.1.0 → 18.0.0-rc2

package/core.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
-Object.defineProperty(exports, /* eslint-disable jsdoc/require-description-complete-sentence */ /**
+Object.defineProperty(exports, /**
  * Handsontable constructor.
  *
  * @core
@@ -124,21 +124,64 @@ const _index = require("./core/index");
 const _focusManager = require("./focusManager");
 const _uniqueMap = require("./utils/dataStructures/uniqueMap");
 const _shortcuts = require("./shortcuts");
-const _shortcutContexts = require("./shortcutContexts");
+const _contexts = require("./shortcuts/contexts");
 const _themes = require("./helpers/themes");
 const _stylesHandler = require("./utils/stylesHandler");
 const _console = require("./helpers/console");
 const _errors = require("./helpers/errors");
 const _a11yAnnouncer = require("./utils/a11yAnnouncer");
+const _licenseNotification = require("./utils/licenseNotification");
 const _valueAccessors = require("./utils/valueAccessors");
 const _engine = require("./themes/engine");
+const _layout = require("./core/layout");
 const _themes1 = require("./themes");
+const _dataMap1 = /*#__PURE__*/ _interop_require_default(require("./dataMap/dataMap"));
 function _interop_require_default(obj) {
     return obj && obj.__esModule ? obj : {
         default: obj
     };
 }
 let activeGuid = null;
+/**
+ * Normalizes an array of `[index, amount]` pairs by merging overlapping or adjacent groups
+ * into the smallest set of non-overlapping groups, sorted in ascending order.
+ *
+ * @param {number[][]} indexes Array of `[index, amount]` pairs to normalize.
+ * @returns {number[][]} Normalized array of `[index, amount]` pairs.
+ */ function normalizeIndexesGroup(indexes) {
+    if (indexes.length === 0) {
+        return [];
+    }
+    const sortedIndexes = [
+        ...indexes
+    ];
+    // Sort the indexes in ascending order.
+    sortedIndexes.sort(([indexA], [indexB])=>{
+        if (indexA === indexB) {
+            return 0;
+        }
+        return indexA > indexB ? 1 : -1;
+    });
+    // Normalize the {index, amount} groups into bigger groups.
+    const normalizedIndexes = (0, _array.arrayReduce)(sortedIndexes, (acc, [groupIndex, groupAmount])=>{
+        const previousItem = acc[acc.length - 1];
+        const [prevIndex, prevAmount] = previousItem;
+        const prevLastIndex = prevIndex + prevAmount;
+        if (groupIndex <= prevLastIndex) {
+            const amountToAdd = Math.max(groupAmount - (prevLastIndex - groupIndex), 0);
+            previousItem[1] += amountToAdd;
+        } else {
+            acc.push([
+                groupIndex,
+                groupAmount
+            ]);
+        }
+        return acc;
+    }, [
+        sortedIndexes[0]
+    ]);
+    return normalizedIndexes;
+}
 /**
  * Keeps the collection of the all Handsontable instances created on the same page. The
  * list is then used to trigger the "afterUnlisten" hook when the "listen()" method was
@@ -150,8 +193,7 @@ let activeGuid = null;
  * A set of deprecated feature names.
  *
  * @type {Set<string>}
- */ // eslint-disable-next-line no-unused-vars
-const deprecationWarns = new Set();
+ */ const deprecationWarns = new Set();
 function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
     let instance = this;
     const eventManager = new _eventManager.default(instance);
@@ -180,19 +222,47 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    *
    * @private
    * @type {HTMLElement}
-   */ this.rootWrapperElement = undefined;
+   */ this.rootWrapperElement = null;
     /**
    * Reference to the grid element.
    *
    * @private
    * @type {HTMLElement}
-   */ this.rootGridElement = undefined;
+   */ this.rootGridElement = null;
+    /**
+   * Reference to the grid content element. Wraps the grid (table) together with the grid focus-scope
+   * tab-catchers, so siblings of this element inside `ht-grid` (e.g. the empty-data-state) stay
+   * outside the grid focus scope.
+   *
+   * @private
+   * @type {HTMLElement}
+   */ this.rootGridContentElement = null;
+    /**
+   * Reference to the top slot element. A wrapper slot rendered above the grid for plugin UI
+   * (for example toolbars). Ordered through the layout manager.
+   *
+   * @private
+   * @type {HTMLElement}
+   */ this.rootSlotTopElement = null;
+    /**
+   * Reference to the bottom slot element (pagination, license notification).
+   *
+   * @private
+   * @type {HTMLElement}
+   */ this.rootSlotBottomElement = null;
+    /**
+   * Reference to the overlays element (dialog). Note: the empty-data-state lives inside the grid
+   * element (`ht-grid`), not here.
+   *
+   * @private
+   * @type {HTMLElement}
+   */ this.rootOverlaysElement = null;
     /**
    * Reference to the portal element.
    *
    * @private
    * @type {HTMLElement}
-   */ this.rootPortalElement = undefined;
+   */ this.rootPortalElement = null;
     // TODO: check if references to DOM elements should be move to UI layer (Walkontable)
     /**
    * Reference to the container element.
@@ -214,16 +284,28 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    */ this.rootWindow = this.rootDocument.defaultView;
     if ((0, _rootInstance.isRootInstance)(this)) {
         this.rootWrapperElement = this.rootDocument.createElement('div');
+        this.rootSlotTopElement = this.rootDocument.createElement('div');
         this.rootGridElement = this.rootDocument.createElement('div');
+        this.rootGridContentElement = this.rootDocument.createElement('div');
+        this.rootOverlaysElement = this.rootDocument.createElement('div');
+        this.rootSlotBottomElement = this.rootDocument.createElement('div');
         this.rootPortalElement = this.rootDocument.createElement('div');
         (0, _element.addClass)(this.rootElement, [
             'ht-wrapper',
             'handsontable'
         ]);
         (0, _element.addClass)(this.rootWrapperElement, 'ht-root-wrapper');
+        (0, _element.addClass)(this.rootSlotTopElement, 'ht-slot-top');
         (0, _element.addClass)(this.rootGridElement, 'ht-grid');
-        this.rootGridElement.appendChild(this.rootElement);
+        (0, _element.addClass)(this.rootGridContentElement, 'ht-grid-content');
+        (0, _element.addClass)(this.rootOverlaysElement, 'ht-overlay');
+        (0, _element.addClass)(this.rootSlotBottomElement, 'ht-slot-bottom');
+        this.rootGridContentElement.appendChild(this.rootElement);
+        this.rootGridElement.appendChild(this.rootGridContentElement);
+        this.rootWrapperElement.appendChild(this.rootSlotTopElement);
         this.rootWrapperElement.appendChild(this.rootGridElement);
+        this.rootWrapperElement.appendChild(this.rootSlotBottomElement);
+        this.rootWrapperElement.appendChild(this.rootOverlaysElement);
         this.rootContainer.appendChild(this.rootWrapperElement);
         this.rootWrapperElement.__hotInstance = this;
         (0, _element.addClass)(this.rootPortalElement, 'ht-portal');
@@ -407,13 +489,16 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
         countCols: ()=>instance.countCols(),
         countRows: ()=>instance.countRows(),
         propToCol: (prop)=>datamap.propToCol(prop),
-        isEditorOpened: ()=>instance.getActiveEditor() ? instance.getActiveEditor().isOpened() : false,
-        countRenderableColumns: ()=>this.view.countRenderableColumns(),
-        countRenderableRows: ()=>this.view.countRenderableRows(),
-        countRowHeaders: ()=>this.countRowHeaders(),
-        countColHeaders: ()=>this.countColHeaders(),
-        countRenderableRowsInRange: (...args)=>this.view.countRenderableRowsInRange(...args),
-        countRenderableColumnsInRange: (...args)=>this.view.countRenderableColumnsInRange(...args),
+        isEditorOpened: ()=>{
+            const editor = instance.getActiveEditor();
+            return editor ? editor.isOpened() : false;
+        },
+        countRenderableColumns: ()=>instance.view.countRenderableColumns(),
+        countRenderableRows: ()=>instance.view.countRenderableRows(),
+        countRowHeaders: ()=>instance.countRowHeaders(),
+        countColHeaders: ()=>instance.countColHeaders(),
+        countRenderableRowsInRange: (rowStart, rowEnd)=>instance.view.countRenderableRowsInRange(rowStart, rowEnd),
+        countRenderableColumnsInRange: (columnStart, columnEnd)=>instance.view.countRenderableColumnsInRange(columnStart, columnEnd),
         getShortcutManager: ()=>instance.getShortcutManager(),
         createCellCoords: (row, column)=>instance._createCellCoords(row, column),
         createCellRange: (highlight, from, to)=>instance._createCellRange(highlight, from, to),
@@ -489,7 +574,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
             'updateData',
             'deselect'
         ].includes(selectionSource)) {
-            editorManager.closeEditor(null);
+            editorManager.closeEditor();
         }
         if (![
             'refresh',
@@ -542,7 +627,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
         ]);
         this.runHooks('afterDeselect');
     });
-    this.selection.addLocalHook('beforeHighlightSet', ()=>this.runHooks('beforeSelectionHighlightSet')).addLocalHook('beforeSetRangeStart', (...args)=>this.runHooks('beforeSetRangeStart', ...args)).addLocalHook('beforeSetRangeStartOnly', (...args)=>this.runHooks('beforeSetRangeStartOnly', ...args)).addLocalHook('beforeSetRangeEnd', (...args)=>this.runHooks('beforeSetRangeEnd', ...args)).addLocalHook('beforeSelectColumns', (...args)=>this.runHooks('beforeSelectColumns', ...args)).addLocalHook('afterSelectColumns', (...args)=>this.runHooks('afterSelectColumns', ...args)).addLocalHook('beforeSelectRows', (...args)=>this.runHooks('beforeSelectRows', ...args)).addLocalHook('afterSelectRows', (...args)=>this.runHooks('afterSelectRows', ...args)).addLocalHook('beforeSelectAll', (...args)=>this.runHooks('beforeSelectAll', ...args)).addLocalHook('afterSelectAll', (...args)=>this.runHooks('afterSelectAll', ...args)).addLocalHook('beforeModifyTransformStart', (...args)=>this.runHooks('modifyTransformStart', ...args)).addLocalHook('afterModifyTransformStart', (...args)=>this.runHooks('afterModifyTransformStart', ...args)).addLocalHook('beforeModifyTransformFocus', (...args)=>this.runHooks('modifyTransformFocus', ...args)).addLocalHook('afterModifyTransformFocus', (...args)=>this.runHooks('afterModifyTransformFocus', ...args)).addLocalHook('beforeModifyTransformEnd', (...args)=>this.runHooks('modifyTransformEnd', ...args)).addLocalHook('afterModifyTransformEnd', (...args)=>this.runHooks('afterModifyTransformEnd', ...args)).addLocalHook('beforeRowWrap', (...args)=>this.runHooks('beforeRowWrap', ...args)).addLocalHook('beforeColumnWrap', (...args)=>this.runHooks('beforeColumnWrap', ...args)).addLocalHook('insertRowRequire', (totalRows)=>this.alter('insert_row_above', totalRows, 1, 'auto')).addLocalHook('insertColRequire', (totalCols)=>this.alter('insert_col_start', totalCols, 1, 'auto'));
+    this.selection.addLocalHook('beforeHighlightSet', ()=>instance.runHooks('beforeSelectionHighlightSet')).addLocalHook('beforeSetRangeStart', (...args)=>instance.runHooks('beforeSetRangeStart', ...args)).addLocalHook('beforeSetRangeStartOnly', (...args)=>instance.runHooks('beforeSetRangeStartOnly', ...args)).addLocalHook('beforeSetRangeEnd', (...args)=>instance.runHooks('beforeSetRangeEnd', ...args)).addLocalHook('beforeSelectColumns', (...args)=>instance.runHooks('beforeSelectColumns', ...args)).addLocalHook('afterSelectColumns', (...args)=>instance.runHooks('afterSelectColumns', ...args)).addLocalHook('beforeSelectRows', (...args)=>instance.runHooks('beforeSelectRows', ...args)).addLocalHook('afterSelectRows', (...args)=>instance.runHooks('afterSelectRows', ...args)).addLocalHook('beforeSelectAll', (...args)=>instance.runHooks('beforeSelectAll', ...args)).addLocalHook('afterSelectAll', (...args)=>instance.runHooks('afterSelectAll', ...args)).addLocalHook('beforeModifyTransformStart', (...args)=>instance.runHooks('modifyTransformStart', ...args)).addLocalHook('afterModifyTransformStart', (...args)=>instance.runHooks('afterModifyTransformStart', ...args)).addLocalHook('beforeModifyTransformFocus', (...args)=>instance.runHooks('modifyTransformFocus', ...args)).addLocalHook('afterModifyTransformFocus', (...args)=>instance.runHooks('afterModifyTransformFocus', ...args)).addLocalHook('beforeModifyTransformEnd', (...args)=>instance.runHooks('modifyTransformEnd', ...args)).addLocalHook('afterModifyTransformEnd', (...args)=>instance.runHooks('afterModifyTransformEnd', ...args)).addLocalHook('beforeRowWrap', (...args)=>instance.runHooks('beforeRowWrap', ...args)).addLocalHook('beforeColumnWrap', (...args)=>instance.runHooks('beforeColumnWrap', ...args)).addLocalHook('insertRowRequire', (totalRows)=>instance.alter('insert_row_above', totalRows, 1, 'auto')).addLocalHook('insertColRequire', (totalCols)=>instance.alter('insert_col_start', totalCols, 1, 'auto'));
     grid = {
         /**
      * Inserts or removes rows and columns.
@@ -562,40 +647,6 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
             if (skipAlter === false) {
                 return;
             }
-            const normalizeIndexesGroup = (indexes)=>{
-                if (indexes.length === 0) {
-                    return [];
-                }
-                const sortedIndexes = [
-                    ...indexes
-                ];
-                // Sort the indexes in ascending order.
-                sortedIndexes.sort(([indexA], [indexB])=>{
-                    if (indexA === indexB) {
-                        return 0;
-                    }
-                    return indexA > indexB ? 1 : -1;
-                });
-                // Normalize the {index, amount} groups into bigger groups.
-                const normalizedIndexes = (0, _array.arrayReduce)(sortedIndexes, (acc, [groupIndex, groupAmount])=>{
-                    const previousItem = acc[acc.length - 1];
-                    const [prevIndex, prevAmount] = previousItem;
-                    const prevLastIndex = prevIndex + prevAmount;
-                    if (groupIndex <= prevLastIndex) {
-                        const amountToAdd = Math.max(groupAmount - (prevLastIndex - groupIndex), 0);
-                        previousItem[1] += amountToAdd;
-                    } else {
-                        acc.push([
-                            groupIndex,
-                            groupAmount
-                        ]);
-                    }
-                    return acc;
-                }, [
-                    sortedIndexes[0]
-                ]);
-                return normalizedIndexes;
-            };
             /* eslint-disable no-case-declarations */ switch(action){
                 case 'insert_row_below':
                 case 'insert_row_above':
@@ -606,9 +657,9 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
                     // `above` is the default behavior for creating new rows
                     const insertRowMode = action === 'insert_row_below' ? 'below' : 'above';
                     // Calling the `insert_row_above` action adds a new row at the beginning of the data set.
-                    // eslint-disable-next-line no-param-reassign
-                    index = index ?? (insertRowMode === 'below' ? numberOfSourceRows : 0);
-                    const { delta: rowDelta, startPhysicalIndex: startRowPhysicalIndex } = datamap.createRow(index, amount, {
+                    const defaultRowIndex = insertRowMode === 'below' ? numberOfSourceRows : 0;
+                    const rowIndex = typeof index === 'number' ? index : defaultRowIndex;
+                    const { delta: rowDelta, startPhysicalIndex: startRowPhysicalIndex } = datamap.createRow(rowIndex, amount, {
                         source,
                         mode: insertRowMode
                     });
@@ -619,9 +670,9 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
                     // "start" is a default behavior for creating new columns
                     const insertColumnMode = action === 'insert_col_end' ? 'end' : 'start';
                     // Calling the `insert_col_start` action adds a new column to the left of the data set.
-                    // eslint-disable-next-line no-param-reassign
-                    index = index ?? (insertColumnMode === 'end' ? instance.countSourceCols() : 0);
-                    const { delta: colDelta, startPhysicalIndex: startColumnPhysicalIndex } = datamap.createCol(index, amount, {
+                    const defaultColIndex = insertColumnMode === 'end' ? instance.countSourceCols() : 0;
+                    const colIndex = typeof index === 'number' ? index : defaultColIndex;
+                    const { delta: colDelta, startPhysicalIndex: startColumnPhysicalIndex } = datamap.createCol(colIndex, amount, {
                         source,
                         mode: insertColumnMode
                     });
@@ -646,7 +697,6 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
                             // If the 'index' is an integer decrease it by 'offset' otherwise pass it through to make the value
                             // compatible with datamap.removeCol method.
                             if (Number.isInteger(groupIndex)) {
-                                // eslint-disable-next-line no-param-reassign
                                 groupIndex = Math.max(groupIndex - offset, 0);
                             }
                             // TODO: for datamap.removeRow index should be passed as it is (with undefined and null values). If not, the logic
@@ -704,7 +754,6 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
                             // If the 'index' is an integer decrease it by 'offset' otherwise pass it through to make the value
                             // compatible with datamap.removeCol method.
                             if (Number.isInteger(groupIndex)) {
-                                // eslint-disable-next-line no-param-reassign
                                 groupIndex = Math.max(groupIndex - offset, 0);
                             }
                             // TODO: for datamap.removeCol index should be passed as it is (with undefined and null values). If not, the logic
@@ -797,7 +846,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
                 }
             }
             {
-                let emptyCols;
+                let emptyCols = 0;
                 // count currently empty cols
                 if (minCols || minSpareCols) {
                     emptyCols = instance.countEmptyCols(true);
@@ -998,11 +1047,17 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
                                     if (cellMeta.parsePastedValue && source === 'CopyPaste.paste') {
                                         pushData = true;
                                     }
+                                    // Editor saves always accept the new value regardless of the original cell type (#3234)
+                                    if (source === 'edit') {
+                                        pushData = true;
+                                        value = (0, _object.deepClone)(value);
+                                    }
                                 } else if (orgValue !== null) {
                                     const orgValueSchema = (0, _object.duckSchema)(Array.isArray(orgValue) ? orgValue : orgValue[0] || orgValue);
                                     const valueSchema = (0, _object.duckSchema)(Array.isArray(value) ? value : value[0] || value);
                                     // Allow overwriting values with the same object-based schema or any array-based schema.
                                     if (hasValueSetter || // If the cell has a value setter, we don't know the value schema (it's dynamic)
+                                    source === 'edit' || // Editor saves always accept the new value regardless of schema (#3234)
                                     (0, _object.isObjectEqual)(orgValueSchema, valueSchema) || Array.isArray(orgValueSchema) && Array.isArray(valueSchema)) {
                                         value = (0, _object.deepClone)(value);
                                     } else {
@@ -1054,12 +1109,15 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    */ function setClassName(className, classSettings) {
         const element = className === 'className' ? instance.rootElement : instance.table;
         if (firstRun) {
-            (0, _element.addClass)(element, classSettings);
+            if (classSettings !== undefined) {
+                (0, _element.addClass)(element, classSettings);
+            }
         } else {
             let globalMetaSettingsArray = [];
             let settingsArray = [];
             if (globalMeta[className]) {
-                globalMetaSettingsArray = Array.isArray(globalMeta[className]) ? globalMeta[className] : (0, _array.stringToArray)(globalMeta[className]);
+                const globalMetaValue = globalMeta[className];
+                globalMetaSettingsArray = Array.isArray(globalMetaValue) ? globalMetaValue : (0, _array.stringToArray)(String(globalMetaValue));
             }
             if (classSettings) {
                 settingsArray = Array.isArray(classSettings) ? classSettings : (0, _array.stringToArray)(classSettings);
@@ -1076,6 +1134,12 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
         globalMeta[className] = classSettings;
     }
     this.init = function() {
+        const theme = tableMeta.theme;
+        const themeName = tableMeta.themeName;
+        const rootContainerThemeClassName = (0, _themes.getThemeClassName)(instance.rootContainer);
+        if ((0, _rootInstance.isRootInstance)(instance) && !rootContainerThemeClassName && ((0, _object.isObject)(theme) || !theme && !themeName)) {
+            initializeThemeManager(theme);
+        }
         dataSource.setData(tableMeta.data);
         instance.runHooks('beforeInit');
         if ((0, _browser.isMobileBrowser)() || (0, _browser.isIpadOS)()) {
@@ -1088,7 +1152,37 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
         focusGridManager.init();
         if ((0, _rootInstance.isRootInstance)(this)) {
             (0, _a11yAnnouncer.install)(instance.rootPortalElement);
-            (0, _mixed._injectProductInfo)(mergedUserSettings.licenseKey, this.rootWrapperElement, "19/05/2026");
+            (0, _licenseNotification.initLicenseNotification)(instance);
+            // Keep the edge slots (top, bottom) as wide as the table so their content
+            // (toolbars, pagination, license notification) aligns with the grid.
+            const lastEdgeWidths = {
+                top: -1,
+                bottom: -1
+            };
+            const syncEdgeSlotsWidth = ()=>{
+                if (instance.isDestroyed) {
+                    return;
+                }
+                const { view } = instance;
+                if (!view) {
+                    return;
+                }
+                let width = view.isHorizontallyScrollableByWindow() ? view.getTotalTableWidth() : view.getWorkspaceWidth();
+                if (width === 0 && instance.rootWrapperElement) {
+                    width = instance.rootWrapperElement.offsetWidth;
+                }
+                // Only write when the value actually changes — avoids a reflow → dimension-refresh
+                // → re-sync feedback loop, and needless layout writes during volatile renders.
+                if (instance.rootSlotBottomElement && width !== lastEdgeWidths.bottom) {
+                    lastEdgeWidths.bottom = width;
+                    instance.rootSlotBottomElement.style.width = `${width}px`;
+                }
+                if (instance.rootSlotTopElement && width !== lastEdgeWidths.top) {
+                    lastEdgeWidths.top = width;
+                    instance.rootSlotTopElement.style.width = `${width}px`;
+                }
+            };
+            this.addHook('afterRender', syncEdgeSlotsWidth);
         }
         instance.runHooks('init');
         this.render();
@@ -1146,7 +1240,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
                 this.validatorsInQueue = this.validatorsInQueue - 1 < 0 ? 0 : this.validatorsInQueue - 1;
                 this.checkIfQueueIsEmpty();
             },
-            onQueueEmpty () {},
+            onQueueEmpty (_valid) {},
             checkIfQueueIsEmpty () {
                 if (this.validatorsInQueue === 0 && resolved === false) {
                     resolved = true;
@@ -1177,9 +1271,34 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
             return;
         }
         const activeEditor = instance.getActiveEditor();
-        const waitingForValidator = new ValidatorsQueue();
+        const waitingForValidator = ValidatorsQueue();
         let shouldBeCanceled = true;
+        // Track value corrections applied by validators via setDataAtCell during the validation window.
+        // Without this, a corrected value written by a nested setDataAtCell call gets overwritten when
+        // applyChanges() runs on the original changes array. The hook is removed before applyChanges()
+        // runs (in onQueueEmpty), so it does not capture the parent apply itself.
+        //
+        // Source filtering is structurally required: each nested validateChanges() call registers its
+        // own onAfterChange hook. Without filtering, when the parent applyChanges() fires afterChange,
+        // the nested hook would intercept it and corrupt the nested changes array. Filtering to sources
+        // that end with 'Validator' ensures only corrections emitted by validators are captured, never
+        // values applied by applyChanges(). Custom validators that correct values must follow this
+        // convention by passing a source ending in 'Validator' to their setDataAtCell call.
+        const applyValidatorCorrection = ([changedRow, changedProp, , correctedValue])=>{
+            const idx = changes.findIndex(([row, prop])=>row === changedRow && prop === changedProp);
+            if (idx !== -1) {
+                changes[idx][3] = correctedValue;
+            }
+        };
+        const onAfterChange = (afterChanges, afterSource)=>{
+            if (typeof afterSource !== 'string' || !afterSource.endsWith('Validator')) {
+                return;
+            }
+            afterChanges?.forEach(applyValidatorCorrection);
+        };
+        instance.addHook('afterChange', onAfterChange);
         waitingForValidator.onQueueEmpty = ()=>{
+            instance.removeHook('afterChange', onAfterChange);
             if (activeEditor && shouldBeCanceled && activeEditor._closeAfterDataChange && doesChangeAffectOpenedEditor(changes, activeEditor)) {
                 activeEditor.cancelChanges();
             }
@@ -1250,7 +1369,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
                 }
             }
             if (instance.dataType === 'array' && (!tableMeta.columns || tableMeta.columns.length === 0) && tableMeta.allowInsertColumn) {
-                while(datamap.propToCol(changes[i][1]) > instance.countCols() - 1){
+                while(Number(datamap.propToCol(changes[i][1])) > instance.countCols() - 1){
                     const { delta: numberOfCreatedColumns } = datamap.createCol(undefined, undefined, {
                         source: 'auto'
                     });
@@ -1281,7 +1400,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
                 editorManager.prepareEditor();
             }
             instance.runHooks('afterChange', changes, source || 'edit');
-            if (activeEditor && (0, _mixed.isDefined)(activeEditor.refreshValue) && (!activeEditor.isOpened() || isOpenedEditorAffectedByChanges)) {
+            if (activeEditor && activeEditor.refreshValue !== undefined && (!activeEditor.isOpened() || isOpenedEditorAffectedByChanges)) {
                 activeEditor.refreshValue();
             }
         } else {
@@ -1298,7 +1417,8 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @param {number} column The column index.
    * @returns {CellCoords}
    */ this._createCellCoords = function(row, column) {
-        return instance.view._wt.createCellCoords(row, column);
+        const view = instance.view;
+        return view._wt.createCellCoords(row, column);
     };
     /**
    * Creates and returns the CellRange object.
@@ -1312,7 +1432,8 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @param {CellCoords} to Final coordinates.
    * @returns {CellRange}
    */ this._createCellRange = function(highlight, from, to) {
-        return instance.view._wt.createCellRange(highlight, from, to);
+        const view = instance.view;
+        return view._wt.createCellRange(highlight, from, to);
     };
     /**
    * Validate a single cell.
@@ -1355,19 +1476,21 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
             }(validator);
         }
         if ((0, _function.isFunction)(validator)) {
-            // eslint-disable-next-line no-param-reassign
-            value = instance.runHooks('beforeValidate', value, cellProperties.visualRow, cellProperties.prop, source);
+            // When the column data accessor is a function, cellProperties.prop holds the accessor
+            // function itself — not a usable column reference. Fall back to the visual column index
+            // so hook listeners always receive a number or a property string, never a function.
+            const colArg = (0, _function.isFunction)(cellProperties.prop) ? cellProperties.visualCol : cellProperties.prop;
+            value = instance.runHooks('beforeValidate', value, cellProperties.visualRow, colArg, source);
             // To provide consistent behavior, validation should be always asynchronous
             instance._registerMicrotask(()=>{
                 validator.call(cellProperties, value, (valid)=>{
                     if (!instance) {
                         return;
                     }
-                    // eslint-disable-next-line no-param-reassign
-                    valid = instance.runHooks('afterValidate', valid, value, cellProperties.visualRow, cellProperties.prop, source);
+                    valid = instance.runHooks('afterValidate', valid, value, cellProperties.visualRow, colArg, source);
                     cellProperties.valid = valid;
                     done(valid);
-                    instance.runHooks('postAfterValidate', valid, value, cellProperties.visualRow, cellProperties.prop, source);
+                    instance.runHooks('postAfterValidate', valid, value, cellProperties.visualRow, colArg, source);
                 });
             });
         } else {
@@ -1456,10 +1579,12 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
                 // eslint-disable-next-line max-len
                 (0, _errors.throwWithCause)('Method `setDataAtCell` accepts row and column number as its parameters. If you want to use object property name, use method `setDataAtRowProp`');
             }
-            if (visualColumn >= this.countCols()) {
-                prop = visualColumn;
+            // setDataAtCell validates that column is numeric above (throws if not number).
+            const visualColumnIndex = typeof visualColumn === 'number' ? visualColumn : 0;
+            if (visualColumnIndex >= this.countCols()) {
+                prop = visualColumnIndex;
             } else {
-                prop = datamap.colToProp(visualColumn);
+                prop = datamap.colToProp(visualColumnIndex);
             }
             changes.push([
                 visualRow,
@@ -1589,7 +1714,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
         if (!(typeof input === 'object' && typeof input[0] === 'object')) {
             (0, _errors.throwWithCause)('populateFromArray parameter `input` must be an array of arrays'); // API changed in 0.9-beta2, let's check if you use it correctly
         }
-        const c = typeof endRow === 'number' ? instance._createCellCoords(endRow, endCol) : null;
+        const c = typeof endRow === 'number' ? instance._createCellCoords(endRow, endCol) : undefined;
         return grid.populateFromArray(instance._createCellCoords(row, column), input, c, source, method);
     };
     /**
@@ -1632,7 +1757,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @returns {Array[]|undefined} An array of arrays of the selection's coordinates.
    */ this.getSelected = function() {
         if (selection.isSelected()) {
-            return (0, _array.arrayMap)(selection.getSelectedRange(), ({ from, to })=>[
+            return (0, _array.arrayMap)(selection.getSelectedRange().ranges, ({ from, to })=>[
                     from.row,
                     from.col,
                     to.row,
@@ -1648,7 +1773,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @function getSelectedLast
    * @returns {Array|undefined} An array of the selection's coordinates.
    */ this.getSelectedLast = function() {
-        const selected = this.getSelected();
+        const selected = instance.getSelected();
         let result;
         if (selected && selected.length > 0) {
             result = selected[selected.length - 1];
@@ -1664,7 +1789,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @since 16.1.0
    * @returns {number[]|undefined} Selected range as an array of coordinates or `undefined` if there is no selection.
    */ this.getSelectedActive = function() {
-        const activeRange = this.getSelectedRangeActive();
+        const activeRange = instance.getSelectedRangeActive();
         if (!activeRange) {
             return;
         }
@@ -1699,7 +1824,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @since 0.36.0
    * @returns {CellRange|undefined} Selected range object or `undefined` if there is no selection.
    */ this.getSelectedRangeLast = function() {
-        const selectedRange = this.getSelectedRange();
+        const selectedRange = instance.getSelectedRange();
         let result;
         if (selectedRange && selectedRange.length > 0) {
             result = selectedRange[selectedRange.length - 1];
@@ -1753,7 +1878,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
             if (fromRow > toRow || fromColumn > toColumn) {
                 return;
             }
-            (0, _number.rangeEach)(fromRow, toRow, (row)=>{
+            const collectEmptyCellChanges = (row)=>{
                 (0, _number.rangeEach)(fromColumn, toColumn, (column)=>{
                     if (!this.getCellMeta(row, column).readOnly) {
                         changes.push([
@@ -1763,7 +1888,8 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
                         ]);
                     }
                 });
-            });
+            };
+            (0, _number.rangeEach)(fromRow, toRow, collectEmptyCellChanges);
         });
         if (changes.length > 0) {
             this.setDataAtCell(changes, source);
@@ -1895,9 +2021,9 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * });
    * ```
    */ this.batchRender = function(wrappedOperations) {
-        this.suspendRender();
+        instance.suspendRender();
         const result = wrappedOperations();
-        this.resumeRender();
+        instance.resumeRender();
         return result;
     };
     /**
@@ -1996,9 +2122,9 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * });
    * ```
    */ this.batchExecution = function(wrappedOperations, forceFlushChanges = false) {
-        this.suspendExecution();
+        instance.suspendExecution();
         const result = wrappedOperations();
-        this.resumeExecution(forceFlushChanges);
+        instance.resumeExecution(forceFlushChanges);
         return result;
     };
     /**
@@ -2035,11 +2161,11 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * });
    * ```
    */ this.batch = function(wrappedOperations) {
-        this.suspendRender();
-        this.suspendExecution();
+        instance.suspendRender();
+        instance.suspendExecution();
         const result = wrappedOperations();
-        this.resumeExecution();
-        this.resumeRender();
+        instance.resumeExecution();
+        instance.resumeRender();
         return result;
     };
     /**
@@ -2184,7 +2310,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
             finalNrOfColumns = columnsSettings.length;
         } else if ((0, _function.isFunction)(columnsSettings)) {
             if (instance.dataType === 'array') {
-                const nrOfSourceColumns = this.countSourceCols();
+                const nrOfSourceColumns = instance.countSourceCols();
                 for(let columnIndex = 0; columnIndex < nrOfSourceColumns; columnIndex += 1){
                     if (columnsSettings(columnIndex)) {
                         finalNrOfColumns += 1;
@@ -2201,7 +2327,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
             finalNrOfColumns = Array.isArray(schema) ? schema.length : (0, _object.deepObjectSize)(schema);
         } else {
             // We init index mappers by length of source data to provide indexes also for skipped indexes.
-            finalNrOfColumns = this.countSourceCols();
+            finalNrOfColumns = instance.countSourceCols();
         }
         return finalNrOfColumns;
     };
@@ -2240,7 +2366,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
         if ((0, _mixed.isUndefined)(row)) {
             return datamap.getAll();
         }
-        return datamap.getRange(instance._createCellCoords(row, column), instance._createCellCoords(row2, column2), datamap.DESTINATION_RENDERER);
+        return datamap.getRange(instance._createCellCoords(row, column), instance._createCellCoords(row2, column2), _dataMap1.default.DESTINATION_RENDERER);
     };
     /**
    * Returns a string value of the selected range. Each column is separated by tab, each row is separated by a new
@@ -2322,7 +2448,6 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @fires Hooks#afterUpdateSettings
    */ this.updateSettings = function(settings, init = false) {
         const dataUpdateFunction = (firstRun ? instance.loadData : instance.updateData).bind(this);
-        let columnsAsFunc = false;
         let i;
         let j;
         if ((0, _mixed.isDefined)(settings.rows)) {
@@ -2379,19 +2504,21 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
             } else if (instance.themeManager) {
                 themeName = instance.themeManager.getClassName();
             }
-            instance.useTheme(themeName);
+            instance.useTheme(themeName ?? null);
         } else {
             const currentThemeName = instance.getCurrentThemeName();
             // Use `theme` option if it's a string and differs from current theme (takes priority over `themeName`).
             if (themeOptionExists && typeof settings.theme === 'string' && currentThemeName !== settings.theme) {
-                instance.useTheme(settings.theme);
                 instance.themeManager?.unmount();
+                instance.themeManager = null;
+                instance.useTheme(settings.theme);
             // Use `themeName` option if `theme` is not provided and the name differs from current theme.
             } else if (themeNameOptionExists && !themeOptionExists && currentThemeName !== settings.themeName) {
+                instance.themeManager?.unmount();
+                instance.themeManager = null;
                 tableMeta.theme = settings.themeName;
                 tableMeta.themeName = undefined;
                 instance.useTheme(settings.themeName);
-                instance.themeManager?.unmount();
             // Initialize or update the themeManager when theme is an object.
             } else if ((0, _rootInstance.isRootInstance)(instance) && !rootContainerThemeClassName && (0, _object.isObject)(settings.theme)) {
                 if (instance.themeManager === null) {
@@ -2439,10 +2566,6 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
         }
         const clen = instance.countCols();
         const columnSetting = tableMeta.columns;
-        // Init columns constructors configuration
-        if (columnSetting && (0, _function.isFunction)(columnSetting)) {
-            columnsAsFunc = true;
-        }
         // Clear cell meta cache
         if (settings.cell !== undefined || settings.cells !== undefined || settings.columns !== undefined) {
             metaManager.clearCache();
@@ -2451,7 +2574,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
             for(i = 0, j = 0; i < clen; i++){
                 // Use settings provided by user
                 if (columnSetting) {
-                    const column = columnsAsFunc ? columnSetting(i) : columnSetting[j];
+                    const column = (0, _function.isFunction)(columnSetting) ? columnSetting(i) : columnSetting[j];
                     if (column) {
                         metaManager.updateColumnMeta(j, column);
                     }
@@ -2460,7 +2583,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
             }
         }
         if ((0, _mixed.isDefined)(settings.cell)) {
-            (0, _object.objectEach)(settings.cell, (cell)=>{
+            settings.cell.forEach((cell)=>{
                 instance.setCellMetaObject(cell.row, cell.col, cell);
             });
         }
@@ -2477,7 +2600,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
         if (init) {
             const initialStyle = instance.rootElement.getAttribute('style');
             if (initialStyle) {
-                instance.rootElement.setAttribute('data-initialstyle', instance.rootElement.getAttribute('style'));
+                instance.rootElement.dataset.initialstyle = instance.rootElement.getAttribute('style') ?? '';
             }
         }
         let height = settings.height;
@@ -2487,7 +2610,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
             }
             height = instance.runHooks('beforeHeightChange', height);
             if (height === null) {
-                const initialStyle = instance.rootElement.getAttribute('data-initialstyle');
+                const initialStyle = instance.rootElement.dataset.initialstyle;
                 if (initialStyle && (initialStyle.indexOf('height') > -1 || initialStyle.indexOf('overflow') > -1)) {
                     instance.rootElement.setAttribute('style', initialStyle);
                 } else {
@@ -2507,6 +2630,28 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
             width = instance.runHooks('beforeWidthChange', width);
             instance.rootElement.style.width = isNaN(width) ? `${width}` : `${width}px`;
         }
+        // When height is absent the table uses window scroll, so the `overflow: clip` shorthand from the
+        // height block is not applied. Set overflowX: clip to prevent the inner table from visually
+        // overflowing a constrained width. Read the effective values from the DOM (after both height and
+        // width blocks ran) so partial updateSettings calls see the correct state.
+        // When height IS set, the height block's `overflow: clip` shorthand handles both axes — leave
+        // overflowX untouched to avoid breaking that shorthand.
+        // Browser compatibility: `overflow-x: clip` requires Safari 16+. On Safari 14.1–15.x it silently
+        // falls back to `visible` (graceful degradation — pre-existing behavior, not a new regression).
+        if (typeof settings.height !== 'undefined' || typeof settings.width !== 'undefined') {
+            const effectiveHeight = instance.rootElement.style.height;
+            const effectiveWidth = instance.rootElement.style.width;
+            if (!effectiveHeight) {
+                const currentOverflowX = instance.rootElement.style.overflowX;
+                // Only manage the overflow-x we own (`clip`) or that is unset. Preserve a user-defined
+                // overflow (e.g. `overflow: hidden` restored from the initial style) so it is not stomped
+                // by `clip`. Unlike `hidden`, `clip` creates no block formatting context and allows no
+                // programmatic scroll.
+                if (currentOverflowX === '' || currentOverflowX === 'clip') {
+                    instance.rootElement.style.overflowX = effectiveWidth && effectiveWidth !== 'auto' ? 'clip' : '';
+                }
+            }
+        }
         if (!init) {
             if (instance.view) {
                 instance.view._wt.wtViewport.resetHasOversizedColumnHeadersMarked();
@@ -2524,6 +2669,9 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
         if (!init && instance.view && (currentHeight === '' || height === '' || height === undefined) && currentHeight !== height) {
             instance.view._wt.wtOverlays.updateMainScrollableElements();
         }
+        if ((0, _rootInstance.isRootInstance)(instance)) {
+            layoutManager?.applyConfig(tableMeta.layout);
+        }
     };
     /**
    * Gets the value of the currently focused cell.
@@ -2538,8 +2686,10 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
         if (tableMeta.getValue) {
             if ((0, _function.isFunction)(tableMeta.getValue)) {
                 return tableMeta.getValue.call(instance);
-            } else if (activeSelection) {
-                return instance.getData()[activeSelection.highlight.row][tableMeta.getValue];
+            } else if (activeSelection && typeof tableMeta.getValue === 'string') {
+                const rowIndex = activeSelection.highlight.row ?? 0;
+                const rowData = instance.getData()[rowIndex];
+                return rowData[tableMeta.getValue];
             }
         } else if (activeSelection) {
             return instance.getDataAtCell(activeSelection.highlight.row, activeSelection.highlight.col);
@@ -2556,13 +2706,14 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
         return tableMeta;
     };
     /**
-   * Clears the data from the table (the table settings remain intact).
+   * Clears the data from the table (the table settings remain intact) and clears the current selection.
    *
    * @memberof Core#
    * @function clear
    */ this.clear = function() {
         this.selectAll();
         this.emptySelectedCells();
+        this.deselectCell();
     };
     /**
    * The `alter()` method lets you alter the grid's structure
@@ -2648,16 +2799,16 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
         let renderableColumnIndex = column; // Handling also column headers.
         let renderableRowIndex = row; // Handling also row headers.
         if (column >= 0) {
-            if (this.columnIndexMapper.isHidden(this.toPhysicalColumn(column))) {
+            if (instance.columnIndexMapper.isHidden(instance.toPhysicalColumn(column))) {
                 return null;
             }
-            renderableColumnIndex = this.columnIndexMapper.getRenderableFromVisualIndex(column);
+            renderableColumnIndex = instance.columnIndexMapper.getRenderableFromVisualIndex(column);
         }
         if (row >= 0) {
-            if (this.rowIndexMapper.isHidden(this.toPhysicalRow(row))) {
+            if (instance.rowIndexMapper.isHidden(instance.toPhysicalRow(row))) {
                 return null;
             }
-            renderableRowIndex = this.rowIndexMapper.getRenderableFromVisualIndex(row);
+            renderableRowIndex = instance.rowIndexMapper.getRenderableFromVisualIndex(row);
         }
         if (renderableRowIndex === null || renderableColumnIndex === null || renderableRowIndex === undefined || renderableColumnIndex === undefined) {
             return null;
@@ -2677,18 +2828,18 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * // it returns CellCoords object instance with props row: 1 and col: 1.
    * ```
    */ this.getCoords = function(element) {
-        const renderableCoords = this.view._wt.wtTable.getCoords(element);
+        const renderableCoords = instance.view._wt.wtTable.getCoords(element);
         if (renderableCoords === null) {
             return null;
         }
         const { row: renderableRow, col: renderableColumn } = renderableCoords;
         let visualRow = renderableRow;
         let visualColumn = renderableColumn;
-        if (renderableRow >= 0) {
-            visualRow = this.rowIndexMapper.getVisualFromRenderableIndex(renderableRow);
+        if (renderableRow !== null && renderableRow >= 0) {
+            visualRow = instance.rowIndexMapper.getVisualFromRenderableIndex(renderableRow);
         }
-        if (renderableColumn >= 0) {
-            visualColumn = this.columnIndexMapper.getVisualFromRenderableIndex(renderableColumn);
+        if (renderableColumn !== null && renderableColumn >= 0) {
+            visualColumn = instance.columnIndexMapper.getVisualFromRenderableIndex(renderableColumn);
         }
         return instance._createCellCoords(visualRow, visualColumn);
     };
@@ -2723,7 +2874,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @function toVisualRow
    * @param {number} row Physical row index.
    * @returns {number} Returns visual row index.
-   */ this.toVisualRow = (row)=>this.rowIndexMapper.getVisualFromPhysicalIndex(row);
+   */ this.toVisualRow = (row)=>instance.rowIndexMapper.getVisualFromPhysicalIndex(row);
     /**
    * Translate physical column index into visual.
    *
@@ -2734,7 +2885,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @function toVisualColumn
    * @param {number} column Physical column index.
    * @returns {number} Returns visual column index.
-   */ this.toVisualColumn = (column)=>this.columnIndexMapper.getVisualFromPhysicalIndex(column);
+   */ this.toVisualColumn = (column)=>instance.columnIndexMapper.getVisualFromPhysicalIndex(column);
     /**
    * Translate visual row index into physical.
    *
@@ -2745,7 +2896,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @function toPhysicalRow
    * @param {number} row Visual row index.
    * @returns {number} Returns physical row index.
-   */ this.toPhysicalRow = (row)=>this.rowIndexMapper.getPhysicalFromVisualIndex(row);
+   */ this.toPhysicalRow = (row)=>instance.rowIndexMapper.getPhysicalFromVisualIndex(row);
     /**
    * Translate visual column index into physical.
    *
@@ -2756,7 +2907,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @function toPhysicalColumn
    * @param {number} column Visual column index.
    * @returns {number} Returns physical column index.
-   */ this.toPhysicalColumn = (column)=>this.columnIndexMapper.getPhysicalFromVisualIndex(column);
+   */ this.toPhysicalColumn = (column)=>instance.columnIndexMapper.getPhysicalFromVisualIndex(column);
     /**
    * @description
    * Returns the cell value at `row`, `column`.
@@ -2796,7 +2947,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @returns {Array} Array of cell values.
    */ this.getDataAtCol = function(column) {
         const columnData = [];
-        const dataByRows = datamap.getRange(instance._createCellCoords(0, column), instance._createCellCoords(tableMeta.data.length - 1, column), datamap.DESTINATION_RENDERER);
+        const dataByRows = datamap.getRange(instance._createCellCoords(0, column), instance._createCellCoords(tableMeta.data.length - 1, column), _dataMap1.default.DESTINATION_RENDERER);
         for(let i = 0; i < dataByRows.length; i += 1){
             for(let j = 0; j < dataByRows[i].length; j += 1){
                 columnData.push(dataByRows[i][j]);
@@ -2815,7 +2966,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    */ // TODO: Getting data from `datamap` should work on visual indexes.
     this.getDataAtProp = function(prop) {
         const columnData = [];
-        const dataByRows = datamap.getRange(instance._createCellCoords(0, datamap.propToCol(prop)), instance._createCellCoords(tableMeta.data.length - 1, datamap.propToCol(prop)), datamap.DESTINATION_RENDERER);
+        const dataByRows = datamap.getRange(instance._createCellCoords(0, datamap.propToCol(prop)), instance._createCellCoords(tableMeta.data.length - 1, datamap.propToCol(prop)), _dataMap1.default.DESTINATION_RENDERER);
         for(let i = 0; i < dataByRows.length; i += 1){
             for(let j = 0; j < dataByRows[i].length; j += 1){
                 columnData.push(dataByRows[i][j]);
@@ -2848,7 +2999,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
         if (row === undefined) {
             data = dataSource.getData();
         } else {
-            data = dataSource.getByRange(instance._createCellCoords(row, column), instance._createCellCoords(row2, column2));
+            data = dataSource.getByRange(instance._createCellCoords(row, column ?? null), instance._createCellCoords(row2 ?? null, column2 ?? null));
         }
         return data;
     };
@@ -2872,7 +3023,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
         if (row === undefined) {
             data = dataSource.getData(true);
         } else {
-            data = dataSource.getByRange(instance._createCellCoords(row, column), instance._createCellCoords(row2, column2), true);
+            data = dataSource.getByRange(instance._createCellCoords(row, column ?? null), instance._createCellCoords(row2 ?? null, column2 ?? null), true);
         }
         return data;
     };
@@ -2887,7 +3038,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
     this.getSourceDataAtCol = function(column) {
         return dataSource.getAtColumn(column);
     };
-    /* eslint-disable jsdoc/require-param */ /**
+    /**
    * Set the provided value in the source data set at the provided coordinates.
    *
    * @memberof Core#
@@ -2896,15 +3047,15 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @param {number|string} column Physical column index / prop name.
    * @param {*} value The value to be set at the provided coordinates.
    * @param {string} [source] Source of the change as a string.
-   */ /* eslint-enable jsdoc/require-param */ this.setSourceDataAtCell = function(row, column, value, source) {
+   */ this.setSourceDataAtCell = function(row, column, value, source) {
         const input = setDataInputToArray(row, column, value);
-        const isThereAnySetSourceListener = this.hasHook('afterSetSourceDataAtCell');
+        const isThereAnySetSourceListener = instance.hasHook('afterSetSourceDataAtCell');
         const changesForHook = [];
         const getCellProperties = (changeRow, changeProp)=>{
-            const visualRow = this.toVisualRow(changeRow);
-            const visualColumn = this.toVisualColumn(changeProp);
+            const visualRow = instance.toVisualRow(changeRow);
+            const visualColumn = instance.toVisualColumn(changeProp);
             if (Number.isInteger(visualColumn)) {
-                return this.getCellMeta(visualRow, visualColumn);
+                return instance.getCellMeta(visualRow, visualColumn);
             }
             // If there's no requested visual column, we can use the table meta as the cell properties
             return {
@@ -2927,6 +3078,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
             const cellMeta = getCellProperties(changeRow, changeProp);
             const newValue = (0, _valueAccessors.getValueSetterValue)(changeValue, cellMeta);
             if ((0, _dataMap.runSourceDataValidator)(newValue, cellMeta, source ?? 'setSourceDataAtCell')) {
+                // changeProp is a physical column index for array-based data sources.
                 dataSource.setAtCell(changeRow, changeProp, newValue);
             }
         });
@@ -2975,7 +3127,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @param {number} row Visual row index.
    * @returns {Array} Array of row's cell data.
    */ this.getDataAtRow = function(row) {
-        const data = datamap.getRange(instance._createCellCoords(row, 0), instance._createCellCoords(row, this.countCols() - 1), datamap.DESTINATION_RENDERER);
+        const data = datamap.getRange(instance._createCellCoords(row, 0), instance._createCellCoords(row, this.countCols() - 1), _dataMap1.default.DESTINATION_RENDERER);
         return data[0] || [];
     };
     /**
@@ -2996,8 +3148,8 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
         const coords = rowFrom === undefined ? [
             0,
             0,
-            this.countRows(),
-            this.countCols()
+            instance.countRows(),
+            instance.countCols()
         ] : [
             rowFrom,
             columnFrom,
@@ -3018,8 +3170,8 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
         (0, _number.rangeEach)(Math.max(Math.min(rowStart, rowEnd), 0), Math.max(rowStart, rowEnd), (row)=>{
             let isTypeEqual = true;
             (0, _number.rangeEach)(Math.max(Math.min(columnStart, columnEnd), 0), Math.max(columnStart, columnEnd), (column)=>{
-                const cellType = this.getCellMeta(row, column);
-                currentType = cellType.type;
+                const cellType = instance.getCellMeta(row, column);
+                currentType = cellType.type ?? null;
                 if (previousType) {
                     isTypeEqual = previousType === currentType;
                 } else {
@@ -3027,7 +3179,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
                 }
                 return isTypeEqual;
             });
-            type = isTypeEqual ? currentType : 'mixed';
+            type = isTypeEqual ? currentType ?? 'mixed' : 'mixed';
             return isTypeEqual;
         });
         return type;
@@ -3044,8 +3196,8 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @fires Hooks#afterRemoveCellMeta
    */ this.removeCellMeta = function(row, column, key) {
         const [physicalRow, physicalColumn] = [
-            this.toPhysicalRow(row),
-            this.toPhysicalColumn(column)
+            instance.toPhysicalRow(row),
+            instance.toPhysicalColumn(column)
         ];
         let cachedValue = metaManager.getCellMetaKeyValue(physicalRow, physicalColumn, key);
         const hookResult = instance.runHooks('beforeRemoveCellMeta', row, column, key, cachedValue);
@@ -3069,12 +3221,14 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
             (0, _errors.throwWithCause)('The 3rd argument (cellMetaRows) has to be passed as an array of cell meta objects array.');
         }
         if (deleteAmount > 0) {
-            metaManager.removeRow(this.toPhysicalRow(visualIndex), deleteAmount);
+            metaManager.removeRow(instance.toPhysicalRow(visualIndex), deleteAmount);
         }
         if (cellMetaRows.length > 0) {
             (0, _array.arrayEach)(cellMetaRows.reverse(), (cellMetaRow)=>{
-                metaManager.createRow(this.toPhysicalRow(visualIndex));
-                (0, _array.arrayEach)(cellMetaRow, (cellMeta, columnIndex)=>this.setCellMetaObject(visualIndex, columnIndex, cellMeta));
+                metaManager.createRow(instance.toPhysicalRow(visualIndex));
+                (0, _array.arrayEach)(cellMetaRow, (cellMeta, columnIndex)=>{
+                    this.setCellMetaObject(visualIndex, columnIndex, cellMeta);
+                });
             });
         }
         instance.render();
@@ -3112,11 +3266,11 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
         }
         let physicalRow = row;
         let physicalColumn = column;
-        if (row < this.countRows()) {
-            physicalRow = this.toPhysicalRow(row);
+        if (row < instance.countRows()) {
+            physicalRow = instance.toPhysicalRow(row);
         }
-        if (column < this.countCols()) {
-            physicalColumn = this.toPhysicalColumn(column);
+        if (column < instance.countCols()) {
+            physicalColumn = instance.toPhysicalColumn(column);
         }
         metaManager.setCellMeta(physicalRow, physicalColumn, key, value);
         instance.runHooks('afterSetCellMeta', row, column, key, value);
@@ -3145,8 +3299,8 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    */ this.getCellMeta = function(row, column, options = {
         skipMetaExtension: false
     }) {
-        let physicalRow = this.toPhysicalRow(row);
-        let physicalColumn = this.toPhysicalColumn(column);
+        let physicalRow = instance.toPhysicalRow(row);
+        let physicalColumn = instance.toPhysicalColumn(column);
         if (physicalRow === null) {
             physicalRow = row;
         }
@@ -3168,7 +3322,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @param {number} column Visual column index.
    * @returns {object}
    */ this.getColumnMeta = function(column) {
-        return metaManager.getColumnMeta(this.toPhysicalColumn(column));
+        return metaManager.getColumnMeta(instance.toPhysicalColumn(column));
     };
     /**
    * Returns an array of cell meta objects for specified physical row index.
@@ -3349,7 +3503,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @param {Array} [rows] An array of validation target visual row indexes.
    * @param {Array} [columns] An array of validation target visual column indexes.
    */ this._validateCells = function(callback, rows, columns) {
-        const waitingForValidator = new ValidatorsQueue();
+        const waitingForValidator = ValidatorsQueue();
         if (callback) {
             waitingForValidator.onQueueEmpty = callback;
         }
@@ -3396,10 +3550,11 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
             physicalRow = instance.runHooks('modifyRowHeader', physicalRow);
         }
         if (physicalRow === undefined) {
-            rowHeader = [];
+            const headers = [];
             (0, _number.rangeEach)(instance.countRows() - 1, (i)=>{
-                rowHeader.push(instance.getRowHeader(i));
+                headers.push(instance.getRowHeader(i));
             });
+            rowHeader = headers;
         } else if (Array.isArray(rowHeader) && rowHeader[physicalRow] !== undefined) {
             rowHeader = rowHeader[physicalRow];
         } else if ((0, _function.isFunction)(rowHeader)) {
@@ -3484,12 +3639,13 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
             return out;
         }
         let result = tableMeta.colHeaders;
+        const columns = tableMeta.columns;
         const translateVisualIndexToColumns = function(visualColumnIndex) {
             const arr = [];
             const columnsLen = instance.countCols();
             let index = 0;
             for(; index < columnsLen; index++){
-                if ((0, _function.isFunction)(tableMeta.columns) && tableMeta.columns(index)) {
+                if ((0, _function.isFunction)(columns) && columns(index)) {
                     arr.push(index);
                 }
             }
@@ -3499,10 +3655,10 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
         const prop = translateVisualIndexToColumns(physicalColumn);
         if (tableMeta.colHeaders === false) {
             result = null;
-        } else if (tableMeta.columns && (0, _function.isFunction)(tableMeta.columns) && tableMeta.columns(prop) && tableMeta.columns(prop).title) {
-            result = tableMeta.columns(prop).title;
-        } else if (tableMeta.columns && tableMeta.columns[physicalColumn] && tableMeta.columns[physicalColumn].title) {
-            result = tableMeta.columns[physicalColumn].title;
+        } else if (columns && (0, _function.isFunction)(columns) && columns(prop) && columns(prop).title) {
+            result = columns(prop).title;
+        } else if (columns && !(0, _function.isFunction)(columns) && columns[physicalColumn] && columns[physicalColumn].title) {
+            result = columns[physicalColumn].title;
         } else if (Array.isArray(tableMeta.colHeaders) && tableMeta.colHeaders[physicalColumn] !== undefined) {
             result = tableMeta.colHeaders[physicalColumn];
         } else if ((0, _function.isFunction)(tableMeta.colHeaders)) {
@@ -3591,7 +3747,9 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
                 height = Number.parseInt(height, 10);
             }
         }
-        return height !== undefined && height !== null && height < defaultRowHeight ? defaultRowHeight : height;
+        const numHeight = height;
+        const numDefaultRowHeight = defaultRowHeight;
+        return numHeight !== undefined && numHeight !== null && numDefaultRowHeight !== null && numHeight < numDefaultRowHeight ? numDefaultRowHeight : numHeight;
     };
     /**
    * Returns a row's height, as recognized by Handsontable.
@@ -3659,7 +3817,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @returns {number} Total number of columns.
    */ this.countCols = function() {
         const maxCols = tableMeta.maxCols;
-        const dataLen = this.columnIndexMapper.getNotTrimmedIndexesLength();
+        const dataLen = instance.columnIndexMapper.getNotTrimmedIndexesLength();
         return Math.min(maxCols, dataLen);
     };
     /**
@@ -3670,7 +3828,8 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @function countRenderedRows
    * @returns {number} Returns -1 if table is not visible.
    */ this.countRenderedRows = function() {
-        return instance.view._wt.drawn ? instance.view._wt.wtTable.getRenderedRowsCount() : -1;
+        const view = instance.view;
+        return view._wt.drawn ? view._wt.wtTable.getRenderedRowsCount() : -1;
     };
     /**
    * Returns the number of rendered rows that are only visible in the table viewport.
@@ -3680,7 +3839,8 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @function countVisibleRows
    * @returns {number} Number of visible rows or -1.
    */ this.countVisibleRows = function() {
-        return instance.view._wt.drawn ? instance.view._wt.wtTable.getVisibleRowsCount() : -1;
+        const view = instance.view;
+        return view._wt.drawn ? view._wt.wtTable.getVisibleRowsCount() : -1;
     };
     /**
    * Returns the number of rendered rows including columns that are partially or fully rendered
@@ -3690,7 +3850,8 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @function countRenderedCols
    * @returns {number} Returns -1 if table is not visible.
    */ this.countRenderedCols = function() {
-        return instance.view._wt.drawn ? instance.view._wt.wtTable.getRenderedColumnsCount() : -1;
+        const view = instance.view;
+        return view._wt.drawn ? view._wt.wtTable.getRenderedColumnsCount() : -1;
     };
     /**
    * Returns the number of rendered columns that are only visible in the table viewport.
@@ -3700,7 +3861,8 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @function countVisibleCols
    * @returns {number} Number of visible columns or -1.
    */ this.countVisibleCols = function() {
-        return instance.view._wt.drawn ? instance.view._wt.wtTable.getVisibleColumnsCount() : -1;
+        const view = instance.view;
+        return view._wt.drawn ? view._wt.wtTable.getVisibleColumnsCount() : -1;
     };
     /**
    * Returns the number of rendered row headers.
@@ -3710,7 +3872,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @function countRowHeaders
    * @returns {number} Number of row headers.
    */ this.countRowHeaders = function() {
-        return this.view.getRowHeadersCount();
+        return instance.view.getRowHeadersCount();
     };
     /**
    * Returns the number of rendered column headers.
@@ -3720,7 +3882,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @function countColHeaders
    * @returns {number} Number of column headers.
    */ this.countColHeaders = function() {
-        return this.view.getColumnHeadersCount();
+        return instance.view.getColumnHeadersCount();
     };
     /**
    * Returns the number of empty rows. If the optional ending parameter is `true`, returns the
@@ -3821,20 +3983,25 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @param {number} [endRow] If selecting a range: the visual row index of the last cell in the range.
    * @param {number|string} [endColumn] If selecting a range: the visual column index (or a column property's value) of the last cell in the range.
    * @param {boolean} [scrollToCell=true] `true`: scroll the viewport to the newly-selected cells. `false`: keep the previous viewport.
-   * @param {boolean} [changeListener=true] `true`: switch the keyboard focus to Handsontable. `false`: keep the previous keyboard focus.
+   * @param {boolean} [changeListener=true] `true`: switch the keyboard focus to Handsontable. `false`: keep the
+   * previous keyboard focus. If an element outside Handsontable (such as a custom input) currently owns the browser
+   * focus, it remains focused after the call.
    * @returns {boolean} `true`: the selection was successful, `false`: the selection failed.
    */ this.selectCell = function(row, column, endRow, endColumn, scrollToCell = true, changeListener = true) {
         if ((0, _mixed.isUndefined)(row) || (0, _mixed.isUndefined)(column)) {
             return false;
         }
-        return this.selectCells([
+        const rowNum = row === null || row === undefined || Number.isNaN(Number(row)) ? 0 : Number(row);
+        const col = column === null || column === undefined || typeof column === 'number' && Number.isNaN(column) ? 0 : column;
+        const coords = [
             [
-                row,
-                column,
-                endRow,
-                endColumn
+                rowNum,
+                col,
+                (0, _mixed.isUndefined)(endRow) ? undefined : endRow,
+                (0, _mixed.isUndefined)(endColumn) ? undefined : endColumn
             ]
-        ], scrollToCell, changeListener);
+        ];
+        return instance.selectCells(coords, scrollToCell, changeListener);
     };
     /**
    * Select multiple cells or ranges of cells, adjacent or non-adjacent.
@@ -3890,7 +4057,9 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * passed either as an array of arrays (`[[rowStart, columnStart, rowEnd, columnEnd], ...]`)
    * or as an array of [`CellRange`](@/api/cellRange.md) objects.
    * @param {boolean} [scrollToCell=true] `true`: scroll the viewport to the newly-selected cells. `false`: keep the previous viewport.
-   * @param {boolean} [changeListener=true] `true`: switch the keyboard focus to Handsontable. `false`: keep the previous keyboard focus.
+   * @param {boolean} [changeListener=true] `true`: switch the keyboard focus to Handsontable. `false`: keep the
+   * previous keyboard focus. If an element outside Handsontable (such as a custom input) currently owns the browser
+   * focus, it remains focused after the call.
    * @returns {boolean} `true`: the selection was successful, `false`: the selection failed.
    */ this.selectCells = function(coords = [
         []
@@ -3898,11 +4067,21 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
         if (scrollToCell === false) {
             viewportScroller.suspend();
         }
-        const wasSelected = selection.selectCells(coords);
+        if (changeListener === false) {
+            focusGridManager.suspend();
+        }
+        let wasSelected;
+        try {
+            wasSelected = selection.selectCells(coords);
+        } finally{
+            // Always release the suspended state even if `selection.selectCells` throws on malformed
+            // coordinates. Otherwise the flags would leak across subsequent calls.
+            viewportScroller.resume();
+            focusGridManager.resume();
+        }
         if (wasSelected && changeListener) {
             instance.listen();
         }
-        viewportScroller.resume();
         return wasSelected;
     };
     /**
@@ -4033,6 +4212,28 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
         return indexMapper.getNearestNotHiddenIndex(visualIndex, 1, true);
     };
     /**
+   * Resolves renderable row and column indexes for scrolling, accounting for hidden indexes.
+   *
+   * @param {number|undefined} row Visual row index.
+   * @param {number|undefined} col Visual column index.
+   * @returns {{renderableRow: number|undefined, renderableColumn: number|undefined}|false} Resolved
+   *   renderable indexes, or `false` when scrolling target is not reachable.
+   */ const resolveRenderableScrollTarget = (row, col)=>{
+        const isValidRowGrid = row !== undefined && Number.isInteger(row) && row >= 0;
+        const isValidColumnGrid = col !== undefined && Number.isInteger(col) && col >= 0;
+        const visualRowToScroll = isValidRowGrid ? getIndexToScroll(instance.rowIndexMapper, row) : undefined;
+        const visualColumnToScroll = isValidColumnGrid ? getIndexToScroll(instance.columnIndexMapper, col) : undefined;
+        if (visualRowToScroll === null || visualColumnToScroll === null) {
+            return false;
+        }
+        const renderableRow = isValidRowGrid ? instance.rowIndexMapper.getRenderableFromVisualIndex(visualRowToScroll) ?? undefined : row;
+        const renderableColumn = isValidColumnGrid ? instance.columnIndexMapper.getRenderableFromVisualIndex(visualColumnToScroll) ?? undefined : col;
+        return {
+            renderableRow,
+            renderableColumn
+        };
+    };
+    /**
    * Scroll viewport to coordinates specified by the `row` and/or `col` object properties.
    *
    * ```js
@@ -4075,14 +4276,14 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    */ this.scrollViewportTo = function(options, callback) {
         // Support for backward compatibility arguments: (row, col, snapToBottom, snapToRight, considerHiddenIndexes)
         if (typeof options === 'number') {
-            /* eslint-disable prefer-rest-params */ options = {
+            /* eslint-disable prefer-rest-params, @typescript-eslint/no-unsafe-assignment */ options = {
                 row: arguments[0],
                 col: arguments[1],
                 verticalSnap: arguments[2] ? 'bottom' : 'top',
                 horizontalSnap: arguments[3] ? 'end' : 'start',
                 considerHiddenIndexes: arguments[4] ?? true
             };
-        /* eslint-enable prefer-rest-params */ }
+        /* eslint-enable prefer-rest-params, @typescript-eslint/no-unsafe-assignment */ }
         const { row, col, considerHiddenIndexes } = options ?? {};
         let renderableRow = row;
         let renderableColumn = col;
@@ -4090,15 +4291,12 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
             this.addHookOnce('afterScroll', callback);
         }
         if (considerHiddenIndexes === undefined || considerHiddenIndexes) {
-            const isValidRowGrid = Number.isInteger(row) && row >= 0;
-            const isValidColumnGrid = Number.isInteger(col) && col >= 0;
-            const visualRowToScroll = isValidRowGrid ? getIndexToScroll(this.rowIndexMapper, row) : undefined;
-            const visualColumnToScroll = isValidColumnGrid ? getIndexToScroll(this.columnIndexMapper, col) : undefined;
-            if (visualRowToScroll === null || visualColumnToScroll === null) {
+            const resolved = resolveRenderableScrollTarget(row, col);
+            if (resolved === false) {
                 return false;
             }
-            renderableRow = isValidRowGrid ? instance.rowIndexMapper.getRenderableFromVisualIndex(visualRowToScroll) : row;
-            renderableColumn = isValidColumnGrid ? instance.columnIndexMapper.getRenderableFromVisualIndex(visualColumnToScroll) : col;
+            renderableRow = resolved.renderableRow;
+            renderableColumn = resolved.renderableColumn;
         }
         const isRowInteger = Number.isInteger(renderableRow);
         const isColumnInteger = Number.isInteger(renderableColumn);
@@ -4131,20 +4329,20 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @param {Function} [callback] The callback function to call after the viewport is scrolled.
    * @returns {boolean} `true` if the viewport was scrolled, `false` otherwise.
    */ this.scrollToFocusedCell = function(callback) {
-        if (!this.selection.isSelected()) {
+        if (!instance.selection.isSelected()) {
             return false;
         }
         if ((0, _function.isFunction)(callback)) {
-            this.addHookOnce('afterScroll', callback);
+            instance.addHookOnce('afterScroll', callback);
         }
-        const { highlight } = this.getSelectedRangeActive();
-        const isScrolled = this.scrollViewportTo(highlight.toObject());
+        const { highlight } = instance.getSelectedRangeActive();
+        const isScrolled = instance.scrollViewportTo(highlight.toObject());
         if (isScrolled) {
             // fast render triggers `afterScroll` hook
-            this.view.render();
+            instance.view.render();
         } else if ((0, _function.isFunction)(callback)) {
-            this.removeHook('afterScroll', callback);
-            this._registerMicrotask(()=>callback());
+            instance.removeHook('afterScroll', callback);
+            instance._registerMicrotask(()=>callback());
         }
         return isScrolled;
     };
@@ -4167,6 +4365,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
         if ((0, _rootInstance.isRootInstance)(this)) {
             (0, _a11yAnnouncer.uninstall)();
             this.getFocusScopeManager().destroy();
+            layoutManager?.destroy();
             instance.themeManager?.destroy();
         }
         this.getShortcutManager().destroy();
@@ -4239,7 +4438,10 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @function getActiveEditor
    * @returns {BaseEditor | undefined} The active editor instance, or `undefined` if no cell is selected.
    */ this.getActiveEditor = function() {
-        return editorManager.getActiveEditor();
+        // During the first `afterLoadData` hook (fired from `loadData` inside `init`),
+        // `editorManager` has not been assigned yet. Guard so callers (e.g.
+        // `setSourceDataAtCell`) invoked from that hook do not crash.
+        return editorManager?.getActiveEditor();
     };
     /**
    * Returns the first rendered row in the DOM (usually, it is not visible in the table's viewport).
@@ -4523,8 +4725,9 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @since 7.1.0
    * @returns {HTMLTableElement}
    */ this.toTableElement = ()=>{
-        const tempElement = this.rootDocument.createElement('div');
-        tempElement.insertAdjacentHTML('afterbegin', (0, _parseTable.instanceToHTML)(this));
+        const rootDocument = instance.rootDocument;
+        const tempElement = rootDocument.createElement('div');
+        tempElement.insertAdjacentHTML('afterbegin', (0, _parseTable.instanceToHTML)(instance));
         return tempElement.firstElementChild;
     };
     this.timeouts = [];
@@ -4537,7 +4740,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @param {string|boolean|undefined} themeName The name of the theme to use.
    */ this.useTheme = (themeName)=>{
         const isFirstRun = !!firstRun;
-        this.stylesHandler.useTheme(themeName);
+        this.stylesHandler.useTheme(themeName ?? undefined);
         const validThemeName = this.stylesHandler.getThemeName();
         if (!isFirstRun && validThemeName) {
             if ((0, _themes.getThemeClassName)(this.rootContainer)) {
@@ -4557,7 +4760,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @since 15.0.0
    * @returns {string|undefined} The name of the currently used theme.
    */ this.getCurrentThemeName = ()=>{
-        return this.stylesHandler.getThemeName();
+        return instance.stylesHandler.getThemeName() ?? null;
     };
     /**
    * Gets the table's root container element height.
@@ -4567,7 +4770,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @since 16.0.0
    * @returns {number}
    */ this.getTableHeight = ()=>{
-        return this.rootElement.offsetHeight;
+        return instance.rootElement.offsetHeight;
     };
     /**
    * Gets the table's root container element width.
@@ -4577,7 +4780,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
    * @since 16.0.0
    * @returns {number}
    */ this.getTableWidth = ()=>{
-        return this.rootElement.offsetWidth;
+        return instance.rootElement.offsetWidth;
     };
     /**
    * Sets timeout. Purpose of this method is to clear all known timeouts when `destroy` method is called.
@@ -4606,7 +4809,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
     };
     this.microtasks = [];
     /**
-   * Execute function execution to the next event loop cycle.
+   * Registers a microtask callback.
    *
    * @param {Function} callback Function to be delayed in execution.
    * @private
@@ -4663,7 +4866,7 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
             return instance.isListening();
         },
         beforeKeyDown: (event)=>{
-            return this.runHooks('beforeKeyDown', event);
+            return instance.runHooks('beforeKeyDown', event);
         },
         afterKeyDown: (event)=>{
             if (this.isDestroyed) {
@@ -4692,6 +4895,10 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
     };
     focusGridManager = new _focusManager.FocusGridManager(instance);
     const focusScopeManager = (0, _rootInstance.isRootInstance)(this) ? (0, _focusManager.createFocusScopeManager)(instance) : null;
+    const layoutManager = (0, _rootInstance.isRootInstance)(this) ? new _layout.LayoutManager({
+        top: instance.rootSlotTopElement,
+        bottom: instance.rootSlotBottomElement
+    }) : null;
     /**
    * Return the Focus Manager responsible for managing the browser's focus in the table.
    *
@@ -4727,6 +4934,26 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
         }
         return focusScopeManager;
     };
+    /**
+   * Returns the Layout Manager. The module manages the order of plugin UI elements within the
+   * user-orderable wrapper slots (`top`, `bottom`). Use it to add or remove custom UI and
+   * order it via weights or the `layout` setting. Only available for the main instance.
+   *
+   * @memberof Core#
+   * @since 18.0.0
+   * @function getLayoutManager
+   * @returns {LayoutManager} Instance of {@link LayoutManager}
+   *
+   * @example
+   * ```js
+   * hot.getLayoutManager().register('myToolbar', toolbarElement, { side: 'top', weight: 100 });
+   * ```
+   */ this.getLayoutManager = function() {
+        if (!(0, _rootInstance.isRootInstance)(instance)) {
+            (0, _errors.throwWithCause)('The LayoutManager is only available for the main Handsontable instance.');
+        }
+        return layoutManager;
+    };
     const theme = mergedUserSettings.theme;
     const themeName = mergedUserSettings.themeName;
     const rootContainerThemeClassName = (0, _themes.getThemeClassName)(instance.rootContainer);
@@ -4735,9 +4962,11 @@ function Core(rootContainer, userSettings, rootInstanceSymbol = false) {
     }
     (0, _registry.getPluginsNames)().forEach((pluginName)=>{
         const PluginClass = (0, _registry.getPlugin)(pluginName);
-        pluginsRegistry.addItem(pluginName, new PluginClass(this));
+        if (PluginClass) {
+            pluginsRegistry.addItem(pluginName, new PluginClass(this));
+        }
     });
-    (0, _shortcutContexts.registerAllShortcutContexts)(instance);
+    (0, _contexts.registerAllShortcutContexts)(instance);
     if ((0, _rootInstance.isRootInstance)(this)) {
         (0, _focusManager.registerAllFocusScopes)(instance);
     }