handsontable 0.0.0-next-788a9dd-20230315 → 0.0.0-next-94c1646-20230323

package/dist/handsontable.js

@@ -25,8 +25,8 @@
  * INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER ARISING FROM
  * USE OR INABILITY TO USE THIS SOFTWARE.
  * 
- * Version: 0.0.0-next-788a9dd-20230315
- * Release date: 06/02/2023 (built at 15/03/2023 14:14:36)
+ * Version: 0.0.0-next-94c1646-20230323
+ * Release date: 23/03/2023 (built at 23/03/2023 12:14:23)
  */
 (function webpackUniversalModuleDefinition(root, factory) {
 	if(typeof exports === 'object' && typeof module === 'object')
@@ -2904,7 +2904,7 @@ var domMessages = {
 function _injectProductInfo(key, element) {
   var hasValidType = !isEmpty(key);
   var isNonCommercial = typeof key === 'string' && key.toLowerCase() === 'non-commercial-and-evaluation';
-  var hotVersion = "0.0.0-next-788a9dd-20230315";
+  var hotVersion = "0.0.0-next-94c1646-20230323";
   var keyValidityDate;
   var consoleMessageState = 'invalid';
   var domMessageState = 'invalid';
@@ -2912,7 +2912,7 @@ function _injectProductInfo(key, element) {
   var schemaValidity = _checkKeySchema(key);
   if (hasValidType || isNonCommercial || schemaValidity) {
     if (schemaValidity) {
-      var releaseDate = (0, _moment.default)("06/02/2023", 'DD/MM/YYYY');
+      var releaseDate = (0, _moment.default)("23/03/2023", 'DD/MM/YYYY');
       var releaseDays = Math.floor(releaseDate.toDate().getTime() / 8.64e7);
       var keyValidityDays = _extractTime(key);
       keyValidityDate = (0, _moment.default)((keyValidityDays + 1) * 8.64e7, 'x').format('MMMM DD, YYYY');
@@ -10174,10 +10174,10 @@ var store = __webpack_require__(186);
 (module.exports = function (key, value) {
   return store[key] || (store[key] = value !== undefined ? value : {});
 })('versions', []).push({
-  version: '3.28.0',
+  version: '3.29.1',
   mode: IS_PURE ? 'pure' : 'global',
   copyright: '© 2014-2023 Denis Pushkarev (zloirock.ru)',
-  license: 'https://github.com/zloirock/core-js/blob/v3.28.0/LICENSE',
+  license: 'https://github.com/zloirock/core-js/blob/v3.29.1/LICENSE',
   source: 'https://github.com/zloirock/core-js'
 });
 
@@ -17532,44 +17532,40 @@ var CoreAbstract = /*#__PURE__*/function () {
     (0, _defineProperty2.default)(this, "wtOverlays", void 0);
     (0, _defineProperty2.default)(this, "selections", void 0);
     (0, _defineProperty2.default)(this, "wtEvent", void 0);
-    (0, _defineProperty2.default)(this, "guid", "wt_".concat((0, _string.randomString)()));
-    (0, _defineProperty2.default)(this, "drawInterrupted", false);
-    (0, _defineProperty2.default)(this, "drawn", false);
-    (0, _defineProperty2.default)(this, "domBindings", void 0);
-    (0, _defineProperty2.default)(this, "wtSettings", void 0);
-    this.domBindings = {
-      rootTable: table,
-      rootDocument: table.ownerDocument,
-      rootWindow: table.ownerDocument.defaultView
-    };
-    this.wtSettings = settings;
-    this.wtScroll = new _scroll.default(this.createScrollDao());
-  }
-  (0, _createClass2.default)(CoreAbstract, [{
-    key: "eventManager",
-    get:
     /**
      * The walkontable instance id.
      *
      * @public
      * @type {Readonly<string>}
      */
-
+    (0, _defineProperty2.default)(this, "guid", "wt_".concat((0, _string.randomString)()));
+    (0, _defineProperty2.default)(this, "drawInterrupted", false);
+    (0, _defineProperty2.default)(this, "drawn", false);
     /**
      * The DOM bindings.
      *
      * @public
      * @type {DomBindings}
      */
-
+    (0, _defineProperty2.default)(this, "domBindings", void 0);
     /**
      * Settings.
      *
      * @public
      * @type {Settings}
      */
-
-    function get() {
+    (0, _defineProperty2.default)(this, "wtSettings", void 0);
+    this.domBindings = {
+      rootTable: table,
+      rootDocument: table.ownerDocument,
+      rootWindow: table.ownerDocument.defaultView
+    };
+    this.wtSettings = settings;
+    this.wtScroll = new _scroll.default(this.createScrollDao());
+  }
+  (0, _createClass2.default)(CoreAbstract, [{
+    key: "eventManager",
+    get: function get() {
       return new _eventManager.default(this);
     }
   }, {
@@ -20527,14 +20523,31 @@ var Formulas = /*#__PURE__*/function (_BasePlugin) {
       _args[_key] = arguments[_key];
     }
     _this = _super.call.apply(_super, [this].concat(_args));
+    /**
+     * Flag used to bypass hooks in internal operations.
+     *
+     * @private
+     * @type {boolean}
+     */
     _classPrivateFieldInitSpec((0, _assertThisInitialized2.default)(_this), _internalOperationPending, {
       writable: true,
       value: 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((0, _assertThisInitialized2.default)(_this), _hotWasInitializedWithEmptyData, {
       writable: true,
       value: false
     });
+    /**
+     * The list of the HyperFormula listeners.
+     *
+     * @type {Array}
+     */
     _classPrivateFieldInitSpec((0, _assertThisInitialized2.default)(_this), _engineListeners, {
       writable: true,
       value: [['valuesUpdated', function () {
@@ -20557,8 +20570,25 @@ var Formulas = /*#__PURE__*/function (_BasePlugin) {
         return (_this7 = _this).onEngineSheetRemoved.apply(_this7, arguments);
       }]]
     });
+    /**
+     * Static register used to set up one global HyperFormula instance.
+     * TODO: currently used in tests, might be removed later.
+     *
+     * @private
+     * @type {object}
+     */
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "staticRegister", (0, _staticRegister.default)('formulas'));
+    /**
+     * The engine instance that will be used for this instance of Handsontable.
+     *
+     * @type {HyperFormula|null}
+     */
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "engine", null);
+    /**
+     * HyperFormula's sheet name.
+     *
+     * @type {string|null}
+     */
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "sheetName", null);
     return _this;
   }
@@ -21625,13 +21655,6 @@ var Formulas = /*#__PURE__*/function (_BasePlugin) {
     get: function get() {
       return PLUGIN_PRIORITY;
     }
-
-    /**
-     * Flag used to bypass hooks in internal operations.
-     *
-     * @private
-     * @type {boolean}
-     */
   }]);
   return Formulas;
 }(_base.BasePlugin);
@@ -28351,9 +28374,9 @@ var ViewportColumnsCalculator = /*#__PURE__*/function () {
       var inlineEndColumnOffset = calculationType === _constants.FULLY_VISIBLE_TYPE ? 0 : lastVisibleColumnWidth;
       var inlineStartColumnOffset = calculationType === _constants.FULLY_VISIBLE_TYPE ? firstVisibleColumnWidth : 0;
       if (
-      // The table is on the left of the viewport
+      // the table is to the left of the viewport
       mostRightScrollOffset < -1 * priv.inlineStartOffset || scrollOffset > startPositions.at(-1) + inlineEndColumnOffset ||
-      // The table is on the right of the viewport
+      // the table is to the right of the viewport
       -1 * priv.scrollOffset - priv.viewportWidth > -1 * inlineStartColumnOffset) {
         this.isVisibleInTrimmingContainer = false;
       } else {
@@ -41810,8 +41833,8 @@ Handsontable.hooks = _pluginHooks.default.getSingleton();
 Handsontable.CellCoords = _src.CellCoords;
 Handsontable.CellRange = _src.CellRange;
 Handsontable.packageName = 'handsontable';
-Handsontable.buildDate = "15/03/2023 14:14:36";
-Handsontable.version = "0.0.0-next-788a9dd-20230315";
+Handsontable.buildDate = "23/03/2023 12:14:23";
+Handsontable.version = "0.0.0-next-94c1646-20230323";
 Handsontable.languages = {
   dictionaryKeys: _registry.dictionaryKeys,
   getLanguageDictionary: _registry.getLanguageDictionary,
@@ -53000,6 +53023,12 @@ var LinkedPhysicalIndexToValueMap = /*#__PURE__*/function (_IndexMap) {
       args[_key] = arguments[_key];
     }
     _this = _super.call.apply(_super, [this].concat(args));
+    /**
+     * Indexes and values corresponding to them (entries) are stored in a certain order.
+     *
+     * @private
+     * @type {Array<number>}
+     */
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "orderOfIndexes", []);
     return _this;
   }
@@ -53650,6 +53679,13 @@ var _currentInitialChanges = /*#__PURE__*/new WeakMap();
 var ChangesObserver = /*#__PURE__*/function () {
   function ChangesObserver() {
     (0, _classCallCheck2.default)(this, ChangesObserver);
+    /**
+     * The field holds initial changes that will be used to notify the callbacks added using
+     * subscribe method. Regardless of the moment of listening for changes, the subscriber
+     * will be notified once with all changes made before subscribing.
+     *
+     * @type {Array}
+     */
     _classPrivateFieldInitSpec(this, _currentInitialChanges, {
       writable: true,
       value: []
@@ -58735,6 +58771,14 @@ var AutocompleteEditor = /*#__PURE__*/function (_HandsontableEditor) {
      *
      * @type {string}
      */
+    /**
+     * Filters and sorts by relevance.
+     *
+     * @param {*} value The selected value.
+     * @param {string[]} choices The list of available choices.
+     * @param {boolean} caseSensitive Indicates if it's sorted by case.
+     * @returns {number[]} Array of indexes in original choices array.
+     */
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "sortByRelevance", function (value, choices, caseSensitive) {
       var choicesRelevance = [];
       var result = [];
@@ -59237,15 +59281,6 @@ var AutocompleteEditor = /*#__PURE__*/function (_HandsontableEditor) {
         }
       }
     }
-
-    /**
-     * Filters and sorts by relevance.
-     *
-     * @param {*} value The selected value.
-     * @param {string[]} choices The list of available choices.
-     * @param {boolean} caseSensitive Indicates if it's sorted by case.
-     * @returns {number[]} Array of indexes in original choices array.
-     */
   }], [{
     key: "EDITOR_TYPE",
     get: function get() {
@@ -62830,6 +62865,15 @@ var BasePlugin = /*#__PURE__*/function () {
   function BasePlugin(hotInstance) {
     var _this = this;
     (0, _classCallCheck2.default)(this, BasePlugin);
+    /**
+     * Check if any of the keys defined in `SETTING_KEYS` configuration of the plugin is present in the provided
+     * config object, or if the `SETTING_KEYS` configuration states that the plugin is relevant to the config object
+     * regardless of its contents.
+     *
+     * @private
+     * @param {Handsontable.DefaultSettings} settings The config object passed to `updateSettings`.
+     * @returns {boolean}
+     */
     _classPrivateMethodInitSpec(this, _isRelevantToSettings);
     /**
      * Handsontable instance.
@@ -62993,16 +63037,6 @@ var BasePlugin = /*#__PURE__*/function () {
         this.pluginsInitializedCallbacks.push(callback);
       }
     }
-
-    /**
-     * Check if any of the keys defined in `SETTING_KEYS` configuration of the plugin is present in the provided
-     * config object, or if the `SETTING_KEYS` configuration states that the plugin is relevant to the config object
-     * regardless of its contents.
-     *
-     * @private
-     * @param {Handsontable.DefaultSettings} settings The config object passed to `updateSettings`.
-     * @returns {boolean}
-     */
   }, {
     key: "onAfterPluginsInitialized",
     value:
@@ -65179,9 +65213,33 @@ var CollapsibleColumns = /*#__PURE__*/function (_BasePlugin) {
       args[_key] = arguments[_key];
     }
     _this = _super.call.apply(_super, [this].concat(args));
+    /**
+     * Cached reference to the NestedHeaders plugin.
+     *
+     * @private
+     * @type {NestedHeaders}
+     */
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "nestedHeadersPlugin", null);
+    /**
+     * Event manager instance reference.
+     *
+     * @private
+     * @type {EventManager}
+     */
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "eventManager", new _eventManager.default((0, _assertThisInitialized2.default)(_this)));
+    /**
+     * The NestedHeaders plugin StateManager instance.
+     *
+     * @private
+     * @type {StateManager}
+     */
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "headerStateManager", null);
+    /**
+     * Map of collapsed columns by the plugin.
+     *
+     * @private
+     * @type {HidingMap|null}
+     */
     _classPrivateFieldInitSpec((0, _assertThisInitialized2.default)(_this), _collapsedColumnsMap, {
       writable: true,
       value: null
@@ -65603,13 +65661,6 @@ var CollapsibleColumns = /*#__PURE__*/function (_BasePlugin) {
     get: function get() {
       return [PLUGIN_KEY].concat(SETTING_KEYS);
     }
-
-    /**
-     * Cached reference to the NestedHeaders plugin.
-     *
-     * @private
-     * @type {NestedHeaders}
-     */
   }]);
   return CollapsibleColumns;
 }(_base.BasePlugin);
@@ -71252,35 +71303,115 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
       args[_key] = arguments[_key];
     }
     _this = _super.call.apply(_super, [this].concat(args));
+    /**
+     * Counts how many column headers will be copied based on the passed range.
+     *
+     * @private
+     * @param {Array<{startRow: number, startCol: number, endRow: number, endCol: number}>} ranges Array of objects with properties `startRow`, `startCol`, `endRow` and `endCol`.
+     * @returns {{ columnHeadersCount: number }} Returns an object with keys that holds
+     *                                           information with the number of copied headers.
+     */
     _classPrivateMethodInitSpec((0, _assertThisInitialized2.default)(_this), _countCopiedHeaders);
+    /**
+     * The maximum number of columns than can be copied to the clipboard.
+     *
+     * @type {number}
+     * @default Infinity
+     */
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "columnsLimit", Infinity);
+    /**
+     * The maximum number of rows than can be copied to the clipboard.
+     *
+     * @type {number}
+     * @default Infinity
+     */
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "rowsLimit", Infinity);
+    /**
+     * When pasting:
+     * - `'overwrite'`: overwrite the currently-selected cells
+     * - `'shift_down'`: move currently-selected cells down
+     * - `'shift_right'`: move currently-selected cells to the right
+     *
+     * @type {string}
+     * @default 'overwrite'
+     */
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "pasteMode", 'overwrite');
+    /**
+     * The UI container for the secondary focusable element.
+     *
+     * @type {HTMLElement}
+     */
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "uiContainer", _this.hot.rootDocument.body);
+    /**
+     * Shows the "Copy with headers" item in the context menu and extends the context menu with the
+     * `'copy_with_column_headers'` option that can be used for creating custom menus arrangements.
+     *
+     * @type {boolean}
+     * @default false
+     */
     _classPrivateFieldInitSpec((0, _assertThisInitialized2.default)(_this), _enableCopyColumnHeaders, {
       writable: true,
       value: false
     });
+    /**
+     * Shows the "Copy with group headers" item in the context menu and extends the context menu with the
+     * `'copy_with_column_group headers'` option that can be used for creating custom menus arrangements.
+     *
+     * @type {boolean}
+     * @default false
+     */
     _classPrivateFieldInitSpec((0, _assertThisInitialized2.default)(_this), _enableCopyColumnGroupHeaders, {
       writable: true,
       value: false
     });
+    /**
+     * Shows the "Copy headers only" item in the context menu and extends the context menu with the
+     * `'copy_column_headers_only'` option that can be used for creating custom menus arrangements.
+     *
+     * @type {boolean}
+     * @default false
+     */
     _classPrivateFieldInitSpec((0, _assertThisInitialized2.default)(_this), _enableCopyColumnHeadersOnly, {
       writable: true,
       value: false
     });
+    /**
+     * Defines the data range to copy. Possible values:
+     *  * `'cells-only'` Copy selected cells only;
+     *  * `'column-headers-only'` Copy column headers only;
+     *  * `'with-all-column-headers'` Copy cells with all column headers;
+     *  * `'with-column-headers'` Copy cells with column headers;
+     *
+     * @type {'cells-only' | 'column-headers-only' | 'with-all-column-headers' | 'with-column-headers'}
+     */
     _classPrivateFieldInitSpec((0, _assertThisInitialized2.default)(_this), _copyMode, {
       writable: true,
       value: 'cells-only'
     });
+    /**
+     * Flag that is used to prevent copying when the native shortcut was not pressed.
+     *
+     * @type {boolean}
+     */
     _classPrivateFieldInitSpec((0, _assertThisInitialized2.default)(_this), _isTriggeredByCopy, {
       writable: true,
       value: false
     });
+    /**
+     * Flag that is used to prevent cutting when the native shortcut was not pressed.
+     *
+     * @type {boolean}
+     */
     _classPrivateFieldInitSpec((0, _assertThisInitialized2.default)(_this), _isTriggeredByCut, {
       writable: true,
       value: false
     });
+    /**
+     * Class that helps generate copyable ranges based on the current selection for different copy mode
+     * types.
+     *
+     * @type {CopyableRangesFactory}
+     */
     _classPrivateFieldInitSpec((0, _assertThisInitialized2.default)(_this), _copyableRangesFactory, {
       writable: true,
       value: new _copyableRanges.CopyableRangesFactory({
@@ -71301,7 +71432,19 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
         }
       })
     });
+    /**
+     * Ranges of the cells coordinates, which should be used to copy/cut/paste actions.
+     *
+     * @private
+     * @type {Array<{startRow: number, startCol: number, endRow: number, endCol: number}>}
+     */
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "copyableRanges", []);
+    /**
+     * Provides focusable element to support IME and copy/paste/cut actions.
+     *
+     * @private
+     * @type {FocusableWrapper}
+     */
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "focusableElement", void 0);
     return _this;
   }
@@ -71610,15 +71753,6 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
       var _this$hot$getActiveEd2;
       return (_this$hot$getActiveEd2 = this.hot.getActiveEditor()) === null || _this$hot$getActiveEd2 === void 0 ? void 0 : _this$hot$getActiveEd2.isOpened();
     }
-
-    /**
-     * Counts how many column headers will be copied based on the passed range.
-     *
-     * @private
-     * @param {Array<{startRow: number, startCol: number, endRow: number, endCol: number}>} ranges Array of objects with properties `startRow`, `startCol`, `endRow` and `endCol`.
-     * @returns {{ columnHeadersCount: number }} Returns an object with keys that holds
-     *                                           information with the number of copied headers.
-     */
   }, {
     key: "populateValues",
     value:
@@ -71904,13 +72038,6 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
     get: function get() {
       return PLUGIN_PRIORITY;
     }
-
-    /**
-     * The maximum number of columns than can be copied to the clipboard.
-     *
-     * @type {number}
-     * @default Infinity
-     */
   }]);
   return CopyPaste;
 }(_base.BasePlugin);
