handsontable 12.3.3-next-e19badf-20230328 → 12.4.0-next-ddbea0c-20230512

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

@@ -33,70 +33,6 @@ import { InlineStartOverlay, TopOverlay, TopInlineStartCornerOverlay, BottomOver
  * @class Overlays
  */
 var Overlays = /*#__PURE__*/function () {
-  /**
-   * Walkontable instance's reference.
-   *
-   * @protected
-   * @type {Walkontable}
-   */
-
-  /**
-   * Refer to the TopOverlay instance.
-   *
-   * @protected
-   * @type {TopOverlay}
-   */
-
-  /**
-   * Refer to the BottomOverlay instance.
-   *
-   * @protected
-   * @type {BottomOverlay}
-   */
-
-  /**
-   * Refer to the InlineStartOverlay or instance.
-   *
-   * @protected
-   * @type {InlineStartOverlay}
-   */
-
-  /**
-   * Refer to the TopInlineStartCornerOverlay instance.
-   *
-   * @protected
-   * @type {TopInlineStartCornerOverlay}
-   */
-
-  /**
-   * Refer to the BottomInlineStartCornerOverlay instance.
-   *
-   * @protected
-   * @type {BottomInlineStartCornerOverlay}
-   */
-
-  /**
-   * Browser line height for purposes of translating mouse wheel.
-   *
-   * @private
-   * @type {number}
-   */
-
-  /**
-   * The walkontable settings.
-   *
-   * @protected
-   * @type {Settings}
-   */
-
-  /**
-   * The instance of the ResizeObserver that observes the size of the Walkontable wrapper element.
-   * In case of the size change detection the `onContainerElementResize` is fired.
-   *
-   * @private
-   * @type {ResizeObserver}
-   */
-
   /**
    * @param {Walkontable} wotInstance The Walkontable instance. @todo refactoring remove.
    * @param {FacadeGetter} facadeGetter Function which return proper facade.
@@ -108,14 +44,69 @@ var Overlays = /*#__PURE__*/function () {
   function Overlays(wotInstance, facadeGetter, domBindings, wtSettings, eventManager, wtTable) {
     var _this = this;
     _classCallCheck(this, Overlays);
+    /**
+     * Walkontable instance's reference.
+     *
+     * @protected
+     * @type {Walkontable}
+     */
     _defineProperty(this, "wot", null);
+    /**
+     * Refer to the TopOverlay instance.
+     *
+     * @protected
+     * @type {TopOverlay}
+     */
     _defineProperty(this, "topOverlay", null);
+    /**
+     * Refer to the BottomOverlay instance.
+     *
+     * @protected
+     * @type {BottomOverlay}
+     */
     _defineProperty(this, "bottomOverlay", null);
+    /**
+     * Refer to the InlineStartOverlay or instance.
+     *
+     * @protected
+     * @type {InlineStartOverlay}
+     */
     _defineProperty(this, "inlineStartOverlay", null);
+    /**
+     * Refer to the TopInlineStartCornerOverlay instance.
+     *
+     * @protected
+     * @type {TopInlineStartCornerOverlay}
+     */
     _defineProperty(this, "topInlineStartCornerOverlay", null);
+    /**
+     * Refer to the BottomInlineStartCornerOverlay instance.
+     *
+     * @protected
+     * @type {BottomInlineStartCornerOverlay}
+     */
     _defineProperty(this, "bottomInlineStartCornerOverlay", null);
+    /**
+     * Browser line height for purposes of translating mouse wheel.
+     *
+     * @private
+     * @type {number}
+     */
     _defineProperty(this, "browserLineHeight", undefined);
+    /**
+     * The walkontable settings.
+     *
+     * @protected
+     * @type {Settings}
+     */
     _defineProperty(this, "wtSettings", null);
+    /**
+     * The instance of the ResizeObserver that observes the size of the Walkontable wrapper element.
+     * In case of the size change detection the `onContainerElementResize` is fired.
+     *
+     * @private
+     * @type {ResizeObserver}
+     */
     _defineProperty(this, "resizeObserver", new ResizeObserver(function (entries) {
       requestAnimationFrame(function () {
         if (!Array.isArray(entries) || !entries.length) {

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

@@ -25,36 +25,33 @@ function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input ==
  * @class Scroll
  */
 var Scroll = /*#__PURE__*/function () {
-  /**
-   * The data access object.
-   *
-   * @protected
-   * @type {ScrollDao}
-   */
-
-  /**
-   * Holds the last column reached by the scroll, which determines the scroll snapping direction
-   * (left or right) for a next horizontal scroll.
-   *
-   * @protected
-   * @type {number}
-   */
-
-  /**
-   * Holds the last row reached by the scroll, which determines the scroll snapping direction
-   * (top or bottom) for a next vertical scroll.
-   *
-   * @protected
-   * @type {number}
-   */
-
   /**
    * @param {ScrollDao} dataAccessObject Tha data access object.
    */
   function Scroll(dataAccessObject) {
     _classCallCheck(this, Scroll);
+    /**
+     * The data access object.
+     *
+     * @protected
+     * @type {ScrollDao}
+     */
     _defineProperty(this, "dataAccessObject", void 0);
+    /**
+     * Holds the last column reached by the scroll, which determines the scroll snapping direction
+     * (left or right) for a next horizontal scroll.
+     *
+     * @protected
+     * @type {number}
+     */
     _defineProperty(this, "lastScrolledColumnPos", -1);
+    /**
+     * Holds the last row reached by the scroll, which determines the scroll snapping direction
+     * (top or bottom) for a next vertical scroll.
+     *
+     * @protected
+     * @type {number}
+     */
     _defineProperty(this, "lastScrolledRowPos", -1);
     this.dataAccessObject = dataAccessObject;
   }

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

@@ -21,36 +21,33 @@ import { innerHeight, innerWidth, getScrollLeft, getScrollTop, offset } from "..
  * @class Scroll
  */
 var Scroll = /*#__PURE__*/function () {
-  /**
-   * The data access object.
-   *
-   * @protected
-   * @type {ScrollDao}
-   */
-
-  /**
-   * Holds the last column reached by the scroll, which determines the scroll snapping direction
-   * (left or right) for a next horizontal scroll.
-   *
-   * @protected
-   * @type {number}
-   */
-
-  /**
-   * Holds the last row reached by the scroll, which determines the scroll snapping direction
-   * (top or bottom) for a next vertical scroll.
-   *
-   * @protected
-   * @type {number}
-   */
-
   /**
    * @param {ScrollDao} dataAccessObject Tha data access object.
    */
   function Scroll(dataAccessObject) {
     _classCallCheck(this, Scroll);
+    /**
+     * The data access object.
+     *
+     * @protected
+     * @type {ScrollDao}
+     */
     _defineProperty(this, "dataAccessObject", void 0);
+    /**
+     * Holds the last column reached by the scroll, which determines the scroll snapping direction
+     * (left or right) for a next horizontal scroll.
+     *
+     * @protected
+     * @type {number}
+     */
     _defineProperty(this, "lastScrolledColumnPos", -1);
+    /**
+     * Holds the last row reached by the scroll, which determines the scroll snapping direction
+     * (top or bottom) for a next vertical scroll.
+     *
+     * @protected
+     * @type {number}
+     */
     _defineProperty(this, "lastScrolledRowPos", -1);
     this.dataAccessObject = dataAccessObject;
   }

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

@@ -95,28 +95,26 @@ function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input ==
  * @class Settings
  */
 var Settings = /*#__PURE__*/function () {
-  /**
-   * Reference to settings.
-   *
-   * @protected
-   * @type {SettingsPure}
-   */
-
-  /**
-   * The defaults values of settings.
-   * Void 0 means it is required, null means it can be empty.
-   *
-   * @public
-   * @type {Readonly<SettingsPure>}
-   */
-
   /**
    * @param {SettingsPure} settings The user defined settings.
    */
   function Settings(settings) {
     var _this = this;
     _classCallCheck(this, Settings);
+    /**
+     * Reference to settings.
+     *
+     * @protected
+     * @type {SettingsPure}
+     */
     _defineProperty(this, "settings", {});
+    /**
+     * The defaults values of settings.
+     * Void 0 means it is required, null means it can be empty.
+     *
+     * @public
+     * @type {Readonly<SettingsPure>}
+     */
     _defineProperty(this, "defaults", Object.freeze(this.getDefaults()));
     (0, _object.objectEach)(this.defaults, function (value, key) {
       if (settings[key] !== void 0) {

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

@@ -91,28 +91,26 @@ import { objectEach } from "../../../helpers/object.mjs";
  * @class Settings
  */
 var Settings = /*#__PURE__*/function () {
-  /**
-   * Reference to settings.
-   *
-   * @protected
-   * @type {SettingsPure}
-   */
-
-  /**
-   * The defaults values of settings.
-   * Void 0 means it is required, null means it can be empty.
-   *
-   * @public
-   * @type {Readonly<SettingsPure>}
-   */
-
   /**
    * @param {SettingsPure} settings The user defined settings.
    */
   function Settings(settings) {
     var _this = this;
     _classCallCheck(this, Settings);
+    /**
+     * Reference to settings.
+     *
+     * @protected
+     * @type {SettingsPure}
+     */
     _defineProperty(this, "settings", {});
+    /**
+     * The defaults values of settings.
+     * Void 0 means it is required, null means it can be empty.
+     *
+     * @public
+     * @type {Readonly<SettingsPure>}
+     */
     _defineProperty(this, "defaults", Object.freeze(this.getDefaults()));
     objectEach(this.defaults, function (value, key) {
       if (settings[key] !== void 0) {

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

@@ -56,32 +56,6 @@ function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input ==
  * @abstract
  */
 var Table = /*#__PURE__*/function () {
-  /**
-   * The walkontable settings.
-   *
-   * @protected
-   * @type {Settings}
-   */
-
-  /**
-   * Indicates if the table has height bigger than 0px.
-   *
-   * @type {boolean}
-   */
-
-  /**
-   * Indicates if the table has width bigger than 0px.
-   *
-   * @type {boolean}
-   */
-
-  /**
-   * Indicates if the table is visible. By visible, it means that the holder
-   * element has CSS 'display' property different than 'none'.
-   *
-   * @type {boolean}
-   */
-
   /**
    *
    * @abstract
@@ -94,13 +68,35 @@ var Table = /*#__PURE__*/function () {
   function Table(dataAccessObject, facadeGetter, domBindings, wtSettings, name) {
     var _this = this;
     _classCallCheck(this, Table);
+    /**
+     * The walkontable settings.
+     *
+     * @protected
+     * @type {Settings}
+     */
     _defineProperty(this, "wtSettings", null);
     _defineProperty(this, "domBindings", void 0);
     _defineProperty(this, "TBODY", null);
     _defineProperty(this, "THEAD", null);
     _defineProperty(this, "COLGROUP", null);
+    /**
+     * Indicates if the table has height bigger than 0px.
+     *
+     * @type {boolean}
+     */
     _defineProperty(this, "hasTableHeight", true);
+    /**
+     * Indicates if the table has width bigger than 0px.
+     *
+     * @type {boolean}
+     */
     _defineProperty(this, "hasTableWidth", true);
+    /**
+     * Indicates if the table is visible. By visible, it means that the holder
+     * element has CSS 'display' property different than 'none'.
+     *
+     * @type {boolean}
+     */
     _defineProperty(this, "isTableVisible", false);
     _defineProperty(this, "tableOffset", 0);
     _defineProperty(this, "holderOffset", 0);

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

@@ -51,32 +51,6 @@ import { CLONE_TOP, CLONE_BOTTOM, CLONE_INLINE_START, CLONE_TOP_INLINE_START_COR
  * @abstract
  */
 var Table = /*#__PURE__*/function () {
-  /**
-   * The walkontable settings.
-   *
-   * @protected
-   * @type {Settings}
-   */
-
-  /**
-   * Indicates if the table has height bigger than 0px.
-   *
-   * @type {boolean}
-   */
-
-  /**
-   * Indicates if the table has width bigger than 0px.
-   *
-   * @type {boolean}
-   */
-
-  /**
-   * Indicates if the table is visible. By visible, it means that the holder
-   * element has CSS 'display' property different than 'none'.
-   *
-   * @type {boolean}
-   */
-
   /**
    *
    * @abstract
@@ -89,13 +63,35 @@ var Table = /*#__PURE__*/function () {
   function Table(dataAccessObject, facadeGetter, domBindings, wtSettings, name) {
     var _this = this;
     _classCallCheck(this, Table);
+    /**
+     * The walkontable settings.
+     *
+     * @protected
+     * @type {Settings}
+     */
     _defineProperty(this, "wtSettings", null);
     _defineProperty(this, "domBindings", void 0);
     _defineProperty(this, "TBODY", null);
     _defineProperty(this, "THEAD", null);
     _defineProperty(this, "COLGROUP", null);
+    /**
+     * Indicates if the table has height bigger than 0px.
+     *
+     * @type {boolean}
+     */
     _defineProperty(this, "hasTableHeight", true);
+    /**
+     * Indicates if the table has width bigger than 0px.
+     *
+     * @type {boolean}
+     */
     _defineProperty(this, "hasTableWidth", true);
+    /**
+     * Indicates if the table is visible. By visible, it means that the holder
+     * element has CSS 'display' property different than 'none'.
+     *
+     * @type {boolean}
+     */
     _defineProperty(this, "isTableVisible", false);
     _defineProperty(this, "tableOffset", 0);
     _defineProperty(this, "holderOffset", 0);

package/CHANGELOG.md

@@ -9,6 +9,20 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 <!-- UNVERSIONED -->
 
+## [12.4.0] - 2023-05-23
+
+### Added
+- Added new afterColumnSequenceChange and afterRowSequenceChange hooks and synchronization of actions done on HOT with HF's engine [#10215](https://github.com/handsontable/handsontable/pull/10215)
+
+### Fixed
+- Fixed problem related to copying and pasting from Hansontable to Excel [#10017](https://github.com/handsontable/handsontable/issues/10017)
+- Fixed an issue where Handsontable's dates didn't sync correctly with HyperFormula's dates. [#10085](https://github.com/handsontable/handsontable/issues/10085)
+- Fixed problem related to Autofill, TrimRows and Formulas plugins cooperation. [#10200](https://github.com/handsontable/handsontable/issues/10200)
+- Fixed a problem where re-entering the same cells/headers with the mouse cursor would not trigger the `beforeOnCellMouseOver` and `afterOnCellMouseOver` hooks. [#10321](https://github.com/handsontable/handsontable/pull/10321)
+- Fixed a problem where Handsontable's `updateSettings` method would reset the HyperFormula's Undo/Redo actions stack in the connected instance. [#10326](https://github.com/handsontable/handsontable/pull/10326)
+- Updated TypeScript definition files related to CustomBorders plugin [#1240](https://github.com/handsontable/handsontable/pull/1240)
+- Fixed problems with backlight and guideline elements misalignment and moving row after the last position [#9556](https://github.com/handsontable/handsontable/issues/9556)
+
 ## [12.3.3] - 2023-03-28
 
 ### Added

package/base.js

@@ -16,9 +16,7 @@ exports.CellRange = _src.CellRange;
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 // FIXME: Bug in eslint-plugin-import: https://github.com/benmosher/eslint-plugin-import/issues/1883
 /* eslint-disable import/named */
-
 /* eslint-enable import/named */
-
 // register default mandatory cell type for the Base package
 (0, _registry2.registerCellType)(_textType.TextCellType);
 
@@ -46,8 +44,8 @@ Handsontable.hooks = _pluginHooks.default.getSingleton();
 Handsontable.CellCoords = _src.CellCoords;
 Handsontable.CellRange = _src.CellRange;
 Handsontable.packageName = 'handsontable';
-Handsontable.buildDate = "28/03/2023 10:00:43";
-Handsontable.version = "12.3.3-next-e19badf-20230328";
+Handsontable.buildDate = "12/05/2023 12:12:12";
+Handsontable.version = "12.4.0-next-ddbea0c-20230512";
 Handsontable.languages = {
   dictionaryKeys: _registry.dictionaryKeys,
   getLanguageDictionary: _registry.getLanguageDictionary,

package/base.mjs

@@ -35,8 +35,8 @@ Handsontable.hooks = Hooks.getSingleton();
 Handsontable.CellCoords = CellCoords;
 Handsontable.CellRange = CellRange;
 Handsontable.packageName = 'handsontable';
-Handsontable.buildDate = "28/03/2023 10:00:57";
-Handsontable.version = "12.3.3-next-e19badf-20230328";
+Handsontable.buildDate = "12/05/2023 12:12:29";
+Handsontable.version = "12.4.0-next-ddbea0c-20230512";
 Handsontable.languages = {
   dictionaryKeys: dictionaryKeys,
   getLanguageDictionary: getLanguageDictionary,

package/core.js

@@ -107,7 +107,7 @@ var deprecationWarns = new Set();
  * :::
  *
  * ::: only-for react
- * ```jsx{3,7,13}
+ * ```jsx
  * import { useRef } from 'react';
  *
  * const hotTableComponent = useRef(null);
@@ -263,6 +263,12 @@ function Core(rootElement, userSettings) {
    * @type {IndexMapper}
    */
   this.rowIndexMapper = new _translations.IndexMapper();
+  this.columnIndexMapper.addLocalHook('indexesSequenceChange', function (source) {
+    instance.runHooks('afterColumnSequenceChange', source);
+  });
+  this.rowIndexMapper.addLocalHook('indexesSequenceChange', function (source) {
+    instance.runHooks('afterRowSequenceChange', source);
+  });
   dataSource = new _dataSource.default(instance);
   if (!this.rootElement.id || this.rootElement.id.substring(0, 3) === 'ht_') {
     this.rootElement.id = this.guid; // if root element does not have an id, assign a random id
@@ -2442,11 +2448,13 @@ function Core(rootElement, userSettings) {
   };
 
   /**
-   * Get value from the selected cell.
+   * Gets the value of the currently focused cell.
+   *
+   * For column headers and row headers, returns `null`.
    *
    * @memberof Core#
    * @function getValue
-   * @returns {*} Value of selected cell.
+   * @returns {*} The value of the focused cell.
    */
   this.getValue = function () {
     var sel = instance.getSelectedLast();
@@ -2789,6 +2797,11 @@ function Core(rootElement, userSettings) {
    * __Note__: This method does not participate in data transformation. If the visual data of the table is reordered,
    * sorted or trimmed only physical indexes are correct.
    *
+   * __Note__: This method may return incorrect values for cells that contain
+   * [formulas](@/guides/formulas/formula-calculation.md). This is because `getSourceData()`
+   * operates on source data ([physical indexes](@/api/indexMapper.md)),
+   * whereas formulas operate on visual data (visual indexes).
+   *
    * @memberof Core#
    * @function getSourceData
    * @param {number} [row] From physical row index.
@@ -3138,7 +3151,13 @@ function Core(rootElement, userSettings) {
   };
 
   /**
-   * Checks if the data format and config allows user to modify the column structure.
+   * Checks if your [data format](@/guides/getting-started/binding-to-data.md#compatible-data-types)
+   * and [configuration options](@/guides/getting-started/configuration-options.md)
+   * allow for changing the number of columns.
+   *
+   * Returns `false` when your data is an array of objects,
+   * or when you use the [`columns`](@/api/options.md#columns) option.
+   * Otherwise, returns `true`.
    *
    * @memberof Core#
    * @function isColumnModificationAllowed
@@ -4104,8 +4123,6 @@ function Core(rootElement, userSettings) {
     if (datamap) {
       datamap.destroy();
     }
-    instance.rowIndexMapper = null;
-    instance.columnIndexMapper = null;
     datamap = null;
     grid = null;
     selection = null;

package/core.mjs

@@ -102,7 +102,7 @@ var deprecationWarns = new Set();
  * :::
  *
  * ::: only-for react
- * ```jsx{3,7,13}
+ * ```jsx
  * import { useRef } from 'react';
  *
  * const hotTableComponent = useRef(null);
@@ -258,6 +258,12 @@ export default function Core(rootElement, userSettings) {
    * @type {IndexMapper}
    */
   this.rowIndexMapper = new IndexMapper();
+  this.columnIndexMapper.addLocalHook('indexesSequenceChange', function (source) {
+    instance.runHooks('afterColumnSequenceChange', source);
+  });
+  this.rowIndexMapper.addLocalHook('indexesSequenceChange', function (source) {
+    instance.runHooks('afterRowSequenceChange', source);
+  });
   dataSource = new DataSource(instance);
   if (!this.rootElement.id || this.rootElement.id.substring(0, 3) === 'ht_') {
     this.rootElement.id = this.guid; // if root element does not have an id, assign a random id
@@ -2437,11 +2443,13 @@ export default function Core(rootElement, userSettings) {
   };
 
   /**
-   * Get value from the selected cell.
+   * Gets the value of the currently focused cell.
+   *
+   * For column headers and row headers, returns `null`.
    *
    * @memberof Core#
    * @function getValue
-   * @returns {*} Value of selected cell.
+   * @returns {*} The value of the focused cell.
    */
   this.getValue = function () {
     var sel = instance.getSelectedLast();
@@ -2784,6 +2792,11 @@ export default function Core(rootElement, userSettings) {
    * __Note__: This method does not participate in data transformation. If the visual data of the table is reordered,
    * sorted or trimmed only physical indexes are correct.
    *
+   * __Note__: This method may return incorrect values for cells that contain
+   * [formulas](@/guides/formulas/formula-calculation.md). This is because `getSourceData()`
+   * operates on source data ([physical indexes](@/api/indexMapper.md)),
+   * whereas formulas operate on visual data (visual indexes).
+   *
    * @memberof Core#
    * @function getSourceData
    * @param {number} [row] From physical row index.
@@ -3133,7 +3146,13 @@ export default function Core(rootElement, userSettings) {
   };
 
   /**
-   * Checks if the data format and config allows user to modify the column structure.
+   * Checks if your [data format](@/guides/getting-started/binding-to-data.md#compatible-data-types)
+   * and [configuration options](@/guides/getting-started/configuration-options.md)
+   * allow for changing the number of columns.
+   *
+   * Returns `false` when your data is an array of objects,
+   * or when you use the [`columns`](@/api/options.md#columns) option.
+   * Otherwise, returns `true`.
    *
    * @memberof Core#
    * @function isColumnModificationAllowed
@@ -4099,8 +4118,6 @@ export default function Core(rootElement, userSettings) {
     if (datamap) {
       datamap.destroy();
     }
-    instance.rowIndexMapper = null;
-    instance.columnIndexMapper = null;
     datamap = null;
     grid = null;
     selection = null;