handsontable 12.1.3 → 12.2.0

package/dataMap/metaManager/metaSchema.mjs

@@ -5,19 +5,16 @@ 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); }
-
 import { isEmpty } from "../../helpers/mixed.mjs";
 import { isObjectEqual } from "../../helpers/object.mjs";
 /* eslint-disable jsdoc/require-description-complete-sentence */
-
 /**
  * @alias Options
  * @class Options
  * @description
  *
- * [Configuration options](@/guides/getting-started/setting-options.md) let you heavily customize your Handsontable instance. For example, you can:
+ * [Configuration options](@/guides/getting-started/configuration-options.md) let you heavily customize your Handsontable instance. For example, you can:
  *
  * - Enable and disable built-in features
  * - Enable and configure additional [plugins](@/guides/tools-and-building/custom-plugins.md)
@@ -25,10 +22,11 @@ import { isObjectEqual } from "../../helpers/object.mjs";
  * - Adjust Handsontable's behavior
  * - Implement your own custom features
  *
- * To apply [configuration options](@/guides/getting-started/setting-options.md), pass them as
+ * 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
  * ```js
  * const container = document.getElementById('example');
  *
@@ -47,22 +45,58 @@ import { isObjectEqual } from "../../helpers/object.mjs";
  *   manualRowMove: true,
  * });
  * ```
+ * :::
+ *
+ * ::: only-for react
+ * ```jsx
+ * <HotTable
+ *   // configuration options, in the object literal notation
+ *   licenseKey='non-commercial-and-evaluation'
+ *   data={Handsontable.helper.createSpreadsheetData(5, 10)}
+ *   width={400}
+ *   height={300}
+ *   colHeaders={true}
+ *   rowHeaders={true}
+ *   customBorders={true}
+ *   dropdownMenu={true}
+ *   multiColumnSorting={true}
+ *   filters={true}
+ *   manualRowMove={true}
+ * />
+ * ```
+ * :::
  *
  * Depending on your needs, you can apply [configuration options](@/api/options.md) to different elements of your grid:
- * - [The entire grid](@/guides/getting-started/setting-options.md#setting-grid-options)
- * - [Individual columns](@/guides/getting-started/setting-options.md#setting-column-options)
- * - [Individual rows](@/guides/getting-started/setting-options.md#setting-row-options)
- * - [Individual cells](@/guides/getting-started/setting-options.md#setting-cell-options)
- * - [Individual grid elements, based on any logic you implement](@/guides/getting-started/setting-options.md#implementing-custom-logic)
+ * - [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)
+ * - [Individual grid elements, based on any logic you implement](@/guides/getting-started/configuration-options.md#implementing-custom-logic)
  *
  * Read more:
- * - [Configuration options](@/guides/getting-started/setting-options.md)
+ * - [Configuration options](@/guides/getting-started/configuration-options.md)
  */
