handsontable 11.1.0 → 12.1.0

package/plugins/customBorders/customBorders.mjs

@@ -12,9 +12,9 @@ function _iterableToArrayLimit(arr, i) { var _i = arr == null ? null : typeof Sy
 
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 
+import "core-js/modules/es.array.concat.js";
 import "core-js/modules/es.object.keys.js";
 import "core-js/modules/es.object.assign.js";
-import "core-js/modules/es.object.values.js";
 import "core-js/modules/es.array.index-of.js";
 import "core-js/modules/es.array.splice.js";
 import "core-js/modules/es.object.set-prototype-of.js";
@@ -40,13 +40,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); }; }
 
@@ -56,19 +56,22 @@ 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; }
 
 import { BasePlugin } from "../base/index.mjs";
-import { hasOwnProperty, objectEach } from "../../helpers/object.mjs";
+import { hasOwnProperty, objectEach, deepClone } from "../../helpers/object.mjs";
 import { rangeEach } from "../../helpers/number.mjs";
 import { arrayEach, arrayReduce, arrayMap } from "../../helpers/array.mjs";
-import { CellRange, CellCoords } from "../../3rdparty/walkontable/src/index.mjs";
 import * as C from "../../i18n/constants.mjs";
-import { bottom, left, noBorders, right, top } from "./contextMenuItem/index.mjs";
-import { createId, createDefaultCustomBorder, createSingleEmptyBorder, createEmptyBorders, extendDefaultBorder } from "./utils.mjs";
+import { top as menuItemTop, bottom as menuItemBottom, left as menuItemLeft, right as menuItemRight, noBorders as menuItemNoBorders } from "./contextMenuItem/index.mjs";
+import { createId, createDefaultCustomBorder, createSingleEmptyBorder, createEmptyBorders, extendDefaultBorder, hasLeftRightTypeOptions, hasStartEndTypeOptions, toInlinePropName, normalizeBorder, denormalizeBorder } from "./utils.mjs";
 import { detectSelectionType, normalizeSelectionFactory } from "../../selection/index.mjs";
 export var PLUGIN_KEY = 'customBorders';
 export var PLUGIN_PRIORITY = 90;
