handsontable 13.1.0 → 14.0.0-next-e8f87aa-20231030

package/3rdparty/walkontable/src/calculator/constants.js

@@ -7,15 +7,14 @@ exports.__esModule = true;
  *
  * @type {number}
  */
-const RENDER_TYPE = 1;
+const RENDER_TYPE = exports.RENDER_TYPE = 1;
 /**
  * Fully visible type calculation calculates rows that are fully visible in the viewport.
  * This type of calculation is used in scrolling by arrow keys navigation.
  *
  * @type {number}
  */
-exports.RENDER_TYPE = RENDER_TYPE;
-const FULLY_VISIBLE_TYPE = 2;
+const FULLY_VISIBLE_TYPE = exports.FULLY_VISIBLE_TYPE = 2;
 /**
  * Partially visible type calculation calculates rows that are fully and partially visible in
  * the viewport. This type of calculation is used to check `endRow` (or `startRow`) with properties
@@ -24,6 +23,4 @@ const FULLY_VISIBLE_TYPE = 2;
  *
  * @type {number}
  */
-exports.FULLY_VISIBLE_TYPE = FULLY_VISIBLE_TYPE;
-const PARTIALLY_VISIBLE_TYPE = 3;
-exports.PARTIALLY_VISIBLE_TYPE = PARTIALLY_VISIBLE_TYPE;
+const PARTIALLY_VISIBLE_TYPE = exports.PARTIALLY_VISIBLE_TYPE = 3;

package/3rdparty/walkontable/src/calculator/viewportColumns.js

@@ -289,5 +289,4 @@ class ViewportColumnsCalculator {
     return width;
   }
 }
-var _default = ViewportColumnsCalculator;
-exports.default = _default;
+var _default = exports.default = ViewportColumnsCalculator;

package/3rdparty/walkontable/src/calculator/viewportRows.js

@@ -173,5 +173,4 @@ class ViewportRowsCalculator {
     }
   }
 }
-var _default = ViewportRowsCalculator;
-exports.default = _default;
+var _default = exports.default = ViewportRowsCalculator;

package/3rdparty/walkontable/src/cell/coords.d.ts

@@ -4,13 +4,20 @@ export default class CellCoords {
   row: number;
   col: number;
 
-  isValid(wot: any): boolean;
+  isValid(tableParams: {
+    countRows?: number;
+    countCols?: number;
+    countRowHeaders?: number;
+    countColHeaders?: number;
+  }): boolean;
+  isRtl(): boolean;
   isEqual(cellCoords: CellCoords): boolean;
   isSouthEastOf(testedCoords: any): boolean;
   isNorthWestOf(testedCoords: any): boolean;
   isSouthWestOf(testedCoords: any): boolean;
   isNorthEastOf(testedCoords: any): boolean;
   normalize(): CellCoords;
+  assign(coords: CellCoords | { row?: number, col?: number }): CellCoords;
   clone(): CellCoords;
   toObject(): any;
 }

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