@@ -72497,7 +72624,21 @@ var CopyableRangesFactory = /*#__PURE__*/function () {
       columnsLimit = _ref.columnsLimit,
       countColumnHeaders = _ref.countColumnHeaders;
     (0, _classCallCheck2.default)(this, CopyableRangesFactory);
+    /**
+     * Trimmed the rows range to the limit.
+     *
+     * @param {*} startRow The lowest row index in the range.
+     * @param {*} endRow The highest row index in the range.
+     * @returns {number} Returns trimmed row index if it exceeds the limit.
+     */
     _classPrivateMethodInitSpec(this, _trimRowsRange);
+    /**
+     * Trimmed the columns range to the limit.
+     *
+     * @param {*} startColumn The lowest column index in the range.
+     * @param {*} endColumn The highest column index in the range.
+     * @returns {number} Returns trimmed column index if it exceeds the limit.
+     */
     _classPrivateMethodInitSpec(this, _trimColumnsRange);
     _classPrivateFieldInitSpec(this, _selectedRange, {
       writable: true,
@@ -72625,14 +72766,6 @@ var CopyableRangesFactory = /*#__PURE__*/function () {
         endCol: finalEndCol
       };
     }
-
-    /**
-     * Trimmed the columns range to the limit.
-     *
-     * @param {*} startColumn The lowest column index in the range.
-     * @param {*} endColumn The highest column index in the range.
-     * @returns {number} Returns trimmed column index if it exceeds the limit.
-     */
   }]);
   return CopyableRangesFactory;
 }();
