handsontable 12.2.0 → 12.3.0-next-9dc4f5d-20221209

package/plugins/copyPaste/copyPaste.js

@@ -1,49 +1,58 @@
 "use strict";
 
+require("core-js/modules/es.symbol.to-primitive.js");
+require("core-js/modules/es.date.to-primitive.js");
+require("core-js/modules/es.symbol.js");
+require("core-js/modules/es.symbol.description.js");
+require("core-js/modules/es.number.constructor.js");
 require("core-js/modules/es.object.set-prototype-of.js");
 require("core-js/modules/es.object.get-prototype-of.js");
 require("core-js/modules/es.reflect.construct.js");
 require("core-js/modules/es.reflect.get.js");
 require("core-js/modules/es.object.get-own-property-descriptor.js");
-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.array.slice.js");
 require("core-js/modules/es.function.name.js");
-require("core-js/modules/es.array.from.js");
 exports.__esModule = true;
 exports.PLUGIN_PRIORITY = exports.PLUGIN_KEY = exports.CopyPaste = void 0;
+require("core-js/modules/es.array.join.js");
+require("core-js/modules/es.array.concat.js");
 require("core-js/modules/es.array.iterator.js");
+require("core-js/modules/es.map.js");
 require("core-js/modules/es.object.to-string.js");
 require("core-js/modules/es.string.iterator.js");
-require("core-js/modules/es.weak-map.js");
 require("core-js/modules/web.dom-collections.iterator.js");
-require("core-js/modules/es.array.join.js");
-require("core-js/modules/es.array.index-of.js");
+require("core-js/modules/es.array.map.js");
+require("core-js/modules/es.array.filter.js");
+require("core-js/modules/es.array.from.js");
 require("core-js/modules/es.regexp.exec.js");
-require("core-js/modules/es.array.concat.js");
+require("core-js/modules/es.weak-map.js");
+require("core-js/modules/es.weak-set.js");
 var _base = require("../base");
 var _pluginHooks = _interopRequireDefault(require("../../pluginHooks"));
 var _SheetClip = require("../../3rdparty/SheetClip");
 var _array = require("../../helpers/array");
-var _number = require("../../helpers/number");
 var _string = require("../../helpers/string");
 var _element = require("../../helpers/dom/element");
 var _copy = _interopRequireDefault(require("./contextMenuItem/copy"));
+var _copyColumnHeadersOnly = _interopRequireDefault(require("./contextMenuItem/copyColumnHeadersOnly"));
+var _copyWithColumnGroupHeaders = _interopRequireDefault(require("./contextMenuItem/copyWithColumnGroupHeaders"));
+var _copyWithColumnHeaders = _interopRequireDefault(require("./contextMenuItem/copyWithColumnHeaders"));
 var _cut = _interopRequireDefault(require("./contextMenuItem/cut"));
 var _pasteEvent = _interopRequireDefault(require("./pasteEvent"));
 var _focusableElement = require("./focusableElement");
+var _copyableRanges = require("./copyableRanges");
 var _parseTable = require("../../utils/parseTable");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 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 _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
 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; }
-function _iterableToArrayLimit(arr, i) { var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"]; if (_i == null) return; var _arr = []; var _n = true; var _d = false; var _s, _e; try { for (_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
+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; } }
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 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 _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, descriptor.key, descriptor); } }
+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); } }
 function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
 function _get() { if (typeof Reflect !== "undefined" && Reflect.get) { _get = Reflect.get.bind(); } else { _get = function _get(target, property, receiver) { var base = _superPropBase(target, property); if (!base) return; var desc = Object.getOwnPropertyDescriptor(base, property); if (desc.get) { return desc.get.call(arguments.length < 3 ? target : receiver); } return desc.value; }; } return _get.apply(this, arguments); }
 function _superPropBase(object, property) { while (!Object.prototype.hasOwnProperty.call(object, property)) { object = _getPrototypeOf(object); if (object === null) break; } return object; }
@@ -54,6 +63,18 @@ function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) ===
 function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
 function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
 function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
