handsontable 12.1.2 → 12.2.0

package/plugins/columnSummary/endpoints.mjs

@@ -1,26 +1,19 @@
 import "core-js/modules/es.array.index-of.js";
 import "core-js/modules/es.object.to-string.js";
 import "core-js/modules/es.number.to-fixed.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 { arrayEach } from "../../helpers/array.mjs";
-import { warn } from "../../helpers/console.mjs";
-/**
- * Class used to make all endpoint-related operations.
- *
- * @private
- * @class Endpoints
- */
-
+import { warn } from "../../helpers/console.mjs"; /**
+                                                   * Class used to make all endpoint-related operations.
+                                                   *
+                                                   * @private
+                                                   * @class Endpoints
+                                                   */
 var Endpoints = /*#__PURE__*/function () {
   function Endpoints(plugin, settings) {
     _classCallCheck(this, Endpoints);
-
     /**
      * The main plugin instance.
      */
@@ -30,7 +23,6 @@ var Endpoints = /*#__PURE__*/function () {
      *
      * @type {object}
      */
-
     this.hot = this.plugin.hot;
     /**
      * Array of declared plugin endpoints (calculation destination points).
@@ -38,7 +30,6 @@ var Endpoints = /*#__PURE__*/function () {
      * @type {Array}
      * @default {Array} Empty array.
      */
-
     this.endpoints = [];
     /**
      * The plugin settings, taken from Handsontable configuration.
@@ -46,7 +37,6 @@ var Endpoints = /*#__PURE__*/function () {
      * @type {object|Function}
      * @default null
      */
-
     this.settings = settings;
     /**
      * Settings type. Can be either 'array' or 'function.
@@ -54,7 +44,6 @@ var Endpoints = /*#__PURE__*/function () {
      * @type {string}
      * @default {'array'}
      */
-
     this.settingsType = 'array';
     /**
      * The current endpoint (calculation destination point) in question.
@@ -62,7 +51,6 @@ var Endpoints = /*#__PURE__*/function () {
      * @type {object}
      * @default null
      */
-
     this.currentEndpoint = null;
     /**
      * Array containing a list of changes to be applied.
@@ -71,41 +59,38 @@ var Endpoints = /*#__PURE__*/function () {
      * @type {Array}
      * @default {[]}
      */
-
     this.cellsToSetCache = [];
   }
+
   /**
    * Get a single endpoint object.
    *
    * @param {number} index Index of the endpoint.
    * @returns {object}
    */
-
-
   _createClass(Endpoints, [{
     key: "getEndpoint",
     value: function getEndpoint(index) {
       if (this.settingsType === 'function') {
         return this.fillMissingEndpointData(this.settings)[index];
       }
-
       return this.endpoints[index];
     }
+
     /**
      * Get an array with all the endpoints.
      *
      * @returns {Array}
      */
-
   }, {
     key: "getAllEndpoints",
     value: function getAllEndpoints() {
       if (this.settingsType === 'function') {
         return this.fillMissingEndpointData(this.settings);
       }
-
       return this.endpoints;
     }
+
     /**
      * Used to fill the blanks in the endpoint data provided by a settings function.
      *
@@ -113,67 +98,50 @@ var Endpoints = /*#__PURE__*/function () {
      * @param {Function} func Function provided in the HOT settings.
      * @returns {Array} An array of endpoints.
      */
-
   }, {
     key: "fillMissingEndpointData",
     value: function fillMissingEndpointData(func) {
       return this.parseSettings(func.call(this));
     }
+
     /**
      * Parse plugin's settings.
      *
      * @param {Array} settings The settings array.
      * @returns {object[]}
      */
-
   }, {
     key: "parseSettings",
     value: function parseSettings(settings) {
       var _this = this;
-
       var endpointsArray = [];
       var settingsArray = settings;
-
       if (!settingsArray && typeof this.settings === 'function') {
         this.settingsType = 'function';
         return;
       }
-
       if (!settingsArray) {
         settingsArray = this.settings;
       }
-
       arrayEach(settingsArray, function (val) {
         var newEndpoint = {};
-
         _this.assignSetting(val, newEndpoint, 'ranges', [[0, _this.hot.countRows() - 1]]);
-
         _this.assignSetting(val, newEndpoint, 'reversedRowCoords', false);
-
         _this.assignSetting(val, newEndpoint, 'destinationRow', new Error("\n        You must provide a destination row for the Column Summary plugin in order to work properly!\n      "));
-
         _this.assignSetting(val, newEndpoint, 'destinationColumn', new Error("\n        You must provide a destination column for the Column Summary plugin in order to work properly!\n      "));
-
         _this.assignSetting(val, newEndpoint, 'sourceColumn', val.destinationColumn);
-
         _this.assignSetting(val, newEndpoint, 'type', 'sum');
-
         _this.assignSetting(val, newEndpoint, 'forceNumeric', false);
-
         _this.assignSetting(val, newEndpoint, 'suppressDataTypeErrors', true);
-
         _this.assignSetting(val, newEndpoint, 'suppressDataTypeErrors', true);
-
         _this.assignSetting(val, newEndpoint, 'customFunction', null);
-
         _this.assignSetting(val, newEndpoint, 'readOnly', true);
-
         _this.assignSetting(val, newEndpoint, 'roundFloat', false);
-
         endpointsArray.push(newEndpoint);
       });
       return endpointsArray;
     }
+
     /**
      * Setter for the internal setting objects.
      *
@@ -182,7 +150,6 @@ var Endpoints = /*#__PURE__*/function () {
      * @param {string} name Settings name.
      * @param {object} defaultValue Default value for the settings.
      */
-
   }, {
     key: "assignSetting",
     value: function assignSetting(settings, endpoint, name, defaultValue) {
@@ -192,12 +159,10 @@ var Endpoints = /*#__PURE__*/function () {
       } else if (name === 'ranges' && settings[name].length === 0) {
         return;
       }
-
       if (settings[name] === void 0) {
         if (defaultValue instanceof Error) {
           throw defaultValue;
         }
-
         endpoint[name] = defaultValue;
       } else {
         /* eslint-disable no-lonely-if */
@@ -208,6 +173,7 @@ var Endpoints = /*#__PURE__*/function () {
         }
       }
     }
+
     /**
      * Resets the endpoint setup before the structure alteration (like inserting or removing rows/columns). Used for settings provided as a function.
      *
@@ -216,14 +182,12 @@ var Endpoints = /*#__PURE__*/function () {
      * @param {number} index Row/column index.
      * @param {number} number Number of rows/columns added/removed.
      */
-
   }, {
     key: "resetSetupBeforeStructureAlteration",
     value: function resetSetupBeforeStructureAlteration(action, index, number) {
       if (this.settingsType !== 'function') {
         return;
       }
-
       var type = action.indexOf('row') > -1 ? 'row' : 'col';
       var endpoints = this.getAllEndpoints();
       arrayEach(endpoints, function (val) {
@@ -234,7 +198,6 @@ var Endpoints = /*#__PURE__*/function () {
             val.alterRowOffset = -1 * number;
           }
         }
-
         if (type === 'col' && val.destinationColumn >= index) {
           if (action === 'insert_col') {
             val.alterColumnOffset = number;
@@ -245,6 +208,7 @@ var Endpoints = /*#__PURE__*/function () {
       });
       this.resetAllEndpoints(endpoints, false);
     }
+
     /**
      * AfterCreateRow/afterCreateRow/afterRemoveRow/afterRemoveCol hook callback. Reset and reenables the summary functionality
      * after changing the table structure.
@@ -257,27 +221,21 @@ var Endpoints = /*#__PURE__*/function () {
      * @param {string} [source] Source of change.
      * @param {boolean} [forceRefresh] `true` of the endpoints should refresh after completing the function.
      */
-
   }, {
     key: "resetSetupAfterStructureAlteration",
     value: function resetSetupAfterStructureAlteration(action, index, number, logicRows, source) {
       var _this2 = this;
-
       var forceRefresh = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : true;
-
       if (this.settingsType === 'function') {
         // We need to run it on a next avaiable hook, because the TrimRows' `afterCreateRow` hook triggers after this one,
         // and it needs to be run to properly calculate the endpoint value.
         var beforeViewRenderCallback = function beforeViewRenderCallback() {
           _this2.hot.removeHook('beforeViewRender', beforeViewRenderCallback);
-
           return _this2.refreshAllEndpoints();
         };
-
         this.hot.addHookOnce('beforeViewRender', beforeViewRenderCallback);
         return;
       }
-
       var type = action.indexOf('row') > -1 ? 'row' : 'col';
       var multiplier = action.indexOf('remove') > -1 ? -1 : 1;
       var endpoints = this.getAllEndpoints();
@@ -287,19 +245,15 @@ var Endpoints = /*#__PURE__*/function () {
         if (type === 'row' && val.destinationRow >= placeOfAlteration) {
           val.alterRowOffset = multiplier * number;
         }
-
         if (type === 'col' && val.destinationColumn >= placeOfAlteration) {
           val.alterColumnOffset = multiplier * number;
         }
       });
       this.resetAllEndpoints(endpoints, !rowMoving);
-
       if (rowMoving) {
         arrayEach(endpoints, function (endpoint) {
           _this2.extendEndpointRanges(endpoint, placeOfAlteration, logicRows[0], logicRows.length);
-
           _this2.recreatePhysicalRanges(endpoint);
-
           _this2.clearOffsetInformation(endpoint);
         });
       } else {
@@ -307,24 +261,24 @@ var Endpoints = /*#__PURE__*/function () {
           _this2.shiftEndpointCoordinates(endpoint, placeOfAlteration);
         });
       }
-
       if (forceRefresh) {
         this.refreshAllEndpoints();
       }
     }
+
     /**
      * Clear the offset information from the endpoint object.
      *
      * @private
      * @param {object} endpoint And endpoint object.
      */
-
   }, {
     key: "clearOffsetInformation",
     value: function clearOffsetInformation(endpoint) {
       endpoint.alterRowOffset = void 0;
       endpoint.alterColumnOffset = void 0;
     }
+
     /**
      * Extend the row ranges for the provided endpoint.
      *
@@ -334,7 +288,6 @@ var Endpoints = /*#__PURE__*/function () {
      * @param {number} previousPosition Previous endpoint result position.
      * @param {number} offset Offset generated by the alteration.
      */
-
   }, {
     key: "extendEndpointRanges",
     value: function extendEndpointRanges(endpoint, placeOfAlteration, previousPosition, offset) {
@@ -349,7 +302,6 @@ var Endpoints = /*#__PURE__*/function () {
             }
           } else if (previousPosition >= range[0] && previousPosition <= range[1]) {
             range[1] -= offset;
-
             if (placeOfAlteration <= range[0]) {
               range[0] += 1;
               range[1] += 1;
@@ -358,24 +310,22 @@ var Endpoints = /*#__PURE__*/function () {
         }
       });
     }
+
     /**
      * Recreate the physical ranges for the provided endpoint. Used (for example) when a row gets moved and extends an existing range.
      *
      * @private
      * @param {object} endpoint An endpoint object.
      */
-
   }, {
     key: "recreatePhysicalRanges",
     value: function recreatePhysicalRanges(endpoint) {
       var _this3 = this;
-
       var ranges = endpoint.ranges;
       var newRanges = [];
       var allIndexes = [];
       arrayEach(ranges, function (range) {
         var newRange = [];
-
         if (range[1]) {
           for (var i = range[0]; i <= range[1]; i++) {
             newRange.push(_this3.hot.toPhysicalRow(i));
@@ -383,7 +333,6 @@ var Endpoints = /*#__PURE__*/function () {
         } else {
           newRange.push(_this3.hot.toPhysicalRow(range[0]));
         }
-
         allIndexes.push(newRange);
       });
       arrayEach(allIndexes, function (range) {
@@ -397,7 +346,6 @@ var Endpoints = /*#__PURE__*/function () {
             newRange = [];
             newRange.push(coord);
           }
-
           if (index === range.length - 1) {
             newRange.push(coord);
             newRanges.push(newRange);
@@ -406,6 +354,7 @@ var Endpoints = /*#__PURE__*/function () {
       });
       endpoint.ranges = newRanges;
     }
+
     /**
      * Shifts the endpoint coordinates by the defined offset.
      *
@@ -413,7 +362,6 @@ var Endpoints = /*#__PURE__*/function () {
      * @param {object} endpoint Endpoint object.
      * @param {number} offsetStartIndex Index of the performed change (if the change is located after the endpoint, nothing about the endpoint has to be changed.
      */
-
   }, {
     key: "shiftEndpointCoordinates",
     value: function shiftEndpointCoordinates(endpoint, offsetStartIndex) {
@@ -431,35 +379,30 @@ var Endpoints = /*#__PURE__*/function () {
         endpoint.sourceColumn += endpoint.alterColumnOffset || 0;
       }
     }
+
     /**
      * Resets (removes) the endpoints from the table.
      *
      * @param {Array} [endpoints] Array containing the endpoints.
      * @param {boolean} [useOffset=true] Use the cell offset value.
      */
-
   }, {
     key: "resetAllEndpoints",
     value: function resetAllEndpoints() {
       var _this4 = this;
-
       var endpoints = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this.getAllEndpoints();
       var useOffset = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
       var anyEndpointOutOfRange = endpoints.some(function (endpoint) {
         var alterRowOffset = endpoint.alterRowOffset || 0;
         var alterColOffset = endpoint.alterColumnOffset || 0;
-
         if (endpoint.destinationRow + alterRowOffset >= _this4.hot.countRows() || endpoint.destinationColumn + alterColOffset >= _this4.hot.countCols()) {
           return true;
         }
-
         return false;
       });
-
       if (anyEndpointOutOfRange) {
         return;
       }
-
       this.cellsToSetCache = [];
       arrayEach(endpoints, function (endpoint) {
         _this4.resetEndpointValue(endpoint, useOffset);
@@ -467,38 +410,34 @@ var Endpoints = /*#__PURE__*/function () {
       this.hot.setDataAtCell(this.cellsToSetCache, 'ColumnSummary.reset');
       this.cellsToSetCache = [];
     }
+
     /**
      * Calculate and refresh all defined endpoints.
      */
-
   }, {
     key: "refreshAllEndpoints",
     value: function refreshAllEndpoints() {
       var _this5 = this;
-
       this.cellsToSetCache = [];
       arrayEach(this.getAllEndpoints(), function (value) {
         _this5.currentEndpoint = value;
-
         _this5.plugin.calculate(value);
-
         _this5.setEndpointValue(value, 'init');
       });
       this.currentEndpoint = null;
       this.hot.setDataAtCell(this.cellsToSetCache, 'ColumnSummary.reset');
       this.cellsToSetCache = [];
     }
+
     /**
      * Calculate and refresh endpoints only in the changed columns.
      *
      * @param {Array} changes Array of changes from the `afterChange` hook.
      */
-
   }, {
     key: "refreshChangedEndpoints",
     value: function refreshChangedEndpoints(changes) {
       var _this6 = this;
-
       var needToRefresh = [];
       this.cellsToSetCache = [];
       arrayEach(changes, function (value, key, changesObj) {
@@ -506,7 +445,6 @@ var Endpoints = /*#__PURE__*/function () {
         if ("".concat(value[2] || '') === "".concat(value[3])) {
           return;
         }
-
         arrayEach(_this6.getAllEndpoints(), function (endpoint, j) {
           if (_this6.hot.propToCol(changesObj[key][1]) === endpoint.sourceColumn && needToRefresh.indexOf(j) === -1) {
             needToRefresh.push(j);
@@ -519,12 +457,12 @@ var Endpoints = /*#__PURE__*/function () {
       this.hot.setDataAtCell(this.cellsToSetCache, 'ColumnSummary.reset');
       this.cellsToSetCache = [];
     }
+
     /**
      * Calculate and refresh a single endpoint.
      *
      * @param {object} endpoint Contains the endpoint information.
      */
-
   }, {
     key: "refreshEndpoint",
     value: function refreshEndpoint(endpoint) {
@@ -533,13 +471,13 @@ var Endpoints = /*#__PURE__*/function () {
       this.setEndpointValue(endpoint);
       this.currentEndpoint = null;
     }
+
     /**
      * Reset the endpoint value.
      *
      * @param {object} endpoint Contains the endpoint information.
      * @param {boolean} [useOffset=true] Use the cell offset value.
      */
-
   }, {
     key: "resetEndpointValue",
     value: function resetEndpointValue(endpoint) {
@@ -547,18 +485,17 @@ var Endpoints = /*#__PURE__*/function () {
       var alterRowOffset = endpoint.alterRowOffset || 0;
       var alterColOffset = endpoint.alterColumnOffset || 0;
       var _ref = [this.hot.toVisualRow(endpoint.destinationRow), this.hot.toVisualColumn(endpoint.destinationColumn)],
-          visualRowIndex = _ref[0],
-          visualColumnIndex = _ref[1];
-
+        visualRowIndex = _ref[0],
+        visualColumnIndex = _ref[1];
       if (visualColumnIndex !== null && visualRowIndex !== null) {
         // Clear the meta on the "old" indexes
         var cellMeta = this.hot.getCellMeta(visualRowIndex, visualColumnIndex);
         cellMeta.readOnly = false;
         cellMeta.className = '';
       }
-
       this.cellsToSetCache.push([this.hot.toVisualRow(endpoint.destinationRow + (useOffset ? alterRowOffset : 0)), this.hot.toVisualColumn(endpoint.destinationColumn + (useOffset ? alterColOffset : 0)), '']);
     }
+
     /**
      * Set the endpoint value.
      *
@@ -566,7 +503,6 @@ var Endpoints = /*#__PURE__*/function () {
      * @param {string} [source] Source of the call information.
      * @param {boolean} [render=false] `true` if it needs to render the table afterwards.
      */
-
   }, {
     key: "setEndpointValue",
     value: function setEndpointValue(endpoint, source) {
@@ -575,50 +511,41 @@ var Endpoints = /*#__PURE__*/function () {
       var reverseRowOffset = -1 * endpoint.alterRowOffset || 0;
       var reverseColOffset = -1 * endpoint.alterColumnOffset || 0;
       var visualEndpointRowIndex = this.hot.toVisualRow(endpoint.destinationRow);
-
       if (endpoint.destinationRow >= this.hot.countRows() || endpoint.destinationColumn >= this.hot.countCols()) {
         this.throwOutOfBoundsWarning();
         return;
       }
-
       var destinationVisualRow = this.hot.toVisualRow(endpoint.destinationRow + reverseRowOffset);
-
       if (destinationVisualRow !== null) {
         var cellMeta = this.hot.getCellMeta(destinationVisualRow, endpoint.destinationColumn + reverseColOffset);
-
         if (source === 'init' || cellMeta.readOnly !== endpoint.readOnly) {
           cellMeta.readOnly = endpoint.readOnly;
           cellMeta.className = 'columnSummaryResult';
         }
       }
-
       if (endpoint.roundFloat && !isNaN(endpoint.result)) {
         endpoint.result = endpoint.result.toFixed(endpoint.roundFloat);
       }
-
       if (render) {
         this.hot.setDataAtCell(visualEndpointRowIndex, endpoint.destinationColumn, endpoint.result, 'ColumnSummary.set');
       } else {
         this.cellsToSetCache.push([visualEndpointRowIndex, endpoint.destinationColumn, endpoint.result]);
       }
-
       endpoint.alterRowOffset = void 0;
       endpoint.alterColumnOffset = void 0;
     }
+
     /**
      * Throw an error for the calculation range being out of boundaries.
      *
      * @private
      */
-
   }, {
     key: "throwOutOfBoundsWarning",
     value: function throwOutOfBoundsWarning() {
       warn('One of the Column Summary plugins\' destination points you provided is beyond the table boundaries!');
     }
   }]);
-
   return Endpoints;
 }();
-
 export default Endpoints;

package/plugins/columnSummary/index.js

@@ -2,9 +2,7 @@
 
 exports.__esModule = true;
 exports.PLUGIN_PRIORITY = exports.PLUGIN_KEY = exports.ColumnSummary = void 0;
-
 var _columnSummary = require("./columnSummary");
-
 exports.PLUGIN_KEY = _columnSummary.PLUGIN_KEY;
 exports.PLUGIN_PRIORITY = _columnSummary.PLUGIN_PRIORITY;
 exports.ColumnSummary = _columnSummary.ColumnSummary;

package/plugins/columnSummary/utils.js

@@ -0,0 +1,13 @@
+"use strict";
+
+exports.__esModule = true;
+exports.isNullishOrNaN = isNullishOrNaN;
+/**
+ * Returns `true` if the value is one of the type: `null`, `undefined` or `NaN`.
+ *
+ * @param {*} value The value to check.
+ * @returns {boolean}
+ */
+function isNullishOrNaN(value) {
+  return value === null || value === undefined || isNaN(value);
+}

package/plugins/columnSummary/utils.mjs

@@ -0,0 +1,9 @@
+/**
+ * Returns `true` if the value is one of the type: `null`, `undefined` or `NaN`.
+ *
+ * @param {*} value The value to check.
+ * @returns {boolean}
+ */
+export function isNullishOrNaN(value) {
+  return value === null || value === undefined || isNaN(value);
+}