-
 export default (function () {
   return {
     /* eslint-disable jsdoc/require-description-complete-sentence */
 
+    /**
+     * 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
+     * }
+     * ```
+     *
+     * @private
+     * @type {object}
+     * @default {}
+     */
+    _automaticallyAssignedMetaProps: {},
     /**
      * 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).
@@ -92,7 +126,6 @@ export default (function () {
      * ```
      */
     activeHeaderClassName: 'ht__active_highlight',
-
     /**
      * The `allowEmpty` option determines whether Handsontable accepts the following values:
      * - `null`
@@ -132,7 +165,6 @@ export default (function () {
      * ```
      */
     allowEmpty: true,
-
     /**
      * The `allowHtml` option configures whether [`autocomplete`](@/guides/cell-types/autocomplete-cell-type.md)
      * and [`dropdown`](@/guides/cell-types/dropdown-cell-type.md) cells' [`source`](#source) data
@@ -172,7 +204,6 @@ export default (function () {
      * ```
      */
     allowHtml: false,
-
     /**
      * If set to `true`, the `allowInsertColumn` option adds the following menu items to the [context menu](@/guides/accessories-and-menus/context-menu.md):
      * - **Insert column left**
@@ -190,7 +221,6 @@ export default (function () {
      * ```
      */
     allowInsertColumn: true,
-
     /**
      * If set to `true`, the `allowInsertRow` option adds the following menu items to the [context menu](@/guides/accessories-and-menus/context-menu.md):
      * - **Insert row above**
@@ -208,7 +238,6 @@ export default (function () {
      * ```
      */
     allowInsertRow: true,
-
     /**
      * The `allowInvalid` option determines whether Handsontable accepts values
      * that were marked as `invalid` by the [cell validator](@/guides/cell-functions/cell-validator.md).
@@ -241,7 +270,6 @@ export default (function () {
      * ```
      */
     allowInvalid: true,
-
     /**
      * If set to `true`, the `allowRemoveColumn` option adds the following menu items to the [context menu](@/guides/accessories-and-menus/context-menu.md):
      * - **Remove column**
@@ -261,7 +289,6 @@ export default (function () {
      * ```
      */
     allowRemoveColumn: true,
-
     /**
      * If set to `true`, the `allowRemoveRow` option adds the following menu items to the [context menu](@/guides/accessories-and-menus/context-menu.md):
      * - **Remove row**
@@ -281,7 +308,6 @@ export default (function () {
      * ```
      */
     allowRemoveRow: true,
-
     /**
      * The `autoColumnSize` option configures the [`AutoColumnSize`](@/api/autoColumnSize.md) plugin.
      *
@@ -332,7 +358,6 @@ export default (function () {
      * ```
      */
     autoColumnSize: void 0,
-
     /**
      * The `autoRowSize` option configures the [`AutoRowSize`](@/api/autoRowSize.md) plugin.
      *
@@ -372,7 +397,6 @@ export default (function () {
      * ```
      */
     autoRowSize: void 0,
-
     /**
      * The `autoWrapCol` option determines what happens to current cell selection when you navigate to the grid's top or bottom edge.
      *
@@ -395,7 +419,6 @@ export default (function () {
      * ```
      */
     autoWrapCol: false,
-
     /**
      * The `autoWrapRow` option determines what happens to current cell selection when you navigate to the grid's left or right edge.
      *
@@ -418,7 +441,6 @@ export default (function () {
      * ```
      */
     autoWrapRow: false,
-
     /**
      * @description
      * The `bindRowsWithHeaders` option configures the [`BindRowsWithHeaders`](@/api/bindRowsWithHeaders.md) plugin.
@@ -445,15 +467,14 @@ export default (function () {
      * ```
      */
     bindRowsWithHeaders: void 0,
-
     /**
-     * The `cell` option lets you apply [configuration options](@/guides/getting-started/setting-options.md) to individual cells.
+     * 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/setting-options.md#setting-grid-options),
+     * The `cell` option overwrites the [top-level grid options](@/guides/getting-started/configuration-options.md#setting-grid-options),
      * and the [`columns`](#columns) options.
      *
      * Read more:
-     * - [Configuration options: Setting cell options](@/guides/getting-started/setting-options.md#setting-cell-options)
+     * - [Configuration options: Setting cell options](@/guides/getting-started/configuration-options.md#setting-cell-options)
      * - [`columns`](#columns)
      *
      * @memberof Options#
@@ -475,10 +496,9 @@ export default (function () {
      * ```
      */
     cell: [],
-
     /**
      * @description
-     * The `cells` option lets you apply any other [configuration options](@/guides/getting-started/setting-options.md) to
+     * The `cells` option lets you apply any other [configuration options](@/guides/getting-started/configuration-options.md) to
      * individual grid elements (columns, rows, cells), based on any logic you implement.
      *
      * The `cells` option overwrites all other options (including options set by [`columns`](#columns) and [`cell`](#cell)).
@@ -491,8 +511,8 @@ export default (function () {
      * | `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/setting-options.md#implementing-custom-logic)
-     * - [Configuration options: Setting row options](@/guides/getting-started/setting-options.md#setting-row-options)
+     * - [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)
      * - [`columns`](#columns)
      * - [`cell`](#cell)
      *
@@ -518,7 +538,6 @@ export default (function () {
      * ```
      */
     cells: void 0,
-
     /**
      * The `checkedTemplate` option lets you configure what value
      * a checked [`checkbox`](@/guides/cell-types/checkbox-cell-type.md) cell has.
@@ -561,7 +580,6 @@ export default (function () {
      * ```
      */
     checkedTemplate: void 0,
-
     /**
      * The `className` option lets you add CSS class names to every currently-selected element.
      *
@@ -572,10 +590,15 @@ export default (function () {
      * | A string            | Add a single CSS class name to every currently-selected element  |
      * | An array of strings | Add multiple CSS class names to every currently-selected element |
      *
-     * To apply different CSS class names on different levels, use Handsontable's [cascading configuration](@/guides/getting-started/setting-options.md#cascading-configuration).
+     * ::: tip
+     * Don't change the `className` metadata of the [column summary](@/guides/columns/column-summary.md) row.
+     * To style the summary row, use the class name assigned automatically by the [`ColumnSummary`](@/api/columnSummary.md) plugin: `columnSummaryResult`.
+     * :::
+     *
+     * To apply different CSS class names on different levels, use Handsontable's [cascading configuration](@/guides/getting-started/configuration-options.md#cascading-configuration).
      *
      * Read more:
-     * - [Configuration options: Cascading configuration](@/guides/getting-started/setting-options.md#cascading-configuration)
+     * - [Configuration options: Cascading configuration](@/guides/getting-started/configuration-options.md#cascading-configuration)
      * - [`currentRowClassName`](#currentRowClassName)
      * - [`currentColClassName`](#currentColClassName)
      * - [`currentHeaderClassName`](#currentHeaderClassName)
@@ -604,7 +627,6 @@ export default (function () {
      * ```
      */
     className: void 0,
-
     /**
      * The `colHeaders` option configures your grid's column headers.
      *
@@ -640,7 +662,6 @@ export default (function () {
      * ```
      */
     colHeaders: null,
-
     /**
      * @description
      * The `collapsibleColumns` option configures the [`CollapsibleColumns`](@/api/collapsibleColumns.md) plugin.
@@ -674,7 +695,6 @@ export default (function () {
      * ```
      */
     collapsibleColumns: void 0,
-
     /**
      * @description
      * The `columnHeaderHeight` option configures the height of column headers.
@@ -701,21 +721,20 @@ export default (function () {
      * ```
      */
     columnHeaderHeight: void 0,
-
     /**
      * @description
-     * The `columns` option lets you apply any other [configuration options](@/guides/getting-started/setting-options.md) to individual columns (or ranges of columns).
+     * The `columns` option lets you apply any other [configuration options](@/guides/getting-started/configuration-options.md) to individual columns (or ranges of columns).
      *
      * You can set the `columns` option to one of the following:
      * - 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/setting-options.md#setting-grid-options).
+     * The `columns` option overwrites the [top-level grid options](@/guides/getting-started/configuration-options.md#setting-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/setting-options.md#setting-column-options)
+     * - [Configuration options: Setting column options](@/guides/getting-started/configuration-options.md#setting-column-options)
      * - [`startCols`](#startCols)
      * - [`minCols`](#minCols)
      * - [`maxCols`](#maxCols)
@@ -755,7 +774,6 @@ export default (function () {
      * ```
      */
     columns: void 0,
-
     /**
      * @description
      * The `columnSorting` option configures the [`ColumnSorting`](@/api/columnSorting.md) plugin.
@@ -835,7 +853,6 @@ export default (function () {
      * ```
      */
     columnSorting: void 0,
-
     /**
      * @description
      * The `columnSummary` option configures the [`ColumnSummary`](@/api/columnSummary.md) plugin.
@@ -890,7 +907,6 @@ export default (function () {
      * ```
      */
     columnSummary: void 0,
-
     /**
      * The `colWidths` option sets columns' widths, in pixels.
      *
@@ -938,7 +954,6 @@ export default (function () {
      * ```
      */
     colWidths: void 0,
-
     /**
      * The `commentedCellClassName` option lets you add a CSS class name to cells
      * that have comments.
@@ -970,7 +985,6 @@ export default (function () {
      * ```
      */
     commentedCellClassName: 'htCommentCell',
-
     /**
      * @description
      * The `comments` option configures the [`Comments`](@/api/comments.md) plugin.
@@ -1025,7 +1039,6 @@ export default (function () {
      * ```
      */
     comments: false,
-
     /**
      * @description
      * The `contextMenu` option configures the [`ContextMenu`](@/api/contextMenu.md) plugin.
@@ -1088,7 +1101,6 @@ export default (function () {
      * ```
      */
     contextMenu: void 0,
-
     /**
      * @description
      * The `copyable` option determines whether a cell's value can be copied to the clipboard or not.
@@ -1102,7 +1114,7 @@ export default (function () {
      *
      * Read more:
      * - [Clipboard](@/guides/cell-features/clipboard.md)
-     * - [Configuration options: Cascading configuration](@/guides/getting-started/setting-options.md#cascading-configuration)
+     * - [Configuration options: Cascading configuration](@/guides/getting-started/configuration-options.md#cascading-configuration)
      * - [Password cell type](@/guides/cell-types/password-cell-type.md)
      *
      * @memberof Options#
@@ -1139,7 +1151,6 @@ export default (function () {
      * ```
      */
     copyable: true,
-
     /**
      * The `copyPaste` option configures the [`CopyPaste`](@/api/copyPaste.md) plugin.
      *
@@ -1188,7 +1199,6 @@ export default (function () {
      * ```
      */
     copyPaste: true,
-
     /**
      * The `correctFormat` option configures whether incorrectly-formatted times and dates are amended or not.
      *
@@ -1236,7 +1246,6 @@ export default (function () {
      * ```
      */
     correctFormat: false,
-
     /**
      * The `currentColClassName` option lets you add a CSS class name
      * to each cell of the currently-visible, currently-selected columns.
@@ -1266,7 +1275,6 @@ export default (function () {
      * ```
      */
     currentColClassName: void 0,
-
     /**
      * The `currentHeaderClassName` option lets you add a CSS class name
      * to every currently-visible, currently-selected header.
@@ -1295,7 +1303,6 @@ export default (function () {
      * ```
      */
     currentHeaderClassName: 'ht__highlight',
-
     /**
      * The `currentRowClassName` option lets you add a CSS class name
      * to each cell of the currently-visible, currently-selected rows.
@@ -1325,7 +1332,6 @@ export default (function () {
      * ```
      */
     currentRowClassName: void 0,
-
     /**
      * @description
      * The `customBorders` option configures the [`CustomBorders`](@/api/customBorders.md) plugin.
@@ -1438,7 +1444,6 @@ export default (function () {
      * ```
      */
     customBorders: false,
-
     /**
      * @description
      * The `data` option sets the initial [data](@/guides/getting-started/binding-to-data.md) of your Handsontable instance.
@@ -1482,7 +1487,6 @@ export default (function () {
      * ```
      */
     data: void 0,
-
     /**
      * @description
      * When the [`data`](#data) option is set to an [array of objects](@/guides/getting-started/binding-to-data.md#array-of-objects)
@@ -1521,7 +1525,6 @@ export default (function () {
      * ```
      */
     dataSchema: void 0,
-
     /**
      * The `dateFormat` option configures the date format accepted by [`date`](@/guides/cell-types/date-cell-type.md) cells.
      *
@@ -1552,7 +1555,6 @@ export default (function () {
      * ```
      */
     dateFormat: 'DD/MM/YYYY',
-
     /**
      * The `datePickerConfig` option configures the `date` [cell editor](@/guides/cell-functions/cell-editor.md)'s date picker, which uses an external dependency: [Pikaday](https://github.com/Pikaday/Pikaday/tree/1.8.2).
      *
@@ -1582,7 +1584,6 @@ export default (function () {
      * @category Core
      */
     datePickerConfig: void 0,
-
     /**
      * The `defaultDate` option configures the date displayed
      * in empty [`date`](@/guides/cell-types/date-cell-type.md) cells.
@@ -1611,7 +1612,6 @@ export default (function () {
      * ```
      */
     defaultDate: void 0,
-
     /**
      * @description
      * The `disableVisualSelection` option configures how
@@ -1655,7 +1655,6 @@ export default (function () {
      * ```
      */
     disableVisualSelection: false,
-
     /**
      * @description
      * The `dragToScroll` option configures the [`DragToScroll`](@/api/dragToScroll.md) plugin.
@@ -1682,7 +1681,6 @@ export default (function () {
      * ```
      */
     dragToScroll: true,
-
     /**
      * The `dropdownMenu` option configures the [`DropdownMenu`](@/api/dropdownMenu.md) plugin.
      *
@@ -1741,7 +1739,6 @@ export default (function () {
      * ```
      */
     dropdownMenu: void 0,
-
     /**
      * The `editor` option sets a [cell editor](@/guides/cell-functions/cell-editor.md) for a cell.
      *
@@ -1773,7 +1770,7 @@ export default (function () {
      * Read more:
      * - [Cell editor](@/guides/cell-functions/cell-editor.md)
      * - [Cell type](@/guides/cell-types/cell-type.md)
-     * - [Configuration options: Cascading configuration](@/guides/getting-started/setting-options.md#cascading-configuration)
+     * - [Configuration options: Cascading configuration](@/guides/getting-started/configuration-options.md#cascading-configuration)
      * - [`type`](#type)
      *
      * @memberof Options#
@@ -1800,7 +1797,6 @@ export default (function () {
      * ```
      */
     editor: void 0,
-
     /**
      * The `enterBeginsEditing` option configures the action of the <kbd>**Enter**</kbd> key.
      *
@@ -1830,7 +1826,6 @@ export default (function () {
      * ```
      */
     enterBeginsEditing: true,
-
     /**
      * The `enterMoves` option configures the action of the <kbd>**Enter**</kbd> key.
      *
@@ -1874,7 +1869,6 @@ export default (function () {
       col: 0,
       row: 1
     },
-
     /**
      * The `fillHandle` option configures the [Autofill](@/api/autofill.md) plugin.
      *
@@ -1934,7 +1928,6 @@ export default (function () {
     fillHandle: {
       autoInsertRow: false
     },
-
     /**
      * The `filter` option configures whether [`autocomplete`](@/guides/cell-types/autocomplete-cell-type.md) cells'
      * lists are updated by the end user's input.
@@ -1971,7 +1964,6 @@ export default (function () {
      * ```
      */
     filter: true,
-
     /**
      * The `filteringCaseSensitive` option configures whether [`autocomplete`](@/guides/cell-types/autocomplete-cell-type.md) cells'
      * input is case-sensitive.
@@ -2006,7 +1998,6 @@ export default (function () {
      * ```
      */
     filteringCaseSensitive: false,
-
     /**
      * The `filters` option configures the [`Filters`](@/api/filters.md) plugin.
      *
@@ -2034,7 +2025,6 @@ export default (function () {
      * ```
      */
     filters: void 0,
-
     /**
      * `fixedColumnsLeft` is a legacy option.
      *
@@ -2059,7 +2049,6 @@ export default (function () {
      * ```
      */
     fixedColumnsLeft: 0,
-
     /**
      * If your grid's [layout direction](@/guides/internationalization/layout-direction.md) is LTR (default), the `fixedColumnsStart` option sets the number of [frozen columns](@/guides/columns/column-freezing.md) at the left-hand edge of the grid.
      *
@@ -2098,7 +2087,6 @@ export default (function () {
      * ```
      */
     fixedColumnsStart: 0,
-
     /**
      * The `fixedRowsBottom` option sets the number of [frozen rows](@/guides/rows/row-freezing.md)
      * at the bottom of the grid.
@@ -2118,7 +2106,6 @@ export default (function () {
      * ```
      */
     fixedRowsBottom: 0,
-
     /**
      * The `fixedRowsTop` option sets the number of [frozen rows](@/guides/rows/row-freezing.md) at the top of the grid.
      *
@@ -2137,7 +2124,6 @@ export default (function () {
      * ```
      */
     fixedRowsTop: 0,
-
     /**
      * The `formulas` option configures the [`Formulas`](@/api/formulas.md) plugin.
      *
@@ -2217,7 +2203,6 @@ export default (function () {
      * ```
      */
     formulas: void 0,
-
     /**
      * The `fragmentSelection` option configures text selection settings.
      *
@@ -2244,7 +2229,6 @@ export default (function () {
      * ```
      */
     fragmentSelection: false,
-
     /**
      * The `height` option configures the height of your grid.
      *
@@ -2279,7 +2263,6 @@ export default (function () {
      * ```
      */
     height: void 0,
-
     /**
      * The `hiddenColumns` option configures the [`HiddenColumns`](@/api/hiddenColumns.md) plugin.
      *
@@ -2325,7 +2308,6 @@ export default (function () {
      * ```
      */
     hiddenColumns: void 0,
-
     /**
      * The `hiddenRows` option configures the [`HiddenRows`](@/api/hiddenRows.md) plugin.
      *
@@ -2371,7 +2353,6 @@ export default (function () {
      * ```
      */
     hiddenRows: void 0,
-
     /**
      * The `invalidCellClassName` option lets you add a CSS class name to cells
      * that were marked as `invalid` by the [cell validator](@/guides/cell-functions/cell-validator.md).
@@ -2401,7 +2382,6 @@ export default (function () {
      * ```
      */
     invalidCellClassName: 'htInvalid',
-
     /**
      * The `isEmptyCol` option lets you define your own custom method
      * for checking if a column at a given visual index is empty.
@@ -2422,23 +2402,18 @@ export default (function () {
      *    ...
      * },
      * ```
-     */
-    isEmptyCol: function isEmptyCol(col) {
+     */isEmptyCol: function isEmptyCol(col) {
       var row;
       var rowLen;
       var value;
-
       for (row = 0, rowLen = this.countRows(); row < rowLen; row++) {
         value = this.getDataAtCell(row, col);
-
         if (isEmpty(value) === false) {
           return false;
         }
       }
-
       return true;
     },
-
     /**
      * The `isEmptyRow` option lets you define your own custom method
      * for checking if a row at a given visual index is empty.
@@ -2459,29 +2434,23 @@ export default (function () {
      *    ...
      * },
      * ```
-     */
-    isEmptyRow: function isEmptyRow(row) {
+     */isEmptyRow: function isEmptyRow(row) {
       var col;
       var colLen;
       var value;
       var meta;
-
       for (col = 0, colLen = this.countCols(); col < colLen; col++) {
         value = this.getDataAtCell(row, col);
-
         if (isEmpty(value) === false) {
           if (_typeof(value) === 'object') {
             meta = this.getCellMeta(row, col);
             return isObjectEqual(this.getSchema()[meta.prop], value);
           }
-
           return false;
         }
       }
-
       return true;
     },
-
     /**
      * @description
      * The `label` option configures [`checkbox`](@/guides/cell-types/checkbox-cell-type.md) cells` labels.
@@ -2513,7 +2482,6 @@ export default (function () {
      * ```
      */
     label: void 0,
-
     /**
      * The `language` option configures Handsontable's [language](@/guides/internationalization/language.md) settings.
      *
@@ -2558,13 +2526,12 @@ export default (function () {
      * ```
      */
     language: 'en-US',
-
     /**
      * The `layoutDirection` option configures whether Handsontable renders from the left to the right, or from the right to the left.
      *
      * 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/setting-options.md#setting-grid-options).
+     * You can set the `layoutDirection` option only [for the entire grid](@/guides/getting-started/configuration-options.md#setting-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:
@@ -2604,7 +2571,6 @@ export default (function () {
      * ```
      */
     layoutDirection: 'inherit',
-
     /**
      * The `licenseKey` option sets your Handsontable license key.
      *
@@ -2633,7 +2599,6 @@ export default (function () {
      * ```
      */
     licenseKey: void 0,
-
     /**
      * The `locale` option configures Handsontable's [locale](@/guides/internationalization/locale.md) settings.
      *
@@ -2670,7 +2635,6 @@ export default (function () {
      * ```
      */
     locale: 'en-US',
-
     /**
      * The `manualColumnFreeze` option configures the [`ManualColumnFreeze`](@/api/manualColumnFreeze.md) plugin.
      *
@@ -2696,7 +2660,6 @@ export default (function () {
      * ```
      */
     manualColumnFreeze: void 0,
-
     /**
      * The `manualColumnMove` option configures the [`ManualColumnMove`](@/api/manualColumnMove.md) plugin.
      *
@@ -2729,7 +2692,6 @@ export default (function () {
      * ```
      */
     manualColumnMove: void 0,
-
     /**
      * @description
      * The `manualColumnResize` option configures the [`ManualColumnResize`](@/api/manualColumnResize.md) plugin.
@@ -2763,7 +2725,6 @@ export default (function () {
      * ```
      */
     manualColumnResize: void 0,
-
     /**
      * @description
      * The `manualRowMove` option configures the [`ManualRowMove`](@/api/manualRowMove.md) plugin.
@@ -2797,7 +2758,6 @@ export default (function () {
      * ```
      */
     manualRowMove: void 0,
-
     /**
      * @description
      * The `manualRowResize` option configures the [`ManualRowResize`](@/api/manualRowResize.md) plugin.
@@ -2831,7 +2791,6 @@ export default (function () {
      * ```
      */
     manualRowResize: void 0,
-
     /**
      * The `maxCols` option sets a maximum number of columns.
      *
@@ -2852,7 +2811,6 @@ export default (function () {
      * ```
      */
     maxCols: Infinity,
-
     /**
      * The `maxRows` option sets a maximum number of rows.
      *
@@ -2873,7 +2831,6 @@ export default (function () {
      * ```
      */
     maxRows: Infinity,
-
     /**
      * @description
      * The `mergeCells` option configures the [`MergeCells`](@/api/mergeCells.md) plugin.
@@ -2922,7 +2879,6 @@ export default (function () {
      * ```
      */
     mergeCells: false,
-
     /**
      * The `minCols` option sets a minimum number of columns.
      *
@@ -2950,7 +2906,6 @@ export default (function () {
      * ```
      */
     minCols: 0,
-
     /**
      * The `minRows` option sets a minimum number of rows.
      *
@@ -2971,7 +2926,6 @@ export default (function () {
      * ```
      */
     minRows: 0,
-
     /**
      * The `minSpareCols` option sets a minimum number of empty columns
      * at the grid's right-hand end.
@@ -3000,7 +2954,6 @@ export default (function () {
      * ```
      */
     minSpareCols: 0,
-
     /**
      * The `minSpareRows` option sets a minimum number of empty rows
      * at the bottom of the grid.
@@ -3022,7 +2975,6 @@ export default (function () {
      * ```
      */
     minSpareRows: 0,
-
     /**
      * @description
      * The `multiColumnSorting` option configures the [`MultiColumnSorting`](@/api/columnSorting.md) plugin.
@@ -3101,14 +3053,21 @@ export default (function () {
      * ```
      */
     multiColumnSorting: void 0,
-
     /**
      * @description
      * The `nestedHeaders` option configures the [`NestedHeaders`](@/api/nestedHeaders.md) plugin.
      *
-     * You can set the `nestedHeaders` option to an array of arrays:
-     * - Each array configures one set of nested headers.
-     * - Each array element configures one header, and can be one of the following:
+     * You can set the `nestedHeaders` option to one of the following:
+     *
+     * | Setting           | Description                                                                                                                           |
+     * | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
+     * | `false` (default) | Disable the [`NestedHeaders`](@/api/nestedHeaders.md) plugin                                                                          |
+     * | `true`            | - Enable the [`NestedHeaders`](@/api/nestedHeaders.md) plugin<br>- Don't configure any nested headers                                 |
+     * | Array of arrays   | - Enable the [`NestedHeaders`](@/api/nestedHeaders.md) plugin<br>- Configure headers that are nested on Handsontable's initialization |
+     *
+     * If you set the `nestedHeaders` option to an array of arrays, each array configures one set of nested headers.
+     *
+     * Each array element configures one header, and can be one of the following:
      *
      * | Array element | Description                                                                                  |
      * | ------------- | -------------------------------------------------------------------------------------------- |
@@ -3120,7 +3079,7 @@ export default (function () {
      * - [Column groups: Nested headers](@/guides/columns/column-groups.md#nested-headers)
      *
      * @memberof Options#
-     * @type {Array[]}
+     * @type {boolean|Array[]}
      * @default undefined
      * @category NestedHeaders
      *
@@ -3134,7 +3093,6 @@ export default (function () {
      * ```
      */
     nestedHeaders: void 0,
-
     /**
      * @description
      * The `nestedRows` option configures the [`NestedRows`](@/api/nestedRows.md) plugin.
@@ -3161,7 +3119,6 @@ export default (function () {
      * @category NestedRows
      */
     nestedRows: void 0,
-
     /**
      * The `noWordWrapClassName` option lets you add a CSS class name
      * to each cell that has the [`wordWrap`](#wordWrap) option set to `false`.
@@ -3191,7 +3148,6 @@ export default (function () {
      * ```
      */
     noWordWrapClassName: 'htNoWrap',
-
     /**
      * The `numericFormat` option configures the number format and the currency format
      * of [`numeric`](@/guides/cell-types/numeric-cell-type.md) cells` displayed output
@@ -3236,7 +3192,6 @@ export default (function () {
      * ```
      */
     numericFormat: void 0,
-
     /**
      * If the `observeDOMVisibility` option is set to `true`,
      * Handsontable rerenders every time it detects that the grid was made visible in the DOM.
@@ -3253,7 +3208,6 @@ export default (function () {
      * ```
      */
     observeDOMVisibility: true,
-
     /**
      * The `outsideClickDeselects` option determines what happens to the current [selection](@/guides/cell-features/selection.md)
      * when you click outside of the grid.
@@ -3291,7 +3245,6 @@ export default (function () {
      * ```
      */
     outsideClickDeselects: true,
-
     /**
      * @description
      * The `persistentState` option configures the [`PersistentState`](@/api/persistentState.md) plugin.
@@ -3319,7 +3272,6 @@ export default (function () {
      * ```
      */
     persistentState: void 0,
-
     /**
      * The `placeholder` option lets you display placeholder text in every empty cell.
      *
@@ -3357,7 +3309,6 @@ export default (function () {
      * ```
      */
     placeholder: void 0,
-
     /**
      * The `placeholderCellClassName` option lets you add a CSS class name to cells
      * that contain [`placeholder`](#placeholder) text.
@@ -3388,7 +3339,6 @@ export default (function () {
      * ```
      */
     placeholderCellClassName: 'htPlaceholder',
-
     /**
      * The `preventOverflow` option configures preventing Handsontable
      * from overflowing outside of its parent element.
@@ -3413,7 +3363,6 @@ export default (function () {
      * ```
      */
     preventOverflow: false,
-
     /**
      * The `preventWheel` option configures preventing the `wheel` event's default action
      * on overlays.
@@ -3438,7 +3387,6 @@ export default (function () {
      * ```
      */
     preventWheel: false,
-
     /**
      * @description
      * The `readOnly` option determines whether a cell, column or comment is editable or not.
@@ -3453,7 +3401,7 @@ export default (function () {
      * `readOnly` cells can't be changed by the [`populateFromArray()`](@/api/core.md#populatefromarray) method.
      *
      * Read more:
-     * - [Configuration options: Cascading configuration](@/guides/getting-started/setting-options.md#cascading-configuration)
+     * - [Configuration options: Cascading configuration](@/guides/getting-started/configuration-options.md#cascading-configuration)
      *
      * @memberof Options#
      * @type {boolean}
@@ -3467,7 +3415,6 @@ export default (function () {
      * ```
      */
     readOnly: false,
-
     /**
      * The `readOnlyCellClassName` option lets you add a CSS class name to [read-only](#readOnly) cells.
      *
@@ -3496,7 +3443,6 @@ export default (function () {
      * ```
      */
     readOnlyCellClassName: 'htDimmed',
-
     /**
      * The `renderAllRows` option configures Handsontable's [row virtualization](@/guides/rows/row-virtualization.md).
      *
@@ -3522,7 +3468,6 @@ export default (function () {
      * ```
      */
     renderAllRows: void 0,
-
     /**
      * @description
      * The `renderer` option sets a [cell renderer](@/guides/cell-functions/cell-renderer.md) for a cell.
@@ -3551,7 +3496,7 @@ export default (function () {
      * Read more:
      * - [Cell renderer](@/guides/cell-functions/cell-renderer.md)
      * - [Cell type](@/guides/cell-types/cell-type.md)
-     * - [Configuration options: Cascading configuration](@/guides/getting-started/setting-options.md#cascading-configuration)
+     * - [Configuration options: Cascading configuration](@/guides/getting-started/configuration-options.md#cascading-configuration)
      * - [`type`](#type)
      *
      * @memberof Options#
@@ -3584,7 +3529,6 @@ export default (function () {
      * ```
      */
     renderer: void 0,
-
     /**
      * The `rowHeaders` option configures your grid's row headers.
      *
@@ -3620,7 +3564,6 @@ export default (function () {
      * ```
      */
     rowHeaders: void 0,
-
     /**
      * @description
      * The `rowHeaderWidth` option configures the width of row headers.
@@ -3647,7 +3590,6 @@ export default (function () {
      * ```
      */
     rowHeaderWidth: void 0,
-
     /**
      * The `rowHeights` option sets rows' heights, in pixels.
      *
@@ -3694,7 +3636,6 @@ export default (function () {
      * ```
      */
     rowHeights: void 0,
-
     /**
      * @description
      * The `search` option configures the [`Search`](@/api/search.md) plugin.
@@ -3746,7 +3687,6 @@ export default (function () {
      * ```
      */
     search: false,
-
     /**
      * @description
      * The `selectionMode` option configures how [selection](@/guides/cell-features/selection.md) works.
@@ -3780,7 +3720,6 @@ export default (function () {
      * ```
      */
     selectionMode: 'multiple',
-
     /**
      * The `selectOptions` option configures options that the end user can choose from in [`select`](@/guides/cell-types/select-cell-type.md) cells.
      *
@@ -3838,7 +3777,6 @@ export default (function () {
      * ```
      */
     selectOptions: void 0,
-
     /**
      * @description
      * The `skipColumnOnPaste` option determines whether you can paste data into a given column.
@@ -3853,7 +3791,7 @@ export default (function () {
      * | `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/setting-options.md#setting-column-options)
+     * - [Configuration options: Setting column options](@/guides/getting-started/configuration-options.md#setting-column-options)
      *
      * @memberof Options#
      * @type {boolean}
@@ -3871,7 +3809,6 @@ export default (function () {
      * ```
      */
     skipColumnOnPaste: false,
-
     /**
      * @description
      *
@@ -3887,7 +3824,7 @@ export default (function () {
      * | `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/setting-options.md#setting-row-options)
+     * - [Configuration options: Setting row options](@/guides/getting-started/configuration-options.md#setting-row-options)
      *
      * @memberof Options#
      * @type {boolean}
@@ -3909,7 +3846,6 @@ export default (function () {
      * ```
      */
     skipRowOnPaste: false,
-
     /**
      * The `sortByRelevance` option configures whether [`autocomplete`](@/guides/cell-types/autocomplete-cell-type.md) cells'
      * lists are sorted in the same order as provided in the [`source`](#source) option.
@@ -3943,7 +3879,6 @@ export default (function () {
      * ```
      */
     sortByRelevance: true,
-
     /**
      * The `source` option sets options available in [`autocomplete`](@/guides/cell-types/autocomplete-cell-type.md)
      * and [`dropdown`](@/guides/cell-types/dropdown-cell-type.md) cells.
@@ -3990,7 +3925,6 @@ export default (function () {
      * ```
      */
     source: void 0,
-
     /**
      * @description
      * If the [`data`](#data) option is not set, the `startCols` option sets the initial number of empty columns.
@@ -4009,7 +3943,6 @@ export default (function () {
      * ```
      */
     startCols: 5,
-
     /**
      * @description
      * If the [`data`](#data) option is not set, the `startRows` option sets the initial number of empty rows.
@@ -4028,7 +3961,6 @@ export default (function () {
      * ```
      */
     startRows: 5,
-
     /**
      * @description
      * The `stretchH` option determines what happens when the declared grid width
@@ -4058,7 +3990,6 @@ export default (function () {
      * ```
      */
     stretchH: 'none',
-
     /**
      * The `strict` option configures the behavior of [`autocomplete`](@/guides/cell-types/autocomplete-cell-type.md) cells.
      *
@@ -4093,7 +4024,6 @@ export default (function () {
      * ```
      */
     strict: void 0,
-
     /**
      * The `tableClassName` option lets you add CSS class names
      * to every Handsontable instance inside the `container` element.
@@ -4134,7 +4064,6 @@ export default (function () {
      * ```
      */
     tableClassName: void 0,
-
     /**
      * The `tabMoves` option configures the action of the <kbd>**Tab**</kbd> key.
      *
@@ -4169,7 +4098,6 @@ export default (function () {
       row: 0,
       col: 1
     },
-
     /**
      * @description
      * The `title` option configures [column header](@/guides/columns/column-header.md) names.
@@ -4202,7 +4130,6 @@ export default (function () {
      * ```
      */
     title: void 0,
-
     /**
      * The `trimDropdown` option configures the width of the [`autocomplete`](@/guides/cell-types/autocomplete-cell-type.md)
      * and [`dropdown`](@/guides/cell-types/dropdown-cell-type.md) lists.
@@ -4242,7 +4169,6 @@ export default (function () {
      * ```
      */
     trimDropdown: true,
-
     /**
      * @description
      * The `trimRows` option configures the [`TrimRows`](@/api/trimRows.md) plugin.
@@ -4275,7 +4201,6 @@ export default (function () {
      * ```
      */
     trimRows: void 0,
-
     /**
      * The `trimWhitespace` option configures automatic whitespace removal. This option
      * affects the cell renderer and the cell editor.
@@ -4304,7 +4229,6 @@ export default (function () {
      * ```
      */
     trimWhitespace: true,
-
     /**
      * @description
      * The `type` option lets you set the [`renderer`](#renderer), [`editor`](#editor), and [`validator`](#validator)
@@ -4330,7 +4254,7 @@ export default (function () {
      * - [Cell renderer](@/guides/cell-functions/cell-renderer.md)
      * - [Cell editor](@/guides/cell-functions/cell-editor.md)
      * - [Cell validator](@/guides/cell-functions/cell-validator.md)
-     * - [Configuration options: Cascading configuration](@/guides/getting-started/setting-options.md#cascading-configuration)
+     * - [Configuration options: Cascading configuration](@/guides/getting-started/configuration-options.md#cascading-configuration)
      * - [`renderer`](#renderer)
      * - [`editor`](#editor)
      * - [`validator`](#validator)
@@ -4359,7 +4283,6 @@ export default (function () {
      * ```
      */
     type: 'text',
-
     /**
      * The `uncheckedTemplate` option lets you configure what value
      * an unchecked [`checkbox`](@/guides/cell-types/checkbox-cell-type.md) cell has.
@@ -4402,7 +4325,6 @@ export default (function () {
      * ```
      */
     uncheckedTemplate: void 0,
-
     /**
      * The `undo` option configures the [`UndoRedo`](@/api/undoRedo.md) plugin.
      *
@@ -4433,7 +4355,6 @@ export default (function () {
      * ```
      */
     undo: void 0,
-
     /**
      * @description
      * The `validator` option sets a [cell validator](@/guides/cell-functions/cell-validator.md) for a cell.
@@ -4464,7 +4385,7 @@ export default (function () {
      * Read more:
      * - [Cell validator](@/guides/cell-functions/cell-validator.md)
      * - [Cell type](@/guides/cell-types/cell-type.md)
-     * - [Configuration options: Cascading configuration](@/guides/getting-started/setting-options.md#cascading-configuration)
+     * - [Configuration options: Cascading configuration](@/guides/getting-started/configuration-options.md#cascading-configuration)
      * - [`type`](#type)
      *
      * @memberof Options#
@@ -4493,7 +4414,6 @@ export default (function () {
      * ```
      */
     validator: void 0,
-
     /**
      * @description
      * The `viewportColumnRenderingOffset` option configures the number of columns
@@ -4521,7 +4441,6 @@ export default (function () {
      * ```
      */
     viewportColumnRenderingOffset: 'auto',
-
     /**
      * @description
      * The `viewportRowRenderingOffset` option configures the number of rows
@@ -4550,7 +4469,6 @@ export default (function () {
      * ```
      */
     viewportRowRenderingOffset: 'auto',
-
     /**
      * The `visibleRows` option sets the height of the [`autocomplete`](@/guides/cell-types/autocomplete-cell-type.md)
      * and [`dropdown`](@/guides/cell-types/dropdown-cell-type.md) lists.
@@ -4585,7 +4503,6 @@ export default (function () {
      * ```
      */
     visibleRows: 10,
-
     /**
      * The `width` option configures the width of your grid.
      *
@@ -4620,7 +4537,6 @@ export default (function () {
      * ```
      */
     width: void 0,
-
     /**
      * The `wordWrap` option configures whether content that exceeds a column's width is wrapped or not.
      *
@@ -4659,7 +4575,7 @@ export default (function () {
      * ```
      */
     wordWrap: true
-    /* eslint-enable jsdoc/require-description-complete-sentence */
 
+    /* eslint-enable jsdoc/require-description-complete-sentence */
   };
 });