@@ -72809,6 +72942,12 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
       args[_key] = arguments[_key];
     }
     _this = _super.call.apply(_super, [this].concat(args));
+    /**
+     * Saved borders.
+     *
+     * @private
+     * @type {Array}
+     */
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "savedBorders", []);
     return _this;
   }
@@ -73559,13 +73698,6 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
     get: function get() {
       return PLUGIN_PRIORITY;
     }
-
-    /**
-     * Saved borders.
-     *
-     * @private
-     * @type {Array}
-     */
   }]);
   return CustomBorders;
 }(_base.BasePlugin);
@@ -79809,10 +79941,22 @@ var HiddenColumns = /*#__PURE__*/function (_BasePlugin) {
       args[_key] = arguments[_key];
     }
     _this = _super.call.apply(_super, [this].concat(args));
+    /**
+     * Cached plugin settings.
+     *
+     * @private
+     * @type {object}
+     */
     _classPrivateFieldInitSpec((0, _assertThisInitialized2.default)(_this), _settings, {
       writable: true,
       value: {}
     });
+    /**
+     * Map of hidden columns by the plugin.
+     *
+     * @private
+     * @type {null|HidingMap}
+     */
     _classPrivateFieldInitSpec((0, _assertThisInitialized2.default)(_this), _hiddenColumnsMap, {
       writable: true,
       value: null
@@ -80232,13 +80376,6 @@ var HiddenColumns = /*#__PURE__*/function (_BasePlugin) {
     get: function get() {
       return PLUGIN_PRIORITY;
     }
-
-    /**
-     * Cached plugin settings.
-     *
-     * @private
-     * @type {object}
-     */
   }]);
   return HiddenColumns;
 }(_base.BasePlugin);
