handsontable 16.2.0 → 17.0.0-rc1

package/core.js

@@ -2,21 +2,6 @@
 
 exports.__esModule = true;
 exports.default = Core;
-require("core-js/modules/es.error.cause.js");
-require("core-js/modules/es.array.push.js");
-require("core-js/modules/es.object.from-entries.js");
-require("core-js/modules/es.set.difference.v2.js");
-require("core-js/modules/es.set.intersection.v2.js");
-require("core-js/modules/es.set.is-disjoint-from.v2.js");
-require("core-js/modules/es.set.is-subset-of.v2.js");
-require("core-js/modules/es.set.is-superset-of.v2.js");
-require("core-js/modules/es.set.symmetric-difference.v2.js");
-require("core-js/modules/es.set.union.v2.js");
-require("core-js/modules/esnext.iterator.constructor.js");
-require("core-js/modules/esnext.iterator.filter.js");
-require("core-js/modules/esnext.iterator.for-each.js");
-require("core-js/modules/esnext.iterator.map.js");
-require("core-js/modules/web.immediate.js");
 var _element = require("./helpers/dom/element");
 var _function = require("./helpers/function");
 var _mixed = require("./helpers/mixed");
@@ -34,7 +19,6 @@ var _registry4 = require("./validators/registry");
 var _string = require("./helpers/string");
 var _number = require("./helpers/number");
 var _tableView = _interopRequireDefault(require("./tableView"));
-var _dataSource = _interopRequireDefault(require("./dataMap/dataSource"));
 var _data = require("./helpers/data");
 var _translations = require("./translations");
 var _rootInstance = require("./utils/rootInstance");
@@ -51,18 +35,14 @@ var _shortcutContexts = require("./shortcutContexts");
 var _themes = require("./helpers/themes");
 var _stylesHandler = require("./utils/stylesHandler");
 var _console = require("./helpers/console");
+var _errors = require("./helpers/errors");
 var _a11yAnnouncer = require("./utils/a11yAnnouncer");
 var _valueAccessors = require("./utils/valueAccessors");
+var _engine = require("./themes/engine");
+var _themes2 = require("./themes");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 let activeGuid = null;
 
-/**
- * A set of deprecated warn instances.
- *
- * @type {Set<string>}
- */
-const deprecatedWarnInstances = new WeakSet();
-
 /**
  * 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
@@ -145,7 +125,7 @@ const deprecationWarns = new Set();
  *   standalone: true,
  *   imports: [HotTableModule],
  *   template: ` <div>
- *     <hot-table themeName="ht-theme-main" [settings]="gridSettings" />
+ *     <hot-table [settings]="gridSettings" />
  *   </div>`,
  * })
  * export class ExampleComponent implements AfterViewInit {
@@ -343,21 +323,29 @@ function Core(rootContainer, userSettings) {
     hot: instance,
     rootElement: instance.rootElement,
     rootDocument: instance.rootDocument,
-    onThemeChange: validThemeName => {
+    onThemeChange: themeName => {
       if ((0, _rootInstance.isRootInstance)(this)) {
         (0, _element.removeClass)(this.rootWrapperElement, /ht-theme-.*/g);
         (0, _element.removeClass)(this.rootPortalElement, /ht-theme-.*/g);
-        if (validThemeName) {
-          (0, _element.addClass)(this.rootWrapperElement, validThemeName);
-          (0, _element.addClass)(this.rootPortalElement, validThemeName);
+        if (themeName) {
+          (0, _element.addClass)(this.rootWrapperElement, themeName);
+          (0, _element.addClass)(this.rootPortalElement, themeName);
           if (!getComputedStyle(this.rootWrapperElement).getPropertyValue('--ht-line-height')) {
-            (0, _console.warn)(`The "${validThemeName}" theme is enabled, but its stylesheets are missing or not imported correctly. \
-              Import the correct CSS files in order to use that theme.`);
+            (0, _console.warn)(`The "${themeName}" theme is enabled, but its stylesheets are missing` + ' or not imported correctly. Import the correct CSS files in order to use that theme.');
           }
         }
       }
-    }
+    },
+    injectCoreCss: typeof (userSettings === null || userSettings === void 0 ? void 0 : userSettings.injectCoreCss) === 'boolean' ? userSettings.injectCoreCss : true
   });
