handsontable 11.1.0 → 12.1.0

package/plugins/customBorders/customBorders.js

@@ -2,6 +2,10 @@
 
 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); }
 
+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.object.to-string.js");
 
 require("core-js/modules/es.reflect.construct.js");
@@ -35,20 +39,16 @@ require("core-js/modules/es.weak-map.js");
 exports.__esModule = true;
 exports.PLUGIN_PRIORITY = exports.PLUGIN_KEY = exports.CustomBorders = void 0;
 
+require("core-js/modules/es.array.concat.js");
+
 require("core-js/modules/es.object.keys.js");
 
 require("core-js/modules/es.object.assign.js");
 
-require("core-js/modules/es.object.values.js");
-
 require("core-js/modules/es.array.index-of.js");
 
 require("core-js/modules/es.array.splice.js");
 
-require("core-js/modules/es.object.set-prototype-of.js");
-
-require("core-js/modules/es.object.get-prototype-of.js");
-
 var _base = require("../base");
 
 var _object = require("../../helpers/object");
@@ -57,8 +57,6 @@ var _number = require("../../helpers/number");
 
 var _array = require("../../helpers/array");
 
-var _src = require("../../3rdparty/walkontable/src");
-
 var C = _interopRequireWildcard(require("../../i18n/constants"));
 
 var _contextMenuItem = require("./contextMenuItem");
@@ -89,13 +87,13 @@ function _defineProperties(target, props) { for (var i = 0; i < props.length; i+
 
 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; } 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 _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; }
 
 function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); Object.defineProperty(subClass, "prototype", { writable: false }); if (superClass) _setPrototypeOf(subClass, superClass); }
 
-function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
+function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
 
 function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
 
@@ -105,11 +103,15 @@ function _assertThisInitialized(self) { if (self === void 0) { throw new Referen
 
 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 : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
+function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
+
+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; }
 
 var PLUGIN_KEY = 'customBorders';
 exports.PLUGIN_KEY = PLUGIN_KEY;
 var PLUGIN_PRIORITY = 90;
+/* eslint-disable jsdoc/require-description-complete-sentence */
+
 /**
  * @plugin CustomBorders
  * @class CustomBorders
@@ -121,7 +123,8 @@ var PLUGIN_PRIORITY = 90;
  * To initialize Handsontable with predefined custom borders, provide cell coordinates and border styles in a form
  * of an array.
  *
- * See [Custom Borders](@/guides/cell-features/formatting-cells.md#custom-cell-borders) demo for more examples.
+ * See [`customBorders` configuration option](@/api/options.md#customBorders) or go to
+ * [Custom cell borders demo](@/guides/cell-features/formatting-cells.md#custom-cell-borders) for more examples.
  *
  * @example
  * ```js
@@ -137,8 +140,8 @@ var PLUGIN_PRIORITY = 90;
  *        col: 4
  *      },
  *    },
- *    left: {},
- *    right: {},
+ *    start: {},
+ *    end: {},
  *    top: {},
  *    bottom: {},
  *   },
@@ -148,11 +151,11 @@ var PLUGIN_PRIORITY = 90;
  * customBorders: [
  *   { row: 2,
  *     col: 2,
- *     left: {
+ *     start: {
  *       width: 2,
  *       color: 'red',
  *     },
- *     right: {
+ *     end: {
  *       width: 1,
  *       color: 'green',
  *     },
@@ -170,33 +173,32 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
 
   var _super = _createSuper(CustomBorders);
 
-  function CustomBorders(hotInstance) {
+  function CustomBorders() {
     var _this;
 
     _classCallCheck(this, CustomBorders);
 
-    _this = _super.call(this, hotInstance);
-    /**
-     * Saved borders.
-     *
-     * @private
-     * @type {Array}
-     */
+    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));
+
+    _defineProperty(_assertThisInitialized(_this), "savedBorders", []);
 
