handsontable 12.2.0 → 12.3.0-next-9dc4f5d-20221209

package/3rdparty/walkontable/src/cell/range.js

@@ -1,5 +1,12 @@
 "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.symbol.iterator.js");
+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); }
 exports.__esModule = true;
 exports.default = void 0;
 require("core-js/modules/es.array.includes.js");
@@ -13,28 +20,45 @@ require("core-js/modules/web.dom-collections.iterator.js");
 var _coords = _interopRequireDefault(require("./../cell/coords"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: 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 _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) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return 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; }
+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 _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; } }
 var _isRtl = /*#__PURE__*/new WeakMap();
+/* eslint-disable jsdoc/require-description-complete-sentence */
 /**
- * CellRange holds cell coordinates as {@link CellCoords} instances. This object represent unit of the selection layer which
- * can contains multiple contiguous cells or single cell.
+ * @description
  *
- * @util
- */var CellRange = /*#__PURE__*/function () {
+ * The `CellRange` class holds a set of cell coordinates ([`CellCoords`](@/api/cellCoords.md) instances)
+ * that form a [selection range](@/guides/cell-features/selection.md#select-ranges).
+ *
+ * A single `CellRange` instance represents a single unit of selection
+ * that contains either a single cell or multiple adjacent cells.
+ *
+ * To import the `CellRange` class:
+ *
+ * ```js
+ * import Handsontable, { CellRange } from '/handsontable';
+ *
+ * // or, using modules
+ * import Handsontable, { CellRange } from '/handsontable/base';
+ * ```
+ */
+var CellRange = /*#__PURE__*/function () {
   /**
    * Used to draw bold border around a cell where selection was started and to edit the cell
    * when you press Enter. The highlight cannot point to headers (negative values) so its
    * coordinates object is normalized while assigning.
    *
+   * @private
    * @type {CellCoords}
    */
 
@@ -42,12 +66,14 @@ var _isRtl = /*#__PURE__*/new WeakMap();
    * Usually the same as highlight, but in Excel there is distinction - one can change
    * highlight within a selection.
    *
+   * @private
    * @type {CellCoords}
    */
 
   /**
    * End selection.
    *
+   * @private
    * @type {CellCoords}
    */
 
@@ -74,7 +100,7 @@ var _isRtl = /*#__PURE__*/new WeakMap();
   }
 
   /**
-   * Set the new coordinates for highlighting selection.
+   * Highlights cell selection at the `coords` coordinates.
    *
    * @param {CellCoords} coords Coordinates to use.
    * @returns {CellRange}
@@ -87,7 +113,7 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Set the new coordinates where selection starts from.
+     * Sets the `coords` coordinates as the start of your range.
      *
      * @param {CellCoords} coords Coordinates to use.
      * @returns {CellRange}
@@ -100,7 +126,7 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Set new coordinates where selection ends from.
+     * Sets the `coords` coordinates as the end of your range.
      *
      * @param {CellCoords} coords Coordinates to use.
      * @returns {CellRange}
@@ -113,9 +139,12 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Checks if given coordinates are valid in context of a given Walkontable instance.
+     * Checks if the coordinates in your `CellRange` instance are valid
+     * in the context of a given Walkontable instance.
      *
-     * @param {Walkontable} wot The Walkontable instance.
+     * See the [`isValid()`](@/api/cellCoords.md#isvalid) method of the [`CellCoords`](@/api/cellCoords.md) class.
+     *
+     * @param {Walkontable} wot A Walkontable instance.
      * @returns {boolean}
      */
   }, {
@@ -125,7 +154,7 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Checks if this cell range is restricted to one cell.
+     * Checks if your range is just a single cell.
      *
      * @returns {boolean}
      */
@@ -136,7 +165,7 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Returns selected range height (in number of rows including rows' headers).
+     * Returns the height of your range (as a number of rows, including row headers).
      *
      * @returns {number}
      */
@@ -147,7 +176,7 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Returns selected range width (in number of columns including columns' headers).
+     * Returns the width of your range (as a number of columns, including column headers).
      *
      * @returns {number}
      */
@@ -158,33 +187,41 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Returns selected range height (in number of rows excluding rows' headers).
+     * Returns the height of your range (as a number of rows, excluding row headers).
      *
      * @returns {number}
      */
   }, {
     key: "getHeight",
     value: function getHeight() {
+      // if the selection contains only row headers, return 0
+      if (this.from.row < 0 && this.to.row < 0) {
+        return 0;
+      }
       var fromRow = Math.max(this.from.row, 0);
       var toRow = Math.max(this.to.row, 0);
       return Math.max(fromRow, toRow) - Math.min(fromRow, toRow) + 1;
     }
 
     /**
-     * Returns selected range width (in number of columns excluding columns' headers).
+     * Returns the width of your range (as a number of columns, excluding column headers).
      *
      * @returns {number}
      */
   }, {
     key: "getWidth",
     value: function getWidth() {
+      // if the selection contains only column headers, return 0
+      if (this.from.col < 0 && this.to.col < 0) {
+        return 0;
+      }
       var fromCol = Math.max(this.from.col, 0);
       var toCol = Math.max(this.to.col, 0);
       return Math.max(fromCol, toCol) - Math.min(fromCol, toCol) + 1;
     }
 
     /**
-     * Returns the number of cells within the range (excluding the column and row headers, if selected).
+     * Returns the number of cells within your range (excluding column and row headers).
      *
      * @returns {number}
      */
@@ -195,9 +232,10 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Checks if given cell coordinates are within `from` and `to` cell coordinates of this range.
+     * Checks if another set of coordinates (`cellCoords`)
+     * is within the `from` and `to` coordinates of your range.
      *
-     * @param {CellCoords} cellCoords The cell coordinates to check.
+     * @param {CellCoords} cellCoords Coordinates to check.
      * @returns {boolean}
      */
   }, {
@@ -211,9 +249,9 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Checks if given range is within of this range.
+     * Checks if another range (`cellRange`) is within your range.
      *
-     * @param {CellRange} cellRange The cells range to check.
+     * @param {CellRange} cellRange A range to check.
      * @returns {boolean}
      */
   }, {
@@ -223,9 +261,9 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Checks if given range is equal to this range.
+     * Checks if another range (`cellRange`) is equal to your range.
      *
-     * @param {CellRange} cellRange The cells range to check.
+     * @param {CellRange} cellRange A range to check.
      * @returns {boolean}
      */
   }, {
@@ -235,10 +273,11 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Checks if tested range overlaps with the range. Range A is considered to to be overlapping with range B
-     * if intersection of A and B or B and A is not empty.
+     * Checks if another range (`cellRange`) overlaps your range.
+     *
+     * Range A overlaps range B if the intersection of A and B (or B and A) is not empty.
      *
-     * @param {CellRange} cellRange The cells range to check.
+     * @param {CellRange} cellRange A range to check.
      * @returns {boolean}
      */
   }, {
@@ -248,9 +287,9 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Checks if tested coordinates are positioned in south-east from this cell range.
+     * Checks if another range (`cellRange`) is south-east of your range.
      *
-     * @param {CellRange} cellRange The cells range to check.
+     * @param {CellRange} cellRange A range to check.
      * @returns {boolean}
      */
   }, {
@@ -260,9 +299,9 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Checks if tested coordinates are positioned in north-west from this cell range.
+     * Checks if another range (`cellRange`) is north-west of your range.
      *
-     * @param {CellRange} cellRange The cells range to check.
+     * @param {CellRange} cellRange A range to check.
      * @returns {boolean}
      */
   }, {
@@ -272,10 +311,12 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Returns `true` if the provided range is overlapping the current range horizontally (e.g. The current range's last
-     * column is 5 and the provided range's first column is 3).
+     * Checks if another range (`cellRange`) overlaps your range horizontally.
      *
-     * @param {CellRange} cellRange The cells range to check.
+     * For example: returns `true` if the last column of your range is `5`
+     * and the first column of the `cellRange` range is `3`.
+     *
+     * @param {CellRange} cellRange A range to check.
      * @returns {boolean}
      */
   }, {
@@ -285,10 +326,12 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Returns `true` if the provided range is overlapping the current range vertically (e.g. The current range's last
-     *  row is 5 and the provided range's first row is 3).
+     * Checks if another range (`cellRange`) overlaps your range vertically.
+     *
+     * For example: returns `true` if the last row of your range is `5`
+     * and the first row of the `cellRange` range is `3`.
      *
-     * @param {CellRange} cellRange The cells range to check.
+     * @param {CellRange} cellRange A range to check.
      * @returns {boolean}
      */
   }, {
@@ -298,9 +341,11 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Adds a cell to a range (only if exceeds corners of the range). Returns information if range was expanded.
+     * Adds a cell to your range, at `cellCoords` coordinates.
      *
-     * @param {CellCoords} cellCoords The cell coordinates.
+     * The `cellCoords` coordinates must exceed a corner of your range.
+     *
+     * @param {CellCoords} cellCoords A new cell's coordinates.
      * @returns {boolean}
      */
   }, {
@@ -317,9 +362,9 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Expand the current object by the range passed in the first argument.
+     * Expand your range with another range (`expandingRange`).
      *
-     * @param {CellRange} expandingRange Object extending the range.
+     * @param {CellRange} expandingRange A new range.
      * @returns {boolean}
      */
   }, {
@@ -409,7 +454,7 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Gets the vertical direction of the range.
+     * Gets the vertical direction of the selection.
      *
      * @returns {string} Returns one of the values: `N-S` (north->south), `S-N` (south->north).
      */
@@ -420,7 +465,7 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Gets the horizontal direction of the range.
+     * Gets the horizontal direction of the selection.
      *
      * @returns {string} Returns one of the values: `W-E` (west->east), `E-W` (east->west).
      */
@@ -431,7 +476,7 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Flip the direction vertically. (e.g. `NW-SE` changes to `SW-NE`).
+     * Flips the direction of your range vertically (e.g., `NW-SE` changes to `SW-NE`).
      */
   }, {
     key: "flipDirectionVertically",
@@ -456,7 +501,7 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Flip the direction horizontally. (e.g. `NW-SE` changes to `NE-SW`).
+     * Flips the direction of your range horizontally (e.g., `NW-SE` changes to `NE-SW`).
      */
   }, {
     key: "flipDirectionHorizontally",
@@ -481,8 +526,10 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Gets the top left (in LTR) or top right (in RTL) corner coordinates of this range. If the corner contains
-     * header coordinates (negative values), the corner coordinates will be normalized to 0.
+     * Gets the top-left (in LTR) or top-right (in RTL) corner coordinates of your range.
+     *
+     * If the corner contains header coordinates (negative values),
+     * the corner coordinates are normalized to `0`.
      *
      * @returns {CellCoords}
      */
@@ -493,8 +540,11 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Gets the top left corner coordinates of this range, no matter if the code runs in LTR or RTL document mode.
-     * If the corner contains header coordinates (negative values), the corner coordinates will be normalized to 0.
+     * Gets the top-left corner coordinates of your range,
+     * both in the LTR and RTL layout direction.
+     *
+     * If the corner contains header coordinates (negative values),
+     * the corner coordinates are normalized to `0`.
      *
      * @returns {CellCoords}
      */
@@ -505,8 +555,10 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Gets the bottom right (in LTR) or bottom left (in RTL) corner coordinates of this range. If the corner contains
-     * header coordinates (negative values), the corner coordinates will be normalized to 0.
+     * Gets the bottom right (in LTR) or bottom left (in RTL) corner coordinates of your range.
+     *
+     * If the corner contains header coordinates (negative values),
+     * the corner coordinates are normalized to `0`.
      *
      * @returns {CellCoords}
      */
@@ -517,8 +569,11 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Gets the bottom right corner coordinates of this range, no matter if the code runs in LTR or RTL document mode.
-     * If the corner contains header coordinates (negative values), the corner coordinates will be normalized to 0.
+     * Gets the bottom right corner coordinates of your range,
+     * both in the LTR and RTL layout direction.
+     *
+     * If the corner contains header coordinates (negative values),
+     * the corner coordinates are normalized to `0`.
      *
      * @returns {CellCoords}
      */
@@ -529,8 +584,10 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Gets the top right (in LTR) or top left (in RTL) corner coordinates of this range. If the corner contains
-     * header coordinates (negative values), the corner coordinates will be normalized to 0.
+     * Gets the top right (in LTR) or top left (in RTL) corner coordinates of your range.
+     *
+     * If the corner contains header coordinates (negative values),
+     * the corner coordinates are normalized to `0`.
      *
      * @returns {CellCoords}
      */
@@ -541,8 +598,11 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Gets the top right corner coordinates of this range, no matter if the code runs in LTR or RTL document mode.
-     * If the corner contains header coordinates (negative values), the corner coordinates will be normalized to 0.
+     * Gets the top right corner coordinates of your range,
+     * both in the LTR and RTL layout direction.
+     *
+     * If the corner contains header coordinates (negative values),
+     * the corner coordinates are normalized to `0`.
      *
      * @returns {CellCoords}
      */
@@ -553,8 +613,10 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Gets the bottom left (in LTR) or bottom right (in RTL) corner coordinates of this range. If the corner
-     * contains header coordinates (negative values), the corner coordinates will be normalized to 0.
+     * Gets the bottom left (in LTR) or bottom right (in RTL) corner coordinates of your range.
+     *
+     * If the corner contains header coordinates (negative values),
+     * the corner coordinates are normalized to `0`.
      *
      * @returns {CellCoords}
      */
@@ -565,8 +627,11 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Gets the bottom left corner coordinates of this range, no matter if the code runs in LTR or RTL document mode.
-     * If the corner contains header coordinates (negative values), the corner coordinates will be normalized to 0.
+     * Gets the bottom left corner coordinates of your range,
+     * both in the LTR and RTL layout direction.
+     *
+     * If the corner contains header coordinates (negative values),
+     * the corner coordinates are normalized to `0`.
      *
      * @returns {CellCoords}
      */
@@ -577,8 +642,10 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Gets the top left (in LTR) or top right (in RTL) corner coordinates of this range. If the corner
-     * contains header coordinates (negative values), then the top and start coordinates will be pointed to that header.
+     * Gets the top left (in LTR) or top right (in RTL) corner coordinates of your range.
+     *
+     * If the corner contains header coordinates (negative values),
+     * the top and start coordinates are pointed to that header.
      *
      * @returns {CellCoords}
      */
@@ -589,9 +656,11 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Gets the top left corner coordinates of this range, no matter if the code runs in LTR or RTL document mode.
-     * If the corner contains header coordinates (negative values), then the top and left coordinates will be
-     * pointed to that header.
+     * Gets the top left corner coordinates of your range,
+     * both in the LTR and RTL layout direction.
+     *
+     * If the corner contains header coordinates (negative values),
+     * the top and left coordinates are pointed to that header.
      *
      * @returns {CellCoords}
      */
@@ -602,8 +671,10 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Gets the bottom right (in LTR) or bottom left (in RTL) corner coordinates of this range. If the corner
-     * contains header coordinates (negative values), then the top and start coordinates will be pointed to that header.
+     * Gets the bottom right (in LTR) or bottom left (in RTL) corner coordinates of your range.
+     *
+     * If the corner contains header coordinates (negative values),
+     * the top and start coordinates are pointed to that header.
      *
      * @returns {CellCoords}
      */
@@ -614,9 +685,11 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Gets the bottom right corner coordinates of this range, no matter if the code runs in LTR or RTL document mode.
-     * If the corner contains header coordinates (negative values), then the top and left coordinates will be
-     * pointed to that header.
+     * Gets the bottom right corner coordinates of your range,
+     * both in the LTR and RTL layout direction.
+     *
+     * If the corner contains header coordinates (negative values),
+     * the top and left coordinates are pointed to that header.
      *
      * @returns {CellCoords}
      */
@@ -627,8 +700,10 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Gets the top right (in LTR) or top left (in RTL) corner coordinates of this range. If the corner
-     * contains header coordinates (negative values), then the top and start coordinates will be pointed to that header.
+     * Gets the top right (in LTR) or top left (in RTL) corner coordinates of your range.
+     *
+     * If the corner contains header coordinates (negative values),
+     * the top and start coordinates are pointed to that header.
      *
      * @returns {CellCoords}
      */
@@ -639,9 +714,11 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Gets the top right corner coordinates of this range, no matter if the code runs in LTR or RTL document mode.
-     * If the corner contains header coordinates (negative values), then the top and left coordinates will be
-     * pointed to that header.
+     * Gets the top right corner coordinates of your range,
+     * both in the LTR and RTL layout direction.
+     *
+     * If the corner contains header coordinates (negative values),
+     * the top and left coordinates are pointed to that header.
      *
      * @returns {CellCoords}
      */
@@ -652,8 +729,10 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Gets the bottom left (in LTR) or bottom right (in RTL) corner coordinates of this range. If the corner
-     * contains header coordinates (negative values), then the top and start coordinates will be pointed to that header.
+     * Gets the bottom left (in LTR) or bottom right (in RTL) corner coordinates of your range.
+     *
+     * If the corner contains header coordinates (negative values),
+     * the top and start coordinates are pointed to that header.
      *
      * @returns {CellCoords}
      */
@@ -664,9 +743,11 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Gets the bottom left corner coordinates of this range, no matter if the code runs in LTR or RTL document mode.
-     * If the corner contains header coordinates (negative values), then the top and left coordinates will be
-     * pointed to that header.
+     * Gets the bottom left corner coordinates of your range,
+     * both in the LTR and RTL layout direction.
+     *
+     * If the corner contains header coordinates (negative values),
+     * the top and left coordinates are pointed to that header.
      *
      * @returns {CellCoords}
      */
@@ -677,10 +758,10 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Checks if coordinates match to one of the 4th corners of this range.
+     * Checks if a set of coordinates (`coords`) matches one of the 4 corners of your range.
      *
-     * @param {CellCoords} coords Cell coordinates to check.
-     * @param {CellRange} [expandedRange] The cells range to compare with.
+     * @param {CellCoords} coords Coordinates to check.
+     * @param {CellRange} [expandedRange] A range to compare with.
      * @returns {boolean}
      */
   }, {
@@ -693,11 +774,13 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Gets coordinates of the corner which is opposite to the matched. When the passed coordinates matched to the
-     * bottom-right corner of this range then the coordinates for top-left will be returned.
+     * Gets the coordinates of a range corner opposite to the provided `coords`.
+     *
+     * For example: if the `coords` coordinates match the bottom-right corner of your range,
+     * the coordinates of the top-left corner of your range are returned.
      *
-     * @param {CellCoords} coords Cell coordinates to check.
-     * @param {CellRange} [expandedRange] The cells range to compare with.
+     * @param {CellCoords} coords Coordinates to check.
+     * @param {CellRange} [expandedRange] A range to compare with.
      * @returns {CellCoords}
      */
   }, {
@@ -736,8 +819,11 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * @param {CellRange} range The cells range to compare with.
-     * @returns {Array}
+     * Indicates which borders (top, right, bottom, left) are shared between
+     * your `CellRange`instance and another `range` that's within your range.
+     *
+     * @param {CellRange} range A range to compare with.
+     * @returns {Array<'top' | 'right' | 'bottom' | 'left'>}
      */
   }, {
     key: "getBordersSharedWith",
@@ -774,9 +860,9 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Get inner selected cell coords defined by this range.
+     * Gets the coordinates of the inner cells of your range.
      *
-     * @returns {Array}
+     * @returns {CellCoords[]}
      */
   }, {
     key: "getInner",
@@ -795,9 +881,9 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Get all selected cell coords defined by this range.
+     * Gets the coordinates of all cells of your range.
      *
-     * @returns {Array}
+     * @returns {CellCoords[]}
      */
   }, {
     key: "getAll",
@@ -820,10 +906,11 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Runs a callback function against all cells in the range. You can break the iteration by returning
-     * `false` in the callback function.
+     * Runs a callback function on all cells within your range.
+     *
+     * You can break the iteration by returning `false` in the callback function.
      *
-     * @param {Function} callback The callback function.
+     * @param {function(number, number): boolean} callback A callback function.
      */
   }, {
     key: "forAll",
@@ -841,7 +928,7 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Clones the range coordinates.
+     * Clones your `CellRange` instance.
      *
      * @returns {CellRange}
      */
@@ -852,10 +939,16 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Convert CellRange to literal object.
+     * Converts your `CellRange` instance into an object literal with the following properties:
      *
-     * @returns {object} Returns a literal object with `from` and `to` properties which each of that object
-     *                  contains `row` and `col` keys.
+     * - `from`
+     *    - `row`
+     *    - `col`
+     * - `to`
+     *    - `row`
+     *    - `col`
+     *
+     * @returns {{from: {row: number, col: number}, to: {row: number, col: number}}} An object literal with `from` and `to` properties.
      */
   }, {
     key: "toObject",
@@ -867,12 +960,14 @@ var _isRtl = /*#__PURE__*/new WeakMap();
     }
 
     /**
-     * Creates and returns a new instance of the CellCoords object. The object automatically inherits
-     * the LTR/RTL flag from this CellRange instance.
+     * Creates and returns a new instance of the `CellCoords` class.
+     *
+     * The new `CellCoords` instance automatically inherits the LTR/RTL flag
+     * from your `CellRange` instance.
      *
      * @private
-     * @param {number} row The row index.
-     * @param {number} column The column index.
+     * @param {number} row A row index.
+     * @param {number} column A column index.
      * @returns {CellCoords}
      */
   }, {