@@ -62,26 +62,45 @@ class CellCoords {
 
   /**
    * Checks if the coordinates in your `CellCoords` instance are valid
-   * in the context of a given Walkontable instance.
+   * in the context of given table parameters.
    *
    * The `row` index:
-   * - Can't be negative.
-   * - Can't be higher than the total number of rows in the Walkontable instance.
+   * - Must be an integer.
+   * - Must be higher than the number of column headers in the table.
+   * - Must be lower than the total number of rows in the table.
    *
    * The `col` index:
-   * - Can't be negative.
-   * - Can't be higher than the total number of columns in the Walkontable instance.
+   * - Must be an integer.
+   * - Must be higher than the number of row headers in the table.
+   * - Must be lower than the total number of columns in the table.
    *
-   * @param {Walkontable} wot A Walkontable instance.
+   * @param {object} [tableParams] An object with a defined table size.
+   * @param {number} [tableParams.countRows=0] The total number of rows.
+   * @param {number} [tableParams.countCols=0] The total number of columns.
+   * @param {number} [tableParams.countRowHeaders=0] A number of row headers.
+   * @param {number} [tableParams.countColHeaders=0] A number of column headers.
    * @returns {boolean} `true`: The coordinates are valid.
    */
-  isValid(wot) {
-    // check if the row and column indexes are valid (0 or higher)
-    if (this.row < 0 || this.col < 0) {
+  isValid(tableParams) {
+    const {
+      countRows,
+      countCols,
+      countRowHeaders,
+      countColHeaders
+    } = {
+      countRows: 0,
+      countCols: 0,
+      countRowHeaders: 0,
+      countColHeaders: 0,
+      ...tableParams
+    };
+    if (!Number.isInteger(this.row) || !Number.isInteger(this.col)) {
+      return false;
+    }
+    if (this.row < -countColHeaders || this.col < -countRowHeaders) {
       return false;
     }
-    // check if the selection fits in the total of rows and columns
-    if (this.row >= wot.getSetting('totalRows') || this.col >= wot.getSetting('totalColumns')) {
+    if (this.row >= countRows || this.col >= countCols) {
       return false;
     }
     return true;
@@ -101,6 +120,35 @@ class CellCoords {
     return this.row === cellCoords.row && this.col === cellCoords.col;
   }
 
+  /**
+   * Checks if the coordinates point to the headers range. If one of the axis (row or col) point to
+   * the header (negative value) then method returns `true`.
+   *
+   * @returns {boolean}
+   */
+  isHeader() {
+    return !this.isCell();
+  }
+
+  /**
+   * Checks if the coordinates point to the cells range. If all axis (row and col) point to
+   * the cell (positive value) then method returns `true`.
+   *
+   * @returns {boolean}
+   */
+  isCell() {
+    return this.row >= 0 && this.col >= 0;
+  }
+
+  /**
+   * Checks if the coordinates runs in RTL mode.
+   *
+   * @returns {boolean}
+   */
+  isRtl() {
+    return _classPrivateFieldGet(this, _isRtl);
+  }
+
   /**
    * Checks if another set of coordinates (`testedCoords`)
    * is south-east of the coordinates in your `CellCoords` instance.
@@ -158,6 +206,27 @@ class CellCoords {
     return this;
   }
 
+  /**
+   * Assigns the coordinates from another `CellCoords` instance (or compatible literal object)
+   * to your `CellCoords` instance.
+   *
+   * @param {CellCoords | { row: number | undefined, col: number | undefined }} coords The CellCoords
+   * instance or compatible literal object.
+   * @returns {CellCoords}
+   */
+  assign(coords) {
+    if (Number.isInteger(coords === null || coords === void 0 ? void 0 : coords.row)) {
+      this.row = coords.row;
+    }
+    if (Number.isInteger(coords === null || coords === void 0 ? void 0 : coords.col)) {
+      this.col = coords.col;
+    }
+    if (coords instanceof CellCoords) {
+      _classPrivateFieldSet(this, _isRtl, coords.isRtl());
+    }
+    return this;
+  }
+
   /**
    * Clones your `CellCoords` instance.
    *
@@ -179,5 +248,4 @@ class CellCoords {
     };
   }
 }
-var _default = CellCoords;
-exports.default = _default;
+var _default = exports.default = CellCoords;

package/3rdparty/walkontable/src/cell/coords.mjs

@@ -59,26 +59,45 @@ class CellCoords {
 
   /**
    * Checks if the coordinates in your `CellCoords` instance are valid
-   * in the context of a given Walkontable instance.
+   * in the context of given table parameters.
    *
    * The `row` index:
-   * - Can't be negative.
-   * - Can't be higher than the total number of rows in the Walkontable instance.
+   * - Must be an integer.
+   * - Must be higher than the number of column headers in the table.
+   * - Must be lower than the total number of rows in the table.
    *
    * The `col` index:
-   * - Can't be negative.
-   * - Can't be higher than the total number of columns in the Walkontable instance.
+   * - Must be an integer.
+   * - Must be higher than the number of row headers in the table.
+   * - Must be lower than the total number of columns in the table.
    *
-   * @param {Walkontable} wot A Walkontable instance.
+   * @param {object} [tableParams] An object with a defined table size.
+   * @param {number} [tableParams.countRows=0] The total number of rows.
+   * @param {number} [tableParams.countCols=0] The total number of columns.
+   * @param {number} [tableParams.countRowHeaders=0] A number of row headers.
+   * @param {number} [tableParams.countColHeaders=0] A number of column headers.
    * @returns {boolean} `true`: The coordinates are valid.
    */
-  isValid(wot) {
-    // check if the row and column indexes are valid (0 or higher)
-    if (this.row < 0 || this.col < 0) {
+  isValid(tableParams) {
+    const {
+      countRows,
+      countCols,
+      countRowHeaders,
+      countColHeaders
+    } = {
+      countRows: 0,
+      countCols: 0,
+      countRowHeaders: 0,
+      countColHeaders: 0,
+      ...tableParams
+    };
+    if (!Number.isInteger(this.row) || !Number.isInteger(this.col)) {
+      return false;
+    }
+    if (this.row < -countColHeaders || this.col < -countRowHeaders) {
       return false;
     }
-    // check if the selection fits in the total of rows and columns
-    if (this.row >= wot.getSetting('totalRows') || this.col >= wot.getSetting('totalColumns')) {
+    if (this.row >= countRows || this.col >= countCols) {
       return false;
     }
     return true;
@@ -98,6 +117,35 @@ class CellCoords {
     return this.row === cellCoords.row && this.col === cellCoords.col;
   }
 
+  /**
+   * Checks if the coordinates point to the headers range. If one of the axis (row or col) point to
+   * the header (negative value) then method returns `true`.
+   *
+   * @returns {boolean}
+   */
+  isHeader() {
+    return !this.isCell();
+  }
+
+  /**
+   * Checks if the coordinates point to the cells range. If all axis (row and col) point to
+   * the cell (positive value) then method returns `true`.
+   *
+   * @returns {boolean}
+   */
+  isCell() {
+    return this.row >= 0 && this.col >= 0;
+  }
+
+  /**
+   * Checks if the coordinates runs in RTL mode.
+   *
+   * @returns {boolean}
+   */
+  isRtl() {
+    return _classPrivateFieldGet(this, _isRtl);
+  }
+
   /**
    * Checks if another set of coordinates (`testedCoords`)
    * is south-east of the coordinates in your `CellCoords` instance.
@@ -155,6 +203,27 @@ class CellCoords {
     return this;
   }
 
+  /**
+   * Assigns the coordinates from another `CellCoords` instance (or compatible literal object)
+   * to your `CellCoords` instance.
+   *
+   * @param {CellCoords | { row: number | undefined, col: number | undefined }} coords The CellCoords
+   * instance or compatible literal object.
+   * @returns {CellCoords}
+   */
+  assign(coords) {
+    if (Number.isInteger(coords === null || coords === void 0 ? void 0 : coords.row)) {
+      this.row = coords.row;
+    }
+    if (Number.isInteger(coords === null || coords === void 0 ? void 0 : coords.col)) {
+      this.col = coords.col;
+    }
+    if (coords instanceof CellCoords) {
+      _classPrivateFieldSet(this, _isRtl, coords.isRtl());
+    }
+    return this;
+  }
+
   /**
    * Clones your `CellCoords` instance.
    *

package/3rdparty/walkontable/src/cell/range.d.ts

@@ -12,8 +12,15 @@ export default class CellRange {
   setHighlight(coords: CellCoords): CellRange;
   setFrom(coords: CellCoords): CellRange;
   setTo(coords: CellCoords): CellRange;
-  isValid(wot: any): boolean;
-  isSingle(): boolean;
+  isValid(tableParams: {
+    countRows?: number;
+    countCols?: number;
+    countRowHeaders?: number;
+    countColHeaders?: number;
+  }): boolean;
+  isSingleCell(): boolean;
+  isSingleHeader(): boolean;
+  containsHeaders(): boolean;
   getOuterHeight(): number;
   getOuterWidth(): number;
   getHeight(): number;

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

@@ -71,7 +71,7 @@ class CellRange {
       writable: true,
       value: false
     });
-    this.highlight = highlight.clone().normalize();
+    this.highlight = highlight.clone();
     this.from = from.clone();
     this.to = to.clone();
     _classPrivateFieldSet(this, _isRtl, isRtl);
@@ -84,7 +84,7 @@ class CellRange {
    * @returns {CellRange}
    */
   setHighlight(coords) {
-    this.highlight = coords.clone().normalize();
+    this.highlight = coords.clone();
     return this;
   }
 
@@ -112,26 +112,57 @@ class CellRange {
 
   /**
    * Checks if the coordinates in your `CellRange` instance are valid
-   * in the context of a given Walkontable instance.
+   * in the context of given table parameters.
    *
    * See the [`isValid()`](@/api/cellCoords.md#isvalid) method of the [`CellCoords`](@/api/cellCoords.md) class.
    *
-   * @param {Walkontable} wot A Walkontable instance.
+   * @param {object} tableParams An object with a defined table size.
+   * @param {number} tableParams.countRows The total number of rows.
+   * @param {number} tableParams.countCols The total number of columns.
+   * @param {number} tableParams.countRowHeaders A number of row headers.
+   * @param {number} tableParams.countColHeaders A number of column headers.
    * @returns {boolean}
    */
-  isValid(wot) {
-    return this.from.isValid(wot) && this.to.isValid(wot);
+  isValid(tableParams) {
+    return this.from.isValid(tableParams) && this.to.isValid(tableParams);
   }
 
   /**
-   * Checks if your range is just a single cell.
+   * Checks if your range is just a single cell or header.
    *
    * @returns {boolean}
    */
   isSingle() {
+    return this.isSingleCell() || this.isSingleHeader();
+  }
+
+  /**
+   * Checks if your range is just a single cell.
+   *
+   * @returns {boolean}
+   */
+  isSingleCell() {
     return this.from.row >= 0 && this.from.row === this.to.row && this.from.col >= 0 && this.from.col === this.to.col;
   }
 
+  /**
+   * Checks if your range is just a single header.
+   *
+   * @returns {boolean}
+   */
+  isSingleHeader() {
+    return (this.from.row < 0 || this.from.col < 0) && this.from.row === this.to.row && this.from.col === this.to.col;
+  }
+
+  /**
+   * Checks if your range overlaps headers range (negative coordinates).
+   *
+   * @returns {boolean}
+   */
+  containsHeaders() {
+    return this.from.isHeader() || this.to.isHeader();
+  }
+
   /**
    * Returns the height of your range (as a number of rows, including row headers).
    *
@@ -848,5 +879,4 @@ class CellRange {
     return new _coords.default(row, column, _classPrivateFieldGet(this, _isRtl));
   }
 }
-var _default = CellRange;
-exports.default = _default;
+var _default = exports.default = CellRange;

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

@@ -67,7 +67,7 @@ class CellRange {
       writable: true,
       value: false
     });
-    this.highlight = highlight.clone().normalize();
+    this.highlight = highlight.clone();
     this.from = from.clone();
     this.to = to.clone();
     _classPrivateFieldSet(this, _isRtl, isRtl);
@@ -80,7 +80,7 @@ class CellRange {
    * @returns {CellRange}
    */
   setHighlight(coords) {
-    this.highlight = coords.clone().normalize();
+    this.highlight = coords.clone();
     return this;
   }
 
@@ -108,26 +108,57 @@ class CellRange {
 
   /**
    * Checks if the coordinates in your `CellRange` instance are valid
-   * in the context of a given Walkontable instance.
+   * in the context of given table parameters.
    *
    * See the [`isValid()`](@/api/cellCoords.md#isvalid) method of the [`CellCoords`](@/api/cellCoords.md) class.
    *
-   * @param {Walkontable} wot A Walkontable instance.
+   * @param {object} tableParams An object with a defined table size.
+   * @param {number} tableParams.countRows The total number of rows.
+   * @param {number} tableParams.countCols The total number of columns.
+   * @param {number} tableParams.countRowHeaders A number of row headers.
+   * @param {number} tableParams.countColHeaders A number of column headers.
    * @returns {boolean}
    */
-  isValid(wot) {
-    return this.from.isValid(wot) && this.to.isValid(wot);
+  isValid(tableParams) {
+    return this.from.isValid(tableParams) && this.to.isValid(tableParams);
   }
 
   /**
-   * Checks if your range is just a single cell.
+   * Checks if your range is just a single cell or header.
    *
    * @returns {boolean}
    */
   isSingle() {
+    return this.isSingleCell() || this.isSingleHeader();
+  }
+
+  /**
+   * Checks if your range is just a single cell.
+   *
+   * @returns {boolean}
+   */
+  isSingleCell() {
     return this.from.row >= 0 && this.from.row === this.to.row && this.from.col >= 0 && this.from.col === this.to.col;
   }
 
+  /**
+   * Checks if your range is just a single header.
+   *
+   * @returns {boolean}
+   */
+  isSingleHeader() {
+    return (this.from.row < 0 || this.from.col < 0) && this.from.row === this.to.row && this.from.col === this.to.col;
+  }
+
+  /**
+   * Checks if your range overlaps headers range (negative coordinates).
+   *
+   * @returns {boolean}
+   */
+  containsHeaders() {
+    return this.from.isHeader() || this.to.isHeader();
+  }
+
   /**
    * Returns the height of your range (as a number of rows, including row headers).
    *

package/3rdparty/walkontable/src/core/_base.js

@@ -31,7 +31,7 @@ class CoreAbstract {
     _defineProperty(this, "wtScroll", void 0);
     _defineProperty(this, "wtViewport", void 0);
     _defineProperty(this, "wtOverlays", void 0);
-    _defineProperty(this, "selections", void 0);
+    _defineProperty(this, "selectionManager", void 0);
     _defineProperty(this, "wtEvent", void 0);
     /**
      * The walkontable instance id.
@@ -309,8 +309,8 @@ class CoreAbstract {
         return wot.wtOverlays; // TODO refactoring: move outside dao, use IOC
       },
 
-      get selections() {
-        return wot.selections; // TODO refactoring: move outside dao, use IOC
+      get selectionManager() {
+        return wot.selectionManager; // TODO refactoring: move outside dao, use IOC
       },
 
       get drawn() {
@@ -359,6 +359,12 @@ class CoreAbstract {
       },
       get countRowsVisible() {
         return wot.wtViewport.rowsVisibleCalculator.count;
+      },
+      get columnHeaders() {
+        return wot.wtSettings.getSetting('columnHeaders');
+      },
+      get rowHeaders() {
+        return wot.wtSettings.getSetting('rowHeaders');
       }
     };
   }

package/3rdparty/walkontable/src/core/_base.mjs

@@ -27,7 +27,7 @@ export default class CoreAbstract {
     _defineProperty(this, "wtScroll", void 0);
     _defineProperty(this, "wtViewport", void 0);
     _defineProperty(this, "wtOverlays", void 0);
-    _defineProperty(this, "selections", void 0);
+    _defineProperty(this, "selectionManager", void 0);
     _defineProperty(this, "wtEvent", void 0);
     /**
      * The walkontable instance id.
@@ -305,8 +305,8 @@ export default class CoreAbstract {
         return wot.wtOverlays; // TODO refactoring: move outside dao, use IOC
       },
 
-      get selections() {
-        return wot.selections; // TODO refactoring: move outside dao, use IOC
+      get selectionManager() {
+        return wot.selectionManager; // TODO refactoring: move outside dao, use IOC
       },
 
       get drawn() {
@@ -355,6 +355,12 @@ export default class CoreAbstract {
       },
       get countRowsVisible() {
         return wot.wtViewport.rowsVisibleCalculator.count;
+      },
+      get columnHeaders() {
+        return wot.wtSettings.getSetting('columnHeaders');
+      },
+      get rowHeaders() {
+        return wot.wtSettings.getSetting('rowHeaders');
       }
     };
   }

package/3rdparty/walkontable/src/core/clone.js

@@ -26,8 +26,8 @@ class Clone extends _base.default {
     this.cloneOverlay = clone.overlay;
     this.wtTable = this.cloneOverlay.createTable(this.getTableDao(), facadeGetter, this.domBindings, this.wtSettings);
     this.wtViewport = clone.viewport;
-    this.selections = clone.selections;
-    this.wtEvent = new _event.default(facadeGetter, this.domBindings, this.wtSettings, this.eventManager, this.wtTable, this.selections, clone.event);
+    this.selectionManager = clone.selectionManager;
+    this.wtEvent = new _event.default(facadeGetter, this.domBindings, this.wtSettings, this.eventManager, this.wtTable, this.selectionManager, clone.event);
     this.findOriginalHeaders();
   }
 }

package/3rdparty/walkontable/src/core/clone.mjs

@@ -22,8 +22,8 @@ export default class Clone extends CoreAbstract {
     this.cloneOverlay = clone.overlay;
     this.wtTable = this.cloneOverlay.createTable(this.getTableDao(), facadeGetter, this.domBindings, this.wtSettings);
     this.wtViewport = clone.viewport;
-    this.selections = clone.selections;
-    this.wtEvent = new Event(facadeGetter, this.domBindings, this.wtSettings, this.eventManager, this.wtTable, this.selections, clone.event);
+    this.selectionManager = clone.selectionManager;
+    this.wtEvent = new Event(facadeGetter, this.domBindings, this.wtSettings, this.eventManager, this.wtTable, this.selectionManager, clone.event);
     this.findOriginalHeaders();
   }
 }

package/3rdparty/walkontable/src/core/core.js

@@ -8,6 +8,7 @@ var _settings = _interopRequireDefault(require("../settings"));
 var _master = _interopRequireDefault(require("../table/master"));
 var _viewport = _interopRequireDefault(require("../viewport"));
 var _base = _interopRequireDefault(require("./_base"));
+var _manager = require("../selection/manager");
 var _object = require("../../../../helpers/object");
 var _element = require("../../../../helpers/dom/element");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
@@ -25,8 +26,8 @@ class Walkontable extends _base.default {
 
     this.wtTable = new _master.default(this.getTableDao(), facadeGetter, this.domBindings, this.wtSettings);
     this.wtViewport = new _viewport.default(this.getViewportDao(), this.domBindings, this.wtSettings, this.eventManager, this.wtTable);
-    this.selections = this.wtSettings.getSetting('selections');
-    this.wtEvent = new _event.default(facadeGetter, this.domBindings, this.wtSettings, this.eventManager, this.wtTable, this.selections);
+    this.selectionManager = new _manager.SelectionManager(this.wtSettings.getSetting('selections'));
+    this.wtEvent = new _event.default(facadeGetter, this.domBindings, this.wtSettings, this.eventManager, this.wtTable, this.selectionManager);
     this.wtOverlays = new _overlays.default(
     // TODO create DAO and remove reference to the Walkontable instance.
     this, facadeGetter, this.domBindings, this.wtSettings, this.eventManager, this.wtTable);

package/3rdparty/walkontable/src/core/core.mjs

@@ -5,6 +5,7 @@ import Settings from "../settings.mjs";
 import MasterTable from "../table/master.mjs";
 import Viewport from "../viewport.mjs";
 import CoreAbstract from "./_base.mjs";
+import { SelectionManager } from "../selection/manager.mjs";
 import { objectEach } from "../../../../helpers/object.mjs";
 import { addClass, removeClass } from "../../../../helpers/dom/element.mjs";
 /**
@@ -21,8 +22,8 @@ export default class Walkontable extends CoreAbstract {
 
     this.wtTable = new MasterTable(this.getTableDao(), facadeGetter, this.domBindings, this.wtSettings);
     this.wtViewport = new Viewport(this.getViewportDao(), this.domBindings, this.wtSettings, this.eventManager, this.wtTable);
-    this.selections = this.wtSettings.getSetting('selections');
-    this.wtEvent = new Event(facadeGetter, this.domBindings, this.wtSettings, this.eventManager, this.wtTable, this.selections);
+    this.selectionManager = new SelectionManager(this.wtSettings.getSetting('selections'));
+    this.wtEvent = new Event(facadeGetter, this.domBindings, this.wtSettings, this.eventManager, this.wtTable, this.selectionManager);
     this.wtOverlays = new Overlays(
     // TODO create DAO and remove reference to the Walkontable instance.
     this, facadeGetter, this.domBindings, this.wtSettings, this.eventManager, this.wtTable);