+
+  /**
+   * ThemeManager instance.
+   *
+   * @private
+   * @type {ThemeManager|null}
+   */
+  this.themeManager = null;
   mergedUserSettings.language = (0, _registry5.getValidLanguageCode)(mergedUserSettings.language);
   const settingsWithoutHooks = Object.fromEntries(Object.entries(mergedUserSettings).filter(_ref => {
     let [key] = _ref;
@@ -399,7 +387,7 @@ function Core(rootContainer, userSettings) {
   eventManager.addEventListener(this.rootDocument.documentElement, 'compositionstart', event => {
     instance.runHooks('beforeCompositionStart', event);
   });
-  dataSource = new _dataSource.default(instance);
+  dataSource = new _dataMap.DataSource(instance);
   const moduleRegisterer = (0, _staticRegister.staticRegister)(this.guid);
   moduleRegisterer.register('cellRangeMapper', new _index.CellRangeToRenderableMapper({
     rowIndexMapper: this.rowIndexMapper,
@@ -506,7 +494,9 @@ function Core(rootContainer, userSettings) {
     const selectionLayerLevel = selectionRange.size() - 1;
     this.runHooks('afterSelection', from.row, from.col, to.row, to.col, preventScrolling, selectionLayerLevel);
     this.runHooks('afterSelectionByProp', from.row, instance.colToProp(from.col), to.row, instance.colToProp(to.col), preventScrolling, selectionLayerLevel);
-    if (isLastSelectionLayer && (!preventScrolling.isTouched() || preventScrolling.isTouched() && !preventScrolling.value)) {
+    const selectionSource = selection.getSelectionSource();
+    const ignoreScrollSources = ['loadData', 'updateData'];
+    if (isLastSelectionLayer && !ignoreScrollSources.includes(selectionSource) && (!preventScrolling.isTouched() || preventScrolling.isTouched() && !preventScrolling.value)) {
       viewportScroller.scrollTo(cellCoords);
     }
     const isSelectedByRowHeader = selection.isSelectedByRowHeader();
@@ -526,10 +516,10 @@ function Core(rootContainer, userSettings) {
     } else {
       (0, _element.removeClass)(this.rootElement, ['ht__selection--rows', 'ht__selection--columns']);
     }
-    if (!['shift', 'refresh'].includes(selection.getSelectionSource())) {
+    if (!['shift', 'refresh', 'loadData', 'updateData'].includes(selectionSource)) {
       editorManager.closeEditor(null);
     }
-    if (selection.getSelectionSource() !== 'refresh') {
+    if (!['refresh', 'loadData', 'updateData'].includes(selectionSource)) {
       instance.view.render();
       editorManager.prepareEditor();
     }
@@ -878,7 +868,7 @@ function Core(rootContainer, userSettings) {
           }
           break;
         default:
-          throw new Error(`There is no such action "${action}"`);
+          (0, _errors.throwWithCause)(`There is no such action "${action}"`);
       }
       if (!keepEmptyRows) {
         grid.adjustRowsAndCols(); // makes sure that we did not add rows that will be removed in next refresh
@@ -1122,6 +1112,12 @@ function Core(rootContainer, userSettings) {
                 }
                 if (!hasValueSetter && (typeof orgValue !== 'object' || orgValue === null)) {
                   pushData = false;
+
+                  // Enabling `parsePastedValue` relaxes schema validation, so object-based values can be pasted
+                  // into non-object-based cells
+                  if (cellMeta.parsePastedValue && source === 'CopyPaste.paste') {
+                    pushData = true;
+                  }
                 } 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);
@@ -1215,7 +1211,7 @@ function Core(rootContainer, userSettings) {
     focusGridManager.init();
     if ((0, _rootInstance.isRootInstance)(this)) {
       (0, _a11yAnnouncer.install)(instance.rootPortalElement);
-      (0, _mixed._injectProductInfo)(mergedUserSettings.licenseKey, this.rootWrapperElement);
+      (0, _mixed._injectProductInfo)(mergedUserSettings.licenseKey, this.rootWrapperElement, "20/02/2026");
     }
     instance.runHooks('init');
     this.render();
@@ -1236,6 +1232,31 @@ function Core(rootContainer, userSettings) {
     instance.runHooks('afterInit');
   };
 
+  /**
+   * Initializes the ThemeManager with the given theme configuration.
+   *
+   * @param {object|boolean} theme - The theme configuration object or `true` to use the default theme.
+   */
+  function initializeThemeManager(theme) {
+    let themeObject;
+    if (typeof theme === 'undefined') {
+      if ((0, _themes2.hasTheme)('main')) {
+        themeObject = (0, _themes2.getTheme)('main');
+      } else {
+        themeObject = (0, _themes2.registerTheme)(_themes2.mainTheme);
+      }
+      themeObject = (0, _themes2.getTheme)('main');
+    } else if (typeof theme.getThemeConfig !== 'function') {
+      themeObject = (0, _themes2.registerTheme)(theme);
+    } else {
+      themeObject = theme;
+    }
+    instance.themeManager = (0, _engine.createThemeManager)({
+      hot: instance,
+      themeObject
+    });
+  }
+
   /**
    * @ignore
    * @returns {object}
@@ -1279,7 +1300,7 @@ function Core(rootContainer, userSettings) {
     const waitingForValidator = new ValidatorsQueue();
     let shouldBeCanceled = true;
     waitingForValidator.onQueueEmpty = () => {
-      if (activeEditor && shouldBeCanceled) {
+      if (activeEditor && shouldBeCanceled && activeEditor._closeAfterDataChange) {
         activeEditor.cancelChanges();
       }
       callback(); // called when async validators are resolved and beforeChange was not async
@@ -1304,7 +1325,7 @@ function Core(rootContainer, userSettings) {
         instance.validateCell(newValue, cellProperties, function (index, cellPropertiesReference) {
           return function (result) {
             if (typeof result !== 'boolean') {
-              throw new Error('Validation error: result is not boolean');
+              (0, _errors.throwWithCause)('Validation error: result is not boolean');
             }
             if (result === false && cellPropertiesReference.allowInvalid === false) {
               shouldBeCanceled = false;
@@ -1375,15 +1396,20 @@ function Core(rootContainer, userSettings) {
       datamap.set(changes[i][0], changes[i][1], changes[i][3]);
     }
     const hasChanges = changes.length > 0;
+    const activeEditor = editorManager.getActiveEditor();
+    const closeEditorAfterDataChange = activeEditor === null || activeEditor === void 0 ? void 0 : activeEditor._closeAfterDataChange;
     if (hasChanges) {
       grid.adjustRowsAndCols();
       instance.runHooks('beforeChangeRender', changes, source);
-      editorManager.closeEditor();
+      if (activeEditor !== null && activeEditor !== void 0 && activeEditor.isOpened() && closeEditorAfterDataChange) {
+        editorManager.closeEditor();
+      }
       instance.view.adjustElementsSize();
       instance.render();
-      editorManager.prepareEditor();
+      if (activeEditor !== null && activeEditor !== void 0 && activeEditor.isOpened() && closeEditorAfterDataChange || !(activeEditor !== null && activeEditor !== void 0 && activeEditor.isOpened())) {
+        editorManager.prepareEditor();
+      }
       instance.runHooks('afterChange', changes, source || 'edit');
-      const activeEditor = instance.getActiveEditor();
       if (activeEditor && (0, _mixed.isDefined)(activeEditor.refreshValue)) {
         activeEditor.refreshValue();
       }
@@ -1471,7 +1497,7 @@ function Core(rootContainer, userSettings) {
       value = instance.runHooks('beforeValidate', value, cellProperties.visualRow, cellProperties.prop, source);
 
       // To provide consistent behavior, validation should be always asynchronous
-      instance._registerImmediate(() => {
+      instance._registerMicrotask(() => {
         validator.call(cellProperties, value, valid => {
           if (!instance) {
             return;
@@ -1485,7 +1511,7 @@ function Core(rootContainer, userSettings) {
       });
     } else {
       // resolve callback even if validator function was not found
-      instance._registerImmediate(() => {
+      instance._registerMicrotask(() => {
         cellProperties.valid = true;
         done(cellProperties.valid, false);
       });
@@ -1565,10 +1591,11 @@ function Core(rootContainer, userSettings) {
     for (i = 0, ilen = input.length; i < ilen; i++) {
       const [visualRow, visualColumn, newValue] = input[i];
       if (typeof input[i] !== 'object') {
-        throw new Error('Method `setDataAtCell` accepts row number or changes array of arrays as its first parameter');
+        (0, _errors.throwWithCause)('Method `setDataAtCell` accepts row number or changes array of arrays as its first parameter');
       }
-      if (typeof visualColumn !== 'number') {
-        throw new Error('Method `setDataAtCell` accepts row and column number as its parameters. If you want to use object property name, use method `setDataAtRowProp`'); // eslint-disable-line max-len
+      if (typeof input[i][1] !== 'number') {
+        // 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;
@@ -1706,7 +1733,7 @@ function Core(rootContainer, userSettings) {
    */
   this.populateFromArray = function (row, column, input, endRow, endCol, source, method) {
     if (!(typeof input === 'object' && typeof input[0] === 'object')) {
-      throw new Error('populateFromArray parameter `input` must be an array of arrays'); // API changed in 0.9-beta2, let's check if you use it correctly
+      (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;
     return grid.populateFromArray(instance._createCellCoords(row, column), input, c, source, method);
@@ -1796,7 +1823,7 @@ function Core(rootContainer, userSettings) {
    * has visible focus highlight.
    *
    * @memberof Core#
-   * @function getSelectedRangeActive
+   * @function getSelectedActive
    * @since 16.1.0
    * @returns {number[]|undefined} Selected range as an array of coordinates or `undefined` if there is no selection.
    */
@@ -2277,7 +2304,9 @@ function Core(rootContainer, userSettings) {
       instance.columnIndexMapper.fitToLength(this.getInitialColumnCount());
       instance.rowIndexMapper.fitToLength(this.countSourceRows());
       grid.adjustRowsAndCols();
+      selection.markSource('updateData');
       selection.refresh();
+      selection.markEndSource();
     }, {
       hotInstance: instance,
       dataMap: datamap,
@@ -2318,7 +2347,9 @@ function Core(rootContainer, userSettings) {
       metaManager.clearCellsCache();
       instance.initIndexMappers();
       grid.adjustRowsAndCols();
+      selection.markSource('loadData');
       selection.refresh();
+      selection.markEndSource();
       if (firstRun) {
         firstRun = [null, 'loadData'];
       }
@@ -2505,13 +2536,13 @@ function Core(rootContainer, userSettings) {
     let i;
     let j;
     if ((0, _mixed.isDefined)(settings.rows)) {
-      throw new Error('The "rows" setting is no longer supported. Do you mean startRows, minRows or maxRows?');
+      (0, _errors.throwWithCause)('The "rows" setting is no longer supported. Do you mean startRows, minRows or maxRows?');
     }
     if ((0, _mixed.isDefined)(settings.cols)) {
-      throw new Error('The "cols" setting is no longer supported. Do you mean startCols, minCols or maxCols?');
+      (0, _errors.throwWithCause)('The "cols" setting is no longer supported. Do you mean startCols, minCols or maxCols?');
     }
     if ((0, _mixed.isDefined)(settings.ganttChart)) {
-      throw new Error('Since 8.0.0 the "ganttChart" setting is no longer supported.');
+      (0, _errors.throwWithCause)('Since 8.0.0 the "ganttChart" setting is no longer supported.');
     }
     if ((0, _mixed.isDefined)(settings.rowHeights) && (0, _mixed.isDefined)(settings.minRowHeights)) {
       (0, _console.warn)('Both `rowHeights` and `minRowHeights` are defined in your configuration. ' + 'As one is the alias of the other, only one of them can be used at a time. ' + '`rowHeights` will be used as the row height configuration.');
@@ -2540,24 +2571,56 @@ function Core(rootContainer, userSettings) {
         globalMeta[i] = settings[i];
       }
     }
+    const rootContainerThemeClassName = (0, _themes.getThemeClassName)(instance.rootContainer);
+    const themeNameOptionExists = (0, _object.hasOwnProperty)(settings, 'themeName');
+    const themeOptionExists = (0, _object.hasOwnProperty)(settings, 'theme');
+    if (themeNameOptionExists && themeOptionExists) {
+      (0, _console.warn)('Both `theme` and `themeName` are defined in your configuration. ' + 'These options are aliases and cannot be used together. ' + 'The `themeName` option will be ignored.');
+    }
+
+    // Update the theme via the `theme` or `themeName` option as a string or undefined.
     if (init) {
-      // Use the theme defined in the settings object or set as a root container class name (in that order).
-      instance.useTheme(tableMeta.themeName || (0, _themes.getThemeClassName)(instance.rootContainer));
+      let themeName;
+      if (themeOptionExists && typeof settings.theme === 'string') {
+        themeName = settings.theme;
+      } else if (themeNameOptionExists && typeof settings.themeName === 'string' && settings.themeName && !themeOptionExists) {
+        themeName = settings.themeName;
+        tableMeta.theme = settings.themeName;
+        tableMeta.themeName = undefined;
+      } else if (rootContainerThemeClassName) {
+        themeName = rootContainerThemeClassName;
+      } else if (instance.themeManager) {
+        themeName = instance.themeManager.getClassName();
+      }
+      instance.useTheme(themeName);
     } else {
       const currentThemeName = instance.getCurrentThemeName();
-      const themeNameOptionExists = (0, _object.hasOwnProperty)(settings, 'themeName');
-      if (themeNameOptionExists && currentThemeName !== settings.themeName) {
+
+      // 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) {
+        var _instance$themeManage;
+        instance.useTheme(settings.theme);
+        (_instance$themeManage = instance.themeManager) === null || _instance$themeManage === void 0 || _instance$themeManage.unmount();
+
+        // Use `themeName` option if `theme` is not provided and the name differs from current theme.
+      } else if (themeNameOptionExists && !themeOptionExists && currentThemeName !== settings.themeName) {
+        var _instance$themeManage2;
+        tableMeta.theme = settings.themeName;
+        tableMeta.themeName = undefined;
         instance.useTheme(settings.themeName);
+        (_instance$themeManage2 = instance.themeManager) === null || _instance$themeManage2 === void 0 || _instance$themeManage2.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) {
+          initializeThemeManager(settings.theme);
+          instance.useTheme(instance.themeManager.getClassName());
+        } else {
+          instance.themeManager.update(settings.theme);
+          instance.useTheme(instance.themeManager.getClassName());
+        }
       }
     }
-    if (deprecatedWarnInstances.has(instance) && instance.stylesHandler.getThemeName() !== undefined) {
-      deprecatedWarnInstances.delete(instance);
-    }
-    if ((0, _rootInstance.isRootInstance)(instance) && !deprecatedWarnInstances.has(instance) && instance.stylesHandler.isClassicTheme()) {
-      // eslint-disable-next-line max-len
-      (0, _console.deprecatedWarn)('The stylesheet you are using is deprecated and will be removed in version 17.0. Please update your theme configuration to ensure compatibility with future releases.');
-      deprecatedWarnInstances.add(instance);
-    }
 
     // Load data or create data map
     if (settings.data === undefined && tableMeta.data === undefined) {
@@ -2603,6 +2666,12 @@ function Core(rootContainer, userSettings) {
       });
     }
     instance.runHooks('afterCellMetaReset');
+
+    // for the first run, we need to run the source data warnings after cell meta initialization
+    // otherwise there is no access to `sourceDataValidator` function
+    if (firstRun) {
+      (0, _dataMap.runSourceDataValidators)(instance, 'init');
+    }
     let currentHeight = instance.rootElement.style.height;
     if (currentHeight !== '') {
       currentHeight = parseInt(instance.rootElement.style.height, 10);
@@ -2629,7 +2698,7 @@ function Core(rootContainer, userSettings) {
         }
       } else if (height !== undefined) {
         instance.rootElement.style.height = isNaN(height) ? `${height}` : `${height}px`;
-        instance.rootElement.style.overflow = 'hidden';
+        instance.rootElement.style.overflow = 'clip';
       }
     }
     if (typeof settings.width !== 'undefined') {
@@ -3102,8 +3171,11 @@ function Core(rootContainer, userSettings) {
     }
     (0, _array.arrayEach)(input, _ref0 => {
       let [changeRow, changeProp, changeValue] = _ref0;
-      const newValue = (0, _valueAccessors.getValueSetterValue)(changeValue, getCellProperties(changeRow, changeProp));
-      dataSource.setAtCell(changeRow, changeProp, newValue);
+      const cellMeta = getCellProperties(changeRow, changeProp);
+      const newValue = (0, _valueAccessors.getValueSetterValue)(changeValue, cellMeta);
+      if ((0, _dataMap.runSourceDataValidator)(newValue, cellMeta, source !== null && source !== void 0 ? source : 'setSourceDataAtCell')) {
+        dataSource.setAtCell(changeRow, changeProp, newValue);
+      }
     });
     if (isThereAnySetSourceListener) {
       this.runHooks('afterSetSourceDataAtCell', changesForHook, source);
@@ -3244,7 +3316,7 @@ function Core(rootContainer, userSettings) {
       cellMetaRows[_key18 - 2] = arguments[_key18];
     }
     if (cellMetaRows.length > 0 && !Array.isArray(cellMetaRows[0])) {
-      throw new Error('The 3rd argument (cellMetaRows) has to be passed as an array of cell meta objects array.');
+      (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);
@@ -3510,7 +3582,7 @@ function Core(rootContainer, userSettings) {
    */
   this.validateRows = function (rows, callback) {
     if (!Array.isArray(rows)) {
-      throw new Error('validateRows parameter `rows` must be an array');
+      (0, _errors.throwWithCause)('validateRows parameter `rows` must be an array');
     }
     this._validateCells(callback, rows);
   };
@@ -3536,7 +3608,7 @@ function Core(rootContainer, userSettings) {
    */
   this.validateColumns = function (columns, callback) {
     if (!Array.isArray(columns)) {
-      throw new Error('validateColumns parameter `columns` must be an array');
+      (0, _errors.throwWithCause)('validateColumns parameter `columns` must be an array');
     }
     this._validateCells(callback, undefined, columns);
   };
@@ -3575,7 +3647,7 @@ function Core(rootContainer, userSettings) {
         waitingForValidator.addValidatorToQueue();
         instance.validateCell(instance.getDataAtCell(i, j), instance.getCellMeta(i, j), result => {
           if (typeof result !== 'boolean') {
-            throw new Error('Validation error: result is not boolean');
+            (0, _errors.throwWithCause)('Validation error: result is not boolean');
           }
           if (result === false) {
             waitingForValidator.valid = false;
@@ -4445,7 +4517,7 @@ function Core(rootContainer, userSettings) {
    */
   this.destroy = function () {
     instance._clearTimeouts();
-    instance._clearImmediates();
+    instance._clearMicrotasks();
     if (instance.view) {
       // in case HT is destroyed before initialization has finished
       instance.view.destroy();
@@ -4455,8 +4527,10 @@ function Core(rootContainer, userSettings) {
     }
     dataSource = null;
     if ((0, _rootInstance.isRootInstance)(this)) {
+      var _instance$themeManage3;
       (0, _a11yAnnouncer.uninstall)();
       this.getFocusScopeManager().destroy();
+      (_instance$themeManage3 = instance.themeManager) === null || _instance$themeManage3 === void 0 || _instance$themeManage3.destroy();
     }
     this.getShortcutManager().destroy();
     moduleRegisterer.clear();
@@ -4519,7 +4593,7 @@ function Core(rootContainer, userSettings) {
    */
   function postMortem(method) {
     return () => {
-      throw new Error(`The "${method}" method cannot be called because this Handsontable instance has been destroyed`);
+      (0, _errors.throwWithCause)(`The "${method}" method cannot be called because this Handsontable instance has been destroyed`);
     };
   }
 
@@ -4707,10 +4781,6 @@ function Core(rootContainer, userSettings) {
    * @returns {string}
    */
   this.getPluginName = function (plugin) {
-    // Workaround for the UndoRedo plugin which, currently doesn't follow the plugin architecture.
-    if (plugin === this.undoRedo) {
-      return this.undoRedo.constructor.PLUGIN_KEY;
-    }
     return pluginsRegistry.getId(plugin);
   };
 
@@ -4883,15 +4953,13 @@ function Core(rootContainer, userSettings) {
     const isFirstRun = !!firstRun;
     this.stylesHandler.useTheme(themeName);
     const validThemeName = this.stylesHandler.getThemeName();
-    if (!isFirstRun) {
-      instance.render();
-      instance.scrollViewportTo(0, 0);
+    if (!isFirstRun && validThemeName) {
       if ((0, _themes.getThemeClassName)(this.rootContainer)) {
         (0, _element.removeClass)(this.rootContainer, /ht-theme-.*/g);
-        if (validThemeName) {
-          (0, _element.addClass)(this.rootContainer, validThemeName);
-        }
+        (0, _element.addClass)(this.rootContainer, validThemeName);
       }
+      instance.render();
+      instance.scrollViewportTo(0, 0);
     }
     this.runHooks('afterSetTheme', validThemeName, isFirstRun);
   };
@@ -4959,51 +5027,66 @@ function Core(rootContainer, userSettings) {
       clearTimeout(handler);
     });
   };
-  this.immediates = [];
+  this.microtasks = [];
 
   /**
-   * Execute function execution to the next event loop cycle. Purpose of this method is to clear all known timeouts when `destroy` method is called.
+   * Execute function execution to the next event loop cycle.
    *
    * @param {Function} callback Function to be delayed in execution.
    * @private
    */
-  this._registerImmediate = function (callback) {
-    this.immediates.push(setImmediate(callback));
+  this._registerMicrotask = function (callback) {
+    const entry = {
+      cancelled: false
+    };
+    this.microtasks.push(entry);
+    this.rootWindow.queueMicrotask(() => {
+      if (!entry.cancelled) {
+        callback();
+      }
+    });
   };
 
   /**
-   * Clears all known timeouts.
+   * Clears all known microtasks (prevents pending callbacks from running).
    *
    * @private
    */
-  this._clearImmediates = function () {
-    (0, _array.arrayEach)(this.immediates, handler => {
-      clearImmediate(handler);
+  this._clearMicrotasks = function () {
+    (0, _array.arrayEach)(this.microtasks, entry => {
+      entry.cancelled = true;
     });
+    this.microtasks.length = 0;
   };
 
   /**
-   * Registers a microtask callback.
+   * Gets the instance of the EditorManager.
    *
-   * @param {Function} callback Function to be delayed in execution.
    * @private
+   * @returns {EditorManager}
    */
-  this._registerMicrotask = function (callback) {
-    this.rootWindow.queueMicrotask(() => {
-      if (!this.isDestroyed) {
-        callback();
-      }
-    });
+  this._getEditorManager = function () {
+    return editorManager;
   };
 
   /**
-   * Gets the instance of the EditorManager.
+   * Gets the instance of the DataSource.
    *
    * @private
-   * @returns {EditorManager}
+   * @returns {DataSource}
    */
-  this._getEditorManager = function () {
-    return editorManager;
+  this._getDataSource = function () {
+    return dataSource;
+  };
+
+  /**
+   * Gets the instance of the MetaManager.
+   *
+   * @private
+   * @returns {MetaManager}
+   */
+  this._getMetaManager = function () {
+    return metaManager;
   };
   const shortcutManager = (0, _shortcuts.createShortcutManager)({
     handleEvent() {
@@ -5077,10 +5160,16 @@ function Core(rootContainer, userSettings) {
    */
   this.getFocusScopeManager = function () {
     if (!(0, _rootInstance.isRootInstance)(instance)) {
-      throw new Error('The FocusScopeManager is only available for the main Handsontable instance.');
+      (0, _errors.throwWithCause)('The FocusScopeManager is only available for the main Handsontable instance.');
     }
     return focusScopeManager;
   };
+  const theme = mergedUserSettings.theme;
+  const themeName = mergedUserSettings.themeName;
+  const rootContainerThemeClassName = (0, _themes.getThemeClassName)(instance.rootContainer);
+  if ((0, _rootInstance.isRootInstance)(instance) && !rootContainerThemeClassName && ((0, _object.isObject)(theme) || !theme && !themeName)) {
+    initializeThemeManager(theme);
+  }
   (0, _registry.getPluginsNames)().forEach(pluginName => {
     const PluginClass = (0, _registry.getPlugin)(pluginName);
     pluginsRegistry.addItem(pluginName, new PluginClass(this));