handsontable 12.2.0 → 12.3.0-next-bb1a7c2-20221208

package/dataMap/metaManager/metaLayers/tableMeta.mjs

@@ -1,32 +1,46 @@
+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.object.to-string.js";
+import "core-js/modules/es.number.constructor.js";
+import "core-js/modules/es.symbol.iterator.js";
+import "core-js/modules/es.array.iterator.js";
+import "core-js/modules/es.string.iterator.js";
+import "core-js/modules/web.dom-collections.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); }
 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); }
 import { extend } from "../../../helpers/object.mjs";
-import { expandMetaType } from "../utils.mjs"; /**
-                                                * The table meta object is a layer that keeps all settings of the Handsontable that was passed in
-                                                * the constructor. That layer contains all default settings inherited from the GlobalMeta layer
-                                                * merged with settings passed by the developer. Adding, removing, or changing property in that
-                                                * object has no direct reflection on any other layers.
-                                                *
-                                                * +-------------+.
-                                                * │ GlobalMeta  │
-                                                * │ (prototype) │
-                                                * +-------------+\
-                                                *       │         \
-                                                *       │          \
-                                                *      \│/         _\|
-                                                * +-------------+    +-------------+.
-                                                * │ TableMeta   │    │ ColumnMeta  │
-                                                * │ (instance)  │    │ (prototype) │
-                                                * +-------------+    +-------------+.
-                                                *                         │
-                                                *                         │
-                                                *                        \│/
-                                                *                    +-------------+.
-                                                *                    │  CellMeta   │
-                                                *                    │ (instance)  │
-                                                *                    +-------------+.
-                                                */
+import { extendByMetaType } from "../utils.mjs";
+/**
+ * The table meta object is a layer that keeps all settings of the Handsontable that was passed in
+ * the constructor. That layer contains all default settings inherited from the GlobalMeta layer
+ * merged with settings passed by the developer. Adding, removing, or changing property in that
+ * object has no direct reflection on any other layers.
+ *
+ * +-------------+.
+ * │ GlobalMeta  │
+ * │ (prototype) │
+ * +-------------+\
+ *       │         \
+ *       │          \
+ *      \│/         _\|
+ * +-------------+    +-------------+.
+ * │ TableMeta   │    │ ColumnMeta  │
+ * │ (instance)  │    │ (prototype) │
+ * +-------------+    +-------------+.
+ *                         │
+ *                         │
+ *                        \│/
+ *                    +-------------+.
+ *                    │  CellMeta   │
+ *                    │ (instance)  │
+ *                    +-------------+.
+ */
 var TableMeta = /*#__PURE__*/function () {
   function TableMeta(globalMeta) {
     _classCallCheck(this, TableMeta);
@@ -60,7 +74,7 @@ var TableMeta = /*#__PURE__*/function () {
     key: "updateMeta",
     value: function updateMeta(settings) {
       extend(this.meta, settings);
-      extend(this.meta, expandMetaType(settings.type, settings));
+      extendByMetaType(this.meta, settings, settings);
     }
   }]);
   return TableMeta;

package/dataMap/metaManager/metaSchema.js

@@ -26,18 +26,27 @@ function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" =
  * - Adjust Handsontable's behavior
  * - Implement your own custom features
  *