+/* eslint-disable jsdoc/require-description-complete-sentence */
+
 /**
  * @plugin CustomBorders
  * @class CustomBorders
@@ -80,7 +83,8 @@ export 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
@@ -96,8 +100,8 @@ export var PLUGIN_PRIORITY = 90;
  *        col: 4
  *      },
  *    },
- *    left: {},
- *    right: {},
+ *    start: {},
+ *    end: {},
  *    top: {},
  *    bottom: {},
  *   },
@@ -107,11 +111,11 @@ export var PLUGIN_PRIORITY = 90;
  * customBorders: [
  *   { row: 2,
  *     col: 2,
- *     left: {
+ *     start: {
  *       width: 2,
  *       color: 'red',
  *     },
- *     right: {
+ *     end: {
  *       width: 1,
  *       color: 'green',
  *     },
@@ -127,33 +131,32 @@ export 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];
     }
     /**
@@ -190,7 +193,10 @@ export 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)
      */
 
   }, {
@@ -210,17 +216,17 @@ export 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.
      */
 
   }, {
@@ -228,8 +234,15 @@ export 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 = normalizeBorder(borderObject);
+      }
+
       var selectionType = detectSelectionType(selectionRanges);
       var selectionSchemaNormalizer = normalizeSelectionFactory(selectionType);
       arrayEach(selectionRanges, function (selection) {
@@ -243,7 +256,7 @@ export var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
         var _loop = function _loop(row) {
           var _loop2 = function _loop2(col) {
             arrayEach(borderKeys, function (borderKey) {
-              _this3.prepareBorderFromCustomAdded(row, col, borderObject, borderKey);
+              _this3.prepareBorderFromCustomAdded(row, col, normBorder, toInlinePropName(borderKey));
             });
           };
 
@@ -310,7 +323,7 @@ export var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
           var _loop4 = function _loop4(col) {
             arrayEach(_this4.savedBorders, function (border) {
               if (border.row === row && border.col === col) {
-                selectedBorders.push(border);
+                selectedBorders.push(denormalizeBorder(border));
               }
             });
           };
@@ -366,8 +379,8 @@ export 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`.
      */
 
   }, {
@@ -379,7 +392,8 @@ export var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
         this.savedBorders.push(border);
       }
 
-      var visualCellRange = new CellRange(new 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) {
@@ -395,8 +409,8 @@ export 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`.
      */
 
   }, {
@@ -417,31 +431,31 @@ export 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', 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);
       rangeEach(range.from.row, lastRowIndex, function (rowIndex) {
@@ -450,37 +464,37 @@ export var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
           var add = 0;
 
           if (rowIndex === range.from.row) {
-            if (hasOwnProperty(rowDecriptor, 'top')) {
+            if (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 (hasOwnProperty(rowDecriptor, 'bottom')) {
+            if (hasOwnProperty(customBorder, 'bottom')) {
               add += 1;
-              border.bottom = rowDecriptor.bottom;
+              border.bottom = customBorder.bottom;
             }
           }
 
           if (colIndex === range.from.col) {
-            if (hasOwnProperty(rowDecriptor, 'left')) {
+            if (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 (hasOwnProperty(rowDecriptor, 'right')) {
+            if (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', denormalizeBorder(border));
 
             _this6.insertBorderIntoSettings(border);
           } else {// TODO sometimes it enters here. Why?
@@ -511,7 +525,7 @@ export 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.
      */
 
@@ -522,6 +536,8 @@ export var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
 
       if (!bordersMeta || bordersMeta.border === void 0) {
         bordersMeta = createEmptyBorders(row, column);
+      } else {
+        bordersMeta = normalizeBorder(bordersMeta);
       }
 
       if (remove) {
@@ -537,7 +553,7 @@ export var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
             this.insertBorderIntoSettings(bordersMeta);
           }
 
-          this.hot.setCellMeta(row, column, 'borders', bordersMeta);
+          this.hot.setCellMeta(row, column, 'borders', denormalizeBorder(bordersMeta));
         }
       } else {
         bordersMeta[place] = createDefaultCustomBorder();
@@ -548,7 +564,7 @@ export var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
           this.insertBorderIntoSettings(bordersMeta);
         }
 
-        this.hot.setCellMeta(row, column, 'borders', bordersMeta);
+        this.hot.setCellMeta(row, column, 'borders', denormalizeBorder(bordersMeta));
       }
     }
     /**
@@ -591,21 +607,21 @@ export var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
               });
               break;
 
-            case 'right':
-              rangeEach(start.row, end.row, function (rowRight) {
-                _this7.setBorder(rowRight, end.col, place, remove);
-              });
-              break;
-
             case 'bottom':
               rangeEach(start.col, end.col, function (bottomCol) {
                 _this7.setBorder(end.row, bottomCol, place, remove);
               });
               break;
 
-            case 'left':
-              rangeEach(start.row, end.row, function (rowLeft) {
-                _this7.setBorder(rowLeft, start.col, place, remove);
+            case 'start':
+              rangeEach(start.row, end.row, function (rowStart) {
+                _this7.setBorder(rowStart, start.col, place, remove);
+              });
+              break;
+
+            case 'end':
+              rangeEach(start.row, end.row, function (rowEnd) {
+                _this7.setBorder(rowEnd, end.col, place, remove);
               });
               break;
 
@@ -619,7 +635,7 @@ export 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.
      */
 
   }, {
@@ -628,10 +644,12 @@ export var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
       var _this8 = this;
 
       arrayEach(customBorders, function (customBorder) {
+        var normCustomBorder = 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);
         }
       });
     }
@@ -639,18 +657,23 @@ export 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 arrayReduce(values, function (accumulator, value) {
         var result = accumulator;
 
-        if (value.hide) {
+        if (value && value.hide) {
           result += 1;
         }
 
@@ -735,7 +758,8 @@ export 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}
      */
@@ -767,8 +791,9 @@ export 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}
@@ -793,9 +818,10 @@ export 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}
      */
 
@@ -840,15 +866,40 @@ export var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
       var customBorders = this.hot.getSettings()[PLUGIN_KEY];
 
       if (Array.isArray(customBorders)) {
-        if (!customBorders.length) {
-          this.savedBorders = customBorders;
+        var bordersClone = 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 = hasLeftRightTypeOptions(customBorders);
+      var hasStartOrEnd = 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.
      *
@@ -874,7 +925,7 @@ export var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
           return this.selection.isSelectedByCorner();
         },
         submenu: {
-          items: [top(this), right(this), bottom(this), left(this), noBorders(this)]
+          items: [menuItemTop(this), menuItemRight(this), menuItemBottom(this), menuItemLeft(this), menuItemNoBorders(this)]
         }
       });
     }
@@ -908,6 +959,13 @@ export var CustomBorders = /*#__PURE__*/function (_BasePlugin) {
     get: function get() {
       return PLUGIN_PRIORITY;
     }
+    /**
+     * Saved borders.
+     *
+     * @private
+     * @type {Array}
+     */
+
   }]);
 
   return CustomBorders;