handsontable 12.4.0-next-e18d05a-20230523 → 13.0.0-next-900887e-20230613

package/3rdparty/walkontable/src/border.js

@@ -5,6 +5,7 @@ require("core-js/modules/es.array.iterator.js");
 require("core-js/modules/es.string.iterator.js");
 require("core-js/modules/web.dom-collections.iterator.js");
 require("core-js/modules/es.array.slice.js");
+require("core-js/modules/es.regexp.to-string.js");
 require("core-js/modules/es.function.name.js");
 require("core-js/modules/es.array.from.js");
 require("core-js/modules/es.regexp.exec.js");

package/3rdparty/walkontable/src/border.mjs

@@ -17,6 +17,7 @@ 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";
 import "core-js/modules/es.array.slice.js";
+import "core-js/modules/es.regexp.to-string.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";

package/3rdparty/walkontable/src/selection.js

@@ -5,6 +5,7 @@ require("core-js/modules/es.array.iterator.js");
 require("core-js/modules/es.string.iterator.js");
 require("core-js/modules/web.dom-collections.iterator.js");
 require("core-js/modules/es.array.slice.js");
+require("core-js/modules/es.regexp.to-string.js");
 require("core-js/modules/es.function.name.js");
 require("core-js/modules/es.array.from.js");
 require("core-js/modules/es.regexp.exec.js");

package/3rdparty/walkontable/src/selection.mjs

@@ -20,6 +20,7 @@ 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";
 import "core-js/modules/es.array.slice.js";
+import "core-js/modules/es.regexp.to-string.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";

package/3rdparty/walkontable/src/table.js

@@ -4,6 +4,7 @@ require("core-js/modules/es.symbol.iterator.js");
 require("core-js/modules/es.array.iterator.js");
 require("core-js/modules/web.dom-collections.iterator.js");
 require("core-js/modules/es.array.slice.js");
+require("core-js/modules/es.regexp.to-string.js");
 require("core-js/modules/es.regexp.exec.js");
 exports.__esModule = true;
 exports.default = void 0;

package/3rdparty/walkontable/src/table.mjs

@@ -24,6 +24,7 @@ import "core-js/modules/es.symbol.iterator.js";
 import "core-js/modules/es.array.iterator.js";
 import "core-js/modules/web.dom-collections.iterator.js";
 import "core-js/modules/es.array.slice.js";
+import "core-js/modules/es.regexp.to-string.js";
 import "core-js/modules/es.regexp.exec.js";
 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, _toPropertyKey(descriptor.key), descriptor); } }

package/CHANGELOG.md

@@ -9,6 +9,20 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 <!-- UNVERSIONED -->
 
