handsontable 16.0.1 → 16.1.0-next-abd8f2e-20250904

package/plugins/autoRowSize/autoRowSize.mjs

@@ -21,9 +21,11 @@ import { valueAccordingPercent, rangeEach } from "../../helpers/number.mjs";
 import SamplesGenerator from "../../utils/samplesGenerator.mjs";
 import { isPercentValue } from "../../helpers/string.mjs";
 import { PhysicalIndexToValueMap as IndexToValueMap } from "../../translations/index.mjs";
+import { addClass, removeClass } from "../../helpers/dom/element.mjs";
 export const PLUGIN_KEY = 'autoRowSize';
 export const PLUGIN_PRIORITY = 40;
 const ROW_WIDTHS_MAP_NAME = 'autoRowSize';
+const FIRST_COLUMN_NOT_RENDERED_CLASS_NAME = 'htFirstDatasetColumnNotRendered';
 
 /* eslint-disable jsdoc/require-description-complete-sentence */
 /**
@@ -210,9 +212,8 @@ export class AutoRowSize extends BasePlugin {
      * @type {SamplesGenerator}
      */
     _defineProperty(this, "samplesGenerator", new SamplesGenerator((row, column) => {
-      const physicalRow = this.hot.toPhysicalRow(row);
       const physicalColumn = this.hot.toPhysicalColumn(column);
-      if (this.hot.rowIndexMapper.isHidden(physicalRow) || this.hot.columnIndexMapper.isHidden(physicalColumn)) {
+      if (this.hot.columnIndexMapper.isHidden(physicalColumn)) {
         return false;
       }
       if (row >= 0 && column >= 0) {
@@ -313,6 +314,7 @@ export class AutoRowSize extends BasePlugin {
       }
       return _assertClassBrand(_AutoRowSize_brand, _this, _onAfterFormulasValuesUpdate).call(_this, ...args);
     });
+    this.addHook('beforeViewRender', () => _assertClassBrand(_AutoRowSize_brand, this, _onBeforeViewRender).call(this));
     this.addHook('beforeRender', () => _assertClassBrand(_AutoRowSize_brand, this, _onBeforeRender).call(this));
     this.addHook('modifyRowHeight', (height, row) => this.getRowHeight(row, height));
     this.addHook('init', () => _assertClassBrand(_AutoRowSize_brand, this, _onInit).call(this));
@@ -327,6 +329,9 @@ export class AutoRowSize extends BasePlugin {
     this.headerHeight = null;
     super.disablePlugin();
 
+    // Remove the "first dataset column not rendered" class name when the plugin is disabled.
+    _assertClassBrand(_AutoRowSize_brand, this, _toggleFirstDatasetColumnRenderedClassName).call(this, false);
+
     // Leave the listener active to allow auto-sizing the rows when the plugin is disabled.
     // This is necessary for height recalculation for resize handler doubleclick (ManualRowResize).
     this.addHook('beforeRowResize', (size, row, isDblClick) => _assertClassBrand(_AutoRowSize_brand, this, _onBeforeRowResize).call(this, size, row, isDblClick));
@@ -514,10 +519,19 @@ export class AutoRowSize extends BasePlugin {
    * @param {number} [defaultHeight] If no height is found, `defaultHeight` is returned instead.
    * @returns {number} The height of the specified row, in pixels.
    */
-  getRowHeight(row, defaultHeight) {
-    const cachedHeight = row < 0 ? this.headerHeight : this.rowHeightsMap.getValueAtIndex(this.hot.toPhysicalRow(row));
+  getRowHeight(row) {
+    let defaultHeight = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : this.hot.stylesHandler.getDefaultRowHeight();
+    if (row < 0) {
+      var _this$headerHeight;
+      return (_this$headerHeight = this.headerHeight) !== null && _this$headerHeight !== void 0 ? _this$headerHeight : defaultHeight;
+    }
+    const physicalRow = this.hot.toPhysicalRow(row);
+    if (this.hot.rowIndexMapper.isHidden(physicalRow)) {
+      return defaultHeight;
+    }
+    const cachedHeight = this.rowHeightsMap.getValueAtIndex(physicalRow);
     let height = defaultHeight;
-    if (cachedHeight !== null && cachedHeight > (defaultHeight || 0)) {
+    if (cachedHeight !== null && cachedHeight > defaultHeight) {
       height = cachedHeight;
     }
     return height;
@@ -601,7 +615,10 @@ export class AutoRowSize extends BasePlugin {
   }
 
   /**
-   * On before view render listener.
+   * Toggles the "first dataset column not rendered" class name.
+   * Used to apply special styling when the first column is visible (used only in the classic (legacy) theme, with the AutoRowSize plugin enabled).
+   *
+   * @param {boolean} [forceState] Force the class to be added or removed (`true` to add, `false` to remove).
    */
 
   /**
@@ -633,6 +650,26 @@ function _calculateSpecificRowsHeight(visualRows) {
     this.ghostTable.clean();
   }
 }
+function _toggleFirstDatasetColumnRenderedClassName(forceState) {
+  if (this.hot.stylesHandler.isClassicTheme()) {
+    const firstRenderedColumnVisualIndex = this.hot.getFirstRenderedVisibleColumn();
+    const firstRenderedColumnPhysicalIndex = this.hot.columnIndexMapper.getPhysicalFromVisualIndex(firstRenderedColumnVisualIndex);
+    if (forceState === false || firstRenderedColumnPhysicalIndex === this.hot.columnIndexMapper.getPhysicalFromRenderableIndex(0)) {
+      removeClass(this.hot.rootElement, FIRST_COLUMN_NOT_RENDERED_CLASS_NAME);
+    } else {
+      addClass(this.hot.rootElement, FIRST_COLUMN_NOT_RENDERED_CLASS_NAME);
+    }
+  }
+}
+/**
+ * `beforeViewRender` hook listener.
+ */
+function _onBeforeViewRender() {
+  _assertClassBrand(_AutoRowSize_brand, this, _toggleFirstDatasetColumnRenderedClassName).call(this);
+}
+/**
+ * `beforeRender` hook listener.
+ */
 function _onBeforeRender() {
   this.calculateVisibleRowsHeight();
   if (!this.inProgress) {

package/plugins/autofill/autofill.js

@@ -3,9 +3,12 @@
 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.some.js");
 var _base = require("../base");
 var _hooks = require("../../core/hooks");
 var _element = require("../../helpers/dom/element");
+var _object = require("../../helpers/object");
 var _array = require("../../helpers/array");
 var _mixed = require("../../helpers/mixed");
 var _utils = require("./utils");
@@ -43,9 +46,13 @@ class Autofill extends _base.BasePlugin {
   constructor() {
     super(...arguments);
     /**
-     * On cell corner double click callback.
+     * Extends the fill data with the source data based on the content of the target cells.
      *
-     * @private
+     * @param {Array} fillData The fill data to extend.
+     * @param {Array} selectionSourceData The source data to extend the fill data with.
+     * @param {CellCoords} startOfDragCoords The start of the drag area.
+     * @param {CellCoords} endOfDragCoords The end of the drag area.
+     * @returns {Array} The extended fill data.
      */
     _classPrivateMethodInitSpec(this, _Autofill_brand);
     /**
@@ -149,9 +156,11 @@ class Autofill extends _base.BasePlugin {
    * Gets selection data.
    *
    * @private
+   * @param {boolean} [useSource=false] If `true`, returns copyable source data instead of copyable data.
    * @returns {object[]} Ranges Array of objects with properties `startRow`, `startCol`, `endRow` and `endCol`.
    */
   getSelectionData() {
+    let useSource = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
     const selection = this.hot.getSelectedRangeLast();
     const {
       row: startRow,
@@ -185,7 +194,12 @@ class Autofill extends _base.BasePlugin {
     (0, _array.arrayEach)(copyableRows, row => {
       const rowSet = [];
       (0, _array.arrayEach)(copyableColumns, column => {
-        rowSet.push(this.hot.getCopyableData(row, column));
+        const sourceDataAtSource = useSource ? this.hot.getSourceDataAtCell(row, column) : null;
+        if (useSource && (0, _object.isObject)(sourceDataAtSource)) {
+          rowSet.push(this.hot.getCopyableSourceData(row, column));
+        } else {
+          rowSet.push(this.hot.getCopyableData(row, column));
+        }
       });
       data.push(rowSet);
     });
@@ -224,6 +238,7 @@ class Autofill extends _base.BasePlugin {
     } = (0, _utils.getDragDirectionAndRange)(cornersOfSelectedCells, cornersOfSelectionAndDragAreas, (row, column) => this.hot._createCellCoords(row, column));
     if (startOfDragCoords && startOfDragCoords.row > -1 && startOfDragCoords.col > -1) {
       const selectionData = this.getSelectionData();
+      const selectionSourceData = this.getSelectionData(true);
       const sourceRange = selectionRangeLast.clone();
       const targetRange = this.hot._createCellRange(startOfDragCoords, startOfDragCoords, endOfDragCoords);
       const beforeAutofillHookResult = this.hot.runHooks('beforeAutofill', selectionData, sourceRange, targetRange, directionOfDrag);
@@ -253,6 +268,14 @@ class Autofill extends _base.BasePlugin {
           }
         }
       }
+
+      // If the source data contains objects, we need to check every target cell for the data type.
+      if (selectionSourceData.some(row => row.some(cell => (0, _object.isObject)(cell)))) {
+        const fullFillData = _assertClassBrand(_Autofill_brand, this, _extendFillDataWithSourceData).call(this, fillData, selectionSourceData, startOfDragCoords, endOfDragCoords, directionOfDrag);
+        if (fullFillData.length) {
+          fillData = fullFillData;
+        }
+      }
       this.hot.populateFromArray(startOfDragCoords.row, startOfDragCoords.col, fillData, endOfDragCoords.row, endOfDragCoords.col, `${this.pluginName}.fill`, null);
       this.setSelection(cornersOfSelectionAndDragAreas);
       this.hot.runHooks('afterAutofill', fillData, sourceRange, targetRange, directionOfDrag);
@@ -496,6 +519,30 @@ class Autofill extends _base.BasePlugin {
   }
 }
 exports.Autofill = Autofill;
+function _extendFillDataWithSourceData(fillData, selectionSourceData, startOfDragCoords, endOfDragCoords) {
+  const fullFillData = [];
+  for (let rowIndex = Math.min(startOfDragCoords.row, endOfDragCoords.row); rowIndex <= Math.max(startOfDragCoords.row, endOfDragCoords.row); rowIndex += 1) {
+    fullFillData.push([]);
+    for (let columnIndex = Math.min(startOfDragCoords.col, endOfDragCoords.col); columnIndex <= Math.max(startOfDragCoords.col, endOfDragCoords.col); columnIndex += 1) {
+      const sourceCell = this.hot.getSourceDataAtCell(rowIndex, columnIndex);
+      const relativeRowIndex = rowIndex - Math.min(startOfDragCoords.row, endOfDragCoords.row);
+      const relativeColumnIndex = columnIndex - Math.min(startOfDragCoords.col, endOfDragCoords.col);
+      const modRelativeRowIndex = relativeRowIndex % selectionSourceData.length;
+      const modRelativeColumnIndex = relativeColumnIndex % selectionSourceData[0].length;
+      if ((0, _object.isObject)(sourceCell)) {
+        fullFillData[relativeRowIndex][relativeColumnIndex] = selectionSourceData[modRelativeRowIndex][modRelativeColumnIndex];
+      } else {
+        fullFillData[relativeRowIndex][relativeColumnIndex] = fillData[modRelativeRowIndex][modRelativeColumnIndex];
+      }
+    }
+  }
+  return fullFillData;
+}
+/**
+ * On cell corner double click callback.
+ *
+ * @private
+ */
 function _onCellCornerDblClick() {
   const selectionApplied = this.selectAdjacent();
   if (selectionApplied) {

package/plugins/autofill/autofill.mjs

@@ -1,5 +1,7 @@
 import "core-js/modules/es.error.cause.js";
 import "core-js/modules/es.array.push.js";
+import "core-js/modules/esnext.iterator.constructor.js";
+import "core-js/modules/esnext.iterator.some.js";
 function _classPrivateMethodInitSpec(e, a) { _checkPrivateRedeclaration(e, a), a.add(e); }
 function _checkPrivateRedeclaration(e, t) { if (t.has(e)) throw new TypeError("Cannot initialize the same private elements twice on an object"); }
 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; }
@@ -9,6 +11,7 @@ function _assertClassBrand(e, t, n) { if ("function" == typeof e ? e === t : e.h
 import { BasePlugin } from "../base/index.mjs";
 import { Hooks } from "../../core/hooks/index.mjs";
 import { offset, outerHeight, outerWidth } from "../../helpers/dom/element.mjs";
+import { isObject } from "../../helpers/object.mjs";
 import { arrayEach, arrayMap } from "../../helpers/array.mjs";
 import { isEmpty } from "../../helpers/mixed.mjs";
 import { getDragDirectionAndRange, DIRECTIONS, getMappedFillHandleSetting } from "./utils.mjs";
@@ -40,9 +43,13 @@ export class Autofill extends BasePlugin {
   constructor() {
     super(...arguments);
     /**
-     * On cell corner double click callback.
+     * Extends the fill data with the source data based on the content of the target cells.
      *
-     * @private
+     * @param {Array} fillData The fill data to extend.
+     * @param {Array} selectionSourceData The source data to extend the fill data with.
+     * @param {CellCoords} startOfDragCoords The start of the drag area.
+     * @param {CellCoords} endOfDragCoords The end of the drag area.
+     * @returns {Array} The extended fill data.
      */
     _classPrivateMethodInitSpec(this, _Autofill_brand);
     /**
@@ -146,9 +153,11 @@ export class Autofill extends BasePlugin {
    * Gets selection data.
    *
    * @private
+   * @param {boolean} [useSource=false] If `true`, returns copyable source data instead of copyable data.
    * @returns {object[]} Ranges Array of objects with properties `startRow`, `startCol`, `endRow` and `endCol`.
    */
   getSelectionData() {
+    let useSource = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
     const selection = this.hot.getSelectedRangeLast();
     const {
       row: startRow,
@@ -182,7 +191,12 @@ export class Autofill extends BasePlugin {
     arrayEach(copyableRows, row => {
       const rowSet = [];
       arrayEach(copyableColumns, column => {
-        rowSet.push(this.hot.getCopyableData(row, column));
+        const sourceDataAtSource = useSource ? this.hot.getSourceDataAtCell(row, column) : null;
+        if (useSource && isObject(sourceDataAtSource)) {
+          rowSet.push(this.hot.getCopyableSourceData(row, column));
+        } else {
+          rowSet.push(this.hot.getCopyableData(row, column));
+        }
       });
       data.push(rowSet);
     });
@@ -221,6 +235,7 @@ export class Autofill extends BasePlugin {
     } = getDragDirectionAndRange(cornersOfSelectedCells, cornersOfSelectionAndDragAreas, (row, column) => this.hot._createCellCoords(row, column));
     if (startOfDragCoords && startOfDragCoords.row > -1 && startOfDragCoords.col > -1) {
       const selectionData = this.getSelectionData();
+      const selectionSourceData = this.getSelectionData(true);
       const sourceRange = selectionRangeLast.clone();
       const targetRange = this.hot._createCellRange(startOfDragCoords, startOfDragCoords, endOfDragCoords);
       const beforeAutofillHookResult = this.hot.runHooks('beforeAutofill', selectionData, sourceRange, targetRange, directionOfDrag);
@@ -250,6 +265,14 @@ export class Autofill extends BasePlugin {
           }
         }
       }
+
+      // If the source data contains objects, we need to check every target cell for the data type.
+      if (selectionSourceData.some(row => row.some(cell => isObject(cell)))) {
+        const fullFillData = _assertClassBrand(_Autofill_brand, this, _extendFillDataWithSourceData).call(this, fillData, selectionSourceData, startOfDragCoords, endOfDragCoords, directionOfDrag);
+        if (fullFillData.length) {
+          fillData = fullFillData;
+        }
+      }
       this.hot.populateFromArray(startOfDragCoords.row, startOfDragCoords.col, fillData, endOfDragCoords.row, endOfDragCoords.col, `${this.pluginName}.fill`, null);
       this.setSelection(cornersOfSelectionAndDragAreas);
       this.hot.runHooks('afterAutofill', fillData, sourceRange, targetRange, directionOfDrag);
@@ -492,6 +515,30 @@ export class Autofill extends BasePlugin {
     super.destroy();
   }
 }
+function _extendFillDataWithSourceData(fillData, selectionSourceData, startOfDragCoords, endOfDragCoords) {
+  const fullFillData = [];
+  for (let rowIndex = Math.min(startOfDragCoords.row, endOfDragCoords.row); rowIndex <= Math.max(startOfDragCoords.row, endOfDragCoords.row); rowIndex += 1) {
+    fullFillData.push([]);
+    for (let columnIndex = Math.min(startOfDragCoords.col, endOfDragCoords.col); columnIndex <= Math.max(startOfDragCoords.col, endOfDragCoords.col); columnIndex += 1) {
+      const sourceCell = this.hot.getSourceDataAtCell(rowIndex, columnIndex);
+      const relativeRowIndex = rowIndex - Math.min(startOfDragCoords.row, endOfDragCoords.row);
+      const relativeColumnIndex = columnIndex - Math.min(startOfDragCoords.col, endOfDragCoords.col);
+      const modRelativeRowIndex = relativeRowIndex % selectionSourceData.length;
+      const modRelativeColumnIndex = relativeColumnIndex % selectionSourceData[0].length;
+      if (isObject(sourceCell)) {
+        fullFillData[relativeRowIndex][relativeColumnIndex] = selectionSourceData[modRelativeRowIndex][modRelativeColumnIndex];
+      } else {
+        fullFillData[relativeRowIndex][relativeColumnIndex] = fillData[modRelativeRowIndex][modRelativeColumnIndex];
+      }
+    }
+  }
+  return fullFillData;
+}
+/**
+ * On cell corner double click callback.
+ *
+ * @private
+ */
 function _onCellCornerDblClick() {
   const selectionApplied = this.selectAdjacent();
   if (selectionApplied) {

package/plugins/base/base.js

@@ -13,13 +13,15 @@ var _registry3 = require("../../editors/registry");
 var _registry4 = require("../../renderers/registry");
 var _registry5 = require("../../validators/registry");
 var _eventManager = _interopRequireDefault(require("../../eventManager"));
+var _console = require("../../helpers/console");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 function _classPrivateMethodInitSpec(e, a) { _checkPrivateRedeclaration(e, a), a.add(e); }
-function _classPrivateFieldInitSpec(e, t, a) { _checkPrivateRedeclaration(e, t), t.set(e, a); }
-function _checkPrivateRedeclaration(e, t) { if (t.has(e)) throw new TypeError("Cannot initialize the same private elements twice on an object"); }
 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); }
+function _classPrivateFieldInitSpec(e, t, a) { _checkPrivateRedeclaration(e, t), t.set(e, a); }
+function _checkPrivateRedeclaration(e, t) { if (t.has(e)) throw new TypeError("Cannot initialize the same private elements twice on an object"); }
+function _classPrivateFieldSet(s, a, r) { return s.set(_assertClassBrand(s, a), r), r; }
 function _classPrivateFieldGet(s, a) { return s.get(_assertClassBrand(s, a)); }
 function _assertClassBrand(e, t, n) { if ("function" == typeof e ? e === t : e.has(t)) return arguments.length < 3 ? t : n; throw new TypeError("Private element is not present on this object"); }
 const DEPS_TYPE_CHECKERS = new Map([['plugin', _registry.hasPlugin], ['cell-type', _registry2.hasCellType], ['editor', _registry3.hasEditor], ['renderer', _registry4.hasRenderer], ['validator', _registry5.hasValidator]]);
@@ -32,6 +34,7 @@ let initializedPlugins = null;
  * @util
  * @property {Core} hot Handsontable instance.
  */
+var _pluginSettings = /*#__PURE__*/new WeakMap();
 var _hooks = /*#__PURE__*/new WeakMap();
 var _BasePlugin_brand = /*#__PURE__*/new WeakSet();
 class BasePlugin {
@@ -62,9 +65,18 @@ class BasePlugin {
   }
 
   /**
-   * The instance of the {@link EventManager} class.
+   * Validators for plugin settings.
    *
-   * @type {EventManager}
+   * @type {Function|object|null}
+   */
+  static get SETTINGS_VALIDATORS() {
+    return null;
+  }
+
+  /**
+   * Plugin settings.
+   *
+   * @type {object|null}
    */
 
   /**
@@ -81,6 +93,12 @@ class BasePlugin {
      * @returns {boolean}
      */
     _classPrivateMethodInitSpec(this, _BasePlugin_brand);
+    _classPrivateFieldInitSpec(this, _pluginSettings, null);
+    /**
+     * The instance of the {@link EventManager} class.
+     *
+     * @type {EventManager}
+     */
     _defineProperty(this, "eventManager", new _eventManager.default(this));
     /**
      * @type {string}
@@ -121,6 +139,7 @@ class BasePlugin {
   }
   init() {
     this.pluginName = this.hot.getPluginName(this);
+    this.updatePluginSettings(this.hot.getSettings()[this.constructor.PLUGIN_KEY]);
     const pluginDeps = this.constructor.PLUGIN_DEPS;
     const deps = Array.isArray(pluginDeps) ? pluginDeps : [];
     if (deps.length > 0) {
@@ -188,25 +207,75 @@ class BasePlugin {
    * @returns {*}
    */
   getSetting(settingName) {
-    const pluginSettings = this.hot.getSettings()[this.constructor.PLUGIN_KEY];
+    const defaultSettings = this.constructor.DEFAULT_SETTINGS;
     if (settingName === undefined) {
-      return pluginSettings;
+      if ((0, _object.isObject)(_classPrivateFieldGet(_pluginSettings, this))) {
+        return (0, _object.assignObjectDefaults)(_classPrivateFieldGet(_pluginSettings, this), defaultSettings);
+      }
+      return _classPrivateFieldGet(_pluginSettings, this);
     }
-    const defaultSettings = this.constructor.DEFAULT_SETTINGS;
-    if ((Array.isArray(pluginSettings) || (0, _object.isObject)(pluginSettings)) && defaultSettings[defaultMainSettingSymbol] === settingName) {
-      var _pluginSettings$setti;
-      if (Array.isArray(pluginSettings)) {
-        return pluginSettings;
+    if ((Array.isArray(_classPrivateFieldGet(_pluginSettings, this)) || (0, _object.isObject)(_classPrivateFieldGet(_pluginSettings, this))) && defaultSettings[defaultMainSettingSymbol] === settingName) {
+      var _classPrivateFieldGet2;
+      if (Array.isArray(_classPrivateFieldGet(_pluginSettings, this))) {
+        return _classPrivateFieldGet(_pluginSettings, this);
       }
-      return (_pluginSettings$setti = pluginSettings[settingName]) !== null && _pluginSettings$setti !== void 0 ? _pluginSettings$setti : defaultSettings[settingName];
+      return (_classPrivateFieldGet2 = _classPrivateFieldGet(_pluginSettings, this)[settingName]) !== null && _classPrivateFieldGet2 !== void 0 ? _classPrivateFieldGet2 : defaultSettings[settingName];
     }
-    if ((0, _object.isObject)(pluginSettings)) {
-      var _pluginSettings$setti2;
-      return (_pluginSettings$setti2 = pluginSettings[settingName]) !== null && _pluginSettings$setti2 !== void 0 ? _pluginSettings$setti2 : defaultSettings[settingName];
+    if (settingName.includes('.')) {
+      const pluginValue = (0, _object.getProperty)(_classPrivateFieldGet(_pluginSettings, this), settingName);
+      const defaultValue = (0, _object.getProperty)(defaultSettings, settingName);
+      if ((0, _object.isObject)(pluginValue)) {
+        return (0, _object.assignObjectDefaults)(pluginValue, defaultValue);
+      }
+      return pluginValue !== undefined ? pluginValue : defaultValue;
+    }
+    if ((0, _object.isObject)(_classPrivateFieldGet(_pluginSettings, this))) {
+      return (0, _object.assignObjectDefaults)(_classPrivateFieldGet(_pluginSettings, this), defaultSettings)[settingName];
     }
     return defaultSettings[settingName];
   }
 
+  /**
+   * Update plugin settings.
+   *
+   * @param {*} newSettings New settings.
+   * @returns {object} Updated settings object.
+   */
+  updatePluginSettings(newSettings) {
+    const settingsValidators = this.constructor.SETTINGS_VALIDATORS;
+    if (settingsValidators && typeof settingsValidators === 'function' && typeof newSettings !== 'object') {
+      const isValid = settingsValidators(newSettings);
+      if (isValid === false) {
+        (0, _console.warn)(`${this.pluginName} Plugin: option is not valid and it will be ignored.`);
+        return;
+      }
+      _classPrivateFieldSet(_pluginSettings, this, newSettings);
+      return _classPrivateFieldGet(_pluginSettings, this);
+    }
+    if (settingsValidators && typeof settingsValidators === 'object' && typeof newSettings === 'object') {
+      if (_classPrivateFieldGet(_pluginSettings, this) === null || typeof _classPrivateFieldGet(_pluginSettings, this) !== 'object') {
+        _classPrivateFieldSet(_pluginSettings, this, {
+          ...this.constructor.DEFAULT_SETTINGS
+        });
+      }
+      Object.keys(settingsValidators).forEach(key => {
+        if (!(key in newSettings)) {
+          return;
+        }
+        const validator = settingsValidators[key];
+        const isValid = validator ? validator(newSettings[key]) : true;
+        if (isValid === false) {
+          (0, _console.warn)(`${this.pluginName} Plugin: "${key}" option is not valid and it will be ignored.`);
+          return;
+        }
+        _classPrivateFieldGet(_pluginSettings, this)[key] = newSettings[key];
+      });
+      return _classPrivateFieldGet(_pluginSettings, this);
+    }
+    _classPrivateFieldSet(_pluginSettings, this, newSettings);
+    return newSettings;
+  }
+
   /**
    * Add listener to plugin hooks system.
    *
@@ -284,6 +353,7 @@ class BasePlugin {
         this.enablePlugin();
       }
       if (this.enabled && this.isEnabled() && relevantToSettings) {
+        this.updatePluginSettings(newSettings[this.constructor.PLUGIN_KEY]);
         this.updatePlugin(newSettings);
       }
     }
@@ -301,6 +371,7 @@ class BasePlugin {
    */
   destroy() {
     var _this$eventManager2;
+    _classPrivateFieldSet(_pluginSettings, this, null);
     (_this$eventManager2 = this.eventManager) === null || _this$eventManager2 === void 0 || _this$eventManager2.destroy();
     this.clearHooks();
     (0, _object.objectEach)(this, (value, property) => {

package/plugins/base/base.mjs

@@ -3,14 +3,15 @@ import "core-js/modules/es.array.push.js";
 import "core-js/modules/esnext.iterator.constructor.js";
 import "core-js/modules/esnext.iterator.for-each.js";
 function _classPrivateMethodInitSpec(e, a) { _checkPrivateRedeclaration(e, a), a.add(e); }
-function _classPrivateFieldInitSpec(e, t, a) { _checkPrivateRedeclaration(e, t), t.set(e, a); }
-function _checkPrivateRedeclaration(e, t) { if (t.has(e)) throw new TypeError("Cannot initialize the same private elements twice on an object"); }
 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); }
+function _classPrivateFieldInitSpec(e, t, a) { _checkPrivateRedeclaration(e, t), t.set(e, a); }
+function _checkPrivateRedeclaration(e, t) { if (t.has(e)) throw new TypeError("Cannot initialize the same private elements twice on an object"); }
+function _classPrivateFieldSet(s, a, r) { return s.set(_assertClassBrand(s, a), r), r; }
 function _classPrivateFieldGet(s, a) { return s.get(_assertClassBrand(s, a)); }
 function _assertClassBrand(e, t, n) { if ("function" == typeof e ? e === t : e.has(t)) return arguments.length < 3 ? t : n; throw new TypeError("Private element is not present on this object"); }
-import { defineGetter, objectEach, isObject } from "../../helpers/object.mjs";
+import { defineGetter, objectEach, isObject, assignObjectDefaults, getProperty } from "../../helpers/object.mjs";
 import { arrayEach } from "../../helpers/array.mjs";
 import { getPluginsNames, hasPlugin } from "../registry.mjs";
 import { hasCellType } from "../../cellTypes/registry.mjs";
@@ -18,6 +19,7 @@ import { hasEditor } from "../../editors/registry.mjs";
 import { hasRenderer } from "../../renderers/registry.mjs";
 import { hasValidator } from "../../validators/registry.mjs";
 import EventManager from "../../eventManager.mjs";
+import { warn } from "../../helpers/console.mjs";
 const DEPS_TYPE_CHECKERS = new Map([['plugin', hasPlugin], ['cell-type', hasCellType], ['editor', hasEditor], ['renderer', hasRenderer], ['validator', hasValidator]]);
 export const defaultMainSettingSymbol = Symbol('mainSetting');
 export const PLUGIN_KEY = 'base';
@@ -28,6 +30,7 @@ let initializedPlugins = null;
  * @util
  * @property {Core} hot Handsontable instance.
  */
+var _pluginSettings = /*#__PURE__*/new WeakMap();
 var _hooks = /*#__PURE__*/new WeakMap();
 var _BasePlugin_brand = /*#__PURE__*/new WeakSet();
 export class BasePlugin {
@@ -58,9 +61,18 @@ export class BasePlugin {
   }
 
   /**
-   * The instance of the {@link EventManager} class.
+   * Validators for plugin settings.
    *
-   * @type {EventManager}
+   * @type {Function|object|null}
+   */
+  static get SETTINGS_VALIDATORS() {
+    return null;
+  }
+
+  /**
+   * Plugin settings.
+   *
+   * @type {object|null}
    */
 
   /**
@@ -77,6 +89,12 @@ export class BasePlugin {
      * @returns {boolean}
      */
     _classPrivateMethodInitSpec(this, _BasePlugin_brand);
+    _classPrivateFieldInitSpec(this, _pluginSettings, null);
+    /**
+     * The instance of the {@link EventManager} class.
+     *
+     * @type {EventManager}
+     */
     _defineProperty(this, "eventManager", new EventManager(this));
     /**
      * @type {string}
@@ -117,6 +135,7 @@ export class BasePlugin {
   }
   init() {
     this.pluginName = this.hot.getPluginName(this);
+    this.updatePluginSettings(this.hot.getSettings()[this.constructor.PLUGIN_KEY]);
     const pluginDeps = this.constructor.PLUGIN_DEPS;
     const deps = Array.isArray(pluginDeps) ? pluginDeps : [];
     if (deps.length > 0) {
@@ -184,25 +203,75 @@ export class BasePlugin {
    * @returns {*}
    */
   getSetting(settingName) {
-    const pluginSettings = this.hot.getSettings()[this.constructor.PLUGIN_KEY];
+    const defaultSettings = this.constructor.DEFAULT_SETTINGS;
     if (settingName === undefined) {
-      return pluginSettings;
+      if (isObject(_classPrivateFieldGet(_pluginSettings, this))) {
+        return assignObjectDefaults(_classPrivateFieldGet(_pluginSettings, this), defaultSettings);
+      }
+      return _classPrivateFieldGet(_pluginSettings, this);
     }
-    const defaultSettings = this.constructor.DEFAULT_SETTINGS;
-    if ((Array.isArray(pluginSettings) || isObject(pluginSettings)) && defaultSettings[defaultMainSettingSymbol] === settingName) {
-      var _pluginSettings$setti;
-      if (Array.isArray(pluginSettings)) {
-        return pluginSettings;
+    if ((Array.isArray(_classPrivateFieldGet(_pluginSettings, this)) || isObject(_classPrivateFieldGet(_pluginSettings, this))) && defaultSettings[defaultMainSettingSymbol] === settingName) {
+      var _classPrivateFieldGet2;
+      if (Array.isArray(_classPrivateFieldGet(_pluginSettings, this))) {
+        return _classPrivateFieldGet(_pluginSettings, this);
       }
-      return (_pluginSettings$setti = pluginSettings[settingName]) !== null && _pluginSettings$setti !== void 0 ? _pluginSettings$setti : defaultSettings[settingName];
+      return (_classPrivateFieldGet2 = _classPrivateFieldGet(_pluginSettings, this)[settingName]) !== null && _classPrivateFieldGet2 !== void 0 ? _classPrivateFieldGet2 : defaultSettings[settingName];
     }
-    if (isObject(pluginSettings)) {
-      var _pluginSettings$setti2;
-      return (_pluginSettings$setti2 = pluginSettings[settingName]) !== null && _pluginSettings$setti2 !== void 0 ? _pluginSettings$setti2 : defaultSettings[settingName];
+    if (settingName.includes('.')) {
+      const pluginValue = getProperty(_classPrivateFieldGet(_pluginSettings, this), settingName);
+      const defaultValue = getProperty(defaultSettings, settingName);
+      if (isObject(pluginValue)) {
+        return assignObjectDefaults(pluginValue, defaultValue);
+      }
+      return pluginValue !== undefined ? pluginValue : defaultValue;
+    }
+    if (isObject(_classPrivateFieldGet(_pluginSettings, this))) {
+      return assignObjectDefaults(_classPrivateFieldGet(_pluginSettings, this), defaultSettings)[settingName];
     }
     return defaultSettings[settingName];
   }
 
+  /**
+   * Update plugin settings.
+   *
+   * @param {*} newSettings New settings.
+   * @returns {object} Updated settings object.
+   */
+  updatePluginSettings(newSettings) {
+    const settingsValidators = this.constructor.SETTINGS_VALIDATORS;
+    if (settingsValidators && typeof settingsValidators === 'function' && typeof newSettings !== 'object') {
+      const isValid = settingsValidators(newSettings);
+      if (isValid === false) {
+        warn(`${this.pluginName} Plugin: option is not valid and it will be ignored.`);
+        return;
+      }
+      _classPrivateFieldSet(_pluginSettings, this, newSettings);
+      return _classPrivateFieldGet(_pluginSettings, this);
+    }
+    if (settingsValidators && typeof settingsValidators === 'object' && typeof newSettings === 'object') {
+      if (_classPrivateFieldGet(_pluginSettings, this) === null || typeof _classPrivateFieldGet(_pluginSettings, this) !== 'object') {
+        _classPrivateFieldSet(_pluginSettings, this, {
+          ...this.constructor.DEFAULT_SETTINGS
+        });
+      }
+      Object.keys(settingsValidators).forEach(key => {
+        if (!(key in newSettings)) {
+          return;
+        }
+        const validator = settingsValidators[key];
+        const isValid = validator ? validator(newSettings[key]) : true;
+        if (isValid === false) {
+          warn(`${this.pluginName} Plugin: "${key}" option is not valid and it will be ignored.`);
+          return;
+        }
+        _classPrivateFieldGet(_pluginSettings, this)[key] = newSettings[key];
+      });
+      return _classPrivateFieldGet(_pluginSettings, this);
+    }
+    _classPrivateFieldSet(_pluginSettings, this, newSettings);
+    return newSettings;
+  }
+
   /**
    * Add listener to plugin hooks system.
    *
@@ -280,6 +349,7 @@ export class BasePlugin {
         this.enablePlugin();
       }
       if (this.enabled && this.isEnabled() && relevantToSettings) {
+        this.updatePluginSettings(newSettings[this.constructor.PLUGIN_KEY]);
         this.updatePlugin(newSettings);
       }
     }
@@ -297,6 +367,7 @@ export class BasePlugin {
    */
   destroy() {
     var _this$eventManager2;
+    _classPrivateFieldSet(_pluginSettings, this, null);
     (_this$eventManager2 = this.eventManager) === null || _this$eventManager2 === void 0 || _this$eventManager2.destroy();
     this.clearHooks();
     objectEach(this, (value, property) => {