handsontable 14.2.0 → 14.3.0-next-13fe676-20240409

package/plugins/formulas/formulas.js

@@ -1,9 +1,9 @@
 "use strict";
 
 exports.__esModule = true;
-require("core-js/modules/es.json.stringify.js");
 require("core-js/modules/es.error.cause.js");
 require("core-js/modules/es.array.push.js");
+require("core-js/modules/es.json.stringify.js");
 var _base = require("../base");
 var _staticRegister = _interopRequireDefault(require("../../utils/staticRegister"));
 var _console = require("../../helpers/console");
@@ -19,16 +19,13 @@ var _indexSyncer = _interopRequireDefault(require("./indexSyncer"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function _classPrivateMethodInitSpec(obj, privateSet) { _checkPrivateRedeclaration(obj, privateSet); privateSet.add(obj); }
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
-function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : String(i); }
+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(obj, privateMap, value) { _checkPrivateRedeclaration(obj, privateMap); privateMap.set(obj, value); }
 function _checkPrivateRedeclaration(obj, privateCollection) { if (privateCollection.has(obj)) { throw new TypeError("Cannot initialize the same private elements twice on an object"); } }
-function _classPrivateFieldSet(receiver, privateMap, value) { var descriptor = _classExtractFieldDescriptor(receiver, privateMap, "set"); _classApplyDescriptorSet(receiver, descriptor, value); return value; }
-function _classApplyDescriptorSet(receiver, descriptor, value) { if (descriptor.set) { descriptor.set.call(receiver, value); } else { if (!descriptor.writable) { throw new TypeError("attempted to set read only private field"); } descriptor.value = value; } }
-function _classPrivateFieldGet(receiver, privateMap) { var descriptor = _classExtractFieldDescriptor(receiver, privateMap, "get"); return _classApplyDescriptorGet(receiver, descriptor); }
-function _classExtractFieldDescriptor(receiver, privateMap, action) { if (!privateMap.has(receiver)) { throw new TypeError("attempted to " + action + " private field on non-instance"); } return privateMap.get(receiver); }
-function _classApplyDescriptorGet(receiver, descriptor) { if (descriptor.get) { return descriptor.get.call(receiver); } return descriptor.value; }
-function _classPrivateMethodGet(receiver, privateSet, fn) { if (!privateSet.has(receiver)) { throw new TypeError("attempted to get private field on non-instance"); } return fn; }
+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 PLUGIN_KEY = exports.PLUGIN_KEY = 'formulas';
 const SETTING_KEYS = exports.SETTING_KEYS = ['maxRows', 'maxColumns', 'language'];
 const PLUGIN_PRIORITY = exports.PLUGIN_PRIORITY = 260;
@@ -50,7 +47,7 @@ const isBlockedSource = source => source === 'UndoRedo.undo' || source === 'Undo
  * integration with our other product, [HyperFormula](https://github.com/handsontable/hyperformula/), which is a
  * powerful calculation engine with an extensive number of features.
  *
- * To test out HyperFormula, see [this guide](@/guides/formulas/formula-calculation.md#available-functions).
+ * To test out HyperFormula, see [this guide](@/guides/formulas/formula-calculation/formula-calculation.md#available-functions).
  *
  * @plugin Formulas
  * @class Formulas
@@ -58,228 +55,12 @@ const isBlockedSource = source => source === 'UndoRedo.undo' || source === 'Undo
 var _internalOperationPending = /*#__PURE__*/new WeakMap();
 var _hotWasInitializedWithEmptyData = /*#__PURE__*/new WeakMap();
 var _engineListeners = /*#__PURE__*/new WeakMap();
-var _onBeforeValidate = /*#__PURE__*/new WeakSet();
-var _onBeforeAutofill = /*#__PURE__*/new WeakSet();
-var _onBeforeLoadData = /*#__PURE__*/new WeakSet();
-var _onAfterCellMetaReset = /*#__PURE__*/new WeakSet();
-var _onAfterLoadData = /*#__PURE__*/new WeakSet();
-var _onModifyData = /*#__PURE__*/new WeakSet();
-var _onModifySourceData = /*#__PURE__*/new WeakSet();
-var _onAfterSetDataAtCell = /*#__PURE__*/new WeakSet();
-var _onAfterSetSourceDataAtCell = /*#__PURE__*/new WeakSet();
-var _onBeforeCreateRow = /*#__PURE__*/new WeakSet();
-var _onBeforeCreateCol = /*#__PURE__*/new WeakSet();
-var _onBeforeRemoveRow = /*#__PURE__*/new WeakSet();
-var _onBeforeRemoveCol = /*#__PURE__*/new WeakSet();
-var _onAfterCreateRow = /*#__PURE__*/new WeakSet();
-var _onAfterCreateCol = /*#__PURE__*/new WeakSet();
-var _onAfterRemoveRow = /*#__PURE__*/new WeakSet();
-var _onAfterRemoveCol = /*#__PURE__*/new WeakSet();
-var _onAfterDetachChild = /*#__PURE__*/new WeakSet();
-var _onEngineValuesUpdated = /*#__PURE__*/new WeakSet();
-var _onEngineNamedExpressionsAdded = /*#__PURE__*/new WeakSet();
-var _onEngineNamedExpressionsRemoved = /*#__PURE__*/new WeakSet();
-var _onEngineSheetAdded = /*#__PURE__*/new WeakSet();
-var _onEngineSheetRenamed = /*#__PURE__*/new WeakSet();
-var _onEngineSheetRemoved = /*#__PURE__*/new WeakSet();
+var _Formulas_brand = /*#__PURE__*/new WeakSet();
 class Formulas extends _base.BasePlugin {
   constructor() {
     var _this;
     super(...arguments);
     _this = this;
-    /**
-     * 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.
-     */
-    _classPrivateMethodInitSpec(this, _onEngineSheetRemoved);
-    /**
-     * 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.
-     */
-    _classPrivateMethodInitSpec(this, _onEngineSheetRenamed);
-    /**
-     * Called when a new sheet is added to the engine instance.
-     *
-     * @fires Hooks#afterSheetAdded
-     * @param {string} addedSheetDisplayName The name of the added sheet.
-     */
-    _classPrivateMethodInitSpec(this, _onEngineSheetAdded);
-    /**
-     * 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.
-     */
-    _classPrivateMethodInitSpec(this, _onEngineNamedExpressionsRemoved);
-    /**
-     * 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.
-     */
-    _classPrivateMethodInitSpec(this, _onEngineNamedExpressionsAdded);
-    /**
-     * Called when a value is updated in the engine.
-     *
-     * @fires Hooks#afterFormulasValuesUpdate
-     * @param {Array} changes The values and location of applied changes.
-     */
-    _classPrivateMethodInitSpec(this, _onEngineValuesUpdated);
-    /**
-     * `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.
-     */
-    _classPrivateMethodInitSpec(this, _onAfterDetachChild);
-    /**
-     * `afterRemoveCol` hook callback.
-     *
-     * @param {number} col Visual index of starter column.
-     * @param {number} amount An amount of removed columns.
-     * @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}).
-     */
-    _classPrivateMethodInitSpec(this, _onAfterRemoveCol);
-    /**
-     * `afterRemoveRow` hook callback.
-     *
-     * @param {number} row Visual index of starter row.
-     * @param {number} amount An amount of removed rows.
-     * @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}).
-     */
-    _classPrivateMethodInitSpec(this, _onAfterRemoveRow);
-    /**
-     * `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}).
-     */
-    _classPrivateMethodInitSpec(this, _onAfterCreateCol);
-    /**
-     * `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}).
-     */
-    _classPrivateMethodInitSpec(this, _onAfterCreateRow);
-    /**
-     * `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.
-     */
-    _classPrivateMethodInitSpec(this, _onBeforeRemoveCol);
-    /**
-     * `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.
-     */
-    _classPrivateMethodInitSpec(this, _onBeforeRemoveRow);
-    /**
-     * `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.
-     */
-    _classPrivateMethodInitSpec(this, _onBeforeCreateCol);
-    /**
-     * `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.
-     */
-    _classPrivateMethodInitSpec(this, _onBeforeCreateRow);
-    /**
-     * `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}).
-     */
-    _classPrivateMethodInitSpec(this, _onAfterSetSourceDataAtCell);
-    /**
-     * `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}).
-     */
-    _classPrivateMethodInitSpec(this, _onAfterSetDataAtCell);
-    /**
-     * `modifySourceData` hook callback.
-     *
-     * @param {number} row Physical row index.
-     * @param {number|string} columnOrProp Physical column index or prop.
-     * @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`).
-     */
-    _classPrivateMethodInitSpec(this, _onModifySourceData);
-    /**
-     * `modifyData` hook callback.
-     *
-     * @param {number} physicalRow Physical row index.
-     * @param {number} visualColumn Visual column index.
-     * @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`).
-     */
-    _classPrivateMethodInitSpec(this, _onModifyData);
-    /**
-     * `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.
-     */
-    _classPrivateMethodInitSpec(this, _onAfterLoadData);
-    /**
-     * Callback to `afterCellMetaReset` hook which is triggered after setting cell meta.
-     */
-    _classPrivateMethodInitSpec(this, _onAfterCellMetaReset);
-    /**
-     * `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.
-     */
-    _classPrivateMethodInitSpec(this, _onBeforeLoadData);
-    /**
-     * `onBeforeAutofill` hook callback.
-     *
-     * @param {Array[]} fillData The data that was used to fill the `targetRange`. If `beforeAutofill` was used
-     * and returned `[[]]`, this will be the same object that was returned from `beforeAutofill`.
-     * @param {CellRange} sourceRange The range values will be filled from.
-     * @param {CellRange} targetRange The range new values will be filled into.
-     * @returns {boolean|*}
-     */
-    _classPrivateMethodInitSpec(this, _onBeforeAutofill);
     /**
      * The hook allows to translate the formula value to calculated value before it goes to the
      * validator function.
@@ -289,66 +70,57 @@ class Formulas extends _base.BasePlugin {
      * @param {number|string} prop The visual column index or property name of the column.
      * @returns {*} Returns value to validate.
      */
-    _classPrivateMethodInitSpec(this, _onBeforeValidate);
+    _classPrivateMethodInitSpec(this, _Formulas_brand);
     /**
      * Flag used to bypass hooks in internal operations.
      *
      * @private
      * @type {boolean}
      */
-    _classPrivateFieldInitSpec(this, _internalOperationPending, {
-      writable: true,
-      value: false
-    });
+    _classPrivateFieldInitSpec(this, _internalOperationPending, false);
     /**
      * Flag needed to mark if Handsontable was initialized with no data.
      * (Required to work around the fact, that Handsontable auto-generates sample data, when no data is provided).
      *
      * @type {boolean}
      */
-    _classPrivateFieldInitSpec(this, _hotWasInitializedWithEmptyData, {
-      writable: true,
-      value: false
-    });
+    _classPrivateFieldInitSpec(this, _hotWasInitializedWithEmptyData, false);
     /**
      * The list of the HyperFormula listeners.
      *
      * @type {Array}
      */
-    _classPrivateFieldInitSpec(this, _engineListeners, {
-      writable: true,
-      value: [['valuesUpdated', function () {
-        for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
-          args[_key] = arguments[_key];
-        }
-        return _classPrivateMethodGet(_this, _onEngineValuesUpdated, _onEngineValuesUpdated2).call(_this, ...args);
-      }], ['namedExpressionAdded', function () {
-        for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
-          args[_key2] = arguments[_key2];
-        }
-        return _classPrivateMethodGet(_this, _onEngineNamedExpressionsAdded, _onEngineNamedExpressionsAdded2).call(_this, ...args);
-      }], ['namedExpressionRemoved', function () {
-        for (var _len3 = arguments.length, args = new Array(_len3), _key3 = 0; _key3 < _len3; _key3++) {
-          args[_key3] = arguments[_key3];
-        }
-        return _classPrivateMethodGet(_this, _onEngineNamedExpressionsRemoved, _onEngineNamedExpressionsRemoved2).call(_this, ...args);
-      }], ['sheetAdded', function () {
-        for (var _len4 = arguments.length, args = new Array(_len4), _key4 = 0; _key4 < _len4; _key4++) {
-          args[_key4] = arguments[_key4];
-        }
-        return _classPrivateMethodGet(_this, _onEngineSheetAdded, _onEngineSheetAdded2).call(_this, ...args);
-      }], ['sheetRenamed', function () {
-        for (var _len5 = arguments.length, args = new Array(_len5), _key5 = 0; _key5 < _len5; _key5++) {
-          args[_key5] = arguments[_key5];
-        }
-        return _classPrivateMethodGet(_this, _onEngineSheetRenamed, _onEngineSheetRenamed2).call(_this, ...args);
-      }], ['sheetRemoved', function () {
-        for (var _len6 = arguments.length, args = new Array(_len6), _key6 = 0; _key6 < _len6; _key6++) {
-          args[_key6] = arguments[_key6];
-        }
-        return _classPrivateMethodGet(_this, _onEngineSheetRemoved, _onEngineSheetRemoved2).call(_this, ...args);
-      }]]
-    });
+    _classPrivateFieldInitSpec(this, _engineListeners, [['valuesUpdated', function () {
+      for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+        args[_key] = arguments[_key];
+      }
+      return _assertClassBrand(_Formulas_brand, _this, _onEngineValuesUpdated).call(_this, ...args);
+    }], ['namedExpressionAdded', function () {
+      for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
+        args[_key2] = arguments[_key2];
+      }
+      return _assertClassBrand(_Formulas_brand, _this, _onEngineNamedExpressionsAdded).call(_this, ...args);
+    }], ['namedExpressionRemoved', function () {
+      for (var _len3 = arguments.length, args = new Array(_len3), _key3 = 0; _key3 < _len3; _key3++) {
+        args[_key3] = arguments[_key3];
+      }
+      return _assertClassBrand(_Formulas_brand, _this, _onEngineNamedExpressionsRemoved).call(_this, ...args);
+    }], ['sheetAdded', function () {
+      for (var _len4 = arguments.length, args = new Array(_len4), _key4 = 0; _key4 < _len4; _key4++) {
+        args[_key4] = arguments[_key4];
+      }
+      return _assertClassBrand(_Formulas_brand, _this, _onEngineSheetAdded).call(_this, ...args);
+    }], ['sheetRenamed', function () {
+      for (var _len5 = arguments.length, args = new Array(_len5), _key5 = 0; _key5 < _len5; _key5++) {
+        args[_key5] = arguments[_key5];
+      }
+      return _assertClassBrand(_Formulas_brand, _this, _onEngineSheetRenamed).call(_this, ...args);
+    }], ['sheetRemoved', function () {
+      for (var _len6 = arguments.length, args = new Array(_len6), _key6 = 0; _key6 < _len6; _key6++) {
+        args[_key6] = arguments[_key6];
+      }
+      return _assertClassBrand(_Formulas_brand, _this, _onEngineSheetRemoved).call(_this, ...args);
+    }]]);
     /**
      * Static register used to set up one global HyperFormula instance.
      * TODO: currently used in tests, might be removed later.
@@ -443,13 +215,13 @@ class Formulas extends _base.BasePlugin {
       for (var _len7 = arguments.length, args = new Array(_len7), _key7 = 0; _key7 < _len7; _key7++) {
         args[_key7] = arguments[_key7];
       }
-      return _classPrivateMethodGet(_this2, _onBeforeLoadData, _onBeforeLoadData2).call(_this2, ...args);
+      return _assertClassBrand(_Formulas_brand, _this2, _onBeforeLoadData).call(_this2, ...args);
     });
     this.addHook('afterLoadData', function () {
       for (var _len8 = arguments.length, args = new Array(_len8), _key8 = 0; _key8 < _len8; _key8++) {
         args[_key8] = arguments[_key8];
       }
-      return _classPrivateMethodGet(_this2, _onAfterLoadData, _onAfterLoadData2).call(_this2, ...args);
+      return _assertClassBrand(_Formulas_brand, _this2, _onAfterLoadData).call(_this2, ...args);
     });
 
     // The `updateData` hooks utilize the same logic as the `loadData` hooks.
@@ -457,97 +229,97 @@ class Formulas extends _base.BasePlugin {
       for (var _len9 = arguments.length, args = new Array(_len9), _key9 = 0; _key9 < _len9; _key9++) {
         args[_key9] = arguments[_key9];
       }
-      return _classPrivateMethodGet(_this2, _onBeforeLoadData, _onBeforeLoadData2).call(_this2, ...args);
+      return _assertClassBrand(_Formulas_brand, _this2, _onBeforeLoadData).call(_this2, ...args);
     });
     this.addHook('afterUpdateData', function () {
       for (var _len10 = arguments.length, args = new Array(_len10), _key10 = 0; _key10 < _len10; _key10++) {
         args[_key10] = arguments[_key10];
       }
-      return _classPrivateMethodGet(_this2, _onAfterLoadData, _onAfterLoadData2).call(_this2, ...args);
+      return _assertClassBrand(_Formulas_brand, _this2, _onAfterLoadData).call(_this2, ...args);
     });
     this.addHook('modifyData', function () {
       for (var _len11 = arguments.length, args = new Array(_len11), _key11 = 0; _key11 < _len11; _key11++) {
         args[_key11] = arguments[_key11];
       }
-      return _classPrivateMethodGet(_this2, _onModifyData, _onModifyData2).call(_this2, ...args);
+      return _assertClassBrand(_Formulas_brand, _this2, _onModifyData).call(_this2, ...args);
     });
     this.addHook('modifySourceData', function () {
       for (var _len12 = arguments.length, args = new Array(_len12), _key12 = 0; _key12 < _len12; _key12++) {
         args[_key12] = arguments[_key12];
       }
-      return _classPrivateMethodGet(_this2, _onModifySourceData, _onModifySourceData2).call(_this2, ...args);
+      return _assertClassBrand(_Formulas_brand, _this2, _onModifySourceData).call(_this2, ...args);
     });
     this.addHook('beforeValidate', function () {
       for (var _len13 = arguments.length, args = new Array(_len13), _key13 = 0; _key13 < _len13; _key13++) {
         args[_key13] = arguments[_key13];
       }
-      return _classPrivateMethodGet(_this2, _onBeforeValidate, _onBeforeValidate2).call(_this2, ...args);
+      return _assertClassBrand(_Formulas_brand, _this2, _onBeforeValidate).call(_this2, ...args);
     });
     this.addHook('afterSetSourceDataAtCell', function () {
       for (var _len14 = arguments.length, args = new Array(_len14), _key14 = 0; _key14 < _len14; _key14++) {
         args[_key14] = arguments[_key14];
       }
-      return _classPrivateMethodGet(_this2, _onAfterSetSourceDataAtCell, _onAfterSetSourceDataAtCell2).call(_this2, ...args);
+      return _assertClassBrand(_Formulas_brand, _this2, _onAfterSetSourceDataAtCell).call(_this2, ...args);
     });
     this.addHook('afterSetDataAtCell', function () {
       for (var _len15 = arguments.length, args = new Array(_len15), _key15 = 0; _key15 < _len15; _key15++) {
         args[_key15] = arguments[_key15];
       }
-      return _classPrivateMethodGet(_this2, _onAfterSetDataAtCell, _onAfterSetDataAtCell2).call(_this2, ...args);
+      return _assertClassBrand(_Formulas_brand, _this2, _onAfterSetDataAtCell).call(_this2, ...args);
     });
     this.addHook('afterSetDataAtRowProp', function () {
       for (var _len16 = arguments.length, args = new Array(_len16), _key16 = 0; _key16 < _len16; _key16++) {
         args[_key16] = arguments[_key16];
       }
-      return _classPrivateMethodGet(_this2, _onAfterSetDataAtCell, _onAfterSetDataAtCell2).call(_this2, ...args);
+      return _assertClassBrand(_Formulas_brand, _this2, _onAfterSetDataAtCell).call(_this2, ...args);
     });
     this.addHook('beforeCreateRow', function () {
       for (var _len17 = arguments.length, args = new Array(_len17), _key17 = 0; _key17 < _len17; _key17++) {
         args[_key17] = arguments[_key17];
       }
-      return _classPrivateMethodGet(_this2, _onBeforeCreateRow, _onBeforeCreateRow2).call(_this2, ...args);
+      return _assertClassBrand(_Formulas_brand, _this2, _onBeforeCreateRow).call(_this2, ...args);
     });
     this.addHook('beforeCreateCol', function () {
       for (var _len18 = arguments.length, args = new Array(_len18), _key18 = 0; _key18 < _len18; _key18++) {
         args[_key18] = arguments[_key18];
       }
-      return _classPrivateMethodGet(_this2, _onBeforeCreateCol, _onBeforeCreateCol2).call(_this2, ...args);
+      return _assertClassBrand(_Formulas_brand, _this2, _onBeforeCreateCol).call(_this2, ...args);
     });
     this.addHook('afterCreateRow', function () {
       for (var _len19 = arguments.length, args = new Array(_len19), _key19 = 0; _key19 < _len19; _key19++) {
         args[_key19] = arguments[_key19];
       }
-      return _classPrivateMethodGet(_this2, _onAfterCreateRow, _onAfterCreateRow2).call(_this2, ...args);
+      return _assertClassBrand(_Formulas_brand, _this2, _onAfterCreateRow).call(_this2, ...args);
     });
     this.addHook('afterCreateCol', function () {
       for (var _len20 = arguments.length, args = new Array(_len20), _key20 = 0; _key20 < _len20; _key20++) {
         args[_key20] = arguments[_key20];
       }
-      return _classPrivateMethodGet(_this2, _onAfterCreateCol, _onAfterCreateCol2).call(_this2, ...args);
+      return _assertClassBrand(_Formulas_brand, _this2, _onAfterCreateCol).call(_this2, ...args);
     });
     this.addHook('beforeRemoveRow', function () {
       for (var _len21 = arguments.length, args = new Array(_len21), _key21 = 0; _key21 < _len21; _key21++) {
         args[_key21] = arguments[_key21];
       }
-      return _classPrivateMethodGet(_this2, _onBeforeRemoveRow, _onBeforeRemoveRow2).call(_this2, ...args);
+      return _assertClassBrand(_Formulas_brand, _this2, _onBeforeRemoveRow).call(_this2, ...args);
     });
     this.addHook('beforeRemoveCol', function () {
       for (var _len22 = arguments.length, args = new Array(_len22), _key22 = 0; _key22 < _len22; _key22++) {
         args[_key22] = arguments[_key22];
       }
-      return _classPrivateMethodGet(_this2, _onBeforeRemoveCol, _onBeforeRemoveCol2).call(_this2, ...args);
+      return _assertClassBrand(_Formulas_brand, _this2, _onBeforeRemoveCol).call(_this2, ...args);
     });
     this.addHook('afterRemoveRow', function () {
       for (var _len23 = arguments.length, args = new Array(_len23), _key23 = 0; _key23 < _len23; _key23++) {
         args[_key23] = arguments[_key23];
       }
-      return _classPrivateMethodGet(_this2, _onAfterRemoveRow, _onAfterRemoveRow2).call(_this2, ...args);
+      return _assertClassBrand(_Formulas_brand, _this2, _onAfterRemoveRow).call(_this2, ...args);
     });
     this.addHook('afterRemoveCol', function () {
       for (var _len24 = arguments.length, args = new Array(_len24), _key24 = 0; _key24 < _len24; _key24++) {
         args[_key24] = arguments[_key24];
       }
-      return _classPrivateMethodGet(_this2, _onAfterRemoveCol, _onAfterRemoveCol2).call(_this2, ...args);
+      return _assertClassBrand(_Formulas_brand, _this2, _onAfterRemoveCol).call(_this2, ...args);
     });
     this.indexSyncer = new _indexSyncer.default(this.hot.rowIndexMapper, this.hot.columnIndexMapper, postponedAction => {
       this.hot.addHookOnce('init', () => {
@@ -592,7 +364,7 @@ class Formulas extends _base.BasePlugin {
       for (var _len25 = arguments.length, args = new Array(_len25), _key25 = 0; _key25 < _len25; _key25++) {
         args[_key25] = arguments[_key25];
       }
-      return _classPrivateMethodGet(_this2, _onAfterCellMetaReset, _onAfterCellMetaReset2).call(_this2, ...args);
+      return _assertClassBrand(_Formulas_brand, _this2, _onAfterCellMetaReset).call(_this2, ...args);
     });
 
     // Handling undo actions on data just using HyperFormula's UndoRedo mechanism
@@ -616,15 +388,15 @@ class Formulas extends _base.BasePlugin {
       for (var _len26 = arguments.length, args = new Array(_len26), _key26 = 0; _key26 < _len26; _key26++) {
         args[_key26] = arguments[_key26];
       }
-      return _classPrivateMethodGet(_this2, _onAfterDetachChild, _onAfterDetachChild2).call(_this2, ...args);
+      return _assertClassBrand(_Formulas_brand, _this2, _onAfterDetachChild).call(_this2, ...args);
     });
     this.addHook('beforeAutofill', function () {
       for (var _len27 = arguments.length, args = new Array(_len27), _key27 = 0; _key27 < _len27; _key27++) {
         args[_key27] = arguments[_key27];
       }
-      return _classPrivateMethodGet(_this2, _onBeforeAutofill, _onBeforeAutofill2).call(_this2, ...args);
+      return _assertClassBrand(_Formulas_brand, _this2, _onBeforeAutofill).call(_this2, ...args);
     });
-    _classPrivateFieldGet(this, _engineListeners).forEach(_ref => {
+    _classPrivateFieldGet(_engineListeners, this).forEach(_ref => {
       let [eventName, listener] = _ref;
       return this.engine.on(eventName, listener);
     });
@@ -635,7 +407,7 @@ class Formulas extends _base.BasePlugin {
    * Disables the plugin functionality for this Handsontable instance.
    */
   disablePlugin() {
-    _classPrivateFieldGet(this, _engineListeners).forEach(_ref2 => {
+    _classPrivateFieldGet(_engineListeners, this).forEach(_ref2 => {
       let [eventName, listener] = _ref2;
       return this.engine.off(eventName, listener);
     });
@@ -677,12 +449,12 @@ class Formulas extends _base.BasePlugin {
    * Destroys the plugin instance.
    */
   destroy() {
-    _classPrivateFieldGet(this, _engineListeners).forEach(_ref3 => {
+    _classPrivateFieldGet(_engineListeners, this).forEach(_ref3 => {
       var _this$engine;
       let [eventName, listener] = _ref3;
       return (_this$engine = this.engine) === null || _this$engine === void 0 ? void 0 : _this$engine.off(eventName, listener);
     });
-    _classPrivateFieldSet(this, _engineListeners, null);
+    _classPrivateFieldSet(_engineListeners, this, null);
     (0, _register.unregisterEngine)(this.engine, this.hot);
     this.engine = null;
     super.destroy();
@@ -892,7 +664,7 @@ class Formulas extends _base.BasePlugin {
   }
 }
 exports.Formulas = Formulas;
-function _onBeforeValidate2(value, visualRow, prop) {
+function _onBeforeValidate(value, visualRow, prop) {
   const visualColumn = this.hot.propToCol(prop);
   if (this.isFormulaCellType(visualRow, visualColumn)) {
     const address = {
@@ -912,7 +684,16 @@ function _onBeforeValidate2(value, visualRow, prop) {
   }
   return value;
 }
-function _onBeforeAutofill2(fillData, sourceRange, targetRange) {
+/**
+ * `onBeforeAutofill` hook callback.
+ *
+ * @param {Array[]} fillData The data that was used to fill the `targetRange`. If `beforeAutofill` was used
+ * and returned `[[]]`, this will be the same object that was returned from `beforeAutofill`.
+ * @param {CellRange} sourceRange The range values will be filled from.
+ * @param {CellRange} targetRange The range new values will be filled into.
+ * @returns {boolean|*}
+ */
+function _onBeforeAutofill(fillData, sourceRange, targetRange) {
   const {
     row: sourceTopStartRow,
     col: sourceTopStartColumn
@@ -989,7 +770,14 @@ function _onBeforeAutofill2(fillData, sourceRange, targetRange) {
   }
   return fillRangeData;
 }
-function _onBeforeLoadData2(sourceData, initialLoad) {
+/**
+ * `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.
+ */
+function _onBeforeLoadData(sourceData, initialLoad) {
   let source = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : '';
   if (source.includes((0, _string.toUpperCaseFirst)(PLUGIN_KEY))) {
     return;
@@ -997,9 +785,12 @@ function _onBeforeLoadData2(sourceData, initialLoad) {
 
   // This flag needs to be defined, because not passing data to HOT results in HOT auto-generating a `null`-filled
   // initial dataset.
-  _classPrivateFieldSet(this, _hotWasInitializedWithEmptyData, (0, _mixed.isUndefined)(this.hot.getSettings().data));
+  _classPrivateFieldSet(_hotWasInitializedWithEmptyData, this, (0, _mixed.isUndefined)(this.hot.getSettings().data));
 }
-function _onAfterCellMetaReset2() {
+/**
+ * Callback to `afterCellMetaReset` hook which is triggered after setting cell meta.
+ */
+function _onAfterCellMetaReset() {
   const sourceDataArray = this.hot.getSourceDataArray();
   let valueChanged = false;
   sourceDataArray.forEach((rowData, rowIndex) => {
@@ -1019,32 +810,48 @@ function _onAfterCellMetaReset2() {
     });
   });
   if (valueChanged === true) {
-    _classPrivateFieldSet(this, _internalOperationPending, true);
+    _classPrivateFieldSet(_internalOperationPending, this, true);
     this.engine.setSheetContent(this.sheetId, sourceDataArray);
-    _classPrivateFieldSet(this, _internalOperationPending, false);
+    _classPrivateFieldSet(_internalOperationPending, this, false);
   }
 }
-function _onAfterLoadData2(sourceData, initialLoad) {
+/**
+ * `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.
+ */
+function _onAfterLoadData(sourceData, initialLoad) {
   let source = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : '';
   if (source.includes((0, _string.toUpperCaseFirst)(PLUGIN_KEY))) {
     return;
   }
   this.sheetName = (0, _register.setupSheet)(this.engine, this.hot.getSettings()[PLUGIN_KEY].sheetName);
-  if (!_classPrivateFieldGet(this, _hotWasInitializedWithEmptyData)) {
+  if (!_classPrivateFieldGet(_hotWasInitializedWithEmptyData, this)) {
     const sourceDataArray = this.hot.getSourceDataArray();
     if (this.engine.isItPossibleToReplaceSheetContent(this.sheetId, sourceDataArray)) {
-      _classPrivateFieldSet(this, _internalOperationPending, true);
+      _classPrivateFieldSet(_internalOperationPending, this, true);
       const dependentCells = this.engine.setSheetContent(this.sheetId, sourceDataArray);
       this.indexSyncer.setupSyncEndpoint(this.engine, this.sheetId);
       this.renderDependentSheets(dependentCells);
-      _classPrivateFieldSet(this, _internalOperationPending, false);
+      _classPrivateFieldSet(_internalOperationPending, this, false);
     }
   } else {
     this.switchSheet(this.sheetName);
   }
 }
-function _onModifyData2(physicalRow, visualColumn, valueHolder, ioMode) {
-  if (ioMode !== 'get' || _classPrivateFieldGet(this, _internalOperationPending) || this.sheetName === null || !this.engine.doesSheetExist(this.sheetName)) {
+/**
+ * `modifyData` hook callback.
+ *
+ * @param {number} physicalRow Physical row index.
+ * @param {number} visualColumn Visual column index.
+ * @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`).
+ */
+function _onModifyData(physicalRow, visualColumn, valueHolder, ioMode) {
+  if (ioMode !== 'get' || _classPrivateFieldGet(_internalOperationPending, this) || this.sheetName === null || !this.engine.doesSheetExist(this.sheetName)) {
     return;
   }
   const visualRow = this.hot.toVisualRow(physicalRow);
@@ -1086,8 +893,17 @@ function _onModifyData2(physicalRow, visualColumn, valueHolder, ioMode) {
   const value = typeof cellValue === 'object' && cellValue !== null ? cellValue.value : cellValue;
   valueHolder.value = value;
 }
-function _onModifySourceData2(row, columnOrProp, valueHolder, ioMode) {
-  if (ioMode !== 'get' || _classPrivateFieldGet(this, _internalOperationPending) || this.sheetName === null || !this.engine.doesSheetExist(this.sheetName)) {
+/**
+ * `modifySourceData` hook callback.
+ *
+ * @param {number} row Physical row index.
+ * @param {number|string} columnOrProp Physical column index or prop.
+ * @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`).
+ */
+function _onModifySourceData(row, columnOrProp, valueHolder, ioMode) {
+  if (ioMode !== 'get' || _classPrivateFieldGet(_internalOperationPending, this) || this.sheetName === null || !this.engine.doesSheetExist(this.sheetName)) {
     return;
   }
   const visualRow = this.hot.toVisualRow(row);
@@ -1120,7 +936,14 @@ function _onModifySourceData2(row, columnOrProp, valueHolder, ioMode) {
   };
   valueHolder.value = this.engine.getCellSerialized(address);
 }
-function _onAfterSetDataAtCell2(changes, source) {
+/**
+ * `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}).
+ */
+function _onAfterSetDataAtCell(changes, source) {
   if (isBlockedSource(source)) {
     return;
   }
@@ -1163,7 +986,14 @@ function _onAfterSetDataAtCell2(changes, source) {
   this.renderDependentSheets(dependentCells);
   this.validateDependentCells(dependentCells, changedCells);
 }
-function _onAfterSetSourceDataAtCell2(changes, source) {
+/**
+ * `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}).
+ */
+function _onAfterSetSourceDataAtCell(changes, source) {
   if (isBlockedSource(source)) {
     return;
   }
@@ -1192,7 +1022,14 @@ function _onAfterSetSourceDataAtCell2(changes, source) {
   this.renderDependentSheets(dependentCells);
   this.validateDependentCells(dependentCells, changedCells);
 }
-function _onBeforeCreateRow2(visualRow, amount) {
+/**
+ * `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.
+ */
+function _onBeforeCreateRow(visualRow, amount) {
   let hfRowIndex = this.rowAxisSyncer.getHfIndexFromVisualIndex(visualRow);
   if (visualRow >= this.hot.countRows()) {
     hfRowIndex = visualRow; // Row beyond the table boundaries.
@@ -1201,7 +1038,14 @@ function _onBeforeCreateRow2(visualRow, amount) {
     return false;
   }
 }
-function _onBeforeCreateCol2(visualColumn, amount) {
+/**
+ * `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.
+ */
+function _onBeforeCreateCol(visualColumn, amount) {
   let hfColumnIndex = this.columnAxisSyncer.getHfIndexFromVisualIndex(visualColumn);
   if (visualColumn >= this.hot.countCols()) {
     hfColumnIndex = visualColumn; // Column beyond the table boundaries.
@@ -1210,35 +1054,76 @@ function _onBeforeCreateCol2(visualColumn, amount) {
     return false;
   }
 }
-function _onBeforeRemoveRow2(row, amount, physicalRows) {
+/**
+ * `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.
+ */
+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 _onBeforeRemoveCol2(col, amount, physicalColumns) {
+/**
+ * `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.
+ */
+function _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;
 }
-function _onAfterCreateRow2(visualRow, amount, source) {
+/**
+ * `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}).
+ */
+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 _onAfterCreateCol2(visualColumn, amount, source) {
+/**
+ * `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}).
+ */
+function _onAfterCreateCol(visualColumn, amount, source) {
   if (isBlockedSource(source)) {
     return;
   }
   const changes = this.engine.addColumns(this.sheetId, [this.columnAxisSyncer.getHfIndexFromVisualIndex(visualColumn), amount]);
   this.renderDependentSheets(changes);
 }
-function _onAfterRemoveRow2(row, amount, physicalRows, source) {
+/**
+ * `afterRemoveRow` hook callback.
+ *
+ * @param {number} row Visual index of starter row.
+ * @param {number} amount An amount of removed rows.
+ * @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}).
+ */
+function _onAfterRemoveRow(row, amount, physicalRows, source) {
   if (isBlockedSource(source)) {
     return;
   }
@@ -1250,7 +1135,16 @@ function _onAfterRemoveRow2(row, amount, physicalRows, source) {
   });
   this.renderDependentSheets(changes);
 }
-function _onAfterRemoveCol2(col, amount, physicalColumns, source) {
+/**
+ * `afterRemoveCol` hook callback.
+ *
+ * @param {number} col Visual index of starter column.
+ * @param {number} amount An amount of removed columns.
+ * @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}).
+ */
+function _onAfterRemoveCol(col, amount, physicalColumns, source) {
   if (isBlockedSource(source)) {
     return;
   }
@@ -1262,11 +1156,19 @@ function _onAfterRemoveCol2(col, amount, physicalColumns, source) {
   });
   this.renderDependentSheets(changes);
 }
-function _onAfterDetachChild2(parent, element, finalElementRowIndex) {
+/**
+ * `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.
+ */
+function _onAfterDetachChild(parent, element, finalElementRowIndex) {
   var _element$__children;
-  _classPrivateFieldSet(this, _internalOperationPending, true);
+  _classPrivateFieldSet(_internalOperationPending, this, true);
   const rowsData = this.hot.getSourceDataArray(finalElementRowIndex, 0, finalElementRowIndex + (((_element$__children = element.__children) === null || _element$__children === void 0 ? void 0 : _element$__children.length) || 0), this.hot.countSourceCols());
-  _classPrivateFieldSet(this, _internalOperationPending, false);
+  _classPrivateFieldSet(_internalOperationPending, this, false);
   rowsData.forEach((row, relativeRowIndex) => {
     row.forEach((value, colIndex) => {
       this.engine.setCellContents({
@@ -1277,22 +1179,62 @@ function _onAfterDetachChild2(parent, element, finalElementRowIndex) {
     });
   });
 }
-function _onEngineValuesUpdated2(changes) {
+/**
+ * Called when a value is updated in the engine.
+ *
+ * @fires Hooks#afterFormulasValuesUpdate
+ * @param {Array} changes The values and location of applied changes.
+ */
+function _onEngineValuesUpdated(changes) {
   this.hot.runHooks('afterFormulasValuesUpdate', changes);
 }
-function _onEngineNamedExpressionsAdded2(namedExpressionName, changes) {
+/**
+ * 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.
+ */
+function _onEngineNamedExpressionsAdded(namedExpressionName, changes) {
   this.hot.runHooks('afterNamedExpressionAdded', namedExpressionName, changes);
 }
-function _onEngineNamedExpressionsRemoved2(namedExpressionName, changes) {
+/**
+ * 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.
+ */
+function _onEngineNamedExpressionsRemoved(namedExpressionName, changes) {
   this.hot.runHooks('afterNamedExpressionRemoved', namedExpressionName, changes);
 }
-function _onEngineSheetAdded2(addedSheetDisplayName) {
+/**
+ * Called when a new sheet is added to the engine instance.
+ *
+ * @fires Hooks#afterSheetAdded
+ * @param {string} addedSheetDisplayName The name of the added sheet.
+ */
+function _onEngineSheetAdded(addedSheetDisplayName) {
   this.hot.runHooks('afterSheetAdded', addedSheetDisplayName);
 }
-function _onEngineSheetRenamed2(oldDisplayName, newDisplayName) {
+/**
+ * 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.
+ */
+function _onEngineSheetRenamed(oldDisplayName, newDisplayName) {
   this.sheetName = newDisplayName;
   this.hot.runHooks('afterSheetRenamed', oldDisplayName, newDisplayName);
 }
-function _onEngineSheetRemoved2(removedSheetDisplayName, changes) {
+/**
+ * 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.
+ */
+function _onEngineSheetRemoved(removedSheetDisplayName, changes) {
   this.hot.runHooks('afterSheetRemoved', removedSheetDisplayName, changes);
 }