handsontable 0.0.0-next-50e428d-20231026 → 0.0.0-next-42d5bd7-20231027

package/pluginHooks.js

@@ -1505,26 +1505,35 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * 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.
  *
+ * Note: Please keep in mind since @14.0.0 the method arguments has been changed.
+ *
  * @event Hooks#beforeCut
- * @param {Array[]} data An array of arrays which contains data to cut.
- * @param {object[]} coords An array of objects with ranges of the visual indexes (`startRow`, `startCol`, `endRow`, `endCol`)
- *                       which will be cut out.
+ * @param {object} clipboardData Information about cut action which is going to happen.
+ * @param {Function} clipboardData.removeRow Remove row from the copied dataset.
+ * @param {Function} clipboardData.removeColumn Remove column from the copied dataset.
+ * @param {Function} clipboardData.insertAtRow Insert values at row index.
+ * @param {Function} clipboardData.insertAtColumn Insert values at column index.
+ * @param {Function} clipboardData.setCellAt Change headers or cells in the copied dataset.
+ * @param {Function} clipboardData.getCellAt Get headers or cells from the copied dataset.
+ * @param {Function} clipboardData.getData Gets copied data stored as array of arrays.
+ * @param {Function} clipboardData.getMetaInfo Gets meta information for the copied data.
+ * @param {Function} clipboardData.getRanges Returns ranges related to copied part of Handsontable.
  * @returns {*} If returns `false` then operation of the cutting out is canceled.
  * @example
  * ::: only-for javascript
  * ```js
- * // To disregard a single row, remove it from the array using data.splice(i, 1).
+ * // To disregard a single row or column, remove it from copied dataset using `removeRows`/`removeColumns` method on the object from the first callback argument.
  * new Handsontable(element, {
- *   beforeCut: function(data, coords) {
- *     // data -> [[1, 2, 3], [4, 5, 6]]
- *     data.splice(0, 1);
- *     // data -> [[4, 5, 6]]
- *     // coords -> [{startRow: 0, startCol: 0, endRow: 1, endCol: 2}]
+ *   beforeCut: function(clipboardData) {
+ *     // clipboardData.getData() -> [[1, 2, 3], [4, 5, 6]]
+ *    clipboardData.removeRows([0]);
+ *    clipboardData.removeColumns([0]);
+ *     // clipboardData.getData() -> [[5, 6]]
  *   }
  * });
  * // To cancel a cutting action, just return `false`.
  * new Handsontable(element, {
- *   beforeCut: function(data, coords) {
+ *   beforeCut: function(clipboardData) {
  *     return false;
  *   }
  * });
@@ -1533,18 +1542,18 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  *
  * ::: only-for react
  * ```jsx
- * // To disregard a single row, remove it from the array using data.splice(i, 1).
+ * // To disregard a single row or column, remove it from copied dataset using `removeRows`/`removeColumns` method on the object from the first callback argument.
  * <HotTable
