handsontable 0.0.0-next-a1e4b4f-20230628 → 0.0.0-next-e697250-20230707

package/plugins/copyPaste/copyableRanges.js

@@ -33,6 +33,13 @@ function _classApplyDescriptorGet(receiver, descriptor) { if (descriptor.get) {
 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; } }
+/**
+ * The utils class produces the selection ranges in the `{startRow, startCol, endRow, endCol}` format
+ * based on the current table selection. The CopyPaste plugin consumes that ranges to generate
+ * appropriate data ready to copy to the clipboard.
+ *
+ * @private
+ */
 var _selectedRange = /*#__PURE__*/new WeakMap();
 var _countRows = /*#__PURE__*/new WeakMap();
 var _countColumns = /*#__PURE__*/new WeakMap();
@@ -41,38 +48,7 @@ var _columnsLimit = /*#__PURE__*/new WeakMap();
 var _countColumnHeaders = /*#__PURE__*/new WeakMap();
 var _trimColumnsRange = /*#__PURE__*/new WeakSet();
 var _trimRowsRange = /*#__PURE__*/new WeakSet();
-/**
- * The utils class produces the selection ranges in the `{startRow, startCol, endRow, endCol}` format
- * based on the current table selection. The CopyPaste plugin consumes that ranges to generate
- * appropriate data ready to copy to the clipboard.
- *
- * @private
- */
 var CopyableRangesFactory = /*#__PURE__*/function () {
-  /**
-   * @type {CellRange}
-   */
-
-  /**
-   * @type {function(): number}
-   */
-
-  /**
-   * @type {function(): number}
-   */
-
-  /**
-   * @type {function(): number}
-   */
-
-  /**
-   * @type {function(): number}
-   */
-
-  /**
-   * @type {function(): number}
-   */
-
   /* eslint-disable jsdoc/require-description-complete-sentence */
   /**
    * @param {{
@@ -106,26 +82,44 @@ var CopyableRangesFactory = /*#__PURE__*/function () {
      * @returns {number} Returns trimmed column index if it exceeds the limit.
      */
     _classPrivateMethodInitSpec(this, _trimColumnsRange);
+    /**
+     * @type {CellRange}
+     */
     _classPrivateFieldInitSpec(this, _selectedRange, {
       writable: true,
       value: void 0
     });
+    /**
+     * @type {function(): number}
+     */
     _classPrivateFieldInitSpec(this, _countRows, {
       writable: true,
       value: void 0
     });
+    /**
+     * @type {function(): number}
+     */
     _classPrivateFieldInitSpec(this, _countColumns, {
       writable: true,
       value: void 0
     });
+    /**
+     * @type {function(): number}
+     */
     _classPrivateFieldInitSpec(this, _rowsLimit, {
       writable: true,
       value: void 0
     });
+    /**
+     * @type {function(): number}
+     */
     _classPrivateFieldInitSpec(this, _columnsLimit, {
       writable: true,
       value: void 0
     });
+    /**
+     * @type {function(): number}
+     */
     _classPrivateFieldInitSpec(this, _countColumnHeaders, {
       writable: true,
       value: void 0

package/plugins/copyPaste/copyableRanges.mjs

@@ -44,30 +44,6 @@ var _countColumnHeaders = /*#__PURE__*/new WeakMap();
 var _trimColumnsRange = /*#__PURE__*/new WeakSet();
 var _trimRowsRange = /*#__PURE__*/new WeakSet();
 export var CopyableRangesFactory = /*#__PURE__*/function () {
-  /**
-   * @type {CellRange}
-   */
-
-  /**
-   * @type {function(): number}
-   */
-
-  /**
-   * @type {function(): number}
-   */
-
-  /**
-   * @type {function(): number}
-   */
-
-  /**
-   * @type {function(): number}
-   */
-
-  /**
-   * @type {function(): number}
-   */
-
   /* eslint-disable jsdoc/require-description-complete-sentence */
   /**
    * @param {{
@@ -101,26 +77,44 @@ export var CopyableRangesFactory = /*#__PURE__*/function () {
      * @returns {number} Returns trimmed column index if it exceeds the limit.
      */
     _classPrivateMethodInitSpec(this, _trimColumnsRange);
+    /**
+     * @type {CellRange}
+     */
     _classPrivateFieldInitSpec(this, _selectedRange, {
       writable: true,
       value: void 0
     });
+    /**
+     * @type {function(): number}
+     */
     _classPrivateFieldInitSpec(this, _countRows, {
       writable: true,
       value: void 0
     });
+    /**
+     * @type {function(): number}
+     */
     _classPrivateFieldInitSpec(this, _countColumns, {
       writable: true,
       value: void 0
     });
+    /**
+     * @type {function(): number}
+     */
     _classPrivateFieldInitSpec(this, _rowsLimit, {
       writable: true,
       value: void 0
     });
+    /**
+     * @type {function(): number}
+     */
     _classPrivateFieldInitSpec(this, _columnsLimit, {
       writable: true,
       value: void 0
     });
+    /**
+     * @type {function(): number}
+     */
     _classPrivateFieldInitSpec(this, _countColumnHeaders, {
       writable: true,
       value: void 0

package/plugins/copyPaste/focusableElement.js

@@ -0,0 +1,219 @@
+"use strict";
+
+require("core-js/modules/es.symbol.iterator.js");
+exports.__esModule = true;
+exports.createElement = createElement;
+exports.deactivateElement = deactivateElement;
+exports.destroyElement = destroyElement;
+require("core-js/modules/es.array.iterator.js");
+require("core-js/modules/es.object.to-string.js");
+require("core-js/modules/es.string.iterator.js");
+require("core-js/modules/es.weak-set.js");
+require("core-js/modules/web.dom-collections.iterator.js");
+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.weak-map.js");
+var _eventManager = _interopRequireDefault(require("../../eventManager"));
+var _localHooks = _interopRequireDefault(require("../../mixins/localHooks"));
+var _object = require("../../helpers/object");
+var _browser = require("../../helpers/browser");
+var _element = require("../../helpers/dom/element");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _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 _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); }
+/**
+ * @private
+ * @class FocusableWrapper
+ */
+var FocusableWrapper = /*#__PURE__*/function () {
+  function FocusableWrapper(container) {
+    _classCallCheck(this, FocusableWrapper);
+    this.rootDocument = container.defaultView ? container : container.ownerDocument;
+    /**
+     * The main/operational focusable element.
+     *
+     * @type {HTMLElement}
+     */
+    this.mainElement = null;
+    /**
+     * Instance of EventManager.
+     *
+     * @type {EventManager}
+     */
+    this.eventManager = new _eventManager.default(this);
+    /**
+     * An object for tracking information about event listeners attached to the focusable element.
+     *
+     * @type {WeakSet}
+     */
+    this.listenersCount = new WeakSet();
+    /**
+     * Parent for an focusable element.
+     *
+     * @type {HTMLElement}
+     */
+    this.container = container;
+  }
+
+  /**
+   * Switch to the secondary focusable element. Used when no any main focusable element is provided.
+   */
+  _createClass(FocusableWrapper, [{
+    key: "useSecondaryElement",
+    value: function useSecondaryElement() {
+      var el = createOrGetSecondaryElement(this.container);
+      if (!this.listenersCount.has(el)) {
+        this.listenersCount.add(el);
+        forwardEventsToLocalHooks(this.eventManager, el, this);
+      }
+      this.mainElement = el;
+    }
+
+    /**
+     * Switch to the main focusable element.
+     *
+     * @param {HTMLElement} element The DOM element.
+     */
+  }, {
+    key: "setFocusableElement",
+    value: function setFocusableElement(element) {
+      if (!this.listenersCount.has(element)) {
+        this.listenersCount.add(element);
+        forwardEventsToLocalHooks(this.eventManager, element, this);
+      }
+      this.mainElement = element;
+    }
+
+    /**
+     * Get currently set focusable element.
+     *
+     * @returns {HTMLElement}
+     */
+  }, {
+    key: "getFocusableElement",
+    value: function getFocusableElement() {
+      return this.mainElement;
+    }
+
+    /**
+     * Set focus to the focusable element.
+     */
+  }, {
+    key: "focus",
+    value: function focus() {
+      // Add an empty space to texarea. It is necessary for safari to enable "copy" command from menu bar.
+      this.mainElement.value = ' ';
+      if (!(0, _browser.isMobileBrowser)()) {
+        (0, _element.selectElementIfAllowed)(this.mainElement);
+      }
+    }
+  }]);
+  return FocusableWrapper;
+}();
+(0, _object.mixin)(FocusableWrapper, _localHooks.default);
+var refCounter = new WeakMap();
+
+/**
+ * Create and return the FocusableWrapper instance.
+ *
+ * @param {HTMLElement} container The container element, holder for focusable elements.
+ * @returns {FocusableWrapper}
+ */
+function createElement(container) {
+  var focusableWrapper = new FocusableWrapper(container);
+  var counter = refCounter.get(container);
+  counter = isNaN(counter) ? 0 : counter;
+  refCounter.set(container, counter + 1);
+  return focusableWrapper;
+}
+
+/**
+ * Deactivate the FocusableWrapper instance.
+ *
+ * @param {FocusableWrapper} wrapper The instance of the FocusableWrapper class.
+ */
+function deactivateElement(wrapper) {
+  wrapper.eventManager.clear();
+}
+var runLocalHooks = function runLocalHooks(eventName, subject) {
+  return function (event) {
+    return subject.runLocalHooks(eventName, event);
+  };
+};
+
+/**
+ * Register copy/cut/paste events and forward their actions to the subject local hooks system.
+ *
+ * @param {EventManager} eventManager The instance of the EventManager class.
+ * @param {HTMLElement} element The element on which the listeners are mounted.
+ * @param {FocusableWrapper} subject The subject object for local hooks.
+ */
+function forwardEventsToLocalHooks(eventManager, element, subject) {
+  eventManager.addEventListener(element, 'copy', runLocalHooks('copy', subject));
+  eventManager.addEventListener(element, 'cut', runLocalHooks('cut', subject));
+  eventManager.addEventListener(element, 'paste', runLocalHooks('paste', subject));
+}
+var secondaryElements = new WeakMap();
+
+/**
+ * Create and attach newly created focusable element to the DOM.
+ *
+ * @param {HTMLElement} container The container element, holder for focusable elements.
+ * @returns {HTMLElement}
+ */
+function createOrGetSecondaryElement(container) {
+  var secondaryElement = secondaryElements.get(container);
+  if (secondaryElement) {
+    if (!secondaryElement.parentElement) {
+      container.appendChild(secondaryElement);
+    }
+    return secondaryElement;
+  }
+  var doc = container.defaultView ? container : container.ownerDocument;
+  var element = doc.createElement('textarea');
+  secondaryElements.set(container, element);
+  element.setAttribute('data-hot-input', ''); // Makes the element recognizable by Hot as its own component's element.
+  element.className = 'HandsontableCopyPaste';
+  element.tabIndex = -1;
+  element.autocomplete = 'off';
+  element.wrap = 'hard';
+  element.value = ' ';
+  container.appendChild(element);
+  return element;
+}
+
+/**
+ * Destroy the FocusableWrapper instance.
+ *
+ * @param {FocusableWrapper} wrapper The instance of the FocusableWrapper class.
+ */
+function destroyElement(wrapper) {
+  if (!(wrapper instanceof FocusableWrapper)) {
+    return;
+  }
+  var counter = refCounter.get(wrapper.container);
+  counter = isNaN(counter) ? 0 : counter;
+  if (counter > 0) {
+    counter -= 1;
+  }
+  deactivateElement(wrapper);
+  if (counter <= 0) {
+    counter = 0;
+
+    // Detach secondary element from the DOM.
+    var secondaryElement = secondaryElements.get(wrapper.container);
+    if (secondaryElement && secondaryElement.parentNode) {
+      secondaryElement.parentNode.removeChild(secondaryElement);
+      secondaryElements.delete(wrapper.container);
+    }
+    wrapper.mainElement = null;
+  }
+  refCounter.set(wrapper.container, counter);
+}

package/plugins/copyPaste/focusableElement.mjs

@@ -0,0 +1,213 @@
+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); }
+import "core-js/modules/es.array.iterator.js";
+import "core-js/modules/es.object.to-string.js";
+import "core-js/modules/es.string.iterator.js";
+import "core-js/modules/es.weak-set.js";
+import "core-js/modules/web.dom-collections.iterator.js";
+import "core-js/modules/es.weak-map.js";
+import "core-js/modules/es.symbol.to-primitive.js";
+import "core-js/modules/es.date.to-primitive.js";
+import "core-js/modules/es.symbol.js";
+import "core-js/modules/es.symbol.description.js";
+import "core-js/modules/es.number.constructor.js";
+import "core-js/modules/es.symbol.iterator.js";
+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, _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 _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); }
+import EventManager from "../../eventManager.mjs";
+import localHooks from "../../mixins/localHooks.mjs";
+import { mixin } from "../../helpers/object.mjs";
+import { isMobileBrowser } from "../../helpers/browser.mjs";
+import { selectElementIfAllowed } from "../../helpers/dom/element.mjs";
+/**
+ * @private
+ * @class FocusableWrapper
+ */
+var FocusableWrapper = /*#__PURE__*/function () {
+  function FocusableWrapper(container) {
+    _classCallCheck(this, FocusableWrapper);
+    this.rootDocument = container.defaultView ? container : container.ownerDocument;
+    /**
+     * The main/operational focusable element.
+     *
+     * @type {HTMLElement}
+     */
+    this.mainElement = null;
+    /**
+     * Instance of EventManager.
+     *
+     * @type {EventManager}
+     */
+    this.eventManager = new EventManager(this);
+    /**
+     * An object for tracking information about event listeners attached to the focusable element.
+     *
+     * @type {WeakSet}
+     */
+    this.listenersCount = new WeakSet();
+    /**
+     * Parent for an focusable element.
+     *
+     * @type {HTMLElement}
+     */
+    this.container = container;
+  }
+
+  /**
+   * Switch to the secondary focusable element. Used when no any main focusable element is provided.
+   */
+  _createClass(FocusableWrapper, [{
+    key: "useSecondaryElement",
+    value: function useSecondaryElement() {
+      var el = createOrGetSecondaryElement(this.container);
+      if (!this.listenersCount.has(el)) {
+        this.listenersCount.add(el);
+        forwardEventsToLocalHooks(this.eventManager, el, this);
+      }
+      this.mainElement = el;
+    }
+
+    /**
+     * Switch to the main focusable element.
+     *
+     * @param {HTMLElement} element The DOM element.
+     */
+  }, {
+    key: "setFocusableElement",
+    value: function setFocusableElement(element) {
+      if (!this.listenersCount.has(element)) {
+        this.listenersCount.add(element);
+        forwardEventsToLocalHooks(this.eventManager, element, this);
+      }
+      this.mainElement = element;
+    }
+
+    /**
+     * Get currently set focusable element.
+     *
+     * @returns {HTMLElement}
+     */
+  }, {
+    key: "getFocusableElement",
+    value: function getFocusableElement() {
+      return this.mainElement;
+    }
+
+    /**
+     * Set focus to the focusable element.
+     */
+  }, {
+    key: "focus",
+    value: function focus() {
+      // Add an empty space to texarea. It is necessary for safari to enable "copy" command from menu bar.
+      this.mainElement.value = ' ';
+      if (!isMobileBrowser()) {
+        selectElementIfAllowed(this.mainElement);
+      }
+    }
+  }]);
+  return FocusableWrapper;
+}();
+mixin(FocusableWrapper, localHooks);
+var refCounter = new WeakMap();
+
+/**
+ * Create and return the FocusableWrapper instance.
+ *
+ * @param {HTMLElement} container The container element, holder for focusable elements.
+ * @returns {FocusableWrapper}
+ */
+function createElement(container) {
+  var focusableWrapper = new FocusableWrapper(container);
+  var counter = refCounter.get(container);
+  counter = isNaN(counter) ? 0 : counter;
+  refCounter.set(container, counter + 1);
+  return focusableWrapper;
+}
+
+/**
+ * Deactivate the FocusableWrapper instance.
+ *
+ * @param {FocusableWrapper} wrapper The instance of the FocusableWrapper class.
+ */
+function deactivateElement(wrapper) {
+  wrapper.eventManager.clear();
+}
+var runLocalHooks = function runLocalHooks(eventName, subject) {
+  return function (event) {
+    return subject.runLocalHooks(eventName, event);
+  };
+};
+
+/**
+ * Register copy/cut/paste events and forward their actions to the subject local hooks system.
+ *
+ * @param {EventManager} eventManager The instance of the EventManager class.
+ * @param {HTMLElement} element The element on which the listeners are mounted.
+ * @param {FocusableWrapper} subject The subject object for local hooks.
+ */
+function forwardEventsToLocalHooks(eventManager, element, subject) {
+  eventManager.addEventListener(element, 'copy', runLocalHooks('copy', subject));
+  eventManager.addEventListener(element, 'cut', runLocalHooks('cut', subject));
+  eventManager.addEventListener(element, 'paste', runLocalHooks('paste', subject));
+}
+var secondaryElements = new WeakMap();
+
+/**
+ * Create and attach newly created focusable element to the DOM.
+ *
+ * @param {HTMLElement} container The container element, holder for focusable elements.
+ * @returns {HTMLElement}
+ */
+function createOrGetSecondaryElement(container) {
+  var secondaryElement = secondaryElements.get(container);
+  if (secondaryElement) {
+    if (!secondaryElement.parentElement) {
+      container.appendChild(secondaryElement);
+    }
+    return secondaryElement;
+  }
+  var doc = container.defaultView ? container : container.ownerDocument;
+  var element = doc.createElement('textarea');
+  secondaryElements.set(container, element);
+  element.setAttribute('data-hot-input', ''); // Makes the element recognizable by Hot as its own component's element.
+  element.className = 'HandsontableCopyPaste';
+  element.tabIndex = -1;
+  element.autocomplete = 'off';
+  element.wrap = 'hard';
+  element.value = ' ';
+  container.appendChild(element);
+  return element;
+}
+
+/**
+ * Destroy the FocusableWrapper instance.
+ *
+ * @param {FocusableWrapper} wrapper The instance of the FocusableWrapper class.
+ */
+function destroyElement(wrapper) {
+  if (!(wrapper instanceof FocusableWrapper)) {
+    return;
+  }
+  var counter = refCounter.get(wrapper.container);
+  counter = isNaN(counter) ? 0 : counter;
+  if (counter > 0) {
+    counter -= 1;
+  }
+  deactivateElement(wrapper);
+  if (counter <= 0) {
+    counter = 0;
+
+    // Detach secondary element from the DOM.
+    var secondaryElement = secondaryElements.get(wrapper.container);
+    if (secondaryElement && secondaryElement.parentNode) {
+      secondaryElement.parentNode.removeChild(secondaryElement);
+      secondaryElements.delete(wrapper.container);
+    }
+    wrapper.mainElement = null;
+  }
+  refCounter.set(wrapper.container, counter);
+}
+export { createElement, deactivateElement, destroyElement };

package/plugins/customBorders/customBorders.d.ts

@@ -14,6 +14,8 @@ export interface BorderRange {
   };
 }
 export type DetailedSettings = (SimpleCellCoords | BorderRange) & {
+  start?: BorderOptions | string;
+  end?: BorderOptions | string;
   left?: BorderOptions | string;
   right?: BorderOptions | string;
   top?: BorderOptions | string;