handsontable 12.3.3 → 12.4.0-next-ddbea0c-20230512

package/tableView.js

@@ -58,98 +58,88 @@ var privatePool = new WeakMap();
 var _columnHeadersCount = /*#__PURE__*/new WeakMap();
 var _rowHeadersCount = /*#__PURE__*/new WeakMap();
 var TableView = /*#__PURE__*/function () {
-  /**
-   * Instance of {@link Handsontable}.
-   *
-   * @private
-   * @type {Handsontable}
-   */
-
-  /**
-   * Instance of {@link EventManager}.
-   *
-   * @private
-   * @type {EventManager}
-   */
-
-  /**
-   * Current Handsontable's GridSettings object.
-   *
-   * @private
-   * @type {GridSettings}
-   */
-
-  /**
-   * Main <THEAD> element.
-   *
-   * @private
-   * @type {HTMLTableSectionElement}
-   */
-
-  /**
-   * Main <TBODY> element.
-   *
-   * @private
-   * @type {HTMLTableSectionElement}
-   */
-
-  /**
-   * Main Walkontable instance.
-   *
-   * @private
-   * @type {Walkontable}
-   */
-
-  /**
-   * Main Walkontable instance.
-   *
-   * @private
-   * @type {Walkontable}
-   */
-
-  /**
-   * The total number of the column header renderers applied to the table through the
-   * `afterGetColumnHeaderRenderers` hook.
-   *
-   * @type {number}
-   */
-
-  /**
-   * The total number of the row header renderers applied to the table through the
-   * `afterGetRowHeaderRenderers` hook.
-   *
-   * @type {number}
-   */
-
-  /**
-   * The flag determines if the `adjustElementsSize` method call was made during
-   * the render suspending. If true, the method has to be triggered once after render
-   * resuming.
-   *
-   * @private
-   * @type {boolean}
-   */
-
   /**
    * @param {Hanstontable} instance Instance of {@link Handsontable}.
    */
   function TableView(instance) {
     _classCallCheck(this, TableView);
+    /**
+     * Instance of {@link Handsontable}.
+     *
+     * @private
+     * @type {Handsontable}
+     */
     _defineProperty(this, "instance", void 0);
+    /**
+     * Instance of {@link EventManager}.
+     *
+     * @private
+     * @type {EventManager}
+     */
     _defineProperty(this, "eventManager", void 0);
+    /**
+     * Current Handsontable's GridSettings object.
+     *
+     * @private
+     * @type {GridSettings}
+     */
     _defineProperty(this, "settings", void 0);
+    /**
+     * Main <THEAD> element.
+     *
+     * @private
+     * @type {HTMLTableSectionElement}
+     */
     _defineProperty(this, "THEAD", void 0);
+    /**
+     * Main <TBODY> element.
+     *
+     * @private
+     * @type {HTMLTableSectionElement}
+     */
     _defineProperty(this, "TBODY", void 0);
+    /**
+     * Main Walkontable instance.
+     *
+     * @private
+     * @type {Walkontable}
+     */
     _defineProperty(this, "_wt", void 0);
+    /**
+     * Main Walkontable instance.
+     *
+     * @private
+     * @type {Walkontable}
+     */
     _defineProperty(this, "activeWt", void 0);
+    /**
+     * The total number of the column header renderers applied to the table through the
+     * `afterGetColumnHeaderRenderers` hook.
+     *
+     * @type {number}
+     */
     _classPrivateFieldInitSpec(this, _columnHeadersCount, {
       writable: true,
       value: 0
     });
+    /**
+     * The total number of the row header renderers applied to the table through the
+     * `afterGetRowHeaderRenderers` hook.
+     *
+     * @type {number}
+     */
     _classPrivateFieldInitSpec(this, _rowHeadersCount, {
       writable: true,
       value: 0
     });
+    /**
+     * The flag determines if the `adjustElementsSize` method call was made during
+     * the render suspending. If true, the method has to be triggered once after render
+     * resuming.
+     *
+     * @private
+     * @type {boolean}
+     */
     _defineProperty(this, "postponedAdjustElementsSize", false);
     this.instance = instance;
     this.eventManager = new _eventManager.default(this.instance);

package/tableView.mjs

@@ -53,98 +53,88 @@ var privatePool = new WeakMap();
 var _columnHeadersCount = /*#__PURE__*/new WeakMap();
 var _rowHeadersCount = /*#__PURE__*/new WeakMap();
 var TableView = /*#__PURE__*/function () {
-  /**
-   * Instance of {@link Handsontable}.
-   *
-   * @private
-   * @type {Handsontable}
-   */
-
-  /**
-   * Instance of {@link EventManager}.
-   *
-   * @private
-   * @type {EventManager}
-   */
-
-  /**
-   * Current Handsontable's GridSettings object.
-   *
-   * @private
-   * @type {GridSettings}
-   */
-
-  /**
-   * Main <THEAD> element.
-   *
-   * @private
-   * @type {HTMLTableSectionElement}
-   */
-
-  /**
-   * Main <TBODY> element.
-   *
-   * @private
-   * @type {HTMLTableSectionElement}
-   */
-
-  /**
-   * Main Walkontable instance.
-   *
-   * @private
-   * @type {Walkontable}
-   */
-
-  /**
-   * Main Walkontable instance.
-   *
-   * @private
-   * @type {Walkontable}
-   */
-
-  /**
-   * The total number of the column header renderers applied to the table through the
-   * `afterGetColumnHeaderRenderers` hook.
-   *
-   * @type {number}
-   */
-
-  /**
-   * The total number of the row header renderers applied to the table through the
-   * `afterGetRowHeaderRenderers` hook.
-   *
-   * @type {number}
-   */
-
-  /**
-   * The flag determines if the `adjustElementsSize` method call was made during
-   * the render suspending. If true, the method has to be triggered once after render
-   * resuming.
-   *
-   * @private
-   * @type {boolean}
-   */
-
   /**
    * @param {Hanstontable} instance Instance of {@link Handsontable}.
    */
   function TableView(instance) {
     _classCallCheck(this, TableView);
+    /**
+     * Instance of {@link Handsontable}.
+     *
+     * @private
+     * @type {Handsontable}
+     */
     _defineProperty(this, "instance", void 0);
+    /**
+     * Instance of {@link EventManager}.
+     *
+     * @private
+     * @type {EventManager}
+     */
     _defineProperty(this, "eventManager", void 0);
+    /**
+     * Current Handsontable's GridSettings object.
+     *
+     * @private
+     * @type {GridSettings}
+     */
     _defineProperty(this, "settings", void 0);
+    /**
+     * Main <THEAD> element.
+     *
+     * @private
+     * @type {HTMLTableSectionElement}
+     */
     _defineProperty(this, "THEAD", void 0);
+    /**
+     * Main <TBODY> element.
+     *
+     * @private
+     * @type {HTMLTableSectionElement}
+     */
     _defineProperty(this, "TBODY", void 0);
+    /**
+     * Main Walkontable instance.
+     *
+     * @private
+     * @type {Walkontable}
+     */
     _defineProperty(this, "_wt", void 0);
+    /**
+     * Main Walkontable instance.
+     *
+     * @private
+     * @type {Walkontable}
+     */
     _defineProperty(this, "activeWt", void 0);
+    /**
+     * The total number of the column header renderers applied to the table through the
+     * `afterGetColumnHeaderRenderers` hook.
+     *
+     * @type {number}
+     */
     _classPrivateFieldInitSpec(this, _columnHeadersCount, {
       writable: true,
       value: 0
     });
+    /**
+     * The total number of the row header renderers applied to the table through the
+     * `afterGetRowHeaderRenderers` hook.
+     *
+     * @type {number}
+     */
     _classPrivateFieldInitSpec(this, _rowHeadersCount, {
       writable: true,
       value: 0
     });
+    /**
+     * The flag determines if the `adjustElementsSize` method call was made during
+     * the render suspending. If true, the method has to be triggered once after render
+     * resuming.
+     *
+     * @private
+     * @type {boolean}
+     */
     _defineProperty(this, "postponedAdjustElementsSize", false);
     this.instance = instance;
     this.eventManager = new EventManager(this.instance);

package/translations/changesObservable/observable.js

@@ -31,11 +31,6 @@ 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; } }
-var _observers = /*#__PURE__*/new WeakMap();
-var _indexMatrix = /*#__PURE__*/new WeakMap();
-var _currentIndexState = /*#__PURE__*/new WeakMap();
-var _isMatrixIndexesInitialized = /*#__PURE__*/new WeakMap();
-var _initialIndexValue = /*#__PURE__*/new WeakMap();
 /**
  * The ChangesObservable module is an object that represents a resource that provides
  * the ability to observe the changes that happened in the index map indexes during
@@ -44,68 +39,68 @@ var _initialIndexValue = /*#__PURE__*/new WeakMap();
  * @private
  * @class ChangesObservable
  */
+var _observers = /*#__PURE__*/new WeakMap();
+var _indexMatrix = /*#__PURE__*/new WeakMap();
+var _currentIndexState = /*#__PURE__*/new WeakMap();
+var _isMatrixIndexesInitialized = /*#__PURE__*/new WeakMap();
+var _initialIndexValue = /*#__PURE__*/new WeakMap();
 var ChangesObservable = /*#__PURE__*/function () {
-  /**
-   * The list of registered ChangesObserver instances.
-   *
-   * @type {ChangesObserver[]}
-   */
-
-  /**
-   * An array with default values that act as a base array that will be compared with
-   * the last saved index state. The changes are generated and immediately send through
-   * the newly created ChangesObserver object. Thanks to that, the observer initially has
-   * all information about what indexes are currently changed.
-   *
-   * @type {Array}
-   */
-
-  /**
-   * An array that holds the indexes state that is currently valid. The value is changed on every
-   * index mapper cache update.
-   *
-   * @type {Array}
-   */
-
-  /**
-   * The flag determines if the observable is initialized or not. Not initialized object creates
-   * index matrix once while emitting new changes.
-   *
-   * @type {boolean}
-   */
-
-  /**
-   * The initial index value allows control from what value the index matrix array will be created.
-   * Changing that value changes how the array diff generates the changes for the initial data
-   * sent to the subscribers. For example, the changes can be triggered by detecting the changes
-   * from `false` to `true` value or vice versa. Generally, it depends on which index map type
-   * the Observable will work with. For "hiding" or "trimming" index types, it will be boolean
-   * values. For various index maps, it can be anything, but I suspect that the most appropriate
-   * initial value will be "undefined" in that case.
-   *
-   * @type {boolean}
-   */
-
   function ChangesObservable() {
     var _ref = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {},
       initialIndexValue = _ref.initialIndexValue;
     _classCallCheck(this, ChangesObservable);
+    /**
+     * The list of registered ChangesObserver instances.
+     *
+     * @type {ChangesObserver[]}
+     */
     _classPrivateFieldInitSpec(this, _observers, {
       writable: true,
       value: new Set()
     });
+    /**
+     * An array with default values that act as a base array that will be compared with
+     * the last saved index state. The changes are generated and immediately send through
+     * the newly created ChangesObserver object. Thanks to that, the observer initially has
+     * all information about what indexes are currently changed.
+     *
+     * @type {Array}
+     */
     _classPrivateFieldInitSpec(this, _indexMatrix, {
       writable: true,
       value: []
     });
+    /**
+     * An array that holds the indexes state that is currently valid. The value is changed on every
+     * index mapper cache update.
+     *
+     * @type {Array}
+     */
     _classPrivateFieldInitSpec(this, _currentIndexState, {
       writable: true,
       value: []
     });
+    /**
+     * The flag determines if the observable is initialized or not. Not initialized object creates
+     * index matrix once while emitting new changes.
+     *
+     * @type {boolean}
+     */
     _classPrivateFieldInitSpec(this, _isMatrixIndexesInitialized, {
       writable: true,
       value: false
     });
+    /**
+     * The initial index value allows control from what value the index matrix array will be created.
+     * Changing that value changes how the array diff generates the changes for the initial data
+     * sent to the subscribers. For example, the changes can be triggered by detecting the changes
+     * from `false` to `true` value or vice versa. Generally, it depends on which index map type
+     * the Observable will work with. For "hiding" or "trimming" index types, it will be boolean
+     * values. For various index maps, it can be anything, but I suspect that the most appropriate
+     * initial value will be "undefined" in that case.
+     *
+     * @type {boolean}
+     */
     _classPrivateFieldInitSpec(this, _initialIndexValue, {
       writable: true,
       value: false

package/translations/changesObservable/observable.mjs

@@ -41,67 +41,62 @@ var _currentIndexState = /*#__PURE__*/new WeakMap();
 var _isMatrixIndexesInitialized = /*#__PURE__*/new WeakMap();
 var _initialIndexValue = /*#__PURE__*/new WeakMap();
 export var ChangesObservable = /*#__PURE__*/function () {
-  /**
-   * The list of registered ChangesObserver instances.
-   *
-   * @type {ChangesObserver[]}
-   */
-
-  /**
-   * An array with default values that act as a base array that will be compared with
-   * the last saved index state. The changes are generated and immediately send through
-   * the newly created ChangesObserver object. Thanks to that, the observer initially has
-   * all information about what indexes are currently changed.
-   *
-   * @type {Array}
-   */
-
-  /**
-   * An array that holds the indexes state that is currently valid. The value is changed on every
-   * index mapper cache update.
-   *
-   * @type {Array}
-   */
-
-  /**
-   * The flag determines if the observable is initialized or not. Not initialized object creates
-   * index matrix once while emitting new changes.
-   *
-   * @type {boolean}
-   */
-
-  /**
-   * The initial index value allows control from what value the index matrix array will be created.
-   * Changing that value changes how the array diff generates the changes for the initial data
-   * sent to the subscribers. For example, the changes can be triggered by detecting the changes
-   * from `false` to `true` value or vice versa. Generally, it depends on which index map type
-   * the Observable will work with. For "hiding" or "trimming" index types, it will be boolean
-   * values. For various index maps, it can be anything, but I suspect that the most appropriate
-   * initial value will be "undefined" in that case.
-   *
-   * @type {boolean}
-   */
-
   function ChangesObservable() {
     var _ref = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {},
       initialIndexValue = _ref.initialIndexValue;
     _classCallCheck(this, ChangesObservable);
+    /**
+     * The list of registered ChangesObserver instances.
+     *
+     * @type {ChangesObserver[]}
+     */
     _classPrivateFieldInitSpec(this, _observers, {
       writable: true,
       value: new Set()
     });
+    /**
+     * An array with default values that act as a base array that will be compared with
+     * the last saved index state. The changes are generated and immediately send through
+     * the newly created ChangesObserver object. Thanks to that, the observer initially has
+     * all information about what indexes are currently changed.
+     *
+     * @type {Array}
+     */
     _classPrivateFieldInitSpec(this, _indexMatrix, {
       writable: true,
       value: []
     });
+    /**
+     * An array that holds the indexes state that is currently valid. The value is changed on every
+     * index mapper cache update.
+     *
+     * @type {Array}
+     */
     _classPrivateFieldInitSpec(this, _currentIndexState, {
       writable: true,
       value: []
     });
+    /**
+     * The flag determines if the observable is initialized or not. Not initialized object creates
+     * index matrix once while emitting new changes.
+     *
+     * @type {boolean}
+     */
     _classPrivateFieldInitSpec(this, _isMatrixIndexesInitialized, {
       writable: true,
       value: false
     });
+    /**
+     * The initial index value allows control from what value the index matrix array will be created.
+     * Changing that value changes how the array diff generates the changes for the initial data
+     * sent to the subscribers. For example, the changes can be triggered by detecting the changes
+     * from `false` to `true` value or vice versa. Generally, it depends on which index map type
+     * the Observable will work with. For "hiding" or "trimming" index types, it will be boolean
+     * values. For various index maps, it can be anything, but I suspect that the most appropriate
+     * initial value will be "undefined" in that case.
+     *
+     * @type {boolean}
+     */
     _classPrivateFieldInitSpec(this, _initialIndexValue, {
       writable: true,
       value: false

package/translations/changesObservable/observer.js

@@ -29,16 +29,23 @@ function _classApplyDescriptorSet(receiver, descriptor, value) { if (descriptor.
 function _classPrivateFieldGet(receiver, privateMap) { var descriptor = _classExtractFieldDescriptor(receiver, privateMap, "get"); return _classApplyDescriptorGet(receiver, descriptor); }
 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 _classApplyDescriptorGet(receiver, descriptor) { if (descriptor.get) { return descriptor.get.call(receiver); } return descriptor.value; }
-var _currentInitialChanges = /*#__PURE__*/new WeakMap();
 /**
  * The ChangesObserver module is an object that represents a disposable resource
  * provided by the ChangesObservable module.
  *
  * @class ChangesObserver
  */
+var _currentInitialChanges = /*#__PURE__*/new WeakMap();
 var ChangesObserver = /*#__PURE__*/function () {
   function ChangesObserver() {
     _classCallCheck(this, ChangesObserver);
+    /**
+     * The field holds initial changes that will be used to notify the callbacks added using
+     * subscribe method. Regardless of the moment of listening for changes, the subscriber
+     * will be notified once with all changes made before subscribing.
+     *
+     * @type {Array}
+     */
     _classPrivateFieldInitSpec(this, _currentInitialChanges, {
       writable: true,
       value: []

package/translations/changesObservable/observer.mjs

@@ -34,6 +34,13 @@ var _currentInitialChanges = /*#__PURE__*/new WeakMap();
 export var ChangesObserver = /*#__PURE__*/function () {
   function ChangesObserver() {
     _classCallCheck(this, ChangesObserver);
+    /**
+     * The field holds initial changes that will be used to notify the callbacks added using
+     * subscribe method. Regardless of the moment of listening for changes, the subscriber
+     * will be notified once with all changes made before subscribing.
+     *
+     * @type {Array}
+     */
     _classPrivateFieldInitSpec(this, _currentInitialChanges, {
       writable: true,
       value: []

package/translations/indexMapper.js

@@ -160,6 +160,12 @@ var IndexMapper = /*#__PURE__*/function () {
      * @type {boolean}
      */
     this.indexesSequenceChanged = false;
+    /**
+     * Flag informing about source of the change.
+     *
+     * @type {undefined|string}
+     */
+    this.indexesChangeSource = void 0;
     /**
      * Flag determining whether any action on trimmed indexes has been performed. It's used for cache management.
      *
@@ -200,6 +206,7 @@ var IndexMapper = /*#__PURE__*/function () {
 
       // Sequence of stored indexes might change.
       _this.updateCache();
+      _this.runLocalHooks('indexesSequenceChange', _this.indexesChangeSource);
       _this.runLocalHooks('change', _this.indexesSequence, null);
     });
     this.trimmingMapsCollection.addLocalHook('change', function (changedMap) {
@@ -520,7 +527,9 @@ var IndexMapper = /*#__PURE__*/function () {
       this.notTrimmedIndexesCache = _toConsumableArray(new Array(length).keys());
       this.notHiddenIndexesCache = _toConsumableArray(new Array(length).keys());
       this.suspendOperations();
+      this.indexesChangeSource = 'init';
       this.indexesSequence.init(length);
+      this.indexesChangeSource = void 0;
       this.trimmingMapsCollection.initEvery(length);
       this.resumeOperations();
 
@@ -572,7 +581,13 @@ var IndexMapper = /*#__PURE__*/function () {
   }, {
     key: "setIndexesSequence",
     value: function setIndexesSequence(indexes) {
+      if (this.indexesChangeSource === void 0) {
+        this.indexesChangeSource = 'update';
+      }
       this.indexesSequence.setValues(indexes);
+      if (this.indexesChangeSource === 'update') {
+        this.indexesChangeSource = void 0;
+      }
     }
 
     /**
@@ -722,9 +737,11 @@ var IndexMapper = /*#__PURE__*/function () {
         })[finalIndex];
         destinationPosition = listWithRemovedItems.indexOf(physicalIndex);
       }
+      this.indexesChangeSource = 'move';
 
       // Adding indexes without re-indexing.
       this.setIndexesSequence((0, _maps.getListWithInsertedItems)(listWithRemovedItems, destinationPosition, physicalMovedIndexes));
+      this.indexesChangeSource = void 0;
     }
 
     /**
@@ -768,7 +785,9 @@ var IndexMapper = /*#__PURE__*/function () {
         return nextIndex + stepsFromStart;
       });
       this.suspendOperations();
+      this.indexesChangeSource = 'insert';
       this.indexesSequence.insert(insertionIndex, insertedIndexes);
+      this.indexesChangeSource = void 0;
       this.trimmingMapsCollection.insertToEvery(insertionIndex, insertedIndexes);
       this.hidingMapsCollection.insertToEvery(insertionIndex, insertedIndexes);
       this.variousMapsCollection.insertToEvery(insertionIndex, insertedIndexes);
@@ -785,7 +804,9 @@ var IndexMapper = /*#__PURE__*/function () {
     key: "removeIndexes",
     value: function removeIndexes(removedIndexes) {
       this.suspendOperations();
+      this.indexesChangeSource = 'remove';
       this.indexesSequence.remove(removedIndexes);
+      this.indexesChangeSource = void 0;
       this.trimmingMapsCollection.removeFromEvery(removedIndexes);
       this.hidingMapsCollection.removeFromEvery(removedIndexes);
       this.variousMapsCollection.removeFromEvery(removedIndexes);