handsontable 12.1.2 → 12.2.0

package/dataMap/metaManager/metaSchema.js

@@ -2,35 +2,23 @@
 
 exports.__esModule = true;
 exports.default = void 0;
-
 require("core-js/modules/es.symbol.js");
-
 require("core-js/modules/es.symbol.description.js");
-
 require("core-js/modules/es.object.to-string.js");
-
 require("core-js/modules/es.symbol.iterator.js");
-
 require("core-js/modules/es.array.iterator.js");
-
 require("core-js/modules/es.string.iterator.js");
-
 require("core-js/modules/web.dom-collections.iterator.js");
-
 var _mixed = require("../../helpers/mixed");
-
 var _object = require("../../helpers/object");
-
 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); }
-
 /* 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)
@@ -38,10 +26,11 @@ function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" =
  * - 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');
  *
@@ -60,21 +49,58 @@ function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" =
  *   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)
  */
 var _default = function _default() {
   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).
@@ -104,7 +130,6 @@ var _default = function _default() {
      * ```
      */
     activeHeaderClassName: 'ht__active_highlight',
-
     /**
      * The `allowEmpty` option determines whether Handsontable accepts the following values:
      * - `null`
@@ -113,10 +138,14 @@ var _default = function _default() {
      *
      * You can set the `allowEmpty` option to one of the following:
      *
-     * | Setting          | Description                                                                                                                           |
-     * | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
-     * | `true` (default) | - Accept `null`, `undefined` and `''` values<br>- Mark cells that contain `null`, `undefined` and `''` values as `valid`              |
-     * | `false`          | - Don't accept `null`, `undefined` and `''` values<br>- Mark cells that contain `null`, `undefined` and `''` values with as `invalid` |
+     * | Setting          | Description                                                                                                                          |
+     * | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
+     * | `true` (default) | - Accept `null`, `undefined` and `''` values<br>- Mark cells that contain `null`, `undefined` or `''` values as `valid`              |
+     * | `false`          | - Don't accept `null`, `undefined` and `''` values<br>- Mark cells that contain `null`, `undefined` or `''` values with as `invalid` |
+     *
+     * ::: tip
+     * To use the [`allowEmpty`](#allowempty) option, you need to set the [`validator`](#validator) option (or the [`type`](#type) option).
+     * :::
      *
      * @memberof Options#
      * @type {boolean}
@@ -125,22 +154,21 @@ var _default = function _default() {
      *
      * @example
      * ```js
-     * // allow empty values in every cell of the entire grid
+     * // allow empty values in each cell of the entire grid
      * allowEmpty: true,
      *
      * // or
      * columns: [
      *   {
-     *     data: 'date',
+     *     type: 'date',
      *     dateFormat: 'DD/MM/YYYY',
-     *     // allow empty values in every cell of the 'date' column
+     *     // allow empty values in each cell of the 'date' column
      *     allowEmpty: true
      *   }
      * ],
      * ```
      */
     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
@@ -169,7 +197,7 @@ var _default = function _default() {
      * ```js
      * columns: [
      *   {
-     *   // set the `type` of every cell in this column to `autocomplete`
+     *   // set the `type` of each cell in this column to `autocomplete`
      *   type: 'autocomplete',
      *   // set options available in every `autocomplete` cell of this column
      *   source: ['<strong>foo</strong>', '<strong>bar</strong>']
@@ -180,7 +208,6 @@ var _default = function _default() {
      * ```
      */
     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**
@@ -198,7 +225,6 @@ var _default = function _default() {
      * ```
      */
     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**
@@ -216,7 +242,6 @@ var _default = function _default() {
      * ```
      */
     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).
@@ -249,7 +274,6 @@ var _default = function _default() {
      * ```
      */
     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**
@@ -269,7 +293,6 @@ var _default = function _default() {
      * ```
      */
     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**
@@ -289,7 +312,6 @@ var _default = function _default() {
      * ```
      */
     allowRemoveRow: true,
-
     /**
      * The `autoColumnSize` option configures the [`AutoColumnSize`](@/api/autoColumnSize.md) plugin.
      *
@@ -340,7 +362,6 @@ var _default = function _default() {
      * ```
      */
     autoColumnSize: void 0,
-
     /**
      * The `autoRowSize` option configures the [`AutoRowSize`](@/api/autoRowSize.md) plugin.
      *
@@ -380,7 +401,6 @@ 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.
      *
@@ -403,7 +423,6 @@ var _default = function _default() {
      * ```
      */
     autoWrapCol: false,
-
     /**
      * The `autoWrapRow` option determines what happens to current cell selection when you navigate to the grid's left or right edge.
      *
@@ -426,7 +445,6 @@ var _default = function _default() {
      * ```
      */
     autoWrapRow: false,
-
     /**
      * @description
      * The `bindRowsWithHeaders` option configures the [`BindRowsWithHeaders`](@/api/bindRowsWithHeaders.md) plugin.
@@ -453,15 +471,14 @@ var _default = function _default() {
      * ```
      */
     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#
@@ -483,10 +500,9 @@ var _default = function _default() {
      * ```
      */
     cell: [],
-
     /**
      * @description
-     * The `cells` option lets you apply [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)).
@@ -499,8 +515,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/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)
      *
@@ -526,7 +542,6 @@ var _default = function _default() {
      * ```
      */
     cells: void 0,
-
     /**
      * The `checkedTemplate` option lets you configure what value
      * a checked [`checkbox`](@/guides/cell-types/checkbox-cell-type.md) cell has.
@@ -552,13 +567,13 @@ var _default = function _default() {
      * ```js
      * columns: [
      *   {
-     *     // set the `type` of every cell in this column to `checkbox`
+     *     // set the `type` of each cell in this column to `checkbox`
      *     // when checked, the cell's value is `true`
      *     // when unchecked, the cell's value is `false`
      *     type: 'checkbox',
      *   },
      *   {
-     *     // set the `type` of every cell in this column to `checkbox`
+     *     // set the `type` of each cell in this column to `checkbox`
      *     type: 'checkbox',
      *     // when checked, the cell's value is `'Yes'`
      *     checkedTemplate: 'Yes',
@@ -569,7 +584,6 @@ var _default = function _default() {
      * ```
      */
     checkedTemplate: void 0,
-
     /**
      * The `className` option lets you add CSS class names to every currently-selected element.
      *
@@ -580,10 +594,15 @@ var _default = function _default() {
      * | 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)
@@ -612,7 +631,6 @@ var _default = function _default() {
      * ```
      */
     className: void 0,
-
     /**
      * The `colHeaders` option configures your grid's column headers.
      *
@@ -648,7 +666,6 @@ var _default = function _default() {
      * ```
      */
     colHeaders: null,
-
     /**
      * @description
      * The `collapsibleColumns` option configures the [`CollapsibleColumns`](@/api/collapsibleColumns.md) plugin.
@@ -682,7 +699,6 @@ var _default = function _default() {
      * ```
      */
     collapsibleColumns: void 0,
-
     /**
      * @description
      * The `columnHeaderHeight` option configures the height of column headers.
@@ -709,24 +725,24 @@ var _default = function _default() {
      * ```
      */
     columnHeaderHeight: void 0,
-
     /**
      * @description
-     * The `columns` option lets you apply [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 the `columns` option, the [`startCols`](#startCols), [`minCols`](#minCols), and [`maxCols`](#maxCols) are ignored.
+     * 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)
+     * - [`data`](#data)
      *
      * @memberof Options#
      * @type {object[]|Function}
@@ -762,7 +778,6 @@ var _default = function _default() {
      * ```
      */
     columns: void 0,
-
     /**
      * @description
      * The `columnSorting` option configures the [`ColumnSorting`](@/api/columnSorting.md) plugin.
@@ -842,7 +857,6 @@ var _default = function _default() {
      * ```
      */
     columnSorting: void 0,
-
     /**
      * @description
      * The `columnSummary` option configures the [`ColumnSummary`](@/api/columnSummary.md) plugin.
@@ -897,7 +911,6 @@ var _default = function _default() {
      * ```
      */
     columnSummary: void 0,
-
     /**
      * The `colWidths` option sets columns' widths, in pixels.
      *
@@ -945,7 +958,6 @@ var _default = function _default() {
      * ```
      */
     colWidths: void 0,
-
     /**
      * The `commentedCellClassName` option lets you add a CSS class name to cells
      * that have comments.
@@ -972,12 +984,11 @@ var _default = function _default() {
      * @example
      * ```js
      * // add a `has-comment` CSS class name
-     * // to every cell that has a comment
+     * // to each cell that has a comment
      * commentedCellClassName: 'has-comment',
      * ```
      */
     commentedCellClassName: 'htCommentCell',
-
     /**
      * @description
      * The `comments` option configures the [`Comments`](@/api/comments.md) plugin.
@@ -1032,7 +1043,6 @@ var _default = function _default() {
      * ```
      */
     comments: false,
-
     /**
      * @description
      * The `contextMenu` option configures the [`ContextMenu`](@/api/contextMenu.md) plugin.
@@ -1095,21 +1105,20 @@ var _default = function _default() {
      * ```
      */
     contextMenu: void 0,
-
     /**
      * @description
      * The `copyable` option determines whether a cell's value can be copied to the clipboard or not.
      *
      * You can set the `copyable` option to one of the following:
      *
-     * | Setting                                                                                                        | Description                                                                                                                        |
-     * | -------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
-     * | `true` (default)                                                                                               | - Enable copying for this cell<br>- On pressing <kbd>**Ctrl**</kbd>/<kbd>**Cmd**</kbd> + <kbd>**C**</kbd>, add the cell's value to the clipboard |
-     * | `false`<br>(default for the [`password`](@/guides/cell-types/password-cell-type.md) [cell type](#type))        | - Disable copying for this cell                                                                                                    |
+     * | Setting                                                                                                        | Description                                                                                                            |
+     * | -------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+     * | `true` (default)                                                                                               | - On pressing <kbd>**Ctrl**</kbd>/<kbd>**Cmd**</kbd> + <kbd>**C**</kbd>, add the cell's value to the clipboard         |
+     * | `false`<br>(default for the [`password`](@/guides/cell-types/password-cell-type.md) [cell type](#type))        | - On pressing <kbd>**Ctrl**</kbd>/<kbd>**Cmd**</kbd> + <kbd>**C**</kbd>, add an empty string (`""`) to the clipboard   |
      *
      * 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#
@@ -1119,17 +1128,17 @@ var _default = function _default() {
      *
      * @example
      * ```js
-     * // enable copying for every cell of the entire grid
+     * // enable copying for each cell of the entire grid
      * copyable: true,
      *
      * // enable copying for individual columns
      * columns: [
      *   {
-     *     // enable copying for every cell of this column
+     *     // enable copying for each cell of this column
      *     copyable: true
      *   },
      *   {
-     *     // disable copying for every cell of this column
+     *     // disable copying for each cell of this column
      *     copyable: false
      *   }
      * ]
@@ -1146,7 +1155,6 @@ var _default = function _default() {
      * ```
      */
     copyable: true,
-
     /**
      * The `copyPaste` option configures the [`CopyPaste`](@/api/copyPaste.md) plugin.
      *
@@ -1195,17 +1203,22 @@ var _default = function _default() {
      * ```
      */
     copyPaste: true,
-
     /**
-     * The `correctFormat` option configures what happens when the format of a date entered into a [`date`](@/guides/cell-types/date-cell-type.md) cell doesn't match the format specified by the [`dateFormat`](#dateFormat) option:
+     * The `correctFormat` option configures whether incorrectly-formatted times and dates are amended or not.
+     *
+     * When the user enters dates and times, Handsontable can automatically adjust their format
+     * to match the [`dateFormat`](#dateFormat) and [`timeFormat`](@/guides/cell-types/time-cell-type.md) settings.
      *
-     * | Setting           | Description                                                                        |
-     * | ----------------- | ---------------------------------------------------------------------------------- |
-     * | `false` (default) | Don't correct the entered date's format (treat the entered date as invalid)        |
-     * | `true`            | Correct the entered date's format to match the [`dateFormat`](#dateFormat) setting |
+     * You can set the `correctFormat` option to one of the following:
+     *
+     * | Setting           | Description                                                                                                                                               |
+     * | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
+     * | `false` (default) | Don't correct the format of the entered date or time (treat the entered date or time as invalid)                                                          |
+     * | `true`            | Correct the format of the entered date or time to match the [`dateFormat`](#dateFormat) or [`timeFormat`](@/guides/cell-types/time-cell-type.md) settings |
      *
      * Read more:
      * - [Date cell type](@/guides/cell-types/date-cell-type.md)
+     * - [Time cell type](@/guides/cell-types/time-cell-type.md)
      * - [`dateFormat`](#dateFormat)
      *
      * @memberof Options#
@@ -1217,21 +1230,29 @@ var _default = function _default() {
      * ```js
      * columns: [
      *   {
-     *   // set the `type` of every cell in this column to `date`
+     *   // set the `type` of each cell in this column to `date`
      *   type: 'date',
      *   // for every `date` cell of this column, set the date format to `YYYY-MM-DD`
      *   dateFormat: 'YYYY-MM-DD',
      *   // enforce the `YYYY-MM-DD` date format
      *   correctFormat: true
      *   },
+     *
+     *   {
+     *   // set the `type` of each cell in this column to `time`
+     *   type: 'time',
+     *   // for every `time` cell of this column, set the time format to `h:mm:ss a`
+     *   timeFormat: 'h:mm:ss a',
+     *   // enforce the `h:mm:ss a` time format
+     *   correctFormat: true
+     *   },
      * ],
      * ```
      */
     correctFormat: false,
-
     /**
      * The `currentColClassName` option lets you add a CSS class name
-     * to every cell of the currently-visible, currently-selected columns.
+     * to each cell of the currently-visible, currently-selected columns.
      *
      * Read more:
      * - [`currentRowClassName`](#currentRowClassName)
@@ -1253,12 +1274,11 @@ var _default = function _default() {
      * @example
      * ```js
      * // add a `your-class-name` CSS class name
-     * // to every cell of the currently-visible, currently-selected columns
+     * // to each cell of the currently-visible, currently-selected columns
      * currentColClassName: 'your-class-name',
      * ```
      */
     currentColClassName: void 0,
-
     /**
      * The `currentHeaderClassName` option lets you add a CSS class name
      * to every currently-visible, currently-selected header.
@@ -1287,10 +1307,9 @@ var _default = function _default() {
      * ```
      */
     currentHeaderClassName: 'ht__highlight',
-
     /**
      * The `currentRowClassName` option lets you add a CSS class name
-     * to every cell of the currently-visible, currently-selected rows.
+     * to each cell of the currently-visible, currently-selected rows.
      *
      * Read more:
      * - [`currentColClassName`](#currentColClassName)
@@ -1312,12 +1331,11 @@ var _default = function _default() {
      * @example
      * ```js
      * // add a `your-class-name` CSS class name
-     * // to every cell of the currently-visible, currently-selected rows
+     * // to each cell of the currently-visible, currently-selected rows
      * currentRowClassName: 'your-class-name',
      * ```
      */
     currentRowClassName: void 0,
-
     /**
      * @description
      * The `customBorders` option configures the [`CustomBorders`](@/api/customBorders.md) plugin.
@@ -1430,7 +1448,6 @@ var _default = function _default() {
      * ```
      */
     customBorders: false,
-
     /**
      * @description
      * The `data` option sets the initial [data](@/guides/getting-started/binding-to-data.md) of your Handsontable instance.
@@ -1441,9 +1458,13 @@ var _default = function _default() {
      * - Either to an [array of arrays](@/guides/getting-started/binding-to-data.md#array-of-arrays).
      * - Or to an [array of objects](@/guides/getting-started/binding-to-data.md#array-of-objects).
      *
+     * If you don't set the `data` option (or set it to `null`), Handsontable renders as an empty 5x5 grid by default.
+     *
      * Read more:
      * - [Binding to data](@/guides/getting-started/binding-to-data.md)
      * - [`dataSchema`](#dataSchema)
+     * - [`startRows`](#startRows)
+     * - [`startCols`](#startCols)
      *
      * @memberof Options#
      * @type {Array[]|object[]}
@@ -1470,18 +1491,24 @@ var _default = function _default() {
      * ```
      */
     data: void 0,
-
     /**
      * @description
-     * If the [`data`](#data) option is set to an [array of objects](@/guides/getting-started/binding-to-data.md#array-of-objects)
+     * When the [`data`](#data) option is set to an [array of objects](@/guides/getting-started/binding-to-data.md#array-of-objects)
      * (or is empty), the `dataSchema` option defines the structure of new rows.
      *
+     * Using the `dataSchema` option, you can start out with an empty grid.
+     *
+     * You can set the `dataSchema` option to one of the following:
+     * - An object
+     * - A function
+     *
      * Read more:
      * - [Binding to data: Array of objects with custom data schema](@/guides/getting-started/binding-to-data.md#array-of-objects-with-custom-data-schema)
+     * - [Binding to data: Function data source and schema](@/guides/getting-started/binding-to-data.md#function-data-source-and-schema)
      * - [`data`](#data)
      *
      * @memberof Options#
-     * @type {object}
+     * @type {object|Function}
      * @default undefined
      * @category Core
      *
@@ -1502,7 +1529,6 @@ var _default = function _default() {
      * ```
      */
     dataSchema: void 0,
-
     /**
      * The `dateFormat` option configures the date format accepted by [`date`](@/guides/cell-types/date-cell-type.md) cells.
      *
@@ -1524,7 +1550,7 @@ var _default = function _default() {
      * ```js
      * columns: [
      *   {
-     *   // set the `type` of every cell in this column to `date`
+     *   // set the `type` of each cell in this column to `date`
      *   type: 'date',
      *   // for every `date` cell of this column, set the date format to `YYYY-MM-DD`
      *   dateFormat: 'YYYY-MM-DD',
@@ -1533,18 +1559,17 @@ var _default = function _default() {
      * ```
      */
     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.0).
+     * 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).
      *
-     * You can set the `datePickerConfig` option to an object with any of the available [Pikaday options](https://github.com/Pikaday/Pikaday/tree/1.8.0#configuration),
+     * You can set the `datePickerConfig` option to an object with any of the available [Pikaday options](https://github.com/Pikaday/Pikaday/tree/1.8.2#configuration),
      * except for the following, which are always overwritten by the `date` [cell editor](@/guides/cell-functions/cell-editor.md):
      * - `bound`
      * - `container`
      * - `field`
      * - `trigger`
      *
-     * If the `datePickerConfig` option is not defined, the `date` [cell editor](@/guides/cell-functions/cell-editor.md) overwrites the following [Pikaday options](https://github.com/Pikaday/Pikaday/tree/1.8.0#configuration) as well:
+     * If the `datePickerConfig` option is not defined, the `date` [cell editor](@/guides/cell-functions/cell-editor.md) overwrites the following [Pikaday options](https://github.com/Pikaday/Pikaday/tree/1.8.2#configuration) as well:
      *
      * | Pikaday option       | Handsontable's setting |
      * | -------------------- | ---------------------- |
@@ -1555,7 +1580,7 @@ var _default = function _default() {
      * - [`editor`](#editor)
      * - [`dateFormat`](#dateFormat)
      * - [Cell editor](@/guides/cell-functions/cell-editor.md)
-     * - [All Pikaday options &#8594;](https://github.com/Pikaday/Pikaday/tree/1.8.0#configuration)
+     * - [All Pikaday options &#8594;](https://github.com/Pikaday/Pikaday/tree/1.8.2#configuration)
      *
      * @memberof Options#
      * @type {object}
@@ -1563,7 +1588,6 @@ var _default = function _default() {
      * @category Core
      */
     datePickerConfig: void 0,
-
     /**
      * The `defaultDate` option configures the date displayed
      * in empty [`date`](@/guides/cell-types/date-cell-type.md) cells.
@@ -1583,7 +1607,7 @@ var _default = function _default() {
      * ```js
      * columns: [
      *   {
-     *     // set the `type` of every cell in this column to `date`
+     *     // set the `type` of each cell in this column to `date`
      *     type: 'date',
      *     // in every empty `date` cell of this column, display `2015-02-02`
      *     defaultDate: '2015-02-02'
@@ -1592,7 +1616,6 @@ var _default = function _default() {
      * ```
      */
     defaultDate: void 0,
-
     /**
      * @description
      * The `disableVisualSelection` option configures how
@@ -1636,7 +1659,6 @@ var _default = function _default() {
      * ```
      */
     disableVisualSelection: false,
-
     /**
      * @description
      * The `dragToScroll` option configures the [`DragToScroll`](@/api/dragToScroll.md) plugin.
@@ -1663,7 +1685,6 @@ var _default = function _default() {
      * ```
      */
     dragToScroll: true,
-
     /**
      * The `dropdownMenu` option configures the [`DropdownMenu`](@/api/dropdownMenu.md) plugin.
      *
@@ -1722,7 +1743,6 @@ var _default = function _default() {
      * ```
      */
     dropdownMenu: void 0,
-
     /**
      * The `editor` option sets a [cell editor](@/guides/cell-functions/cell-editor.md) for a cell.
      *
@@ -1754,7 +1774,7 @@ var _default = function _default() {
      * 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#
@@ -1764,24 +1784,23 @@ var _default = function _default() {
      *
      * @example
      * ```js
-     * // use the `numeric` editor for every cell of the entire grid
+     * // use the `numeric` editor for each cell of the entire grid
      * editor: 'numeric',
      *
      * // apply the `editor` option to individual columns
      * columns: [
      *   {
-     *     // use the `autocomplete` editor for every cell of this column
+     *     // use the `autocomplete` editor for each cell of this column
      *     editor: 'autocomplete'
      *   },
      *   {
-     *     // disable editing cells through cell editors for every cell of this column
+     *     // disable editing cells through cell editors for each cell of this column
      *     editor: false
      *   }
      * ]
      * ```
      */
     editor: void 0,
-
     /**
      * The `enterBeginsEditing` option configures the action of the <kbd>**Enter**</kbd> key.
      *
@@ -1811,7 +1830,6 @@ var _default = function _default() {
      * ```
      */
     enterBeginsEditing: true,
-
     /**
      * The `enterMoves` option configures the action of the <kbd>**Enter**</kbd> key.
      *
@@ -1855,7 +1873,6 @@ var _default = function _default() {
       col: 0,
       row: 1
     },
-
     /**
      * The `fillHandle` option configures the [Autofill](@/api/autofill.md) plugin.
      *
@@ -1915,7 +1932,6 @@ var _default = function _default() {
     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.
@@ -1940,7 +1956,7 @@ var _default = function _default() {
      * @example
      * ```js
      * columns: [{
-     *   // set the `type` of every cell in this column to `autocomplete`
+     *   // set the `type` of each cell in this column to `autocomplete`
      *   type: 'autocomplete',
      *   // set options available in every `autocomplete` cell of this column
      *   source: ['A', 'B', 'C'],
@@ -1952,7 +1968,6 @@ var _default = function _default() {
      * ```
      */
     filter: true,
-
     /**
      * The `filteringCaseSensitive` option configures whether [`autocomplete`](@/guides/cell-types/autocomplete-cell-type.md) cells'
      * input is case-sensitive.
@@ -1987,7 +2002,6 @@ var _default = function _default() {
      * ```
      */
     filteringCaseSensitive: false,
-
     /**
      * The `filters` option configures the [`Filters`](@/api/filters.md) plugin.
      *
@@ -2015,7 +2029,6 @@ var _default = function _default() {
      * ```
      */
     filters: void 0,
-
     /**
      * `fixedColumnsLeft` is a legacy option.
      *
@@ -2040,7 +2053,6 @@ var _default = function _default() {
      * ```
      */
     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.
      *
@@ -2079,7 +2091,6 @@ var _default = function _default() {
      * ```
      */
     fixedColumnsStart: 0,
-
     /**
      * The `fixedRowsBottom` option sets the number of [frozen rows](@/guides/rows/row-freezing.md)
      * at the bottom of the grid.
@@ -2099,7 +2110,6 @@ var _default = function _default() {
      * ```
      */
     fixedRowsBottom: 0,
-
     /**
      * The `fixedRowsTop` option sets the number of [frozen rows](@/guides/rows/row-freezing.md) at the top of the grid.
      *
@@ -2118,7 +2128,6 @@ var _default = function _default() {
      * ```
      */
     fixedRowsTop: 0,
-
     /**
      * The `formulas` option configures the [`Formulas`](@/api/formulas.md) plugin.
      *
@@ -2198,7 +2207,6 @@ var _default = function _default() {
      * ```
      */
     formulas: void 0,
-
     /**
      * The `fragmentSelection` option configures text selection settings.
      *
@@ -2225,7 +2233,6 @@ var _default = function _default() {
      * ```
      */
     fragmentSelection: false,
-
     /**
      * The `height` option configures the height of your grid.
      *
@@ -2260,7 +2267,6 @@ var _default = function _default() {
      * ```
      */
     height: void 0,
-
     /**
      * The `hiddenColumns` option configures the [`HiddenColumns`](@/api/hiddenColumns.md) plugin.
      *
@@ -2306,7 +2312,6 @@ var _default = function _default() {
      * ```
      */
     hiddenColumns: void 0,
-
     /**
      * The `hiddenRows` option configures the [`HiddenRows`](@/api/hiddenRows.md) plugin.
      *
@@ -2352,7 +2357,6 @@ var _default = function _default() {
      * ```
      */
     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).
@@ -2382,7 +2386,6 @@ var _default = function _default() {
      * ```
      */
     invalidCellClassName: 'htInvalid',
-
     /**
      * The `isEmptyCol` option lets you define your own custom method
      * for checking if a column at a given visual index is empty.
@@ -2403,23 +2406,18 @@ var _default = function _default() {
      *    ...
      * },
      * ```
-     */
-    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 ((0, _mixed.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.
@@ -2440,29 +2438,23 @@ var _default = function _default() {
      *    ...
      * },
      * ```
-     */
-    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 ((0, _mixed.isEmpty)(value) === false) {
           if (_typeof(value) === 'object') {
             meta = this.getCellMeta(row, col);
             return (0, _object.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.
@@ -2494,7 +2486,6 @@ var _default = function _default() {
      * ```
      */
     label: void 0,
-
     /**
      * The `language` option configures Handsontable's [language](@/guides/internationalization/language.md) settings.
      *
@@ -2539,13 +2530,12 @@ var _default = function _default() {
      * ```
      */
     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:
@@ -2585,7 +2575,6 @@ var _default = function _default() {
      * ```
      */
     layoutDirection: 'inherit',
-
     /**
      * The `licenseKey` option sets your Handsontable license key.
      *
@@ -2614,7 +2603,6 @@ var _default = function _default() {
      * ```
      */
     licenseKey: void 0,
-
     /**
      * The `locale` option configures Handsontable's [locale](@/guides/internationalization/locale.md) settings.
      *
@@ -2651,7 +2639,6 @@ var _default = function _default() {
      * ```
      */
     locale: 'en-US',
-
     /**
      * The `manualColumnFreeze` option configures the [`ManualColumnFreeze`](@/api/manualColumnFreeze.md) plugin.
      *
@@ -2677,7 +2664,6 @@ var _default = function _default() {
      * ```
      */
     manualColumnFreeze: void 0,
-
     /**
      * The `manualColumnMove` option configures the [`ManualColumnMove`](@/api/manualColumnMove.md) plugin.
      *
@@ -2710,7 +2696,6 @@ var _default = function _default() {
      * ```
      */
     manualColumnMove: void 0,
-
     /**
      * @description
      * The `manualColumnResize` option configures the [`ManualColumnResize`](@/api/manualColumnResize.md) plugin.
@@ -2744,7 +2729,6 @@ var _default = function _default() {
      * ```
      */
     manualColumnResize: void 0,
-
     /**
      * @description
      * The `manualRowMove` option configures the [`ManualRowMove`](@/api/manualRowMove.md) plugin.
@@ -2778,7 +2762,6 @@ var _default = function _default() {
      * ```
      */
     manualRowMove: void 0,
-
     /**
      * @description
      * The `manualRowResize` option configures the [`ManualRowResize`](@/api/manualRowResize.md) plugin.
@@ -2812,7 +2795,6 @@ var _default = function _default() {
      * ```
      */
     manualRowResize: void 0,
-
     /**
      * The `maxCols` option sets a maximum number of columns.
      *
@@ -2833,7 +2815,6 @@ var _default = function _default() {
      * ```
      */
     maxCols: Infinity,
-
     /**
      * The `maxRows` option sets a maximum number of rows.
      *
@@ -2854,7 +2835,6 @@ var _default = function _default() {
      * ```
      */
     maxRows: Infinity,
-
     /**
      * @description
      * The `mergeCells` option configures the [`MergeCells`](@/api/mergeCells.md) plugin.
@@ -2903,7 +2883,6 @@ var _default = function _default() {
      * ```
      */
     mergeCells: false,
-
     /**
      * The `minCols` option sets a minimum number of columns.
      *
@@ -2931,7 +2910,6 @@ var _default = function _default() {
      * ```
      */
     minCols: 0,
-
     /**
      * The `minRows` option sets a minimum number of rows.
      *
@@ -2952,7 +2930,6 @@ var _default = function _default() {
      * ```
      */
     minRows: 0,
-
     /**
      * The `minSpareCols` option sets a minimum number of empty columns
      * at the grid's right-hand end.
@@ -2981,7 +2958,6 @@ var _default = function _default() {
      * ```
      */
     minSpareCols: 0,
-
     /**
      * The `minSpareRows` option sets a minimum number of empty rows
      * at the bottom of the grid.
@@ -3003,7 +2979,6 @@ var _default = function _default() {
      * ```
      */
     minSpareRows: 0,
-
     /**
      * @description
      * The `multiColumnSorting` option configures the [`MultiColumnSorting`](@/api/columnSorting.md) plugin.
@@ -3082,14 +3057,21 @@ var _default = function _default() {
      * ```
      */
     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                                                                                  |
      * | ------------- | -------------------------------------------------------------------------------------------- |
@@ -3101,7 +3083,7 @@ var _default = function _default() {
      * - [Column groups: Nested headers](@/guides/columns/column-groups.md#nested-headers)
      *
      * @memberof Options#
-     * @type {Array[]}
+     * @type {boolean|Array[]}
      * @default undefined
      * @category NestedHeaders
      *
@@ -3115,7 +3097,6 @@ var _default = function _default() {
      * ```
      */
     nestedHeaders: void 0,
-
     /**
      * @description
      * The `nestedRows` option configures the [`NestedRows`](@/api/nestedRows.md) plugin.
@@ -3142,10 +3123,9 @@ var _default = function _default() {
      * @category NestedRows
      */
     nestedRows: void 0,
-
     /**
      * The `noWordWrapClassName` option lets you add a CSS class name
-     * to every cell that has the [`wordWrap`](#wordWrap) option set to `false`.
+     * to each cell that has the [`wordWrap`](#wordWrap) option set to `false`.
      *
      * Read more:
      * - [`wordWrap`](#wordWrap)
@@ -3167,15 +3147,15 @@ var _default = function _default() {
      * @example
      * ```js
      * // add an `is-noWrapCell` CSS class name
-     * // to every cell that doesn't wrap content
+     * // to each cell that doesn't wrap content
      * noWordWrapClassName: 'is-noWrapCell',
      * ```
      */
     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.
+     * of [`numeric`](@/guides/cell-types/numeric-cell-type.md) cells` displayed output
+     * in the numeric cell renderer.
      *
      * You can set the `numericFormat` option to an object with the following properties:
      *
@@ -3184,10 +3164,7 @@ var _default = function _default() {
      * | `pattern`   | All [`numbro.js` number formats](https://numbrojs.com/format.html#numbers)    | Number format   |
      * | `culture`   | All [`numbro.js` currency formats](https://numbrojs.com/format.html#currency) | Currency format |
      *
-     * The `numericFormat` option as no effect on cells' input data.
-     * To enter numeric data into Handsontable, use:
-     * - Either floats (separated by a dot, or a comma)
-     * - Or integers
+     * The `numericFormat` option as no effect on the numeric cell editor.
      *
      * In the source data, numeric data is stored as JavaScript numbers.
      *
@@ -3205,7 +3182,7 @@ var _default = function _default() {
      * ```js
      * columns: [
      *   {
-     *     // set the `type` of every cell in this column to `numeric`
+     *     // set the `type` of each cell in this column to `numeric`
      *     type: 'numeric',
      *     // set the `numericFormat` option for every `numeric` cell of this column
      *     numericFormat: {
@@ -3219,7 +3196,6 @@ var _default = function _default() {
      * ```
      */
     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.
@@ -3236,7 +3212,6 @@ var _default = function _default() {
      * ```
      */
     observeDOMVisibility: true,
-
     /**
      * The `outsideClickDeselects` option determines what happens to the current [selection](@/guides/cell-features/selection.md)
      * when you click outside of the grid.
@@ -3274,7 +3249,6 @@ var _default = function _default() {
      * ```
      */
     outsideClickDeselects: true,
-
     /**
      * @description
      * The `persistentState` option configures the [`PersistentState`](@/api/persistentState.md) plugin.
@@ -3302,7 +3276,6 @@ var _default = function _default() {
      * ```
      */
     persistentState: void 0,
-
     /**
      * The `placeholder` option lets you display placeholder text in every empty cell.
      *
@@ -3340,7 +3313,6 @@ var _default = function _default() {
      * ```
      */
     placeholder: void 0,
-
     /**
      * The `placeholderCellClassName` option lets you add a CSS class name to cells
      * that contain [`placeholder`](#placeholder) text.
@@ -3366,12 +3338,11 @@ var _default = function _default() {
      * @example
      * ```js
      * // add a `has-placeholder` CSS class name
-     * // to every cell that contains `placeholder` text
+     * // to each cell that contains `placeholder` text
      * placeholderCellClassName: 'has-placeholder',
      * ```
      */
     placeholderCellClassName: 'htPlaceholder',
-
     /**
      * The `preventOverflow` option configures preventing Handsontable
      * from overflowing outside of its parent element.
@@ -3396,7 +3367,6 @@ var _default = function _default() {
      * ```
      */
     preventOverflow: false,
-
     /**
      * The `preventWheel` option configures preventing the `wheel` event's default action
      * on overlays.
@@ -3421,7 +3391,6 @@ var _default = function _default() {
      * ```
      */
     preventWheel: false,
-
     /**
      * @description
      * The `readOnly` option determines whether a cell, column or comment is editable or not.
@@ -3433,8 +3402,10 @@ var _default = function _default() {
      * | `false` (default) | Set as editable                                                                                                           |
      * | `true`            | - Set as read-only<br>- Add the [`readOnlyCellClassName`](#readOnlyCellClassName) CSS class name (by default: `htDimmed`) |
      *
+     * `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}
@@ -3448,7 +3419,6 @@ var _default = function _default() {
      * ```
      */
     readOnly: false,
-
     /**
      * The `readOnlyCellClassName` option lets you add a CSS class name to [read-only](#readOnly) cells.
      *
@@ -3477,7 +3447,6 @@ var _default = function _default() {
      * ```
      */
     readOnlyCellClassName: 'htDimmed',
-
     /**
      * The `renderAllRows` option configures Handsontable's [row virtualization](@/guides/rows/row-virtualization.md).
      *
@@ -3503,7 +3472,6 @@ var _default = function _default() {
      * ```
      */
     renderAllRows: void 0,
-
     /**
      * @description
      * The `renderer` option sets a [cell renderer](@/guides/cell-functions/cell-renderer.md) for a cell.
@@ -3532,7 +3500,7 @@ var _default = function _default() {
      * 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#
@@ -3542,7 +3510,7 @@ var _default = function _default() {
      *
      * @example
      * ```js
-     * // use the `numeric` renderer for every cell of the entire grid
+     * // use the `numeric` renderer for each cell of the entire grid
      * renderer: `'numeric'`,
      *
      * // add a custom renderer function
@@ -3554,18 +3522,17 @@ var _default = function _default() {
      * // apply the `renderer` option to individual columns
      * columns: [
      *   {
-     *     // use the `autocomplete` renderer for every cell of this column
+     *     // use the `autocomplete` renderer for each cell of this column
      *     renderer: 'autocomplete'
      *   },
      *   {
-     *     // use the `myCustomRenderer` renderer for every cell of this column
+     *     // use the `myCustomRenderer` renderer for each cell of this column
      *     renderer: 'myCustomRenderer'
      *   }
      * ]
      * ```
      */
     renderer: void 0,
-
     /**
      * The `rowHeaders` option configures your grid's row headers.
      *
@@ -3601,7 +3568,6 @@ var _default = function _default() {
      * ```
      */
     rowHeaders: void 0,
-
     /**
      * @description
      * The `rowHeaderWidth` option configures the width of row headers.
@@ -3628,7 +3594,6 @@ var _default = function _default() {
      * ```
      */
     rowHeaderWidth: void 0,
-
     /**
      * The `rowHeights` option sets rows' heights, in pixels.
      *
@@ -3675,7 +3640,6 @@ var _default = function _default() {
      * ```
      */
     rowHeights: void 0,
-
     /**
      * @description
      * The `search` option configures the [`Search`](@/api/search.md) plugin.
@@ -3727,7 +3691,6 @@ var _default = function _default() {
      * ```
      */
     search: false,
-
     /**
      * @description
      * The `selectionMode` option configures how [selection](@/guides/cell-features/selection.md) works.
@@ -3761,7 +3724,6 @@ var _default = function _default() {
      * ```
      */
     selectionMode: 'multiple',
-
     /**
      * The `selectOptions` option configures options that the end user can choose from in [`select`](@/guides/cell-types/select-cell-type.md) cells.
      *
@@ -3785,7 +3747,7 @@ var _default = function _default() {
      * ```js
      * columns: [
      *   {
-     *     // set the `type` of every cell in this column to `select`
+     *     // set the `type` of each cell in this column to `select`
      *     type: 'select',
      *     // set the first option's value and label to `A`
      *     // set the second option's value and label to `B`
@@ -3793,7 +3755,7 @@ var _default = function _default() {
      *     selectOptions: ['A', 'B', 'C'],
      *   },
      *   {
-     *     // set the `type` of every cell in this column to `select`
+     *     // set the `type` of each cell in this column to `select`
      *     type: 'select',
      *     selectOptions: {
      *       // set the first option's value to `value1` and label to `Label 1`
@@ -3805,7 +3767,7 @@ var _default = function _default() {
      *     },
      *   },
      *   {
-     *     // set the `type` of every cell in this column to `select`
+     *     // set the `type` of each cell in this column to `select`
      *     type: 'select',
      *     // set `selectOption` to a function that returns available options as an object
      *     selectOptions(visualRow, visualColumn, prop) {
@@ -3819,7 +3781,6 @@ var _default = function _default() {
      * ```
      */
     selectOptions: void 0,
-
     /**
      * @description
      * The `skipColumnOnPaste` option determines whether you can paste data into a given column.
@@ -3834,7 +3795,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/setting-options.md#setting-column-options)
+     * - [Configuration options: Setting column options](@/guides/getting-started/configuration-options.md#setting-column-options)
      *
      * @memberof Options#
      * @type {boolean}
@@ -3852,7 +3813,6 @@ var _default = function _default() {
      * ```
      */
     skipColumnOnPaste: false,
-
     /**
      * @description
      *
@@ -3868,7 +3828,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/setting-options.md#setting-row-options)
+     * - [Configuration options: Setting row options](@/guides/getting-started/configuration-options.md#setting-row-options)
      *
      * @memberof Options#
      * @type {boolean}
@@ -3890,7 +3850,6 @@ var _default = function _default() {
      * ```
      */
     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.
@@ -3914,7 +3873,7 @@ var _default = function _default() {
      * @example
      * ```js
      * columns: [{
-     *   // set the `type` of every cell in this column to `autocomplete`
+     *   // set the `type` of each cell in this column to `autocomplete`
      *   type: 'autocomplete',
      *   // set options available in every `autocomplete` cell of this column
      *   source: ['D', 'C', 'B', 'A'],
@@ -3924,7 +3883,6 @@ var _default = function _default() {
      * ```
      */
     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.
@@ -3951,7 +3909,7 @@ var _default = function _default() {
      * ```js
      * // set `source` to an array
      * columns: [{
-     *   // set the `type` of every cell in this column to `autocomplete`
+     *   // set the `type` of each cell in this column to `autocomplete`
      *   type: 'autocomplete',
      *   // set options available in every `autocomplete` cell of this column
      *   source: ['A', 'B', 'C', 'D']
@@ -3959,7 +3917,7 @@ var _default = function _default() {
      *
      * // set `source` to a function
      * columns: [{
-     *   // set the `type` of every cell in this column to `autocomplete`
+     *   // set the `type` of each cell in this column to `autocomplete`
      *   type: 'autocomplete',
      *   // for every `autocomplete` cell in this column, fetch data from an external source
      *   source(query, callback) {
@@ -3971,7 +3929,6 @@ var _default = function _default() {
      * ```
      */
     source: void 0,
-
     /**
      * @description
      * If the [`data`](#data) option is not set, the `startCols` option sets the initial number of empty columns.
@@ -3990,7 +3947,6 @@ var _default = function _default() {
      * ```
      */
     startCols: 5,
-
     /**
      * @description
      * If the [`data`](#data) option is not set, the `startRows` option sets the initial number of empty rows.
@@ -4009,7 +3965,6 @@ var _default = function _default() {
      * ```
      */
     startRows: 5,
-
     /**
      * @description
      * The `stretchH` option determines what happens when the declared grid width
@@ -4039,7 +3994,6 @@ var _default = function _default() {
      * ```
      */
     stretchH: 'none',
-
     /**
      * The `strict` option configures the behavior of [`autocomplete`](@/guides/cell-types/autocomplete-cell-type.md) cells.
      *
@@ -4063,7 +4017,7 @@ var _default = function _default() {
      * ```js
      * columns: [
      *   {
-     *   // set the `type` of every cell in this column to `autocomplete`
+     *   // set the `type` of each cell in this column to `autocomplete`
      *   type: 'autocomplete',
      *   // set options available in every `autocomplete` cell of this column
      *   source: ['A', 'B', 'C'],
@@ -4074,7 +4028,6 @@ var _default = function _default() {
      * ```
      */
     strict: void 0,
-
     /**
      * The `tableClassName` option lets you add CSS class names
      * to every Handsontable instance inside the `container` element.
@@ -4115,7 +4068,6 @@ var _default = function _default() {
      * ```
      */
     tableClassName: void 0,
-
     /**
      * The `tabMoves` option configures the action of the <kbd>**Tab**</kbd> key.
      *
@@ -4150,7 +4102,6 @@ var _default = function _default() {
       row: 0,
       col: 1
     },
-
     /**
      * @description
      * The `title` option configures [column header](@/guides/columns/column-header.md) names.
@@ -4183,7 +4134,6 @@ var _default = function _default() {
      * ```
      */
     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.
@@ -4209,13 +4159,13 @@ var _default = function _default() {
      * columns: [
      *   {
      *     type: 'autocomplete',
-     *     // for every cell of this column
+     *     // for each cell of this column
      *     // make the `autocomplete` list's width the same as the edited cell's width
      *     trimDropdown: true,
      *   },
      *   {
      *     type: 'dropdown',
-     *     // for every cell of this column
+     *     // for each cell of this column
      *     // scale the `dropdown` list's width to the list's content
      *     trimDropdown: false,
      *   }
@@ -4223,18 +4173,17 @@ var _default = function _default() {
      * ```
      */
     trimDropdown: true,
-
     /**
      * @description
      * The `trimRows` option configures the [`TrimRows`](@/api/trimRows.md) plugin.
      *
      * You can set the `trimRows` option to one of the following:
      *
-     * | Setting  | Description                                                                                   |
-     * | -------- | --------------------------------------------------------------------------------------------- |
-     * | `false`  | Disable the [`TrimRows`](@/api/trimRows.md) plugin                                            |
-     * | `true`   | Enable the [`TrimRows`](@/api/trimRows.md) plugin                                             |
-     * | An array | - Enable the [`TrimRows`](@/api/trimRows.md) plugin<br>- Trim selected rows at initialization |
+     * | Setting                          | Description                                                                                   |
+     * | -------------------------------- | --------------------------------------------------------------------------------------------- |
+     * | `false`                          | Disable the [`TrimRows`](@/api/trimRows.md) plugin                                            |
+     * | `true`                           | Enable the [`TrimRows`](@/api/trimRows.md) plugin                                             |
+     * | An array of physical row indexes | - Enable the [`TrimRows`](@/api/trimRows.md) plugin<br>- Trim selected rows at initialization |
      *
      * Read more:
      * - [Plugins: `TrimRows`](@/api/trimRows.md)
@@ -4251,23 +4200,23 @@ var _default = function _default() {
      * trimRows: true,
      *
      * // enable the `TrimRows` plugin
-     * // trim rows 5, 10, and 15 at Handsontable's initialization
+     * // at Handsontable's initialization, trim rows 5, 10, and 15
      * trimRows: [5, 10, 15],
      * ```
      */
     trimRows: void 0,
-
     /**
-     * The `trimWhitespace` option configures automatic whitespace removal.
+     * The `trimWhitespace` option configures automatic whitespace removal. This option
+     * affects the cell renderer and the cell editor.
      *
      * You can set the `trimWhitespace` option to one of the following:
      *
      * | Setting          | Description                                                     |
      * | ---------------- | --------------------------------------------------------------- |
-     * | `true` (default) | Remove whitespace at the beginning and at the end of every cell |
+     * | `true` (default) | Remove whitespace at the beginning and at the end of each cell |
      * | `false`          | Don't remove whitespace                                         |
      *
-     * @memberof Options#tr
+     * @memberof Options#
      * @type {boolean}
      * @default true
      * @category Core
@@ -4284,7 +4233,6 @@ var _default = function _default() {
      * ```
      */
     trimWhitespace: true,
-
     /**
      * @description
      * The `type` option lets you set the [`renderer`](#renderer), [`editor`](#editor), and [`validator`](#validator)
@@ -4310,7 +4258,7 @@ var _default = function _default() {
      * - [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)
@@ -4322,24 +4270,23 @@ var _default = function _default() {
      *
      * @example
      * ```js
-     * // use the `numeric` cell type for every cell of the entire grid
+     * // set the `numeric` cell type for each cell of the entire grid
      * type: `'numeric'`,
      *
      * // apply the `type` option to individual columns
      * columns: [
      *   {
-     *     // use the `autocomplete` cell type for every cell of this column
+     *     // set the `autocomplete` cell type for each cell of this column
      *     type: 'autocomplete'
      *   },
      *   {
-     *     // use the `myCustomCellType` cell type for every cell of this column
+     *     // set the `myCustomCellType` cell type for each cell of this column
      *     type: 'myCustomCellType'
      *   }
      * ]
      * ```
      */
     type: 'text',
-
     /**
      * The `uncheckedTemplate` option lets you configure what value
      * an unchecked [`checkbox`](@/guides/cell-types/checkbox-cell-type.md) cell has.
@@ -4365,13 +4312,13 @@ var _default = function _default() {
      * ```js
      * columns: [
      *   {
-     *     // set the `type` of every cell in this column to `checkbox`
+     *     // set the `type` of each cell in this column to `checkbox`
      *     // when unchecked, the cell's value is `false`
      *     // when checked, the cell's value is `true`
      *     type: 'checkbox',
      *   },
      *   {
-     *     // set the `type` of every cell in this column to `checkbox`
+     *     // set the `type` of each cell in this column to `checkbox`
      *     // when unchecked, the cell's value is `'No'`
      *     // when checked, the cell's value is `'Yes'`
      *     type: 'checkbox',
@@ -4382,7 +4329,6 @@ var _default = function _default() {
      * ```
      */
     uncheckedTemplate: void 0,
-
     /**
      * The `undo` option configures the [`UndoRedo`](@/api/undoRedo.md) plugin.
      *
@@ -4413,7 +4359,6 @@ var _default = function _default() {
      * ```
      */
     undo: void 0,
-
     /**
      * @description
      * The `validator` option sets a [cell validator](@/guides/cell-functions/cell-validator.md) for a cell.
@@ -4444,7 +4389,7 @@ var _default = function _default() {
      * 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#
@@ -4473,7 +4418,6 @@ var _default = function _default() {
      * ```
      */
     validator: void 0,
-
     /**
      * @description
      * The `viewportColumnRenderingOffset` option configures the number of columns
@@ -4501,7 +4445,6 @@ var _default = function _default() {
      * ```
      */
     viewportColumnRenderingOffset: 'auto',
-
     /**
      * @description
      * The `viewportRowRenderingOffset` option configures the number of rows
@@ -4530,7 +4473,6 @@ var _default = function _default() {
      * ```
      */
     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.
@@ -4552,20 +4494,19 @@ var _default = function _default() {
      *   {
      *     type: 'autocomplete',
      *     // set the `autocomplete` list's height to 15 options
-     *     // for every cell of this column
+     *     // for each cell of this column
      *     visibleRows: 15,
      *   },
      *   {
      *     type: 'dropdown',
      *     // set the `dropdown` list's height to 5 options
-     *     // for every cell of this column
+     *     // for each cell of this column
      *     visibleRows: 5,
      *   }
      * ],
      * ```
      */
     visibleRows: 10,
-
     /**
      * The `width` option configures the width of your grid.
      *
@@ -4600,7 +4541,6 @@ var _default = function _default() {
      * ```
      */
     width: void 0,
-
     /**
      * The `wordWrap` option configures whether content that exceeds a column's width is wrapped or not.
      *
@@ -4639,9 +4579,8 @@ var _default = function _default() {
      * ```
      */
     wordWrap: true
-    /* eslint-enable jsdoc/require-description-complete-sentence */
 
+    /* eslint-enable jsdoc/require-description-complete-sentence */
   };
 };
-
 exports.default = _default;