+ * ::: only-for javascript
+ *
  * To apply [configuration options](@/guides/getting-started/configuration-options.md), pass them as
  * a second argument of the [Handsontable constructor](@/guides/getting-started/installation.md#initialize-handsontable),
  * using the [object literal notation](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Object_initializer):
  *
- * ::: only-for javascript
+ * Read more on the [Configuration options](@/guides/getting-started/configuration-options.md) page.
+ *
  * ```js
  * const container = document.getElementById('example');
  *
  * const hot = new Handsontable(container, {
  *   // configuration options, in the object literal notation
  *   licenseKey: 'non-commercial-and-evaluation',
- *   data: Handsontable.helper.createSpreadsheetData(5, 10),
+ *   data: [
+ *     ['A1', 'B1', 'C1', 'D1', 'E1'],
+ *     ['A2', 'B2', 'C2', 'D2', 'E2'],
+ *     ['A3', 'B3', 'C3', 'D3', 'E3'],
+ *     ['A4', 'B4', 'C4', 'D4', 'E4'],
+ *     ['A5', 'B5', 'C5', 'D5', 'E5'],
+ *   ],
  *   width: 400,
  *   height: 300,
  *   colHeaders: true,
@@ -52,11 +61,24 @@ function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" =
  * :::
  *
  * ::: only-for react
+ *
+ * To apply configuration options, pass them as individual props
+ * of the [`HotTable`](@/guides/getting-started/installation.md#use-the-hottable-component)
+ * or [`HotColumn`](@/guides/columns/react-hot-column.md) components.
+ *
+ * Read more on the [Configuration options](@/guides/getting-started/configuration-options.md) page.
+ *
  * ```jsx
  * <HotTable
  *   // configuration options, in the object literal notation
  *   licenseKey='non-commercial-and-evaluation'
- *   data={Handsontable.helper.createSpreadsheetData(5, 10)}
+ *   data={[
+ *     ['A1', 'B1', 'C1', 'D1', 'E1'],
+ *     ['A2', 'B2', 'C2', 'D2', 'E2'],
+ *     ['A3', 'B3', 'C3', 'D3', 'E3'],
+ *     ['A4', 'B4', 'C4', 'D4', 'E4'],
+ *     ['A5', 'B5', 'C5', 'D5', 'E5'],
+ *   ]}
  *   width={400}
  *   height={300}
  *   colHeaders={true}
@@ -71,10 +93,10 @@ function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" =
  * :::
  *
  * Depending on your needs, you can apply [configuration options](@/api/options.md) to different elements of your grid:
- * - [The entire grid](@/guides/getting-started/configuration-options.md#setting-grid-options)
- * - [Individual columns](@/guides/getting-started/configuration-options.md#setting-column-options)
- * - [Individual rows](@/guides/getting-started/configuration-options.md#setting-row-options)
- * - [Individual cells](@/guides/getting-started/configuration-options.md#setting-cell-options)
+ * - [The entire grid](@/guides/getting-started/configuration-options.md#set-grid-options)
+ * - [Individual columns](@/guides/getting-started/configuration-options.md#set-column-options)
+ * - [Individual rows](@/guides/getting-started/configuration-options.md#set-row-options)
+ * - [Individual cells](@/guides/getting-started/configuration-options.md#set-cell-options)
  * - [Individual grid elements, based on any logic you implement](@/guides/getting-started/configuration-options.md#implementing-custom-logic)
  *
  * Read more:
@@ -87,20 +109,13 @@ var _default = function _default() {
     /**
      * Information on which of the meta properties were added automatically.
      * For example: setting the `renderer` property directly won't extend the `_automaticallyAssignedMetaProps`
-     * entry, but setting a `type` will modify it to:
-     * ```
-     * _automaticallyAssignedMetaProps: {
-     *   renderer: true,
-     *   editor: true,
-     *   validator: true
-     * }
-     * ```
+     * entry, but setting a `type` will modify it to `Set(3) {'renderer', 'editor', 'validator', ...}`.
      *
      * @private
-     * @type {object}
-     * @default {}
+     * @type {Set}
+     * @default undefined
      */
-    _automaticallyAssignedMetaProps: {},
+    _automaticallyAssignedMetaProps: void 0,
     /**
      * The `activeHeaderClassName` option lets you add a CSS class name
      * to every currently-active, currently-selected header (when a whole column or row is selected).
@@ -402,14 +417,16 @@ var _default = function _default() {
      */
     autoRowSize: void 0,
     /**
-     * The `autoWrapCol` option determines what happens to current cell selection when you navigate to the grid's top or bottom edge.
+     * With [`autoWrapCol`](#autowrapcol) enabled:
+     * - When you select a bottom-most cell, pressing <kbd>**↓**</kbd> takes you to the top-most cell of the next column.
+     * - When you select a top-most cell, pressing <kbd>**↑**</kbd> takes you to the bottom-most cell of the previous column.
      *
-     * You can set the `autoWrapCol` option to one of the following:
+     * You can set the [`autoWrapCol`](#autowrapcol) option to one of the following:
      *
-     * | Setting           | Description                                                                                                             |
-     * | ----------------- | ----------------------------------------------------------------------------------------------------------------------- |
-     * | `true`            | On reaching the grid's top or bottom edge<br>- Jump to the opposite edge<br>- Select a cell in the previous/next column |
-     * | `false` (default) | On reaching the grid's top or bottom edge, stop                                                                         |
+     * | Setting           | Description                                                                                                                                                                                                                                  |
+     * | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+     * | `true`            | When you select a bottom-most cell, pressing <kbd>**↓**</kbd> takes you to the top-most cell of the next column.<br><br>When you select a top-most cell, pressing <kbd>**↑**</kbd> takes you to the bottom-most cell of the previous column. |
+     * | `false` (default) | When you select a bottom-most cell, pressing <kbd>**↓**</kbd> doesn't do anything.<br><br>When you select a top-most cell, pressing <kbd>**↑**</kbd> doesn't do anything.                                                                    |
      *
      * @memberof Options#
      * @type {boolean}
@@ -418,20 +435,29 @@ var _default = function _default() {
      *
      * @example
      * ```js
-     * // on reaching the grid's top or bottom edge, jump to the opposite edge
+     * // when you select a bottom-most cell, pressing ⬇ doesn't do anything
+     * // when you select a top-most cell, pressing ⬆ doesn't do anything
+     * autoWrapCol: false, // default setting
+     *
+     * // when you select a bottom-most cell, pressing ⬇ takes you to the top-most cell of the next column
+     * // when you select a top-most cell, pressing ⬆ takes you to the bottom-most cell of the previous column
      * autoWrapCol: true,
      * ```
      */
     autoWrapCol: false,
     /**
-     * The `autoWrapRow` option determines what happens to current cell selection when you navigate to the grid's left or right edge.
+     * With [`autoWrapRow`](#autoWrapRow) enabled:
+     * - When you select the first cell of a row, pressing <kbd>**←**</kbd>* takes you to the last cell of the row above.
+     * - When you select the last cell of a row, pressing <kbd>**→**</kbd>* takes you to the first cell of the row below.
      *
-     * You can set the `autoWrapRow` option to one of the following:
+     * You can set the [`autoWrapRow`](#autoWrapRow) option to one of the following:
      *
-     * | Setting           | Description                                                                                                                  |
-     * | ----------------- | ---------------------------------------------------------------------------------------------------------------------------- |
-     * | `true`            | On reaching the grid's left or right edge:<br>- Jump to the grid's opposite edge<br>- Select a cell in the previous/next row |
-     * | `false` (default) | On reaching the grid's left or right edge, stop                                                                              |
+     * | Setting           | Description                                                                                                                                                                                                                              |
+     * | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+     * | `true`            | When you select the first cell of a row, pressing <kbd>**←**</kbd>* takes you to the last cell of the row above.<br><br>When you select the last cell of a row, pressing <kbd>**→**</kbd>* takes you to the first cell of the row below. |
+     * | `false` (default) | When you select the first cell of a row, pressing <kbd>**←**</kbd>* doesn't do anything.<br><br>When you select the last cell of a row, pressing <kbd>**→**</kbd>* doesn't do anything.                                                  |
+     *
+     * \* The exact key depends on your [`layoutDirection`](#layoutdirection) configuration.
      *
      * @memberof Options#
      * @type {boolean}
@@ -440,7 +466,12 @@ var _default = function _default() {
      *
      * @example
      * ```js
-     * // on reaching the grid's left or right edge, jump to the opposite edge
+     * // when you select the first cell of a row, pressing ⬅ doesn't do anything
+     * // when you select the last cell of a row, pressing ➡️ doesn't do anything
+     * autoWrapRow: false, // default setting
+     *
+     * // when you select the first cell of a row, pressing ⬅ takes you to the last cell of the row above
+     * // when you select the last cell of a row, pressing ➡️ takes you to the first cell of the row below
      * autoWrapRow: true,
      * ```
      */
@@ -474,11 +505,11 @@ var _default = function _default() {
     /**
      * The `cell` option lets you apply [configuration options](@/guides/getting-started/configuration-options.md) to individual cells.
      *
-     * The `cell` option overwrites the [top-level grid options](@/guides/getting-started/configuration-options.md#setting-grid-options),
+     * The `cell` option overwrites the [top-level grid options](@/guides/getting-started/configuration-options.md#set-grid-options),
      * and the [`columns`](#columns) options.
      *
      * Read more:
-     * - [Configuration options: Setting cell options](@/guides/getting-started/configuration-options.md#setting-cell-options)
+     * - [Configuration options: Setting cell options](@/guides/getting-started/configuration-options.md#set-cell-options)
      * - [`columns`](#columns)
      *
      * @memberof Options#
@@ -515,8 +546,8 @@ var _default = function _default() {
      * | `prop`    | No       | String \| Number | If [`data`](#data) is set to an [array of arrays](@/guides/getting-started/binding-to-data.md#array-of-arrays), `prop` is the same number as `column`.<br><br>If [`data`](#data) is set to an [array of objects](@/guides/getting-started/binding-to-data.md#array-of-objects), `prop` is a property name for the column's data object. |
      *
      * Read more:
-     * - [Configuration options: Implementing custom logic](@/guides/getting-started/configuration-options.md#implementing-custom-logic)
-     * - [Configuration options: Setting row options](@/guides/getting-started/configuration-options.md#setting-row-options)
+     * - [Configuration options: Implementing custom logic](@/guides/getting-started/configuration-options.md#implement-custom-logic)
+     * - [Configuration options: Setting row options](@/guides/getting-started/configuration-options.md#set-row-options)
      * - [`columns`](#columns)
      * - [`cell`](#cell)
      *
@@ -733,12 +764,12 @@ var _default = function _default() {
      * - An array of objects (each object represents one column)
      * - A function that returns an array of objects
      *
-     * The `columns` option overwrites the [top-level grid options](@/guides/getting-started/configuration-options.md#setting-grid-options).
+     * The `columns` option overwrites the [top-level grid options](@/guides/getting-started/configuration-options.md#set-grid-options).
      *
      * When you use `columns`, the [`startCols`](#startCols), [`minCols`](#minCols), and [`maxCols`](#maxCols) options are ignored.
      *
      * Read more:
-     * - [Configuration options: Setting column options](@/guides/getting-started/configuration-options.md#setting-column-options)
+     * - [Configuration options: Setting column options](@/guides/getting-started/configuration-options.md#set-column-options)
      * - [`startCols`](#startCols)
      * - [`minCols`](#minCols)
      * - [`maxCols`](#maxCols)
@@ -871,12 +902,12 @@ var _default = function _default() {
      * | `type`                   | `'sum'` \| `'min'` \| `'max'` \| `'count'` \| `'average'` \| `'custom'` | [Summary function](@/guides/columns/column-summary.md#step-3-calculate-your-summary)                                         |
      * | `destinationRow`         | A number                                                                | [Destination cell's row coordinate](@/guides/columns/column-summary.md#step-4-provide-the-destination-cell-s-coordinates)    |
      * | `destinationColumn`      | A number                                                                | [Destination cell's column coordinate](@/guides/columns/column-summary.md#step-4-provide-the-destination-cell-s-coordinates) |
-     * | `forceNumeric`           | `true`  \| `false`                                                      | [Treat non-numerics as numerics](@/guides/columns/column-summary.md#forcing-numeric-values)                                  |
+     * | `forceNumeric`           | `true`  \| `false`                                                      | [Treat non-numerics as numerics](@/guides/columns/column-summary.md#force-numeric-values)                                  |
      * | `reversedRowCoords`      | `true`  \| `false`                                                      | [Reverse row coordinates](@/guides/columns/column-summary.md#step-5-make-room-for-the-destination-cell)                      |
-     * | `suppressDataTypeErrors` | `true`  \| `false`                                                      | [Suppress data type errors](@/guides/columns/column-summary.md#throwing-data-type-errors)                                    |
+     * | `suppressDataTypeErrors` | `true`  \| `false`                                                      | [Suppress data type errors](@/guides/columns/column-summary.md#throw-data-type-errors)                                    |
      * | `readOnly`               | `true`  \| `false`                                                      | Make summary cell read-only                                                                                                  |
-     * | `roundFloat`             | `true`  \| `false`                                                      | [Round summary result](@/guides/columns/column-summary.md#rounding-a-column-summary-result)                                  |
-     * | `customFunction`         | A function                                                              | [Custom summary function](@/guides/columns/column-summary.md#implementing-a-custom-summary-function)                         |
+     * | `roundFloat`             | `true`  \| `false`                                                      | [Round summary result](@/guides/columns/column-summary.md#round-a-column-summary-result)                                  |
+     * | `customFunction`         | A function                                                              | [Custom summary function](@/guides/columns/column-summary.md#implement-a-custom-summary-function)                         |
      *
      * Read more:
      * - [Column summary](@/guides/columns/column-summary.md)
@@ -1054,13 +1085,13 @@ var _default = function _default() {
      * | `false`   | Disable the [`ContextMenu`](@/api/contextMenu.md) plugin                                                                                                                                                |
      * | `true`    | - Enable the [`ContextMenu`](@/api/contextMenu.md) plugin<br>- Use the [default context menu options](@/guides/accessories-and-menus/context-menu.md#context-menu-with-default-options)                 |
      * | An array  | - Enable the [`ContextMenu`](@/api/contextMenu.md) plugin<br>- Modify [individual context menu options](@/guides/accessories-and-menus/context-menu.md#context-menu-with-specific-options)              |
-     * | An object | - Enable the [`ContextMenu`](@/api/contextMenu.md) plugin<br>- Apply a [custom context menu configuration](@/guides/accessories-and-menus/context-menu.md#context-menu-with-fully-custom-configuration) |
+     * | An object | - Enable the [`ContextMenu`](@/api/contextMenu.md) plugin<br>- Apply a [custom context menu configuration](@/guides/accessories-and-menus/context-menu.md#context-menu-with-a-fully-custom-configuration) |
      *
      * Read more:
      * - [Context menu](@/guides/accessories-and-menus/context-menu.md)
      * - [Context menu: Context menu with default options](@/guides/accessories-and-menus/context-menu.md#context-menu-with-default-options)
      * - [Context menu: Context menu with specific options](@/guides/accessories-and-menus/context-menu.md#context-menu-with-specific-options)
-     * - [Context menu: Context menu with fully custom configuration options](@/guides/accessories-and-menus/context-menu.md#context-menu-with-fully-custom-configuration)
+     * - [Context menu: Context menu with fully custom configuration options](@/guides/accessories-and-menus/context-menu.md#context-menu-with-a-fully-custom-configuration)
      * - [Plugins: `ContextMenu`](@/api/contextMenu.md)
      *
      * @memberof Options#
@@ -1166,17 +1197,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}
@@ -1185,19 +1222,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,
      * },
      * ```
@@ -2406,7 +2457,8 @@ var _default = function _default() {
      *    ...
      * },
      * ```
-     */isEmptyCol: function isEmptyCol(col) {
+     */
+    isEmptyCol: function isEmptyCol(col) {
       var row;
       var rowLen;
       var value;
@@ -2438,7 +2490,8 @@ var _default = function _default() {
      *    ...
      * },
      * ```
-     */isEmptyRow: function isEmptyRow(row) {
+     */
+    isEmptyRow: function isEmptyRow(row) {
       var col;
       var colLen;
       var value;
@@ -2535,7 +2588,7 @@ var _default = function _default() {
      *
      * You can set the layout direction only at Handsontable's [initialization](@/guides/getting-started/installation.md#initialize-handsontable). Any change of the `layoutDirection` option after the initialization (e.g. using the [`updateSettings()`](@/api/core.md#updatesettings) method) is ignored.
      *
-     * You can set the `layoutDirection` option only [for the entire grid](@/guides/getting-started/configuration-options.md#setting-grid-options).
+     * You can set the `layoutDirection` option only [for the entire grid](@/guides/getting-started/configuration-options.md#set-grid-options).
      * You can't set it for individual columns, rows, or cells.
      *
      * You can set the `layoutDirection` option to one of the following strings:
@@ -2607,8 +2660,8 @@ var _default = function _default() {
      * The `locale` option configures Handsontable's [locale](@/guides/internationalization/locale.md) settings.
      *
      * You can set the `locale` option to any valid and canonicalized Unicode BCP 47 locale tag,
-     * both for the [entire grid](@/guides/internationalization/locale.md#setting-the-grid-s-locale),
-     * and for [individual columns](@/guides/internationalization/locale.md#setting-a-column-s-locale).
+     * both for the [entire grid](@/guides/internationalization/locale.md#set-the-grid-s-locale),
+     * and for [individual columns](@/guides/internationalization/locale.md#set-a-column-s-locale).
      *
      * Read more:
      * - [Locale](@/guides/internationalization/locale.md)
@@ -3261,7 +3314,7 @@ var _default = function _default() {
      * | `true`            | Enable the [`PersistentState`](@/api/persistentState.md) plugin  |
      *
      * Read more:
-     * - [Saving data: Saving data locally](@/guides/getting-started/saving-data.md#saving-data-locally)
+     * - [Saving data: Saving data locally](@/guides/getting-started/saving-data.md#save-data-locally)
      * - [Plugins: `PersistentState`](@/api/persistentState.md)
      *
      * @memberof Options#
@@ -3597,7 +3650,7 @@ var _default = function _default() {
     /**
      * The `rowHeights` option sets rows' heights, in pixels.
      *
-     * In the rendering process, the default row height is 23px.
+     * In the rendering process, the default row height is 23 px (22 px + 1 px of the row's bottom border).
      * You can change it to equal or greater than 23px, by setting the `rowHeights` option to one of the following:
      *
      * | Setting     | Description                                                                                         | Example                                                      |
@@ -3704,7 +3757,7 @@ var _default = function _default() {
      * | `'multiple'` | Allow the user to select multiple ranges of cells at a time. |
      *
      * Read more:
-     * - [Selection: Selecting ranges](@/guides/cell-features/selection.md#selecting-ranges)
+     * - [Selection: Selecting ranges](@/guides/cell-features/selection.md#select-ranges)
      *
      * @memberof Options#
      * @type {string}
@@ -3795,7 +3848,7 @@ var _default = function _default() {
      * | `true`            | - Disable pasting data into this column<br>- On pasting, paste data into the next column to the right |
      *
      * Read more:
-     * - [Configuration options: Setting column options](@/guides/getting-started/configuration-options.md#setting-column-options)
+     * - [Configuration options: Setting column options](@/guides/getting-started/configuration-options.md#set-column-options)
      *
      * @memberof Options#
      * @type {boolean}
@@ -3828,7 +3881,7 @@ var _default = function _default() {
      * | `true`            | - Disable pasting data into this row<br>- On pasting, paste data into the row below |
      *
      * Read more:
-     * - [Configuration options: Setting row options](@/guides/getting-started/configuration-options.md#setting-row-options)
+     * - [Configuration options: Setting row options](@/guides/getting-started/configuration-options.md#set-row-options)
      *
      * @memberof Options#
      * @type {boolean}