handsontable 12.1.2 → 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`
@@ -101,10 +134,14 @@ export default (function () {
      *
      * 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}
@@ -113,22 +150,21 @@ export default (function () {
      *
      * @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
@@ -157,7 +193,7 @@ export default (function () {
      * ```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>']
@@ -168,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**
@@ -186,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**
@@ -204,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).
@@ -237,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**
@@ -257,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**
@@ -277,7 +308,6 @@ export default (function () {
      * ```
      */
     allowRemoveRow: true,
-
     /**
      * The `autoColumnSize` option configures the [`AutoColumnSize`](@/api/autoColumnSize.md) plugin.
      *
@@ -328,7 +358,6 @@ export default (function () {
      * ```
      */
     autoColumnSize: void 0,
-
     /**
      * The `autoRowSize` option configures the [`AutoRowSize`](@/api/autoRowSize.md) plugin.
      *
@@ -368,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.
      *
@@ -391,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.
      *
@@ -414,7 +441,6 @@ export default (function () {
      * ```
      */
     autoWrapRow: false,
-
     /**
      * @description
      * The `bindRowsWithHeaders` option configures the [`BindRowsWithHeaders`](@/api/bindRowsWithHeaders.md) plugin.
@@ -441,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#
@@ -471,10 +496,9 @@ export default (function () {
      * ```
      */
     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)).
@@ -487,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)
      *
