handsontable 16.2.0 → 17.0.0-rc1

package/core.mjs

@@ -1,18 +1,3 @@
-import "core-js/modules/es.error.cause.js";
-import "core-js/modules/es.array.push.js";
-import "core-js/modules/es.object.from-entries.js";
-import "core-js/modules/es.set.difference.v2.js";
-import "core-js/modules/es.set.intersection.v2.js";
-import "core-js/modules/es.set.is-disjoint-from.v2.js";
-import "core-js/modules/es.set.is-subset-of.v2.js";
-import "core-js/modules/es.set.is-superset-of.v2.js";
-import "core-js/modules/es.set.symmetric-difference.v2.js";
-import "core-js/modules/es.set.union.v2.js";
-import "core-js/modules/esnext.iterator.constructor.js";
-import "core-js/modules/esnext.iterator.filter.js";
-import "core-js/modules/esnext.iterator.for-each.js";
-import "core-js/modules/esnext.iterator.map.js";
-import "core-js/modules/web.immediate.js";
 import { addClass, empty, observeVisibilityChangeOnce, removeClass } from "./helpers/dom/element.mjs";
 import { isFunction } from "./helpers/function.mjs";
 import { isDefined, isUndefined, isRegExp, _injectProductInfo, isEmpty } from "./helpers/mixed.mjs";
@@ -30,7 +15,6 @@ import { getValidator } from "./validators/registry.mjs";
 import { randomString, toUpperCaseFirst } from "./helpers/string.mjs";
 import { rangeEach, rangeEachReverse } from "./helpers/number.mjs";
 import TableView from "./tableView.mjs";
-import DataSource from "./dataMap/dataSource.mjs";
 import { spreadsheetColumnLabel } from "./helpers/data.mjs";
 import { IndexMapper } from "./translations/index.mjs";
 import { registerAsRootInstance, hasValidParameter, isRootInstance } from "./utils/rootInstance.mjs";
@@ -38,7 +22,7 @@ import { DEFAULT_COLUMN_WIDTH } from "./3rdparty/walkontable/src/index.mjs";
 import { hasLanguageDictionary, getValidLanguageCode, getTranslatedPhrase } from "./i18n/registry.mjs";
 import { warnUserAboutLanguageRegistration, normalizeLanguageCode } from "./i18n/utils.mjs";
 import { Selection } from "./selection/index.mjs";
-import { MetaManager, DynamicCellMetaMod, ExtendMetaPropertiesMod, replaceData } from "./dataMap/index.mjs";
+import { DataSource, MetaManager, DynamicCellMetaMod, ExtendMetaPropertiesMod, replaceData, runSourceDataValidator, runSourceDataValidators } from "./dataMap/index.mjs";
 import { createViewportScroller, Hooks, CellRangeToRenderableMapper } from "./core/index.mjs";
 import { FocusGridManager, createFocusScopeManager, registerAllFocusScopes } from "./focusManager/index.mjs";
 import { createUniqueMap } from "./utils/dataStructures/uniqueMap.mjs";
@@ -46,18 +30,14 @@ import { createShortcutManager } from "./shortcuts/index.mjs";
 import { registerAllShortcutContexts } from "./shortcutContexts/index.mjs";
 import { getThemeClassName } from "./helpers/themes.mjs";
 import { StylesHandler } from "./utils/stylesHandler.mjs";
-import { deprecatedWarn, warn } from "./helpers/console.mjs";
+import { warn } from "./helpers/console.mjs";
+import { throwWithCause } from "./helpers/errors.mjs";
 import { install as installAccessibilityAnnouncer, uninstall as uninstallAccessibilityAnnouncer } from "./utils/a11yAnnouncer.mjs";
 import { getValueSetterValue } from "./utils/valueAccessors.mjs";
+import { createThemeManager } from "./themes/engine/index.mjs";
+import { getTheme, hasTheme, registerTheme, mainTheme } from "./themes/index.mjs";
 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
