handsontable 0.0.0-next-1b1acbd-20221123 → 0.0.0-next-561a94b-20221129

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-1b1acbd-20221123
- * Release date: 25/10/2022 (built at 23/11/2022 12:56:32)
+ * Version: 0.0.0-next-561a94b-20221129
+ * Release date: 25/10/2022 (built at 29/11/2022 07:43:50)
  */
 (function webpackUniversalModuleDefinition(root, factory) {
 	if(typeof exports === 'object' && typeof module === 'object')
@@ -2795,7 +2795,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-1b1acbd-20221123";
+  var hotVersion = "0.0.0-next-561a94b-20221129";
   var keyValidityDate;
   var consoleMessageState = 'invalid';
   var domMessageState = 'invalid';
@@ -4578,14 +4578,12 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
 /**
  * Fired after retrieving information about a column header and appending it to the table header.
  *
- * Since the 12.2 the hook is triggered with the 3rd `headerLevel` argument.
- *
  * @event Hooks#afterGetColHeader
  * @param {number} column Visual column index.
  * @param {HTMLTableCellElement} TH Header's TH element.
- * @param {number} [headerLevel=0] The index of header level. The header level accepts positive (0 to N)
- *                                 and negative (-1 to -N) values. For positive values, 0 points to the
- *                                 top most header, and for negative direction, -1 points to the most bottom
+ * @param {number} [headerLevel=0] (Since 12.2.0) Header level index. Accepts positive (0 to n)
+ *                                 and negative (-1 to -n) values. For positive values, 0 points to the
+ *                                 topmost header. For negative values, -1 points to the bottom-most
  *                                 header (the header closest to the cells).
  */
 'afterGetColHeader',
@@ -5537,7 +5535,7 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  */
 'modifyCopyableRange',
 /**
- * Fired by {@link CopyPaste} plugin before copying the values into clipboard and before clearing values of
+ * Fired by {@link CopyPaste} plugin before copying the values to the clipboard and before clearing values of
  * the selected cells. This hook is fired when {@link Options#copyPaste} option is enabled.
  *
  * @event Hooks#beforeCut
@@ -5592,22 +5590,19 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  * {@link Options#copyPaste} option is enabled.
  *
  * @event Hooks#afterCut
- * @param {Array[]} data An array of arrays which contains the cut out data.
+ * @param {Array[]} data An array of arrays with the cut data.
  * @param {object[]} coords An array of objects with ranges of the visual indexes (`startRow`, `startCol`, `endRow`, `endCol`)
  *                       which was cut out.
  */
 'afterCut',
 /**
- * Fired before values are copied into clipboard.
- *
- * Since the 12.3.0 the hook is triggered with the 3rd `copiedHeadersCount` argument.
+ * Fired before values are copied to the clipboard.
  *
  * @event Hooks#beforeCopy
  * @param {Array[]} data An array of arrays which contains data to copied.
  * @param {object[]} coords An array of objects with ranges of the visual indexes (`startRow`, `startCol`, `endRow`, `endCol`)
  *                         which will copied.
- * @param {{ columnHeadersCount: number }} copiedHeadersCount An object with keys that holds information with
- *                                                            the number of copied headers.
+ * @param {{ columnHeadersCount: number }} copiedHeadersCount (Since 12.3.0) The number of copied column headers.
  * @returns {*} If returns `false` then copying is canceled.
  *
  * @example
@@ -5670,6 +5665,7 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  * @param {Array[]} data An array of arrays which contains the copied data.
  * @param {object[]} coords An array of objects with ranges of the visual indexes (`startRow`, `startCol`, `endRow`, `endCol`)
  *                         which was copied.
+ * @param {{ columnHeadersCount: number }} copiedHeadersCount (Since 12.3.0) The number of copied column headers.
  */
 'afterCopy',
 /**
@@ -5728,7 +5724,7 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  * {@link Options#copyPaste} option is enabled.
  *
  * @event Hooks#afterPaste
- * @param {Array[]} data An array of arrays which contains the pasted data.
+ * @param {Array[]} data An array of arrays with the pasted data.
  * @param {object[]} coords An array of objects with ranges of the visual indexes (`startRow`, `startCol`, `endRow`, `endCol`)
  *                       that correspond to the previously selected area.
  */
@@ -6036,17 +6032,17 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  */
 'modifyColumnHeaderHeight',
 /**
- * Fired while retrieving the column header value.
+ * Fired while retrieving a column header's value.
  *
  * @since 12.3.0
  * @event Hooks#modifyColumnHeaderValue
- * @param {string} value The column header value.
- * @param {number} visualColumnIndex The visual column index.
- * @param {number} [headerLevel=0] The index of header level. The header level accepts positive (0 to N)
- *                                 and negative (-1 to -N) values. For positive values, 0 points to the
- *                                 top most header, and for negative direction, -1 points to the most bottom
+ * @param {string} value A column header value.
+ * @param {number} visualColumnIndex A visual column index.
+ * @param {number} [headerLevel=0] Header level index. Accepts positive (0 to n)
+ *                                 and negative (-1 to -n) values. For positive values, 0 points to the
+ *                                 topmost header. For negative values, -1 points to the bottom-most
  *                                 header (the header closest to the cells).
- * @returns {string} Returns the column header value to update.
+ * @returns {string} The column header value to be updated.
  */
 'modifyColumnHeaderValue',
 /**
@@ -25923,21 +25919,43 @@ function Core(rootElement, userSettings) {
   };
 
   /**
-   * Returns an array of column headers (in string format, if they are enabled). If param `column` is given, it
-   * returns the header at the given column.
+   * Gets the values of column headers (if column headers are [enabled](@/api/options.md#colheaders)).
+   *
+   * To get an array with the values of all
+   * [bottom-most](@/guides/cell-features/clipboard.md#copy-with-headers) column headers,
+   * call `getColHeader()` with no arguments.
+   *
+   * To get the value of the bottom-most header of a specific column, use the `column` parameter.
+   *
+   * To get the value of a [specific-level](@/guides/columns/column-groups.md) header
+   * of a specific column, use the `column` and `headerLevel` parameters.
    *
-   * Since the 12.3.0 the method accepts the 2nd `headerLevel` argument.
+   * Read more:
+   * - [Guides: Column groups](@/guides/columns/column-groups.md)
+   * - [Options: `colHeaders`](@/api/options.md#colheaders)
+   * - [Guides: Copy with headers](@/guides/cell-features/clipboard.md#copy-with-headers)
+   *
+   * ```js
+   * // get the contents of all bottom-most column headers
+   * hot.getColHeader();
+   *
+   * // get the contents of the bottom-most header of a specific column
+   * hot.getColHeader(5);
+   *
+   * // get the contents of a specific column header at a specific level
+   * hot.getColHeader(5, -2);
+   * ```
    *
    * @memberof Core#
    * @function getColHeader
-   * @param {number} [column] Visual column index.
-   * @param {number} [headerLevel=-1] The index of header level. The header level accepts positive (0 to N)
-   *                                  and negative (-1 to -N) values. For positive values, 0 points to the
-   *                                  top most header, and for negative direction, -1 points to the most bottom
+   * @param {number} [column] A visual column index.
+   * @param {number} [headerLevel=-1] (Since 12.3.0) Header level index. Accepts positive (0 to n)
+   *                                  and negative (-1 to -n) values. For positive values, 0 points to the
+   *                                  topmost header. For negative values, -1 points to the bottom-most
    *                                  header (the header closest to the cells).
    * @fires Hooks#modifyColHeader
    * @fires Hooks#modifyColumnHeaderValue
-   * @returns {Array|string|number} The column header(s).
+   * @returns {Array|string|number} Column header values.
    */
   this.getColHeader = function (column) {
     var headerLevel = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : -1;
@@ -28634,7 +28652,7 @@ var CellRange = /*#__PURE__*/function () {
   }, {
     key: "getHeight",
     value: function getHeight() {
-      // If the selection contains only rows headers return 0.
+      // if the selection contains only row headers, return 0
       if (this.from.row < 0 && this.to.row < 0) {
         return 0;
       }
@@ -28651,7 +28669,7 @@ var CellRange = /*#__PURE__*/function () {
   }, {
     key: "getWidth",
     value: function getWidth() {
-      // If the selection contains only columns headers return 0.
+      // if the selection contains only column headers, return 0
       if (this.from.col < 0 && this.to.col < 0) {
         return 0;
       }
@@ -33623,17 +33641,23 @@ var _default = function _default() {
      * | `false`           | Disable the [`CopyPaste`](@/api/copyPaste.md) plugin                                                                   |
      * | An object         | - Enable the [`CopyPaste`](@/api/copyPaste.md) plugin<br>- Modify the [`CopyPaste`](@/api/copyPaste.md) plugin options |
      *
+     * ##### copyPaste: Additional options
+     *
      * If you set the `copyPaste` option to an object, you can set the following `CopyPaste` plugin options:
      *
-     * | Option         | Possible settings                                  | Description                                                                                                                                                                             |
-     * | -------------- | -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-     * | `columnsLimit` | A number (default: `Infinity`)                       | A maximum number of columns that can be copied                                                                                                                                        |
-     * | `rowsLimit`    | A number (default: `Infinity`)                       | A maximum number of columns that can be copied                                                                                                                                        |
-     * | `pasteMode`    | `'overwrite'` \| `'shift_down'` \| `'shift_right'` | When pasting:<br>`'overwrite'`: overwrite currently-selected cells<br>`'shift_down'`: move currently-selected cells down<br>`'shift_right'`: move currently-selected cells to the right |
-     * | `uiContainer`  | An HTML element                                    | A UI container for the secondary focusable element                                                                                                                                      |
+     * | Option                   | Possible settings                                  | Description                                                                                                                                                                                         |
+     * | ------------------------ | -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+     * | `columnsLimit`           | A number (default: `Infinity`)                     | The maximum number of columns that can be copied                                                                                                                                                    |
+     * | `rowsLimit`              | A number (default: `Infinity`)                     | The maximum number of columns that can be copied                                                                                                                                                    |
+     * | `pasteMode`              | `'overwrite'` \| `'shift_down'` \| `'shift_right'` | When pasting:<br>`'overwrite'`: overwrite the currently-selected cells<br>`'shift_down'`: move the currently-selected cells down<br>`'shift_right'`: move the currently-selected cells to the right |
+     * | `copyColumnHeaders`      | Boolean (default: `false`)                         | `true`: add a context menu option for copying cells along with their nearest column headers                                                                                                         |
+     * | `copyColumnGroupHeaders` | Boolean (default: `false`)                         | `true`: add a context menu option for copying cells along with all their related columns headers                                                                                                    |
+     * | `copyColumnHeadersOnly`  | Boolean (default: `false`)                         | `true`: add a context menu option for copying column headers nearest to the selected cells (without copying cells)                                                                    |
+     * | `uiContainer`            | An HTML element                                    | The UI container for the secondary focusable element                                                                                                                                                |
      *
      * Read more:
      * - [Plugins: `CopyPaste`](@/api/copyPaste.md)
+     * - [Guides: Clipboard](@/guides/cell-features/clipboard.md)
      *
      * @memberof Options#
      * @type {object|boolean}
@@ -33642,19 +33666,33 @@ var _default = function _default() {
      *
      * @example
      * ```js
-     * // disable the `CopyPaste` plugin
+     * // enable the plugin with the default configuration
+     * copyPaste: true // set by default
+     *
+     * // disable the plugin
      * copyPaste: false,
      *
-     * // enable the `CopyPaste` plugin
-     * // and modify the `CopyPaste` plugin options
+     * // enable the plugin with a custom configuration
      * copyPaste: {
-     *   // set the maximum number of columns that can be copied
+     *   // set a maximum number of columns that can be copied
      *   columnsLimit: 25,
-     *   // set the maximum number of rows that can be copied
+     *
+     *   // set a maximum number of rows that can be copied
      *   rowsLimit: 50,
+     *
      *   // set the paste behavior
      *   pasteMode: 'shift_down',
-     *   // set the UI container
+     *
+     *   // add the option to copy cells along with their nearest column headers
+     *   copyColumnHeaders: true,
+     *
+     *   // add the option to copy cells along with all their related columns headers
+     *   copyColumnGroupHeaders: true,
+     *
+     *   // add the option to copy just column headers (without copying cells)
+     *   copyColumnHeadersOnly: true,
+     *
+     *   // set a UI container
      *   uiContainer: document.body,
      * },
      * ```
@@ -41381,8 +41419,8 @@ Handsontable.Core = function (rootElement) {
 Handsontable.DefaultSettings = (0, _dataMap.metaSchemaFactory)();
 Handsontable.hooks = _pluginHooks.default.getSingleton();
 Handsontable.packageName = 'handsontable';
-Handsontable.buildDate = "23/11/2022 12:56:32";
-Handsontable.version = "0.0.0-next-1b1acbd-20221123";
+Handsontable.buildDate = "29/11/2022 07:43:50";
+Handsontable.version = "0.0.0-next-561a94b-20221129";
 Handsontable.languages = {
   dictionaryKeys: _registry.dictionaryKeys,
   getLanguageDictionary: _registry.getLanguageDictionary,
@@ -51724,10 +51762,10 @@ var IndexMapper = /*#__PURE__*/function () {
     }
 
     /**
-     * Creates and register the new IndexMap for specified IndexMapper instance.
+     * Creates and registers a new `IndexMap` for a specified `IndexMapper` instance.
      *
-     * @param {string} indexName The uniq index name.
-     * @param {string} mapType The index map type (e.q. "hiding, "trimming", "physicalIndexToValue").
+     * @param {string} indexName A unique index name.
+     * @param {string} mapType The index map type (e.g., "hiding", "trimming", "physicalIndexToValue").
      * @param {*} [initValueOrFn] The initial value for the index map.
      * @returns {IndexMap}
      */
@@ -69153,22 +69191,7 @@ _pluginHooks.default.getSingleton().register('afterContextMenuExecute');
  * * `true` (to enable default options),
  * * `false` (to disable completely)
  * * `{ uiContainer: containerDomElement }` (to declare a container for all of the Context Menu's dom elements to be placed in).
- *
- * or array of any available strings:
- * * `'row_above'`
- * * `'row_below'`
- * * `'col_left'`
- * * `'col_right'`
- * * `'remove_row'`
- * * `'remove_col'`
- * * `'undo'`
- * * `'redo'`
- * * `'make_read_only'`
- * * `'alignment'`
- * * `'---------'` (menu item separator)
- * * `'borders'` (with {@link Options#customBorders} turned on)
- * * `'commentsAddEdit'` (with {@link Options#comments} turned on)
- * * `'commentsRemove'` (with {@link Options#comments} turned on).
+ * * An array of [the available strings](@/guides/accessories-and-menus/context-menu.md#context-menu-with-specific-options)
  *
  * See [the context menu demo](@/guides/accessories-and-menus/context-menu.md) for examples.
  *
@@ -70662,28 +70685,25 @@ var META_HEAD = ['<meta name="generator" content="Handsontable"/>', '<style type
 /* eslint-disable jsdoc/require-description-complete-sentence */
 /**
  * @description
- * This plugin enables the copy/paste functionality in the Handsontable. The functionality works for API, Context Menu,
- * using keyboard shortcuts and menu bar from the browser.
- * Possible values:
- * * `true` (to enable default options),
- * * `false` (to disable completely).
+ * Copy, cut, and paste data by using the `CopyPaste` plugin.
+ *
+ * Control the `CopyPaste` plugin programmatically through its [API methods](#methods).
  *
- * or an object with values:
- * * `'columnsLimit'` (see {@link CopyPaste#columnsLimit})
- * * `'rowsLimit'` (see {@link CopyPaste#rowsLimit})
- * * `'pasteMode'` (see {@link CopyPaste#pasteMode})
- * * `'copyColumnHeaders'`
- * * `'copyColumnGroupHeaders'`
- * * `'copyColumnHeadersOnly'`
- * * `'uiContainer'` (see {@link CopyPaste#uiContainer}).
+ * The user can access the copy-paste features through:
+ * - The [context menu](@/guides/cell-features/clipboard.md#context-menu).
+ * - The [keyboard shortcuts](@/guides/cell-features/clipboard.md#related-keyboard-shortcuts).
+ * - The browser's menu bar.
  *
- * See [the copy/paste demo](@/guides/cell-features/clipboard.md) for examples.
+ * Read more:
+ * - [Guides: Clipboard](@/guides/cell-features/clipboard.md)
+ * - [Configuration options: `copyPaste`](@/api/options.md#copypaste)
  *
  * @example
  * ```js
- * // Enables the plugin with default values
+ * // enable the plugin with the default configuration
  * copyPaste: true,
- * // Enables the plugin with custom values
+ *
+ * // or, enable the plugin with a custom configuration
  * copyPaste: {
  *   columnsLimit: 25,
  *   rowsLimit: 50,
@@ -70772,8 +70792,10 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
     key: "isEnabled",
     value:
     /**
-     * Checks if the plugin is enabled in the handsontable settings. This method is executed in {@link Hooks#beforeInit}
-     * hook and if it returns `true` then the {@link CopyPaste#enablePlugin} method is called.
+     * Checks if the [`CopyPaste`](#copypaste) plugin is enabled.
+     *
+     * This method gets called by Handsontable's [`beforeInit`](@/api/hooks.md#beforeinit) hook.
+     * If it returns `true`, the [`enablePlugin()`](#enableplugin) method gets called.
      *
      * @returns {boolean}
      */
@@ -70782,7 +70804,7 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
     }
 
     /**
-     * Enables the plugin functionality for this Handsontable instance.
+     * Enables the [`CopyPaste`](#copypaste) plugin for your Handsontable instance.
      */
   }, {
     key: "enablePlugin",
@@ -70827,9 +70849,10 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
     }
 
     /**
-     * Updates the plugin's state.
+     * Updates the state of the [`CopyPaste`](#copypaste) plugin.
      *
-     * This method is executed when [`updateSettings()`](@/api/core.md#updatesettings) is invoked with any of the following configuration options:
+     * Gets called when [`updateSettings()`](@/api/core.md#updatesettings)
+     * is invoked with any of the following configuration options:
      *  - [`copyPaste`](@/api/options.md#copypaste)
      *  - [`fragmentSelection`](@/api/options.md#fragmentselection)
      */
@@ -70843,7 +70866,7 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
     }
 
     /**
-     * Disables the plugin functionality for this Handsontable instance.
+     * Disables the [`CopyPaste`](#copypaste) plugin for your Handsontable instance.
      */
   }, {
     key: "disablePlugin",
@@ -70855,12 +70878,18 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
     }
 
     /**
-     * Copies the selected cell with or without column headers into the clipboard.
+     * Copies the contents of the selected cells (and/or their related column headers) to the system clipboard.
+     *
+     * Takes an optional parameter (`copyMode`) that defines the scope of copying:
      *
-     * @param {'cells-only' | 'column-headers-only' | 'with-all-column-headers' | 'with-column-headers'} [copyMode='cells-only']
-     * Defines the data range to copy. Possible values: `cells-only` (copy selected cells only),
-     * `column-headers-only` (copy the most-bottom column headers only), `with-all-column-headers` (copy cells
-     * with all column headers levels) or `with-column-headers` (copy cells with the most-bottom column headers).
+     * | `copyMode` value            | Description                                                     |
+     * | --------------------------- | --------------------------------------------------------------- |
+     * | `'cells-only'` (default)    | Copy the selected cells                                         |
+     * | `'with-column-headers'`     | - Copy the selected cells<br>- Copy the nearest column headers  |
+     * | `'with-all-column-headers'` | - Copy the selected cells<br>- Copy all related columns headers |
+     * | `'column-headers-only'`     | Copy the nearest column headers (without copying cells)         |
+     *
+     * @param {string} [copyMode='cells-only'] Copy mode.
      */
   }, {
     key: "copy",
@@ -70874,7 +70903,7 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
     }
 
     /**
-     * Copies the selected cell/cells into the clipboard.
+     * Copies the contents of the selected cells.
      */
   }, {
     key: "copyCellsOnly",
@@ -70882,7 +70911,7 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
       this.copy('cells-only');
     }
     /**
-     * Copies only the most-bottom column headers into the clipboard.
+     * Copies the contents of column headers that are nearest to the selected cells.
      */
   }, {
     key: "copyColumnHeadersOnly",
@@ -70890,7 +70919,7 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
       this.copy('column-headers-only');
     }
     /**
-     * Copies the selected cell/cells and all column headers levels (including column group) into the clipboard.
+     * Copies the contents of the selected cells and all their related column headers.
      */
   }, {
     key: "copyWithAllColumnHeaders",
@@ -70898,7 +70927,7 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
       this.copy('with-column-group-headers');
     }
     /**
-     * Copies the selected cell/cells and most-bottom column headers into the clipboard.
+     * Copies the contents of the selected cells and their nearest column headers.
      */
   }, {
     key: "copyWithColumnHeaders",
@@ -70907,7 +70936,7 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
     }
 
     /**
-     * Cuts the selected cell into the clipboard.
+     * Cuts the contents of the selected cells to the system clipboard.
      */
   }, {
     key: "cut",
@@ -70919,10 +70948,10 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
     }
 
     /**
-     * Creates copyable text related to range objects.
+     * Converts the contents of multiple ranges (`ranges`) into a single string.
      *
      * @param {Array<{startRow: number, startCol: number, endRow: number, endCol: number}>} ranges Array of objects with properties `startRow`, `endRow`, `startCol` and `endCol`.
-     * @returns {string} Returns string which will be copied into clipboard.
+     * @returns {string} A string that will be copied to the clipboard.
      */
   }, {
     key: "getRangedCopyableData",
@@ -70931,10 +70960,10 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
     }
 
     /**
-     * Creates copyable text related to range objects.
+     * Converts the contents of multiple ranges (`ranges`) into an array of arrays.
      *
      * @param {Array<{startRow: number, startCol: number, endRow: number, endCol: number}>} ranges Array of objects with properties `startRow`, `startCol`, `endRow` and `endCol`.
-     * @returns {Array[]} Returns array of arrays which will be copied into clipboard.
+     * @returns {Array[]} An array of arrays that will be copied to the clipboard.
      */
   }, {
     key: "getRangedData",
@@ -70945,12 +70974,12 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
         rows = _normalizeRanges.rows,
         columns = _normalizeRanges.columns;
 
-      // Concat all rows and columns data defined in ranges into one copyable string
+      // concatenate all rows and columns data defined in ranges into one copyable string
       (0, _array.arrayEach)(rows, function (row) {
         var rowSet = [];
         (0, _array.arrayEach)(columns, function (column) {
           if (row < 0) {
-            // 'row' as the second argument act here as 'headerLevel' argument
+            // `row` as the second argument acts here as the `headerLevel` argument
             rowSet.push(_this3.hot.getColHeader(column, row));
           } else {
             rowSet.push(_this3.hot.getCopyableData(row, column));
@@ -70964,10 +70993,10 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
     /**
      * Simulates the paste action.
      *
-     * Due to security reasons, modern browsers disallow reading from the system clipboard.
+     * For security reasons, modern browsers don't allow reading from the system clipboard.
      *
-     * @param {string} pastableText Value as raw string to paste.
-     * @param {string} [pastableHtml=''] Value as HTML to paste.
+     * @param {string} pastableText The value to paste, as a raw string.
+     * @param {string} [pastableHtml=''] The value to paste, as HTML.
      */
   }, {
     key: "paste",
@@ -71332,7 +71361,7 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
     }
 
     /**
-     * Destroys the plugin instance.
+     * Destroys the `CopyPaste` plugin instance.
      */
   }, {
     key: "destroy",
@@ -71360,7 +71389,7 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
     }
 
     /**
-     * Maximum number of columns than can be copied to clipboard using <kbd>**Ctrl**</kbd>/<kbd>**Cmd**</kbd> + <kbd>**C**</kbd>.
+     * The maximum number of columns than can be copied to the clipboard.
      *
      * @type {number}
      * @default Infinity

package/dist/handsontable.min.css

@@ -26,8 +26,8 @@
  * INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER ARISING FROM
  * USE OR INABILITY TO USE THIS SOFTWARE.
  * 
- * Version: 0.0.0-next-1b1acbd-20221123
- * Release date: 25/10/2022 (built at 23/11/2022 12:57:03)
+ * Version: 0.0.0-next-561a94b-20221129
+ * Release date: 25/10/2022 (built at 29/11/2022 07:44:34)
  */.handsontable .table td,.handsontable .table th{border-top:none}.handsontable tr{background:#fff}.handsontable td{background-color:inherit}.handsontable .table caption+thead tr:first-child td,.handsontable .table caption+thead tr:first-child th,.handsontable .table colgroup+thead tr:first-child td,.handsontable .table colgroup+thead tr:first-child th,.handsontable .table thead:first-child tr:first-child td,.handsontable .table thead:first-child tr:first-child th{border-top:1px solid #ccc}.handsontable .table-bordered{border:0;border-collapse:separate}.handsontable .table-bordered td,.handsontable .table-bordered th{border-left:none}.handsontable .table-bordered td:first-child,.handsontable .table-bordered th:first-child{border-left:1px solid #ccc}.handsontable .table>tbody>tr>td,.handsontable .table>tbody>tr>th,.handsontable .table>tfoot>tr>td,.handsontable .table>tfoot>tr>th,.handsontable .table>thead>tr>td,.handsontable .table>thead>tr>th{line-height:21px;padding:0}.col-lg-1.handsontable,.col-lg-2.handsontable,.col-lg-3.handsontable,.col-lg-4.handsontable,.col-lg-5.handsontable,.col-lg-6.handsontable,.col-lg-7.handsontable,.col-lg-8.handsontable,.col-lg-9.handsontable,.col-lg-10.handsontable,.col-lg-11.handsontable,.col-lg-12.handsontable,.col-md-1.handsontable,.col-md-2.handsontable,.col-md-3.handsontable,.col-md-4.handsontable,.col-md-5.handsontable,.col-md-6.handsontable,.col-md-7.handsontable,.col-md-8.handsontable,.col-md-9.handsontable .col-sm-1.handsontable,.col-md-10.handsontable,.col-md-11.handsontable,.col-md-12.handsontable,.col-sm-2.handsontable,.col-sm-3.handsontable,.col-sm-4.handsontable,.col-sm-5.handsontable,.col-sm-6.handsontable,.col-sm-7.handsontable,.col-sm-8.handsontable,.col-sm-9.handsontable .col-xs-1.handsontable,.col-sm-10.handsontable,.col-sm-11.handsontable,.col-sm-12.handsontable,.col-xs-2.handsontable,.col-xs-3.handsontable,.col-xs-4.handsontable,.col-xs-5.handsontable,.col-xs-6.handsontable,.col-xs-7.handsontable,.col-xs-8.handsontable,.col-xs-9.handsontable,.col-xs-10.handsontable,.col-xs-11.handsontable,.col-xs-12.handsontable{padding-left:0;padding-right:0}.handsontable .table-striped>tbody>tr:nth-of-type(2n){background-color:#fff}.handsontable{position:relative}.handsontable .hide{display:none}.handsontable .relative{position:relative}.handsontable .wtHider{width:0}.handsontable .wtSpreader{position:relative;width:0;height:auto}.handsontable div,.handsontable input,.handsontable table,.handsontable tbody,.handsontable td,.handsontable textarea,.handsontable th,.handsontable thead{box-sizing:content-box;-webkit-box-sizing:content-box;-moz-box-sizing:content-box}.handsontable input,.handsontable textarea{min-height:0}.handsontable table.htCore{border-collapse:separate;border-spacing:0;margin:0;border-width:0;table-layout:fixed;width:0;outline-width:0;cursor:default;max-width:none;max-height:none}.handsontable col,.handsontable col.rowHeader{width:50px}.handsontable td,.handsontable th{border-top-width:0;border-left-width:0;border-right:1px solid #ccc;border-bottom:1px solid #ccc;height:22px;empty-cells:show;line-height:21px;padding:0 4px;background-color:#fff;vertical-align:top;overflow:hidden;outline-width:0;white-space:pre-wrap}[dir=rtl].handsontable td,[dir=rtl].handsontable th{border-right-width:0;border-left:1px solid #ccc}.handsontable th:last-child{border-left:none;border-right:1px solid #ccc;border-bottom:1px solid #ccc}[dir=rtl].handsontable th:last-child{border-right:none;border-left:1px solid #ccc}.handsontable td:first-of-type,.handsontable th:first-child,.handsontable th:nth-child(2){border-left:1px solid #ccc}[dir=rtl].handsontable td:first-of-type,[dir=rtl].handsontable th:first-child,[dir=rtl].handsontable th:nth-child(2){border-right:1px solid #ccc}.handsontable .ht_clone_top th:nth-child(2){border-left-width:0;border-right:1px solid #ccc}[dir=rtl].handsontable .ht_clone_top th:nth-child(2){border-right-width:0;border-left:1px solid #ccc}.handsontable.htRowHeaders thead tr th:nth-child(2){border-left:1px solid #ccc}[dir=rtl].handsontable.htRowHeaders thead tr th:nth-child(2){border-right:1px solid #ccc}.handsontable tr:first-child td,.handsontable tr:first-child th{border-top:1px solid #ccc}.ht_master:not(.innerBorderInlineStart):not(.emptyColumns)~.handsontable:not(.ht_clone_top) thead tr th:first-child,.ht_master:not(.innerBorderInlineStart):not(.emptyColumns)~.handsontable tbody tr th{border-right-width:0;border-left:1px solid #ccc}[dir=rtl].ht_master:not(.innerBorderInlineStart):not(.emptyColumns)~.handsontable:not(.ht_clone_top) thead tr th:first-child,[dir=rtl].ht_master:not(.innerBorderInlineStart):not(.emptyColumns)~.handsontable tbody tr th{border-left-width:0;border-right:1px solid #ccc}.ht_master:not(.innerBorderTop):not(.innerBorderBottom) thead tr.lastChild th,.ht_master:not(.innerBorderTop):not(.innerBorderBottom) thead tr:last-child th,.ht_master:not(.innerBorderTop):not(.innerBorderBottom)~.handsontable thead tr.lastChild th,.ht_master:not(.innerBorderTop):not(.innerBorderBottom)~.handsontable thead tr:last-child th{border-bottom-width:0}.handsontable th{background-color:#f0f0f0;color:#222;text-align:center;font-weight:400;white-space:nowrap}.handsontable thead th{padding:0}.handsontable th.active{background-color:#ccc}.handsontable thead th .relative{padding:2px 4px}.handsontable span.colHeader{display:inline-block;line-height:1.1}.handsontable .wtBorder{position:absolute;font-size:0}.handsontable .wtBorder.hidden{display:none!important}.handsontable .wtBorder.current{z-index:10}.handsontable .wtBorder.area{z-index:8}.handsontable .wtBorder.fill{z-index:6}.handsontable .wtBorder.corner{font-size:0;cursor:crosshair}.ht_clone_master{z-index:100}.ht_clone_inline_start{z-index:120}.ht_clone_bottom{z-index:130}.ht_clone_bottom_inline_start_corner{z-index:150}.ht_clone_top{z-index:160}.ht_clone_top_inline_start_corner{z-index:180}.handsontable col.hidden{width:0!important}.handsontable tr.hidden,.handsontable tr.hidden td,.handsontable tr.hidden th{display:none}.ht_clone_bottom,.ht_clone_inline_start,.ht_clone_top,.ht_master{overflow:hidden}.ht_master .wtHolder{overflow:auto}.handsontable .ht_clone_inline_start thead,.handsontable .ht_master thead,.handsontable .ht_master tr th{visibility:hidden}.ht_clone_bottom .wtHolder,.ht_clone_inline_start .wtHolder,.ht_clone_top .wtHolder{overflow:hidden}.handsontable{touch-action:manipulation;font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Oxygen,Ubuntu,Helvetica Neue,Arial,sans-serif;font-size:13px;font-weight:400;color:#373737}.handsontable a{color:#104acc}.handsontable.htAutoSize{visibility:hidden;left:-99000px;position:absolute;top:-99000px}.handsontable td.htInvalid{background-color:#ff4c42!important}.handsontable td.htNoWrap{white-space:nowrap}#hot-display-license-info{font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Oxygen,Ubuntu,Helvetica Neue,Arial,sans-serif;font-size:10px;font-weight:400;color:#373737;padding:5px 0 3px;text-align:left}#hot-display-license-info a{color:#104acc;font-size:10px}.handsontable .manualColumnResizer{position:absolute;top:0;cursor:col-resize;z-index:210;width:5px;height:25px}.handsontable .manualRowResizer{position:absolute;left:0;cursor:row-resize;z-index:210;height:5px;width:50px}.handsontable .manualColumnResizer.active,.handsontable .manualColumnResizer:hover,.handsontable .manualRowResizer.active,.handsontable .manualRowResizer:hover{background-color:#34a9db}.handsontable .manualColumnResizerGuide{position:absolute;right:unset;top:0;background-color:#34a9db;display:none;width:0;border-right:1px dashed #777;border-left:none;margin-left:5px;margin-right:unset}[dir=rtl].handsontable .manualColumnResizerGuide{left:unset;border-left:1px dashed #777;border-right:none;margin-right:5px;margin-left:unset}.handsontable .manualRowResizerGuide{position:absolute;left:0;bottom:0;background-color:#34a9db;display:none;height:0;border-bottom:1px dashed #777;margin-top:5px}.handsontable .manualColumnResizerGuide.active,.handsontable .manualRowResizerGuide.active{display:block;z-index:209}.handsontable .columnSorting{position:relative}.handsontable .columnSorting.sortAction:hover{text-decoration:underline;cursor:pointer}.handsontable span.colHeader.columnSorting:before{top:50%;margin-top:-6px;padding-left:8px;padding-right:0;position:absolute;right:-9px;left:unset;content:"";height:10px;width:5px;background-size:contain;background-repeat:no-repeat;background-position-x:right}[dir=rtl].handsontable span.colHeader.columnSorting:before{padding-right:8px;padding-left:0;left:-9px;right:unset;background-position-x:left}.handsontable span.colHeader.columnSorting.ascending:before{background-image:url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAoCAMAAADJ7yrpAAAAKlBMVEUAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAKE86IAAAADXRSTlMABBEmRGprlJW72e77tTkTKwAAAFNJREFUeAHtzjkSgCAUBNHPgsoy97+ulGXRqJE5L+xkxoYt2UdsLb5bqFINz+aLuuLn5rIu2RkO3fZpWENimNgiw6iBYRTPMLJjGFxQZ1hxxb/xBI1qC8k39CdKAAAAAElFTkSuQmCC")}.handsontable span.colHeader.columnSorting.descending:before{background-image:url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAoCAMAAADJ7yrpAAAAKlBMVEUAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAKE86IAAAADXRSTlMABBEmRGprlJW72e77tTkTKwAAAFJJREFUeAHtzjkSgCAQRNFmQYUZ7n9dKUvru0TmvPAn3br0QfgdZ5xx6x+rQn23GqTYnq1FDcnuzZIO2WmedVqIRVxgGKEyjNgYRjKGkZ1hFIZ3I70LyM0VtU8AAAAASUVORK5CYII=")}.htGhostTable .htCore span.colHeader.columnSorting:not(.indicatorDisabled):after{content:"*";display:inline-block;position:relative;padding-right:20px}.handsontable td.area,.handsontable td.area-1,.handsontable td.area-2,.handsontable td.area-3,.handsontable td.area-4,.handsontable td.area-5,.handsontable td.area-6,.handsontable td.area-7{position:relative}.handsontable td.area-1:before,.handsontable td.area-2:before,.handsontable td.area-3:before,.handsontable td.area-4:before,.handsontable td.area-5:before,.handsontable td.area-6:before,.handsontable td.area-7:before,.handsontable td.area:before{content:"";position:absolute;top:0;left:0;right:0;bottom:0;bottom:-100%\9;background:#005eff}@media (-ms-high-contrast:none),screen and (-ms-high-contrast:active){.handsontable td.area-1:before,.handsontable td.area-2:before,.handsontable td.area-3:before,.handsontable td.area-4:before,.handsontable td.area-5:before,.handsontable td.area-6:before,.handsontable td.area-7:before,.handsontable td.area:before{bottom:-100%}}.handsontable td.area:before{opacity:.1}.handsontable td.area-1:before{opacity:.2}.handsontable td.area-2:before{opacity:.27}.handsontable td.area-3:before{opacity:.35}.handsontable td.area-4:before{opacity:.41}.handsontable td.area-5:before{opacity:.47}.handsontable td.area-6:before{opacity:.54}.handsontable td.area-7:before{opacity:.58}.handsontable tbody th.ht__highlight,.handsontable thead th.ht__highlight{background-color:#dcdcdc}.handsontable tbody th.ht__active_highlight,.handsontable thead th.ht__active_highlight{background-color:#8eb0e7;color:#000}.handsontableInput{border:none;outline-width:0;margin:0;padding:1px 5px 0;font-family:inherit;line-height:21px;font-size:inherit;box-shadow:inset 0 0 0 2px #5292f7;resize:none;display:block;color:#000;border-radius:0;background-color:#fff}.handsontableInput:focus{outline:none}.handsontableInputHolder{position:absolute;top:0;left:0}.htSelectEditor{-webkit-appearance:menulist-button!important;position:absolute;width:auto}.htSelectEditor:focus{outline:none}.handsontable .htDimmed{color:#777}.handsontable .htSubmenu{position:relative}.handsontable .htSubmenu :after{content:"▶";color:#777;position:absolute;right:5px;font-size:9px}[dir=rtl].handsontable .htSubmenu :after{content:""}[dir=rtl].handsontable .htSubmenu :before{content:"◀";color:#777;position:absolute;left:5px;font-size:9px}.handsontable .htLeft{text-align:left}.handsontable .htCenter{text-align:center}.handsontable .htRight{text-align:right}.handsontable .htJustify{text-align:justify}.handsontable .htTop{vertical-align:top}.handsontable .htMiddle{vertical-align:middle}.handsontable .htBottom{vertical-align:bottom}.handsontable .htPlaceholder{color:#999}.handsontable.listbox{margin:0}.handsontable.listbox .ht_master table{border:1px solid #ccc;border-collapse:separate;background:#fff}.handsontable.listbox td,.handsontable.listbox th,.handsontable.listbox tr:first-child td,.handsontable.listbox tr:first-child th,.handsontable.listbox tr:last-child th{border-color:transparent!important}.handsontable.listbox td,.handsontable.listbox th{white-space:nowrap;text-overflow:ellipsis}.handsontable.listbox td.htDimmed{cursor:default;color:inherit;font-style:inherit}.handsontable.listbox .wtBorder{visibility:hidden}.handsontable.listbox tr:hover td,.handsontable.listbox tr td.current{background:#eee}.ht_editor_hidden{z-index:-1}.ht_editor_visible{z-index:200}.handsontable td.htSearchResult{background:#fcedd9;color:#583707}.handsontable .collapsibleIndicator{position:absolute;top:50%;transform:translateY(-50%);left:unset;right:5px;border:1px solid #a6a6a6;line-height:8px;color:#222;border-radius:10px;font-size:10px;width:10px;height:10px;cursor:pointer;-webkit-box-shadow:0 0 0 6px #eee;-moz-box-shadow:0 0 0 6px #eee;box-shadow:0 0 0 6px #eee;background:#eee;text-align:center}[dir=rtl].handsontable .collapsibleIndicator{right:unset;left:5px}.handsontable.mobile,.handsontable.mobile .wtHolder{-webkit-touch-callout:none;-webkit-user-select:none;-khtml-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;-webkit-tap-highlight-color:rgba(0,0,0,0);-webkit-overflow-scrolling:touch}.handsontable.mobile .handsontableInput:focus{-webkit-box-shadow:0 0 0 2px #5292f7 inset;-moz-box-shadow:0 0 0 2px #5292f7 inset;box-shadow:inset 0 0 0 2px #5292f7;-webkit-appearance:none}.topSelectionHandle-HitArea:not(.ht_master .topSelectionHandle-HitArea),.topSelectionHandle:not(.ht_master .topSelectionHandle){z-index:9999}.handsontable .bottomSelectionHandle,.handsontable .bottomSelectionHandle-HitArea,.handsontable .topSelectionHandle,.handsontable .topSelectionHandle-HitArea{left:-10000px;right:unset;top:-10000px}[dir=rtl].handsontable .bottomSelectionHandle,[dir=rtl].handsontable .bottomSelectionHandle-HitArea,[dir=rtl].handsontable .topSelectionHandle,[dir=rtl].handsontable .topSelectionHandle-HitArea{right:-10000px;left:unset}.handsontable.hide-tween{-webkit-animation:opacity-hide .3s;animation:opacity-hide .3s;animation-fill-mode:forwards;-webkit-animation-fill-mode:forwards}.handsontable.show-tween{-webkit-animation:opacity-show .3s;animation:opacity-show .3s;animation-fill-mode:forwards;-webkit-animation-fill-mode:forwards}.handsontable .htAutocompleteArrow{float:right;font-size:10px;color:#eee;cursor:default;width:16px;text-align:center}[dir=rtl].handsontable .htAutocompleteArrow{float:left}.handsontable td .htAutocompleteArrow:hover{color:#777}.handsontable td.area .htAutocompleteArrow{color:#d3d3d3}.handsontable .htCheckboxRendererInput{display:inline-block}.handsontable .htCheckboxRendererInput.noValue{opacity:.5}.handsontable .htCheckboxRendererLabel{font-size:inherit;vertical-align:middle;cursor:pointer;display:inline-block}.handsontable .htCheckboxRendererLabel.fullWidth{width:100%}.handsontable .htCommentCell{position:relative}.handsontable .htCommentCell:after{content:"";position:absolute;top:0;right:0;left:unset;border-left:6px solid transparent;border-right:none;border-top:6px solid #000}[dir=rtl].handsontable .htCommentCell:after{left:0;right:unset;border-right:6px solid transparent;border-left:none}.htCommentsContainer .htComments{display:none;z-index:1059;position:absolute}.htCommentsContainer .htCommentTextArea{box-shadow:0 1px 3px rgba(0,0,0,.117647),0 1px 2px rgba(0,0,0,.239216);-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box;border:none;border-left:3px solid #ccc;background-color:#fff;width:215px;height:90px;font-size:12px;padding:5px;outline:0!important;-webkit-appearance:none}[dir=rtl].htCommentsContainer .htCommentTextArea{border-right:3px solid #ccc;border-left:none}.htCommentsContainer .htCommentTextArea:focus{box-shadow:0 1px 3px rgba(0,0,0,.117647),0 1px 2px rgba(0,0,0,.239216),inset 0 0 0 1px #5292f7;border-left:3px solid #5292f7;border-right:none}[dir=rtl].htCommentsContainer .htCommentTextArea:focus{border-right:3px solid #5292f7;border-left:none}
 /*!
  * Handsontable ContextMenu