handsontable 12.2.0 → 12.3.0-next-9dc4f5d-20221209

package/mixins/localHooks.js

@@ -22,7 +22,8 @@ var localHooks = {
    * @param {string} key The hook name.
    * @param {Function} callback The hook callback.
    * @returns {object}
-   */addLocalHook: function addLocalHook(key, callback) {
+   */
+  addLocalHook: function addLocalHook(key, callback) {
     if (!this._localHooks[key]) {
       this._localHooks[key] = [];
     }
@@ -39,7 +40,8 @@ var localHooks = {
    * @param {*} [arg4] An additional parameter passed to the callback function.
    * @param {*} [arg5] An additional parameter passed to the callback function.
    * @param {*} [arg6] An additional parameter passed to the callback function.
-   */runLocalHooks: function runLocalHooks(key, arg1, arg2, arg3, arg4, arg5, arg6) {
+   */
+  runLocalHooks: function runLocalHooks(key, arg1, arg2, arg3, arg4, arg5, arg6) {
     if (this._localHooks[key]) {
       var length = this._localHooks[key].length;
 
@@ -55,7 +57,8 @@ var localHooks = {
    * Clear all added hooks.
    *
    * @returns {object}
-   */clearLocalHooks: function clearLocalHooks() {
+   */
+  clearLocalHooks: function clearLocalHooks() {
     this._localHooks = {};
     return this;
   }

package/mixins/localHooks.mjs

@@ -18,7 +18,8 @@ var localHooks = {
    * @param {string} key The hook name.
    * @param {Function} callback The hook callback.
    * @returns {object}
-   */addLocalHook: function addLocalHook(key, callback) {
+   */
+  addLocalHook: function addLocalHook(key, callback) {
     if (!this._localHooks[key]) {
       this._localHooks[key] = [];
     }
@@ -35,7 +36,8 @@ var localHooks = {
    * @param {*} [arg4] An additional parameter passed to the callback function.
    * @param {*} [arg5] An additional parameter passed to the callback function.
    * @param {*} [arg6] An additional parameter passed to the callback function.
-   */runLocalHooks: function runLocalHooks(key, arg1, arg2, arg3, arg4, arg5, arg6) {
+   */
+  runLocalHooks: function runLocalHooks(key, arg1, arg2, arg3, arg4, arg5, arg6) {
     if (this._localHooks[key]) {
       var length = this._localHooks[key].length;
 
@@ -51,7 +53,8 @@ var localHooks = {
    * Clear all added hooks.
    *
    * @returns {object}
-   */clearLocalHooks: function clearLocalHooks() {
+   */
+  clearLocalHooks: function clearLocalHooks() {
     this._localHooks = {};
     return this;
   }

package/package.json

@@ -10,7 +10,7 @@
     "url": "https://github.com/handsontable/handsontable/issues"
   },
   "author": "Handsoncode <hello@handsontable.com>",
-  "version": "12.2.0",
+  "version": "12.3.0-next-9dc4f5d-20221209",
   "main": "index",
   "module": "index.mjs",
   "jsnext:main": "index.mjs",
@@ -93,7 +93,7 @@
     "on-build-webpack": "^0.1.0",
     "optimize-css-assets-webpack-plugin": "^5.0.1",
     "progress-bar-webpack-plugin": "^1.10.0",
-    "puppeteer": "^10.2.0",
+    "puppeteer": "^19.2.2",
     "replace-in-file": "^6.1.0",
     "rimraf": "^2.5.4",
     "sass": "^1.3.0",

package/pluginHooks.d.ts

@@ -65,13 +65,15 @@ export interface Events {
   afterChangesObserved?: () => void;
   afterColumnCollapse?: (currentCollapsedColumns: number[], destinationCollapsedColumns: number[], collapsePossible: boolean, successfullyCollapsed: boolean) => void;
   afterColumnExpand?: (currentCollapsedColumns: number[], destinationCollapsedColumns: number[], expandPossible: boolean, successfullyExpanded: boolean) => void;
+  afterColumnFreeze?: (columnIndex: number, isFreezingPerformed: boolean) => void;
   afterColumnMove?: (movedColumns: number[], finalIndex: number, dropIndex: number | undefined, movePossible: boolean, orderChanged: boolean) => void;
   afterColumnResize?: (newSize: number, column: number, isDoubleClick: boolean) => void;
   afterColumnSort?: (currentSortConfig: ColumnSortingConfig[], destinationSortConfigs: ColumnSortingConfig[]) => void;
+  afterColumnUnfreeze?: (columnIndex: number, isUnfreezingPerformed: boolean) => void;
   afterContextMenuDefaultOptions?: (predefinedItems: Array<ContextMenuPredefinedMenuItemKey | ContextMenuMenuItemConfig>) => void;
   afterContextMenuHide?: (context: ContextMenu) => void;
   afterContextMenuShow?: (context: ContextMenu) => void;
-  afterCopy?: (data: CellValue[][], coords: RangeType[]) => void;
+  afterCopy?: (data: CellValue[][], coords: RangeType[], copiedHeadersCount: { columnHeadersCount: number }) => void;
   afterCopyLimit?: (selectedRows: number, selectedColumns: number, copyRowsLimit: number, copyColumnsLimit: number) => void;
   afterCreateCol?: (index: number, amount: number, source?: ChangeSource) => void;
   afterCreateRow?: (index: number, amount: number, source?: ChangeSource) => void;
@@ -158,12 +160,14 @@ export interface Events {
   beforeChangeRender?: (changes: CellChange[], source: ChangeSource) => void;
   beforeColumnCollapse?: (currentCollapsedColumn: number[], destinationCollapsedColumns: number[], collapsePossible: boolean) => void | boolean;
   beforeColumnExpand?: (currentCollapsedColumn: number[], destinationCollapsedColumns: number[], expandPossible: boolean) => void | boolean;
+  beforeColumnFreeze?: (columnIndex: number, isFreezingPerformed: boolean) => void | boolean;
   beforeColumnMove?: (movedColumns: number[], finalIndex: number, dropIndex: number | undefined, movePossible: boolean) => void | boolean;
   beforeColumnResize?: (newSize: number, column: number, isDoubleClick: boolean) => void | number;
   beforeColumnSort?: (currentSortConfig: ColumnSortingConfig[], destinationSortConfigs: ColumnSortingConfig[]) => void | boolean;
+  beforeColumnUnfreeze?: (columnIndex: number, isUnfreezingPerformed: boolean) => void | boolean;
   beforeContextMenuSetItems?: (menuItems: ContextMenuMenuItemConfig[]) => void;
   beforeContextMenuShow?: (context: ContextMenu) => void;
-  beforeCopy?: (data: CellValue[][], coords: RangeType[]) => void | boolean;
+  beforeCopy?: (data: CellValue[][], coords: RangeType[], copiedHeadersCount: { columnHeadersCount: number }) => void | boolean;
   beforeCreateCol?: (index: number, amount: number, source?: ChangeSource) => void | boolean;
   beforeCreateRow?: (index: number, amount: number, source?: ChangeSource) => void | boolean;
   beforeCut?: (data: CellValue[][], coords: RangeType[]) => void | boolean;
@@ -223,6 +227,7 @@ export interface Events {
   modifyAutofillRange?: (startArea: Array<[number, number, number, number]>, entireArea: Array<[number, number, number, number]>) => void;
   modifyColHeader?: (column: number) => void;
   modifyColumnHeaderHeight?: () => void;
+  modifyColumnHeaderValue?: (headerValue: string, visualColumnIndex: number, headerLevel: number) => void | string;
   modifyColWidth?: (width: number, column: number) => void;
   modifyCopyableRange?: (copyableRanges: RangeType[]) => void;
   modifyData?: (row: number, column: number, valueHolder: { value: CellValue }, ioMode: 'get' | 'set') => void;

package/pluginHooks.js

@@ -1,7 +1,14 @@
 "use strict";
 
+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); }
 require("core-js/modules/es.array.slice.js");
 require("core-js/modules/es.object.freeze.js");
+require("core-js/modules/es.symbol.to-primitive.js");
+require("core-js/modules/es.date.to-primitive.js");
+require("core-js/modules/es.symbol.js");
+require("core-js/modules/es.symbol.description.js");
+require("core-js/modules/es.number.constructor.js");
+require("core-js/modules/es.symbol.iterator.js");
 exports.__esModule = true;
 exports.default = void 0;
 require("core-js/modules/es.array.iterator.js");
@@ -19,18 +26,30 @@ var _templateLiteralTag = require("./helpers/templateLiteralTag");
 var _function = require("./helpers/function");
 var _templateObject;
 function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
-function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
 function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
 function _taggedTemplateLiteral(strings, raw) { if (!raw) { raw = strings.slice(0); } return Object.freeze(Object.defineProperties(strings, { raw: { value: Object.freeze(raw) } })); }
+/* eslint-disable jsdoc/require-description-complete-sentence */
 /**
  * @description
+ *
+ * ::: only-for javascript
  * Handsontable events are the common interface that function in 2 ways: as __callbacks__ and as __hooks__.
+ * :::
+ *
+ * ::: only-for react
+ * This page lists all the **Handsontable hooks** – callbacks that let you react before or after an action occurs.
+ *
+ * Read more on the [Events and hooks](@/guides/getting-started/events-and-hooks.md) page.
+ * :::
  *
  * @example
  *
  * ::: only-for javascript
  * ```js
- * // Using events as callbacks:
+ * // using events as callbacks
  * ...
  * const hot1 = new Handsontable(document.getElementById('example1'), {
  *   afterChange: function(changes, source) {
@@ -62,7 +81,7 @@ function _taggedTemplateLiteral(strings, raw) { if (!raw) { raw = strings.slice(
  *
  * ::: only-for javascript
  * ```js
- * // Using events as plugin hooks:
+ * // using events as plugin hooks
  * ...
  * const hot1 = new Handsontable(document.getElementById('example1'), {
  *   myPlugin: true
@@ -352,13 +371,13 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
 /**
  * Fired after retrieving information about a column header and appending it to the table header.
  *
- * Since the 12.2 the hook is triggered with the 3rd `headerLevel` argument.
- *
  * @event Hooks#afterGetColHeader
  * @param {number} column Visual column index.
  * @param {HTMLTableCellElement} TH Header's TH element.
- * @param {number} [headerLevel=0] The index of header level counting from the top (positive
- *                                 values counting from 0 to N).
+ * @param {number} [headerLevel=0] (Since 12.2.0) Header level index. Accepts positive (0 to n)
+ *                                 and negative (-1 to -n) values. For positive values, 0 points to the
+ *                                 topmost header. For negative values, -1 points to the bottom-most
+ *                                 header (the header closest to the cells).
  */
 'afterGetColHeader',
 /**
@@ -1309,7 +1328,7 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  */
 'modifyCopyableRange',
 /**
- * Fired by {@link CopyPaste} plugin before copying the values into clipboard and before clearing values of
+ * Fired by {@link CopyPaste} plugin before copying the values to the clipboard and before clearing values of
  * the selected cells. This hook is fired when {@link Options#copyPaste} option is enabled.
  *
  * @event Hooks#beforeCut
@@ -1364,18 +1383,19 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  * {@link Options#copyPaste} option is enabled.
  *
  * @event Hooks#afterCut
- * @param {Array[]} data An array of arrays which contains the cutted out data.
+ * @param {Array[]} data An array of arrays with the cut data.
  * @param {object[]} coords An array of objects with ranges of the visual indexes (`startRow`, `startCol`, `endRow`, `endCol`)
  *                       which was cut out.
  */
 'afterCut',
 /**
- * Fired before values are copied into clipboard.
+ * Fired before values are copied to the clipboard.
  *
  * @event Hooks#beforeCopy
  * @param {Array[]} data An array of arrays which contains data to copied.
  * @param {object[]} coords An array of objects with ranges of the visual indexes (`startRow`, `startCol`, `endRow`, `endCol`)
  *                         which will copied.
+ * @param {{ columnHeadersCount: number }} copiedHeadersCount (Since 12.3.0) The number of copied column headers.
  * @returns {*} If returns `false` then copying is canceled.
  *
  * @example
@@ -1438,6 +1458,7 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  * @param {Array[]} data An array of arrays which contains the copied data.
  * @param {object[]} coords An array of objects with ranges of the visual indexes (`startRow`, `startCol`, `endRow`, `endCol`)
  *                         which was copied.
+ * @param {{ columnHeadersCount: number }} copiedHeadersCount (Since 12.3.0) The number of copied column headers.
  */
 'afterCopy',
 /**
@@ -1496,7 +1517,7 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  * {@link Options#copyPaste} option is enabled.
  *
  * @event Hooks#afterPaste
- * @param {Array[]} data An array of arrays which contains the pasted data.
+ * @param {Array[]} data An array of arrays with the pasted data.
  * @param {object[]} coords An array of objects with ranges of the visual indexes (`startRow`, `startCol`, `endRow`, `endCol`)
  *                       that correspond to the previously selected area.
  */
@@ -1681,13 +1702,22 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  */
 'beforeStretchingColumnWidth',
 /**
- * Fired by {@link Filters} plugin before applying [filtering](@/guides/columns/column-filter.md).
- * This hook is fired when {@link Options#filters} option is enabled.
+ * Fired by the [`Filters`](@/api/filters.md) plugin,
+ * before a [column filter](@/guides/columns/column-filter.md) gets applied.
+ *
+ * [`beforeFilter`](#beforefilter) takes one argument (`conditionsStack`), which is an array of objects.
+ * Each object represents one of your [column filters](@/api/filters.md#addcondition),
+ * and consists of the following properties:
+ *
+ * | Property     | Possible values                                                         | Description                                                                                                              |
+ * | ------------ | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+ * | `column`     | Number                                                                  | A visual index of the column to which the filter will be applied.                                                        |
+ * | `conditions` | Array of objects                                                        | Each object represents one condition. For details, see [`addCondition()`](@/api/filters.md#addcondition).                |
+ * | `operation`  | `'conjunction'` \| `'disjunction'` \| `'disjunctionWithExtraCondition'` | An operation to perform on your set of `conditions`. For details, see [`addCondition()`](@/api/filters.md#addcondition). |
+ *
+ * An example of the format of the `conditionsStack` argument:
  *
- * @event Hooks#beforeFilter
- * @param {object[]} conditionsStack An array of objects with added formulas.
  * ```js
- * // Example format of the conditionsStack argument:
  * [
  *   {
  *     column: 2,
@@ -1705,17 +1735,47 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  *   },
  * ]
  * ```
- * @returns {boolean} If hook returns `false` value then filtering won't be applied on the UI side (server-side filtering).
+ *
+ * To perform server-side filtering (i.e., to not apply filtering to Handsontable's UI),
+ * set [`beforeFilter`](#beforefilter) to return `false`:
+ *
+ * ```js
+ * new Handsontable(document.getElementById('example'), {
+ *   beforeFilter: (conditionsStack) => {
+ *     return false;
+ *   }
+ * });
+ *```
+ *
+ * Read more:
+ * - [Guides: Column filter](@/guides/columns/column-filter.md)
+ * - [Hooks: `afterFilter`](#afterfilter)
+ * - [Options: `filters`](@/api/options.md#filters)
+ * - [Plugins: `Filters`](@/api/filters.md)
+ * – [Plugin methods: `addCondition()`](@/api/filters.md#addcondition)
+ *
+ * @event Hooks#beforeFilter
+ * @param {object[]} conditionsStack An array of objects with your [column filters](@/api/filters.md#addcondition).
+ * @returns {boolean} To perform server-side filtering (i.e., to not apply filtering to Handsontable's UI), return `false`.
  */
 'beforeFilter',
 /**
- * Fired by {@link Filters} plugin after applying [filtering](@/guides/columns/column-filter.md).
- * This hook is fired when {@link Options#filters} option is enabled.
+ * Fired by the [`Filters`](@/api/filters.md) plugin,
+ * after a [column filter](@/guides/columns/column-filter.md) gets applied.
+ *
+ * [`afterFilter`](#afterfilter) takes one argument (`conditionsStack`), which is an array of objects.
+ * Each object represents one of your [column filters](@/api/filters.md#addcondition),
+ * and consists of the following properties:
+ *
+ * | Property     | Possible values                                                         | Description                                                                                                              |
+ * | ------------ | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+ * | `column`     | Number                                                                  | A visual index of the column to which the filter was applied.                                                            |
+ * | `conditions` | Array of objects                                                        | Each object represents one condition. For details, see [`addCondition()`](@/api/filters.md#addcondition).                |
+ * | `operation`  | `'conjunction'` \| `'disjunction'` \| `'disjunctionWithExtraCondition'` | An operation to perform on your set of `conditions`. For details, see [`addCondition()`](@/api/filters.md#addcondition). |
+ *
+ * An example of the format of the `conditionsStack` argument:
  *
- * @event Hooks#afterFilter
- * @param {object[]} conditionsStack An array of objects with added conditions.
  * ```js
- * // Example format of the conditionsStack argument:
  * [
  *   {
  *     column: 2,
@@ -1733,6 +1793,16 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  *   },
  * ]
  * ```
+ *
+ * Read more:
+ * - [Guides: Column filter](@/guides/columns/column-filter.md)
+ * - [Hooks: `beforeFilter`](#beforefilter)
+ * - [Options: `filters`](@/api/options.md#filters)
+ * - [Plugins: `Filters`](@/api/filters.md)
+ * – [Plugin methods: `addCondition()`](@/api/filters.md#addcondition)
+ *
+ * @event Hooks#afterFilter
+ * @param {object[]} conditionsStack An array of objects with your [column filters](@/api/filters.md#addcondition).
  */
 'afterFilter',
 /**
@@ -1803,6 +1873,20 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  * @event Hooks#modifyColumnHeaderHeight
  */
 'modifyColumnHeaderHeight',
+/**
+ * Fired while retrieving a column header's value.
+ *
+ * @since 12.3.0
+ * @event Hooks#modifyColumnHeaderValue
+ * @param {string} value A column header value.
+ * @param {number} visualColumnIndex A visual column index.
+ * @param {number} [headerLevel=0] Header level index. Accepts positive (0 to n)
+ *                                 and negative (-1 to -n) values. For positive values, 0 points to the
+ *                                 topmost header. For negative values, -1 points to the bottom-most
+ *                                 header (the header closest to the cells).
+ * @returns {string} The column header value to be updated.
+ */
+'modifyColumnHeaderValue',
 /**
  * Fired by {@link UndoRedo} plugin before the undo action. Contains information about the action that is being undone.
  * This hook is fired when {@link Options#undo} option is enabled.
@@ -2203,7 +2287,7 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  */
 'afterUnlisten',
 /**
- * Fired after the window was resized.
+ * Fired after the window was resized or the size of the Handsontable root element was changed.
  *
  * @event Hooks#afterRefreshDimensions
  * @param {object} previousDimensions Previous dimensions of the container.
@@ -2212,7 +2296,8 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  */
 'afterRefreshDimensions',
 /**
- * Cancellable hook, called after resizing a window, but before redrawing a table.
+ * Cancellable hook, called after resizing a window or after detecting size change of the
+ * Handsontable root element, but before redrawing a table.
  *
  * @event Hooks#beforeRefreshDimensions
  * @param {object} previousDimensions Previous dimensions of the container.

package/pluginHooks.mjs

@@ -1,9 +1,18 @@
+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 "core-js/modules/es.array.slice.js";
 import "core-js/modules/es.object.freeze.js";
+import "core-js/modules/es.symbol.to-primitive.js";
+import "core-js/modules/es.date.to-primitive.js";
+import "core-js/modules/es.symbol.js";
+import "core-js/modules/es.symbol.description.js";
+import "core-js/modules/es.number.constructor.js";
+import "core-js/modules/es.symbol.iterator.js";
 var _templateObject;
 function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
-function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
 function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
 import "core-js/modules/es.array.iterator.js";
 import "core-js/modules/es.map.js";
 import "core-js/modules/es.object.to-string.js";
@@ -18,15 +27,25 @@ import { substitute } from "./helpers/string.mjs";
 import { warn } from "./helpers/console.mjs";
 import { toSingleLine } from "./helpers/templateLiteralTag.mjs";
 import { fastCall } from "./helpers/function.mjs";
+/* eslint-disable jsdoc/require-description-complete-sentence */
 /**
  * @description
+ *
+ * ::: only-for javascript
  * Handsontable events are the common interface that function in 2 ways: as __callbacks__ and as __hooks__.
+ * :::
+ *
+ * ::: only-for react
+ * This page lists all the **Handsontable hooks** – callbacks that let you react before or after an action occurs.
+ *
+ * Read more on the [Events and hooks](@/guides/getting-started/events-and-hooks.md) page.
+ * :::
  *
  * @example
  *
  * ::: only-for javascript
  * ```js
- * // Using events as callbacks:
+ * // using events as callbacks
  * ...
  * const hot1 = new Handsontable(document.getElementById('example1'), {
  *   afterChange: function(changes, source) {
@@ -58,7 +77,7 @@ import { fastCall } from "./helpers/function.mjs";
  *
  * ::: only-for javascript
  * ```js
- * // Using events as plugin hooks:
+ * // using events as plugin hooks
  * ...
  * const hot1 = new Handsontable(document.getElementById('example1'), {
  *   myPlugin: true
@@ -347,13 +366,13 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
 /**
  * Fired after retrieving information about a column header and appending it to the table header.
  *
- * Since the 12.2 the hook is triggered with the 3rd `headerLevel` argument.
- *
  * @event Hooks#afterGetColHeader
  * @param {number} column Visual column index.
  * @param {HTMLTableCellElement} TH Header's TH element.
- * @param {number} [headerLevel=0] The index of header level counting from the top (positive
- *                                 values counting from 0 to N).
+ * @param {number} [headerLevel=0] (Since 12.2.0) Header level index. Accepts positive (0 to n)
+ *                                 and negative (-1 to -n) values. For positive values, 0 points to the
+ *                                 topmost header. For negative values, -1 points to the bottom-most
+ *                                 header (the header closest to the cells).
  */
 'afterGetColHeader',
 /**
@@ -1304,7 +1323,7 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  */
 'modifyCopyableRange',
 /**
- * Fired by {@link CopyPaste} plugin before copying the values into clipboard and before clearing values of
+ * Fired by {@link CopyPaste} plugin before copying the values to the clipboard and before clearing values of
  * the selected cells. This hook is fired when {@link Options#copyPaste} option is enabled.
  *
  * @event Hooks#beforeCut
@@ -1359,18 +1378,19 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  * {@link Options#copyPaste} option is enabled.
  *
  * @event Hooks#afterCut
- * @param {Array[]} data An array of arrays which contains the cutted out data.
+ * @param {Array[]} data An array of arrays with the cut data.
  * @param {object[]} coords An array of objects with ranges of the visual indexes (`startRow`, `startCol`, `endRow`, `endCol`)
  *                       which was cut out.
  */
 'afterCut',
 /**
- * Fired before values are copied into clipboard.
+ * Fired before values are copied to the clipboard.
  *
  * @event Hooks#beforeCopy
  * @param {Array[]} data An array of arrays which contains data to copied.
  * @param {object[]} coords An array of objects with ranges of the visual indexes (`startRow`, `startCol`, `endRow`, `endCol`)
  *                         which will copied.
+ * @param {{ columnHeadersCount: number }} copiedHeadersCount (Since 12.3.0) The number of copied column headers.
  * @returns {*} If returns `false` then copying is canceled.
  *
  * @example
@@ -1433,6 +1453,7 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  * @param {Array[]} data An array of arrays which contains the copied data.
  * @param {object[]} coords An array of objects with ranges of the visual indexes (`startRow`, `startCol`, `endRow`, `endCol`)
  *                         which was copied.
+ * @param {{ columnHeadersCount: number }} copiedHeadersCount (Since 12.3.0) The number of copied column headers.
  */
 'afterCopy',
 /**
@@ -1491,7 +1512,7 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  * {@link Options#copyPaste} option is enabled.
  *
  * @event Hooks#afterPaste
- * @param {Array[]} data An array of arrays which contains the pasted data.
+ * @param {Array[]} data An array of arrays with the pasted data.
  * @param {object[]} coords An array of objects with ranges of the visual indexes (`startRow`, `startCol`, `endRow`, `endCol`)
  *                       that correspond to the previously selected area.
  */
@@ -1676,13 +1697,22 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  */
 'beforeStretchingColumnWidth',
 /**
- * Fired by {@link Filters} plugin before applying [filtering](@/guides/columns/column-filter.md).
- * This hook is fired when {@link Options#filters} option is enabled.
+ * Fired by the [`Filters`](@/api/filters.md) plugin,
+ * before a [column filter](@/guides/columns/column-filter.md) gets applied.
+ *
+ * [`beforeFilter`](#beforefilter) takes one argument (`conditionsStack`), which is an array of objects.
+ * Each object represents one of your [column filters](@/api/filters.md#addcondition),
+ * and consists of the following properties:
+ *
+ * | Property     | Possible values                                                         | Description                                                                                                              |
+ * | ------------ | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+ * | `column`     | Number                                                                  | A visual index of the column to which the filter will be applied.                                                        |
+ * | `conditions` | Array of objects                                                        | Each object represents one condition. For details, see [`addCondition()`](@/api/filters.md#addcondition).                |
+ * | `operation`  | `'conjunction'` \| `'disjunction'` \| `'disjunctionWithExtraCondition'` | An operation to perform on your set of `conditions`. For details, see [`addCondition()`](@/api/filters.md#addcondition). |
+ *
+ * An example of the format of the `conditionsStack` argument:
  *
- * @event Hooks#beforeFilter
- * @param {object[]} conditionsStack An array of objects with added formulas.
  * ```js
- * // Example format of the conditionsStack argument:
  * [
  *   {
  *     column: 2,
@@ -1700,17 +1730,47 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  *   },
  * ]
  * ```
- * @returns {boolean} If hook returns `false` value then filtering won't be applied on the UI side (server-side filtering).
+ *
+ * To perform server-side filtering (i.e., to not apply filtering to Handsontable's UI),
+ * set [`beforeFilter`](#beforefilter) to return `false`:
+ *
+ * ```js
+ * new Handsontable(document.getElementById('example'), {
+ *   beforeFilter: (conditionsStack) => {
+ *     return false;
+ *   }
+ * });
+ *```
+ *
+ * Read more:
+ * - [Guides: Column filter](@/guides/columns/column-filter.md)
+ * - [Hooks: `afterFilter`](#afterfilter)
+ * - [Options: `filters`](@/api/options.md#filters)
+ * - [Plugins: `Filters`](@/api/filters.md)
+ * – [Plugin methods: `addCondition()`](@/api/filters.md#addcondition)
+ *
+ * @event Hooks#beforeFilter
+ * @param {object[]} conditionsStack An array of objects with your [column filters](@/api/filters.md#addcondition).
+ * @returns {boolean} To perform server-side filtering (i.e., to not apply filtering to Handsontable's UI), return `false`.
  */
 'beforeFilter',
 /**
- * Fired by {@link Filters} plugin after applying [filtering](@/guides/columns/column-filter.md).
- * This hook is fired when {@link Options#filters} option is enabled.
+ * Fired by the [`Filters`](@/api/filters.md) plugin,
+ * after a [column filter](@/guides/columns/column-filter.md) gets applied.
+ *
+ * [`afterFilter`](#afterfilter) takes one argument (`conditionsStack`), which is an array of objects.
+ * Each object represents one of your [column filters](@/api/filters.md#addcondition),
+ * and consists of the following properties:
+ *
+ * | Property     | Possible values                                                         | Description                                                                                                              |
+ * | ------------ | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+ * | `column`     | Number                                                                  | A visual index of the column to which the filter was applied.                                                            |
+ * | `conditions` | Array of objects                                                        | Each object represents one condition. For details, see [`addCondition()`](@/api/filters.md#addcondition).                |
+ * | `operation`  | `'conjunction'` \| `'disjunction'` \| `'disjunctionWithExtraCondition'` | An operation to perform on your set of `conditions`. For details, see [`addCondition()`](@/api/filters.md#addcondition). |
+ *
+ * An example of the format of the `conditionsStack` argument:
  *
- * @event Hooks#afterFilter
- * @param {object[]} conditionsStack An array of objects with added conditions.
  * ```js
- * // Example format of the conditionsStack argument:
  * [
  *   {
  *     column: 2,
@@ -1728,6 +1788,16 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  *   },
  * ]
  * ```
+ *
+ * Read more:
+ * - [Guides: Column filter](@/guides/columns/column-filter.md)
+ * - [Hooks: `beforeFilter`](#beforefilter)
+ * - [Options: `filters`](@/api/options.md#filters)
+ * - [Plugins: `Filters`](@/api/filters.md)
+ * – [Plugin methods: `addCondition()`](@/api/filters.md#addcondition)
+ *
+ * @event Hooks#afterFilter
+ * @param {object[]} conditionsStack An array of objects with your [column filters](@/api/filters.md#addcondition).
  */
 'afterFilter',
 /**
@@ -1798,6 +1868,20 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  * @event Hooks#modifyColumnHeaderHeight
  */
 'modifyColumnHeaderHeight',
+/**
+ * Fired while retrieving a column header's value.
+ *
+ * @since 12.3.0
+ * @event Hooks#modifyColumnHeaderValue
+ * @param {string} value A column header value.
+ * @param {number} visualColumnIndex A visual column index.
+ * @param {number} [headerLevel=0] Header level index. Accepts positive (0 to n)
+ *                                 and negative (-1 to -n) values. For positive values, 0 points to the
+ *                                 topmost header. For negative values, -1 points to the bottom-most
+ *                                 header (the header closest to the cells).
+ * @returns {string} The column header value to be updated.
+ */
+'modifyColumnHeaderValue',
 /**
  * Fired by {@link UndoRedo} plugin before the undo action. Contains information about the action that is being undone.
  * This hook is fired when {@link Options#undo} option is enabled.
@@ -2198,7 +2282,7 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  */
 'afterUnlisten',
 /**
- * Fired after the window was resized.
+ * Fired after the window was resized or the size of the Handsontable root element was changed.
  *
  * @event Hooks#afterRefreshDimensions
  * @param {object} previousDimensions Previous dimensions of the container.
@@ -2207,7 +2291,8 @@ var REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-sen
  */
 'afterRefreshDimensions',
 /**
- * Cancellable hook, called after resizing a window, but before redrawing a table.
+ * Cancellable hook, called after resizing a window or after detecting size change of the
+ * Handsontable root element, but before redrawing a table.
  *
  * @event Hooks#beforeRefreshDimensions
  * @param {object} previousDimensions Previous dimensions of the container.