@@ -514,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.
@@ -540,13 +563,13 @@ export default (function () {
      * ```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',
@@ -557,7 +580,6 @@ export default (function () {
      * ```
      */
     checkedTemplate: void 0,
-
     /**
      * The `className` option lets you add CSS class names to every currently-selected element.
      *
@@ -568,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)
@@ -600,7 +627,6 @@ export default (function () {
      * ```
      */
     className: void 0,
-
     /**
      * The `colHeaders` option configures your grid's column headers.
      *
@@ -636,7 +662,6 @@ export default (function () {
      * ```
      */
     colHeaders: null,
-
     /**
      * @description
      * The `collapsibleColumns` option configures the [`CollapsibleColumns`](@/api/collapsibleColumns.md) plugin.
@@ -670,7 +695,6 @@ export default (function () {
      * ```
      */
     collapsibleColumns: void 0,
-
     /**
      * @description
      * The `columnHeaderHeight` option configures the height of column headers.
@@ -697,24 +721,24 @@ export default (function () {
      * ```
      */
     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}
@@ -750,7 +774,6 @@ export default (function () {
      * ```
      */
     columns: void 0,
-
     /**
      * @description
      * The `columnSorting` option configures the [`ColumnSorting`](@/api/columnSorting.md) plugin.
@@ -830,7 +853,6 @@ export default (function () {
      * ```
      */
     columnSorting: void 0,
-
     /**
      * @description
      * The `columnSummary` option configures the [`ColumnSummary`](@/api/columnSummary.md) plugin.
@@ -885,7 +907,6 @@ export default (function () {
      * ```
      */
     columnSummary: void 0,
-
     /**
      * The `colWidths` option sets columns' widths, in pixels.
      *
@@ -933,7 +954,6 @@ export default (function () {
      * ```
      */
     colWidths: void 0,
-
     /**
      * The `commentedCellClassName` option lets you add a CSS class name to cells
      * that have comments.
@@ -960,12 +980,11 @@ export default (function () {
      * @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.
@@ -1020,7 +1039,6 @@ export default (function () {
      * ```
      */
     comments: false,
-
     /**
      * @description
      * The `contextMenu` option configures the [`ContextMenu`](@/api/contextMenu.md) plugin.
@@ -1083,21 +1101,20 @@ export default (function () {
      * ```
      */
     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#
@@ -1107,17 +1124,17 @@ export default (function () {
      *
      * @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
      *   }
      * ]
@@ -1134,7 +1151,6 @@ export default (function () {
      * ```
      */
     copyable: true,
-
     /**
      * The `copyPaste` option configures the [`CopyPaste`](@/api/copyPaste.md) plugin.
      *
@@ -1183,17 +1199,22 @@ export default (function () {
      * ```
      */
     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.
      *
-     * | 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 |
+     * 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.
+     *
+     * 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#
@@ -1205,21 +1226,29 @@ export default (function () {
      * ```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)
@@ -1241,12 +1270,11 @@ export default (function () {
      * @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.
@@ -1275,10 +1303,9 @@ export default (function () {
      * ```
      */
     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)
@@ -1300,12 +1327,11 @@ export default (function () {
      * @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.
@@ -1418,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.
@@ -1429,9 +1454,13 @@ export default (function () {
      * - 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[]}
@@ -1458,18 +1487,24 @@ export default (function () {
      * ```
      */
     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
      *
@@ -1490,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.
      *
@@ -1512,7 +1546,7 @@ export default (function () {
      * ```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',
@@ -1521,18 +1555,17 @@ 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.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 |
      * | -------------------- | ---------------------- |
@@ -1543,7 +1576,7 @@ export default (function () {
      * - [`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}
@@ -1551,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.
@@ -1571,7 +1603,7 @@ export default (function () {
      * ```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'
@@ -1580,7 +1612,6 @@ export default (function () {
      * ```
      */
     defaultDate: void 0,
-
     /**
      * @description
      * The `disableVisualSelection` option configures how
@@ -1624,7 +1655,6 @@ export default (function () {
      * ```
      */
     disableVisualSelection: false,
-
     /**
      * @description
      * The `dragToScroll` option configures the [`DragToScroll`](@/api/dragToScroll.md) plugin.
@@ -1651,7 +1681,6 @@ export default (function () {
      * ```
      */
     dragToScroll: true,
-
     /**
      * The `dropdownMenu` option configures the [`DropdownMenu`](@/api/dropdownMenu.md) plugin.
      *
@@ -1710,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.
      *
@@ -1742,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#
@@ -1752,24 +1780,23 @@ export default (function () {
      *
      * @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.
      *
@@ -1799,7 +1826,6 @@ export default (function () {
      * ```
      */
     enterBeginsEditing: true,
-
     /**
      * The `enterMoves` option configures the action of the <kbd>**Enter**</kbd> key.
      *
@@ -1843,7 +1869,6 @@ export default (function () {
       col: 0,
       row: 1
     },
-
     /**
      * The `fillHandle` option configures the [Autofill](@/api/autofill.md) plugin.
      *
@@ -1903,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.
@@ -1928,7 +1952,7 @@ export default (function () {
      * @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'],
@@ -1940,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.
@@ -1975,7 +1998,6 @@ export default (function () {
      * ```
      */
     filteringCaseSensitive: false,
-
     /**
      * The `filters` option configures the [`Filters`](@/api/filters.md) plugin.
      *
@@ -2003,7 +2025,6 @@ export default (function () {
      * ```
      */
     filters: void 0,
-
     /**
      * `fixedColumnsLeft` is a legacy option.
      *
@@ -2028,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.
      *
@@ -2067,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.
@@ -2087,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.
      *
@@ -2106,7 +2124,6 @@ export default (function () {
      * ```
      */
     fixedRowsTop: 0,
-
     /**
      * The `formulas` option configures the [`Formulas`](@/api/formulas.md) plugin.
      *
@@ -2186,7 +2203,6 @@ export default (function () {
      * ```
      */
     formulas: void 0,
-
     /**
      * The `fragmentSelection` option configures text selection settings.
      *
@@ -2213,7 +2229,6 @@ export default (function () {
      * ```
      */
     fragmentSelection: false,
-
     /**
      * The `height` option configures the height of your grid.
      *
@@ -2248,7 +2263,6 @@ export default (function () {
      * ```
      */
     height: void 0,
-
     /**
      * The `hiddenColumns` option configures the [`HiddenColumns`](@/api/hiddenColumns.md) plugin.
      *
@@ -2294,7 +2308,6 @@ export default (function () {
      * ```
      */
     hiddenColumns: void 0,
-
     /**
      * The `hiddenRows` option configures the [`HiddenRows`](@/api/hiddenRows.md) plugin.
      *
@@ -2340,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).
@@ -2370,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.
@@ -2391,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.
@@ -2428,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.
@@ -2482,7 +2482,6 @@ export default (function () {
      * ```
      */
     label: void 0,
-
     /**
      * The `language` option configures Handsontable's [language](@/guides/internationalization/language.md) settings.
      *
@@ -2527,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:
@@ -2573,7 +2571,6 @@ export default (function () {
      * ```
      */
     layoutDirection: 'inherit',
-
     /**
      * The `licenseKey` option sets your Handsontable license key.
      *
@@ -2602,7 +2599,6 @@ export default (function () {
      * ```
      */
     licenseKey: void 0,
-
     /**
      * The `locale` option configures Handsontable's [locale](@/guides/internationalization/locale.md) settings.
      *
@@ -2639,7 +2635,6 @@ export default (function () {
      * ```
      */
     locale: 'en-US',
-
     /**
      * The `manualColumnFreeze` option configures the [`ManualColumnFreeze`](@/api/manualColumnFreeze.md) plugin.
      *
@@ -2665,7 +2660,6 @@ export default (function () {
      * ```
      */
     manualColumnFreeze: void 0,
-
     /**
      * The `manualColumnMove` option configures the [`ManualColumnMove`](@/api/manualColumnMove.md) plugin.
      *
@@ -2698,7 +2692,6 @@ export default (function () {
      * ```
      */
     manualColumnMove: void 0,
-
     /**
      * @description
      * The `manualColumnResize` option configures the [`ManualColumnResize`](@/api/manualColumnResize.md) plugin.
@@ -2732,7 +2725,6 @@ export default (function () {
      * ```
      */
     manualColumnResize: void 0,
-
     /**
      * @description
      * The `manualRowMove` option configures the [`ManualRowMove`](@/api/manualRowMove.md) plugin.
@@ -2766,7 +2758,6 @@ export default (function () {
      * ```
      */
     manualRowMove: void 0,
-
     /**
      * @description
      * The `manualRowResize` option configures the [`ManualRowResize`](@/api/manualRowResize.md) plugin.
@@ -2800,7 +2791,6 @@ export default (function () {
      * ```
      */
     manualRowResize: void 0,
-
     /**
      * The `maxCols` option sets a maximum number of columns.
      *
@@ -2821,7 +2811,6 @@ export default (function () {
      * ```
      */
     maxCols: Infinity,
-
     /**
      * The `maxRows` option sets a maximum number of rows.
      *
@@ -2842,7 +2831,6 @@ export default (function () {
      * ```
      */
     maxRows: Infinity,
-
     /**
      * @description
      * The `mergeCells` option configures the [`MergeCells`](@/api/mergeCells.md) plugin.
@@ -2891,7 +2879,6 @@ export default (function () {
      * ```
      */
     mergeCells: false,
-
     /**
      * The `minCols` option sets a minimum number of columns.
      *
@@ -2919,7 +2906,6 @@ export default (function () {
      * ```
      */
     minCols: 0,
-
     /**
      * The `minRows` option sets a minimum number of rows.
      *
@@ -2940,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.
@@ -2969,7 +2954,6 @@ export default (function () {
      * ```
      */
     minSpareCols: 0,
-
     /**
      * The `minSpareRows` option sets a minimum number of empty rows
      * at the bottom of the grid.
@@ -2991,7 +2975,6 @@ export default (function () {
      * ```
      */
     minSpareRows: 0,
-
     /**
      * @description
      * The `multiColumnSorting` option configures the [`MultiColumnSorting`](@/api/columnSorting.md) plugin.
@@ -3070,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                                                                                  |
      * | ------------- | -------------------------------------------------------------------------------------------- |
@@ -3089,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
      *
@@ -3103,7 +3093,6 @@ export default (function () {
      * ```
      */
     nestedHeaders: void 0,
-
     /**
      * @description
      * The `nestedRows` option configures the [`NestedRows`](@/api/nestedRows.md) plugin.
@@ -3130,10 +3119,9 @@ export default (function () {
      * @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)
@@ -3155,15 +3143,15 @@ export default (function () {
      * @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:
      *
@@ -3172,10 +3160,7 @@ export default (function () {
      * | `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.
      *
@@ -3193,7 +3178,7 @@ export default (function () {
      * ```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: {
@@ -3207,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.
@@ -3224,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.
@@ -3262,7 +3245,6 @@ export default (function () {
      * ```
      */
     outsideClickDeselects: true,
-
     /**
      * @description
      * The `persistentState` option configures the [`PersistentState`](@/api/persistentState.md) plugin.
@@ -3290,7 +3272,6 @@ export default (function () {
      * ```
      */
     persistentState: void 0,
-
     /**
      * The `placeholder` option lets you display placeholder text in every empty cell.
      *
@@ -3328,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.
@@ -3354,12 +3334,11 @@ export default (function () {
      * @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.
@@ -3384,7 +3363,6 @@ export default (function () {
      * ```
      */
     preventOverflow: false,
-
     /**
      * The `preventWheel` option configures preventing the `wheel` event's default action
      * on overlays.
@@ -3409,7 +3387,6 @@ export default (function () {
      * ```
      */
     preventWheel: false,
-
     /**
      * @description
      * The `readOnly` option determines whether a cell, column or comment is editable or not.
@@ -3421,8 +3398,10 @@ export default (function () {
      * | `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}
@@ -3436,7 +3415,6 @@ export default (function () {
      * ```
      */
     readOnly: false,
-
     /**
      * The `readOnlyCellClassName` option lets you add a CSS class name to [read-only](#readOnly) cells.
      *
@@ -3465,7 +3443,6 @@ export default (function () {
      * ```
      */
     readOnlyCellClassName: 'htDimmed',
-
     /**
      * The `renderAllRows` option configures Handsontable's [row virtualization](@/guides/rows/row-virtualization.md).
      *
@@ -3491,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.
@@ -3520,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#
@@ -3530,7 +3506,7 @@ export default (function () {
      *
      * @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
@@ -3542,18 +3518,17 @@ export default (function () {
      * // 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.
      *
@@ -3589,7 +3564,6 @@ export default (function () {
      * ```
      */
     rowHeaders: void 0,
-
     /**
      * @description
      * The `rowHeaderWidth` option configures the width of row headers.
@@ -3616,7 +3590,6 @@ export default (function () {
      * ```
      */
     rowHeaderWidth: void 0,
-
     /**
      * The `rowHeights` option sets rows' heights, in pixels.
      *
@@ -3663,7 +3636,6 @@ export default (function () {
      * ```
      */
     rowHeights: void 0,
-
     /**
      * @description
      * The `search` option configures the [`Search`](@/api/search.md) plugin.
@@ -3715,7 +3687,6 @@ export default (function () {
      * ```
      */
     search: false,
-
     /**
      * @description
      * The `selectionMode` option configures how [selection](@/guides/cell-features/selection.md) works.
@@ -3749,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.
      *
@@ -3773,7 +3743,7 @@ export default (function () {
      * ```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`
@@ -3781,7 +3751,7 @@ export default (function () {
      *     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`
@@ -3793,7 +3763,7 @@ export default (function () {
      *     },
      *   },
      *   {
-     *     // 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) {
@@ -3807,7 +3777,6 @@ export default (function () {
      * ```
      */
     selectOptions: void 0,
-
     /**
      * @description
      * The `skipColumnOnPaste` option determines whether you can paste data into a given column.
@@ -3822,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}
@@ -3840,7 +3809,6 @@ export default (function () {
      * ```
      */
     skipColumnOnPaste: false,
-
     /**
      * @description
      *
@@ -3856,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}
@@ -3878,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.
@@ -3902,7 +3869,7 @@ export default (function () {
      * @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'],
@@ -3912,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.
@@ -3939,7 +3905,7 @@ export default (function () {
      * ```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']
@@ -3947,7 +3913,7 @@ export default (function () {
      *
      * // 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) {
@@ -3959,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.
@@ -3978,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.
@@ -3997,7 +3961,6 @@ export default (function () {
      * ```
      */
     startRows: 5,
-
     /**
      * @description
      * The `stretchH` option determines what happens when the declared grid width
@@ -4027,7 +3990,6 @@ export default (function () {
      * ```
      */
     stretchH: 'none',
-
     /**
      * The `strict` option configures the behavior of [`autocomplete`](@/guides/cell-types/autocomplete-cell-type.md) cells.
      *
@@ -4051,7 +4013,7 @@ export default (function () {
      * ```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'],
@@ -4062,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.
@@ -4103,7 +4064,6 @@ export default (function () {
      * ```
      */
     tableClassName: void 0,
-
     /**
      * The `tabMoves` option configures the action of the <kbd>**Tab**</kbd> key.
      *
@@ -4138,7 +4098,6 @@ export default (function () {
       row: 0,
       col: 1
     },
-
     /**
      * @description
      * The `title` option configures [column header](@/guides/columns/column-header.md) names.
@@ -4171,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.
@@ -4197,13 +4155,13 @@ export default (function () {
      * 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,
      *   }
@@ -4211,18 +4169,17 @@ export default (function () {
      * ```
      */
     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)
@@ -4239,23 +4196,23 @@ export default (function () {
      * 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
@@ -4272,7 +4229,6 @@ export default (function () {
      * ```
      */
     trimWhitespace: true,
-
     /**
      * @description
      * The `type` option lets you set the [`renderer`](#renderer), [`editor`](#editor), and [`validator`](#validator)
@@ -4298,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)
@@ -4310,24 +4266,23 @@ export default (function () {
      *
      * @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.
@@ -4353,13 +4308,13 @@ export default (function () {
      * ```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',
@@ -4370,7 +4325,6 @@ export default (function () {
      * ```
      */
     uncheckedTemplate: void 0,
-
     /**
      * The `undo` option configures the [`UndoRedo`](@/api/undoRedo.md) plugin.
      *
@@ -4401,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.
@@ -4432,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#
@@ -4461,7 +4414,6 @@ export default (function () {
      * ```
      */
     validator: void 0,
-
     /**
      * @description
      * The `viewportColumnRenderingOffset` option configures the number of columns
@@ -4489,7 +4441,6 @@ export default (function () {
      * ```
      */
     viewportColumnRenderingOffset: 'auto',
-
     /**
      * @description
      * The `viewportRowRenderingOffset` option configures the number of rows
@@ -4518,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.
@@ -4540,20 +4490,19 @@ export default (function () {
      *   {
      *     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.
      *
@@ -4588,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.
      *
@@ -4627,7 +4575,7 @@ export default (function () {
      * ```
      */
     wordWrap: true
-    /* eslint-enable jsdoc/require-description-complete-sentence */
 
+    /* eslint-enable jsdoc/require-description-complete-sentence */
   };
 });