@@ -80633,10 +80770,22 @@ var HiddenRows = /*#__PURE__*/function (_BasePlugin) {
       args[_key] = arguments[_key];
     }
     _this = _super.call.apply(_super, [this].concat(args));
+    /**
+     * Cached settings from Handsontable settings.
+     *
+     * @private
+     * @type {object}
+     */
     _classPrivateFieldInitSpec((0, _assertThisInitialized2.default)(_this), _settings, {
       writable: true,
       value: {}
     });
+    /**
+     * Map of hidden rows by the plugin.
+     *
+     * @private
+     * @type {HidingMap|null}
+     */
     _classPrivateFieldInitSpec((0, _assertThisInitialized2.default)(_this), _hiddenRowsMap, {
       writable: true,
       value: null
@@ -81048,13 +81197,6 @@ var HiddenRows = /*#__PURE__*/function (_BasePlugin) {
     get: function get() {
       return PLUGIN_PRIORITY;
     }
-
-    /**
-     * Cached settings from Handsontable settings.
-     *
-     * @private
-     * @type {object}
-     */
   }]);
   return HiddenRows;
 }(_base.BasePlugin);
@@ -88170,17 +88312,43 @@ var NestedHeaders = /*#__PURE__*/function (_BasePlugin) {
       args[_key] = arguments[_key];
     }
     _this = _super.call.apply(_super, [this].concat(args));
