handsontable 0.0.0-next-abfe462-20231207 → 0.0.0-next-3d099da-20231208

package/plugins/mergeCells/mergeCells.js

@@ -17,6 +17,7 @@ var _number = require("../../helpers/number");
 var _utils = require("./utils");
 var _element = require("../../helpers/dom/element");
 var _browser = require("../../helpers/browser");
+var _mixed = require("../../helpers/mixed");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function _classPrivateMethodInitSpec(obj, privateSet) { _checkPrivateRedeclaration(obj, privateSet); privateSet.add(obj); }
 function _classPrivateFieldInitSpec(obj, privateMap, value) { _checkPrivateRedeclaration(obj, privateMap); privateMap.set(obj, value); }
@@ -98,9 +99,26 @@ var _onBeforeDrawAreaBorders = /*#__PURE__*/new WeakSet();
 var _onAfterModifyTransformStart = /*#__PURE__*/new WeakSet();
 var _onAfterDrawSelection = /*#__PURE__*/new WeakSet();
 var _onBeforeRemoveCellClassNames = /*#__PURE__*/new WeakSet();
+var _onBeforePaste = /*#__PURE__*/new WeakSet();
 class MergeCells extends _base.BasePlugin {
   constructor() {
     super(...arguments);
+    /**
+     * `beforePaste` hook callback. Used for manipulating with area of paste (by changing selection) and unmerging cells.
+     *
+     * @private
+     * @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.
+     */
+    _classPrivateMethodInitSpec(this, _onBeforePaste);
     /**
      * `beforeRemoveCellClassNames` hook callback. Used to remove additional class name from all cells in the table.
      *
@@ -464,6 +482,12 @@ class MergeCells extends _base.BasePlugin {
         return false;
       }
     });
+    this.addHook('beforePaste', function () {
+      for (var _len24 = arguments.length, args = new Array(_len24), _key24 = 0; _key24 < _len24; _key24++) {
+        args[_key24] = arguments[_key24];
+      }
+      return _classPrivateMethodGet(_this, _onBeforePaste, _onBeforePaste2).call(_this, ...args);
+    });
     this.registerShortcuts();
     super.enablePlugin();
   }
@@ -749,13 +773,15 @@ class MergeCells extends _base.BasePlugin {
    * @private
    * @param {CellRange} cellRange Selection cell range.
    * @param {boolean} [auto=false] `true` if called automatically by the plugin.
+   * @param {boolean} [unmergePartials=false] If set to `true`, all the merged cells overlapping the range will be unmerged.
    *
    * @fires Hooks#beforeUnmergeCells
    * @fires Hooks#afterUnmergeCells
    */
   unmergeRange(cellRange) {
     let auto = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
-    const mergedCells = this.mergedCellsCollection.getWithinRange(cellRange);
+    let unmergePartials = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
+    const mergedCells = this.mergedCellsCollection.getWithinRange(cellRange, unmergePartials);
     if (!mergedCells) {
       return;
     }
@@ -910,6 +936,7 @@ class MergeCells extends _base.BasePlugin {
       }
     }
   }
+
   /**
    * Modify viewport start when needed. We extend viewport when merged cells aren't fully visible.
    *
@@ -1004,6 +1031,67 @@ class MergeCells extends _base.BasePlugin {
     const renderableColumn = parentColumn >= 0 ? columnMapper.getRenderableFromVisualIndex(firstNonHiddenColumn) : parentColumn;
     return [renderableRow, renderableColumn];
   }
+  /**
+   * Creates cell range.
+   *
+   * @private
+   * @param {number} startRow Visual start row index for the range.
+   * @param {number} startColumn Visual start column index for the range.
+   * @param {number} numberOfRows Number of rows within the range.
+   * @param {number} numberOfColumns Number of columns within the range.
+   * @returns {CellRange}
+   */
+  getCellRange(startRow, startColumn, numberOfRows, numberOfColumns) {
+    const rangeStart = this.hot._createCellCoords(startRow, startColumn);
+    const rangeEnd = this.hot._createCellCoords(startRow + numberOfRows - 1, startColumn + numberOfColumns - 1);
+    return this.hot._createCellRange(rangeStart, rangeStart, rangeEnd);
+  }
+
+  /**
+   * Adjusting selection to select complete area of previously merged cells.
+   *
+   * @private
+   * @param {Array|boolean} listOfUnmergedCells Array of found merged cells of `false` if none were found.
+   * @param {CellRange} unmergedRange Range for unmerged cells.
+   */
+  adjustSelectionAfterPasting(listOfUnmergedCells, unmergedRange) {
+    if (listOfUnmergedCells === false) {
+      return;
+    }
+    listOfUnmergedCells.forEach(mergedCell => {
+      const {
+        row,
+        col,
+        rowspan,
+        colspan
+      } = mergedCell;
+      const mergeRange = this.getCellRange(row, col, rowspan, colspan);
+      unmergedRange.expandByRange(mergeRange);
+    });
+    this.hot.addHookOnce('afterPaste', () => {
+      this.hot.selectCell(unmergedRange.from.row, unmergedRange.from.col, unmergedRange.to.row, unmergedRange.to.col);
+    });
+  }
+
+  /**
+   * Checks if unmerge should be performed.
+   *
+   * @private
+   * @param {Array<object>} mergedCells List of merged cells.
+   * @param {number} pastedRows Number of pasted data rows.
+   * @param {number} pastedColumns Number of pasted data columns.
+   * @returns {boolean}
+   */
+  shouldUnmerge(mergedCells, pastedRows, pastedColumns) {
+    const isCopiedWithMergedCell = (0, _mixed.isDefined)(mergedCells);
+    const copiedOnlyMergedCell = isCopiedWithMergedCell && mergedCells.length === 1 && mergedCells[0].rowspan === pastedRows && mergedCells[0].colspan === pastedColumns;
+    const selectedRangeLast = this.hot.getSelectedRangeLast();
+    const pastingToMergedCell = this.mergedCellsCollection.getByRange(selectedRangeLast) !== false;
+    if (pastedRows === 1 && pastedColumns === 1 && pastingToMergedCell === true) {
+      return false;
+    }
+    return copiedOnlyMergedCell === false || pastingToMergedCell === false;
+  }
 }
 exports.MergeCells = MergeCells;
 function _onAfterInit2() {
@@ -1042,6 +1130,7 @@ function _onModifyTransformStart2(delta) {
     if (!mergeRange.includes(_classPrivateFieldGet(this, _lastDesiredCoords))) {
       _classPrivateFieldSet(this, _lastDesiredCoords, this.hot._createCellCoords(null, null)); // reset outdated version of lastDesiredCoords
     }
+
     newDelta.row = _classPrivateFieldGet(this, _lastDesiredCoords).row ? _classPrivateFieldGet(this, _lastDesiredCoords).row - currentPosition.row : newDelta.row;
     newDelta.col = _classPrivateFieldGet(this, _lastDesiredCoords).col ? _classPrivateFieldGet(this, _lastDesiredCoords).col - currentPosition.col : newDelta.col;
     if (delta.row > 0) {
@@ -1290,4 +1379,41 @@ function _onAfterDrawSelection2(currentRow, currentColumn, cornersOfSelection, l
 }
 function _onBeforeRemoveCellClassNames2() {
   return this.selectionCalculations.getSelectedMergedCellClassNameToRemove();
+}
+function _onBeforePaste2(clipboardData) {
+  const selectedRangeLast = this.hot.getSelectedRangeLast();
+  const data = clipboardData.getData();
+  const pastedRows = data.length;
+  const pastedColumns = data[0].length;
+  const {
+    row: selectionFromRow,
+    col: selectionFromColumn
+  } = selectedRangeLast.from;
+  const selectedRows = selectedRangeLast.getHeight();
+  const selectedColumns = selectedRangeLast.getWidth();
+  if (this.shouldUnmerge(clipboardData.getMetaInfo().mergeCells, pastedRows, pastedColumns) === false) {
+    return;
+  }
+  const pasteRange = this.getCellRange(selectionFromRow, selectionFromColumn, pastedRows, pastedColumns);
+  const populationRange = this.getCellRange(selectionFromRow, selectionFromColumn, Math.max(pastedRows, selectedRows), Math.max(pastedColumns, selectedColumns));
+  let rangeToUnmerge = pasteRange;
+  const mergedCellsWithinPopulation = this.mergedCellsCollection.getWithinRange(populationRange, true);
+
+  // Nothing to unmerge.
+  if (mergedCellsWithinPopulation.length === 0) {
+    return;
+  }
+  if (mergedCellsWithinPopulation.length === 1) {
+    rangeToUnmerge = populationRange;
+  }
+
+  // Checking merged cells on unmerge range right before performing the unmerge.
+  const listOfUnmergedCells = this.mergedCellsCollection.getWithinRange(rangeToUnmerge, true);
+  this.unmergeRange(rangeToUnmerge, false, true);
+
+  // Changing selection (place where the data is populated) only for greater range (at least two merged cells).
+  if (rangeToUnmerge === pasteRange) {
+    this.hot.selectCell(selectionFromRow, selectionFromColumn, pasteRange.endRow, pasteRange.endCol);
+  }
+  this.adjustSelectionAfterPasting(listOfUnmergedCells, rangeToUnmerge);
 }

package/plugins/mergeCells/mergeCells.mjs

@@ -26,6 +26,7 @@ import { rangeEach } from "../../helpers/number.mjs";
 import { applySpanProperties } from "./utils.mjs";
 import { getStyle } from "../../helpers/dom/element.mjs";
 import { isChrome } from "../../helpers/browser.mjs";
+import { isDefined } from "../../helpers/mixed.mjs";
 Hooks.getSingleton().register('beforeMergeCells');
 Hooks.getSingleton().register('afterMergeCells');
 Hooks.getSingleton().register('beforeUnmergeCells');
@@ -94,9 +95,26 @@ var _onBeforeDrawAreaBorders = /*#__PURE__*/new WeakSet();
 var _onAfterModifyTransformStart = /*#__PURE__*/new WeakSet();
 var _onAfterDrawSelection = /*#__PURE__*/new WeakSet();
 var _onBeforeRemoveCellClassNames = /*#__PURE__*/new WeakSet();
+var _onBeforePaste = /*#__PURE__*/new WeakSet();
 export class MergeCells extends BasePlugin {
   constructor() {
     super(...arguments);
+    /**
+     * `beforePaste` hook callback. Used for manipulating with area of paste (by changing selection) and unmerging cells.
+     *
+     * @private
+     * @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.
+     */
+    _classPrivateMethodInitSpec(this, _onBeforePaste);
     /**
      * `beforeRemoveCellClassNames` hook callback. Used to remove additional class name from all cells in the table.
      *
@@ -460,6 +478,12 @@ export class MergeCells extends BasePlugin {
         return false;
       }
     });
+    this.addHook('beforePaste', function () {
+      for (var _len24 = arguments.length, args = new Array(_len24), _key24 = 0; _key24 < _len24; _key24++) {
+        args[_key24] = arguments[_key24];
+      }
+      return _classPrivateMethodGet(_this, _onBeforePaste, _onBeforePaste2).call(_this, ...args);
+    });
     this.registerShortcuts();
     super.enablePlugin();
   }
@@ -745,13 +769,15 @@ export class MergeCells extends BasePlugin {
    * @private
    * @param {CellRange} cellRange Selection cell range.
    * @param {boolean} [auto=false] `true` if called automatically by the plugin.
+   * @param {boolean} [unmergePartials=false] If set to `true`, all the merged cells overlapping the range will be unmerged.
    *
    * @fires Hooks#beforeUnmergeCells
    * @fires Hooks#afterUnmergeCells
    */
   unmergeRange(cellRange) {
     let auto = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
-    const mergedCells = this.mergedCellsCollection.getWithinRange(cellRange);
+    let unmergePartials = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
+    const mergedCells = this.mergedCellsCollection.getWithinRange(cellRange, unmergePartials);
     if (!mergedCells) {
       return;
     }
@@ -906,6 +932,7 @@ export class MergeCells extends BasePlugin {
       }
     }
   }
+
   /**
    * Modify viewport start when needed. We extend viewport when merged cells aren't fully visible.
    *
@@ -1000,6 +1027,67 @@ export class MergeCells extends BasePlugin {
     const renderableColumn = parentColumn >= 0 ? columnMapper.getRenderableFromVisualIndex(firstNonHiddenColumn) : parentColumn;
     return [renderableRow, renderableColumn];
   }
+  /**
+   * Creates cell range.
+   *
+   * @private
+   * @param {number} startRow Visual start row index for the range.
+   * @param {number} startColumn Visual start column index for the range.
+   * @param {number} numberOfRows Number of rows within the range.
+   * @param {number} numberOfColumns Number of columns within the range.
+   * @returns {CellRange}
+   */
+  getCellRange(startRow, startColumn, numberOfRows, numberOfColumns) {
+    const rangeStart = this.hot._createCellCoords(startRow, startColumn);
+    const rangeEnd = this.hot._createCellCoords(startRow + numberOfRows - 1, startColumn + numberOfColumns - 1);
+    return this.hot._createCellRange(rangeStart, rangeStart, rangeEnd);
+  }
+
+  /**
+   * Adjusting selection to select complete area of previously merged cells.
+   *
+   * @private
+   * @param {Array|boolean} listOfUnmergedCells Array of found merged cells of `false` if none were found.
+   * @param {CellRange} unmergedRange Range for unmerged cells.
+   */
+  adjustSelectionAfterPasting(listOfUnmergedCells, unmergedRange) {
+    if (listOfUnmergedCells === false) {
+      return;
+    }
+    listOfUnmergedCells.forEach(mergedCell => {
+      const {
+        row,
+        col,
+        rowspan,
+        colspan
+      } = mergedCell;
+      const mergeRange = this.getCellRange(row, col, rowspan, colspan);
+      unmergedRange.expandByRange(mergeRange);
+    });
+    this.hot.addHookOnce('afterPaste', () => {
+      this.hot.selectCell(unmergedRange.from.row, unmergedRange.from.col, unmergedRange.to.row, unmergedRange.to.col);
+    });
+  }
+
+  /**
+   * Checks if unmerge should be performed.
+   *
+   * @private
+   * @param {Array<object>} mergedCells List of merged cells.
+   * @param {number} pastedRows Number of pasted data rows.
+   * @param {number} pastedColumns Number of pasted data columns.
+   * @returns {boolean}
+   */
+  shouldUnmerge(mergedCells, pastedRows, pastedColumns) {
+    const isCopiedWithMergedCell = isDefined(mergedCells);
+    const copiedOnlyMergedCell = isCopiedWithMergedCell && mergedCells.length === 1 && mergedCells[0].rowspan === pastedRows && mergedCells[0].colspan === pastedColumns;
+    const selectedRangeLast = this.hot.getSelectedRangeLast();
+    const pastingToMergedCell = this.mergedCellsCollection.getByRange(selectedRangeLast) !== false;
+    if (pastedRows === 1 && pastedColumns === 1 && pastingToMergedCell === true) {
+      return false;
+    }
+    return copiedOnlyMergedCell === false || pastingToMergedCell === false;
+  }
 }
 function _onAfterInit2() {
   this.generateFromSettings(this.hot.getSettings()[PLUGIN_KEY]);
@@ -1037,6 +1125,7 @@ function _onModifyTransformStart2(delta) {
     if (!mergeRange.includes(_classPrivateFieldGet(this, _lastDesiredCoords))) {
       _classPrivateFieldSet(this, _lastDesiredCoords, this.hot._createCellCoords(null, null)); // reset outdated version of lastDesiredCoords
     }
+
     newDelta.row = _classPrivateFieldGet(this, _lastDesiredCoords).row ? _classPrivateFieldGet(this, _lastDesiredCoords).row - currentPosition.row : newDelta.row;
     newDelta.col = _classPrivateFieldGet(this, _lastDesiredCoords).col ? _classPrivateFieldGet(this, _lastDesiredCoords).col - currentPosition.col : newDelta.col;
     if (delta.row > 0) {
@@ -1285,4 +1374,41 @@ function _onAfterDrawSelection2(currentRow, currentColumn, cornersOfSelection, l
 }
 function _onBeforeRemoveCellClassNames2() {
   return this.selectionCalculations.getSelectedMergedCellClassNameToRemove();
+}
+function _onBeforePaste2(clipboardData) {
+  const selectedRangeLast = this.hot.getSelectedRangeLast();
+  const data = clipboardData.getData();
+  const pastedRows = data.length;
+  const pastedColumns = data[0].length;
+  const {
+    row: selectionFromRow,
+    col: selectionFromColumn
+  } = selectedRangeLast.from;
+  const selectedRows = selectedRangeLast.getHeight();
+  const selectedColumns = selectedRangeLast.getWidth();
+  if (this.shouldUnmerge(clipboardData.getMetaInfo().mergeCells, pastedRows, pastedColumns) === false) {
+    return;
+  }
+  const pasteRange = this.getCellRange(selectionFromRow, selectionFromColumn, pastedRows, pastedColumns);
+  const populationRange = this.getCellRange(selectionFromRow, selectionFromColumn, Math.max(pastedRows, selectedRows), Math.max(pastedColumns, selectedColumns));
+  let rangeToUnmerge = pasteRange;
+  const mergedCellsWithinPopulation = this.mergedCellsCollection.getWithinRange(populationRange, true);
+
+  // Nothing to unmerge.
+  if (mergedCellsWithinPopulation.length === 0) {
+    return;
+  }
+  if (mergedCellsWithinPopulation.length === 1) {
+    rangeToUnmerge = populationRange;
+  }
+
+  // Checking merged cells on unmerge range right before performing the unmerge.
+  const listOfUnmergedCells = this.mergedCellsCollection.getWithinRange(rangeToUnmerge, true);
+  this.unmergeRange(rangeToUnmerge, false, true);
+
+  // Changing selection (place where the data is populated) only for greater range (at least two merged cells).
+  if (rangeToUnmerge === pasteRange) {
+    this.hot.selectCell(selectionFromRow, selectionFromColumn, pasteRange.endRow, pasteRange.endCol);
+  }
+  this.adjustSelectionAfterPasting(listOfUnmergedCells, rangeToUnmerge);
 }

package/plugins/nestedHeaders/nestedHeaders.js

@@ -12,6 +12,7 @@ var _selection = require("../../selection");
 var _base = require("../base");
 var _stateManager2 = _interopRequireDefault(require("./stateManager"));
 var _ghostTable = _interopRequireDefault(require("./utils/ghostTable"));
+var _array = require("../../helpers/array");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function _classPrivateMethodInitSpec(obj, privateSet) { _checkPrivateRedeclaration(obj, privateSet); privateSet.add(obj); }
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
@@ -101,6 +102,7 @@ class NestedHeaders extends _base.BasePlugin {
     /**
      * Updates the plugin state after new dataset load.
      *
+     * @private
      * @param {Array[]} sourceData Array of arrays or array of objects containing data.
      * @param {boolean} initialLoad Flag that determines whether the data has been loaded
      *                              during the initialization.
@@ -108,11 +110,14 @@ class NestedHeaders extends _base.BasePlugin {
     _classPrivateMethodInitSpec(this, _onAfterLoadData);
     /**
      * Updates the plugin state after HoT initialization.
+     *
+     * @private
      */
     _classPrivateMethodInitSpec(this, _onInit);
     /**
      * `modifyFocusedElement` hook callback.
      *
+     * @private
      * @param {number} row Row index.
      * @param {number} column Column index.
      * @returns {HTMLTableCellElement} The `TH` element to be focused.
@@ -122,6 +127,7 @@ class NestedHeaders extends _base.BasePlugin {
      * Listens the `modifyColumnHeaderValue` hook that overwrites the column headers values based on
      * the internal state and settings of the plugin.
      *
+     * @private
      * @param {string} value The column header value.
      * @param {number} visualColumnIndex The visual column index.
      * @param {number} headerLevel The index of header level. The header level accepts positive (0 to N)
@@ -134,6 +140,7 @@ class NestedHeaders extends _base.BasePlugin {
     /**
      * `modifyColWidth` hook callback - returns width from cache, when is greater than incoming from hook.
      *
+     * @private
      * @param {number} width Width from hook.
      * @param {number} column Visual index of an column.
      * @returns {number}
@@ -142,12 +149,14 @@ class NestedHeaders extends _base.BasePlugin {
     /**
      * Make the renderer render the first nested column in its entirety.
      *
+     * @private
      * @param {object} calc Viewport column calculator.
      */
     _classPrivateMethodInitSpec(this, _onAfterViewportColumnCalculatorOverride);
     /**
      * `afterGetColumnHeader` hook callback - prepares the header structure.
      *
+     * @private
      * @param {Array} renderersArray Array of renderers.
      */
     _classPrivateMethodInitSpec(this, _onAfterGetColumnHeaderRenderers);
@@ -155,6 +164,7 @@ class NestedHeaders extends _base.BasePlugin {
      * The hook observes the column selection from the Selection API and modifies the column range to
      * ensure that the whole nested column will be covered.
      *
+     * @private
      * @param {CellCoords} from The coords object where the selection starts.
      * @param {CellCoords} to The coords object where the selection ends.
      */
@@ -162,21 +172,27 @@ class NestedHeaders extends _base.BasePlugin {
     /**
      * `modifyTransformStart` hook is called every time the keyboard navigation is used.
      *
+     * @private
      * @param {object} delta The transformation delta.
      */
     _classPrivateMethodInitSpec(this, _onModifyTransformStart);
     /**
      * The hook checks and ensures that the focus position that depends on the selected columns
      * range is always positioned within the range.
+     *
+     * @private
      */
     _classPrivateMethodInitSpec(this, _onBeforeSelectionHighlightSet);
     /**
      * Switches internal flag about selection progress to `false`.
+     *
+     * @private
      */
     _classPrivateMethodInitSpec(this, _onBeforeOnCellMouseUp);
     /**
      * Makes the header-selection properly select the nested headers.
      *
+     * @private
      * @param {MouseEvent} event Mouse event.
      * @param {CellCoords} coords Cell coords object containing the visual coordinates of the clicked cell.
      * @param {HTMLElement} TD The cell element.
@@ -187,6 +203,7 @@ class NestedHeaders extends _base.BasePlugin {
     /**
      * Allows to control how the column selection based on the coordinates and the nested headers is made.
      *
+     * @private
      * @param {MouseEvent} event Mouse event.
      * @param {CellCoords} coords Cell coords object containing the visual coordinates of the clicked cell.
      */
@@ -194,6 +211,7 @@ class NestedHeaders extends _base.BasePlugin {
     /**
      * Allows blocking the column selection that is controlled by the core Selection module.
      *
+     * @private
      * @param {MouseEvent} event Mouse event.
      * @param {CellCoords} coords Cell coords object containing the visual coordinates of the clicked cell.
      * @param {CellCoords} TD The table cell or header element.
@@ -207,16 +225,23 @@ class NestedHeaders extends _base.BasePlugin {
      * of the column.
      *
      * @private
-     * @param {Array[]} data An array of arrays which contains data to copied.
-     * @param {object[]} copyableRanges An array of objects with ranges of the visual indexes (`startRow`, `startCol`, `endRow`, `endCol`)
-     *                                  which will copied.
-     * @param {{ columnHeadersCount: number }} copiedHeadersCount An object with keys that holds information with
-     *                                                            the number of copied headers.
+     * @param {object} clipboardData Information about already performed copy action.
+     * @param {Function} clipboardData.removeRow Remove row from the copied/pasted dataset.
+     * @param {Function} clipboardData.removeColumn Remove column from the copied/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 copied/pasted dataset.
+     * @param {Function} clipboardData.getCellAt Get headers or cells from the copied/pasted dataset.
+     * @param {Function} clipboardData.getData Gets copied data stored as array of arrays.
+     * @param {Function} clipboardData.getMetaInfo Gets grid settings for copied data.
+     * @param {Function} clipboardData.setMetaInfo Sets grid settings for copied data.
+     * @param {Function} clipboardData.getRanges Returns ranges related to copied part of Handsontable.
      */
     _classPrivateMethodInitSpec(this, _onBeforeCopy);
     /**
      * Allows to control which header DOM element will be used to highlight.
      *
+     * @private
      * @param {number} visualColumn A visual column index of the highlighted row header.
      * @param {number} headerLevel A row header level that is currently highlighted.
      * @param {object} highlightMeta An object with meta data that describes the highlight state.
@@ -228,6 +253,7 @@ class NestedHeaders extends _base.BasePlugin {
      * is scrolled to the correct column for the nested header the most left and the most right visual column
      * indexes are used.
      *
+     * @private
      * @param {number} visualColumn A visual column index to which the viewport will be scrolled.
      * @returns {number}
      */
@@ -235,6 +261,8 @@ class NestedHeaders extends _base.BasePlugin {
     /**
      * Updates the selection focus highlight position to point to the nested header root element (TH)
      * even when the logical coordinates point in-between the header.
+     *
+     * @private
      */
     _classPrivateMethodInitSpec(this, _updateFocusHighlightPosition);
     /**
@@ -726,42 +754,60 @@ function _onBeforeHighlightingColumnHeader2(visualColumn, headerLevel, highlight
   }
   return visualColumn;
 }
-function _onBeforeCopy2(data, copyableRanges, _ref2) {
-  let {
-    columnHeadersCount
-  } = _ref2;
-  if (columnHeadersCount === 0) {
-    return;
-  }
-  for (let rangeIndex = 0; rangeIndex < copyableRanges.length; rangeIndex++) {
-    const {
-      startRow,
-      startCol,
-      endRow,
-      endCol
-    } = copyableRanges[rangeIndex];
-    const rowsCount = endRow - startRow + 1;
-    const columnsCount = startCol - endCol + 1;
-
-    // do not process dataset ranges and column headers where only one column is copied
-    if (startRow >= 0 || columnsCount === 1) {
-      break;
-    }
-    for (let column = startCol; column <= endCol; column++) {
-      for (let row = startRow; row <= endRow; row++) {
-        var _classPrivateFieldGet4;
-        const zeroBasedColumnHeaderLevel = rowsCount + row;
-        const zeroBasedColumnIndex = column - startCol;
-        if (zeroBasedColumnIndex === 0) {
-          continue; // eslint-disable-line no-continue
-        }
-        const isRoot = (_classPrivateFieldGet4 = _classPrivateFieldGet(this, _stateManager).getHeaderTreeNodeData(row, column)) === null || _classPrivateFieldGet4 === void 0 ? void 0 : _classPrivateFieldGet4.isRoot;
-        if (isRoot === false) {
-          data[zeroBasedColumnHeaderLevel][zeroBasedColumnIndex] = '';
+function _onBeforeCopy2(clipboardData) {
+  const {
+    rows,
+    columns
+  } = (0, _selection.transformRangeLikeToIndexes)(clipboardData.getRanges());
+  const headers = rows.filter(row => row < 0);
+  const nestedHeaders = [];
+  headers.forEach(header => {
+    const headersForLevel = [];
+    (0, _array.arrayEach)(columns, (column, index) => {
+      const headerSettings = this.getHeaderSettings(header, column);
+      if (headerSettings === null) {
+        headersForLevel.push(this.hot.getColHeader(column, header));
+        return;
+      }
+      const {
+        isPlaceholder
+      } = headerSettings;
+      const columnsToEnd = columns.slice(index).length;
+      const headerTreeNodeData = this.getStateManager().getHeaderTreeNodeData(header, column);
+      if (index === 0 && isPlaceholder === true) {
+        const {
+          label,
+          origColspan: colspan,
+          columnIndex
+        } = headerTreeNodeData;
+        const columnFromStart = column - columnIndex;
+        const reducedColspan = Math.min(colspan - columnFromStart, columnsToEnd);
+        if (reducedColspan > 1) {
+          headersForLevel.push({
+            label,
+            colspan: reducedColspan
+          });
+        } else {
+          headersForLevel.push(label);
         }
+      } else if (isPlaceholder === false) {
+        const {
+          label,
+          origColspan: colspan,
+          columnIndex
+        } = headerTreeNodeData;
+        const columnFromStart = column - columnIndex;
+        const reducedColspan = Math.min(colspan - columnFromStart, columnsToEnd);
+        headersForLevel.push(reducedColspan > 1 ? {
+          label,
+          colspan: reducedColspan
+        } : label);
       }
-    }
-  }
+    });
+    nestedHeaders.push(headersForLevel);
+  });
+  clipboardData.setMetaInfo('colHeaders', null);
+  clipboardData.setMetaInfo('nestedHeaders', nestedHeaders);
 }
 function _onBeforeOnCellMouseDown2(event, coords, TD, controller) {
   const headerNodeData = this._getHeaderTreeNodeDataByCoords(coords);
@@ -964,10 +1010,10 @@ function _onModifyColWidth2(width, column) {
   return width > cachedWidth ? width : cachedWidth;
 }
 function _onModifyColumnHeaderValue2(value, visualColumnIndex, headerLevel) {
-  var _classPrivateFieldGet5;
+  var _classPrivateFieldGet4;
   const {
     label
-  } = (_classPrivateFieldGet5 = _classPrivateFieldGet(this, _stateManager).getHeaderTreeNodeData(headerLevel, visualColumnIndex)) !== null && _classPrivateFieldGet5 !== void 0 ? _classPrivateFieldGet5 : {
+  } = (_classPrivateFieldGet4 = _classPrivateFieldGet(this, _stateManager).getHeaderTreeNodeData(headerLevel, visualColumnIndex)) !== null && _classPrivateFieldGet4 !== void 0 ? _classPrivateFieldGet4 : {
     label: ''
   };
   return label;