handsontable 17.1.0 → 18.0.0-rc2

package/plugins/formulas/formulas.mjs

@@ -55,13 +55,37 @@ import { isNumeric } from '../../helpers/number.mjs';
 import { isObject } from '../../helpers/object.mjs';
 import { isDefined, isUndefined } from '../../helpers/mixed.mjs';
 import { getRegisteredHotInstances, setupEngine, setupSheet, unregisterEngine } from './engine/register.mjs';
-import { getDateFromExcelDate, getDateInHfFormat, getDateInHotFormat, isDate, isDateValid, isFormula, normalizeValueForFormulaEngine, unescapeFormulaExpression } from './utils.mjs';
+import { getDateFromExcelDate, getDateInHfFormat, getDateInHotFormat, getTimeFromHfTimeFraction, isDate, isDateValid, isFormula, normalizeValueForFormulaEngine, unescapeFormulaExpression } from './utils.mjs';
 import { getEngineSettingsWithOverrides, haveEngineSettingsChanged } from './engine/settings.mjs';
 import { isArrayOfArrays } from '../../helpers/data.mjs';
 import { toUpperCaseFirst } from '../../helpers/string.mjs';
 import { getValueGetterValue } from '../../utils/valueAccessors.mjs';
 import { Hooks } from '../../core/hooks/index.mjs';
 import IndexSyncer from './indexSyncer/index.mjs';