- *   beforeCut={(data, coords) => {
- *     // data -> [[1, 2, 3], [4, 5, 6]]
- *     data.splice(0, 1);
- *     // data -> [[4, 5, 6]]
- *     // coords -> [{startRow: 0, startCol: 0, endRow: 1, endCol: 2}]
+ *   beforeCut={(clipboardData) => {
+ *     // clipboardData.getData() -> [[1, 2, 3], [4, 5, 6]]
+ *    clipboardData.removeRows([0]);
+ *    clipboardData.removeColumns([0]);
+ *     // clipboardData.getData() -> [[5, 6]]
  *   }}
  * />
  * // To cancel a cutting action, just return `false`.
  * <HotTable
- *   beforeCut={(data, coords) => {
+ *   beforeCut={(clipboardData) => {
  *     return false;
  *   }}
  * />
@@ -1556,33 +1565,50 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * Fired by {@link CopyPaste} plugin after data was cut out from the table. This hook is fired when
  * {@link Options#copyPaste} option is enabled.
  *
+ * Note: Please keep in mind since @14.0.0 the method arguments has been changed.
+ *
  * @event Hooks#afterCut
- * @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.
+ * @param {object} clipboardData Information about already performed cut action.
+ * @param {Function} clipboardData.removeRow Remove row from the copied dataset.
+ * @param {Function} clipboardData.removeColumn Remove column from the copied dataset.
+ * @param {Function} clipboardData.insertAtRow Insert values at row index.
+ * @param {Function} clipboardData.insertAtColumn Insert values at column index.
+ * @param {Function} clipboardData.setCellAt Change headers or cells in the copied dataset.
+ * @param {Function} clipboardData.getCellAt Get headers or cells from the copied dataset.
+ * @param {Function} clipboardData.getData Gets copied data stored as array of arrays.
+ * @param {Function} clipboardData.getMetaInfo Gets meta information for the copied data.
+ * @param {Function} clipboardData.getRanges Returns ranges related to copied part of Handsontable.
  */
 'afterCut',
 /**
  * Fired before values are copied to the clipboard.
  *
+ * Note: Please keep in mind since @14.0.0 the method arguments has been changed.
+ *
  * @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.
+ * @param {object} clipboardData Information about copy action which is going to happen.
+ * @param {Function} clipboardData.removeRow Remove row from the copied dataset.
+ * @param {Function} clipboardData.removeColumn Remove column from the copied dataset.
+ * @param {Function} clipboardData.insertAtRow Insert values at row index.
+ * @param {Function} clipboardData.insertAtColumn Insert values at column index.
+ * @param {Function} clipboardData.setCellAt Change headers or cells in the copied dataset.
+ * @param {Function} clipboardData.getCellAt Get headers or cells from the copied dataset.
+ * @param {Function} clipboardData.getData Gets copied data stored as array of arrays.
+ * @param {Function} clipboardData.getMetaInfo Gets meta information for the copied data.
+ * @param {Function} clipboardData.getRanges Returns ranges related to copied part of Handsontable.
  * @returns {*} If returns `false` then copying is canceled.
  *
  * @example
  * ::: only-for javascript
  * ```js
- * // To disregard a single row, remove it from array using data.splice(i, 1).
+ * // To disregard a single row or column, remove it from copied dataset using `removeRows`/`removeColumns` method on the object from the first callback argument.
  * ...
  * new Handsontable(document.getElementById('example'), {
- *   beforeCopy: (data, coords) => {
- *     // data -> [[1, 2, 3], [4, 5, 6]]
- *     data.splice(0, 1);
- *     // data -> [[4, 5, 6]]
- *     // coords -> [{startRow: 0, startCol: 0, endRow: 1, endCol: 2}]
+ *   beforeCopy: (clipboardData) => {
+ *     // clipboardData.getData() -> [[1, 2, 3], [4, 5, 6]]
+ *    clipboardData.removeRows([0]);
+ *    clipboardData.removeColumns([0]);
+ *     // clipboardData.getData() -> [[5, 6]]
  *   }
  * });
  * ...
@@ -1590,7 +1616,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * // To cancel copying, return false from the callback.
  * ...
  * new Handsontable(document.getElementById('example'), {
- *   beforeCopy: (data, coords) => {
+ *   beforeCopy: (clipboardData) => {
  *     return false;
  *   }
  * });
@@ -1600,14 +1626,14 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  *
  * ::: only-for react
  * ```jsx
- * // To disregard a single row, remove it from array using data.splice(i, 1).
+ * // To disregard a single row or column, remove it from copied dataset using `removeRows`/`removeColumns` method on the object from the first callback argument.
  * ...
  * <HotTable
- *   beforeCopy={(data, coords) => {
- *     // data -> [[1, 2, 3], [4, 5, 6]]
- *     data.splice(0, 1);
- *     // data -> [[4, 5, 6]]
- *     // coords -> [{startRow: 0, startCol: 0, endRow: 1, endCol: 2}]
+ *   beforeCopy={(clipboardData) => {
+ *     // clipboardData.getData() -> [[1, 2, 3], [4, 5, 6]]
+ *    clipboardData.removeRows([0]);
+ *    clipboardData.removeColumns([0]);
+ *     // clipboardData.getData() -> [[5, 6]]
  *   }}
  * />
  * ...
@@ -1615,7 +1641,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * // To cancel copying, return false from the callback.
  * ...
  * <HotTable
- *   beforeCopy={(data, coords) => {
+ *   beforeCopy={(clipboardData) => {
  *     return false;
  *   }}
  * />
@@ -1628,37 +1654,55 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * Fired by {@link CopyPaste} plugin after data are pasted into table. This hook is fired when {@link Options#copyPaste}
  * option is enabled.
  *
+ * Note: Please keep in mind since @14.0.0 the method arguments has been changed.
+ *
  * @event Hooks#afterCopy
- * @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.
+ * @param {object} clipboardData Information about already performed copy action.
+ * @param {Function} clipboardData.removeRow Remove row from the copied dataset.
+ * @param {Function} clipboardData.removeColumn Remove column from the copied dataset.
+ * @param {Function} clipboardData.insertAtRow Insert values at row index.
+ * @param {Function} clipboardData.insertAtColumn Insert values at column index.
+ * @param {Function} clipboardData.setCellAt Change headers or cells in the copied dataset.
+ * @param {Function} clipboardData.getCellAt Get headers or cells from the copied dataset.
+ * @param {Function} clipboardData.getData Gets copied data stored as array of arrays.
+ * @param {Function} clipboardData.getMetaInfo Gets meta information for the copied data.
+ * @param {Function} clipboardData.getRanges Returns ranges related to copied part of Handsontable.
  */
 'afterCopy',
 /**
  * Fired by {@link CopyPaste} plugin before values are pasted into table. This hook is fired when
  * {@link Options#copyPaste} option is enabled.
  *
+ * Note: Please keep in mind since @14.0.0 the method arguments has been changed.
+ *
  * @event Hooks#beforePaste
- * @param {Array[]} data An array of arrays which contains data to paste.
- * @param {object[]} coords An array of objects with ranges of the visual indexes (`startRow`, `startCol`, `endRow`, `endCol`)
- *                       that correspond to the previously selected area.
+ * @param {object} clipboardData Information about paste action which is going to happen.
+ * @param {Function} clipboardData.removeRow Remove row from the pasted dataset.
+ * @param {Function} clipboardData.removeColumn Remove column from the pasted dataset.
+ * @param {Function} clipboardData.insertAtRow Insert values at row index.
+ * @param {Function} clipboardData.insertAtColumn Insert values at column index.
+ * @param {Function} clipboardData.setCellAt Change headers or cells in the pasted dataset.
+ * @param {Function} clipboardData.getCellAt Get headers or cells from the pasted dataset.
+ * @param {Function} clipboardData.getData Gets copied data stored as array of arrays.
+ * @param {Function} clipboardData.getMetaInfo Gets meta information for the copied data.
+ * @param {Function} clipboardData.getSource Gets information about source of the copied data
+ * (Handsontable, table or string).
  * @returns {*} If returns `false` then pasting is canceled.
  * @example
  * ```js
  * ::: only-for javascript
- * // To disregard a single row, remove it from array using data.splice(i, 1).
+ * // To disregard a single row or column, remove it from copied dataset using `removeRows`/`removeColumns` method on the object from the first callback argument.
  * new Handsontable(example, {
- *   beforePaste: (data, coords) => {
- *     // data -> [[1, 2, 3], [4, 5, 6]]
- *     data.splice(0, 1);
- *     // data -> [[4, 5, 6]]
- *     // coords -> [{startRow: 0, startCol: 0, endRow: 1, endCol: 2}]
+ *   beforePaste: (clipboardData) => {
+ *     // clipboardData.getData() -> [[1, 2, 3], [4, 5, 6]]
+ *    clipboardData.removeRows([0]);
+ *    clipboardData.removeColumns([0]);
+ *     // clipboardData.getData() -> [[5, 6]]
  *   }
  * });
  * // To cancel pasting, return false from the callback.
  * new Handsontable(example, {
- *   beforePaste: (data, coords) => {
+ *   beforePaste: (clipboardData) => {
  *     return false;
  *   }
  * });
@@ -1667,18 +1711,18 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  *
  * ::: only-for react
  * ```jsx
- * // To disregard a single row, remove it from array using data.splice(i, 1).
+ * // To disregard a single row or column, remove it from copied dataset using `removeRows`/`removeColumns` method on the object from the first callback argument.
  * <HotTable
- *   beforePaste={(data, coords) => {
- *     // data -> [[1, 2, 3], [4, 5, 6]]
- *     data.splice(0, 1);
- *     // data -> [[4, 5, 6]]
- *     // coords -> [{startRow: 0, startCol: 0, endRow: 1, endCol: 2}]
+ *   beforePaste={(clipboardData) => {
+ *     // clipboardData.getData() -> [[1, 2, 3], [4, 5, 6]]
+ *    clipboardData.removeRows([0]);
+ *    clipboardData.removeColumns([0]);
+ *     // clipboardData.getData() -> [[5, 6]]
  *   }}
  * />
  * // To cancel pasting, return false from the callback.
  * <HotTable
- *   beforePaste={(data, coords) => {
+ *   beforePaste={(clipboardData) => {
  *     return false;
  *   }}
  * />
@@ -1690,10 +1734,20 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * Fired by {@link CopyPaste} plugin after values are pasted into table. This hook is fired when
  * {@link Options#copyPaste} option is enabled.
  *
+ * Note: Please keep in mind since @14.0.0 the method arguments has been changed.
+ *
  * @event Hooks#afterPaste
- * @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.
+ * @param {object} clipboardData Information about already performed paste action.
+ * @param {Function} clipboardData.removeRow Remove row from the pasted dataset.
+ * @param {Function} clipboardData.removeColumn Remove column from the pasted dataset.
+ * @param {Function} clipboardData.insertAtRow Insert values at row index.
+ * @param {Function} clipboardData.insertAtColumn Insert values at column index.
+ * @param {Function} clipboardData.setCellAt Change headers or cells in the pasted dataset.
+ * @param {Function} clipboardData.getCellAt Get headers or cells from the pasted dataset.
+ * @param {Function} clipboardData.getData Gets copied data stored as array of arrays.
+ * @param {Function} clipboardData.getMetaInfo Gets meta information for the copied data.
+ * @param {Function} clipboardData.getSource Gets information about source of the copied data
+ * (Handsontable, table or string).
  */
 'afterPaste',
 /**

package/pluginHooks.mjs

@@ -1503,26 +1503,35 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * 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.
  *
+ * Note: Please keep in mind since @14.0.0 the method arguments has been changed.
+ *
  * @event Hooks#beforeCut
- * @param {Array[]} data An array of arrays which contains data to cut.
- * @param {object[]} coords An array of objects with ranges of the visual indexes (`startRow`, `startCol`, `endRow`, `endCol`)
- *                       which will be cut out.
+ * @param {object} clipboardData Information about cut action which is going to happen.
+ * @param {Function} clipboardData.removeRow Remove row from the copied dataset.
+ * @param {Function} clipboardData.removeColumn Remove column from the copied dataset.
+ * @param {Function} clipboardData.insertAtRow Insert values at row index.
+ * @param {Function} clipboardData.insertAtColumn Insert values at column index.
+ * @param {Function} clipboardData.setCellAt Change headers or cells in the copied dataset.
+ * @param {Function} clipboardData.getCellAt Get headers or cells from the copied dataset.
+ * @param {Function} clipboardData.getData Gets copied data stored as array of arrays.
+ * @param {Function} clipboardData.getMetaInfo Gets meta information for the copied data.
+ * @param {Function} clipboardData.getRanges Returns ranges related to copied part of Handsontable.
  * @returns {*} If returns `false` then operation of the cutting out is canceled.
  * @example
  * ::: only-for javascript
  * ```js
- * // To disregard a single row, remove it from the array using data.splice(i, 1).
+ * // To disregard a single row or column, remove it from copied dataset using `removeRows`/`removeColumns` method on the object from the first callback argument.
  * new Handsontable(element, {
- *   beforeCut: function(data, coords) {
- *     // data -> [[1, 2, 3], [4, 5, 6]]
- *     data.splice(0, 1);
- *     // data -> [[4, 5, 6]]
- *     // coords -> [{startRow: 0, startCol: 0, endRow: 1, endCol: 2}]
+ *   beforeCut: function(clipboardData) {
+ *     // clipboardData.getData() -> [[1, 2, 3], [4, 5, 6]]
+ *    clipboardData.removeRows([0]);
+ *    clipboardData.removeColumns([0]);
+ *     // clipboardData.getData() -> [[5, 6]]
  *   }
  * });
  * // To cancel a cutting action, just return `false`.
  * new Handsontable(element, {
- *   beforeCut: function(data, coords) {
+ *   beforeCut: function(clipboardData) {
  *     return false;
  *   }
  * });
@@ -1531,18 +1540,18 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  *
  * ::: only-for react
  * ```jsx
- * // To disregard a single row, remove it from the array using data.splice(i, 1).
+ * // To disregard a single row or column, remove it from copied dataset using `removeRows`/`removeColumns` method on the object from the first callback argument.
  * <HotTable
- *   beforeCut={(data, coords) => {
- *     // data -> [[1, 2, 3], [4, 5, 6]]
- *     data.splice(0, 1);
- *     // data -> [[4, 5, 6]]
- *     // coords -> [{startRow: 0, startCol: 0, endRow: 1, endCol: 2}]
+ *   beforeCut={(clipboardData) => {
+ *     // clipboardData.getData() -> [[1, 2, 3], [4, 5, 6]]
+ *    clipboardData.removeRows([0]);
+ *    clipboardData.removeColumns([0]);
+ *     // clipboardData.getData() -> [[5, 6]]
  *   }}
  * />
  * // To cancel a cutting action, just return `false`.
  * <HotTable
- *   beforeCut={(data, coords) => {
+ *   beforeCut={(clipboardData) => {
  *     return false;
  *   }}
  * />
@@ -1554,33 +1563,50 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * Fired by {@link CopyPaste} plugin after data was cut out from the table. This hook is fired when
  * {@link Options#copyPaste} option is enabled.
  *
+ * Note: Please keep in mind since @14.0.0 the method arguments has been changed.
+ *
  * @event Hooks#afterCut
- * @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.
+ * @param {object} clipboardData Information about already performed cut action.
+ * @param {Function} clipboardData.removeRow Remove row from the copied dataset.
+ * @param {Function} clipboardData.removeColumn Remove column from the copied dataset.
+ * @param {Function} clipboardData.insertAtRow Insert values at row index.
+ * @param {Function} clipboardData.insertAtColumn Insert values at column index.
+ * @param {Function} clipboardData.setCellAt Change headers or cells in the copied dataset.
+ * @param {Function} clipboardData.getCellAt Get headers or cells from the copied dataset.
+ * @param {Function} clipboardData.getData Gets copied data stored as array of arrays.
+ * @param {Function} clipboardData.getMetaInfo Gets meta information for the copied data.
+ * @param {Function} clipboardData.getRanges Returns ranges related to copied part of Handsontable.
  */
 'afterCut',
 /**
  * Fired before values are copied to the clipboard.
  *
+ * Note: Please keep in mind since @14.0.0 the method arguments has been changed.
+ *
  * @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.
+ * @param {object} clipboardData Information about copy action which is going to happen.
+ * @param {Function} clipboardData.removeRow Remove row from the copied dataset.
+ * @param {Function} clipboardData.removeColumn Remove column from the copied dataset.
+ * @param {Function} clipboardData.insertAtRow Insert values at row index.
+ * @param {Function} clipboardData.insertAtColumn Insert values at column index.
+ * @param {Function} clipboardData.setCellAt Change headers or cells in the copied dataset.
+ * @param {Function} clipboardData.getCellAt Get headers or cells from the copied dataset.
+ * @param {Function} clipboardData.getData Gets copied data stored as array of arrays.
+ * @param {Function} clipboardData.getMetaInfo Gets meta information for the copied data.
+ * @param {Function} clipboardData.getRanges Returns ranges related to copied part of Handsontable.
  * @returns {*} If returns `false` then copying is canceled.
  *
  * @example
  * ::: only-for javascript
  * ```js
- * // To disregard a single row, remove it from array using data.splice(i, 1).
+ * // To disregard a single row or column, remove it from copied dataset using `removeRows`/`removeColumns` method on the object from the first callback argument.
  * ...
  * new Handsontable(document.getElementById('example'), {
- *   beforeCopy: (data, coords) => {
- *     // data -> [[1, 2, 3], [4, 5, 6]]
- *     data.splice(0, 1);
- *     // data -> [[4, 5, 6]]
- *     // coords -> [{startRow: 0, startCol: 0, endRow: 1, endCol: 2}]
+ *   beforeCopy: (clipboardData) => {
+ *     // clipboardData.getData() -> [[1, 2, 3], [4, 5, 6]]
+ *    clipboardData.removeRows([0]);
+ *    clipboardData.removeColumns([0]);
+ *     // clipboardData.getData() -> [[5, 6]]
  *   }
  * });
  * ...
@@ -1588,7 +1614,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * // To cancel copying, return false from the callback.
  * ...
  * new Handsontable(document.getElementById('example'), {
- *   beforeCopy: (data, coords) => {
+ *   beforeCopy: (clipboardData) => {
  *     return false;
  *   }
  * });
@@ -1598,14 +1624,14 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  *
  * ::: only-for react
  * ```jsx
- * // To disregard a single row, remove it from array using data.splice(i, 1).
+ * // To disregard a single row or column, remove it from copied dataset using `removeRows`/`removeColumns` method on the object from the first callback argument.
  * ...
  * <HotTable
- *   beforeCopy={(data, coords) => {
- *     // data -> [[1, 2, 3], [4, 5, 6]]
- *     data.splice(0, 1);
- *     // data -> [[4, 5, 6]]
- *     // coords -> [{startRow: 0, startCol: 0, endRow: 1, endCol: 2}]
+ *   beforeCopy={(clipboardData) => {
+ *     // clipboardData.getData() -> [[1, 2, 3], [4, 5, 6]]
+ *    clipboardData.removeRows([0]);
+ *    clipboardData.removeColumns([0]);
+ *     // clipboardData.getData() -> [[5, 6]]
  *   }}
  * />
  * ...
@@ -1613,7 +1639,7 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * // To cancel copying, return false from the callback.
  * ...
  * <HotTable
- *   beforeCopy={(data, coords) => {
+ *   beforeCopy={(clipboardData) => {
  *     return false;
  *   }}
  * />
@@ -1626,37 +1652,55 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * Fired by {@link CopyPaste} plugin after data are pasted into table. This hook is fired when {@link Options#copyPaste}
  * option is enabled.
  *
+ * Note: Please keep in mind since @14.0.0 the method arguments has been changed.
+ *
  * @event Hooks#afterCopy
- * @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.
+ * @param {object} clipboardData Information about already performed copy action.
+ * @param {Function} clipboardData.removeRow Remove row from the copied dataset.
+ * @param {Function} clipboardData.removeColumn Remove column from the copied dataset.
+ * @param {Function} clipboardData.insertAtRow Insert values at row index.
+ * @param {Function} clipboardData.insertAtColumn Insert values at column index.
+ * @param {Function} clipboardData.setCellAt Change headers or cells in the copied dataset.
+ * @param {Function} clipboardData.getCellAt Get headers or cells from the copied dataset.
+ * @param {Function} clipboardData.getData Gets copied data stored as array of arrays.
+ * @param {Function} clipboardData.getMetaInfo Gets meta information for the copied data.
+ * @param {Function} clipboardData.getRanges Returns ranges related to copied part of Handsontable.
  */
 'afterCopy',
 /**
  * Fired by {@link CopyPaste} plugin before values are pasted into table. This hook is fired when
  * {@link Options#copyPaste} option is enabled.
  *
+ * Note: Please keep in mind since @14.0.0 the method arguments has been changed.
+ *
  * @event Hooks#beforePaste
- * @param {Array[]} data An array of arrays which contains data to paste.
- * @param {object[]} coords An array of objects with ranges of the visual indexes (`startRow`, `startCol`, `endRow`, `endCol`)
- *                       that correspond to the previously selected area.
+ * @param {object} clipboardData Information about paste action which is going to happen.
+ * @param {Function} clipboardData.removeRow Remove row from the pasted dataset.
+ * @param {Function} clipboardData.removeColumn Remove column from the pasted dataset.
+ * @param {Function} clipboardData.insertAtRow Insert values at row index.
+ * @param {Function} clipboardData.insertAtColumn Insert values at column index.
+ * @param {Function} clipboardData.setCellAt Change headers or cells in the pasted dataset.
+ * @param {Function} clipboardData.getCellAt Get headers or cells from the pasted dataset.
+ * @param {Function} clipboardData.getData Gets copied data stored as array of arrays.
+ * @param {Function} clipboardData.getMetaInfo Gets meta information for the copied data.
+ * @param {Function} clipboardData.getSource Gets information about source of the copied data
+ * (Handsontable, table or string).
  * @returns {*} If returns `false` then pasting is canceled.
  * @example
  * ```js
  * ::: only-for javascript
- * // To disregard a single row, remove it from array using data.splice(i, 1).
+ * // To disregard a single row or column, remove it from copied dataset using `removeRows`/`removeColumns` method on the object from the first callback argument.
  * new Handsontable(example, {
- *   beforePaste: (data, coords) => {
- *     // data -> [[1, 2, 3], [4, 5, 6]]
- *     data.splice(0, 1);
- *     // data -> [[4, 5, 6]]
- *     // coords -> [{startRow: 0, startCol: 0, endRow: 1, endCol: 2}]
+ *   beforePaste: (clipboardData) => {
+ *     // clipboardData.getData() -> [[1, 2, 3], [4, 5, 6]]
+ *    clipboardData.removeRows([0]);
+ *    clipboardData.removeColumns([0]);
+ *     // clipboardData.getData() -> [[5, 6]]
  *   }
  * });
  * // To cancel pasting, return false from the callback.
  * new Handsontable(example, {
- *   beforePaste: (data, coords) => {
+ *   beforePaste: (clipboardData) => {
  *     return false;
  *   }
  * });
@@ -1665,18 +1709,18 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  *
  * ::: only-for react
  * ```jsx
- * // To disregard a single row, remove it from array using data.splice(i, 1).
+ * // To disregard a single row or column, remove it from copied dataset using `removeRows`/`removeColumns` method on the object from the first callback argument.
  * <HotTable
- *   beforePaste={(data, coords) => {
- *     // data -> [[1, 2, 3], [4, 5, 6]]
- *     data.splice(0, 1);
- *     // data -> [[4, 5, 6]]
- *     // coords -> [{startRow: 0, startCol: 0, endRow: 1, endCol: 2}]
+ *   beforePaste={(clipboardData) => {
+ *     // clipboardData.getData() -> [[1, 2, 3], [4, 5, 6]]
+ *    clipboardData.removeRows([0]);
+ *    clipboardData.removeColumns([0]);
+ *     // clipboardData.getData() -> [[5, 6]]
  *   }}
  * />
  * // To cancel pasting, return false from the callback.
  * <HotTable
- *   beforePaste={(data, coords) => {
+ *   beforePaste={(clipboardData) => {
  *     return false;
  *   }}
  * />
@@ -1688,10 +1732,20 @@ const REGISTERED_HOOKS = [/* eslint-disable jsdoc/require-description-complete-s
  * Fired by {@link CopyPaste} plugin after values are pasted into table. This hook is fired when
  * {@link Options#copyPaste} option is enabled.
  *
+ * Note: Please keep in mind since @14.0.0 the method arguments has been changed.
+ *
  * @event Hooks#afterPaste
- * @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.
+ * @param {object} clipboardData Information about already performed paste action.
+ * @param {Function} clipboardData.removeRow Remove row from the pasted dataset.
+ * @param {Function} clipboardData.removeColumn Remove column from the pasted dataset.
+ * @param {Function} clipboardData.insertAtRow Insert values at row index.
+ * @param {Function} clipboardData.insertAtColumn Insert values at column index.
+ * @param {Function} clipboardData.setCellAt Change headers or cells in the pasted dataset.
+ * @param {Function} clipboardData.getCellAt Get headers or cells from the pasted dataset.
+ * @param {Function} clipboardData.getData Gets copied data stored as array of arrays.
+ * @param {Function} clipboardData.getMetaInfo Gets meta information for the copied data.
+ * @param {Function} clipboardData.getSource Gets information about source of the copied data
+ * (Handsontable, table or string).
  */
 'afterPaste',
 /**

package/plugins/collapsibleColumns/collapsibleColumns.js

@@ -11,6 +11,7 @@ var _element = require("../../helpers/dom/element");
 var _eventManager = _interopRequireDefault(require("../../eventManager"));
 var _event = require("../../helpers/dom/event");
 var _a11y = require("../../helpers/a11y");
+var _constants = require("../../i18n/constants");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function _classPrivateFieldInitSpec(obj, privateMap, value) { _checkPrivateRedeclaration(obj, privateMap); privateMap.set(obj, value); }
 function _checkPrivateRedeclaration(obj, privateCollection) { if (privateCollection.has(obj)) { throw new TypeError("Cannot initialize the same private elements twice on an object"); } }
@@ -520,7 +521,7 @@ class CollapsibleColumns extends _base.BasePlugin {
 
         // Add ARIA tags
         if (isAriaTagsEnabled) {
-          (0, _element.setAttribute)(TH, ...(0, _a11y.A11Y_EXPANDED)(false));
+          (0, _element.setAttribute)(TH, [(0, _a11y.A11Y_EXPANDED)(false), (0, _a11y.A11Y_DESCRIPTION)(this.hot.getTranslatedPhrase(_constants.COLUMN_HEADER_DESCRIPTION_EXPAND_COLUMN))]);
         }
       } else {
         (0, _element.addClass)(collapsibleElement, 'expanded');
@@ -528,7 +529,7 @@ class CollapsibleColumns extends _base.BasePlugin {
 
         // Add ARIA tags
         if (isAriaTagsEnabled) {
-          (0, _element.setAttribute)(TH, ...(0, _a11y.A11Y_EXPANDED)(true));
+          (0, _element.setAttribute)(TH, [(0, _a11y.A11Y_EXPANDED)(true), (0, _a11y.A11Y_DESCRIPTION)(this.hot.getTranslatedPhrase(_constants.COLUMN_HEADER_DESCRIPTION_COLLAPSE_COLUMN))]);
         }
       }
       if (isAriaTagsEnabled) {