+function _classPrivateMethodInitSpec(obj, privateSet) { _checkPrivateRedeclaration(obj, privateSet); privateSet.add(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"); } }
+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; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+function _classPrivateMethodGet(receiver, privateSet, fn) { if (!privateSet.has(receiver)) { throw new TypeError("attempted to get private field on non-instance"); } return fn; }
+function _classPrivateFieldGet(receiver, privateMap) { var descriptor = _classExtractFieldDescriptor(receiver, privateMap, "get"); return _classApplyDescriptorGet(receiver, descriptor); }
+function _classApplyDescriptorGet(receiver, descriptor) { if (descriptor.get) { return descriptor.get.call(receiver); } return descriptor.value; }
+function _classPrivateFieldSet(receiver, privateMap, value) { var descriptor = _classExtractFieldDescriptor(receiver, privateMap, "set"); _classApplyDescriptorSet(receiver, descriptor, value); return value; }
+function _classExtractFieldDescriptor(receiver, privateMap, action) { if (!privateMap.has(receiver)) { throw new TypeError("attempted to " + action + " private field on non-instance"); } return privateMap.get(receiver); }
+function _classApplyDescriptorSet(receiver, descriptor, value) { if (descriptor.set) { descriptor.set.call(receiver, value); } else { if (!descriptor.writable) { throw new TypeError("attempted to set read only private field"); } descriptor.value = value; } }
 _pluginHooks.default.getSingleton().register('afterCopyLimit');
 _pluginHooks.default.getSingleton().register('modifyCopyableRange');
 _pluginHooks.default.getSingleton().register('beforeCut');
@@ -67,118 +88,131 @@ exports.PLUGIN_KEY = PLUGIN_KEY;
 var PLUGIN_PRIORITY = 80;
 exports.PLUGIN_PRIORITY = PLUGIN_PRIORITY;
 var SETTING_KEYS = ['fragmentSelection'];
-var ROWS_LIMIT = Infinity;
-var COLUMNS_LIMIT = Infinity;
-var privatePool = new WeakMap();
 var META_HEAD = ['<meta name="generator" content="Handsontable"/>', '<style type="text/css">td{white-space:normal}br{mso-data-placement:same-cell}</style>'].join('');
 
 /* eslint-disable jsdoc/require-description-complete-sentence */
 /**
  * @description
- * This plugin enables the copy/paste functionality in the Handsontable. The functionality works for API, Context Menu,
- * using keyboard shortcuts and menu bar from the browser.
- * Possible values:
- * * `true` (to enable default options),
- * * `false` (to disable completely).
+ * Copy, cut, and paste data by using the `CopyPaste` plugin.
  *
- * or an object with values:
- * * `'columnsLimit'` (see {@link CopyPaste#columnsLimit})
- * * `'rowsLimit'` (see {@link CopyPaste#rowsLimit})
- * * `'pasteMode'` (see {@link CopyPaste#pasteMode})
- * * `'uiContainer'` (see {@link CopyPaste#uiContainer}).
+ * Control the `CopyPaste` plugin programmatically through its [API methods](#methods).
  *
- * See [the copy/paste demo](@/guides/cell-features/clipboard.md) for examples.
+ * The user can access the copy-paste features through:
+ * - The [context menu](@/guides/cell-features/clipboard.md#context-menu).
+ * - The [keyboard shortcuts](@/guides/cell-features/clipboard.md#related-keyboard-shortcuts).
+ * - The browser's menu bar.
+ *
+ * Read more:
+ * - [Guides: Clipboard](@/guides/cell-features/clipboard.md)
+ * - [Configuration options: `copyPaste`](@/api/options.md#copypaste)
  *
  * @example
  * ```js
- * // Enables the plugin with default values
+ * // enable the plugin with the default configuration
  * copyPaste: true,
- * // Enables the plugin with custom values
+ *
+ * // or, enable the plugin with a custom configuration
  * copyPaste: {
  *   columnsLimit: 25,
  *   rowsLimit: 50,
  *   pasteMode: 'shift_down',
+ *   copyColumnHeaders: true,
+ *   copyColumnGroupHeaders: true,
+ *   copyColumnHeadersOnly: true,
  *   uiContainer: document.body,
  * },
  * ```
  * @class CopyPaste
  * @plugin CopyPaste
  */
+var _enableCopyColumnHeaders = /*#__PURE__*/new WeakMap();
+var _enableCopyColumnGroupHeaders = /*#__PURE__*/new WeakMap();
+var _enableCopyColumnHeadersOnly = /*#__PURE__*/new WeakMap();
+var _copyMode = /*#__PURE__*/new WeakMap();
+var _isTriggeredByCopy = /*#__PURE__*/new WeakMap();
+var _isTriggeredByCut = /*#__PURE__*/new WeakMap();
+var _copyableRangesFactory = /*#__PURE__*/new WeakMap();
+var _countCopiedHeaders = /*#__PURE__*/new WeakSet();
 var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
   _inherits(CopyPaste, _BasePlugin);
   var _super = _createSuper(CopyPaste);
-  function CopyPaste(hotInstance) {
+  function CopyPaste() {
     var _this;
     _classCallCheck(this, CopyPaste);
-    _this = _super.call(this, hotInstance);
-    /**
-     * Maximum number of columns than can be copied to clipboard using <kbd>**Ctrl**</kbd>/<kbd>**Cmd**</kbd> + <kbd>**C**</kbd>.
-     *
-     * @type {number}
-     * @default Infinity
-     */
-    _this.columnsLimit = COLUMNS_LIMIT;
-    /**
-     * Ranges of the cells coordinates, which should be used to copy/cut/paste actions.
-     *
-     * @private
-     * @type {Array}
-     */
-    _this.copyableRanges = [];
-    /**
-     * Provides focusable element to support IME and copy/paste/cut actions.
-     *
-     * @private
-     * @type {FocusableWrapper}
-     */
-    _this.focusableElement = void 0;
-    /**
-     * Defines paste (<kbd>**Ctrl**</kbd>/<kbd>**Cmd**</kbd> + <kbd>**V**</kbd>) behavior.
-     * * Default value `"overwrite"` will paste clipboard value over current selection.
-     * * When set to `"shift_down"`, clipboard data will be pasted in place of current selection, while all selected cells are moved down.
-     * * When set to `"shift_right"`, clipboard data will be pasted in place of current selection, while all selected cells are moved right.
-     *
-     * @type {string}
-     * @default 'overwrite'
-     */
-    _this.pasteMode = 'overwrite';
-    /**
-     * Maximum number of rows than can be copied to clipboard using <kbd>**Ctrl**</kbd>/<kbd>**Cmd**</kbd> + <kbd>**C**</kbd>.
-     *
-     * @type {number}
-     * @default Infinity
-     */
-    _this.rowsLimit = ROWS_LIMIT;
-
-    /**
-     * UI container for the secondary focusable element.
-     *
-     * @type {HTMLElement}
-     */
-    _this.uiContainer = _this.hot.rootDocument.body;
-    privatePool.set(_assertThisInitialized(_this), {
-      isTriggeredByCopy: false,
-      isTriggeredByCut: false,
-      isBeginEditing: false,
-      isFragmentSelectionEnabled: false
+    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+      args[_key] = arguments[_key];
+    }
+    _this = _super.call.apply(_super, [this].concat(args));
+    _classPrivateMethodInitSpec(_assertThisInitialized(_this), _countCopiedHeaders);
+    _defineProperty(_assertThisInitialized(_this), "columnsLimit", Infinity);
+    _defineProperty(_assertThisInitialized(_this), "rowsLimit", Infinity);
+    _defineProperty(_assertThisInitialized(_this), "pasteMode", 'overwrite');
+    _defineProperty(_assertThisInitialized(_this), "uiContainer", _this.hot.rootDocument.body);
+    _classPrivateFieldInitSpec(_assertThisInitialized(_this), _enableCopyColumnHeaders, {
+      writable: true,
+      value: false
+    });
+    _classPrivateFieldInitSpec(_assertThisInitialized(_this), _enableCopyColumnGroupHeaders, {
+      writable: true,
+      value: false
+    });
+    _classPrivateFieldInitSpec(_assertThisInitialized(_this), _enableCopyColumnHeadersOnly, {
+      writable: true,
+      value: false
+    });
+    _classPrivateFieldInitSpec(_assertThisInitialized(_this), _copyMode, {
+      writable: true,
+      value: 'cells-only'
+    });
+    _classPrivateFieldInitSpec(_assertThisInitialized(_this), _isTriggeredByCopy, {
+      writable: true,
+      value: false
     });
+    _classPrivateFieldInitSpec(_assertThisInitialized(_this), _isTriggeredByCut, {
+      writable: true,
+      value: false
+    });
+    _classPrivateFieldInitSpec(_assertThisInitialized(_this), _copyableRangesFactory, {
+      writable: true,
+      value: new _copyableRanges.CopyableRangesFactory({
+        countRows: function countRows() {
+          return _this.hot.countRows();
+        },
+        countColumns: function countColumns() {
+          return _this.hot.countCols();
+        },
+        rowsLimit: function rowsLimit() {
+          return _this.rowsLimit;
+        },
+        columnsLimit: function columnsLimit() {
+          return _this.columnsLimit;
+        },
+        countColumnHeaders: function countColumnHeaders() {
+          return _this.hot.view.getColumnHeadersCount();
+        }
+      })
+    });
+    _defineProperty(_assertThisInitialized(_this), "copyableRanges", []);
+    _defineProperty(_assertThisInitialized(_this), "focusableElement", void 0);
     return _this;
   }
-
-  /**
-   * Checks if the plugin is enabled in the handsontable settings. This method is executed in {@link Hooks#beforeInit}
-   * hook and if it returns `true` then the {@link CopyPaste#enablePlugin} method is called.
-   *
-   * @returns {boolean}
-   */
   _createClass(CopyPaste, [{
     key: "isEnabled",
-    value: function isEnabled() {
+    value:
+    /**
+     * Checks if the [`CopyPaste`](#copypaste) plugin is enabled.
+     *
+     * This method gets called by Handsontable's [`beforeInit`](@/api/hooks.md#beforeinit) hook.
+     * If it returns `true`, the [`enablePlugin()`](#enableplugin) method gets called.
+     *
+     * @returns {boolean}
+     */
+    function isEnabled() {
       return !!this.hot.getSettings()[PLUGIN_KEY];
     }
 
     /**
-     * Enables the plugin functionality for this Handsontable instance.
+     * Enables the [`CopyPaste`](#copypaste) plugin for your Handsontable instance.
      */
   }, {
     key: "enablePlugin",
@@ -188,15 +222,16 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
         return;
       }
       var _this$hot$getSettings = this.hot.getSettings(),
-        settings = _this$hot$getSettings[PLUGIN_KEY],
-        fragmentSelection = _this$hot$getSettings.fragmentSelection;
-      var priv = privatePool.get(this);
-      priv.isFragmentSelectionEnabled = !!fragmentSelection;
+        settings = _this$hot$getSettings[PLUGIN_KEY];
       if (_typeof(settings) === 'object') {
-        this.pasteMode = settings.pasteMode || this.pasteMode;
+        var _settings$pasteMode, _settings$uiContainer;
+        this.pasteMode = (_settings$pasteMode = settings.pasteMode) !== null && _settings$pasteMode !== void 0 ? _settings$pasteMode : this.pasteMode;
         this.rowsLimit = isNaN(settings.rowsLimit) ? this.rowsLimit : settings.rowsLimit;
         this.columnsLimit = isNaN(settings.columnsLimit) ? this.columnsLimit : settings.columnsLimit;
-        this.uiContainer = settings.uiContainer || this.uiContainer;
+        _classPrivateFieldSet(this, _enableCopyColumnHeaders, !!settings.copyColumnHeaders);
+        _classPrivateFieldSet(this, _enableCopyColumnGroupHeaders, !!settings.copyColumnGroupHeaders);
+        _classPrivateFieldSet(this, _enableCopyColumnHeadersOnly, !!settings.copyColumnHeadersOnly);
+        this.uiContainer = (_settings$uiContainer = settings.uiContainer) !== null && _settings$uiContainer !== void 0 ? _settings$uiContainer : this.uiContainer;
       }
       this.addHook('afterContextMenuDefaultOptions', function (options) {
         return _this2.onAfterContextMenuDefaultOptions(options);
@@ -222,9 +257,10 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
     }
 
     /**
-     * Updates the plugin's state.
+     * Updates the state of the [`CopyPaste`](#copypaste) plugin.
      *
-     * This method is executed when [`updateSettings()`](@/api/core.md#updatesettings) is invoked with any of the following configuration options:
+     * Gets called when [`updateSettings()`](@/api/core.md#updatesettings)
+     * is invoked with any of the following configuration options:
      *  - [`copyPaste`](@/api/options.md#copypaste)
      *  - [`fragmentSelection`](@/api/options.md#fragmentselection)
      */
@@ -238,7 +274,7 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
     }
 
     /**
-     * Disables the plugin functionality for this Handsontable instance.
+     * Disables the [`CopyPaste`](#copypaste) plugin for your Handsontable instance.
      */
   }, {
     key: "disablePlugin",
@@ -250,114 +286,125 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
     }
 
     /**
-     * Copies the selected cell into the clipboard.
+     * Copies the contents of the selected cells (and/or their related column headers) to the system clipboard.
+     *
+     * Takes an optional parameter (`copyMode`) that defines the scope of copying:
+     *
+     * | `copyMode` value            | Description                                                     |
+     * | --------------------------- | --------------------------------------------------------------- |
+     * | `'cells-only'` (default)    | Copy the selected cells                                         |
+     * | `'with-column-headers'`     | - Copy the selected cells<br>- Copy the nearest column headers  |
+     * | `'with-all-column-headers'` | - Copy the selected cells<br>- Copy all related columns headers |
+     * | `'column-headers-only'`     | Copy the nearest column headers (without copying cells)         |
+     *
+     * @param {string} [copyMode='cells-only'] Copy mode.
      */
   }, {
     key: "copy",
     value: function copy() {
-      var priv = privatePool.get(this);
-      priv.isTriggeredByCopy = true;
+      var copyMode = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'cells-only';
+      _classPrivateFieldSet(this, _copyMode, copyMode);
+      _classPrivateFieldSet(this, _isTriggeredByCopy, true);
       this.getOrCreateFocusableElement();
       this.focusableElement.focus();
       this.hot.rootDocument.execCommand('copy');
     }
 
     /**
-     * Cuts the selected cell into the clipboard.
+     * Copies the contents of the selected cells.
+     */
+  }, {
+    key: "copyCellsOnly",
+    value: function copyCellsOnly() {
+      this.copy('cells-only');
+    }
+    /**
+     * Copies the contents of column headers that are nearest to the selected cells.
+     */
+  }, {
+    key: "copyColumnHeadersOnly",
+    value: function copyColumnHeadersOnly() {
+      this.copy('column-headers-only');
+    }
+    /**
+     * Copies the contents of the selected cells and all their related column headers.
+     */
+  }, {
+    key: "copyWithAllColumnHeaders",
+    value: function copyWithAllColumnHeaders() {
+      this.copy('with-column-group-headers');
+    }
+    /**
+     * Copies the contents of the selected cells and their nearest column headers.
+     */
+  }, {
+    key: "copyWithColumnHeaders",
+    value: function copyWithColumnHeaders() {
+      this.copy('with-column-headers');
+    }
+
+    /**
+     * Cuts the contents of the selected cells to the system clipboard.
      */
   }, {
     key: "cut",
     value: function cut() {
-      var priv = privatePool.get(this);
-      priv.isTriggeredByCut = true;
+      _classPrivateFieldSet(this, _isTriggeredByCut, true);
       this.getOrCreateFocusableElement();
       this.focusableElement.focus();
       this.hot.rootDocument.execCommand('cut');
     }
 
     /**
-     * Creates copyable text releated to range objects.
+     * Converts the contents of multiple ranges (`ranges`) into a single string.
      *
-     * @param {object[]} ranges Array of objects with properties `startRow`, `endRow`, `startCol` and `endCol`.
-     * @returns {string} Returns string which will be copied into clipboard.
+     * @param {Array<{startRow: number, startCol: number, endRow: number, endCol: number}>} ranges Array of objects with properties `startRow`, `endRow`, `startCol` and `endCol`.
+     * @returns {string} A string that will be copied to the clipboard.
      */
   }, {
     key: "getRangedCopyableData",
     value: function getRangedCopyableData(ranges) {
-      var _this3 = this;
-      var dataSet = [];
-      var copyableRows = [];
-      var copyableColumns = [];
-
-      // Count all copyable rows and columns
-      (0, _array.arrayEach)(ranges, function (range) {
-        (0, _number.rangeEach)(range.startRow, range.endRow, function (row) {
-          if (copyableRows.indexOf(row) === -1) {
-            copyableRows.push(row);
-          }
-        });
-        (0, _number.rangeEach)(range.startCol, range.endCol, function (column) {
-          if (copyableColumns.indexOf(column) === -1) {
-            copyableColumns.push(column);
-          }
-        });
-      });
-      // Concat all rows and columns data defined in ranges into one copyable string
-      (0, _array.arrayEach)(copyableRows, function (row) {
-        var rowSet = [];
-        (0, _array.arrayEach)(copyableColumns, function (column) {
-          rowSet.push(_this3.hot.getCopyableData(row, column));
-        });
-        dataSet.push(rowSet);
-      });
-      return (0, _SheetClip.stringify)(dataSet);
+      return (0, _SheetClip.stringify)(this.getRangedData(ranges));
     }
 
     /**
-     * Creates copyable text releated to range objects.
+     * Converts the contents of multiple ranges (`ranges`) into an array of arrays.
      *
-     * @param {object[]} ranges Array of objects with properties `startRow`, `startCol`, `endRow` and `endCol`.
-     * @returns {Array[]} Returns array of arrays which will be copied into clipboard.
+     * @param {Array<{startRow: number, startCol: number, endRow: number, endCol: number}>} ranges Array of objects with properties `startRow`, `startCol`, `endRow` and `endCol`.
+     * @returns {Array[]} An array of arrays that will be copied to the clipboard.
      */
   }, {
     key: "getRangedData",
     value: function getRangedData(ranges) {
-      var _this4 = this;
-      var dataSet = [];
-      var copyableRows = [];
-      var copyableColumns = [];
+      var _this3 = this;
+      var data = [];
+      var _normalizeRanges = (0, _copyableRanges.normalizeRanges)(ranges),
+        rows = _normalizeRanges.rows,
+        columns = _normalizeRanges.columns;
 
-      // Count all copyable rows and columns
-      (0, _array.arrayEach)(ranges, function (range) {
-        (0, _number.rangeEach)(range.startRow, range.endRow, function (row) {
-          if (copyableRows.indexOf(row) === -1) {
-            copyableRows.push(row);
-          }
-        });
-        (0, _number.rangeEach)(range.startCol, range.endCol, function (column) {
-          if (copyableColumns.indexOf(column) === -1) {
-            copyableColumns.push(column);
-          }
-        });
-      });
-      // Concat all rows and columns data defined in ranges into one copyable string
-      (0, _array.arrayEach)(copyableRows, function (row) {
+      // concatenate all rows and columns data defined in ranges into one copyable string
+      (0, _array.arrayEach)(rows, function (row) {
         var rowSet = [];
-        (0, _array.arrayEach)(copyableColumns, function (column) {
-          rowSet.push(_this4.hot.getCopyableData(row, column));
+        (0, _array.arrayEach)(columns, function (column) {
+          if (row < 0) {
+            // `row` as the second argument acts here as the `headerLevel` argument
+            rowSet.push(_this3.hot.getColHeader(column, row));
+          } else {
+            rowSet.push(_this3.hot.getCopyableData(row, column));
+          }
         });
-        dataSet.push(rowSet);
+        data.push(rowSet);
       });
-      return dataSet;
+      return data;
     }
 
     /**
      * Simulates the paste action.
      *
-     * Due to security reasons, modern browsers disallow reading from the system clipboard.
+     * For security reasons, modern browsers don't allow reading from the system clipboard.
      *
-     * @param {string} pastableText Value as raw string to paste.
-     * @param {string} [pastableHtml=''] Value as HTML to paste.
+     * @param {string} pastableText The value to paste, as a raw string.
+     * @param {string} [pastableHtml=''] The value to paste, as HTML.
      */
   }, {
     key: "paste",
@@ -384,27 +431,43 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
   }, {
     key: "setCopyableText",
     value: function setCopyableText() {
-      var selRange = this.hot.getSelectedRangeLast();
-      if (!selRange) {
+      var selectionRange = this.hot.getSelectedRangeLast();
+      if (!selectionRange) {
         return;
       }
-      var topStart = selRange.getTopStartCorner();
-      var bottomEnd = selRange.getBottomEndCorner();
-      var startRow = topStart.row;
-      var startCol = topStart.col;
-      var endRow = bottomEnd.row;
-      var endCol = bottomEnd.col;
-      var finalEndRow = Math.min(endRow, startRow + this.rowsLimit - 1);
-      var finalEndCol = Math.min(endCol, startCol + this.columnsLimit - 1);
-      this.copyableRanges.length = 0;
-      this.copyableRanges.push({
-        startRow: startRow,
-        startCol: startCol,
-        endRow: finalEndRow,
-        endCol: finalEndCol
+      _classPrivateFieldGet(this, _copyableRangesFactory).setSelectedRange(selectionRange);
+      var groupedRanges = new Map([['headers', null], ['cells', null]]);
+      if (_classPrivateFieldGet(this, _copyMode) === 'column-headers-only') {
+        groupedRanges.set('headers', _classPrivateFieldGet(this, _copyableRangesFactory).getMostBottomColumnHeadersRange());
+      } else {
+        if (_classPrivateFieldGet(this, _copyMode) === 'with-column-headers') {
+          groupedRanges.set('headers', _classPrivateFieldGet(this, _copyableRangesFactory).getMostBottomColumnHeadersRange());
+        } else if (_classPrivateFieldGet(this, _copyMode) === 'with-column-group-headers') {
+          groupedRanges.set('headers', _classPrivateFieldGet(this, _copyableRangesFactory).getAllColumnHeadersRange());
+        }
+        groupedRanges.set('cells', _classPrivateFieldGet(this, _copyableRangesFactory).getCellsRange());
+      }
+      this.copyableRanges = Array.from(groupedRanges.values()).filter(function (range) {
+        return range !== null;
+      }).map(function (_ref) {
+        var startRow = _ref.startRow,
+          startCol = _ref.startCol,
+          endRow = _ref.endRow,
+          endCol = _ref.endCol;
+        return {
+          startRow: startRow,
+          startCol: startCol,
+          endRow: endRow,
+          endCol: endCol
+        };
       });
       this.copyableRanges = this.hot.runHooks('modifyCopyableRange', this.copyableRanges);
-      if (endRow !== finalEndRow || endCol !== finalEndCol) {
+      var cellsRange = groupedRanges.get('cells');
+      if (cellsRange !== null && cellsRange.isRangeTrimmed) {
+        var startRow = cellsRange.startRow,
+          startCol = cellsRange.startCol,
+          endRow = cellsRange.endRow,
+          endCol = cellsRange.endCol;
         this.hot.runHooks('afterCopyLimit', endRow - startRow + 1, endCol - startCol + 1, this.rowsLimit, this.columnsLimit);
       }
     }
@@ -417,8 +480,8 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
   }, {
     key: "getOrCreateFocusableElement",
     value: function getOrCreateFocusableElement() {
-      var editor = this.hot.getActiveEditor();
-      var editableElement = editor ? editor.TEXTAREA : void 0;
+      var _this$hot$getActiveEd;
+      var editableElement = (_this$hot$getActiveEd = this.hot.getActiveEditor()) === null || _this$hot$getActiveEd === void 0 ? void 0 : _this$hot$getActiveEd.TEXTAREA;
       if (editableElement) {
         this.focusableElement.setFocusableElement(editableElement);
       } else {
@@ -435,10 +498,21 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
   }, {
     key: "isEditorOpened",
     value: function isEditorOpened() {
-      var editor = this.hot.getActiveEditor();
-      return editor && editor.isOpened();
+      var _this$hot$getActiveEd2;
+      return (_this$hot$getActiveEd2 = this.hot.getActiveEditor()) === null || _this$hot$getActiveEd2 === void 0 ? void 0 : _this$hot$getActiveEd2.isOpened();
     }
 
+    /**
+     * Counts how many column headers will be copied based on the passed range.
+     *
+     * @private
+     * @param {Array<{startRow: number, startCol: number, endRow: number, endCol: number}>} ranges Array of objects with properties `startRow`, `startCol`, `endRow` and `endCol`.
+     * @returns {{ columnHeadersCount: number }} Returns an object with keys that holds
+     *                                           information with the number of copied headers.
+     */
+  }, {
+    key: "populateValues",
+    value:
     /**
      * Prepares new values to populate them into datasource.
      *
@@ -447,9 +521,7 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
      * @param {Array} [selection] The selection which indicates from what position the data will be populated.
      * @returns {Array} Range coordinates after populate data.
      */
-  }, {
-    key: "populateValues",
-    value: function populateValues(inputArray) {
+    function populateValues(inputArray) {
       var selection = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : this.hot.getSelectedRangeLast();
       if (!inputArray.length) {
         return;
@@ -512,25 +584,26 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
   }, {
     key: "onCopy",
     value: function onCopy(event) {
-      var priv = privatePool.get(this);
-      if (!this.hot.isListening() && !priv.isTriggeredByCopy || this.isEditorOpened()) {
+      if (!this.hot.isListening() && !_classPrivateFieldGet(this, _isTriggeredByCopy) || this.isEditorOpened()) {
         return;
       }
       this.setCopyableText();
-      priv.isTriggeredByCopy = false;
-      var rangedData = this.getRangedData(this.copyableRanges);
-      var allowCopying = !!this.hot.runHooks('beforeCopy', rangedData, this.copyableRanges);
+      _classPrivateFieldSet(this, _isTriggeredByCopy, false);
+      var data = this.getRangedData(this.copyableRanges);
+      var copiedHeadersCount = _classPrivateMethodGet(this, _countCopiedHeaders, _countCopiedHeaders2).call(this, this.copyableRanges);
+      var allowCopying = !!this.hot.runHooks('beforeCopy', data, this.copyableRanges, copiedHeadersCount);
       if (allowCopying) {
-        var textPlain = (0, _SheetClip.stringify)(rangedData);
+        var textPlain = (0, _SheetClip.stringify)(data);
         if (event && event.clipboardData) {
-          var textHTML = (0, _parseTable._dataToHTML)(rangedData, this.hot.rootDocument);
+          var textHTML = (0, _parseTable._dataToHTML)(data, this.hot.rootDocument);
           event.clipboardData.setData('text/plain', textPlain);
           event.clipboardData.setData('text/html', [META_HEAD, textHTML].join(''));
         } else if (typeof ClipboardEvent === 'undefined') {
           this.hot.rootWindow.clipboardData.setData('Text', textPlain);
         }
-        this.hot.runHooks('afterCopy', rangedData, this.copyableRanges);
+        this.hot.runHooks('afterCopy', data, this.copyableRanges, copiedHeadersCount);
       }
+      _classPrivateFieldSet(this, _copyMode, 'cells-only');
       event.preventDefault();
     }
 
@@ -543,12 +616,11 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
   }, {
     key: "onCut",
     value: function onCut(event) {
-      var priv = privatePool.get(this);
-      if (!this.hot.isListening() && !priv.isTriggeredByCut || this.isEditorOpened()) {
+      if (!this.hot.isListening() && !_classPrivateFieldGet(this, _isTriggeredByCut) || this.isEditorOpened()) {
         return;
       }
       this.setCopyableText();
-      priv.isTriggeredByCut = false;
+      _classPrivateFieldSet(this, _isTriggeredByCut, false);
       var rangedData = this.getRangedData(this.copyableRanges);
       var allowCuttingOut = !!this.hot.runHooks('beforeCut', rangedData, this.copyableRanges);
       if (allowCuttingOut) {
@@ -627,7 +699,17 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
     value: function onAfterContextMenuDefaultOptions(options) {
       options.items.push({
         name: '---------'
-      }, (0, _copy.default)(this), (0, _cut.default)(this));
+      }, (0, _copy.default)(this));
+      if (_classPrivateFieldGet(this, _enableCopyColumnHeaders)) {
+        options.items.push((0, _copyWithColumnHeaders.default)(this));
+      }
+      if (_classPrivateFieldGet(this, _enableCopyColumnGroupHeaders)) {
+        options.items.push((0, _copyWithColumnGroupHeaders.default)(this));
+      }
+      if (_classPrivateFieldGet(this, _enableCopyColumnHeadersOnly)) {
+        options.items.push((0, _copyColumnHeadersOnly.default)(this));
+      }
+      options.items.push((0, _cut.default)(this));
     }
 
     /**
@@ -655,13 +737,11 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
   }, {
     key: "onAfterSelectionEnd",
     value: function onAfterSelectionEnd() {
-      var _privatePool$get = privatePool.get(this),
-        isFragmentSelectionEnabled = _privatePool$get.isFragmentSelectionEnabled;
       if (this.isEditorOpened()) {
         return;
       }
       this.getOrCreateFocusableElement();
-      if (isFragmentSelectionEnabled && this.focusableElement.getFocusableElement() !== this.hot.rootDocument.activeElement && (0, _element.getSelectionText)()) {
+      if (this.hot.getSettings().fragmentSelection && this.focusableElement.getFocusableElement() !== this.hot.rootDocument.activeElement && (0, _element.getSelectionText)()) {
         return;
       }
       this.setCopyableText();
@@ -689,7 +769,7 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
     }
 
     /**
-     * Destroys the plugin instance.
+     * Destroys the `CopyPaste` plugin instance.
      */
   }, {
     key: "destroy",
@@ -715,7 +795,28 @@ var CopyPaste = /*#__PURE__*/function (_BasePlugin) {
     get: function get() {
       return PLUGIN_PRIORITY;
     }
+
+    /**
+     * The maximum number of columns than can be copied to the clipboard.
+     *
+     * @type {number}
+     * @default Infinity
+     */
   }]);
   return CopyPaste;
 }(_base.BasePlugin);
-exports.CopyPaste = CopyPaste;
+exports.CopyPaste = CopyPaste;
+function _countCopiedHeaders2(ranges) {
+  var _normalizeRanges2 = (0, _copyableRanges.normalizeRanges)(ranges),
+    rows = _normalizeRanges2.rows;
+  var columnHeadersCount = 0;
+  for (var row = 0; row < rows.length; row++) {
+    if (rows[row] >= 0) {
+      break;
+    }
+    columnHeadersCount += 1;
+  }
+  return {
+    columnHeadersCount: columnHeadersCount
+  };
+}