handsontable 12.2.0 → 12.3.0-next-bb1a7c2-20221208

package/plugins/nestedHeaders/stateManager/index.js

@@ -1,12 +1,18 @@
 "use strict";
 
+require("core-js/modules/es.symbol.to-primitive.js");
+require("core-js/modules/es.date.to-primitive.js");
+require("core-js/modules/es.symbol.js");
+require("core-js/modules/es.symbol.description.js");
+require("core-js/modules/es.number.constructor.js");
 require("core-js/modules/es.object.keys.js");
 require("core-js/modules/es.array.index-of.js");
-require("core-js/modules/es.symbol.js");
 require("core-js/modules/es.array.filter.js");
 require("core-js/modules/es.object.get-own-property-descriptor.js");
 require("core-js/modules/web.dom-collections.for-each.js");
 require("core-js/modules/es.object.get-own-property-descriptors.js");
+require("core-js/modules/es.symbol.iterator.js");
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
 exports.__esModule = true;
 exports.default = void 0;
 require("core-js/modules/es.array.map.js");
@@ -24,12 +30,14 @@ var _excluded = ["row"];
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
-function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return 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 _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 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 _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, _toPropertyKey(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; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
 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; }
@@ -67,7 +75,8 @@ var _stateMatrix = /*#__PURE__*/new WeakMap();
  *                            CSS classes, etc) for a specific column and layer level.
  *
  * @class StateManager