-    _this.savedBorders = [];
     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` than the {@link CustomBorders#enablePlugin} method is called.
-   *
-   * @returns {boolean}
-   */
-
 
   _createClass(CustomBorders, [{
     key: "isEnabled",
-    value: function isEnabled() {
+    value:
+    /**
+     * Checks if the plugin is enabled in the handsontable settings. This method is executed in {@link Hooks#beforeInit}
+     * hook and if it returns `true` than the {@link CustomBorders#enablePlugin} method is called.
+     *
+     * @returns {boolean}
+     */
+    function isEnabled() {
       return !!this.hot.getSettings()[PLUGIN_KEY];
     }
     /**
@@ -233,7 +235,10 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
       _get(_getPrototypeOf(CustomBorders.prototype), "disablePlugin", this).call(this);
     }
     /**
-     * Updates the plugin state. This method is executed when {@link Core#updateSettings} is invoked.
+     * Updates the plugin's state.
+     *
+     * This method is executed when [`updateSettings()`](@/api/core.md#updatesettings) is invoked with any of the following configuration options:
+     *  - [`customBorders`](@/api/options.md#customborders)
      */
 
   }, {
@@ -253,17 +258,17 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
      * const customBordersPlugin = hot.getPlugin('customBorders');
      *
      * // Using an array of arrays (produced by `.getSelected()` method).
-     * customBordersPlugin.setBorders([[1, 1, 2, 2], [6, 2, 0, 2]], {left: {width: 2, color: 'blue'}});
+     * customBordersPlugin.setBorders([[1, 1, 2, 2], [6, 2, 0, 2]], {start: {width: 2, color: 'blue'}});
      *
      * // Using an array of CellRange objects (produced by `.getSelectedRange()` method).
      * //  Selecting a cell range.
      * hot.selectCell(0, 0, 2, 2);
      * // Returning selected cells' range with the getSelectedRange method.
-     * customBordersPlugin.setBorders(hot.getSelectedRange(), {left: {hide: false, width: 2, color: 'blue'}});
+     * customBordersPlugin.setBorders(hot.getSelectedRange(), {start: {hide: false, width: 2, color: 'blue'}});
      * ```
      *
      * @param {Array[]|CellRange[]} selectionRanges Array of selection ranges.