+/**
+ * Narrow an arbitrary value to a HyperFormula cell change shape.
+ *
+ * @param {unknown} value Value to check.
+ * @returns {boolean} `true` if the value matches the cell change shape.
+ */ function isHFCellChange(value) {
+    return typeof value === 'object' && value !== null;
+}
+/**
+ * Narrow the raw `formulas` setting value to the object form.
+ *
+ * @param {unknown} value Raw setting value.
+ * @returns {boolean} `true` when the value is a settings object.
+ */ function isFormulasSettingsObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+/**
+ * Narrow a value to an object with a `value` property.
+ *
+ * @param {unknown} candidate Value to check.
+ * @returns {boolean} `true` when the value is an object exposing a `value` property.
+ */ function hasValueProperty(candidate) {
+    return typeof candidate === 'object' && candidate !== null && 'value' in candidate;
+}
 export const PLUGIN_KEY = 'formulas';
 export const SETTING_KEYS = [
     'maxRows',
@@ -91,6 +115,48 @@ var /**
    *
    * @type {boolean}
    */ _hotWasInitializedWithEmptyData = /*#__PURE__*/ new WeakMap(), /**
+   * Maps a HyperFormula `ExportedCellChange` to the same change with `newValue` translated to a
+   * Handsontable-formatted string when the target cell is of type `date` or `time`. For other cells
+   * (or non-numeric values, or named expressions, or trimmed cells, or cells on other sheets), the
+   * original change is returned unchanged.
+   *
+   * @param {object} change The HyperFormula exported change.
+   * @returns {object}
+   */ _exportChangeValue = /*#__PURE__*/ new WeakSet(), /**
+   * Called when a value is updated in the engine.
+   *
+   * @fires Hooks#afterFormulasValuesUpdate
+   * @param {Array} changes The values and location of applied changes.
+   */ _onEngineValuesUpdated = /*#__PURE__*/ new WeakMap(), /**
+   * Called when a named expression is added to the engine instance.
+   *
+   * @fires Hooks#afterNamedExpressionAdded
+   * @param {string} namedExpressionName The name of the added expression.
+   * @param {Array} changes The values and location of applied changes.
+   */ _onEngineNamedExpressionsAdded = /*#__PURE__*/ new WeakMap(), /**
+   * Called when a named expression is removed from the engine instance.
+   *
+   * @fires Hooks#afterNamedExpressionRemoved
+   * @param {string} namedExpressionName The name of the removed expression.
+   * @param {Array} changes The values and location of applied changes.
+   */ _onEngineNamedExpressionsRemoved = /*#__PURE__*/ new WeakMap(), /**
+   * Called when a new sheet is added to the engine instance.
+   *
+   * @fires Hooks#afterSheetAdded
+   * @param {string} addedSheetDisplayName The name of the added sheet.
+   */ _onEngineSheetAdded = /*#__PURE__*/ new WeakMap(), /**
+   * Called when a sheet in the engine instance is renamed.
+   *
+   * @fires Hooks#afterSheetRenamed
+   * @param {string} oldDisplayName The old name of the sheet.
+   * @param {string} newDisplayName The new name of the sheet.
+   */ _onEngineSheetRenamed = /*#__PURE__*/ new WeakMap(), /**
+   * Called when a sheet is removed from the engine instance.
+   *
+   * @fires Hooks#afterSheetRemoved
+   * @param {string} removedSheetDisplayName The removed sheet name.
+   * @param {Array} changes The values and location of applied changes.
+   */ _onEngineSheetRemoved = /*#__PURE__*/ new WeakMap(), /**
    * The list of the HyperFormula listeners.
    *
    * @type {Array}
@@ -123,7 +189,7 @@ var /**
    * @param {number} visualRow The visual row index.
    * @param {number|string} prop The visual column index or property name of the column.
    * @returns {*} Returns value to validate.
-   */ _onBeforeValidate = /*#__PURE__*/ new WeakSet(), /**
+   */ _onBeforeValidate = /*#__PURE__*/ new WeakMap(), /**
    * `onBeforeAutofill` hook callback.
    *
    * @param {Array[]} fillData The data that was used to fill the `targetRange`. If `beforeAutofill` was used
@@ -131,21 +197,21 @@ var /**
    * @param {CellRange} sourceRange The range values will be filled from.
    * @param {CellRange} targetRange The range new values will be filled into.
    * @returns {boolean|*}
-   */ _onBeforeAutofill = /*#__PURE__*/ new WeakSet(), /**
+   */ _onBeforeAutofill = /*#__PURE__*/ new WeakMap(), /**
    * `beforeLoadData` hook callback.
    *
    * @param {Array} sourceData Array of arrays or array of objects containing data.
    * @param {boolean} initialLoad Flag that determines whether the data has been loaded during the initialization.
    * @param {string} [source] Source of the call.
-   */ _onBeforeLoadData = /*#__PURE__*/ new WeakSet(), /**
+   */ _onBeforeLoadData = /*#__PURE__*/ new WeakMap(), /**
    * Callback to `afterCellMetaReset` hook which is triggered after setting cell meta.
-   */ _onAfterCellMetaReset = /*#__PURE__*/ new WeakSet(), /**
+   */ _onAfterCellMetaReset = /*#__PURE__*/ new WeakMap(), /**
    * `afterLoadData` hook callback.
    *
    * @param {Array} sourceData Array of arrays or array of objects containing data.
    * @param {boolean} initialLoad Flag that determines whether the data has been loaded during the initialization.
    * @param {string} [source] Source of the call.
-   */ _onAfterLoadData = /*#__PURE__*/ new WeakSet(), /**
+   */ _onAfterLoadData = /*#__PURE__*/ new WeakMap(), /**
    * `modifyData` hook callback.
    *
    * @param {number} visualRow Visual row index.
@@ -153,7 +219,7 @@ var /**
    * @param {object} valueHolder Object which contains original value which can be modified by overwriting `.value`
    *   property.
    * @param {string} ioMode String which indicates for what operation hook is fired (`get` or `set`).
-   */ _onModifyData = /*#__PURE__*/ new WeakSet(), /**
+   */ _onModifyData = /*#__PURE__*/ new WeakMap(), /**
    * `modifySourceData` hook callback.
    *
    * @param {number} row Physical row index.
@@ -161,59 +227,59 @@ var /**
    * @param {object} valueHolder Object which contains original value which can be modified by overwriting `.value`
    *   property.
    * @param {string} ioMode String which indicates for what operation hook is fired (`get` or `set`).
-   */ _onModifySourceData = /*#__PURE__*/ new WeakSet(), /**
+   */ _onModifySourceData = /*#__PURE__*/ new WeakMap(), /**
    * `onAfterSetDataAtCell` hook callback.
    *
    * @param {Array[]} changes An array of changes in format [[row, prop, oldValue, value], ...].
    * @param {string} [source] String that identifies source of hook call
    *                          ([list of all available sources]{@link https://handsontable.com/docs/javascript-data-grid/events-and-hooks/#handsontable-hooks}).
-   */ _onAfterSetDataAtCell = /*#__PURE__*/ new WeakSet(), /**
+   */ _onAfterSetDataAtCell = /*#__PURE__*/ new WeakMap(), /**
    * `onAfterSetSourceDataAtCell` hook callback.
    *
    * @param {Array[]} changes An array of changes in format [[row, column, oldValue, value], ...].
    * @param {string} [source] String that identifies source of hook call
    *                          ([list of all available sources]{@link https://handsontable.com/docs/javascript-data-grid/events-and-hooks/#handsontable-hooks}).
-   */ _onAfterSetSourceDataAtCell = /*#__PURE__*/ new WeakSet(), /**
+   */ _onAfterSetSourceDataAtCell = /*#__PURE__*/ new WeakMap(), /**
    * `beforeCreateRow` hook callback.
    *
    * @param {number} visualRow Represents the visual index of first newly created row in the data source array.
    * @param {number} amount Number of newly created rows in the data source array.
    * @returns {*|boolean} If false is returned the action is canceled.
-   */ _onBeforeCreateRow = /*#__PURE__*/ new WeakSet(), /**
+   */ _onBeforeCreateRow = /*#__PURE__*/ new WeakMap(), /**
    * `beforeCreateCol` hook callback.
    *
    * @param {number} visualColumn Represents the visual index of first newly created column in the data source.
    * @param {number} amount Number of newly created columns in the data source.
    * @returns {*|boolean} If false is returned the action is canceled.
-   */ _onBeforeCreateCol = /*#__PURE__*/ new WeakSet(), /**
+   */ _onBeforeCreateCol = /*#__PURE__*/ new WeakMap(), /**
    * `beforeRemoveRow` hook callback.
    *
    * @param {number} row Visual index of starter row.
    * @param {number} amount Amount of rows to be removed.
    * @param {number[]} physicalRows An array of physical rows removed from the data source.
    * @returns {*|boolean} If false is returned the action is canceled.
-   */ _onBeforeRemoveRow = /*#__PURE__*/ new WeakSet(), /**
+   */ _onBeforeRemoveRow = /*#__PURE__*/ new WeakMap(), /**
    * `beforeRemoveCol` hook callback.
    *
    * @param {number} col Visual index of starter column.
    * @param {number} amount Amount of columns to be removed.
    * @param {number[]} physicalColumns An array of physical columns removed from the data source.
    * @returns {*|boolean} If false is returned the action is canceled.
-   */ _onBeforeRemoveCol = /*#__PURE__*/ new WeakSet(), /**
+   */ _onBeforeRemoveCol = /*#__PURE__*/ new WeakMap(), /**
    * `afterCreateRow` hook callback.
    *
    * @param {number} visualRow Represents the visual index of first newly created row in the data source array.
    * @param {number} amount Number of newly created rows in the data source array.
    * @param {string} [source] String that identifies source of hook call
    *                          ([list of all available sources]{@link https://handsontable.com/docs/javascript-data-grid/events-and-hooks/#handsontable-hooks}).
-   */ _onAfterCreateRow = /*#__PURE__*/ new WeakSet(), /**
+   */ _onAfterCreateRow = /*#__PURE__*/ new WeakMap(), /**
    * `afterCreateCol` hook callback.
    *
    * @param {number} visualColumn Represents the visual index of first newly created column in the data source.
    * @param {number} amount Number of newly created columns in the data source.
    * @param {string} [source] String that identifies source of hook call
    *                          ([list of all available sources]{@link https://handsontable.com/docs/javascript-data-grid/events-and-hooks/#handsontable-hooks}).
-   */ _onAfterCreateCol = /*#__PURE__*/ new WeakSet(), /**
+   */ _onAfterCreateCol = /*#__PURE__*/ new WeakMap(), /**
    * `afterRemoveRow` hook callback.
    *
    * @param {number} row Visual index of starter row.
@@ -221,7 +287,7 @@ var /**
    * @param {number[]} physicalRows An array of physical rows removed from the data source.
    * @param {string} [source] String that identifies source of hook call
    *                          ([list of all available sources]{@link https://handsontable.com/docs/javascript-data-grid/events-and-hooks/#handsontable-hooks}).
-   */ _onAfterRemoveRow = /*#__PURE__*/ new WeakSet(), /**
+   */ _onAfterRemoveRow = /*#__PURE__*/ new WeakMap(), /**
    * `afterRemoveCol` hook callback.
    *
    * @param {number} col Visual index of starter column.
@@ -229,48 +295,14 @@ var /**
    * @param {number[]} physicalColumns An array of physical columns removed from the data source.
    * @param {string} [source] String that identifies source of hook call
    *                          ([list of all available sources]{@link https://handsontable.com/docs/javascript-data-grid/events-and-hooks/#handsontable-hooks}).
-   */ _onAfterRemoveCol = /*#__PURE__*/ new WeakSet(), /**
+   */ _onAfterRemoveCol = /*#__PURE__*/ new WeakMap(), /**
    * `afterDetachChild` hook callback.
    * Used to sync the data of the rows detached in the Nested Rows plugin with the engine's dataset.
    *
    * @param {object} parent An object representing the parent from which the element was detached.
    * @param {object} element The detached element.
    * @param {number} finalElementRowIndex The final row index of the detached element.
-   */ _onAfterDetachChild = /*#__PURE__*/ new WeakSet(), /**
-   * Called when a value is updated in the engine.
-   *
-   * @fires Hooks#afterFormulasValuesUpdate
-   * @param {Array} changes The values and location of applied changes.
-   */ _onEngineValuesUpdated = /*#__PURE__*/ new WeakSet(), /**
-   * Called when a named expression is added to the engine instance.
-   *
-   * @fires Hooks#afterNamedExpressionAdded
-   * @param {string} namedExpressionName The name of the added expression.
-   * @param {Array} changes The values and location of applied changes.
-   */ _onEngineNamedExpressionsAdded = /*#__PURE__*/ new WeakSet(), /**
-   * Called when a named expression is removed from the engine instance.
-   *
-   * @fires Hooks#afterNamedExpressionRemoved
-   * @param {string} namedExpressionName The name of the removed expression.
-   * @param {Array} changes The values and location of applied changes.
-   */ _onEngineNamedExpressionsRemoved = /*#__PURE__*/ new WeakSet(), /**
-   * Called when a new sheet is added to the engine instance.
-   *
-   * @fires Hooks#afterSheetAdded
-   * @param {string} addedSheetDisplayName The name of the added sheet.
-   */ _onEngineSheetAdded = /*#__PURE__*/ new WeakSet(), /**
-   * Called when a sheet in the engine instance is renamed.
-   *
-   * @fires Hooks#afterSheetRenamed
-   * @param {string} oldDisplayName The old name of the sheet.
-   * @param {string} newDisplayName The new name of the sheet.
-   */ _onEngineSheetRenamed = /*#__PURE__*/ new WeakSet(), /**
-   * Called when a sheet is removed from the engine instance.
-   *
-   * @fires Hooks#afterSheetRemoved
-   * @param {string} removedSheetDisplayName The removed sheet name.
-   * @param {Array} changes The values and location of applied changes.
-   */ _onEngineSheetRemoved = /*#__PURE__*/ new WeakSet();
+   */ _onAfterDetachChild = /*#__PURE__*/ new WeakMap();
 /**
  * This plugin allows you to perform Excel-like calculations in your business applications. It does it by an
  * integration with our other product, [HyperFormula](https://github.com/handsontable/hyperformula/), which is a
@@ -281,13 +313,19 @@ var /**
  * @plugin Formulas
  * @class Formulas
  */ export class Formulas extends BasePlugin {
-    static get PLUGIN_KEY() {
+    /**
+   * Returns the plugin key used to identify this plugin in Handsontable settings.
+   */ static get PLUGIN_KEY() {
         return PLUGIN_KEY;
     }
-    static get PLUGIN_PRIORITY() {
+    /**
+   * Returns the priority order used to determine the order in which plugins are initialized.
+   */ static get PLUGIN_PRIORITY() {
         return PLUGIN_PRIORITY;
     }
-    static get SETTING_KEYS() {
+    /**
+   * Returns the list of settings keys observed by the plugin for configuration changes.
+   */ static get SETTING_KEYS() {
         return [
             PLUGIN_KEY,
             ...SETTING_KEYS
@@ -315,29 +353,29 @@ var /**
         // Useful for disabling -> enabling the plugin using `updateSettings` or the API.
         if (this.sheetName !== null && !this.engine.doesSheetExist(this.sheetName)) {
             const newSheetName = this.addSheet(this.sheetName, _class_private_method_get(this, _getProcessedSourceDataArray, getProcessedSourceDataArray).call(this));
-            if (newSheetName !== false) {
+            if (typeof newSheetName === 'string') {
                 _class_private_method_get(this, _updateSheetNameAndSheetId, updateSheetNameAndSheetId).call(this, newSheetName);
             }
         }
-        this.addHook('beforeLoadData', (...args)=>_class_private_method_get(this, _onBeforeLoadData, onBeforeLoadData).call(this, ...args));
-        this.addHook('afterLoadData', (...args)=>_class_private_method_get(this, _onAfterLoadData, onAfterLoadData).call(this, ...args));
+        this.addHook('beforeLoadData', _class_private_field_get(this, _onBeforeLoadData));
+        this.addHook('afterLoadData', _class_private_field_get(this, _onAfterLoadData));
         // The `updateData` hooks utilize the same logic as the `loadData` hooks.
-        this.addHook('beforeUpdateData', (...args)=>_class_private_method_get(this, _onBeforeLoadData, onBeforeLoadData).call(this, ...args));
-        this.addHook('afterUpdateData', (...args)=>_class_private_method_get(this, _onAfterLoadData, onAfterLoadData).call(this, ...args));
-        this.addHook('modifyData', (...args)=>_class_private_method_get(this, _onModifyData, onModifyData).call(this, ...args));
-        this.addHook('modifySourceData', (...args)=>_class_private_method_get(this, _onModifySourceData, onModifySourceData).call(this, ...args));
-        this.addHook('beforeValidate', (...args)=>_class_private_method_get(this, _onBeforeValidate, onBeforeValidate).call(this, ...args));
-        this.addHook('afterSetSourceDataAtCell', (...args)=>_class_private_method_get(this, _onAfterSetSourceDataAtCell, onAfterSetSourceDataAtCell).call(this, ...args));
-        this.addHook('afterSetDataAtCell', (...args)=>_class_private_method_get(this, _onAfterSetDataAtCell, onAfterSetDataAtCell).call(this, ...args));
-        this.addHook('afterSetDataAtRowProp', (...args)=>_class_private_method_get(this, _onAfterSetDataAtCell, onAfterSetDataAtCell).call(this, ...args));
-        this.addHook('beforeCreateRow', (...args)=>_class_private_method_get(this, _onBeforeCreateRow, onBeforeCreateRow).call(this, ...args));
-        this.addHook('beforeCreateCol', (...args)=>_class_private_method_get(this, _onBeforeCreateCol, onBeforeCreateCol).call(this, ...args));
-        this.addHook('afterCreateRow', (...args)=>_class_private_method_get(this, _onAfterCreateRow, onAfterCreateRow).call(this, ...args));
-        this.addHook('afterCreateCol', (...args)=>_class_private_method_get(this, _onAfterCreateCol, onAfterCreateCol).call(this, ...args));
-        this.addHook('beforeRemoveRow', (...args)=>_class_private_method_get(this, _onBeforeRemoveRow, onBeforeRemoveRow).call(this, ...args));
-        this.addHook('beforeRemoveCol', (...args)=>_class_private_method_get(this, _onBeforeRemoveCol, onBeforeRemoveCol).call(this, ...args));
-        this.addHook('afterRemoveRow', (...args)=>_class_private_method_get(this, _onAfterRemoveRow, onAfterRemoveRow).call(this, ...args));
-        this.addHook('afterRemoveCol', (...args)=>_class_private_method_get(this, _onAfterRemoveCol, onAfterRemoveCol).call(this, ...args));
+        this.addHook('beforeUpdateData', _class_private_field_get(this, _onBeforeLoadData));
+        this.addHook('afterUpdateData', _class_private_field_get(this, _onAfterLoadData));
+        this.addHook('modifyData', _class_private_field_get(this, _onModifyData));
+        this.addHook('modifySourceData', _class_private_field_get(this, _onModifySourceData));
+        this.addHook('beforeValidate', _class_private_field_get(this, _onBeforeValidate));
+        this.addHook('afterSetSourceDataAtCell', _class_private_field_get(this, _onAfterSetSourceDataAtCell));
+        this.addHook('afterSetDataAtCell', _class_private_field_get(this, _onAfterSetDataAtCell));
+        this.addHook('afterSetDataAtRowProp', _class_private_field_get(this, _onAfterSetDataAtCell));
+        this.addHook('beforeCreateRow', _class_private_field_get(this, _onBeforeCreateRow));
+        this.addHook('beforeCreateCol', _class_private_field_get(this, _onBeforeCreateCol));
+        this.addHook('afterCreateRow', _class_private_field_get(this, _onAfterCreateRow));
+        this.addHook('afterCreateCol', _class_private_field_get(this, _onAfterCreateCol));
+        this.addHook('beforeRemoveRow', _class_private_field_get(this, _onBeforeRemoveRow));
+        this.addHook('beforeRemoveCol', _class_private_field_get(this, _onBeforeRemoveCol));
+        this.addHook('afterRemoveRow', _class_private_field_get(this, _onAfterRemoveRow));
+        this.addHook('afterRemoveCol', _class_private_field_get(this, _onAfterRemoveCol));
         this.indexSyncer = new IndexSyncer(this.hot.rowIndexMapper, this.hot.columnIndexMapper, (postponedAction)=>{
             this.hot.addHookOnce('init', ()=>{
                 // Engine is initialized after executing callback to `afterLoadData` hook. Thus, some actions on indexes should
@@ -349,38 +387,40 @@ var /**
         this.columnAxisSyncer = this.indexSyncer.getForAxis('column');
         this.hot.addHook('afterRowSequenceChange', this.rowAxisSyncer.getIndexesChangeSyncMethod());
         this.hot.addHook('afterColumnSequenceChange', this.columnAxisSyncer.getIndexesChangeSyncMethod());
-        this.hot.addHook('beforeRowMove', (movedRows, finalIndex, _, movePossible)=>{
+        this.hot.addHook('beforeRowMove', (movedRows, finalIndex, _dropIndex, movePossible)=>{
             this.rowAxisSyncer.storeMovesInformation(movedRows, finalIndex, movePossible);
         });
-        this.hot.addHook('beforeColumnMove', (movedColumns, finalIndex, _, movePossible)=>{
+        this.hot.addHook('beforeColumnMove', (movedColumns, finalIndex, _dropIndex, movePossible)=>{
             this.columnAxisSyncer.storeMovesInformation(movedColumns, finalIndex, movePossible);
         });
-        this.hot.addHook('afterRowMove', (movedRows, finalIndex, dropIndex, movePossible, orderChanged)=>{
+        this.hot.addHook('afterRowMove', (_movedRows, _finalIndex, _dropIndex, movePossible, orderChanged)=>{
             this.rowAxisSyncer.calculateAndSyncMoves(movePossible, orderChanged);
         });
-        this.hot.addHook('afterColumnMove', (movedColumns, finalIndex, dropIndex, movePossible, orderChanged)=>{
+        this.hot.addHook('afterColumnMove', (_movedColumns, _finalIndex, _dropIndex, movePossible, orderChanged)=>{
             this.columnAxisSyncer.calculateAndSyncMoves(movePossible, orderChanged);
         });
         this.hot.addHook('beforeColumnFreeze', (column, freezePerformed)=>{
+            const fixedColumnsStart = this.hot.getSettings().fixedColumnsStart;
             this.columnAxisSyncer.storeMovesInformation([
                 column
-            ], this.hot.getSettings().fixedColumnsStart, freezePerformed);
+            ], fixedColumnsStart, freezePerformed);
         });
-        this.hot.addHook('afterColumnFreeze', (_, freezePerformed)=>{
+        this.hot.addHook('afterColumnFreeze', (_column, freezePerformed)=>{
             this.columnAxisSyncer.calculateAndSyncMoves(freezePerformed, freezePerformed);
         });
         this.hot.addHook('beforeColumnUnfreeze', (column, unfreezePerformed)=>{
+            const fixedColumnsStart = this.hot.getSettings().fixedColumnsStart;
             this.columnAxisSyncer.storeMovesInformation([
                 column
-            ], this.hot.getSettings().fixedColumnsStart - 1, unfreezePerformed);
+            ], fixedColumnsStart - 1, unfreezePerformed);
         });
-        this.hot.addHook('afterColumnUnfreeze', (_, unfreezePerformed)=>{
+        this.hot.addHook('afterColumnUnfreeze', (_column, unfreezePerformed)=>{
             this.columnAxisSyncer.calculateAndSyncMoves(unfreezePerformed, unfreezePerformed);
         });
         // TODO: Actions related to overwriting dates from HOT format to HF default format are done as callback to this
         // hook, because some hooks, such as `afterLoadData` doesn't have information about composed cell properties.
         // Another hooks are triggered to late for setting HF's engine data needed for some actions.
-        this.addHook('afterCellMetaReset', (...args)=>_class_private_method_get(this, _onAfterCellMetaReset, onAfterCellMetaReset).call(this, ...args));
+        this.addHook('afterCellMetaReset', _class_private_field_get(this, _onAfterCellMetaReset));
         // Handling undo actions on data just using HyperFormula's UndoRedo mechanism
         this.addHook('beforeUndo', ()=>{
             this.indexSyncer.setPerformUndo(true);
@@ -397,16 +437,18 @@ var /**
         this.addHook('afterUndo', ()=>{
             this.indexSyncer.setPerformRedo(false);
         });
-        this.addHook('afterDetachChild', (...args)=>_class_private_method_get(this, _onAfterDetachChild, onAfterDetachChild).call(this, ...args));
-        this.addHook('beforeAutofill', (...args)=>_class_private_method_get(this, _onBeforeAutofill, onBeforeAutofill).call(this, ...args));
-        _class_private_field_get(this, _engineListeners).forEach(([eventName, listener])=>this.engine.on(eventName, listener));
+        this.addHook('afterDetachChild', _class_private_field_get(this, _onAfterDetachChild));
+        this.addHook('beforeAutofill', _class_private_field_get(this, _onBeforeAutofill));
+        _class_private_field_get(this, _engineListeners)?.forEach(([eventName, listener])=>this.engine.on(eventName, listener));
         super.enablePlugin();
     }
     /**
    * Disables the plugin functionality for this Handsontable instance.
    */ disablePlugin() {
-        _class_private_field_get(this, _engineListeners).forEach(([eventName, listener])=>this.engine.off(eventName, listener));
-        unregisterEngine(this.engine, this.hot);
+        _class_private_field_get(this, _engineListeners)?.forEach(([eventName, listener])=>this.engine?.off(eventName, listener));
+        if (this.engine) {
+            unregisterEngine(this.engine, this.hot);
+        }
         this.engine = null;
         super.disablePlugin();
     }
@@ -417,22 +459,25 @@ var /**
    * @param {object} newSettings New set of settings passed to the `updateSettings` method.
    */ updatePlugin(newSettings) {
         const newEngineSettings = getEngineSettingsWithOverrides(this.hot.getSettings());
-        if (haveEngineSettingsChanged(this.engine.getConfig(), newEngineSettings)) {
+        if (this.engine && haveEngineSettingsChanged(this.engine.getConfig(), newEngineSettings)) {
             this.engine.updateConfig(newEngineSettings);
         }
         const pluginSettings = this.hot.getSettings()[PLUGIN_KEY];
-        if (isDefined(pluginSettings) && isDefined(pluginSettings.sheetName) && pluginSettings.sheetName !== this.sheetName) {
+        if (pluginSettings !== undefined && typeof pluginSettings !== 'boolean' && pluginSettings.sheetName !== undefined && pluginSettings.sheetName !== this.sheetName) {
             this.switchSheet(pluginSettings.sheetName);
         }
         // If no data was passed to the `updateSettings` method and no sheet is connected to the instance -> create a
         // new sheet using the currently used data. Otherwise, it will be handled by the `afterLoadData` call.
         if (!newSettings.data && this.sheetName === null) {
-            const sheetName = this.hot.getSettings()[PLUGIN_KEY].sheetName;
-            if (sheetName && this.engine.doesSheetExist(sheetName)) {
-                this.switchSheet(this.sheetName);
+            const formulasSettings = this.hot.getSettings()[PLUGIN_KEY];
+            const sheetName = isFormulasSettingsObject(formulasSettings) ? formulasSettings.sheetName : undefined;
+            if (sheetName && this.engine?.doesSheetExist(sheetName)) {
+                this.switchSheet(sheetName);
             } else {
                 const newSheetName = this.addSheet(sheetName ?? undefined, _class_private_method_get(this, _getProcessedSourceDataArray, getProcessedSourceDataArray).call(this));
-                _class_private_method_get(this, _updateSheetNameAndSheetId, updateSheetNameAndSheetId).call(this, newSheetName);
+                if (typeof newSheetName === 'string') {
+                    _class_private_method_get(this, _updateSheetNameAndSheetId, updateSheetNameAndSheetId).call(this, newSheetName);
+                }
             }
         }
         super.updatePlugin(newSettings);
@@ -440,9 +485,11 @@ var /**
     /**
    * Destroys the plugin instance.
    */ destroy() {
-        _class_private_field_get(this, _engineListeners).forEach(([eventName, listener])=>this.engine?.off(eventName, listener));
+        _class_private_field_get(this, _engineListeners)?.forEach(([eventName, listener])=>this.engine?.off(eventName, listener));
         _class_private_field_set(this, _engineListeners, null);
-        unregisterEngine(this.engine, this.hot);
+        if (this.engine) {
+            unregisterEngine(this.engine, this.hot);
+        }
         this.engine = null;
         super.destroy();
     }
@@ -460,7 +507,7 @@ var /**
             warn('The provided data should be an array of arrays.');
             return false;
         }
-        if (sheetName !== undefined && sheetName !== null && this.engine.doesSheetExist(sheetName)) {
+        if (sheetName !== undefined && sheetName !== null && this.engine?.doesSheetExist(sheetName)) {
             warn('Sheet with the provided name already exists.');
             return false;
         }
@@ -471,7 +518,7 @@ var /**
             }
             return actualSheetName;
         } catch (e) {
-            warn(e.message);
+            warn(e instanceof Error ? e.message : String(e));
             return false;
         }
     }
@@ -481,7 +528,7 @@ var /**
    *
    * @param {string} sheetName Sheet name used in the shared HyperFormula instance.
    */ switchSheet(sheetName) {
-        if (!this.engine.doesSheetExist(sheetName)) {
+        if (!this.engine?.doesSheetExist(sheetName)) {
             error(`The sheet named \`${sheetName}\` does not exist, switch aborted.`);
             return;
         }
@@ -537,13 +584,14 @@ var /**
         const affectedSheetIds = new Set();
         dependentCells.forEach((change)=>{
             // For the Named expression the address is empty, hence the `sheetId` is undefined.
-            const sheetId = change?.address?.sheet;
-            if (sheetId !== undefined) {
-                if (!affectedSheetIds.has(sheetId)) {
-                    affectedSheetIds.add(sheetId);
-                }
+            const sheetId = isHFCellChange(change) ? change.address?.sheet : undefined;
+            if (sheetId !== undefined && !affectedSheetIds.has(sheetId)) {
+                affectedSheetIds.add(sheetId);
             }
         });
+        if (!this.engine) {
+            return;
+        }
         getRegisteredHotInstances(this.engine).forEach((relatedHot, sheetId)=>{
             if ((renderSelf || sheetId !== this.sheetId) && affectedSheetIds.has(sheetId)) {
                 relatedHot.render();
@@ -559,22 +607,22 @@ var /**
    * @param {object[]} [changedCells] The values and location of applied changes by developer (through API or UI).
    */ validateDependentCells(dependentCells, changedCells = []) {
         const stringifyAddress = (change)=>{
-            const { row, col, sheet } = change?.address ?? {};
+            const address = isHFCellChange(change) ? change.address : undefined;
+            const { row, col, sheet } = address ?? {};
             return isDefined(sheet) ? `${sheet}:${row}x${col}` : '';
         };
         const changedCellsSet = new Set(changedCells.map((change)=>stringifyAddress(change)));
         dependentCells.forEach((change)=>{
-            const { row, col } = change.address ?? {};
+            const address = isHFCellChange(change) ? change.address : undefined;
+            const { row, col, sheet: sheetId } = address ?? {};
             // Don't try to validate cells outside of the visual part of the table.
-            if (isDefined(row) === false || isDefined(col) === false || row >= this.hot.countRows() || col >= this.hot.countCols()) {
+            if (row === undefined || col === undefined || row >= this.hot.countRows() || col >= this.hot.countCols()) {
                 return;
             }
-            // For the Named expression the address is empty, hence the `sheetId` is undefined.
-            const sheetId = change?.address?.sheet;
             const addressId = stringifyAddress(change);
             // Validate the cells that depend on the calculated formulas. Skip that cells
             // where the user directly changes the values - the Core triggers those validators.
-            if (sheetId !== undefined && !changedCellsSet.has(addressId)) {
+            if (sheetId !== undefined && !changedCellsSet.has(addressId) && this.engine) {
                 const boundHot = getRegisteredHotInstances(this.engine).get(sheetId);
                 // if `sheetId` is not bound to any Handsontable instance, skip the validation process
                 if (!boundHot) {
@@ -599,56 +647,142 @@ var /**
             col: this.columnAxisSyncer.getHfIndexFromVisualIndex(column),
             sheet: this.sheetId
         };
-        if (!this.engine.isItPossibleToSetCellContents(address)) {
+        if (!this.engine?.isItPossibleToSetCellContents(address)) {
             warn(`Not possible to set cell data at ${JSON.stringify(address)}`);
             return;
         }
         const cellMeta = this.hot.getCellMeta(row, column);
         if (isDate(newValue, cellMeta.type)) {
-            if (isDateValid(newValue, cellMeta.dateFormat)) {
+            if (isDateValid(newValue)) {
                 // Rewriting date in HOT format to HF format.
-                newValue = getDateInHfFormat(newValue, cellMeta.dateFormat);
+                newValue = getDateInHfFormat(newValue);
             } else if (isFormula(newValue) === false) {
                 // Escaping value from date parsing using "'" sign (HF feature).
                 newValue = `'${newValue}`;
             }
         }
-        return this.engine.setCellContents(address, newValue);
+        return this.engine?.setCellContents(address, newValue);
     }
     constructor(...args){
-        super(...args), _class_private_method_init(this, _updateSheetNameAndSheetId), _class_private_method_init(this, _getValueGetterValue), _class_private_method_init(this, _getProcessedSourceDataArray), _class_private_method_init(this, _onBeforeValidate), _class_private_method_init(this, _onBeforeAutofill), _class_private_method_init(this, _onBeforeLoadData), _class_private_method_init(this, _onAfterCellMetaReset), _class_private_method_init(this, _onAfterLoadData), _class_private_method_init(this, _onModifyData), _class_private_method_init(this, _onModifySourceData), _class_private_method_init(this, _onAfterSetDataAtCell), _class_private_method_init(this, _onAfterSetSourceDataAtCell), _class_private_method_init(this, _onBeforeCreateRow), _class_private_method_init(this, _onBeforeCreateCol), _class_private_method_init(this, _onBeforeRemoveRow), _class_private_method_init(this, _onBeforeRemoveCol), _class_private_method_init(this, _onAfterCreateRow), _class_private_method_init(this, _onAfterCreateCol), _class_private_method_init(this, _onAfterRemoveRow), _class_private_method_init(this, _onAfterRemoveCol), _class_private_method_init(this, _onAfterDetachChild), _class_private_method_init(this, _onEngineValuesUpdated), _class_private_method_init(this, _onEngineNamedExpressionsAdded), _class_private_method_init(this, _onEngineNamedExpressionsRemoved), _class_private_method_init(this, _onEngineSheetAdded), _class_private_method_init(this, _onEngineSheetRenamed), _class_private_method_init(this, _onEngineSheetRemoved), _class_private_field_init(this, _internalOperationPending, {
+        super(...args), _class_private_method_init(this, _exportChangeValue), _class_private_method_init(this, _updateSheetNameAndSheetId), _class_private_method_init(this, _getValueGetterValue), _class_private_method_init(this, _getProcessedSourceDataArray), _class_private_field_init(this, _internalOperationPending, {
             writable: true,
             value: void 0
         }), _class_private_field_init(this, _hotWasInitializedWithEmptyData, {
             writable: true,
             value: void 0
+        }), _class_private_field_init(this, _onEngineValuesUpdated, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_init(this, _onEngineNamedExpressionsAdded, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_init(this, _onEngineNamedExpressionsRemoved, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_init(this, _onEngineSheetAdded, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_init(this, _onEngineSheetRenamed, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_init(this, _onEngineSheetRemoved, {
+            writable: true,
+            value: void 0
         }), _class_private_field_init(this, _engineListeners, {
             writable: true,
             value: void 0
-        }), _class_private_field_set(this, _internalOperationPending, false), _class_private_field_set(this, _hotWasInitializedWithEmptyData, false), _class_private_field_set(this, _engineListeners, [
+        }), _class_private_field_init(this, _onBeforeValidate, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_init(this, _onBeforeAutofill, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_init(this, _onBeforeLoadData, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_init(this, _onAfterCellMetaReset, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_init(this, _onAfterLoadData, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_init(this, _onModifyData, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_init(this, _onModifySourceData, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_init(this, _onAfterSetDataAtCell, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_init(this, _onAfterSetSourceDataAtCell, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_init(this, _onBeforeCreateRow, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_init(this, _onBeforeCreateCol, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_init(this, _onBeforeRemoveRow, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_init(this, _onBeforeRemoveCol, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_init(this, _onAfterCreateRow, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_init(this, _onAfterCreateCol, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_init(this, _onAfterRemoveRow, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_init(this, _onAfterRemoveCol, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_init(this, _onAfterDetachChild, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_set(this, _internalOperationPending, false), _class_private_field_set(this, _hotWasInitializedWithEmptyData, false), _class_private_field_set(this, _onEngineValuesUpdated, (changes)=>{
+            const exportedChanges = changes.map((change)=>_class_private_method_get(this, _exportChangeValue, exportChangeValue).call(this, change));
+            this.hot.runHooks('afterFormulasValuesUpdate', exportedChanges);
+        }), _class_private_field_set(this, _onEngineNamedExpressionsAdded, (namedExpressionName, changes)=>{
+            this.hot.runHooks('afterNamedExpressionAdded', namedExpressionName, changes);
+        }), _class_private_field_set(this, _onEngineNamedExpressionsRemoved, (namedExpressionName, changes)=>{
+            this.hot.runHooks('afterNamedExpressionRemoved', namedExpressionName, changes);
+        }), _class_private_field_set(this, _onEngineSheetAdded, (addedSheetDisplayName)=>{
+            this.hot.runHooks('afterSheetAdded', addedSheetDisplayName);
+        }), _class_private_field_set(this, _onEngineSheetRenamed, (oldDisplayName, newDisplayName)=>{
+            _class_private_method_get(this, _updateSheetNameAndSheetId, updateSheetNameAndSheetId).call(this, newDisplayName);
+            this.hot.runHooks('afterSheetRenamed', oldDisplayName, newDisplayName);
+        }), _class_private_field_set(this, _onEngineSheetRemoved, (removedSheetDisplayName, changes)=>{
+            this.hot.runHooks('afterSheetRemoved', removedSheetDisplayName, changes);
+        }), _class_private_field_set(this, _engineListeners, [
             [
                 'valuesUpdated',
-                (...args)=>_class_private_method_get(this, _onEngineValuesUpdated, onEngineValuesUpdated).call(this, ...args)
+                _class_private_field_get(this, _onEngineValuesUpdated)
             ],
             [
                 'namedExpressionAdded',
-                (...args)=>_class_private_method_get(this, _onEngineNamedExpressionsAdded, onEngineNamedExpressionsAdded).call(this, ...args)
+                _class_private_field_get(this, _onEngineNamedExpressionsAdded)
             ],
             [
                 'namedExpressionRemoved',
-                (...args)=>_class_private_method_get(this, _onEngineNamedExpressionsRemoved, onEngineNamedExpressionsRemoved).call(this, ...args)
+                _class_private_field_get(this, _onEngineNamedExpressionsRemoved)
             ],
             [
                 'sheetAdded',
-                (...args)=>_class_private_method_get(this, _onEngineSheetAdded, onEngineSheetAdded).call(this, ...args)
+                _class_private_field_get(this, _onEngineSheetAdded)
             ],
             [
                 'sheetRenamed',
-                (...args)=>_class_private_method_get(this, _onEngineSheetRenamed, onEngineSheetRenamed).call(this, ...args)
+                _class_private_field_get(this, _onEngineSheetRenamed)
             ],
             [
                 'sheetRemoved',
-                (...args)=>_class_private_method_get(this, _onEngineSheetRemoved, onEngineSheetRemoved).call(this, ...args)
+                _class_private_field_get(this, _onEngineSheetRemoved)
             ]
         ]), /**
    * Static register used to set up one global HyperFormula instance.
@@ -680,423 +814,479 @@ var /**
    * Index synchronizer responsible for syncing the order of HOT and HF's data for the axis of the columns.
    *
    * @type {AxisSyncer|null}
-   */ this.columnAxisSyncer = null;
-    }
-}
-function updateSheetNameAndSheetId(sheetName) {
-    this.sheetName = sheetName;
-    this.sheetId = this.engine.getSheetId(this.sheetName);
-}
-function getValueGetterValue1(row, column, value) {
-    if (isObject(value) && value !== null) {
-        const visualRow = this.hot.toVisualRow(row);
-        const visualColumn = this.hot.toVisualColumn(column);
-        value = getValueGetterValue(value, this.hot.getCellMeta(visualRow, visualColumn));
-        value = value.toString();
-    }
-    return normalizeValueForFormulaEngine(value);
-}
-function getProcessedSourceDataArray(row, column, row2, column2) {
-    return this.hot.getSourceDataArray(row, column, row2, column2).map((rowObject, rowIndex)=>{
-        return rowObject.map((value, columnIndex)=>{
-            return _class_private_method_get(this, _getValueGetterValue, getValueGetterValue1).call(this, rowIndex, columnIndex, value);
-        });
-    });
-}
-function onBeforeValidate(value, visualRow, prop) {
-    const visualColumn = this.hot.propToCol(prop);
-    if (this.isFormulaCellType(visualRow, visualColumn)) {
-        const address = {
-            row: this.rowAxisSyncer.getHfIndexFromVisualIndex(visualRow),
-            col: this.columnAxisSyncer.getHfIndexFromVisualIndex(visualColumn),
-            sheet: this.sheetId
-        };
-        const cellMeta = this.hot.getCellMeta(visualRow, visualColumn);
-        let cellValue = this.engine.getCellValue(address); // Date as an integer (Excel-like date).
-        if (cellMeta.type === 'date' && isNumeric(cellValue)) {
-            cellValue = getDateFromExcelDate(cellValue, cellMeta.dateFormat);
-        }
-        // If `cellValue` is an object it is expected to be an error
-        return typeof cellValue === 'object' && cellValue !== null ? cellValue.value : cellValue;
-    }
-    return value;
-}
-function onBeforeAutofill(fillData, sourceRange, targetRange) {
-    const { row: sourceTopStartRow, col: sourceTopStartColumn } = sourceRange.getTopStartCorner();
-    const { row: sourceBottomEndRow, col: sourceBottomEndColumn } = sourceRange.getBottomEndCorner();
-    const { row: targetTopStartRow, col: targetTopStartColumn } = targetRange.getTopStartCorner();
-    const { row: targetBottomEndRow, col: targetBottomEndColumn } = targetRange.getBottomEndCorner();
-    const engineSourceRange = {
-        start: {
-            row: this.rowAxisSyncer.getHfIndexFromVisualIndex(sourceTopStartRow),
-            col: this.columnAxisSyncer.getHfIndexFromVisualIndex(sourceTopStartColumn),
-            sheet: this.sheetId
-        },
-        end: {
-            row: this.rowAxisSyncer.getHfIndexFromVisualIndex(sourceBottomEndRow),
-            col: this.columnAxisSyncer.getHfIndexFromVisualIndex(sourceBottomEndColumn),
-            sheet: this.sheetId
-        }
-    };
-    const engineTargetRange = {
-        start: {
-            row: this.rowAxisSyncer.getHfIndexFromVisualIndex(targetTopStartRow),
-            col: this.columnAxisSyncer.getHfIndexFromVisualIndex(targetTopStartColumn),
-            sheet: this.sheetId
-        },
-        end: {
-            row: this.rowAxisSyncer.getHfIndexFromVisualIndex(targetBottomEndRow),
-            col: this.columnAxisSyncer.getHfIndexFromVisualIndex(targetBottomEndColumn),
-            sheet: this.sheetId
-        }
-    };
-    // Blocks the autofill operation if HyperFormula says that at least one of
-    // the underlying cell's contents cannot be set.
-    if (this.engine.isItPossibleToSetCellContents(engineTargetRange) === false) {
-        return false;
-    }
-    const fillRangeData = this.engine.getFillRangeData(engineSourceRange, engineTargetRange);
-    const { row: sourceStartRow, col: sourceStartColumn } = engineSourceRange.start;
-    const { row: sourceEndRow, col: sourceEndColumn } = engineSourceRange.end;
-    const populationRowLength = sourceEndRow - sourceStartRow + 1;
-    const populationColumnLength = sourceEndColumn - sourceStartColumn + 1;
-    for(let populatedRowIndex = 0; populatedRowIndex < fillRangeData.length; populatedRowIndex += 1){
-        for(let populatedColumnIndex = 0; populatedColumnIndex < fillRangeData[populatedRowIndex].length; populatedColumnIndex += 1){
-            const populatedValue = fillRangeData[populatedRowIndex][populatedColumnIndex];
-            const sourceRow = sourceStartRow + populatedRowIndex % populationRowLength;
-            const sourceColumn = sourceStartColumn + populatedColumnIndex % populationColumnLength;
-            const sourceCellMeta = this.hot.getCellMeta(sourceRow, sourceColumn);
-            if (isDate(populatedValue, sourceCellMeta.type)) {
-                if (populatedValue.startsWith('\'')) {
-                    // Populating values on HOT side without apostrophe.
-                    fillRangeData[populatedRowIndex][populatedColumnIndex] = populatedValue.slice(1);
-                } else if (this.isFormulaCellType(sourceRow, sourceColumn, this.sheetId) === false) {
-                    // Populating date in proper format, coming from the source cell.
-                    fillRangeData[populatedRowIndex][populatedColumnIndex] = getDateInHotFormat(populatedValue, sourceCellMeta.dateFormat);
+   */ this.columnAxisSyncer = null, _class_private_field_set(this, _onBeforeValidate, (value, visualRow, prop)=>{
+            const visualColumn = this.hot.propToCol(prop);
+            if (this.isFormulaCellType(visualRow, visualColumn)) {
+                const address = {
+                    row: this.rowAxisSyncer.getHfIndexFromVisualIndex(visualRow),
+                    col: this.columnAxisSyncer.getHfIndexFromVisualIndex(visualColumn),
+                    sheet: this.sheetId
+                };
+                const cellMeta = this.hot.getCellMeta(visualRow, visualColumn);
+                let cellValue = this.engine.getCellValue(address); // Date as an integer (Excel-like date).
+                if (cellMeta.type === 'date' && isNumeric(cellValue)) {
+                    cellValue = getDateFromExcelDate(cellValue);
+                } else if (cellMeta.type === 'time' && isNumeric(cellValue)) {
+                    cellValue = getTimeFromHfTimeFraction(cellValue);
                 }
+                // If `cellValue` is an object it is expected to be an error
+                return hasValueProperty(cellValue) ? cellValue.value : cellValue;
             }
-        }
-    }
-    return fillRangeData;
-}
-function onBeforeLoadData(sourceData, initialLoad, source = '') {
-    if (source.includes(toUpperCaseFirst(PLUGIN_KEY))) {
-        return;
-    }
-    // This flag needs to be defined, because not passing data to HOT results in HOT auto-generating a `null`-filled
-    // initial dataset.
-    _class_private_field_set(this, _hotWasInitializedWithEmptyData, isUndefined(this.hot.getSettings().data));
-}
-function onAfterCellMetaReset() {
-    if (_class_private_field_get(this, _hotWasInitializedWithEmptyData)) {
-        this.switchSheet(this.sheetName);
-        return;
-    }
-    const sourceDataArray = _class_private_method_get(this, _getProcessedSourceDataArray, getProcessedSourceDataArray).call(this);
-    sourceDataArray.forEach((rowData, rowIndex)=>{
-        rowData.forEach((cellValue, columnIndex)=>{
-            const cellMeta = this.hot.getCellMeta(rowIndex, columnIndex, {
-                skipMetaExtension: true
-            });
-            const dateFormat = cellMeta.dateFormat;
-            if (isDate(cellValue, cellMeta.type)) {
-                if (isDateValid(cellValue, dateFormat)) {
-                    // Rewriting date in HOT format to HF format.
-                    sourceDataArray[rowIndex][columnIndex] = getDateInHfFormat(cellValue, dateFormat);
-                } else if (!cellValue.startsWith('=')) {
-                    // Escaping value from date parsing using "'" sign (HF feature).
-                    sourceDataArray[rowIndex][columnIndex] = `'${cellValue}`;
+            return value;
+        }), _class_private_field_set(this, _onBeforeAutofill, (fillData, sourceRange, targetRange)=>{
+            const { row: sourceTopStartRow, col: sourceTopStartColumn } = sourceRange.getTopStartCorner();
+            const { row: sourceBottomEndRow, col: sourceBottomEndColumn } = sourceRange.getBottomEndCorner();
+            const { row: targetTopStartRow, col: targetTopStartColumn } = targetRange.getTopStartCorner();
+            const { row: targetBottomEndRow, col: targetBottomEndColumn } = targetRange.getBottomEndCorner();
+            if (sourceTopStartRow === null || sourceTopStartColumn === null || sourceBottomEndRow === null || sourceBottomEndColumn === null || targetTopStartRow === null || targetTopStartColumn === null || targetBottomEndRow === null || targetBottomEndColumn === null) {
+                return;
+            }
+            const hfSourceStartRow = this.rowAxisSyncer.getHfIndexFromVisualIndex(sourceTopStartRow);
+            const hfSourceStartCol = this.columnAxisSyncer.getHfIndexFromVisualIndex(sourceTopStartColumn);
+            const hfSourceEndRow = this.rowAxisSyncer.getHfIndexFromVisualIndex(sourceBottomEndRow);
+            const hfSourceEndCol = this.columnAxisSyncer.getHfIndexFromVisualIndex(sourceBottomEndColumn);
+            const hfTargetStartRow = this.rowAxisSyncer.getHfIndexFromVisualIndex(targetTopStartRow);
+            const hfTargetStartCol = this.columnAxisSyncer.getHfIndexFromVisualIndex(targetTopStartColumn);
+            const hfTargetEndRow = this.rowAxisSyncer.getHfIndexFromVisualIndex(targetBottomEndRow);
+            const hfTargetEndCol = this.columnAxisSyncer.getHfIndexFromVisualIndex(targetBottomEndColumn);
+            if (hfSourceStartRow === null || hfSourceStartCol === null || hfSourceEndRow === null || hfSourceEndCol === null || hfTargetStartRow === null || hfTargetStartCol === null || hfTargetEndRow === null || hfTargetEndCol === null) {
+                return;
+            }
+            const engineSourceRange = {
+                start: {
+                    row: hfSourceStartRow,
+                    col: hfSourceStartCol,
+                    sheet: this.sheetId
+                },
+                end: {
+                    row: hfSourceEndRow,
+                    col: hfSourceEndCol,
+                    sheet: this.sheetId
                 }
+            };
+            const engineTargetRange = {
+                start: {
+                    row: hfTargetStartRow,
+                    col: hfTargetStartCol,
+                    sheet: this.sheetId
+                },
+                end: {
+                    row: hfTargetEndRow,
+                    col: hfTargetEndCol,
+                    sheet: this.sheetId
+                }
+            };
+            // Blocks the autofill operation if HyperFormula says that at least one of
+            // the underlying cell's contents cannot be set.
+            if (this.engine.isItPossibleToSetCellContents(engineTargetRange) === false) {
+                return false;
             }
-        });
-    });
-    _class_private_field_set(this, _internalOperationPending, true);
-    const dependentCells = this.engine.setSheetContent(this.sheetId, sourceDataArray);
-    this.indexSyncer.setupSyncEndpoint(this.engine, this.sheetId);
-    this.renderDependentSheets(dependentCells);
-    _class_private_field_set(this, _internalOperationPending, false);
-}
-function onAfterLoadData(sourceData, initialLoad, source = '') {
-    if (source.includes(toUpperCaseFirst(PLUGIN_KEY))) {
-        return;
-    }
-    const sheetName = setupSheet(this.engine, this.hot.getSettings()[PLUGIN_KEY].sheetName);
-    _class_private_method_get(this, _updateSheetNameAndSheetId, updateSheetNameAndSheetId).call(this, sheetName);
-    if (source === 'updateSettings') {
-        // For performance reasons, the initialization will be done in afterCellMetaReset hook
-        return;
-    }
-    if (!_class_private_field_get(this, _hotWasInitializedWithEmptyData)) {
-        const sourceDataArray = _class_private_method_get(this, _getProcessedSourceDataArray, getProcessedSourceDataArray).call(this);
-        if (this.engine.isItPossibleToReplaceSheetContent(this.sheetId, sourceDataArray)) {
+            const fillRangeData = this.engine.getFillRangeData(engineSourceRange, engineTargetRange);
+            const { row: sourceStartRow, col: sourceStartColumn } = engineSourceRange.start;
+            const { row: sourceEndRow, col: sourceEndColumn } = engineSourceRange.end;
+            const populationRowLength = sourceEndRow - sourceStartRow + 1;
+            const populationColumnLength = sourceEndColumn - sourceStartColumn + 1;
+            for(let populatedRowIndex = 0; populatedRowIndex < fillRangeData.length; populatedRowIndex += 1){
+                for(let populatedColumnIndex = 0; populatedColumnIndex < fillRangeData[populatedRowIndex].length; populatedColumnIndex += 1){
+                    const populatedValue = fillRangeData[populatedRowIndex][populatedColumnIndex];
+                    const sourceRow = sourceStartRow + populatedRowIndex % populationRowLength;
+                    const sourceColumn = sourceStartColumn + populatedColumnIndex % populationColumnLength;
+                    const sourceCellMeta = this.hot.getCellMeta(sourceRow, sourceColumn);
+                    if (isDate(populatedValue, sourceCellMeta.type)) {
+                        if (populatedValue.startsWith('\'')) {
+                            // Populating values on HOT side without apostrophe.
+                            fillRangeData[populatedRowIndex][populatedColumnIndex] = populatedValue.slice(1);
+                        } else if (this.isFormulaCellType(sourceRow, sourceColumn, this.sheetId) === false) {
+                            // Populating date in proper format, coming from the source cell.
+                            fillRangeData[populatedRowIndex][populatedColumnIndex] = getDateInHotFormat(populatedValue);
+                        }
+                    }
+                }
+            }
+            return fillRangeData;
+        }), _class_private_field_set(this, _onBeforeLoadData, (sourceData, initialLoad, source = '')=>{
+            if (source.includes(toUpperCaseFirst(PLUGIN_KEY))) {
+                return;
+            }
+            // This flag needs to be defined, because not passing data to HOT results in HOT auto-generating a `null`-filled
+            // initial dataset.
+            _class_private_field_set(this, _hotWasInitializedWithEmptyData, isUndefined(this.hot.getSettings().data));
+        }), _class_private_field_set(this, _onAfterCellMetaReset, ()=>{
+            if (_class_private_field_get(this, _hotWasInitializedWithEmptyData)) {
+                if (this.sheetName !== null) {
+                    this.switchSheet(this.sheetName);
+                }
+                return;
+            }
+            const sourceDataArray = _class_private_method_get(this, _getProcessedSourceDataArray, getProcessedSourceDataArray).call(this);
+            sourceDataArray.forEach((rowData, rowIndex)=>{
+                rowData.forEach((cellValue, columnIndex)=>{
+                    const cellMeta = this.hot.getCellMeta(rowIndex, columnIndex, {
+                        skipMetaExtension: true
+                    });
+                    if (isDate(cellValue, cellMeta.type)) {
+                        if (isDateValid(cellValue)) {
+                            // Rewriting date in HOT format to HF format.
+                            sourceDataArray[rowIndex][columnIndex] = getDateInHfFormat(cellValue);
+                        } else if (!cellValue.startsWith('=')) {
+                            // Escaping value from date parsing using "'" sign (HF feature).
+                            sourceDataArray[rowIndex][columnIndex] = `'${cellValue}`;
+                        }
+                    }
+                });
+            });
             _class_private_field_set(this, _internalOperationPending, true);
             const dependentCells = this.engine.setSheetContent(this.sheetId, sourceDataArray);
             this.indexSyncer.setupSyncEndpoint(this.engine, this.sheetId);
             this.renderDependentSheets(dependentCells);
             _class_private_field_set(this, _internalOperationPending, false);
-        }
-    } else {
-        this.switchSheet(this.sheetName);
-    }
-}
-function onModifyData(visualRow, visualColumn, valueHolder, ioMode) {
-    if (ioMode !== 'get' || _class_private_field_get(this, _internalOperationPending) || this.sheetName === null || !this.engine.doesSheetExist(this.sheetName)) {
-        return;
-    }
-    if (visualRow === null || visualColumn === null) {
-        return;
-    }
-    const cellType = this.getCellType(visualRow, visualColumn);
-    if (cellType === 'VALUE' || cellType === 'EMPTY') {
-        valueHolder.value = unescapeFormulaExpression(valueHolder.value);
-        return;
-    }
-    const address = {
-        row: this.rowAxisSyncer.getHfIndexFromVisualIndex(visualRow),
-        col: this.columnAxisSyncer.getHfIndexFromVisualIndex(visualColumn),
-        sheet: this.sheetId
-    };
-    let cellValue = this.engine.getCellValue(address); // Date as an integer (Excel like date).
-    const cellMeta = this.hot.getCellMeta(visualRow, visualColumn, {
-        skipMetaExtension: true
-    });
-    if (cellMeta.type === 'date' && isNumeric(cellValue)) {
-        cellValue = getDateFromExcelDate(cellValue, cellMeta.dateFormat);
-    }
-    // If `cellValue` is an object it is expected to be an error
-    valueHolder.value = typeof cellValue === 'object' && cellValue !== null ? cellValue.value : cellValue;
-}
-function onModifySourceData(row, columnOrProp, valueHolder, ioMode) {
-    if (ioMode !== 'get' || _class_private_field_get(this, _internalOperationPending) || this.sheetName === null || !this.engine.doesSheetExist(this.sheetName)) {
-        return;
-    }
-    const visualRow = this.hot.toVisualRow(row);
-    const visualColumn = this.hot.propToCol(columnOrProp);
-    if (visualRow === null || visualColumn === null) {
-        return;
-    }
-    const cellType = this.getCellType(visualRow, visualColumn);
-    if (cellType === 'VALUE' || cellType === 'EMPTY') {
-        return;
-    }
-    const dimensions = this.engine.getSheetDimensions(this.engine.getSheetId(this.sheetName));
-    // Don't actually change the source data if HyperFormula is not
-    // initialized yet. This is done to allow the `afterLoadData` hook to
-    // load the existing source data with `Handsontable#getSourceDataArray`
-    // properly.
-    if (dimensions.width === 0 && dimensions.height === 0) {
-        return;
-    }
-    const address = {
-        row: this.rowAxisSyncer.getHfIndexFromVisualIndex(visualRow),
-        col: this.columnAxisSyncer.getHfIndexFromVisualIndex(visualColumn),
-        sheet: this.sheetId
-    };
-    valueHolder.value = this.engine.getCellSerialized(address);
-}
-function onAfterSetDataAtCell(changes, source) {
-    if (isBlockedSource(source) || changes.length === 0) {
-        return;
-    }
-    const outOfBoundsChanges = [];
-    const changedCells = [];
-    const dependentCells = this.engine.batch(()=>{
-        changes.forEach(([visualRow, prop, , newValue])=>{
-            const visualColumn = this.hot.propToCol(prop);
-            const physicalRow = this.hot.toPhysicalRow(visualRow);
-            const physicalColumn = this.hot.toPhysicalColumn(visualColumn);
+        }), _class_private_field_set(this, _onAfterLoadData, (sourceData, initialLoad, source = '')=>{
+            if (source.includes(toUpperCaseFirst(PLUGIN_KEY))) {
+                return;
+            }
+            if (!this.engine) {
+                return;
+            }
+            const formulasSettings = this.hot.getSettings()[PLUGIN_KEY];
+            const settingsSheetName = isFormulasSettingsObject(formulasSettings) ? formulasSettings.sheetName : undefined;
+            const sheetName = setupSheet(this.engine, settingsSheetName);
+            _class_private_method_get(this, _updateSheetNameAndSheetId, updateSheetNameAndSheetId).call(this, sheetName);
+            if (source === 'updateSettings') {
+                // For performance reasons, the initialization will be done in afterCellMetaReset hook
+                return;
+            }
+            if (!_class_private_field_get(this, _hotWasInitializedWithEmptyData)) {
+                const sourceDataArray = _class_private_method_get(this, _getProcessedSourceDataArray, getProcessedSourceDataArray).call(this);
+                if (this.engine.isItPossibleToReplaceSheetContent(this.sheetId, sourceDataArray)) {
+                    _class_private_field_set(this, _internalOperationPending, true);
+                    const dependentCells = this.engine.setSheetContent(this.sheetId, sourceDataArray);
+                    this.indexSyncer.setupSyncEndpoint(this.engine, this.sheetId);
+                    this.renderDependentSheets(dependentCells);
+                    _class_private_field_set(this, _internalOperationPending, false);
+                }
+            } else if (this.sheetName !== null) {
+                this.switchSheet(this.sheetName);
+            }
+        }), _class_private_field_set(this, _onModifyData, (visualRow, visualColumn, valueHolder, ioMode)=>{
+            if (ioMode !== 'get' || _class_private_field_get(this, _internalOperationPending) || this.sheetName === null || !this.engine?.doesSheetExist(this.sheetName)) {
+                return;
+            }
+            if (visualRow === null || visualColumn === null) {
+                return;
+            }
+            const cellType = this.getCellType(visualRow, visualColumn);
+            if (cellType === 'VALUE' || cellType === 'EMPTY') {
+                valueHolder.value = unescapeFormulaExpression(valueHolder.value);
+                return;
+            }
             const address = {
                 row: this.rowAxisSyncer.getHfIndexFromVisualIndex(visualRow),
                 col: this.columnAxisSyncer.getHfIndexFromVisualIndex(visualColumn),
                 sheet: this.sheetId
             };
-            newValue = _class_private_method_get(this, _getValueGetterValue, getValueGetterValue1).call(this, physicalRow, physicalColumn, newValue);
-            if (physicalRow !== null && physicalColumn !== null) {
-                this.syncChangeWithEngine(visualRow, visualColumn, newValue);
-            } else {
-                outOfBoundsChanges.push([
-                    visualRow,
-                    visualColumn,
-                    newValue
+            let cellValue = this.engine.getCellValue(address); // Date as an integer (Excel like date).
+            const cellMeta = this.hot.getCellMeta(visualRow, visualColumn, {
+                skipMetaExtension: true
+            });
+            if (cellMeta.type === 'date' && isNumeric(cellValue)) {
+                cellValue = getDateFromExcelDate(cellValue);
+            } else if (cellMeta.type === 'time' && isNumeric(cellValue)) {
+                cellValue = getTimeFromHfTimeFraction(cellValue);
+            }
+            // If `cellValue` is an object it is expected to be an error
+            valueHolder.value = hasValueProperty(cellValue) ? cellValue.value : cellValue;
+        }), _class_private_field_set(this, _onModifySourceData, (row, columnOrProp, valueHolder, ioMode)=>{
+            if (ioMode !== 'get' || _class_private_field_get(this, _internalOperationPending) || this.sheetName === null || !this.engine?.doesSheetExist(this.sheetName)) {
+                return;
+            }
+            const visualRow = this.hot.toVisualRow(row);
+            const visualColumn = this.hot.propToCol(columnOrProp);
+            if (visualRow === null || visualColumn === null) {
+                return;
+            }
+            const cellType = this.getCellType(visualRow, visualColumn);
+            if (cellType === 'VALUE' || cellType === 'EMPTY') {
+                return;
+            }
+            const dimensions = this.engine.getSheetDimensions(this.engine.getSheetId(this.sheetName));
+            // Don't actually change the source data if HyperFormula is not
+            // initialized yet. This is done to allow the `afterLoadData` hook to
+            // load the existing source data with `Handsontable#getSourceDataArray`
+            // properly.
+            if (dimensions.width === 0 && dimensions.height === 0) {
+                return;
+            }
+            const address = {
+                row: this.rowAxisSyncer.getHfIndexFromVisualIndex(visualRow),
+                col: this.columnAxisSyncer.getHfIndexFromVisualIndex(visualColumn),
+                sheet: this.sheetId
+            };
+            valueHolder.value = this.engine.getCellSerialized(address);
+        }), _class_private_field_set(this, _onAfterSetDataAtCell, (changes, source)=>{
+            if (isBlockedSource(source)) {
+                return;
+            }
+            // Skip engine sync when there are no changes (e.g. populateFromArray on readOnly cells).
+            // Otherwise engine.batch() would push an empty undo step and undo would revert the wrong action (#dev-2136).
+            if (!changes?.length) {
+                return;
+            }
+            const outOfBoundsChanges = [];
+            const changedCells = [];
+            const dependentCells = this.engine.batch(()=>{
+                changes.forEach(([visualRow, prop, , newValue])=>{
+                    if (typeof prop !== 'string' && typeof prop !== 'number') {
+                        return;
+                    }
+                    const visualColumn = this.hot.propToCol(prop);
+                    const physicalRow = this.hot.toPhysicalRow(visualRow);
+                    const physicalColumn = this.hot.toPhysicalColumn(visualColumn);
+                    const address = {
+                        row: this.rowAxisSyncer.getHfIndexFromVisualIndex(visualRow),
+                        col: this.columnAxisSyncer.getHfIndexFromVisualIndex(visualColumn),
+                        sheet: this.sheetId
+                    };
+                    newValue = _class_private_method_get(this, _getValueGetterValue, getValueGetterValue1).call(this, physicalRow, physicalColumn, newValue);
+                    if (physicalRow !== null && physicalColumn !== null) {
+                        this.syncChangeWithEngine(visualRow, visualColumn, newValue);
+                    } else {
+                        outOfBoundsChanges.push([
+                            visualRow,
+                            visualColumn,
+                            newValue
+                        ]);
+                    }
+                    changedCells.push({
+                        address
+                    });
+                });
+            });
+            if (outOfBoundsChanges.length) {
+                // Workaround for rows/columns being created two times (by HOT and the engine).
+                // (unfortunately, this requires an extra re-render)
+                this.hot.addHookOnce('afterChange', ()=>{
+                    const outOfBoundsDependentCells = this.engine.batch(()=>{
+                        outOfBoundsChanges.forEach(([row, column, newValue])=>{
+                            this.syncChangeWithEngine(row, column, newValue);
+                        });
+                    });
+                    this.renderDependentSheets(outOfBoundsDependentCells, true);
+                });
+            }
+            this.renderDependentSheets(dependentCells);
+            this.validateDependentCells(dependentCells, changedCells);
+        }), _class_private_field_set(this, _onAfterSetSourceDataAtCell, (changes, source)=>{
+            if (isBlockedSource(source)) {
+                return;
+            }
+            const dependentCells = [];
+            const changedCells = [];
+            changes.forEach(([visualRow, prop, , newValue])=>{
+                if (typeof prop !== 'string' && typeof prop !== 'number') {
+                    return;
+                }
+                const visualColumn = this.hot.propToCol(prop);
+                if (!isNumeric(visualColumn)) {
+                    return;
+                }
+                const address = {
+                    row: this.rowAxisSyncer.getHfIndexFromVisualIndex(visualRow),
+                    col: this.columnAxisSyncer.getHfIndexFromVisualIndex(visualColumn),
+                    sheet: this.sheetId
+                };
+                if (!this.engine?.isItPossibleToSetCellContents(address)) {
+                    warn(`Not possible to set source cell data at ${JSON.stringify(address)}`);
+                    return;
+                }
+                newValue = normalizeValueForFormulaEngine(newValue);
+                changedCells.push({
+                    address
+                });
+                dependentCells.push(...this.engine.setCellContents(address, newValue));
+            });
+            this.renderDependentSheets(dependentCells);
+            this.validateDependentCells(dependentCells, changedCells);
+        }), _class_private_field_set(this, _onBeforeCreateRow, (visualRow, amount)=>{
+            let hfRowIndex = this.rowAxisSyncer.getHfIndexFromVisualIndex(visualRow);
+            if (visualRow >= this.hot.countRows()) {
+                hfRowIndex = visualRow; // Row beyond the table boundaries.
+            }
+            if (this.sheetId === null || !this.engine?.doesSheetExist(this.sheetName) || !this.engine?.isItPossibleToAddRows(this.sheetId, [
+                hfRowIndex,
+                amount
+            ])) {
+                return false;
+            }
+        }), _class_private_field_set(this, _onBeforeCreateCol, (visualColumn, amount)=>{
+            let hfColumnIndex = this.columnAxisSyncer.getHfIndexFromVisualIndex(visualColumn);
+            if (visualColumn >= this.hot.countCols()) {
+                hfColumnIndex = visualColumn; // Column beyond the table boundaries.
+            }
+            if (this.sheetId === null || !this.engine?.doesSheetExist(this.sheetName) || !this.engine?.isItPossibleToAddColumns(this.sheetId, [
+                hfColumnIndex,
+                amount
+            ])) {
+                return false;
+            }
+        }), _class_private_field_set(this, _onBeforeRemoveRow, (row, amount, physicalRows)=>{
+            const hfRows = this.rowAxisSyncer.setRemovedHfIndexes(physicalRows);
+            const possible = hfRows.every((hfRow)=>{
+                return this.engine?.isItPossibleToRemoveRows(this.sheetId, [
+                    hfRow,
+                    1
                 ]);
+            });
+            return possible === false ? false : undefined;
+        }), _class_private_field_set(this, _onBeforeRemoveCol, (col, amount, physicalColumns)=>{
+            const hfColumns = this.columnAxisSyncer.setRemovedHfIndexes(physicalColumns);
+            const possible = hfColumns.every((hfColumn)=>{
+                return this.engine?.isItPossibleToRemoveColumns(this.sheetId, [
+                    hfColumn,
+                    1
+                ]);
+            });
+            return possible === false ? false : undefined;
+        }), _class_private_field_set(this, _onAfterCreateRow, (visualRow, amount, source)=>{
+            if (isBlockedSource(source)) {
+                return;
+            }
+            const changes = this.engine.addRows(this.sheetId, [
+                this.rowAxisSyncer.getHfIndexFromVisualIndex(visualRow),
+                amount
+            ]);
+            this.renderDependentSheets(changes);
+        }), _class_private_field_set(this, _onAfterCreateCol, (visualColumn, amount, source)=>{
+            if (isBlockedSource(source)) {
+                return;
+            }
+            const changes = this.engine.addColumns(this.sheetId, [
+                this.columnAxisSyncer.getHfIndexFromVisualIndex(visualColumn),
+                amount
+            ]);
+            this.renderDependentSheets(changes);
+        }), _class_private_field_set(this, _onAfterRemoveRow, (row, amount, physicalRows, source)=>{
+            if (isBlockedSource(source)) {
+                return;
             }
-            changedCells.push({
-                address
+            const descendingHfRows = this.rowAxisSyncer.getRemovedHfIndexes().sort((a, b)=>b - a); // sort numeric values descending
+            const changes = this.engine.batch(()=>{
+                descendingHfRows.forEach((hfRow)=>{
+                    this.engine.removeRows(this.sheetId, [
+                        hfRow,
+                        1
+                    ]);
+                });
             });
-        });
-    });
-    if (outOfBoundsChanges.length) {
-        // Workaround for rows/columns being created two times (by HOT and the engine).
-        // (unfortunately, this requires an extra re-render)
-        this.hot.addHookOnce('afterChange', ()=>{
-            const outOfBoundsDependentCells = this.engine.batch(()=>{
-                outOfBoundsChanges.forEach(([row, column, newValue])=>{
-                    this.syncChangeWithEngine(row, column, newValue);
+            this.renderDependentSheets(changes);
+        }), _class_private_field_set(this, _onAfterRemoveCol, (col, amount, physicalColumns, source)=>{
+            if (isBlockedSource(source)) {
+                return;
+            }
+            const descendingHfColumns = this.columnAxisSyncer.getRemovedHfIndexes().sort((a, b)=>b - a); // sort numeric values descending
+            const changes = this.engine.batch(()=>{
+                descendingHfColumns.forEach((hfColumn)=>{
+                    this.engine.removeColumns(this.sheetId, [
+                        hfColumn,
+                        1
+                    ]);
+                });
+            });
+            this.renderDependentSheets(changes);
+        }), _class_private_field_set(this, _onAfterDetachChild, (parent, element, finalElementRowIndex)=>{
+            _class_private_field_set(this, _internalOperationPending, true);
+            const children = element.__children;
+            const childrenCount = Array.isArray(children) ? children.length : 0;
+            const rowsData = _class_private_method_get(this, _getProcessedSourceDataArray, getProcessedSourceDataArray).call(this, finalElementRowIndex, 0, finalElementRowIndex + childrenCount, this.hot.countSourceCols());
+            _class_private_field_set(this, _internalOperationPending, false);
+            rowsData.forEach((row, relativeRowIndex)=>{
+                row.forEach((value, colIndex)=>{
+                    this.engine?.setCellContents({
+                        col: colIndex,
+                        row: finalElementRowIndex + relativeRowIndex,
+                        sheet: this.sheetId
+                    }, [
+                        [
+                            value
+                        ]
+                    ]);
                 });
             });
-            this.renderDependentSheets(outOfBoundsDependentCells, true);
-        });
-    }
-    this.renderDependentSheets(dependentCells);
-    this.validateDependentCells(dependentCells, changedCells);
-}
-function onAfterSetSourceDataAtCell(changes, source) {
-    if (isBlockedSource(source)) {
-        return;
-    }
-    const dependentCells = [];
-    const changedCells = [];
-    changes.forEach(([visualRow, prop, , newValue])=>{
-        const visualColumn = this.hot.propToCol(prop);
-        if (!isNumeric(visualColumn)) {
-            return;
-        }
-        const address = {
-            row: this.rowAxisSyncer.getHfIndexFromVisualIndex(visualRow),
-            col: this.columnAxisSyncer.getHfIndexFromVisualIndex(visualColumn),
-            sheet: this.sheetId
-        };
-        if (!this.engine.isItPossibleToSetCellContents(address)) {
-            warn(`Not possible to set source cell data at ${JSON.stringify(address)}`);
-            return;
-        }
-        newValue = normalizeValueForFormulaEngine(newValue);
-        changedCells.push({
-            address
         });
-        dependentCells.push(...this.engine.setCellContents(address, newValue));
-    });
-    this.renderDependentSheets(dependentCells);
-    this.validateDependentCells(dependentCells, changedCells);
-}
-function onBeforeCreateRow(visualRow, amount) {
-    let hfRowIndex = this.rowAxisSyncer.getHfIndexFromVisualIndex(visualRow);
-    if (visualRow >= this.hot.countRows()) {
-        hfRowIndex = visualRow; // Row beyond the table boundaries.
-    }
-    if (this.sheetId === null || !this.engine.doesSheetExist(this.sheetName) || !this.engine.isItPossibleToAddRows(this.sheetId, [
-        hfRowIndex,
-        amount
-    ])) {
-        return false;
     }
 }
-function onBeforeCreateCol(visualColumn, amount) {
-    let hfColumnIndex = this.columnAxisSyncer.getHfIndexFromVisualIndex(visualColumn);
-    if (visualColumn >= this.hot.countCols()) {
-        hfColumnIndex = visualColumn; // Column beyond the table boundaries.
+function exportChangeValue(change) {
+    if (!change.address || change.address.sheet !== this.sheetId || typeof change.newValue !== 'number') {
+        return change;
     }
-    if (this.sheetId === null || !this.engine.doesSheetExist(this.sheetName) || !this.engine.isItPossibleToAddColumns(this.sheetId, [
-        hfColumnIndex,
-        amount
-    ])) {
-        return false;
+    const visualRow = this.rowAxisSyncer.getVisualIndexFromHfIndex(change.address.row);
+    const visualColumn = this.columnAxisSyncer.getVisualIndexFromHfIndex(change.address.col);
+    if (visualRow < 0 || visualColumn < 0) {
+        return change;
     }
-}
-function onBeforeRemoveRow(row, amount, physicalRows) {
-    const hfRows = this.rowAxisSyncer.setRemovedHfIndexes(physicalRows);
-    const possible = hfRows.every((hfRow)=>{
-        return this.engine.isItPossibleToRemoveRows(this.sheetId, [
-            hfRow,
-            1
-        ]);
-    });
-    return possible === false ? false : undefined;
-}
-function onBeforeRemoveCol(col, amount, physicalColumns) {
-    const hfColumns = this.columnAxisSyncer.setRemovedHfIndexes(physicalColumns);
-    const possible = hfColumns.every((hfColumn)=>{
-        return this.engine.isItPossibleToRemoveColumns(this.sheetId, [
-            hfColumn,
-            1
-        ]);
+    const cellMeta = this.hot.getCellMeta(visualRow, visualColumn, {
+        skipMetaExtension: true
     });
-    return possible === false ? false : undefined;
-}
-function onAfterCreateRow(visualRow, amount, source) {
-    if (isBlockedSource(source)) {
-        return;
-    }
-    const changes = this.engine.addRows(this.sheetId, [
-        this.rowAxisSyncer.getHfIndexFromVisualIndex(visualRow),
-        amount
-    ]);
-    this.renderDependentSheets(changes);
-}
-function onAfterCreateCol(visualColumn, amount, source) {
-    if (isBlockedSource(source)) {
-        return;
+    let newValue;
+    if (cellMeta.type === 'date') {
+        newValue = getDateFromExcelDate(change.newValue);
+    } else if (cellMeta.type === 'time') {
+        newValue = getTimeFromHfTimeFraction(change.newValue);
+    } else {
+        return change;
     }
-    const changes = this.engine.addColumns(this.sheetId, [
-        this.columnAxisSyncer.getHfIndexFromVisualIndex(visualColumn),
-        amount
-    ]);
-    this.renderDependentSheets(changes);
+    const clone = Object.assign(Object.create(Object.getPrototypeOf(change)), change);
+    clone.newValue = newValue;
+    return clone;
 }
-function onAfterRemoveRow(row, amount, physicalRows, source) {
-    if (isBlockedSource(source)) {
-        return;
-    }
-    const descendingHfRows = this.rowAxisSyncer.getRemovedHfIndexes().sort((a, b)=>b - a); // sort numeric values descending
-    const changes = this.engine.batch(()=>{
-        descendingHfRows.forEach((hfRow)=>{
-            this.engine.removeRows(this.sheetId, [
-                hfRow,
-                1
-            ]);
-        });
-    });
-    this.renderDependentSheets(changes);
+function updateSheetNameAndSheetId(sheetName) {
+    this.sheetName = sheetName;
+    this.sheetId = this.engine?.getSheetId(this.sheetName) ?? null;
 }
-function onAfterRemoveCol(col, amount, physicalColumns, source) {
-    if (isBlockedSource(source)) {
-        return;
+function getValueGetterValue1(row, column, value) {
+    if (isObject(value) && value !== null) {
+        const visualRow = this.hot.toVisualRow(row);
+        const visualColumn = this.hot.toVisualColumn(column);
+        const cellMeta = this.hot.getCellMeta(visualRow, visualColumn);
+        const valueGetter = cellMeta.valueGetter;
+        value = getValueGetterValue(value, this.hot.getCellMeta(visualRow, visualColumn));
+        if (value !== null && value !== undefined) {
+            value = Object(value).toString();
+        }
     }
-    const descendingHfColumns = this.columnAxisSyncer.getRemovedHfIndexes().sort((a, b)=>b - a); // sort numeric values descending
-    const changes = this.engine.batch(()=>{
-        descendingHfColumns.forEach((hfColumn)=>{
-            this.engine.removeColumns(this.sheetId, [
-                hfColumn,
-                1
-            ]);
-        });
-    });
-    this.renderDependentSheets(changes);
+    return normalizeValueForFormulaEngine(value);
 }
-function onAfterDetachChild(parent, element, finalElementRowIndex) {
-    _class_private_field_set(this, _internalOperationPending, true);
-    const rowsData = _class_private_method_get(this, _getProcessedSourceDataArray, getProcessedSourceDataArray).call(this, finalElementRowIndex, 0, finalElementRowIndex + (element.__children?.length || 0), this.hot.countSourceCols());
-    _class_private_field_set(this, _internalOperationPending, false);
-    rowsData.forEach((row, relativeRowIndex)=>{
-        row.forEach((value, colIndex)=>{
-            this.engine.setCellContents({
-                col: colIndex,
-                row: finalElementRowIndex + relativeRowIndex,
-                sheet: this.sheetId
-            }, [
-                [
-                    value
-                ]
-            ]);
+function getProcessedSourceDataArray(row, column, row2, column2) {
+    const dataArray = this.hot.getSourceDataArray(row, column, row2, column2);
+    const visibleColumnCount = this.hot.countCols();
+    const physicalColumnCount = this.hot.countSourceCols();
+    const isAoAWithSkippedColumns = visibleColumnCount < physicalColumnCount && isArrayOfArrays(this.hot.getSourceData());
+    if (!isAoAWithSkippedColumns) {
+        return dataArray.map((rowObject, rowIndex)=>{
+            const rowArray = Array.isArray(rowObject) ? rowObject : [];
+            return rowArray.map((value, columnIndex)=>{
+                return _class_private_method_get(this, _getValueGetterValue, getValueGetterValue1).call(this, rowIndex, columnIndex, value);
+            });
         });
+    }
+    // Array-of-objects data is already projected to visible columns by
+    // `dataSource.getAtRow`. Array-of-arrays data returns the full source row,
+    // so when `columns` skips physical indexes the data fed to HF misaligns
+    // with the axis-syncer's visual->HF mapping (issue #10021). Build a row
+    // containing only visible columns so HF cell coordinates stay in sync.
+    const columnOffset = column ?? 0;
+    return dataArray.map((rowArray, rowIndex)=>{
+        const projected = [];
+        for(let visualCol = 0; visualCol < visibleColumnCount; visualCol++){
+            const physicalCol = this.hot.colToProp(visualCol);
+            if (typeof physicalCol !== 'number') {
+                continue;
+            }
+            const arrayIndex = physicalCol - columnOffset;
+            if (arrayIndex < 0 || arrayIndex >= rowArray.length) {
+                continue;
+            }
+            projected.push(_class_private_method_get(this, _getValueGetterValue, getValueGetterValue1).call(this, rowIndex, visualCol, rowArray[arrayIndex]));
+        }
+        return projected;
     });
 }
-function onEngineValuesUpdated(changes) {
-    this.hot.runHooks('afterFormulasValuesUpdate', changes);
-}
-function onEngineNamedExpressionsAdded(namedExpressionName, changes) {
-    this.hot.runHooks('afterNamedExpressionAdded', namedExpressionName, changes);
-}
-function onEngineNamedExpressionsRemoved(namedExpressionName, changes) {
-    this.hot.runHooks('afterNamedExpressionRemoved', namedExpressionName, changes);
-}
-function onEngineSheetAdded(addedSheetDisplayName) {
-    this.hot.runHooks('afterSheetAdded', addedSheetDisplayName);
-}
-function onEngineSheetRenamed(oldDisplayName, newDisplayName) {
-    _class_private_method_get(this, _updateSheetNameAndSheetId, updateSheetNameAndSheetId).call(this, newDisplayName);
-    this.hot.runHooks('afterSheetRenamed', oldDisplayName, newDisplayName);
-}
-function onEngineSheetRemoved(removedSheetDisplayName, changes) {
-    this.hot.runHooks('afterSheetRemoved', removedSheetDisplayName, changes);
-}