@@ -140,7 +120,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 {
@@ -338,21 +318,29 @@ export default function Core(rootContainer, userSettings) {
     hot: instance,
     rootElement: instance.rootElement,
     rootDocument: instance.rootDocument,
-    onThemeChange: validThemeName => {
+    onThemeChange: themeName => {
       if (isRootInstance(this)) {
         removeClass(this.rootWrapperElement, /ht-theme-.*/g);
         removeClass(this.rootPortalElement, /ht-theme-.*/g);
-        if (validThemeName) {
-          addClass(this.rootWrapperElement, validThemeName);
-          addClass(this.rootPortalElement, validThemeName);
+        if (themeName) {
+          addClass(this.rootWrapperElement, themeName);
+          addClass(this.rootPortalElement, themeName);
           if (!getComputedStyle(this.rootWrapperElement).getPropertyValue('--ht-line-height')) {
-            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.`);
+            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 = getValidLanguageCode(mergedUserSettings.language);
   const settingsWithoutHooks = Object.fromEntries(Object.entries(mergedUserSettings).filter(_ref => {
     let [key] = _ref;
@@ -501,7 +489,9 @@ export default 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();
@@ -521,10 +511,10 @@ export default function Core(rootContainer, userSettings) {
     } else {
       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();
     }
@@ -873,7 +863,7 @@ export default function Core(rootContainer, userSettings) {
           }
           break;
         default:
-          throw new Error(`There is no such action "${action}"`);
+          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
@@ -1117,6 +1107,12 @@ export default 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 = duckSchema(Array.isArray(orgValue) ? orgValue : orgValue[0] || orgValue);
                   const valueSchema = duckSchema(Array.isArray(value) ? value : value[0] || value);
@@ -1210,7 +1206,7 @@ export default function Core(rootContainer, userSettings) {
     focusGridManager.init();
     if (isRootInstance(this)) {
       installAccessibilityAnnouncer(instance.rootPortalElement);
-      _injectProductInfo(mergedUserSettings.licenseKey, this.rootWrapperElement);
+      _injectProductInfo(mergedUserSettings.licenseKey, this.rootWrapperElement, "20/02/2026");
     }
     instance.runHooks('init');
     this.render();
@@ -1231,6 +1227,31 @@ export default 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 (hasTheme('main')) {
+        themeObject = getTheme('main');
+      } else {
+        themeObject = registerTheme(mainTheme);
+      }
+      themeObject = getTheme('main');
+    } else if (typeof theme.getThemeConfig !== 'function') {
+      themeObject = registerTheme(theme);
+    } else {
+      themeObject = theme;
+    }
+    instance.themeManager = createThemeManager({
+      hot: instance,
+      themeObject
+    });
+  }
+
   /**
    * @ignore
    * @returns {object}
@@ -1274,7 +1295,7 @@ export default 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
@@ -1299,7 +1320,7 @@ export default 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');
+              throwWithCause('Validation error: result is not boolean');
             }
             if (result === false && cellPropertiesReference.allowInvalid === false) {
               shouldBeCanceled = false;
@@ -1370,15 +1391,20 @@ export default 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 && isDefined(activeEditor.refreshValue)) {
         activeEditor.refreshValue();
       }
@@ -1466,7 +1492,7 @@ export default 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;
@@ -1480,7 +1506,7 @@ export default 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);
       });
@@ -1560,10 +1586,11 @@ export default 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');
+        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
+        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;
@@ -1701,7 +1728,7 @@ export default 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
+      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);
@@ -1791,7 +1818,7 @@ export default 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.
    */
@@ -2272,7 +2299,9 @@ export default 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,
@@ -2313,7 +2342,9 @@ export default function Core(rootContainer, userSettings) {
       metaManager.clearCellsCache();
       instance.initIndexMappers();
       grid.adjustRowsAndCols();
+      selection.markSource('loadData');
       selection.refresh();
+      selection.markEndSource();
       if (firstRun) {
         firstRun = [null, 'loadData'];
       }
@@ -2500,13 +2531,13 @@ export default function Core(rootContainer, userSettings) {
     let i;
     let j;
     if (isDefined(settings.rows)) {
-      throw new Error('The "rows" setting is no longer supported. Do you mean startRows, minRows or maxRows?');
+      throwWithCause('The "rows" setting is no longer supported. Do you mean startRows, minRows or maxRows?');
     }
     if (isDefined(settings.cols)) {
-      throw new Error('The "cols" setting is no longer supported. Do you mean startCols, minCols or maxCols?');
+      throwWithCause('The "cols" setting is no longer supported. Do you mean startCols, minCols or maxCols?');
     }
     if (isDefined(settings.ganttChart)) {
-      throw new Error('Since 8.0.0 the "ganttChart" setting is no longer supported.');
+      throwWithCause('Since 8.0.0 the "ganttChart" setting is no longer supported.');
     }
     if (isDefined(settings.rowHeights) && isDefined(settings.minRowHeights)) {
       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.');
@@ -2535,24 +2566,56 @@ export default function Core(rootContainer, userSettings) {
         globalMeta[i] = settings[i];
       }
     }
+    const rootContainerThemeClassName = getThemeClassName(instance.rootContainer);
+    const themeNameOptionExists = hasOwnProperty(settings, 'themeName');
+    const themeOptionExists = hasOwnProperty(settings, 'theme');
+    if (themeNameOptionExists && themeOptionExists) {
+      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 || 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 = 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 (isRootInstance(instance) && !rootContainerThemeClassName && 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 (isRootInstance(instance) && !deprecatedWarnInstances.has(instance) && instance.stylesHandler.isClassicTheme()) {
-      // eslint-disable-next-line max-len
-      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) {
@@ -2598,6 +2661,12 @@ export default 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) {
+      runSourceDataValidators(instance, 'init');
+    }
     let currentHeight = instance.rootElement.style.height;
     if (currentHeight !== '') {
       currentHeight = parseInt(instance.rootElement.style.height, 10);
@@ -2624,7 +2693,7 @@ export default 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') {
@@ -3097,8 +3166,11 @@ export default function Core(rootContainer, userSettings) {
     }
     arrayEach(input, _ref0 => {
       let [changeRow, changeProp, changeValue] = _ref0;
-      const newValue = getValueSetterValue(changeValue, getCellProperties(changeRow, changeProp));
-      dataSource.setAtCell(changeRow, changeProp, newValue);
+      const cellMeta = getCellProperties(changeRow, changeProp);
+      const newValue = getValueSetterValue(changeValue, cellMeta);
+      if (runSourceDataValidator(newValue, cellMeta, source !== null && source !== void 0 ? source : 'setSourceDataAtCell')) {
+        dataSource.setAtCell(changeRow, changeProp, newValue);
+      }
     });
     if (isThereAnySetSourceListener) {
       this.runHooks('afterSetSourceDataAtCell', changesForHook, source);
@@ -3239,7 +3311,7 @@ export default 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.');
+      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);
@@ -3505,7 +3577,7 @@ export default function Core(rootContainer, userSettings) {
    */
   this.validateRows = function (rows, callback) {
     if (!Array.isArray(rows)) {
-      throw new Error('validateRows parameter `rows` must be an array');
+      throwWithCause('validateRows parameter `rows` must be an array');
     }
     this._validateCells(callback, rows);
   };
@@ -3531,7 +3603,7 @@ export default function Core(rootContainer, userSettings) {
    */
   this.validateColumns = function (columns, callback) {
     if (!Array.isArray(columns)) {
-      throw new Error('validateColumns parameter `columns` must be an array');
+      throwWithCause('validateColumns parameter `columns` must be an array');
     }
     this._validateCells(callback, undefined, columns);
   };
@@ -3570,7 +3642,7 @@ export default 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');
+            throwWithCause('Validation error: result is not boolean');
           }
           if (result === false) {
             waitingForValidator.valid = false;
@@ -4440,7 +4512,7 @@ export default 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();
@@ -4450,8 +4522,10 @@ export default function Core(rootContainer, userSettings) {
     }
     dataSource = null;
     if (isRootInstance(this)) {
+      var _instance$themeManage3;
       uninstallAccessibilityAnnouncer();
       this.getFocusScopeManager().destroy();
+      (_instance$themeManage3 = instance.themeManager) === null || _instance$themeManage3 === void 0 || _instance$themeManage3.destroy();
     }
     this.getShortcutManager().destroy();
     moduleRegisterer.clear();
@@ -4514,7 +4588,7 @@ export default function Core(rootContainer, userSettings) {
    */
   function postMortem(method) {
     return () => {
-      throw new Error(`The "${method}" method cannot be called because this Handsontable instance has been destroyed`);
+      throwWithCause(`The "${method}" method cannot be called because this Handsontable instance has been destroyed`);
     };
   }
 
@@ -4702,10 +4776,6 @@ export default 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);
   };
 
@@ -4878,15 +4948,13 @@ export default 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 (getThemeClassName(this.rootContainer)) {
         removeClass(this.rootContainer, /ht-theme-.*/g);
-        if (validThemeName) {
-          addClass(this.rootContainer, validThemeName);
-        }
+        addClass(this.rootContainer, validThemeName);
       }
+      instance.render();
+      instance.scrollViewportTo(0, 0);
     }
     this.runHooks('afterSetTheme', validThemeName, isFirstRun);
   };
@@ -4954,51 +5022,66 @@ export default 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 () {
-    arrayEach(this.immediates, handler => {
-      clearImmediate(handler);
+  this._clearMicrotasks = function () {
+    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 = createShortcutManager({
     handleEvent() {
@@ -5072,10 +5155,16 @@ export default function Core(rootContainer, userSettings) {
    */
   this.getFocusScopeManager = function () {
     if (!isRootInstance(instance)) {
-      throw new Error('The FocusScopeManager is only available for the main Handsontable instance.');
+      throwWithCause('The FocusScopeManager is only available for the main Handsontable instance.');
     }
     return focusScopeManager;
   };
+  const theme = mergedUserSettings.theme;
+  const themeName = mergedUserSettings.themeName;
+  const rootContainerThemeClassName = getThemeClassName(instance.rootContainer);
+  if (isRootInstance(instance) && !rootContainerThemeClassName && (isObject(theme) || !theme && !themeName)) {
+    initializeThemeManager(theme);
+  }
   getPluginsNames().forEach(pluginName => {
     const PluginClass = getPlugin(pluginName);
     pluginsRegistry.addItem(pluginName, new PluginClass(this));

package/dataMap/dataMap.js

@@ -1,11 +1,6 @@
 "use strict";
 
 exports.__esModule = true;
-require("core-js/modules/es.error.cause.js");
-require("core-js/modules/es.array.push.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");
 var _SheetClip = require("../3rdparty/SheetClip");
 var _data = require("../helpers/data");
 var _object = require("../helpers/object");
@@ -13,6 +8,7 @@ var _array = require("../helpers/array");
 var _number = require("../helpers/number");
 var _mixed = require("../helpers/mixed");
 var _valueAccessors = require("../utils/valueAccessors");
+var _errors = require("../helpers/errors");
 function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
 function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
@@ -128,7 +124,7 @@ class DataMap {
   createMap() {
     const schema = this.getSchema();
     if (typeof schema === 'undefined') {
-      throw new Error('trying to create `columns` definition but you didn\'t provide `schema` nor `data`');
+      (0, _errors.throwWithCause)('trying to create `columns` definition but you didn\'t provide `schema` nor `data`');
     }
     const columns = this.tableMeta.columns;
     let i;
@@ -383,7 +379,9 @@ class DataMap {
       mode = 'start'
     } = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
     if (!this.hot.isColumnModificationAllowed()) {
-      throw new Error('Cannot create new column. When data source in an object, ' + 'you can only have as much columns as defined in first data row, data schema or in the \'columns\' setting.' + 'If you want to be able to add new columns, you have to use array datasource.');
+      (0, _errors.throwWithCause)('Cannot create new column. When data source in an object, ' +
+      // eslint-disable-next-line max-len
+      'you can only have as much columns as defined in first data row, data schema or in the \'columns\' setting.' + 'If you want to be able to add new columns, you have to use array datasource.');
     }
     const dataSource = this.dataSource;
     const maxCols = this.tableMeta.maxCols;
@@ -492,7 +490,7 @@ class DataMap {
     let amount = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 1;
     let source = arguments.length > 2 ? arguments[2] : undefined;
     if (this.hot.dataType === 'object' || this.tableMeta.columns) {
-      throw new Error('cannot remove column with object data source or columns option specified');
+      (0, _errors.throwWithCause)('cannot remove column with object data source or columns option specified');
     }
     let columnIndex = typeof index !== 'number' ? -amount : index;
     columnIndex = (this.hot.countCols() + columnIndex) % this.hot.countCols();