- */var StateManager = /*#__PURE__*/function () {
+ */
+var StateManager = /*#__PURE__*/function () {
   function StateManager() {
     _classCallCheck(this, StateManager);
     _classPrivateFieldInitSpec(this, _sourceSettings, {
@@ -252,16 +261,20 @@ var _stateMatrix = /*#__PURE__*/new WeakMap();
      *           │    │    │    │
      *
      * @param {number} rowIndex A visual row index.
-     * @returns {number} Returns unsigned number.
+     * @returns {number|null} Returns unsigned number.
      */
     /* eslint-enable jsdoc/require-description-complete-sentence */
   }, {
     key: "rowCoordsToLevel",
     value: function rowCoordsToLevel(rowIndex) {
-      var layersCount = Math.max(this.getLayersCount(), 1);
-      var highestPossibleLevel = layersCount - 1;
-      var lowestPossibleLevel = 0;
-      return Math.min(Math.max(rowIndex + layersCount, lowestPossibleLevel), highestPossibleLevel);
+      if (rowIndex >= 0) {
+        return null;
+      }
+      var headerLevel = rowIndex + Math.max(this.getLayersCount(), 1);
+      if (headerLevel < 0) {
+        return null;
+      }
+      return headerLevel;
     }
 
     /* eslint-disable jsdoc/require-description-complete-sentence */
@@ -293,10 +306,14 @@ var _stateMatrix = /*#__PURE__*/new WeakMap();
   }, {
     key: "levelToRowCoords",
     value: function levelToRowCoords(headerLevel) {
-      var layersCount = Math.max(this.getLayersCount(), 1);
-      var highestPossibleRow = -1;
-      var lowestPossibleRow = -layersCount;
-      return Math.min(Math.max(headerLevel - layersCount, lowestPossibleRow), highestPossibleRow);
+      if (headerLevel < 0) {
+        return null;
+      }
+      var rowIndex = headerLevel - Math.max(this.getLayersCount(), 1);
+      if (rowIndex >= 0) {
+        return null;
+      }
+      return rowIndex;
     }
 
     /**
@@ -315,7 +332,7 @@ var _stateMatrix = /*#__PURE__*/new WeakMap();
       if (headerLevel < 0) {
         headerLevel = this.rowCoordsToLevel(headerLevel);
       }
-      if (headerLevel >= this.getLayersCount()) {
+      if (headerLevel === null || headerLevel >= this.getLayersCount()) {
         return null;
       }
       return (_classPrivateFieldGet2 = (_classPrivateFieldGet3 = _classPrivateFieldGet(this, _stateMatrix)[headerLevel]) === null || _classPrivateFieldGet3 === void 0 ? void 0 : _classPrivateFieldGet3[columnIndex]) !== null && _classPrivateFieldGet2 !== void 0 ? _classPrivateFieldGet2 : null;
@@ -336,6 +353,9 @@ var _stateMatrix = /*#__PURE__*/new WeakMap();
       if (headerLevel < 0) {
         headerLevel = this.rowCoordsToLevel(headerLevel);
       }
+      if (headerLevel === null || headerLevel >= this.getLayersCount()) {
+        return null;
+      }
       var node = _classPrivateFieldGet(this, _headersTree).getNode(headerLevel, columnIndex);
       if (!node) {
         return null;

package/plugins/nestedHeaders/stateManager/index.mjs

@@ -1,10 +1,4 @@
-import "core-js/modules/es.object.keys.js";
-import "core-js/modules/es.array.index-of.js";
-import "core-js/modules/es.symbol.js";
-import "core-js/modules/es.array.filter.js";
-import "core-js/modules/es.object.get-own-property-descriptor.js";
-import "core-js/modules/web.dom-collections.for-each.js";
-import "core-js/modules/es.object.get-own-property-descriptors.js";
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
 var _excluded = ["row"];
 import "core-js/modules/es.array.map.js";
 import "core-js/modules/es.array.iterator.js";
@@ -12,14 +6,28 @@ import "core-js/modules/es.object.to-string.js";
 import "core-js/modules/es.string.iterator.js";
 import "core-js/modules/es.weak-map.js";
 import "core-js/modules/web.dom-collections.iterator.js";
+import "core-js/modules/es.symbol.to-primitive.js";
+import "core-js/modules/es.date.to-primitive.js";
+import "core-js/modules/es.symbol.js";
+import "core-js/modules/es.symbol.description.js";
+import "core-js/modules/es.number.constructor.js";
+import "core-js/modules/es.object.keys.js";
+import "core-js/modules/es.array.index-of.js";
+import "core-js/modules/es.array.filter.js";
+import "core-js/modules/es.object.get-own-property-descriptor.js";
+import "core-js/modules/web.dom-collections.for-each.js";
+import "core-js/modules/es.object.get-own-property-descriptors.js";
+import "core-js/modules/es.symbol.iterator.js";
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
-function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return 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 _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 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 _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, _toPropertyKey(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; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
 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; }
@@ -31,34 +39,35 @@ import { arrayMap, arrayReduce } from "../../../helpers/array.mjs";
 import SourceSettings from "./sourceSettings.mjs";
 import HeadersTree from "./headersTree.mjs";
 import { triggerNodeModification as _triggerNodeModification } from "./nodeModifiers/index.mjs";
-import { generateMatrix } from "./matrixGenerator.mjs"; /**
-                                                         * The state manager is a source of truth for nested headers configuration.
-                                                         * The state generation process is divided into three stages.
-                                                         *
-                                                         *   +---------------------+  1. User-defined configuration normalization;
-                                                         *   │                     │  The source settings class normalizes and shares API for
-                                                         *   │   SourceSettings    │  raw settings passed by the developer. It is only consumed by
-                                                         *   │                     │  the header tree module.
-                                                         *   +---------------------+
-                                                         *             │
-                                                         *            \│/
-                                                         *   +---------------------+  2. Building a tree structure for validation and easier node manipulation;
-                                                         *   │                     │  The header tree generates a tree based on source settings for future
-                                                         *   │     HeadersTree     │  node manipulation (such as collapsible columns feature). While generating a tree
-                                                         *   │                     │  the source settings is checked to see if the configuration has overlapping headers.
-                                                         *   +---------------------+  If `true` the colspan matrix generation is skipped, overlapped headers are not supported.
-                                                         *             │
-                                                         *            \│/
-                                                         *   +---------------------+  3. Matrix generation;
-                                                         *   │                     │  Based on built trees the matrix generation is performed. That part of code
-                                                         *   │  matrix generation  │  generates an array structure similar to normalized data from the SourceSettings
-                                                         *   │                     │  but with the difference that this structure contains column settings which changed
-                                                         *   +---------------------+  during runtime (after the tree manipulation) e.q after collapse or expand column.
-                                                         *                            That settings describes how the TH element should be modified (colspan attribute,
-                                                         *                            CSS classes, etc) for a specific column and layer level.
-                                                         *
-                                                         * @class StateManager
-                                                         */
+import { generateMatrix } from "./matrixGenerator.mjs";
+/**
+ * The state manager is a source of truth for nested headers configuration.
+ * The state generation process is divided into three stages.
+ *
+ *   +---------------------+  1. User-defined configuration normalization;
+ *   │                     │  The source settings class normalizes and shares API for
+ *   │   SourceSettings    │  raw settings passed by the developer. It is only consumed by
+ *   │                     │  the header tree module.
+ *   +---------------------+
+ *             │
+ *            \│/
+ *   +---------------------+  2. Building a tree structure for validation and easier node manipulation;
+ *   │                     │  The header tree generates a tree based on source settings for future
+ *   │     HeadersTree     │  node manipulation (such as collapsible columns feature). While generating a tree
+ *   │                     │  the source settings is checked to see if the configuration has overlapping headers.
+ *   +---------------------+  If `true` the colspan matrix generation is skipped, overlapped headers are not supported.
+ *             │
+ *            \│/
+ *   +---------------------+  3. Matrix generation;
+ *   │                     │  Based on built trees the matrix generation is performed. That part of code
+ *   │  matrix generation  │  generates an array structure similar to normalized data from the SourceSettings
+ *   │                     │  but with the difference that this structure contains column settings which changed
+ *   +---------------------+  during runtime (after the tree manipulation) e.q after collapse or expand column.
+ *                            That settings describes how the TH element should be modified (colspan attribute,
+ *                            CSS classes, etc) for a specific column and layer level.
+ *
+ * @class StateManager
+ */
 var _sourceSettings = /*#__PURE__*/new WeakMap();
 var _headersTree = /*#__PURE__*/new WeakMap();
 var _stateMatrix = /*#__PURE__*/new WeakMap();
@@ -247,16 +256,20 @@ var StateManager = /*#__PURE__*/function () {
      *           │    │    │    │
      *
      * @param {number} rowIndex A visual row index.
-     * @returns {number} Returns unsigned number.
+     * @returns {number|null} Returns unsigned number.
      */
     /* eslint-enable jsdoc/require-description-complete-sentence */
   }, {
     key: "rowCoordsToLevel",
     value: function rowCoordsToLevel(rowIndex) {
-      var layersCount = Math.max(this.getLayersCount(), 1);
-      var highestPossibleLevel = layersCount - 1;
-      var lowestPossibleLevel = 0;
-      return Math.min(Math.max(rowIndex + layersCount, lowestPossibleLevel), highestPossibleLevel);
+      if (rowIndex >= 0) {
+        return null;
+      }
+      var headerLevel = rowIndex + Math.max(this.getLayersCount(), 1);
+      if (headerLevel < 0) {
+        return null;
+      }
+      return headerLevel;
     }
 
     /* eslint-disable jsdoc/require-description-complete-sentence */
@@ -288,10 +301,14 @@ var StateManager = /*#__PURE__*/function () {
   }, {
     key: "levelToRowCoords",
     value: function levelToRowCoords(headerLevel) {
-      var layersCount = Math.max(this.getLayersCount(), 1);
-      var highestPossibleRow = -1;
-      var lowestPossibleRow = -layersCount;
-      return Math.min(Math.max(headerLevel - layersCount, lowestPossibleRow), highestPossibleRow);
+      if (headerLevel < 0) {
+        return null;
+      }
+      var rowIndex = headerLevel - Math.max(this.getLayersCount(), 1);
+      if (rowIndex >= 0) {
+        return null;
+      }
+      return rowIndex;
     }
 
     /**
@@ -310,7 +327,7 @@ var StateManager = /*#__PURE__*/function () {
       if (headerLevel < 0) {
         headerLevel = this.rowCoordsToLevel(headerLevel);
       }
-      if (headerLevel >= this.getLayersCount()) {
+      if (headerLevel === null || headerLevel >= this.getLayersCount()) {
         return null;
       }
       return (_classPrivateFieldGet2 = (_classPrivateFieldGet3 = _classPrivateFieldGet(this, _stateMatrix)[headerLevel]) === null || _classPrivateFieldGet3 === void 0 ? void 0 : _classPrivateFieldGet3[columnIndex]) !== null && _classPrivateFieldGet2 !== void 0 ? _classPrivateFieldGet2 : null;
@@ -331,6 +348,9 @@ var StateManager = /*#__PURE__*/function () {
       if (headerLevel < 0) {
         headerLevel = this.rowCoordsToLevel(headerLevel);
       }
+      if (headerLevel === null || headerLevel >= this.getLayersCount()) {
+        return null;
+      }
       var node = _classPrivateFieldGet(this, _headersTree).getNode(headerLevel, columnIndex);
       if (!node) {
         return null;

package/plugins/nestedHeaders/stateManager/matrixGenerator.mjs

@@ -6,37 +6,39 @@ import "core-js/modules/es.string.includes.js";
 import "core-js/modules/es.object.keys.js";
 import "core-js/modules/es.array.index-of.js";
 import "core-js/modules/es.symbol.js";
-/* eslint-disable jsdoc/require-description-complete-sentence */import { arrayEach } from "../../../helpers/array.mjs";
-import { createDefaultHeaderSettings, createPlaceholderHeaderSettings } from "./utils.mjs"; /**
-                                                                                             * A function that dump a tree structure into multidimensional array. That structure is
-                                                                                             * later processed by header renderers to modify TH elements to achieve a proper
-                                                                                             * DOM structure.
-                                                                                             *
-                                                                                             * That structure contains settings object for every TH element generated by Walkontable.
-                                                                                             * The matrix operates on visual column index.
-                                                                                             *
-                                                                                             * Output example:
-                                                                                             *   [
-                                                                                             *     [
-                                                                                             *       { label: 'A1', colspan: 2, origColspan: 2, isHidden: false, ... },
-                                                                                             *       { label: '', colspan: 1, origColspan: 1, isHidden: true, ... },
-                                                                                             *       { label: '', colspan: 1, origColspan: 1, isHidden: false, ... },
-                                                                                             *     ],
-                                                                                             *     [
-                                                                                             *       { label: 'true', colspan: 1, origColspan: 1, isHidden: false, ... },
-                                                                                             *       { label: 'B2', colspan: 1, origColspan: 1, isHidden: false, ... },
-                                                                                             *       { label: '4', colspan: 1, origColspan: 1, isHidden: false, ... },
-                                                                                             *     ],
-                                                                                             *     [
-                                                                                             *       { label: '', colspan: 1, origColspan: 1, isHidden: false, ... },
-                                                                                             *       { label: '', colspan: 1, origColspan: 1, isHidden: false, ... },
-                                                                                             *       { label: '', colspan: 1, origColspan: 1, isHidden: false, ... },
-                                                                                             *     ],
-                                                                                             *   ]
-                                                                                             *
-                                                                                             * @param {TreeNode[]} headerRoots An array of root nodes.
-                                                                                             * @returns {Array[]}
-                                                                                             */
+/* eslint-disable jsdoc/require-description-complete-sentence */
+import { arrayEach } from "../../../helpers/array.mjs";
+import { createDefaultHeaderSettings, createPlaceholderHeaderSettings } from "./utils.mjs";
+/**
+ * A function that dump a tree structure into multidimensional array. That structure is
+ * later processed by header renderers to modify TH elements to achieve a proper
+ * DOM structure.
+ *
+ * That structure contains settings object for every TH element generated by Walkontable.
+ * The matrix operates on visual column index.
+ *
+ * Output example:
+ *   [
+ *     [
+ *       { label: 'A1', colspan: 2, origColspan: 2, isHidden: false, ... },
+ *       { label: '', colspan: 1, origColspan: 1, isHidden: true, ... },
+ *       { label: '', colspan: 1, origColspan: 1, isHidden: false, ... },
+ *     ],
+ *     [
+ *       { label: 'true', colspan: 1, origColspan: 1, isHidden: false, ... },
+ *       { label: 'B2', colspan: 1, origColspan: 1, isHidden: false, ... },
+ *       { label: '4', colspan: 1, origColspan: 1, isHidden: false, ... },
+ *     ],
+ *     [
+ *       { label: '', colspan: 1, origColspan: 1, isHidden: false, ... },
+ *       { label: '', colspan: 1, origColspan: 1, isHidden: false, ... },
+ *       { label: '', colspan: 1, origColspan: 1, isHidden: false, ... },
+ *     ],
+ *   ]
+ *
+ * @param {TreeNode[]} headerRoots An array of root nodes.
+ * @returns {Array[]}
+ */
 export function generateMatrix(headerRoots) {
   var matrix = [];
   arrayEach(headerRoots, function (rootNode) {

package/plugins/nestedHeaders/stateManager/nodeModifiers/collapse.mjs

@@ -7,23 +7,24 @@ import "core-js/modules/web.dom-collections.iterator.js";
 import "core-js/modules/es.array.from.js";
 import { arrayEach } from "../../../../helpers/array.mjs";
 import { expandNode } from "./expand.mjs";
-import { getFirstChildProperty, isNodeReflectsFirstChildColspan, traverseHiddenNodeColumnIndexes } from "./utils/tree.mjs"; /**
-                                                                                                                             * Collapsing a node is a process where the processing node is collapsed
-                                                                                                                             * to the colspan width of the first child. All node children, except the
-                                                                                                                             * first one, are hidden. To prevent losing a current state of node children
-                                                                                                                             * on the right, all nodes are cloned (and restored while expanding), and
-                                                                                                                             * only then original nodes are modified (hidden in this case).
-                                                                                                                             *
-                                                                                                                             * @param {TreeNode} nodeToProcess A tree node to process.
-                                                                                                                             * @returns {object} Returns an object with properties:
-                                                                                                                             *                    - rollbackModification: The function that rollbacks
-                                                                                                                             *                      the tree to the previous state.
-                                                                                                                             *                    - affectedColumns: The list of the visual column
-                                                                                                                             *                      indexes which are affected. That list is passed
-                                                                                                                             *                      to the hiddens column logic.
-                                                                                                                             *                    - colspanCompensation: The number of colspan by
-                                                                                                                             *                      which the processed node colspan was reduced.
-                                                                                                                             */
+import { getFirstChildProperty, isNodeReflectsFirstChildColspan, traverseHiddenNodeColumnIndexes } from "./utils/tree.mjs";
+/**
+ * Collapsing a node is a process where the processing node is collapsed
+ * to the colspan width of the first child. All node children, except the
+ * first one, are hidden. To prevent losing a current state of node children
+ * on the right, all nodes are cloned (and restored while expanding), and
+ * only then original nodes are modified (hidden in this case).
+ *
+ * @param {TreeNode} nodeToProcess A tree node to process.
+ * @returns {object} Returns an object with properties:
+ *                    - rollbackModification: The function that rollbacks
+ *                      the tree to the previous state.
+ *                    - affectedColumns: The list of the visual column
+ *                      indexes which are affected. That list is passed
+ *                      to the hiddens column logic.
+ *                    - colspanCompensation: The number of colspan by
+ *                      which the processed node colspan was reduced.
+ */
 export function collapseNode(nodeToProcess) {
   var _getFirstChildPropert;
   var nodeData = nodeToProcess.data,

package/plugins/nestedHeaders/stateManager/nodeModifiers/expand.mjs

@@ -7,22 +7,23 @@ import "core-js/modules/web.dom-collections.iterator.js";
 import "core-js/modules/es.array.from.js";
 import { arrayEach } from "../../../../helpers/array.mjs";
 import { collapseNode } from "./collapse.mjs";
-import { getFirstChildProperty, isNodeReflectsFirstChildColspan, traverseHiddenNodeColumnIndexes } from "./utils/tree.mjs"; /**
-                                                                                                                             * Expanding a node is a process where the processing node is expanded to
-                                                                                                                             * its original colspan width. To restore an original state of all node
-                                                                                                                             * children on the right, the modified nodes are replaced with the cloned
-                                                                                                                             * nodes (they were cloned while collapsing).
-                                                                                                                             *
-                                                                                                                             * @param {TreeNode} nodeToProcess A tree node to process.
-                                                                                                                             * @returns {object} Returns an object with properties:
-                                                                                                                             *                    - rollbackModification: The function that rollbacks
-                                                                                                                             *                      the tree to the previous state.
-                                                                                                                             *                    - affectedColumns: The list of the visual column
-                                                                                                                             *                      indexes which are affected. That list is passed
-                                                                                                                             *                      to the hiddens column logic.
-                                                                                                                             *                    - colspanCompensation: The number of colspan by
-                                                                                                                             *                      which the processed node colspan was increased.
-                                                                                                                             */
+import { getFirstChildProperty, isNodeReflectsFirstChildColspan, traverseHiddenNodeColumnIndexes } from "./utils/tree.mjs";
+/**
+ * Expanding a node is a process where the processing node is expanded to
+ * its original colspan width. To restore an original state of all node
+ * children on the right, the modified nodes are replaced with the cloned
+ * nodes (they were cloned while collapsing).
+ *
+ * @param {TreeNode} nodeToProcess A tree node to process.
+ * @returns {object} Returns an object with properties:
+ *                    - rollbackModification: The function that rollbacks
+ *                      the tree to the previous state.
+ *                    - affectedColumns: The list of the visual column
+ *                      indexes which are affected. That list is passed
+ *                      to the hiddens column logic.
+ *                    - colspanCompensation: The number of colspan by
+ *                      which the processed node colspan was increased.
+ */
 export function expandNode(nodeToProcess) {
   var nodeData = nodeToProcess.data,
     nodeChilds = nodeToProcess.childs;

package/plugins/nestedHeaders/stateManager/nodeModifiers/hideColumn.mjs

@@ -6,12 +6,13 @@ import "core-js/modules/es.number.is-integer.js";
 import "core-js/modules/es.number.constructor.js";
 import "core-js/modules/es.array.includes.js";
 import "core-js/modules/es.string.includes.js";
-import { toSingleLine } from "../../../../helpers/templateLiteralTag.mjs"; /**
-                                                                            * @param {TreeNode} nodeToProcess A tree node to process.
-                                                                            * @param {number} gridColumnIndex The visual column index that triggers the node modification.
-                                                                            *                                 The index can be between the root node column index and
-                                                                            *                                 column index plus node colspan length.
-                                                                            */
+import { toSingleLine } from "../../../../helpers/templateLiteralTag.mjs";
+/**
+ * @param {TreeNode} nodeToProcess A tree node to process.
+ * @param {number} gridColumnIndex The visual column index that triggers the node modification.
+ *                                 The index can be between the root node column index and
+ *                                 column index plus node colspan length.
+ */
 export function hideColumn(nodeToProcess, gridColumnIndex) {
   if (!Number.isInteger(gridColumnIndex)) {
     throw new Error('The passed gridColumnIndex argument has invalid type.');

package/plugins/nestedHeaders/stateManager/nodeModifiers/index.mjs

@@ -6,7 +6,8 @@ import "core-js/modules/web.dom-collections.iterator.js";
 /**
  * The NodeModifiers module is responsible for the modification of a tree structure
  * in a way to achieve new column headers state.
- */import { collapseNode } from "./collapse.mjs";
+ */
+import { collapseNode } from "./collapse.mjs";
 import { expandNode } from "./expand.mjs";
 import { hideColumn } from "./hideColumn.mjs";
 import { showColumn } from "./showColumn.mjs";

package/plugins/nestedHeaders/stateManager/nodeModifiers/showColumn.mjs

@@ -8,12 +8,13 @@ import "core-js/modules/es.array.includes.js";
 import "core-js/modules/es.string.includes.js";
 import "core-js/modules/es.array.splice.js";
 import "core-js/modules/es.array.index-of.js";
-import { toSingleLine } from "../../../../helpers/templateLiteralTag.mjs"; /**
-                                                                            * @param {TreeNode} nodeToProcess A tree node to process.
-                                                                            * @param {number} gridColumnIndex The visual column index that triggers the node modification.
-                                                                            *                                 The index can be between the root node column index and
-                                                                            *                                 column index plus node colspan length.
-                                                                            */
+import { toSingleLine } from "../../../../helpers/templateLiteralTag.mjs";
+/**
+ * @param {TreeNode} nodeToProcess A tree node to process.
+ * @param {number} gridColumnIndex The visual column index that triggers the node modification.
+ *                                 The index can be between the root node column index and
+ *                                 column index plus node colspan length.
+ */
 export function showColumn(nodeToProcess, gridColumnIndex) {
   if (!Number.isInteger(gridColumnIndex)) {
     throw new Error('The passed gridColumnIndex argument has invalid type.');