handsontable 0.0.0-next-8dc7078-20240322 → 0.0.0-next-28fc088-20240325

package/editorManager.js

@@ -310,18 +310,22 @@ class EditorManager {
   }
 
   /**
-   * Controls selection's behaviour after clicking `Enter`.
+   * Controls selection's behavior after clicking `Enter`.
    *
    * @private
-   * @param {boolean} isShiftPressed If `true`, then the selection will move up after hit enter.
+   * @param {KeyboardEvent} event The keyboard event object.
    */
-  moveSelectionAfterEnter(isShiftPressed) {
-    const enterMoves = typeof this.tableMeta.enterMoves === 'function' ? this.tableMeta.enterMoves(event) : this.tableMeta.enterMoves;
-    if (isShiftPressed) {
-      // move selection up
-      this.selection.transformStart(-enterMoves.row, -enterMoves.col);
+  moveSelectionAfterEnter(event) {
+    const enterMoves = {
+      ...(typeof this.tableMeta.enterMoves === 'function' ? this.tableMeta.enterMoves(event) : this.tableMeta.enterMoves)
+    };
+    if (event.shiftKey) {
+      enterMoves.row = -enterMoves.row;
+      enterMoves.col = -enterMoves.col;
+    }
+    if (this.hot.selection.isMultiple()) {
+      this.selection.transformFocus(enterMoves.row, enterMoves.col);
     } else {
-      // move selection down (add a new row if needed)
       this.selection.transformStart(enterMoves.row, enterMoves.col, true);
     }
   }

package/editorManager.mjs

@@ -306,18 +306,22 @@ class EditorManager {
   }
 
   /**
-   * Controls selection's behaviour after clicking `Enter`.
+   * Controls selection's behavior after clicking `Enter`.
    *
    * @private
-   * @param {boolean} isShiftPressed If `true`, then the selection will move up after hit enter.
+   * @param {KeyboardEvent} event The keyboard event object.
    */
-  moveSelectionAfterEnter(isShiftPressed) {
-    const enterMoves = typeof this.tableMeta.enterMoves === 'function' ? this.tableMeta.enterMoves(event) : this.tableMeta.enterMoves;
-    if (isShiftPressed) {
-      // move selection up
-      this.selection.transformStart(-enterMoves.row, -enterMoves.col);
+  moveSelectionAfterEnter(event) {
+    const enterMoves = {
+      ...(typeof this.tableMeta.enterMoves === 'function' ? this.tableMeta.enterMoves(event) : this.tableMeta.enterMoves)
+    };
+    if (event.shiftKey) {
+      enterMoves.row = -enterMoves.row;
+      enterMoves.col = -enterMoves.col;
+    }
+    if (this.hot.selection.isMultiple()) {
+      this.selection.transformFocus(enterMoves.row, enterMoves.col);
     } else {
-      // move selection down (add a new row if needed)
       this.selection.transformStart(enterMoves.row, enterMoves.col, true);
     }
   }

package/focusManager.js

@@ -92,10 +92,16 @@ class FocusManager {
       }
       return _assertClassBrand(_FocusManager_brand, _this, _focusCell).call(_this, ...args);
     });
-    _classPrivateFieldGet(_hot, this).addHook('afterSelectionEnd', function () {
+    _classPrivateFieldGet(_hot, this).addHook('afterSelectionFocusSet', function () {
       for (var _len3 = arguments.length, args = new Array(_len3), _key3 = 0; _key3 < _len3; _key3++) {
         args[_key3] = arguments[_key3];
       }
+      return _assertClassBrand(_FocusManager_brand, _this, _focusCell).call(_this, ...args);
+    });
+    _classPrivateFieldGet(_hot, this).addHook('afterSelectionEnd', function () {
+      for (var _len4 = arguments.length, args = new Array(_len4), _key4 = 0; _key4 < _len4; _key4++) {
+        args[_key4] = arguments[_key4];
+      }
       return _assertClassBrand(_FocusManager_brand, _this, _focusEditorElement).call(_this, ...args);
     });
   }

package/focusManager.mjs

@@ -89,10 +89,16 @@ export class FocusManager {
       }
       return _assertClassBrand(_FocusManager_brand, _this, _focusCell).call(_this, ...args);
     });
-    _classPrivateFieldGet(_hot, this).addHook('afterSelectionEnd', function () {
+    _classPrivateFieldGet(_hot, this).addHook('afterSelectionFocusSet', function () {
       for (var _len3 = arguments.length, args = new Array(_len3), _key3 = 0; _key3 < _len3; _key3++) {
         args[_key3] = arguments[_key3];
       }
+      return _assertClassBrand(_FocusManager_brand, _this, _focusCell).call(_this, ...args);
+    });
+    _classPrivateFieldGet(_hot, this).addHook('afterSelectionEnd', function () {
+      for (var _len4 = arguments.length, args = new Array(_len4), _key4 = 0; _key4 < _len4; _key4++) {
+        args[_key4] = arguments[_key4];
+      }
       return _assertClassBrand(_FocusManager_brand, _this, _focusEditorElement).call(_this, ...args);
     });
   }

package/helpers/mixed.js

@@ -134,7 +134,7 @@ const domMessages = {
 function _injectProductInfo(key, element) {
   const hasValidType = !isEmpty(key);
   const isNonCommercial = typeof key === 'string' && key.toLowerCase() === 'non-commercial-and-evaluation';
-  const hotVersion = "0.0.0-next-8dc7078-20240322";
+  const hotVersion = "0.0.0-next-28fc088-20240325";
   let keyValidityDate;
   let consoleMessageState = 'invalid';
   let domMessageState = 'invalid';

package/helpers/mixed.mjs

@@ -124,7 +124,7 @@ const domMessages = {
 export function _injectProductInfo(key, element) {
   const hasValidType = !isEmpty(key);
   const isNonCommercial = typeof key === 'string' && key.toLowerCase() === 'non-commercial-and-evaluation';
-  const hotVersion = "0.0.0-next-8dc7078-20240322";
+  const hotVersion = "0.0.0-next-28fc088-20240325";
   let keyValidityDate;
   let consoleMessageState = 'invalid';
   let domMessageState = 'invalid';

package/package.json

@@ -10,7 +10,7 @@
     "url": "https://github.com/handsontable/handsontable/issues"
   },
   "author": "Handsoncode <hello@handsontable.com>",
-  "version": "0.0.0-next-8dc7078-20240322",
+  "version": "0.0.0-next-28fc088-20240325",
   "main": "index",
   "module": "index.mjs",
   "jsnext:main": "index.mjs",

package/pluginHooks.d.ts

@@ -98,6 +98,7 @@ export interface Events {
   afterLoadData?: (sourceData: CellValue[], initialLoad: boolean, source: string | undefined) => void;
   afterMergeCells?: (cellRange: CellRange, mergeParent: MergeCellsSettings, auto: boolean) => void;
   afterModifyTransformEnd?: (coords: CellCoords, rowTransformDir: -1 | 0, colTransformDir: -1 | 0) => void;
+  afterModifyTransformFocus?: (coords: CellCoords, rowTransformDir: -1 | 0, colTransformDir: -1 | 0) => void;
   afterModifyTransformStart?: (coords: CellCoords, rowTransformDir: -1 | 0, colTransformDir: -1 | 0) => void;
   afterMomentumScroll?: () => void;
   afterNamedExpressionAdded?: (namedExpressionName: string, changes: ExportedChange[]) => void;
@@ -130,6 +131,7 @@ export interface Events {
   afterSelectionByProp?: (row: number, prop: string, row2: number, prop2: string, preventScrolling: { value: boolean }, selectionLayerLevel: number) => void;
   afterSelectionEnd?: (row: number, column: number, row2: number, column2: number, selectionLayerLevel: number) => void;
   afterSelectionEndByProp?: (row: number, prop: string, row2: number, prop2: string, selectionLayerLevel: number) => void;
+  afterSelectionFocusSet?: (row: number, column: number, preventScrolling: { value: boolean }) => void;
   afterSelectRows?: (from: CellCoords, to: CellCoords, highlight: CellCoords) => void;
   afterSetCellMeta?: (row: number, column: number, key: string, value: any) => void;
   afterSetDataAtCell?: (changes: CellChange[], source?: ChangeSource) => void;
@@ -208,6 +210,7 @@ export interface Events {
   beforeRowResize?: (newSize: number, row: number, isDoubleClick: boolean) => number | void;
   beforeRowWrap?: (isActionInterrupted: { value: boolean }, newCoords: CellCoords, isRowFlipped: boolean) => void;
   beforeSelectColumns?: (from: CellCoords, to: CellCoords, highlight: CellCoords) => void;
+  beforeSelectionFocusSet?: (coords: CellCoords) => void;
   beforeSelectionHighlightSet?: () => void;
   beforeSelectRows?: (from: CellCoords, to: CellCoords, highlight: CellCoords) => void;
   beforeSetCellMeta?: (row: number, column: number, key: string, value: any) => boolean | void;
@@ -250,6 +253,7 @@ export interface Events {
   modifyRowHeight?: (height: number, row: number) => void;
   modifySourceData?: (row: number, column: number, valueHolder: { value: CellValue }, ioMode: 'get' | 'set') => void;
   modifyTransformEnd?: (delta: CellCoords) => void;
+  modifyTransformFocus?: (delta: CellCoords) => void;
   modifyTransformStart?: (delta: CellCoords) => void;
   persistentStateLoad?: (key: string, valuePlaceholder: { value: any }) => void;
   persistentStateReset?: (key: string) => void;

package/pluginHooks.js

@@ -134,7 +134,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
 'afterCellMetaReset',
 /**
  * Fired after one or more cells has been changed. The changes are triggered in any situation when the
- * value is entered using an editor or changed using API (e.q setDataAtCell).
+ * value is entered using an editor or changed using API (e.q [`setDataAtCell`](@/api/core.md#setdataatcell) method).
  *
  * __Note:__ For performance reasons, the `changes` array is null for `"loadData"` source.
  *
@@ -177,7 +177,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
 'afterContextMenuDefaultOptions',
 /**
  * Fired each time user opens {@link ContextMenu} plugin before setting up the Context Menu's items but after filtering these options by
- * user (`contextMenu` option). This hook can by helpful to determine if user use specified menu item or to set up
+ * user ([`contextMenu`](@/api/options.md#contextmenu) option). This hook can by helpful to determine if user use specified menu item or to set up
  * one of the menu item to by always visible.
  *
  * @event Hooks#beforeContextMenuSetItems
@@ -195,7 +195,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
 'afterDropdownMenuDefaultOptions',
 /**
  * Fired by {@link DropdownMenu} plugin before setting up the Dropdown Menu's items but after filtering these options
- * by user (`dropdownMenu` option). This hook can by helpful to determine if user use specified menu item or to set
+ * by user ([`dropdownMenu`](@/api/options.md#dropdownmenu) option). This hook can by helpful to determine if user use specified menu item or to set
  * up one of the menu item to by always visible.
  *
  * @event Hooks#beforeDropdownMenuSetItems
@@ -322,7 +322,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  */
 'afterDestroy',
 /**
- * Hook fired after keydown event is handled.
+ * Hook fired after `keydown` event is handled.
  *
  * @event Hooks#afterDocumentKeyDown
  * @param {Event} event A native `keydown` event object.
@@ -414,7 +414,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  */
 'afterUpdateData',
 /**
- * Fired after a scroll event, which is identified as a momentum scroll (e.g. On an iPad).
+ * Fired after a scroll event, which is identified as a momentum scroll (e.g. on an iPad).
  *
  * @event Hooks#afterMomentumScroll
  */
@@ -598,7 +598,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  */
 'afterScroll',
 /**
- * Fired after one or more cells are selected (e.g. During mouse move).
+ * Fired after one or more cells are selected (e.g. during mouse move).
  *
  * @event Hooks#afterSelection
  * @param {number} row Selection start visual row index.
@@ -650,7 +650,9 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * @param {string} prop Selection start data source object property name.
  * @param {number} row2 Selection end visual row index.
  * @param {string} prop2 Selection end data source object property name.
- * @param {object} preventScrolling Object with `value` property where its value change will be observed.
+ * @param {object} preventScrolling A reference to the observable object with the `value` property.
+ *                                  Property `preventScrolling.value` expects a boolean value that
+ *                                  Handsontable uses to control scroll behavior after selection.
  * @param {number} selectionLayerLevel The number which indicates what selection layer is currently modified.
  * @example
  * ```js
@@ -677,7 +679,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  */
 'afterSelectionByProp',
 /**
- * Fired after one or more cells are selected (e.g. On mouse up).
+ * Fired after one or more cells are selected (e.g. on mouse up).
  *
  * @event Hooks#afterSelectionEnd
  * @param {number} row Selection start visual row index.
@@ -688,7 +690,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  */
 'afterSelectionEnd',
 /**
- * Fired after one or more cells are selected (e.g. On mouse up).
+ * Fired after one or more cells are selected (e.g. on mouse up).
  *
  * The `prop` and `prop2` arguments represent the source object property name instead of the column number.
  *
@@ -700,6 +702,46 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * @param {number} selectionLayerLevel The number which indicates what selection layer is currently modified.
  */
 'afterSelectionEndByProp',
+/**
+ * Fired after the focus position within a selected range is changed.
+ *
+ * @since 14.3.0
+ * @event Hooks#afterSelectionFocusSet
+ * @param {number} row The focus visual row index position.
+ * @param {number} column The focus visual column index position.
+ * @param {object} preventScrolling A reference to the observable object with the `value` property.
+ *                                  Property `preventScrolling.value` expects a boolean value that
+ *                                  Handsontable uses to control scroll behavior after selection.
+ * @example
+ * ```js
+ * ::: only-for javascript
+ * new Handsontable(element, {
+ *   afterSelectionFocusSet: (row, column, preventScrolling) => {
+ *     // If set to `false` (default): when focused cell selection is outside the viewport,
+ *     // Handsontable scrolls the viewport to that cell.
+ *     // If set to `true`: when focused cell selection is outside the viewport,
+ *     // Handsontable doesn't scroll the viewport.
+ *     preventScrolling.value = true;
+ *   }
+ * })
+ * ```
+ * :::
+ *
+ * ::: only-for react
+ * ```jsx
+ * <HotTable
+ *   afterSelectionFocusSet={(row, column, preventScrolling) => {
+ *     // If set to `false` (default): when focused cell selection is outside the viewport,
+ *     // Handsontable scrolls the viewport to that cell.
+ *     // If set to `true`: when focused cell selection is outside the viewport,
+ *     // Handsontable doesn't scroll the viewport.
+ *     preventScrolling.value = true;
+ *   }}
+ * />
+ * ```
+ * :::
+ */
+'afterSelectionFocusSet',
 /**
  * Fired before one or more columns are selected (e.g. During mouse header click or {@link Core#selectColumns} API call).
  *
@@ -735,7 +777,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  */
 'beforeSelectColumns',
 /**
- * Fired after one or more columns are selected (e.g. During mouse header click or {@link Core#selectColumns} API call).
+ * Fired after one or more columns are selected (e.g. during mouse header click or {@link Core#selectColumns} API call).
  *
  * @since 14.0.0
  * @event Hooks#afterSelectColumns
@@ -745,7 +787,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  */
 'afterSelectColumns',
 /**
- * Fired before one or more rows are selected (e.g. During mouse header click or {@link Core#selectRows} API call).
+ * Fired before one or more rows are selected (e.g. during mouse header click or {@link Core#selectRows} API call).
  *
  * @since 14.0.0
  * @event Hooks#beforeSelectRows
@@ -779,7 +821,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  */
 'beforeSelectRows',
 /**
- * Fired after one or more rows are selected (e.g. During mouse header click or {@link Core#selectRows} API call).
+ * Fired after one or more rows are selected (e.g. during mouse header click or {@link Core#selectRows} API call).
  *
  * @since 14.0.0
  * @event Hooks#afterSelectRows
@@ -819,7 +861,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
 'afterSetDataAtCell',
 /**
  * Fired after cell data was changed.
- * Called only when `setDataAtRowProp` was executed.
+ * Called only when [`setDataAtRowProp`](@/api/core.md#setdataatrowprop) was executed.
  *
  * @event Hooks#afterSetDataAtRowProp
  * @param {Array} changes An array of changes in format `[[row, prop, oldValue, value], ...]`.
@@ -837,7 +879,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  */
 'afterSetSourceDataAtCell',
 /**
- * Fired after calling the `updateSettings` method.
+ * Fired after calling the [`updateSettings`](@/api/core.md#updatesettings) method.
  *
  * @event Hooks#afterUpdateSettings
  * @param {object} newSettings New settings object.
@@ -887,7 +929,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * @param {string} direction Declares the direction of the autofill. Possible values: `up`, `down`, `left`, `right`.
  *
  * @returns {boolean|Array[]} If false, the operation is cancelled. If array of arrays, the returned data
- *                              will be passed into `populateFromArray` instead of the default autofill
+ *                              will be passed into [`populateFromArray`](@/api/core.md#populatefromarray) instead of the default autofill
  *                              algorithm's result.
  */
 'beforeAutofill',
@@ -909,17 +951,10 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  *
  * @event Hooks#beforeCellAlignment
  * @param {object} stateBefore An object with class names defining the cell alignment.
- * @param {CellRange[]} range An array of CellRange coordinates where the alignment will be applied.
+ * @param {CellRange[]} range An array of `CellRange` coordinates where the alignment will be applied.
  * @param {string} type Type of the alignment - either `horizontal` or `vertical`.
  * @param {string} alignmentClass String defining the alignment class added to the cell.
- * Possible values:
- * * `htLeft`
- * * `htCenter`
- * * `htRight`
- * * `htJustify`
- * * `htTop`
- * * `htMiddle`
- * * `htBottom`.
+ * Possible values: `htLeft` , `htCenter`, `htRight`, `htJustify`, `htTop`, `htMiddle`, `htBottom`.
  */
 'beforeCellAlignment',
 /**
@@ -1080,7 +1115,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  */
 'beforeUpdateData',
 /**
- * Hook fired before keydown event is handled. It can be used to stop default key bindings.
+ * Hook fired before `keydown` event is handled. It can be used to stop default key bindings.
  *
  * __Note__: To prevent default behavior you need to call `false` in your `beforeKeyDown` handler.
  *
@@ -1254,25 +1289,33 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * @returns {boolean|undefined} If false is returned the action is canceled.
  */
 'beforeSetCellMeta',
+/**
+ * Fired before setting focus selection.
+ *
+ * @since 14.3.0
+ * @event Hooks#beforeSelectionFocusSet
+ * @param {CellCoords} coords CellCoords instance.
+ */
+'beforeSelectionFocusSet',
 /**
  * Fired before setting range is started but not finished yet.
  *
  * @event Hooks#beforeSetRangeStartOnly
- * @param {CellCoords} coords CellCoords instance.
+ * @param {CellCoords} coords `CellCoords` instance.
  */
 'beforeSetRangeStartOnly',
 /**
  * Fired before setting range is started.
  *
  * @event Hooks#beforeSetRangeStart
- * @param {CellCoords} coords CellCoords instance.
+ * @param {CellCoords} coords `CellCoords` instance.
  */
 'beforeSetRangeStart',
 /**
  * Fired before setting range is ended.
  *
  * @event Hooks#beforeSetRangeEnd
- * @param {CellCoords} coords CellCoords instance.
+ * @param {CellCoords} coords `CellCoords` instance.
  */
 'beforeSetRangeEnd',
 /**
@@ -1405,7 +1448,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  */
 'modifyRowData',
 /**
- * Used to modify the cell coordinates when using the `getCell` method, opening editor, getting value from the editor
+ * Used to modify the cell coordinates when using the [`getCell`](@/api/core.md#getcell) method, opening editor, getting value from the editor
  * and saving values from the closed editor.
  *
  * @event Hooks#modifyGetCellCoords
@@ -2074,9 +2117,9 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * @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
+ * @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.
  */
@@ -2163,6 +2206,14 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * @param {number} rowHeaderWidth Row header width.
  */
 'modifyRowHeaderWidth',
+/**
+ * Fired when the focus of the selection is being modified (e.g. Moving the focus with the enter/tab keys).
+ *
+ * @since 14.3.0
+ * @event Hooks#modifyTransformFocus
+ * @param {CellCoords} delta Cell coords object declaring the delta of the new selection relative to the previous one.
+ */
+'modifyTransformFocus',
 /**
  * Fired when the start of the selection is being modified (e.g. Moving the selection with the arrow keys).
  *
@@ -2177,6 +2228,16 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * @param {CellCoords} delta Cell coords object declaring the delta of the new selection relative to the previous one.
  */
 'modifyTransformEnd',
+/**
+ * Fired after the focus of the selection is being modified (e.g. Moving the focus with the enter/tab keys).
+ *
+ * @since 14.3.0
+ * @event Hooks#afterModifyTransformFocus
+ * @param {CellCoords} coords Coords of the freshly focused cell.
+ * @param {number} rowTransformDir `-1` if trying to focus a cell with a negative row index. `0` otherwise.
+ * @param {number} colTransformDir `-1` if trying to focus a cell with a negative column index. `0` otherwise.
+ */
+'afterModifyTransformFocus',
 /**
  * Fired after the start of the selection is being modified (e.g. Moving the selection with the arrow keys).
  *
@@ -2352,7 +2413,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * option is enabled.
  *
  * @event Hooks#beforeDropdownMenuShow
- * @param {DropdownMenu} dropdownMenu The DropdownMenu instance.
+ * @param {DropdownMenu} dropdownMenu The `DropdownMenu` instance.
  */
 'beforeDropdownMenuShow',
 /**
@@ -2360,7 +2421,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * option is enabled.
  *
  * @event Hooks#afterDropdownMenuShow
- * @param {DropdownMenu} dropdownMenu The DropdownMenu instance.
+ * @param {DropdownMenu} dropdownMenu The `DropdownMenu` instance.
  */
 'afterDropdownMenuShow',
 /**
@@ -2368,11 +2429,11 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * option is enabled.
  *
  * @event Hooks#afterDropdownMenuHide
- * @param {DropdownMenu} instance The DropdownMenu instance.
+ * @param {DropdownMenu} instance The `DropdownMenu` instance.
  */
 'afterDropdownMenuHide',
 /**
- * Fired by {@link NestedRows} plugin before adding a children to the NestedRows structure. This hook is fired when
+ * Fired by {@link NestedRows} plugin before adding a children to the `NestedRows` structure. This hook is fired when
  * {@link Options#nestedRows} option is enabled.
  *
  * @event Hooks#beforeAddChild
@@ -2382,7 +2443,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  */
 'beforeAddChild',
 /**
- * Fired by {@link NestedRows} plugin after adding a children to the NestedRows structure. This hook is fired when
+ * Fired by {@link NestedRows} plugin after adding a children to the `NestedRows` structure. This hook is fired when
  * {@link Options#nestedRows} option is enabled.
  *
  * @event Hooks#afterAddChild