handsontable 12.1.3 → 12.2.0

package/dataMap/metaManager/index.mjs

@@ -1,55 +1,46 @@
 import "core-js/modules/es.object.to-string.js";
 import "core-js/modules/web.dom-collections.for-each.js";
-
 function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
-
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
-
 function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
-
 import GlobalMeta from "./metaLayers/globalMeta.mjs";
 import TableMeta from "./metaLayers/tableMeta.mjs";
 import ColumnMeta from "./metaLayers/columnMeta.mjs";
 import CellMeta from "./metaLayers/cellMeta.mjs";
 import localHooks from "../../mixins/localHooks.mjs";
-import { mixin } from "../../helpers/object.mjs";
-/**
- * With the Meta Manager class, it can be possible to manage with meta objects for different layers in
- * one place. All coordinates used to fetch, updating, removing, or creating rows or columns have to
- * be passed as physical values.
- *
- * The diagram of the meta layers:
- * +-------------+.
- * │ GlobalMeta  │
- * │ (prototype) │
- * +-------------+\
- *       │         \
- *       │          \
- *      \│/         _\|
- * +-------------+    +-------------+.
- * │ TableMeta   │    │ ColumnMeta  │
- * │ (instance)  │    │ (prototype) │
- * +-------------+    +-------------+.
- *                         │
- *                         │
- *                        \│/
- *                    +-------------+.
- *                    │  CellMeta   │
- *                    │ (instance)  │
- *                    +-------------+.
- *
- * A more detailed description of the specific layers can be found in the "metaLayers/" modules description.
- */
-
+import { mixin } from "../../helpers/object.mjs"; /**
+                                                   * With the Meta Manager class, it can be possible to manage with meta objects for different layers in
+                                                   * one place. All coordinates used to fetch, updating, removing, or creating rows or columns have to
+                                                   * be passed as physical values.
+                                                   *
+                                                   * The diagram of the meta layers:
+                                                   * +-------------+.
+                                                   * │ GlobalMeta  │
+                                                   * │ (prototype) │
+                                                   * +-------------+\
+                                                   *       │         \
+                                                   *       │          \
+                                                   *      \│/         _\|
+                                                   * +-------------+    +-------------+.
+                                                   * │ TableMeta   │    │ ColumnMeta  │
+                                                   * │ (instance)  │    │ (prototype) │
+                                                   * +-------------+    +-------------+.
+                                                   *                         │
+                                                   *                         │
+                                                   *                        \│/
+                                                   *                    +-------------+.
+                                                   *                    │  CellMeta   │
+                                                   *                    │ (instance)  │
+                                                   *                    +-------------+.
+                                                   *
+                                                   * A more detailed description of the specific layers can be found in the "metaLayers/" modules description.
+                                                   */
 var MetaManager = /*#__PURE__*/function () {
   function MetaManager(hot) {
     var _this = this;
-
     var customSettings = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
     var metaMods = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : [];
-
     _classCallCheck(this, MetaManager);
-
     /**
      * @type {Handsontable}
      */
@@ -57,28 +48,25 @@ var MetaManager = /*#__PURE__*/function () {
     /**
      * @type {GlobalMeta}
      */
-
     this.globalMeta = new GlobalMeta(hot);
     /**
      * @type {TableMeta}
      */
-
     this.tableMeta = new TableMeta(this.globalMeta);
     /**
      * @type {ColumnMeta}
      */
-
     this.columnMeta = new ColumnMeta(this.globalMeta);
     /**
      * @type {CellMeta}
      */
-
     this.cellMeta = new CellMeta(this.columnMeta);
     metaMods.forEach(function (ModifierClass) {
       return new ModifierClass(_this);
     });
     this.globalMeta.updateMeta(customSettings);
   }
+
   /**
    * Gets the global meta object that is a root of all default settings, which are recognizable by Handsontable.
    * Other layers inherites all properties from this. Adding, removing, or changing property in that
@@ -86,24 +74,23 @@ var MetaManager = /*#__PURE__*/function () {
    *
    * @returns {object}
    */
-
-
   _createClass(MetaManager, [{
     key: "getGlobalMeta",
     value: function getGlobalMeta() {
       return this.globalMeta.getMeta();
     }
+
     /**
      * Updates global settings object by merging settings with the current state.
      *
      * @param {object} settings An object to merge with.
      */
-
   }, {
     key: "updateGlobalMeta",
     value: function updateGlobalMeta(settings) {
       this.globalMeta.updateMeta(settings);
     }
+
     /**
      * Gets settings object that was passed in the Handsontable constructor. That layer contains all
      * default settings inherited from the GlobalMeta layer merged with settings passed by the developer.
@@ -111,23 +98,23 @@ var MetaManager = /*#__PURE__*/function () {
      *
      * @returns {TableMeta}
      */
-
   }, {
     key: "getTableMeta",
     value: function getTableMeta() {
       return this.tableMeta.getMeta();
     }
+
     /**
      * Updates table settings object by merging settings with the current state.
      *
      * @param {object} settings An object to merge with.
      */
-
   }, {
     key: "updateTableMeta",
     value: function updateTableMeta(settings) {
       this.tableMeta.updateMeta(settings);
     }
+
     /**
      * Gets column meta object that is a root of all settings defined in the column property of the Handsontable
      * settings. Each column in the Handsontable is associated with a unique meta object which identified by
@@ -138,24 +125,24 @@ var MetaManager = /*#__PURE__*/function () {
      * @param {number} physicalColumn The physical column index.
      * @returns {object}
      */
-
   }, {
     key: "getColumnMeta",
     value: function getColumnMeta(physicalColumn) {
       return this.columnMeta.getMeta(physicalColumn);
     }
+
     /**
      * Updates column meta object by merging settings with the current state.
      *
      * @param {number} physicalColumn The physical column index which points what column meta object is updated.
      * @param {object} settings An object to merge with.
      */
-
   }, {
     key: "updateColumnMeta",
     value: function updateColumnMeta(physicalColumn, settings) {
       this.columnMeta.updateMeta(physicalColumn, settings);
     }
+
     /**
      * Gets the cell meta object that is a root of all settings defined for the specific cell rendered by
      * the Handsontable. Each cell meta inherits settings from higher layers. When a property doesn't
@@ -170,12 +157,11 @@ var MetaManager = /*#__PURE__*/function () {
      * @param {number} options.visualColumn The visual column index of the currently requested cell meta object.
      * @returns {object}
      */
-
   }, {
     key: "getCellMeta",
     value: function getCellMeta(physicalRow, physicalColumn, _ref) {
       var visualRow = _ref.visualRow,
-          visualColumn = _ref.visualColumn;
+        visualColumn = _ref.visualColumn;
       var cellMeta = this.cellMeta.getMeta(physicalRow, physicalColumn);
       cellMeta.visualRow = visualRow;
       cellMeta.visualCol = visualColumn;
@@ -184,6 +170,7 @@ var MetaManager = /*#__PURE__*/function () {
       this.runLocalHooks('afterGetCellMeta', cellMeta);
       return cellMeta;
     }
+
     /**
      * Gets a value (defined by the `key` property) from the cell meta object.
      *
@@ -192,16 +179,15 @@ var MetaManager = /*#__PURE__*/function () {
      * @param {string} key Defines the value that will be returned from the cell meta object.
      * @returns {*}
      */
-
   }, {
     key: "getCellMetaKeyValue",
     value: function getCellMetaKeyValue(physicalRow, physicalColumn, key) {
       if (typeof key !== 'string') {
         throw new Error('The passed cell meta object key is not a string');
       }
-
       return this.cellMeta.getMeta(physicalRow, physicalColumn, key);
     }
+
     /**
      * Sets settings object for cell meta object defined by "key" property.
      *
@@ -210,12 +196,12 @@ var MetaManager = /*#__PURE__*/function () {
      * @param {string} key The property name to set.
      * @param {*} value Value to save.
      */
-
   }, {
     key: "setCellMeta",
     value: function setCellMeta(physicalRow, physicalColumn, key, value) {
       this.cellMeta.setMeta(physicalRow, physicalColumn, key, value);
     }
+
     /**
      * Updates cell meta object by merging settings with the current state.
      *
@@ -223,12 +209,12 @@ var MetaManager = /*#__PURE__*/function () {
      * @param {number} physicalColumn The physical column index which points what cell meta object is updated.
      * @param {object} settings An object to merge with.
      */
-
   }, {
     key: "updateCellMeta",
     value: function updateCellMeta(physicalRow, physicalColumn, settings) {
       this.cellMeta.updateMeta(physicalRow, physicalColumn, settings);
     }
+
     /**
      * Removes a property defined by the "key" argument from the cell meta object.
      *
@@ -236,12 +222,12 @@ var MetaManager = /*#__PURE__*/function () {
      * @param {number} physicalColumn The physical column index.
      * @param {string} key The property name to remove.
      */
-
   }, {
     key: "removeCellMeta",
     value: function removeCellMeta(physicalRow, physicalColumn, key) {
       this.cellMeta.removeMeta(physicalRow, physicalColumn, key);
     }
+
     /**
      * Returns all cell meta objects that were created during the Handsontable operation. As cell meta
      * objects are created lazy, the length of the returned collection depends on how and when the
@@ -249,12 +235,12 @@ var MetaManager = /*#__PURE__*/function () {
      *
      * @returns {object[]}
      */
-
   }, {
     key: "getCellsMeta",
     value: function getCellsMeta() {
       return this.cellMeta.getMetas();
     }
+
     /**
      * Returns all cell meta objects that were created during the Handsontable operation but for
      * specyfic row index.
@@ -262,45 +248,44 @@ var MetaManager = /*#__PURE__*/function () {
      * @param {number} physicalRow The physical row index.
      * @returns {object[]}
      */
-
   }, {
     key: "getCellsMetaAtRow",
     value: function getCellsMetaAtRow(physicalRow) {
       return this.cellMeta.getMetasAtRow(physicalRow);
     }
+
     /**
      * Creates one or more rows at specific position.
      *
      * @param {number} physicalRow The physical row index which points from what position the row is added.
      * @param {number} [amount=1] An amount of rows to add.
      */
-
   }, {
     key: "createRow",
     value: function createRow(physicalRow) {
       var amount = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 1;
       this.cellMeta.createRow(physicalRow, amount);
     }
+
     /**
      * Removes one or more rows from the collection.
      *
      * @param {number} physicalRow The physical row index which points from what position the row is removed.
      * @param {number} [amount=1] An amount rows to remove.
      */
-
   }, {
     key: "removeRow",
     value: function removeRow(physicalRow) {
       var amount = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 1;
       this.cellMeta.removeRow(physicalRow, amount);
     }
+
     /**
      * Creates one or more columns at specific position.
      *
      * @param {number} physicalColumn The physical column index which points from what position the column is added.
      * @param {number} [amount=1] An amount of columns to add.
      */
-
   }, {
     key: "createColumn",
     value: function createColumn(physicalColumn) {
@@ -308,13 +293,13 @@ var MetaManager = /*#__PURE__*/function () {
       this.cellMeta.createColumn(physicalColumn, amount);
       this.columnMeta.createColumn(physicalColumn, amount);
     }
+
     /**
      * Removes one or more columns from the collection.
      *
      * @param {number} physicalColumn The physical column index which points from what position the column is removed.
      * @param {number} [amount=1] An amount of columns to remove.
      */
-
   }, {
     key: "removeColumn",
     value: function removeColumn(physicalColumn) {
@@ -322,19 +307,19 @@ var MetaManager = /*#__PURE__*/function () {
       this.cellMeta.removeColumn(physicalColumn, amount);
       this.columnMeta.removeColumn(physicalColumn, amount);
     }
+
     /**
      * Clears all saved cell meta objects. It keeps column meta, table meta, and global meta intact.
      */
-
   }, {
     key: "clearCellsCache",
     value: function clearCellsCache() {
       this.cellMeta.clearCache();
     }
+
     /**
      * Clears all saved cell and columns meta objects.
      */
-
   }, {
     key: "clearCache",
     value: function clearCache() {
@@ -342,9 +327,7 @@ var MetaManager = /*#__PURE__*/function () {
       this.columnMeta.clearCache();
     }
   }]);
-
   return MetaManager;
 }();
-
 export { MetaManager as default };
 mixin(MetaManager, localHooks);

package/dataMap/metaManager/lazyFactoryMap.js

@@ -1,62 +1,34 @@
 "use strict";
 
 require("core-js/modules/es.array.from.js");
-
 require("core-js/modules/es.function.name.js");
-
 require("core-js/modules/es.regexp.exec.js");
-
 exports.__esModule = true;
 exports.default = void 0;
-
 require("core-js/modules/es.array.iterator.js");
-
 require("core-js/modules/es.object.to-string.js");
-
 require("core-js/modules/es.set.js");
-
 require("core-js/modules/es.string.iterator.js");
-
 require("core-js/modules/web.dom-collections.iterator.js");
-
 require("core-js/modules/es.array.concat.js");
-
 require("core-js/modules/es.array.slice.js");
-
 require("core-js/modules/es.array.splice.js");
-
 require("core-js/modules/es.symbol.iterator.js");
-
 require("core-js/modules/es.symbol.js");
-
 require("core-js/modules/es.symbol.description.js");
-
 require("core-js/modules/es.array.index-of.js");
-
 var _array = require("../../helpers/array");
-
 var _utils = require("./utils");
-
 function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
-
 function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-
 function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-
 function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
-
 function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
-
 function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
-
 function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
-
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
-
 function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
-
 /* eslint-disable jsdoc/require-description-complete-sentence */
-
 /**
  * @class LazyFactoryMap
  *
@@ -177,19 +149,16 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
  * The first "hole" (at index 0) item is permanently removed and replaced by a new item.
  * The hole index is taken from the hole collection which act as FIFO (First In First Out).
  */
-
 /* eslint-enable jsdoc/require-description-complete-sentence */
 var LazyFactoryMap = /*#__PURE__*/function (_Symbol$iterator) {
   function LazyFactoryMap(valueFactory) {
     _classCallCheck(this, LazyFactoryMap);
-
     this.valueFactory = valueFactory;
     /**
      * An array which contains data.
      *
      * @type {Array}
      */
-
     this.data = [];
     /**
      * An array of indexes where the key of the array is mapped to the value which points to the
@@ -197,7 +166,6 @@ var LazyFactoryMap = /*#__PURE__*/function (_Symbol$iterator) {
      *
      * @type {number[]}
      */
-
     this.index = [];
     /**
      * The collection of indexes that points to the data items which can be replaced by obtaining new
@@ -208,38 +176,31 @@ var LazyFactoryMap = /*#__PURE__*/function (_Symbol$iterator) {
      *
      * @type {Set<number>}
      */
-
     this.holes = new Set();
   }
+
   /**
    * Gets or if data not exist creates and returns new data.
    *
    * @param {number} key The item key as zero-based index.
    * @returns {*}
    */
-
-
   _createClass(LazyFactoryMap, [{
     key: "obtain",
     value: function obtain(key) {
       (0, _utils.assert)(function () {
         return (0, _utils.isUnsignedNumber)(key);
       }, 'Expecting an unsigned number.');
-
       var dataIndex = this._getStorageIndexByKey(key);
-
       var result;
-
       if (dataIndex >= 0) {
         result = this.data[dataIndex];
-
         if (result === void 0) {
           result = this.valueFactory(key);
           this.data[dataIndex] = result;
         }
       } else {
         result = this.valueFactory(key);
-
         if (this.holes.size > 0) {
           var reuseIndex = this.holes.values().next().value; // Gets first item from the collection
 
@@ -251,9 +212,9 @@ var LazyFactoryMap = /*#__PURE__*/function (_Symbol$iterator) {
           this.index[key] = this.data.length - 1;
         }
       }
-
       return result;
     }
+
     /**
      * Inserts an empty data to the map. This method creates an empty space for obtaining
      * new data.
@@ -261,7 +222,6 @@ var LazyFactoryMap = /*#__PURE__*/function (_Symbol$iterator) {
      * @param {number} key The key as volatile zero-based index at which to begin inserting space for new data.
      * @param {number} [amount=1] Ammount of data to insert.
      */
-
   }, {
     key: "insert",
     value: function insert(key) {
@@ -271,22 +231,20 @@ var LazyFactoryMap = /*#__PURE__*/function (_Symbol$iterator) {
       }, 'Expecting an unsigned number or null/undefined argument.');
       var newIndexes = [];
       var dataLength = this.data.length;
-
       for (var i = 0; i < amount; i++) {
         newIndexes.push(dataLength + i);
         this.data.push(void 0);
       }
-
       var insertionIndex = (0, _utils.isNullish)(key) ? this.index.length : key;
       this.index = [].concat(_toConsumableArray(this.index.slice(0, insertionIndex)), newIndexes, _toConsumableArray(this.index.slice(insertionIndex)));
     }
+
     /**
      * Removes (soft remove) data from "index" and according to the amount of data.
      *
      * @param {number} key The key as volatile zero-based index at which to begin removing the data.
      * @param {number} [amount=1] Ammount data to remove.
      */
-
   }, {
     key: "remove",
     value: function remove(key) {
@@ -295,60 +253,54 @@ var LazyFactoryMap = /*#__PURE__*/function (_Symbol$iterator) {
         return (0, _utils.isUnsignedNumber)(key) || (0, _utils.isNullish)(key);
       }, 'Expecting an unsigned number or null/undefined argument.');
       var removed = this.index.splice((0, _utils.isNullish)(key) ? this.index.length - amount : key, amount);
-
       for (var i = 0; i < removed.length; i++) {
         var removedIndex = removed[i];
-
         if (typeof removedIndex === 'number') {
           this.holes.add(removedIndex);
         }
       }
     }
+
     /**
      * Returns the size of the data which this map holds.
      *
      * @returns {number}
      */
-
   }, {
     key: "size",
     value: function size() {
       return this.data.length - this.holes.size;
     }
+
     /**
      * Returns a new Iterator object that contains the values for each item in the LazyMap object.
      *
      * @returns {Iterator}
      */
-
   }, {
     key: "values",
     value: function values() {
       var _this = this;
-
       return (0, _array.arrayFilter)(this.data, function (_, index) {
         return !_this.holes.has(index);
       })[Symbol.iterator]();
     }
+
     /**
      * Returns a new Iterator object that contains an array of `[index, value]` for each item in the LazyMap object.
      *
      * @returns {Iterator}
      */
-
   }, {
     key: "entries",
     value: function entries() {
       var validEntries = [];
-
       for (var i = 0; i < this.data.length; i++) {
         var keyIndex = this._getKeyByStorageIndex(i);
-
         if (keyIndex !== -1) {
           validEntries.push([keyIndex, this.data[i]]);
         }
       }
-
       var dataIndex = 0;
       return {
         next: function next() {
@@ -360,17 +312,16 @@ var LazyFactoryMap = /*#__PURE__*/function (_Symbol$iterator) {
               done: false
             };
           }
-
           return {
             done: true
           };
         }
       };
     }
+
     /**
      * Clears the map.
      */
-
   }, {
     key: "clear",
     value: function clear() {
@@ -378,44 +329,42 @@ var LazyFactoryMap = /*#__PURE__*/function (_Symbol$iterator) {
       this.index = [];
       this.holes.clear();
     }
+
     /**
      * Gets storage index calculated from the key associated with the specified value.
      *
      * @param {number} key Volatile zero-based index.
      * @returns {number} Returns index 0-N or -1 if no storage index found.
      */
-
   }, {
     key: "_getStorageIndexByKey",
     value: function _getStorageIndexByKey(key) {
       return this.index.length > key ? this.index[key] : -1;
     }
+
     /**
      * Gets the key associated with the specified value calculated from storage index.
      *
      * @param {number} dataIndex Zero-based storage index.
      * @returns {number} Returns index 0-N or -1 if no key found.
      */
-
   }, {
     key: "_getKeyByStorageIndex",
     value: function _getKeyByStorageIndex(dataIndex) {
       return this.index.indexOf(dataIndex);
     }
+
     /**
      * Makes this object iterable.
      *
      * @returns {Iterator}
      */
-
   }, {
     key: _Symbol$iterator,
     value: function value() {
       return this.entries();
     }
   }]);
-
   return LazyFactoryMap;
 }(Symbol.iterator);
-
 exports.default = LazyFactoryMap;