-     * @param {object} borderObject Object with `top`, `right`, `bottom` and `left` properties.
+     * @param {object} borderObject Object with `top`, `right`, `bottom` and `start` properties.
      */
 
   }, {
@@ -271,8 +276,15 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
     value: function setBorders(selectionRanges, borderObject) {
       var _this3 = this;
 
-      var defaultBorderKeys = ['top', 'right', 'bottom', 'left'];
-      var borderKeys = borderObject ? Object.keys(borderObject) : defaultBorderKeys;
+      var borderKeys = ['top', 'bottom', 'start', 'end'];
+      var normBorder = null;
+
+      if (borderObject) {
+        this.checkSettingsCohesion([borderObject]);
+        borderKeys = Object.keys(borderObject);
+        normBorder = (0, _utils.normalizeBorder)(borderObject);
+      }
+
       var selectionType = (0, _selection.detectSelectionType)(selectionRanges);
       var selectionSchemaNormalizer = (0, _selection.normalizeSelectionFactory)(selectionType);
       (0, _array.arrayEach)(selectionRanges, function (selection) {
@@ -286,7 +298,7 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
         var _loop = function _loop(row) {
           var _loop2 = function _loop2(col) {
             (0, _array.arrayEach)(borderKeys, function (borderKey) {
-              _this3.prepareBorderFromCustomAdded(row, col, borderObject, borderKey);
+              _this3.prepareBorderFromCustomAdded(row, col, normBorder, (0, _utils.toInlinePropName)(borderKey));
             });
           };
 
@@ -353,7 +365,7 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
           var _loop4 = function _loop4(col) {
             (0, _array.arrayEach)(_this4.savedBorders, function (border) {
               if (border.row === row && border.col === col) {
-                selectedBorders.push(border);
+                selectedBorders.push((0, _utils.denormalizeBorder)(border));
               }
             });
           };
@@ -409,8 +421,8 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
      * Insert WalkontableSelection instance into Walkontable settings.
      *
      * @private
-     * @param {object} border Object with `row` and `col`, `left`, `right`, `top` and `bottom`, `id` and `border` ({Object} with `color`, `width` and `cornerVisible` property) properties.
-     * @param {string} place Coordinate where add/remove border - `top`, `bottom`, `left`, `right`.
+     * @param {object} border Object with `row` and `col`, `start`, `end`, `top` and `bottom`, `id` and `border` ({Object} with `color`, `width` and `cornerVisible` property) properties.
+     * @param {string} [place] Coordinate where add/remove border - `top`, `bottom`, `start`, `end`.
      */
 
   }, {
@@ -422,7 +434,8 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
         this.savedBorders.push(border);
       }
 
-      var visualCellRange = new _src.CellRange(new _src.CellCoords(border.row, border.col));
+      var visualCellRange = this.hot._createCellRange(this.hot._createCellCoords(border.row, border.col));
+
       var hasCustomSelections = this.checkCustomSelections(border, visualCellRange, place);
 
       if (!hasCustomSelections) {
@@ -438,8 +451,8 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
      * @private
      * @param {number} row Visual row index.
      * @param {number} column Visual column index.
-     * @param {object} borderDescriptor Object with `row` and `col`, `left`, `right`, `top` and `bottom` properties.
-     * @param {string} place Coordinate where add/remove border - `top`, `bottom`, `left`, `right`.
+     * @param {object} borderDescriptor Object with `row` and `col`, `start`, `end`, `top` and `bottom` properties.
+     * @param {string} [place] Coordinate where add/remove border - `top`, `bottom`, `start`, `end`.
      */
 
   }, {
@@ -460,31 +473,31 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
           if (border.id === customSelection.settings.id) {
             Object.assign(customSelection.settings, borderDescriptor);
             border.id = customSelection.settings.id;
-            border.left = customSelection.settings.left;
-            border.right = customSelection.settings.right;
             border.top = customSelection.settings.top;
             border.bottom = customSelection.settings.bottom;
+            border.start = customSelection.settings.start;
+            border.end = customSelection.settings.end;
             return false; // breaks forAll
           }
         });
       }
 
-      this.hot.setCellMeta(row, column, 'borders', border);
+      this.hot.setCellMeta(row, column, 'borders', (0, _utils.denormalizeBorder)(border));
       this.insertBorderIntoSettings(border, place);
     }
     /**
      * Prepare borders from setting (object).
      *
      * @private
-     * @param {object} rowDecriptor Object with `range`, `left`, `right`, `top` and `bottom` properties.
+     * @param {object} range {CellRange} The CellRange object.
+     * @param {object} customBorder Object with `start`, `end`, `top` and `bottom` properties.
      */
 
   }, {
     key: "prepareBorderFromCustomAddedRange",
-    value: function prepareBorderFromCustomAddedRange(rowDecriptor) {
+    value: function prepareBorderFromCustomAddedRange(range, customBorder) {
       var _this6 = this;
 
-      var range = rowDecriptor.range;
       var lastRowIndex = Math.min(range.to.row, this.hot.countRows() - 1);
       var lastColumnIndex = Math.min(range.to.col, this.hot.countCols() - 1);
       (0, _number.rangeEach)(range.from.row, lastRowIndex, function (rowIndex) {
@@ -493,37 +506,37 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
           var add = 0;
 
           if (rowIndex === range.from.row) {
-            if ((0, _object.hasOwnProperty)(rowDecriptor, 'top')) {
+            if ((0, _object.hasOwnProperty)(customBorder, 'top')) {
               add += 1;
-              border.top = rowDecriptor.top;
+              border.top = customBorder.top;
             }
           } // Please keep in mind that `range.to.row` may be beyond the table boundaries. The border won't be rendered.
 
 
           if (rowIndex === range.to.row) {
-            if ((0, _object.hasOwnProperty)(rowDecriptor, 'bottom')) {
+            if ((0, _object.hasOwnProperty)(customBorder, 'bottom')) {
               add += 1;
-              border.bottom = rowDecriptor.bottom;
+              border.bottom = customBorder.bottom;
             }
           }
 
           if (colIndex === range.from.col) {
-            if ((0, _object.hasOwnProperty)(rowDecriptor, 'left')) {
+            if ((0, _object.hasOwnProperty)(customBorder, 'start')) {
               add += 1;
-              border.left = rowDecriptor.left;
+              border.start = customBorder.start;
             }
           } // Please keep in mind that `range.to.col` may be beyond the table boundaries. The border won't be rendered.
 
 
           if (colIndex === range.to.col) {
-            if ((0, _object.hasOwnProperty)(rowDecriptor, 'right')) {
+            if ((0, _object.hasOwnProperty)(customBorder, 'end')) {
               add += 1;
-              border.right = rowDecriptor.right;
+              border.end = customBorder.end;
             }
           }
 
           if (add > 0) {
-            _this6.hot.setCellMeta(rowIndex, colIndex, 'borders', border);
+            _this6.hot.setCellMeta(rowIndex, colIndex, 'borders', (0, _utils.denormalizeBorder)(border));
 
             _this6.insertBorderIntoSettings(border);
           } else {// TODO sometimes it enters here. Why?
@@ -554,7 +567,7 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
      * @private
      * @param {number} row Visual row index.
      * @param {number} column Visual column index.
-     * @param {string} place Coordinate where add/remove border - `top`, `bottom`, `left`, `right` and `noBorders`.
+     * @param {string} place Coordinate where add/remove border - `top`, `bottom`, `start`, `end` and `noBorders`.
      * @param {boolean} remove True when remove borders, and false when add borders.
      */
 
@@ -565,6 +578,8 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
 
       if (!bordersMeta || bordersMeta.border === void 0) {
         bordersMeta = (0, _utils.createEmptyBorders)(row, column);
+      } else {
+        bordersMeta = (0, _utils.normalizeBorder)(bordersMeta);
       }
 
       if (remove) {
@@ -580,7 +595,7 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
             this.insertBorderIntoSettings(bordersMeta);
           }
 
-          this.hot.setCellMeta(row, column, 'borders', bordersMeta);
+          this.hot.setCellMeta(row, column, 'borders', (0, _utils.denormalizeBorder)(bordersMeta));
         }
       } else {
         bordersMeta[place] = (0, _utils.createDefaultCustomBorder)();
@@ -591,7 +606,7 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
           this.insertBorderIntoSettings(bordersMeta);
         }
 
-        this.hot.setCellMeta(row, column, 'borders', bordersMeta);
+        this.hot.setCellMeta(row, column, 'borders', (0, _utils.denormalizeBorder)(bordersMeta));
       }
     }
     /**
@@ -634,21 +649,21 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
               });
               break;
 
-            case 'right':
-              (0, _number.rangeEach)(start.row, end.row, function (rowRight) {
-                _this7.setBorder(rowRight, end.col, place, remove);
-              });
-              break;
-
             case 'bottom':
               (0, _number.rangeEach)(start.col, end.col, function (bottomCol) {
                 _this7.setBorder(end.row, bottomCol, place, remove);
               });
               break;
 
-            case 'left':
-              (0, _number.rangeEach)(start.row, end.row, function (rowLeft) {
-                _this7.setBorder(rowLeft, start.col, place, remove);
+            case 'start':
+              (0, _number.rangeEach)(start.row, end.row, function (rowStart) {
+                _this7.setBorder(rowStart, start.col, place, remove);
+              });
+              break;
+
+            case 'end':
+              (0, _number.rangeEach)(start.row, end.row, function (rowEnd) {
+                _this7.setBorder(rowEnd, end.col, place, remove);
               });
               break;
 
@@ -662,7 +677,7 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
      * Create borders from settings.
      *
      * @private
-     * @param {Array} customBorders Object with `row` and `col`, `left`, `right`, `top` and `bottom` properties.
+     * @param {Array} customBorders Object with `row` and `col`, `start`, `end`, `top` and `bottom` properties.
      */
 
   }, {
@@ -671,10 +686,12 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
       var _this8 = this;
 
       (0, _array.arrayEach)(customBorders, function (customBorder) {
+        var normCustomBorder = (0, _utils.normalizeBorder)(customBorder);
+
         if (customBorder.range) {
-          _this8.prepareBorderFromCustomAddedRange(customBorder);
+          _this8.prepareBorderFromCustomAddedRange(customBorder.range, normCustomBorder);
         } else {
-          _this8.prepareBorderFromCustomAdded(customBorder.row, customBorder.col, customBorder);
+          _this8.prepareBorderFromCustomAdded(customBorder.row, customBorder.col, normCustomBorder);
         }
       });
     }
@@ -682,18 +699,23 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
      * Count hide property in border object.
      *
      * @private
-     * @param {object} border Object with `row` and `col`, `left`, `right`, `top` and `bottom`, `id` and `border` ({Object} with `color`, `width` and `cornerVisible` property) properties.
+     * @param {object} border Object with `row` and `col`, `start`, `end`, `top` and `bottom`, `id` and
+     *                        `border` ({Object} with `color`, `width` and `cornerVisible` property) properties.
      * @returns {number}
      */
 
   }, {
     key: "countHide",
     value: function countHide(border) {
-      var values = Object.values(border);
+      var top = border.top,
+          bottom = border.bottom,
+          start = border.start,
+          end = border.end;
+      var values = [top, bottom, start, end];
       return (0, _array.arrayReduce)(values, function (accumulator, value) {
         var result = accumulator;
 
-        if (value.hide) {
+        if (value && value.hide) {
           result += 1;
         }
 
@@ -778,7 +800,8 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
      * Check if an border already exists in the savedBorders array, and if true update border in savedBorders.
      *
      * @private
-     * @param {object} border Object with `row` and `col`, `left`, `right`, `top` and `bottom`, `id` and `border` ({Object} with `color`, `width` and `cornerVisible` property) properties.
+     * @param {object} border Object with `row` and `col`, `start`, `end`, `top` and `bottom`, `id` and
+     *                        `border` ({Object} with `color`, `width` and `cornerVisible` property) properties.
      *
      * @returns {boolean}
      */
@@ -810,8 +833,9 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
      * Check if an border already exists in the customSelections, and if true call toggleHiddenClass method.
      *
      * @private
-     * @param {object} border Object with `row` and `col`, `left`, `right`, `top` and `bottom`, `id` and `border` ({Object} with `color`, `width` and `cornerVisible` property) properties.
-     * @param {string} place Coordinate where add/remove border - `top`, `bottom`, `left`, `right` and `noBorders`.
+     * @param {object} border Object with `row` and `col`, `start`, `end`, `top` and `bottom`, `id` and
+     *                        `border` ({Object} with `color`, `width` and `cornerVisible` property) properties.
+     * @param {string} place Coordinate where add/remove border - `top`, `bottom`, `start`, `end` and `noBorders`.
      * @param {boolean} remove True when remove borders, and false when add borders.
      *
      * @returns {boolean}
@@ -836,9 +860,10 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
      * Check if an border already exists in the customSelections, and if true reset cellRange.
      *
      * @private
-     * @param {object} border Object with `row` and `col`, `left`, `right`, `top` and `bottom`, `id` and `border` ({Object} with `color`, `width` and `cornerVisible` property) properties.
+     * @param {object} border Object with `row` and `col`, `start`, `end`, `top` and `bottom`, `id` and
+     *                        `border` ({Object} with `color`, `width` and `cornerVisible` property) properties.
      * @param {CellRange} cellRange The selection range to check.
-     * @param {string} place Coordinate where add/remove border - `top`, `bottom`, `left`, `right`.
+     * @param {string} [place] Coordinate where add/remove border - `top`, `bottom`, `start`, `end`.
      * @returns {boolean}
      */
 
@@ -883,15 +908,40 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
       var customBorders = this.hot.getSettings()[PLUGIN_KEY];
 
       if (Array.isArray(customBorders)) {
-        if (!customBorders.length) {
-          this.savedBorders = customBorders;
+        var bordersClone = (0, _object.deepClone)(customBorders);
+        this.checkSettingsCohesion(bordersClone);
+
+        if (!bordersClone.length) {
+          this.savedBorders = bordersClone;
         }
 
-        this.createCustomBorders(customBorders);
+        this.createCustomBorders(bordersClone);
       } else if (customBorders !== void 0) {
         this.createCustomBorders(this.savedBorders);
       }
     }
+    /**
+     * Checks the settings cohesion. The properties such like "left"/"right" are supported only
+     * in the LTR mode and the "left"/"right" options can not be used together with "start"/"end" properties.
+     *
+     * @private
+     * @param {object[]} customBorders The user defined custom border objects array.
+     */
+
+  }, {
+    key: "checkSettingsCohesion",
+    value: function checkSettingsCohesion(customBorders) {
+      var hasLeftOrRight = (0, _utils.hasLeftRightTypeOptions)(customBorders);
+      var hasStartOrEnd = (0, _utils.hasStartEndTypeOptions)(customBorders);
+
+      if (hasLeftOrRight && hasStartOrEnd) {
+        throw new Error('The "left"/"right" and "start"/"end" options should not be used together. ' + 'Please use only the option "start"/"end".');
+      }
+
+      if (this.hot.isRtl() && hasLeftOrRight) {
+        throw new Error('The "left"/"right" properties are not supported for RTL. Please use option "start"/"end".');
+      }
+    }
     /**
      * Add border options to context menu.
      *
@@ -951,6 +1001,13 @@ var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
     get: function get() {
       return PLUGIN_PRIORITY;
     }
+    /**
+     * Saved borders.
+     *
+     * @private
+     * @type {Array}
+     */
+
   }]);
 
   return CustomBorders;