+    /**
+     * The state manager for the nested headers.
+     *
+     * @private
+     * @type {StateManager}
+     */
     _classPrivateFieldInitSpec((0, _assertThisInitialized2.default)(_this), _stateManager, {
       writable: true,
       value: new _stateManager2.default()
     });
+    /**
+     * The instance of the ChangesObservable class that allows track the changes that happens in the
+     * column indexes.
+     *
+     * @private
+     * @type {ChangesObservable}
+     */
     _classPrivateFieldInitSpec((0, _assertThisInitialized2.default)(_this), _hidingIndexMapObserver, {
       writable: true,
       value: null
     });
+    /**
+     * Custom helper for getting widths of the nested headers.
+     *
+     * @private
+     * @type {GhostTable}
+     */
+    // @TODO This should be changed after refactor handsontable/utils/ghostTable.
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "ghostTable", new _ghostTable.default(_this.hot, function (row, column) {
       return _this.getHeaderSettings(row, column);
     }));
+    /**
+     * The flag which determines that the nested header settings contains overlapping headers
+     * configuration.
+     *
+     * @type {boolean}
+     */
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "detectedOverlappedHeaders", false);
     return _this;
   }
@@ -88812,13 +88980,6 @@ var NestedHeaders = /*#__PURE__*/function (_BasePlugin) {
     get: function get() {
       return PLUGIN_PRIORITY;
     }
-
-    /**
-     * The state manager for the nested headers.
-     *
-     * @private
-     * @type {StateManager}
-     */
   }]);
   return NestedHeaders;
 }(_base.BasePlugin);
