handsontable 12.1.1 → 12.1.3

package/pluginHooks.d.ts

@@ -231,7 +231,6 @@ export interface Events {
   modifyRowHeader?: (row: number) => void;
   modifyRowHeaderWidth?: (rowHeaderWidth: number) => void;
   modifyRowHeight?: (height: number, row: number) => void;
-  modifyRowSourceData?: (row: number) => void;
   modifySourceData?: (row: number, column: number, valueHolder: { value: CellValue }, ioMode: 'get' | 'set') => void;
   modifyTransformEnd?: (delta: CellCoords) => void;
   modifyTransformStart?: (delta: CellCoords) => void;

package/pluginHooks.js

@@ -106,7 +106,7 @@ var REGISTERED_HOOKS = [
  * __Note:__ For performance reasons, the `changes` array is null for `"loadData"` source.
  *
  * @event Hooks#afterChange
- * @param {Array} changes 2D array containing information about each of the edited cells `[[row, prop, oldVal, newVal], ...]`.
+ * @param {Array[]} changes 2D array containing information about each of the edited cells `[[row, prop, oldVal, newVal], ...]`. `row` is a visual row index.
  * @param {string} [source] String that identifies source of hook call ([list of all available sources](@/guides/getting-started/events-and-hooks.md#definition-for-source-argument)).
  * @example
  * ```js
@@ -242,7 +242,7 @@ var REGISTERED_HOOKS = [
  */
 'afterCreateRow',
 /**
- * Fired after the current cell is deselected.
+ * Fired after all selected cells are deselected.
  *
  * @event Hooks#afterDeselect
  */
@@ -623,7 +623,7 @@ var REGISTERED_HOOKS = [
  * @param {string|number} prop Property name / visual column index.
  * @param {string} [source] String that identifies source of hook call
  *                          ([list of all available sources](@/guides/getting-started/events-and-hooks.md#definition-for-source-argument)).
- * @returns {void | boolean} If `false` the cell will be marked as invalid, `true` otherwise.
+ * @returns {undefined | boolean} If `false` the cell will be marked as invalid, `true` otherwise.
  */
 'afterValidate',
 /**
@@ -693,10 +693,10 @@ var REGISTERED_HOOKS = [
  * table rendering.
  *
  * @event Hooks#beforeChange
- * @param {Array[]} changes 2D array containing information about each of the edited cells.
+ * @param {Array[]} changes 2D array containing information about each of the edited cells `[[row, prop, oldVal, newVal], ...]`. `row` is a visual row index.
  * @param {string} [source] String that identifies source of hook call
  *                          ([list of all available sources](@/guides/getting-started/events-and-hooks.md#definition-for-source-argument)).
- * @returns {void | boolean} If `false` all changes were cancelled, `true` otherwise.
+ * @returns {undefined | boolean} If `false` all changes were cancelled, `true` otherwise.
  * @example
  * ```js
  * // To disregard a single change, set changes[i] to null or remove it from array using changes.splice(i, 1).
@@ -946,7 +946,7 @@ var REGISTERED_HOOKS = [
  * @param {number} column Visual column index.
  * @param {string} key The updated meta key.
  * @param {*} value The updated meta value.
- * @returns {*|boolean} If false is returned the action is canceled.
+ * @returns {boolean|undefined} If false is returned the action is canceled.
  */
 'beforeSetCellMeta',
 /**
@@ -1080,6 +1080,7 @@ var REGISTERED_HOOKS = [
  * @param {boolean} topmost If set to `true`, it returns the TD element from the topmost overlay. For example,
  *                          if the wanted cell is in the range of fixed rows, it will return a TD element
  *                          from the `top` overlay.
+ * @returns {undefined|number[]}
  */
 'modifyGetCellCoords',
 /**
@@ -1111,8 +1112,9 @@ var REGISTERED_HOOKS = [
  */
 'beforeHighlightingColumnHeader',
 /**
- * Fired by {@link PersistentState} plugin, after loading value, saved under given key, from browser local storage. This hook is fired when
- * {@link Options#persistentState} option is enabled.
+ * Fired by {@link PersistentState} plugin, after loading value, saved under given key, from browser local storage.
+ *
+ * The `persistentStateLoad` hook is fired even when the {@link Options#persistentState} option is disabled.
  *
  * @event Hooks#persistentStateLoad
  * @param {string} key Key.
@@ -1128,8 +1130,9 @@ var REGISTERED_HOOKS = [
  */
 'persistentStateReset',
 /**
- * Fired by {@link PersistentState} plugin, after saving value under given key in browser local storage. This hook is fired when
- * {@link Options#persistentState} option is enabled.
+ * Fired by {@link PersistentState} plugin, after saving value under given key in browser local storage.
+ *
+ * The `persistentStateSave` hook is fired even when the {@link Options#persistentState} option is disabled.
  *
  * @event Hooks#persistentStateSave
  * @param {string} key Key.
@@ -1145,7 +1148,7 @@ var REGISTERED_HOOKS = [
  * @event Hooks#beforeColumnSort
  * @param {Array} currentSortConfig Current sort configuration (for all sorted columns).
  * @param {Array} destinationSortConfigs Destination sort configuration (for all sorted columns).
- * @returns {boolean | void} If `false` the column will not be sorted, `true` otherwise.
+ * @returns {boolean | undefined} If `false` the column will not be sorted, `true` otherwise.
  */
 'beforeColumnSort',
 /**
@@ -1330,7 +1333,7 @@ var REGISTERED_HOOKS = [
  *                                     [documentation](@/guides/columns/column-moving.md).
  *                                     It's `undefined` when `dragColumns` function wasn't called.
  * @param {boolean} movePossible Indicates if it's possible to move rows to the desired position.
- * @returns {void | boolean} If `false` the column will not be moved, `true` otherwise.
+ * @returns {undefined | boolean} If `false` the column will not be moved, `true` otherwise.
  */
 'beforeColumnMove',
 /**
@@ -1438,7 +1441,7 @@ var REGISTERED_HOOKS = [
  * @param {number} newSize Calculated new row height.
  * @param {number} row Visual index of the resized row.
  * @param {boolean} isDoubleClick Flag that determines whether there was a double-click.
- * @returns {number} Returns the new row size or `undefined` if row size should be calculated automatically.
+ * @returns {number|undefined} Returns the new row size or `undefined` if row size should be calculated automatically.
  */
 'beforeRowResize',
 /**
@@ -1471,7 +1474,7 @@ var REGISTERED_HOOKS = [
  * @event Hooks#beforeStretchingColumnWidth
  * @param {number} stretchedWidth Calculated width.
  * @param {number} column Visual column index.
- * @returns {number} Returns new width which will be applied to the column element.
+ * @returns {number|undefined} Returns new width which will be applied to the column element.
  */
 'beforeStretchingColumnWidth',
 /**

package/pluginHooks.mjs

@@ -89,7 +89,7 @@ var REGISTERED_HOOKS = [
  * __Note:__ For performance reasons, the `changes` array is null for `"loadData"` source.
  *
  * @event Hooks#afterChange
- * @param {Array} changes 2D array containing information about each of the edited cells `[[row, prop, oldVal, newVal], ...]`.
+ * @param {Array[]} changes 2D array containing information about each of the edited cells `[[row, prop, oldVal, newVal], ...]`. `row` is a visual row index.
  * @param {string} [source] String that identifies source of hook call ([list of all available sources](@/guides/getting-started/events-and-hooks.md#definition-for-source-argument)).
  * @example
  * ```js
@@ -225,7 +225,7 @@ var REGISTERED_HOOKS = [
  */
 'afterCreateRow',
 /**
- * Fired after the current cell is deselected.
+ * Fired after all selected cells are deselected.
  *
  * @event Hooks#afterDeselect
  */
@@ -606,7 +606,7 @@ var REGISTERED_HOOKS = [
  * @param {string|number} prop Property name / visual column index.
  * @param {string} [source] String that identifies source of hook call
  *                          ([list of all available sources](@/guides/getting-started/events-and-hooks.md#definition-for-source-argument)).
- * @returns {void | boolean} If `false` the cell will be marked as invalid, `true` otherwise.
+ * @returns {undefined | boolean} If `false` the cell will be marked as invalid, `true` otherwise.
  */
 'afterValidate',
 /**
@@ -676,10 +676,10 @@ var REGISTERED_HOOKS = [
  * table rendering.
  *
  * @event Hooks#beforeChange
- * @param {Array[]} changes 2D array containing information about each of the edited cells.
+ * @param {Array[]} changes 2D array containing information about each of the edited cells `[[row, prop, oldVal, newVal], ...]`. `row` is a visual row index.
  * @param {string} [source] String that identifies source of hook call
  *                          ([list of all available sources](@/guides/getting-started/events-and-hooks.md#definition-for-source-argument)).
- * @returns {void | boolean} If `false` all changes were cancelled, `true` otherwise.
+ * @returns {undefined | boolean} If `false` all changes were cancelled, `true` otherwise.
  * @example
  * ```js
  * // To disregard a single change, set changes[i] to null or remove it from array using changes.splice(i, 1).
@@ -929,7 +929,7 @@ var REGISTERED_HOOKS = [
  * @param {number} column Visual column index.
  * @param {string} key The updated meta key.
  * @param {*} value The updated meta value.
- * @returns {*|boolean} If false is returned the action is canceled.
+ * @returns {boolean|undefined} If false is returned the action is canceled.
  */
 'beforeSetCellMeta',
 /**
@@ -1063,6 +1063,7 @@ var REGISTERED_HOOKS = [
  * @param {boolean} topmost If set to `true`, it returns the TD element from the topmost overlay. For example,
  *                          if the wanted cell is in the range of fixed rows, it will return a TD element
  *                          from the `top` overlay.
+ * @returns {undefined|number[]}
  */
 'modifyGetCellCoords',
 /**
@@ -1094,8 +1095,9 @@ var REGISTERED_HOOKS = [
  */
 'beforeHighlightingColumnHeader',
 /**
- * Fired by {@link PersistentState} plugin, after loading value, saved under given key, from browser local storage. This hook is fired when
- * {@link Options#persistentState} option is enabled.
+ * Fired by {@link PersistentState} plugin, after loading value, saved under given key, from browser local storage.
+ *
+ * The `persistentStateLoad` hook is fired even when the {@link Options#persistentState} option is disabled.
  *
  * @event Hooks#persistentStateLoad
  * @param {string} key Key.
@@ -1111,8 +1113,9 @@ var REGISTERED_HOOKS = [
  */
 'persistentStateReset',
 /**
- * Fired by {@link PersistentState} plugin, after saving value under given key in browser local storage. This hook is fired when
- * {@link Options#persistentState} option is enabled.
+ * Fired by {@link PersistentState} plugin, after saving value under given key in browser local storage.
+ *
+ * The `persistentStateSave` hook is fired even when the {@link Options#persistentState} option is disabled.
  *
  * @event Hooks#persistentStateSave
  * @param {string} key Key.
@@ -1128,7 +1131,7 @@ var REGISTERED_HOOKS = [
  * @event Hooks#beforeColumnSort
  * @param {Array} currentSortConfig Current sort configuration (for all sorted columns).
  * @param {Array} destinationSortConfigs Destination sort configuration (for all sorted columns).
- * @returns {boolean | void} If `false` the column will not be sorted, `true` otherwise.
+ * @returns {boolean | undefined} If `false` the column will not be sorted, `true` otherwise.
  */
 'beforeColumnSort',
 /**
@@ -1313,7 +1316,7 @@ var REGISTERED_HOOKS = [
  *                                     [documentation](@/guides/columns/column-moving.md).
  *                                     It's `undefined` when `dragColumns` function wasn't called.
  * @param {boolean} movePossible Indicates if it's possible to move rows to the desired position.
- * @returns {void | boolean} If `false` the column will not be moved, `true` otherwise.
+ * @returns {undefined | boolean} If `false` the column will not be moved, `true` otherwise.
  */
 'beforeColumnMove',
 /**
@@ -1421,7 +1424,7 @@ var REGISTERED_HOOKS = [
  * @param {number} newSize Calculated new row height.
  * @param {number} row Visual index of the resized row.
  * @param {boolean} isDoubleClick Flag that determines whether there was a double-click.
- * @returns {number} Returns the new row size or `undefined` if row size should be calculated automatically.
+ * @returns {number|undefined} Returns the new row size or `undefined` if row size should be calculated automatically.
  */
 'beforeRowResize',
 /**
@@ -1454,7 +1457,7 @@ var REGISTERED_HOOKS = [
  * @event Hooks#beforeStretchingColumnWidth
  * @param {number} stretchedWidth Calculated width.
  * @param {number} column Visual column index.
- * @returns {number} Returns new width which will be applied to the column element.
+ * @returns {number|undefined} Returns new width which will be applied to the column element.
  */
 'beforeStretchingColumnWidth',
 /**

package/plugins/base/base.js

@@ -12,6 +12,8 @@ require("core-js/modules/es.function.name.js");
 
 require("core-js/modules/es.array.from.js");
 
+require("core-js/modules/es.regexp.exec.js");
+
 exports.__esModule = true;
 exports.PLUGIN_KEY = exports.BasePlugin = void 0;
 
@@ -29,10 +31,6 @@ require("core-js/modules/es.weak-map.js");
 
 require("core-js/modules/web.dom-collections.for-each.js");
 
-require("core-js/modules/es.regexp.exec.js");
-
-require("core-js/modules/es.string.split.js");
-
 require("core-js/modules/es.array.concat.js");
 
 require("core-js/modules/es.array.join.js");

package/plugins/base/base.mjs

@@ -29,8 +29,6 @@ import "core-js/modules/es.string.iterator.js";
 import "core-js/modules/web.dom-collections.iterator.js";
 import "core-js/modules/es.weak-map.js";
 import "core-js/modules/web.dom-collections.for-each.js";
-import "core-js/modules/es.regexp.exec.js";
-import "core-js/modules/es.string.split.js";
 import "core-js/modules/es.array.concat.js";
 import "core-js/modules/es.array.join.js";
 import "core-js/modules/es.array.index-of.js";
@@ -42,6 +40,7 @@ import "core-js/modules/es.symbol.iterator.js";
 import "core-js/modules/es.array.slice.js";
 import "core-js/modules/es.function.name.js";
 import "core-js/modules/es.array.from.js";
+import "core-js/modules/es.regexp.exec.js";
 import { defineGetter, objectEach } from "../../helpers/object.mjs";
 import { arrayEach } from "../../helpers/array.mjs";
 import { getPluginsNames, hasPlugin } from "../registry.mjs";

package/plugins/columnSorting/sortService/engine.js

@@ -1,17 +1,13 @@
 "use strict";
 
-require("core-js/modules/es.array.sort.js");
-
 exports.__esModule = true;
 exports.FIRST_BEFORE_SECOND = exports.FIRST_AFTER_SECOND = exports.DO_NOT_SWAP = void 0;
 exports.sort = sort;
 
-var _mergeSort = _interopRequireDefault(require("../../../utils/sortingAlgorithms/mergeSort"));
+require("core-js/modules/es.array.sort.js");
 
 var _registry = require("./registry");
 
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
 var DO_NOT_SWAP = 0;
 exports.DO_NOT_SWAP = DO_NOT_SWAP;
 var FIRST_BEFORE_SECOND = -1;
@@ -32,5 +28,5 @@ function sort(indexesWithData, rootComparatorId) {
     argsForRootComparator[_key - 2] = arguments[_key];
   }
 
-  (0, _mergeSort.default)(indexesWithData, rootComparator.apply(void 0, argsForRootComparator));
+  indexesWithData.sort(rootComparator.apply(void 0, argsForRootComparator));
 }

package/plugins/columnSorting/sortService/engine.mjs

@@ -1,4 +1,4 @@
-import mergeSort from "../../../utils/sortingAlgorithms/mergeSort.mjs";
+import "core-js/modules/es.array.sort.js";
 import { getRootComparator } from "./registry.mjs";
 export var DO_NOT_SWAP = 0;
 export var FIRST_BEFORE_SECOND = -1;
@@ -16,5 +16,5 @@ export function sort(indexesWithData, rootComparatorId) {
     argsForRootComparator[_key - 2] = arguments[_key];
   }
 
-  mergeSort(indexesWithData, rootComparator.apply(void 0, argsForRootComparator));
+  indexesWithData.sort(rootComparator.apply(void 0, argsForRootComparator));
 }

package/plugins/columnSummary/columnSummary.js

@@ -31,12 +31,10 @@ exports.PLUGIN_PRIORITY = exports.PLUGIN_KEY = exports.ColumnSummary = void 0;
 
 require("core-js/modules/es.array.concat.js");
 
-require("core-js/modules/es.regexp.exec.js");
-
-require("core-js/modules/es.string.split.js");
-
 require("core-js/modules/es.array.index-of.js");
 
+require("core-js/modules/es.regexp.exec.js");
+
 require("core-js/modules/es.string.replace.js");
 
 require("core-js/modules/es.object.set-prototype-of.js");
@@ -51,6 +49,8 @@ var _endpoints = _interopRequireDefault(require("./endpoints"));
 
 var _templateLiteralTag = require("../../helpers/templateLiteralTag");
 
+var _utils = require("./utils");
+
 var _templateObject;
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
@@ -340,11 +340,15 @@ var ColumnSummary = /*#__PURE__*/function (_BasePlugin) {
       var biggestDecimalPlacesCount = 0;
 
       do {
-        cellValue = this.getCellValue(i, col) || 0;
-        var decimalPlaces = ("".concat(cellValue).split('.')[1] || []).length || 1;
+        cellValue = this.getCellValue(i, col);
+        cellValue = (0, _utils.isNullishOrNaN)(cellValue) ? null : cellValue;
+
+        if (cellValue !== null) {
+          var decimalPlaces = ("".concat(cellValue).split('.')[1] || []).length || 1;
 
-        if (decimalPlaces > biggestDecimalPlacesCount) {
-          biggestDecimalPlacesCount = decimalPlaces;
+          if (decimalPlaces > biggestDecimalPlacesCount) {
+            biggestDecimalPlacesCount = decimalPlaces;
+          }
         }
 
         sum += cellValue || 0;
@@ -400,7 +404,7 @@ var ColumnSummary = /*#__PURE__*/function (_BasePlugin) {
      * @param {Array} rowRange Range for the calculation.
      * @param {number} col Column index.
      * @param {string} type `'min'` or `'max'`.
-     * @returns {number} Min or max value.
+     * @returns {number|null} Min or max value.
      */
 
   }, {
@@ -411,7 +415,8 @@ var ColumnSummary = /*#__PURE__*/function (_BasePlugin) {
       var cellValue;
 
       do {
-        cellValue = this.getCellValue(i, col) || null;
+        cellValue = this.getCellValue(i, col);
+        cellValue = (0, _utils.isNullishOrNaN)(cellValue) ? null : cellValue;
 
         if (result === null) {
           result = cellValue;
@@ -453,8 +458,9 @@ var ColumnSummary = /*#__PURE__*/function (_BasePlugin) {
 
       do {
         cellValue = this.getCellValue(i, col);
+        cellValue = (0, _utils.isNullishOrNaN)(cellValue) ? null : cellValue;
 
-        if (!cellValue) {
+        if (cellValue === null) {
           counter += 1;
         }
 

package/plugins/columnSummary/columnSummary.mjs

@@ -20,9 +20,8 @@ var _templateObject;
 function _taggedTemplateLiteral(strings, raw) { if (!raw) { raw = strings.slice(0); } return Object.freeze(Object.defineProperties(strings, { raw: { value: Object.freeze(raw) } })); }
 
 import "core-js/modules/es.array.concat.js";
-import "core-js/modules/es.regexp.exec.js";
-import "core-js/modules/es.string.split.js";
 import "core-js/modules/es.array.index-of.js";
+import "core-js/modules/es.regexp.exec.js";
 import "core-js/modules/es.string.replace.js";
 
 function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
@@ -53,6 +52,7 @@ import { BasePlugin } from "../base/index.mjs";
 import { objectEach } from "../../helpers/object.mjs";
 import Endpoints from "./endpoints.mjs";
 import { toSingleLine } from "../../helpers/templateLiteralTag.mjs";
+import { isNullishOrNaN } from "./utils.mjs";
 export var PLUGIN_KEY = 'columnSummary';
 export var PLUGIN_PRIORITY = 220;
 /**
@@ -309,11 +309,15 @@ export var ColumnSummary = /*#__PURE__*/function (_BasePlugin) {
       var biggestDecimalPlacesCount = 0;
 
       do {
-        cellValue = this.getCellValue(i, col) || 0;
-        var decimalPlaces = ("".concat(cellValue).split('.')[1] || []).length || 1;
+        cellValue = this.getCellValue(i, col);
+        cellValue = isNullishOrNaN(cellValue) ? null : cellValue;
 
-        if (decimalPlaces > biggestDecimalPlacesCount) {
-          biggestDecimalPlacesCount = decimalPlaces;
+        if (cellValue !== null) {
+          var decimalPlaces = ("".concat(cellValue).split('.')[1] || []).length || 1;
+
+          if (decimalPlaces > biggestDecimalPlacesCount) {
+            biggestDecimalPlacesCount = decimalPlaces;
+          }
         }
 
         sum += cellValue || 0;
@@ -369,7 +373,7 @@ export var ColumnSummary = /*#__PURE__*/function (_BasePlugin) {
      * @param {Array} rowRange Range for the calculation.
      * @param {number} col Column index.
      * @param {string} type `'min'` or `'max'`.
-     * @returns {number} Min or max value.
+     * @returns {number|null} Min or max value.
      */
 
   }, {
@@ -380,7 +384,8 @@ export var ColumnSummary = /*#__PURE__*/function (_BasePlugin) {
       var cellValue;
 
       do {
-        cellValue = this.getCellValue(i, col) || null;
+        cellValue = this.getCellValue(i, col);
+        cellValue = isNullishOrNaN(cellValue) ? null : cellValue;
 
         if (result === null) {
           result = cellValue;
@@ -422,8 +427,9 @@ export var ColumnSummary = /*#__PURE__*/function (_BasePlugin) {
 
       do {
         cellValue = this.getCellValue(i, col);
+        cellValue = isNullishOrNaN(cellValue) ? null : cellValue;
 
-        if (!cellValue) {
+        if (cellValue === null) {
           counter += 1;
         }
 

package/plugins/columnSummary/utils.js

@@ -0,0 +1,14 @@
+"use strict";
+
+exports.__esModule = true;
+exports.isNullishOrNaN = isNullishOrNaN;
+
+/**
+ * Returns `true` if the value is one of the type: `null`, `undefined` or `NaN`.
+ *
+ * @param {*} value The value to check.
+ * @returns {boolean}
+ */
+function isNullishOrNaN(value) {
+  return value === null || value === undefined || isNaN(value);
+}

package/plugins/columnSummary/utils.mjs

@@ -0,0 +1,9 @@
+/**
+ * Returns `true` if the value is one of the type: `null`, `undefined` or `NaN`.
+ *
+ * @param {*} value The value to check.
+ * @returns {boolean}
+ */
+export function isNullishOrNaN(value) {
+  return value === null || value === undefined || isNaN(value);
+}

package/plugins/contextMenu/commandExecutor.js

@@ -3,10 +3,6 @@
 exports.__esModule = true;
 exports.default = void 0;
 
-require("core-js/modules/es.regexp.exec.js");
-
-require("core-js/modules/es.string.split.js");
-
 require("core-js/modules/es.array.join.js");
 
 var _array = require("../../helpers/array");

package/plugins/contextMenu/commandExecutor.mjs

@@ -1,5 +1,3 @@
-import "core-js/modules/es.regexp.exec.js";
-import "core-js/modules/es.string.split.js";
 import "core-js/modules/es.array.join.js";
 
 function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }

package/plugins/contextMenu/contextMenu.js

@@ -330,6 +330,10 @@ var ContextMenu = /*#__PURE__*/function (_BasePlugin) {
     /**
      * Execute context menu command.
      *
+     * The `executeCommand()` method works only for selected cells.
+     *
+     * When no cells are selected, `executeCommand()` doesn't do anything.
+     *
      * You can execute all predefined commands:
      *  * `'row_above'` - Insert row above
      *  * `'row_below'` - Insert row below
@@ -351,7 +355,7 @@ var ContextMenu = /*#__PURE__*/function (_BasePlugin) {
      * Or you can execute command registered in settings where `key` is your command name.
      *
      * @param {string} commandName The command name to be executed.
-     * @param {*} params Additional paramteres passed to command executor module.
+     * @param {*} params Additional parameters passed to command executor module.
      */
 
   }, {

package/plugins/contextMenu/contextMenu.mjs

@@ -294,6 +294,10 @@ export var ContextMenu = /*#__PURE__*/function (_BasePlugin) {
     /**
      * Execute context menu command.
      *
+     * The `executeCommand()` method works only for selected cells.
+     *
+     * When no cells are selected, `executeCommand()` doesn't do anything.
+     *
      * You can execute all predefined commands:
      *  * `'row_above'` - Insert row above
      *  * `'row_below'` - Insert row below
@@ -315,7 +319,7 @@ export var ContextMenu = /*#__PURE__*/function (_BasePlugin) {
      * Or you can execute command registered in settings where `key` is your command name.
      *
      * @param {string} commandName The command name to be executed.
-     * @param {*} params Additional paramteres passed to command executor module.
+     * @param {*} params Additional parameters passed to command executor module.
      */
 
   }, {

package/plugins/contextMenu/menu.js

@@ -607,6 +607,10 @@ var Menu = /*#__PURE__*/function () {
     /**
      * Execute menu command.
      *
+     * The `executeCommand()` method works only for selected cells.
+     *
+     * When no cells are selected, `executeCommand()` doesn't do anything.
+     *
      * @param {Event} [event] The mouse event object.
      */
 

package/plugins/contextMenu/menu.mjs

@@ -574,6 +574,10 @@ var Menu = /*#__PURE__*/function () {
     /**
      * Execute menu command.
      *
+     * The `executeCommand()` method works only for selected cells.
+     *
+     * When no cells are selected, `executeCommand()` doesn't do anything.
+     *
      * @param {Event} [event] The mouse event object.
      */
 

package/plugins/copyPaste/copyPaste.js

@@ -433,6 +433,8 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
     /**
      * Simulates the paste action.
      *
+     * Due to security reasons, modern browsers disallow reading from the system clipboard.
+     *
      * @param {string} pastableText Value as raw string to paste.
      * @param {string} [pastableHtml=''] Value as HTML to paste.
      */

package/plugins/copyPaste/copyPaste.mjs

@@ -384,6 +384,8 @@ export var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
     /**
      * Simulates the paste action.
      *
+     * Due to security reasons, modern browsers disallow reading from the system clipboard.
+     *
      * @param {string} pastableText Value as raw string to paste.
      * @param {string} [pastableHtml=''] Value as HTML to paste.
      */

package/plugins/dropdownMenu/dropdownMenu.js

@@ -360,6 +360,10 @@ var DropdownMenu = /*#__PURE__*/function (_BasePlugin) {
     /**
      * Executes context menu command.
      *
+     * The `executeCommand()` method works only for selected cells.
+     *
+     * When no cells are selected, `executeCommand()` doesn't do anything.
+     *
      * You can execute all predefined commands:
      *  * `'row_above'` - Insert row above
      *  * `'row_below'` - Insert row below

package/plugins/dropdownMenu/dropdownMenu.mjs

@@ -324,6 +324,10 @@ export var DropdownMenu = /*#__PURE__*/function (_BasePlugin) {
     /**
      * Executes context menu command.
      *
+     * The `executeCommand()` method works only for selected cells.
+     *
+     * When no cells are selected, `executeCommand()` doesn't do anything.
+     *
      * You can execute all predefined commands:
      *  * `'row_above'` - Insert row above
      *  * `'row_below'` - Insert row below