+## [13.0.0] - 2023-06-20
+
+### Added
+- **Breaking change**: Angular: Rewritten the Angular wrapper to be based on Angular@12 and to support Angular versions 12 and above. [#10396](https://github.com/handsontable/handsontable/pull/10396)
+
+### Changed
+- **Breaking change**: Swapping `beforeChange` and `afterSetDataAtCell`/`afterSetDataAtRowProp` hooks order [#677](https://github.com/handsontable/handsontable/pull/677)
+
+### Removed
+- **Breaking change**: Removed the the deprecated hooks, methods and options for 13.0.0. [#10407](https://github.com/handsontable/handsontable/issues/10407)
+
+### Fixed
+- Changed margins for context-menu in RTL mode and fixed problem with wrong position for check inside Read only entry [#10375](https://github.com/handsontable/handsontable/pull/10375)
+
 ## [12.4.0] - 2023-05-23
 
 ### Added

package/base.js

@@ -44,8 +44,8 @@ Handsontable.hooks = _pluginHooks.default.getSingleton();
 Handsontable.CellCoords = _src.CellCoords;
 Handsontable.CellRange = _src.CellRange;
 Handsontable.packageName = 'handsontable';
-Handsontable.buildDate = "23/05/2023 08:49:12";
-Handsontable.version = "12.4.0-next-e18d05a-20230523";
+Handsontable.buildDate = "13/06/2023 14:32:06";
+Handsontable.version = "13.0.0-next-900887e-20230613";
 Handsontable.languages = {
   dictionaryKeys: _registry.dictionaryKeys,
   getLanguageDictionary: _registry.getLanguageDictionary,

package/base.mjs

@@ -35,8 +35,8 @@ Handsontable.hooks = Hooks.getSingleton();
 Handsontable.CellCoords = CellCoords;
 Handsontable.CellRange = CellRange;
 Handsontable.packageName = 'handsontable';
-Handsontable.buildDate = "23/05/2023 08:49:26";
-Handsontable.version = "12.4.0-next-e18d05a-20230523";
+Handsontable.buildDate = "13/06/2023 14:32:21";
+Handsontable.version = "13.0.0-next-900887e-20230613";
 Handsontable.languages = {
   dictionaryKeys: dictionaryKeys,
   getLanguageDictionary: getLanguageDictionary,

package/core.d.ts

@@ -18,8 +18,8 @@ import { Plugins } from './plugins';
 import { CellType } from './cellTypes';
 import { ShortcutManager } from './shortcuts';
 
-type AlterActions = 'insert_row' | 'insert_row_above' | 'insert_row_below' |
-                    'insert_col' | 'insert_col_start' | 'insert_col_end' |
+type AlterActions = 'insert_row_above' | 'insert_row_below' |
+                    'insert_col_start' | 'insert_col_end' |
                     'remove_row' | 'remove_col';
 
 export default class Core {
@@ -113,8 +113,7 @@ export default class Core {
   listen(): void;
   loadData(data: CellValue[][] | RowObject[], source?: string): void;
   populateFromArray(row: number, col: number, input: CellValue[][], endRow?: number,
-    endCol?: number, source?: string, method?: 'shift_down' | 'shift_right' | 'overwrite',
-    direction?: 'left' | 'right' | 'up' | 'down', deltas?: any[]): void;
+    endCol?: number, source?: string, method?: 'shift_down' | 'shift_right' | 'overwrite'): void;
   propToCol(prop: string | number): number;
   redo(): void;
   refreshDimensions(): void;

package/core.js

@@ -3,8 +3,8 @@
 require("core-js/modules/es.symbol.js");
 require("core-js/modules/es.symbol.description.js");
 require("core-js/modules/es.symbol.iterator.js");
+require("core-js/modules/es.regexp.to-string.js");
 require("core-js/modules/es.function.name.js");
-require("core-js/modules/es.object.freeze.js");
 exports.__esModule = true;
 exports.default = Core;
 require("core-js/modules/es.array.iterator.js");
@@ -23,6 +23,7 @@ require("core-js/modules/es.array.fill.js");
 require("core-js/modules/es.array.map.js");
 require("core-js/modules/es.regexp.exec.js");
 require("core-js/modules/es.string.replace.js");
+require("core-js/modules/es.array.filter.js");
 require("core-js/modules/es.array.from.js");
 require("core-js/modules/es.array.index-of.js");
 require("core-js/modules/es.array.reverse.js");
@@ -34,8 +35,6 @@ var _element = require("./helpers/dom/element");
 var _function = require("./helpers/function");
 var _mixed = require("./helpers/mixed");
 var _browser = require("./helpers/browser");
-var _console = require("./helpers/console");
-var _templateLiteralTag = require("./helpers/templateLiteralTag");
 var _editorManager = _interopRequireDefault(require("./editorManager"));
 var _eventManager = _interopRequireDefault(require("./eventManager"));
 var _object = require("./helpers/object");
@@ -60,10 +59,8 @@ var _selection = require("./selection");
 var _dataMap = require("./dataMap");
 var _uniqueMap = require("./utils/dataStructures/uniqueMap");
 var _shortcuts = require("./shortcuts");
-var _templateObject, _templateObject2;
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 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); }
-function _taggedTemplateLiteral(strings, raw) { if (!raw) { raw = strings.slice(0); } return Object.freeze(Object.defineProperties(strings, { raw: { value: Object.freeze(raw) } })); }
 function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
 function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function _iterableToArrayLimit(arr, i) { var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"]; if (null != _i) { var _s, _e, _x, _r, _arr = [], _n = !0, _d = !1; try { if (_x = (_i = _i.call(arr)).next, 0 === i) { if (Object(_i) !== _i) return; _n = !1; } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0); } catch (err) { _d = !0, _e = err; } finally { try { if (!_n && null != _i.return && (_r = _i.return(), Object(_r) !== _r)) return; } finally { if (_d) throw _e; } } return _arr; } }
@@ -76,6 +73,13 @@ function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToAr
 function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
 var SHORTCUTS_GROUP = 'gridDefault';
 var activeGuid = null;
+
+/**
+ * A set of deprecated feature names.
+ *
+ * @type {Set<string>}
+ */
+// eslint-disable-next-line no-unused-vars
 var deprecationWarns = new Set();
 
 /* eslint-disable jsdoc/require-description-complete-sentence */
@@ -504,13 +508,6 @@ function Core(rootElement, userSettings) {
 
       /* eslint-disable no-case-declarations */
       switch (action) {
-        case 'insert_row':
-          // backward compatibility
-          if (!deprecationWarns.has(action)) {
-            deprecationWarns.add(action);
-            (0, _console.warn)((0, _templateLiteralTag.toSingleLine)(_templateObject || (_templateObject = _taggedTemplateLiteral(["The `", "` action of the `alter()` method is deprecated and will be removed \n                              in the next major release of Handsontable. Use the `insert_row_above` action instead."], ["The \\`", "\\` action of the \\`alter()\\` method is deprecated and will be removed\\x20\n                              in the next major release of Handsontable. Use the \\`insert_row_above\\` action instead."])), action));
-          }
-        // falls through
         case 'insert_row_below':
         case 'insert_row_above':
           var numberOfSourceRows = instance.countSourceRows();
@@ -521,11 +518,9 @@ function Core(rootElement, userSettings) {
           // `above` is the default behavior for creating new rows
           var insertRowMode = action === 'insert_row_below' ? 'below' : 'above';
 
-          // The line below ensures backward compatibility of the `alter()` method's `insert_row` action.
-          // Calling the `insert_row` action with no arguments adds a new row at the end of the data set.
           // Calling the `insert_row_above` action adds a new row at the beginning of the data set.
           // eslint-disable-next-line no-param-reassign
-          index = (_index = index) !== null && _index !== void 0 ? _index : action === 'insert_row' || insertRowMode === 'below' ? numberOfSourceRows : 0;
+          index = (_index = index) !== null && _index !== void 0 ? _index : insertRowMode === 'below' ? numberOfSourceRows : 0;
           var _datamap$createRow = datamap.createRow(index, amount, {
               source: source,
               mode: insertRowMode
@@ -564,23 +559,14 @@ function Core(rootElement, userSettings) {
           }
 
           break;
-        case 'insert_col':
-          // backward compatibility
-          if (!deprecationWarns.has(action)) {
-            deprecationWarns.add(action);
-            (0, _console.warn)((0, _templateLiteralTag.toSingleLine)(_templateObject2 || (_templateObject2 = _taggedTemplateLiteral(["The `", "` action of the `alter()` method is deprecated and will be removed \n                              in the next major release of Handsontable. Use the `insert_col_start` action instead."], ["The \\`", "\\` action of the \\`alter()\\` method is deprecated and will be removed\\x20\n                              in the next major release of Handsontable. Use the \\`insert_col_start\\` action instead."])), action));
-          }
-        // falls through
         case 'insert_col_start':
         case 'insert_col_end':
           // "start" is a default behavior for creating new columns
           var insertColumnMode = action === 'insert_col_end' ? 'end' : 'start';
 
-          // The line below ensures backward compatibility of the `alter()` method's `insert_col` action.
-          // Calling the `insert_col` action with no arguments adds a new column to the right of the data set.
           // Calling the `insert_col_start` action adds a new column to the left of the data set.
           // eslint-disable-next-line no-param-reassign
-          index = (_index2 = index) !== null && _index2 !== void 0 ? _index2 : action === 'insert_col' || insertColumnMode === 'end' ? instance.countSourceCols() : 0;
+          index = (_index2 = index) !== null && _index2 !== void 0 ? _index2 : insertColumnMode === 'end' ? instance.countSourceCols() : 0;
           var _datamap$createCol = datamap.createCol(index, amount, {
               source: source,
               mode: insertColumnMode
@@ -851,13 +837,9 @@ function Core(rootElement, userSettings) {
      * @param {object} [end] End selection position (only for drag-down mode). Visual indexes.
      * @param {string} [source="populateFromArray"] Source information string.
      * @param {string} [method="overwrite"] Populate method. Possible options: `shift_down`, `shift_right`, `overwrite`.
-     * @param {string} direction (left|right|up|down) String specifying the direction.
-     * @param {Array} deltas The deltas array. A difference between values of adjacent cells.
-     *                       Useful **only** when the type of handled cells is `numeric`.
      * @returns {object|undefined} Ending td in pasted area (only if any cell was changed).
      */
-    populateFromArray: function populateFromArray(start, input, end, source, method, direction, deltas) {
-      // TODO: either remove or implement the `direction` argument. Currently it's not working at all.
+    populateFromArray: function populateFromArray(start, input, end, source, method) {
       var r;
       var rlen;
       var c;
@@ -945,11 +927,6 @@ function Core(rootElement, userSettings) {
           // overwrite and other not specified options
           current.row = start.row;
           current.col = start.col;
-          var selected = {
-            // selected range
-            row: end && start ? end.row - start.row + 1 : 1,
-            col: end && start ? end.col - start.col + 1 : 1
-          };
           var skippedRow = 0;
           var skippedColumn = 0;
           var pushData = true;
@@ -1010,16 +987,6 @@ function Core(rootElement, userSettings) {
               var visualColumn = c - skippedColumn;
               var value = getInputValue(visualRow, visualColumn);
               var orgValue = instance.getDataAtCell(current.row, current.col);
-              var index = {
-                row: visualRow,
-                col: visualColumn
-              };
-              if (source === 'Autofill.fill') {
-                var result = instance.runHooks('beforeAutofillInsidePopulate', index, direction, input, deltas, {}, selected);
-                if (result) {
-                  value = (0, _mixed.isUndefined)(result.value) ? value : result.value;
-                }
-              }
               if (value !== null && _typeof(value) === 'object') {
                 // when 'value' is array and 'orgValue' is null, set 'orgValue' to
                 // an empty array so that the null value can be compared to 'value'
@@ -1189,15 +1156,8 @@ function Core(rootElement, userSettings) {
       return;
     }
     var activeEditor = instance.getActiveEditor();
-    var beforeChangeResult = instance.runHooks('beforeChange', changes, source || 'edit');
-    var shouldBeCanceled = true;
-    if (beforeChangeResult === false) {
-      if (activeEditor) {
-        activeEditor.cancelChanges();
-      }
-      return;
-    }
     var waitingForValidator = new ValidatorsQueue();
+    var shouldBeCanceled = true;
     waitingForValidator.onQueueEmpty = function (isValid) {
       if (activeEditor && shouldBeCanceled) {
         activeEditor.cancelChanges();
@@ -1206,43 +1166,37 @@ function Core(rootElement, userSettings) {
     };
 
     for (var i = changes.length - 1; i >= 0; i--) {
-      if (changes[i] === null) {
-        changes.splice(i, 1);
-      } else {
-        var _changes$i = _slicedToArray(changes[i], 4),
-          row = _changes$i[0],
-          prop = _changes$i[1],
-          newValue = _changes$i[3];
-        var col = datamap.propToCol(prop);
-        var cellProperties = instance.getCellMeta(row, col);
-        if (cellProperties.type === 'numeric' && typeof newValue === 'string' && (0, _number.isNumericLike)(newValue)) {
-          changes[i][3] = getParsedNumber(newValue);
-        }
+      var _changes$i = _slicedToArray(changes[i], 4),
+        row = _changes$i[0],
+        prop = _changes$i[1],
+        newValue = _changes$i[3];
+      var col = datamap.propToCol(prop);
+      var cellProperties = instance.getCellMeta(row, col);
+      if (cellProperties.type === 'numeric' && typeof newValue === 'string' && (0, _number.isNumericLike)(newValue)) {
+        changes[i][3] = getParsedNumber(newValue);
+      }
 
-        /* eslint-disable no-loop-func */
-        if (instance.getCellValidator(cellProperties)) {
-          waitingForValidator.addValidatorToQueue();
-          instance.validateCell(changes[i][3], cellProperties, function (index, cellPropertiesReference) {
-            return function (result) {
-              if (typeof result !== 'boolean') {
-                throw new Error('Validation error: result is not boolean');
-              }
-              if (result === false && cellPropertiesReference.allowInvalid === false) {
-                shouldBeCanceled = false;
-                changes.splice(index, 1); // cancel the change
-                cellPropertiesReference.valid = true; // we cancelled the change, so cell value is still valid
-
-                var cell = instance.getCell(cellPropertiesReference.visualRow, cellPropertiesReference.visualCol);
-                if (cell !== null) {
-                  (0, _element.removeClass)(cell, tableMeta.invalidCellClassName);
-                }
-                // index -= 1;
+      /* eslint-disable no-loop-func */
+      if (instance.getCellValidator(cellProperties)) {
+        waitingForValidator.addValidatorToQueue();
+        instance.validateCell(changes[i][3], cellProperties, function (index, cellPropertiesReference) {
+          return function (result) {
+            if (typeof result !== 'boolean') {
+              throw new Error('Validation error: result is not boolean');
+            }
+            if (result === false && cellPropertiesReference.allowInvalid === false) {
+              shouldBeCanceled = false;
+              changes.splice(index, 1); // cancel the change
+              cellPropertiesReference.valid = true; // we cancelled the change, so cell value is still valid
+
+              var cell = instance.getCell(cellPropertiesReference.visualRow, cellPropertiesReference.visualCol);
+              if (cell !== null) {
+                (0, _element.removeClass)(cell, tableMeta.invalidCellClassName);
               }
-
-              waitingForValidator.removeValidatorFormQueue();
-            };
-          }(i, cellProperties), source);
-        }
+            }
+            waitingForValidator.removeValidatorFormQueue();
+          };
+        }(i, cellProperties), source);
       }
     }
     waitingForValidator.checkIfQueueIsEmpty();
@@ -1432,6 +1386,31 @@ function Core(rootElement, userSettings) {
     return [[row, propOrCol, value]];
   }
 
+  /**
+   * Process changes prepared for applying to the dataset (unifying list of changes, closing an editor - when needed,
+   * calling a hook).
+   *
+   * @private
+   * @param {Array} changes Array of changes in format `[[row, col, value],...]`.
+   * @param {string} [source] String that identifies how this change will be described in the changes array (useful in afterChange or beforeChange callback). Set to 'edit' if left empty.
+   * @returns {Array} List of changes finally applied to the dataset.
+   */
+  function processChanges(changes, source) {
+    var activeEditor = instance.getActiveEditor();
+    var beforeChangeResult = instance.runHooks('beforeChange', changes, source || 'edit');
+    // The `beforeChange` hook could add a `null` for purpose of cancelling some dataset's change.
+    var filteredChanges = changes.filter(function (change) {
+      return change !== null;
+    });
+    if (beforeChangeResult === false || filteredChanges.length === 0) {
+      if (activeEditor) {
+        activeEditor.cancelChanges();
+      }
+      return [];
+    }
+    return filteredChanges;
+  }
+
   /**
    * @description
    * Set new value to a cell. To change many cells at once (recommended way), pass an array of `changes` in format
@@ -1469,9 +1448,10 @@ function Core(rootElement, userSettings) {
     if (!changeSource && _typeof(row) === 'object') {
       changeSource = column;
     }
-    instance.runHooks('afterSetDataAtCell', changes, changeSource);
-    validateChanges(changes, changeSource, function () {
-      applyChanges(changes, changeSource);
+    var processedChanges = processChanges(changes, source);
+    instance.runHooks('afterSetDataAtCell', processedChanges, changeSource);
+    validateChanges(processedChanges, changeSource, function () {
+      applyChanges(processedChanges, changeSource);
     });
   };
 
@@ -1499,9 +1479,10 @@ function Core(rootElement, userSettings) {
     if (!changeSource && _typeof(row) === 'object') {
       changeSource = prop;
     }
-    instance.runHooks('afterSetDataAtRowProp', changes, changeSource);
-    validateChanges(changes, changeSource, function () {
-      applyChanges(changes, changeSource);
+    var processedChanges = processChanges(changes, source);
+    instance.runHooks('afterSetDataAtRowProp', processedChanges, changeSource);
+    validateChanges(processedChanges, changeSource, function () {
+      applyChanges(processedChanges, changeSource);
     });
   };
 
@@ -1576,18 +1557,15 @@ function Core(rootElement, userSettings) {
    * @param {number} [endCol] End visual column index (use when you want to cut input when certain column is reached).
    * @param {string} [source=populateFromArray] Used to identify this call in the resulting events (beforeChange, afterChange).
    * @param {string} [method=overwrite] Populate method, possible values: `'shift_down'`, `'shift_right'`, `'overwrite'`.
-   * @param {string} direction Populate direction, possible values: `'left'`, `'right'`, `'up'`, `'down'`.
-   * @param {Array} deltas The deltas array. A difference between values of adjacent cells.
-   *                       Useful **only** when the type of handled cells is `numeric`.
    * @returns {object|undefined} Ending td in pasted area (only if any cell was changed).
    */
-  this.populateFromArray = function (row, column, input, endRow, endCol, source, method, direction, deltas) {
+  this.populateFromArray = function (row, column, input, endRow, endCol, source, method) {
     if (!(_typeof(input) === 'object' && _typeof(input[0]) === 'object')) {
       throw new Error('populateFromArray parameter `input` must be an array of arrays'); // API changed in 0.9-beta2, let's check if you use it correctly
     }
 
     var c = typeof endRow === 'number' ? instance._createCellCoords(endRow, endCol) : null;
-    return grid.populateFromArray(instance._createCellCoords(row, column), input, c, source, method, direction, deltas);
+    return grid.populateFromArray(instance._createCellCoords(row, column), input, c, source, method);
   };
 
   /**
@@ -2513,10 +2491,11 @@ function Core(rootElement, userSettings) {
    *  | `'insert_col_start'` | Inserts columns before the `index` column. | Inserts columns before the first column. |
    *  | `'insert_col_end'`   | Inserts columns after the `index` column. | Inserts columns after the last column. |
    *  | `'remove_col'`       | Removes columns, starting from the `index` column. | Removes columns, starting from the last column. |
-   *  | `'insert_row'` (<b>Deprecated</b>) |  Inserts rows above the `index` row. | Inserts rows below the last row. |
-   *  | `'insert_col'` (<b>Deprecated</b>) |  Inserts columns before the `index` column. | Inserts columns after the last column. |
    *
-   * The behavior of `'insert_col_start'`, `'insert_col_end'`, and `'insert_col'` depends on your [`layoutDirection`](@/api/options.md#layoutdirection).
+   * Additional information about `'insert_col_start'` and `'insert_col_end'`:
+   * - Their behavior depends on your [`layoutDirection`](@/api/options.md#layoutdirection).
+   * - If the provided `index` is higher than the actual number of columns, Handsontable doesn't generate
+   * the columns missing in between. Instead, the new columns are inserted next to the last column.
    *
    * @memberof Core#
    * @function alter
@@ -2528,8 +2507,6 @@ function Core(rootElement, userSettings) {
    *    <li> `'insert_col_start'` </li>
    *    <li> `'insert_col_end'` </li>
    *    <li> `'remove_col'` </li>
-   *    <li> `'insert_row'` (<b>Deprecated</b>) </li>
-   *    <li> `'insert_col'` (<b>Deprecated</b>) </li>
    * </ul>
    * @param {number|number[]} [index] A visual index of the row/column before or after which the new row/column will be
    *                                inserted or removed. Can also be an array of arrays, in format `[[index, amount],...]`.
@@ -3240,10 +3217,16 @@ function Core(rootElement, userSettings) {
   };
 
   /**
-   * Validates all cells using their validator functions and calls callback when finished.
+   * Validates every cell in the data set,
+   * using a [validator function](@/guides/cell-functions/cell-validator.md) configured for each cell.
    *
-   * If one of the cells is invalid, the callback will be fired with `'valid'` arguments as `false` - otherwise it
-   * would equal `true`.
+   * Doesn't validate cells that are currently [trimmed](@/guides/rows/row-trimming.md),
+   * [hidden](@/guides/rows/row-hiding.md), or [filtered](@/guides/columns/column-filter.md),
+   * as such cells are not included in the data set until you bring them back again.
+   *
+   * After the validation, the `callback` function is fired, with the `valid` argument set to:
+   * - `true` for valid cells
+   * - `false` for invalid cells
    *
    * @memberof Core#
    * @function validateCells