@@ -88896,14 +89057,32 @@ var _stateMatrix = /*#__PURE__*/new WeakMap();
 var StateManager = /*#__PURE__*/function () {
   function StateManager() {
     (0, _classCallCheck2.default)(this, StateManager);
+    /**
+     * The instance of the source settings class.
+     *
+     * @private
+     * @type {SourceSettings}
+     */
     _classPrivateFieldInitSpec(this, _sourceSettings, {
       writable: true,
       value: new _sourceSettings2.default()
     });
+    /**
+     * The instance of the headers tree. The tree is generated after setting new configuration data.
+     *
+     * @private
+     * @type {HeadersTree}
+     */
     _classPrivateFieldInitSpec(this, _headersTree, {
       writable: true,
       value: new _headersTree2.default((0, _classPrivateFieldGet4.default)(this, _sourceSettings))
     });
+    /**
+     * Cached matrix which is generated from the tree structure.
+     *
+     * @private
+     * @type {Array[]}
+     */
     _classPrivateFieldInitSpec(this, _stateMatrix, {
       writable: true,
       value: [[]]
@@ -89309,14 +89488,33 @@ var _columnsLimit = /*#__PURE__*/new WeakMap();
 var SourceSettings = /*#__PURE__*/function () {
   function SourceSettings() {
     (0, _classCallCheck2.default)(this, SourceSettings);
+    /**
+     * The normalized source data (normalized user-defined settings for nested headers).
+     *
+     * @private
+     * @type {Array[]}
+     */
     _classPrivateFieldInitSpec(this, _data, {
       writable: true,
       value: []
     });
+    /**
+     * The total length of the nested header layers.
+     *
+     * @private
+     * @type {number}
+     */
     _classPrivateFieldInitSpec(this, _dataLength, {
       writable: true,
       value: 0
     });
+    /**
+     * Columns count limit value trims source settings to that value. If columns
+     * count limit intersects nested header, the header's colspan value is reduced
+     * to keep the whole structure stable (trimmed precisely where the limit is set).
+     *
+     * @type {number}
+     */
     _classPrivateFieldInitSpec(this, _columnsLimit, {
       writable: true,
       value: Infinity