handsontable 17.1.0 → 18.0.0-rc2

package/plugins/manualRowResize/manualRowResize.mjs

@@ -49,11 +49,12 @@ function _class_private_method_init(obj, privateSet) {
     privateSet.add(obj);
 }
 import { BasePlugin } from '../base/index.mjs';
-import { addClass, closest, hasClass, removeClass, outerHeight, outerWidth, isDetached } from '../../helpers/dom/element.mjs';
+import { addClass, closest, eventTargetEl, hasClass, removeClass, outerHeight, outerWidth, isDetached } from '../../helpers/dom/element.mjs';
 import { arrayEach } from '../../helpers/array.mjs';
 import { rangeEach } from '../../helpers/number.mjs';
+import { deprecatedWarn } from '../../helpers/console.mjs';
 import { PhysicalIndexToValueMap as IndexToValueMap } from '../../translations/index.mjs';
-import { getElementScaleFactor, normalizeVisualDelta } from '../manualResize/utils.mjs';
+import { getElementScaleFactor, normalizeVisualDelta, shouldRefreshHandleAfterAutoResize, shouldSkipResizeHandlePositioning } from '../manualResize/utils.mjs';
 // Developer note! Whenever you make a change in this file, make an analogous change in manualColumnResize.js
 export const PLUGIN_KEY = 'manualRowResize';
 export const PLUGIN_PRIORITY = 30;
@@ -124,10 +125,10 @@ var /**
    * @param {number} height Row height.
    * @param {number} row Visual row index.
    * @returns {number}
-   */ _onModifyRowHeight = /*#__PURE__*/ new WeakSet(), /**
+   */ _onModifyRowHeight = /*#__PURE__*/ new WeakMap(), /**
    * Callback to call on map's `init` local hook.
    */ _onMapInit = /*#__PURE__*/ new WeakSet();
-/* eslint-disable jsdoc/require-description-complete-sentence */ /**
+/**
  * @plugin ManualRowResize
  * @class ManualRowResize
  *
@@ -138,10 +139,14 @@ var /**
  * - handle - the draggable element that sets the desired height of the row.
  * - guide - the helper guide that shows the desired height as a horizontal guide.
  */ export class ManualRowResize extends BasePlugin {
-    static get PLUGIN_KEY() {
+    /**
+   * Returns the plugin key used to identify this plugin in Handsontable settings.
+   */ static get PLUGIN_KEY() {
         return PLUGIN_KEY;
     }
-    static get PLUGIN_PRIORITY() {
+    /**
+   * Returns the priority order used to determine the order in which plugins are initialized.
+   */ static get PLUGIN_PRIORITY() {
         return PLUGIN_PRIORITY;
     }
     /**
@@ -156,7 +161,7 @@ var /**
    *
    * @returns {boolean}
    */ isEnabled() {
-        return this.hot.getSettings()[PLUGIN_KEY];
+        return !!this.hot.getSettings()[PLUGIN_KEY];
     }
     /**
    * Enables the plugin functionality for this Handsontable instance.
@@ -170,7 +175,7 @@ var /**
         _class_private_field_set(this, _disposeMapObserver, this.hot.rowIndexMapper.observeMapChange(_class_private_field_get(this, _rowHeightsMap), ()=>{
             this.hot.view?.invalidateRowHeightCache();
         }));
-        this.addHook('modifyRowHeight', (height, row)=>_class_private_method_get(this, _onModifyRowHeight, onModifyRowHeight).call(this, height, row));
+        this.addHook('modifyRowHeight', _class_private_field_get(this, _onModifyRowHeight));
         this.bindEvents();
         super.enablePlugin();
     }
@@ -196,6 +201,24 @@ var /**
         super.disablePlugin();
     }
     /**
+   * Deprecated. The `PersistentState` plugin has been removed. This method is a no-op and will be removed in a
+   * future major release.
+   *
+   * @deprecated
+   */ saveManualRowHeights() {
+        deprecatedWarn('`saveManualRowHeights()` is deprecated and will be removed in a future major release. ' + 'The PersistentState plugin has been removed.');
+    }
+    /**
+   * Deprecated. The `PersistentState` plugin has been removed. This method is a no-op and will be removed in a
+   * future major release.
+   *
+   * @deprecated
+   * @returns {Array}
+   */ loadManualRowHeights() {
+        deprecatedWarn('`loadManualRowHeights()` is deprecated and will be removed in a future major release. ' + 'The PersistentState plugin has been removed.');
+        return [];
+    }
+    /**
    * Sets the new height for specified row index.
    *
    * @param {number} row Visual row index.
@@ -203,8 +226,10 @@ var /**
    * @returns {number} Returns new height.
    */ setManualSize(row, height) {
         const physicalRow = this.hot.toPhysicalRow(row);
-        const newHeight = Math.max(height, this.hot.stylesHandler.getDefaultRowHeight());
-        _class_private_field_get(this, _rowHeightsMap).setValueAtIndex(physicalRow, newHeight);
+        const newHeight = Math.max(height, this.hot.stylesHandler.getDefaultRowHeight() ?? 0);
+        if (physicalRow !== null) {
+            _class_private_field_get(this, _rowHeightsMap).setValueAtIndex(physicalRow, newHeight);
+        }
         return newHeight;
     }
     /**
@@ -212,7 +237,7 @@ var /**
    *
    * @returns {number} The last desired row height.
    */ getLastDesiredRowHeight() {
-        return _class_private_field_get(this, _currentHeight);
+        return _class_private_field_get(this, _currentHeight) ?? 0;
     }
     /**
    * Sets the resize handle position.
@@ -220,16 +245,19 @@ var /**
    * @private
    * @param {HTMLCellElement} TH TH HTML element.
    */ setupHandlePosition(TH) {
-        if (!TH.parentNode || _class_private_field_get(this, _dblclick) > 1) {
+        if (shouldSkipResizeHandlePositioning(TH, _class_private_field_get(this, _dblclick))) {
             return;
         }
         _class_private_field_set(this, _currentTH, TH);
         const { view } = this.hot;
         const { _wt: wt } = view;
         const cellCoords = wt.wtTable.getCoords(_class_private_field_get(this, _currentTH));
+        if (!cellCoords) {
+            return;
+        }
         const row = cellCoords.row;
         // Ignore row headers.
-        if (row < 0) {
+        if (row === null || row < 0) {
             return;
         }
         const headerWidth = outerWidth(_class_private_field_get(this, _currentTH));
@@ -238,24 +266,29 @@ var /**
         const fixedRowTop = row < wt.getSetting('fixedRowsTop');
         const fixedRowBottom = row >= view.countNotHiddenRowIndexes(0, 1) - wt.getSetting('fixedRowsBottom');
         let relativeHeaderPosition;
+        const coordRow = cellCoords.row ?? 0;
+        const coordCol = cellCoords.col ?? 0;
         if (fixedRowTop) {
-            relativeHeaderPosition = wt.wtOverlays.topInlineStartCornerOverlay.getRelativeCellPosition(_class_private_field_get(this, _currentTH), cellCoords.row, cellCoords.col);
+            relativeHeaderPosition = wt.wtOverlays.topInlineStartCornerOverlay.getRelativeCellPosition(_class_private_field_get(this, _currentTH), coordRow, coordCol);
         } else if (fixedRowBottom) {
-            relativeHeaderPosition = wt.wtOverlays.bottomInlineStartCornerOverlay.getRelativeCellPosition(_class_private_field_get(this, _currentTH), cellCoords.row, cellCoords.col);
+            relativeHeaderPosition = wt.wtOverlays.bottomInlineStartCornerOverlay.getRelativeCellPosition(_class_private_field_get(this, _currentTH), coordRow, coordCol);
         }
         // If the TH is not a child of the top-left/bottom-left overlay, recalculate using
         // the left overlay - as this overlay contains the rest of the headers.
         if (!relativeHeaderPosition) {
-            relativeHeaderPosition = wt.wtOverlays.inlineStartOverlay.getRelativeCellPosition(_class_private_field_get(this, _currentTH), cellCoords.row, cellCoords.col);
+            relativeHeaderPosition = wt.wtOverlays.inlineStartOverlay.getRelativeCellPosition(_class_private_field_get(this, _currentTH), coordRow, coordCol);
         }
         _class_private_field_set(this, _currentRow, this.hot.rowIndexMapper.getVisualFromRenderableIndex(row));
         _class_private_field_set(this, _selectedRows, []);
         const isFullRowSelected = this.hot.selection.isSelectedByCorner() || this.hot.selection.isSelectedByRowHeader();
         if (this.hot.selection.isSelected() && isFullRowSelected) {
-            const selectionRanges = this.hot.getSelectedRange();
+            const selectionRanges = this.hot.getSelectedRange() ?? [];
             arrayEach(selectionRanges, (selectionRange)=>{
                 const fromRow = selectionRange.getTopStartCorner().row;
                 const toRow = selectionRange.getBottomStartCorner().row;
+                if (fromRow === null || toRow === null) {
+                    return;
+                }
                 // Add every selected row for resize action.
                 rangeEach(fromRow, toRow, (rowIndex)=>{
                     if (!_class_private_field_get(this, _selectedRows).includes(rowIndex)) {
@@ -264,12 +297,18 @@ var /**
                 });
             });
         }
+        if (_class_private_field_get(this, _currentRow) === null) {
+            return;
+        }
         // Resizing element beyond the current selection (also when there is no selection).
         if (!_class_private_field_get(this, _selectedRows).includes(_class_private_field_get(this, _currentRow))) {
             _class_private_field_set(this, _selectedRows, [
                 _class_private_field_get(this, _currentRow)
             ]);
         }
+        if (!relativeHeaderPosition) {
+            return;
+        }
         _class_private_field_set(this, _startOffset, relativeHeaderPosition.top - 6);
         _class_private_field_set(this, _startHeight, outerHeight(_class_private_field_get(this, _currentTH)));
         _class_private_field_set(this, _verticalScaleFactor, getElementScaleFactor(_class_private_field_get(this, _currentTH), 'vertical'));
@@ -283,15 +322,15 @@ var /**
    *
    * @private
    */ refreshHandlePosition() {
-        _class_private_field_get(this, _handle).style.top = `${_class_private_field_get(this, _startOffset) + _class_private_field_get(this, _currentHeight)}px`;
+        _class_private_field_get(this, _handle).style.top = `${(_class_private_field_get(this, _startOffset) ?? 0) + (_class_private_field_get(this, _currentHeight) ?? 0)}px`;
     }
     /**
    * Sets the resize guide position.
    *
    * @private
    */ setupGuidePosition() {
-        const handleWidth = parseInt(outerWidth(_class_private_field_get(this, _handle)), 10);
-        const handleEndPosition = parseInt(_class_private_field_get(this, _handle).style[this.inlineDir], 10) + handleWidth;
+        const handleWidth = outerWidth(_class_private_field_get(this, _handle));
+        const handleEndPosition = Number.parseInt(_class_private_field_get(this, _handle).style[this.inlineDir], 10) + handleWidth;
         const tableWidth = this.hot.view.getTableWidth();
         addClass(_class_private_field_get(this, _handle), 'active');
         addClass(_class_private_field_get(this, _guide), 'active');
@@ -327,9 +366,9 @@ var /**
         ], this.hot.rootElement);
         const { inlineStartOverlay, topInlineStartCornerOverlay, bottomInlineStartCornerOverlay } = this.hot.view._wt.wtOverlays;
         return [
-            inlineStartOverlay.clone.wtTable.TBODY,
-            topInlineStartCornerOverlay.clone.wtTable.TBODY,
-            bottomInlineStartCornerOverlay.clone.wtTable.TBODY
+            inlineStartOverlay.clone?.wtTable.TBODY,
+            topInlineStartCornerOverlay.clone?.wtTable.TBODY,
+            bottomInlineStartCornerOverlay.clone?.wtTable.TBODY
         ].includes(tbody);
     }
     /**
@@ -356,7 +395,7 @@ var /**
    */ getActualRowHeight(row) {
         // TODO: this should utilize `this.hot.getRowHeight` after it's fixed and working properly.
         const walkontableHeight = this.hot.view._wt.wtTable.getRowHeight(row);
-        if (walkontableHeight !== undefined && _class_private_field_get(this, _newSize) < walkontableHeight) {
+        if (walkontableHeight !== undefined && _class_private_field_get(this, _newSize) !== null && _class_private_field_get(this, _newSize) < walkontableHeight) {
             return walkontableHeight;
         }
         return _class_private_field_get(this, _newSize);
@@ -368,13 +407,17 @@ var /**
    * @fires Hooks#beforeRowResize
    * @fires Hooks#afterRowResize
    */ afterMouseDownTimeout() {
+        const shouldRefreshHandlePosition = shouldRefreshHandleAfterAutoResize(_class_private_field_get(this, _currentTH), _class_private_field_get(this, _dblclick));
         const render = ()=>{
             this.hot.view.adjustElementsSize();
             this.hot.render();
         };
         const resize = (row, forceRender)=>{
             const hookNewSize = this.hot.runHooks('beforeRowResize', this.getActualRowHeight(row), row, true);
-            if (hookNewSize !== undefined) {
+            if (hookNewSize === false) {
+                return;
+            }
+            if (typeof hookNewSize === 'number') {
                 _class_private_field_set(this, _newSize, hookNewSize);
             }
             this.setManualSize(row, _class_private_field_get(this, _newSize)); // double click sets auto row size
@@ -396,8 +439,11 @@ var /**
                 });
             }
         }
-        _class_private_field_set(this, _dblclick, 0);
         _class_private_field_set(this, _autoresizeTimeout, null);
+        _class_private_field_set(this, _dblclick, 0);
+        if (shouldRefreshHandlePosition && _class_private_field_get(this, _currentTH)) {
+            this.setupHandlePosition(_class_private_field_get(this, _currentTH));
+        }
     }
     /**
    * Binds the mouse events.
@@ -416,8 +462,10 @@ var /**
    */ destroy() {
         super.destroy();
     }
-    constructor(hotInstance){
-        super(hotInstance), _class_private_method_init(this, _onMouseOver), _class_private_method_init(this, _onMouseDown), _class_private_method_init(this, _onMouseMove), _class_private_method_init(this, _onMouseUp), _class_private_method_init(this, _onContextMenu), _class_private_method_init(this, _onModifyRowHeight), _class_private_method_init(this, _onMapInit), _class_private_field_init(this, _currentTH, {
+    /**
+   * Initializes the plugin and applies CSS classes to the resize handle and guide elements.
+   */ constructor(hotInstance){
+        super(hotInstance), _class_private_method_init(this, _onMouseOver), _class_private_method_init(this, _onMouseDown), _class_private_method_init(this, _onMouseMove), _class_private_method_init(this, _onMouseUp), _class_private_method_init(this, _onContextMenu), _class_private_method_init(this, _onMapInit), _class_private_field_init(this, _currentTH, {
             writable: true,
             value: void 0
         }), _class_private_field_init(this, _currentRow, {
@@ -471,7 +519,24 @@ var /**
         }), _class_private_field_init(this, _config, {
             writable: true,
             value: void 0
-        }), _class_private_field_set(this, _currentTH, null), _class_private_field_set(this, _currentRow, null), _class_private_field_set(this, _selectedRows, []), _class_private_field_set(this, _currentHeight, null), _class_private_field_set(this, _newSize, null), _class_private_field_set(this, _startY, null), _class_private_field_set(this, _startHeight, null), _class_private_field_set(this, _startOffset, null), _class_private_field_set(this, _verticalScaleFactor, 1), _class_private_field_set(this, _handle, this.hot.rootDocument.createElement('DIV')), _class_private_field_set(this, _guide, this.hot.rootDocument.createElement('DIV')), _class_private_field_set(this, _pressed, false), _class_private_field_set(this, _isTriggeredByRMB, false), _class_private_field_set(this, _dblclick, 0), _class_private_field_set(this, _autoresizeTimeout, null), _class_private_field_set(this, _disposeMapObserver, null);
+        }), _class_private_field_init(this, _onModifyRowHeight, {
+            writable: true,
+            value: void 0
+        }), _class_private_field_set(this, _currentTH, null), _class_private_field_set(this, _currentRow, null), _class_private_field_set(this, _selectedRows, []), _class_private_field_set(this, _currentHeight, null), _class_private_field_set(this, _newSize, null), _class_private_field_set(this, _startY, null), _class_private_field_set(this, _startHeight, null), _class_private_field_set(this, _startOffset, null), _class_private_field_set(this, _verticalScaleFactor, 1), _class_private_field_set(this, _handle, this.hot.rootDocument.createElement('DIV')), _class_private_field_set(this, _guide, this.hot.rootDocument.createElement('DIV')), _class_private_field_set(this, _pressed, false), _class_private_field_set(this, _isTriggeredByRMB, false), _class_private_field_set(this, _dblclick, 0), _class_private_field_set(this, _autoresizeTimeout, null), _class_private_field_set(this, _disposeMapObserver, null), _class_private_field_set(this, _onModifyRowHeight, (height, row)=>{
+            let newHeight = height;
+            if (this.enabled) {
+                const physicalRow = this.hot.toPhysicalRow(row);
+                const rowHeight = _class_private_field_get(this, _rowHeightsMap).getValueAtIndex(physicalRow);
+                if (this.hot.getSettings()[PLUGIN_KEY] && rowHeight) {
+                    if (this.hot.getPlugin('autoRowSize')?.isEnabled()) {
+                        newHeight = Math.max(rowHeight, newHeight ?? 0);
+                    } else {
+                        newHeight = rowHeight;
+                    }
+                }
+            }
+            return newHeight;
+        });
         addClass(_class_private_field_get(this, _handle), 'manualRowResizer');
         addClass(_class_private_field_get(this, _guide), 'manualRowResizerGuide');
     }
@@ -479,15 +544,15 @@ var /**
 function onMouseOver(event) {
     // Workaround for #6926 - if the `event.target` is temporarily detached, we can skip this callback and wait for
     // the next `onmouseover`.
-    if (isDetached(event.target)) {
+    if (isDetached(eventTargetEl(event))) {
         return;
     }
     // A "mouseover" action is triggered right after executing "contextmenu" event. It should be ignored.
     if (_class_private_field_get(this, _isTriggeredByRMB) === true) {
         return;
     }
-    if (this.checkIfRowHeader(event.target)) {
-        const th = this.getClosestTHParent(event.target);
+    if (this.checkIfRowHeader(eventTargetEl(event))) {
+        const th = this.getClosestTHParent(eventTargetEl(event));
         if (th) {
             if (!_class_private_field_get(this, _pressed)) {
                 this.setupHandlePosition(th);
@@ -496,10 +561,10 @@ function onMouseOver(event) {
     }
 }
 function onMouseDown(event) {
-    if (event.target.parentNode !== this.hot.rootElement) {
+    if (eventTargetEl(event).parentNode !== this.hot.rootElement) {
         return;
     }
-    if (hasClass(event.target, 'manualRowResizer')) {
+    if (hasClass(eventTargetEl(event), 'manualRowResizer')) {
         this.setupHandlePosition(_class_private_field_get(this, _currentTH));
         this.setupGuidePosition();
         _class_private_field_set(this, _pressed, true);
@@ -513,9 +578,9 @@ function onMouseDown(event) {
 }
 function onMouseMove(event) {
     if (_class_private_field_get(this, _pressed)) {
-        const visualChange = event.pageY - _class_private_field_get(this, _startY);
+        const visualChange = event.pageY - (_class_private_field_get(this, _startY) ?? 0);
         const change = normalizeVisualDelta(visualChange, _class_private_field_get(this, _verticalScaleFactor));
-        _class_private_field_set(this, _currentHeight, _class_private_field_get(this, _startHeight) + change);
+        _class_private_field_set(this, _currentHeight, (_class_private_field_get(this, _startHeight) ?? 0) + change);
         arrayEach(_class_private_field_get(this, _selectedRows), (selectedRow)=>{
             _class_private_field_set(this, _newSize, this.setManualSize(selectedRow, _class_private_field_get(this, _currentHeight)));
         });
@@ -529,11 +594,20 @@ function onMouseUp() {
         this.hot.render();
     };
     const runHooks = (row, forceRender)=>{
-        this.hot.runHooks('beforeRowResize', this.getActualRowHeight(row), row, false);
+        const hookNewSize = this.hot.runHooks('beforeRowResize', this.getActualRowHeight(row), row, false);
+        if (hookNewSize === false) {
+            this.setManualSize(row, _class_private_field_get(this, _startHeight));
+            _class_private_field_set(this, _newSize, _class_private_field_get(this, _startHeight));
+        } else if (typeof hookNewSize === 'number') {
+            _class_private_field_set(this, _newSize, hookNewSize);
+            this.setManualSize(row, _class_private_field_get(this, _newSize));
+        }
         if (forceRender) {
             render();
         }
-        this.hot.runHooks('afterRowResize', this.getActualRowHeight(row), row, false);
+        if (hookNewSize !== false) {
+            this.hot.runHooks('afterRowResize', this.getActualRowHeight(row), row, false);
+        }
     };
     if (_class_private_field_get(this, _pressed)) {
         this.hideHandleAndGuide();
@@ -566,21 +640,6 @@ function onContextMenu() {
         _class_private_field_set(this, _isTriggeredByRMB, false);
     });
 }
-function onModifyRowHeight(height, row) {
-    let newHeight = height;
-    if (this.enabled) {
-        const physicalRow = this.hot.toPhysicalRow(row);
-        const rowHeight = _class_private_field_get(this, _rowHeightsMap).getValueAtIndex(physicalRow);
-        if (this.hot.getSettings()[PLUGIN_KEY] && rowHeight) {
-            if (this.hot.getPlugin('autoRowSize')?.isEnabled()) {
-                newHeight = Math.max(rowHeight, newHeight ?? 0);
-            } else {
-                newHeight = rowHeight;
-            }
-        }
-    }
-    return newHeight;
-}
 function onMapInit() {
     const initialSetting = this.hot.getSettings()[PLUGIN_KEY];
     this.hot.batchExecution(()=>{

package/plugins/mergeCells/calculations/autofill.d.mts

@@ -0,0 +1,2 @@
+export * from './autofill.js';
+export { default } from './autofill.js';

package/plugins/mergeCells/calculations/autofill.d.ts

@@ -0,0 +1,128 @@
+import type { HotInstance } from '../../../core/types';
+import type MergedCellsCollection from '../cellsCollection';
+import type MergedCellCoords from '../cellCoords';
+interface MergeCellsPlugin {
+    hot: HotInstance;
+    mergedCellsCollection: MergedCellsCollection;
+    ifChromeForceRepaint(): void;
+}
+/**
+ * Class responsible for all of the Autofill-related operations on merged cells.
+ *
+ * @private
+ * @class AutofillCalculations
+ */
+declare class AutofillCalculations {
+    /**
+     * Reference to the Merge Cells plugin.
+     *
+     * @type {MergeCells}
+     */
+    plugin: MergeCellsPlugin;
+    /**
+     * Reference to the MergedCellsCollection class instance.
+     *
+     * @type {MergedCellsCollection}
+     */
+    mergedCellsCollection: MergedCellsCollection;
+    /**
+     * Cache of the currently processed autofill data.
+     *
+     * @private
+     * @type {object}
+     */
+    currentFillData: Record<string, unknown> | null;
+    /**
+     * Initializes the autofill calculations helper with a reference to the MergeCells plugin and its merged cells collection.
+     */
+    constructor(plugin: MergeCellsPlugin);
+    /**
+     * Get the direction of the autofill process.
+     *
+     * @param {Array} baseArea The selection area.
+     * @param {Array} fullArea The final area (base + drag).
+     * @returns {string} `up`, `down`, `left` or `right`.
+     */
+    getDirection(baseArea: number[], fullArea: number[]): string;
+    /**
+     * Snap the drag area to the farthest merged cell, so it won't clip any of the merged cells.
+     *
+     * @param {Array} baseArea The base selected area.
+     * @param {Array} fullArea The drag area.
+     * @param {string} dragDirection The autofill drag direction.
+     * @param {Array} foundMergedCells MergeCellCoords found in the base selection area.
+     * @returns {Array} The new drag area.
+     */
+    snapDragArea(baseArea: number[], fullArea: number[], dragDirection: string, foundMergedCells: MergedCellCoords[]): number[];
+    /**
+     * Update the current fill cache with the provided object.
+     *
+     * @private
+     * @param {object} updateObject The current filled object cache.
+     */
+    updateCurrentFillCache(updateObject: Record<string, unknown>): void;
+    /**
+     * Get the "length" of the drag area.
+     *
+     * @private
+     * @param {Array} baseArea The base selection area.
+     * @param {Array} fullArea The drag area (containing the base area).
+     * @param {string} direction The drag direction.
+     * @returns {number} The "length" (height or width, depending on the direction) of the drag.
+     */
+    getAutofillSize(baseArea: number[], fullArea: number[], direction: string): number;
+    /**
+     * Trim the default drag area (containing the selection area) to the drag-only area.
+     *
+     * @private
+     * @param {Array} baseArea The base selection area.
+     * @param {Array} fullArea The base selection area extended by the drag area.
+     * @param {string} direction Drag direction.
+     * @returns {Array} Array representing the drag area coordinates.
+     */
+    getDragArea(baseArea: number[], fullArea: number[], direction: string): number[];
+    /**
+     * Get the to-be-farthest merged cell in the newly filled area.
+     *
+     * @private
+     * @param {Array} baseArea The base selection area.
+     * @param {Array} fullArea The drag area (containing the base area).
+     * @param {string} direction The drag direction.
+     * @param {Array} mergedCellArray Array of the merged cells found in the base area.
+     * @returns {MergedCellCoords|null}
+     */
+    getFarthestCollection(baseArea: number[], fullArea: number[], direction: string, mergedCellArray: MergedCellCoords[]): MergedCellCoords | null;
+    /**
+     * Recreate the merged cells after the autofill process.
+     *
+     * @param {Array} changes Changes made.
+     */
+    recreateAfterDataPopulation(changes: unknown[][]): void;
+    /**
+     * Get the drag range from the changes made.
+     *
+     * @private
+     * @param {Array} changes The changes made.
+     * @returns {object} Object with `from` and `to` properties, both containing `row` and `column` keys.
+     */
+    getRangeFromChanges(changes: unknown[][]): {
+        from: {
+            row: number;
+            column: number;
+        };
+        to: {
+            row: number;
+            column: number;
+        };
+    };
+    /**
+     * Check if the drag area contains any merged cells.
+     *
+     * @param {Array} baseArea The base selection area.
+     * @param {Array} fullArea The base area extended by the drag area.
+     * @param {string} direction Drag direction.
+     * @returns {boolean}
+     */
+    dragAreaOverlapsCollections(baseArea: number[], fullArea: number[], direction: string): boolean;
+}
+export default AutofillCalculations;

package/plugins/mergeCells/calculations/autofill.js

@@ -118,7 +118,7 @@ const _array = require("../../../helpers/array");
    * @param {Array} baseArea The base selection area.
    * @param {Array} fullArea The drag area (containing the base area).
    * @param {string} direction The drag direction.
-   * @returns {number|null} The "length" (height or width, depending on the direction) of the drag.
+   * @returns {number} The "length" (height or width, depending on the direction) of the drag.
    */ getAutofillSize(baseArea, fullArea, direction) {
         const [baseAreaStartRow, baseAreaStartColumn, baseAreaEndRow, baseAreaEndColumn] = baseArea;
         const [dragAreaStartRow, dragAreaStartColumn, dragAreaEndRow, dragAreaEndColumn] = fullArea;
@@ -132,7 +132,7 @@ const _array = require("../../../helpers/array");
             case 'right':
                 return dragAreaEndColumn - baseAreaEndColumn;
             default:
-                return null;
+                return 0;
         }
     }
     /**
@@ -142,7 +142,7 @@ const _array = require("../../../helpers/array");
    * @param {Array} baseArea The base selection area.
    * @param {Array} fullArea The base selection area extended by the drag area.
    * @param {string} direction Drag direction.
-   * @returns {Array|null} Array representing the drag area coordinates.
+   * @returns {Array} Array representing the drag area coordinates.
    */ getDragArea(baseArea, fullArea, direction) {
         const [baseAreaStartRow, baseAreaStartColumn, baseAreaEndRow, baseAreaEndColumn] = baseArea;
         const [fullAreaStartRow, fullAreaStartColumn, fullAreaEndRow, fullAreaEndColumn] = fullArea;
@@ -184,7 +184,12 @@ const _array = require("../../../helpers/array");
                     ];
                 }
             default:
-                return null;
+                return [
+                    0,
+                    0,
+                    0,
+                    0
+                ];
         }
     }
     /**
@@ -231,8 +236,9 @@ const _array = require("../../../helpers/array");
             default:
         }
         (0, _array.arrayEach)(mergedCellArray, (currentCollection)=>{
-            if (currentCollection[inclusionFunctionName](endOfDragRecreationIndex) && currentCollection.isFarther(farthestCollection, direction)) {
-                farthestCollection = currentCollection;
+            const mc = currentCollection;
+            if (mc[inclusionFunctionName](endOfDragRecreationIndex) && mc.isFarther(farthestCollection, direction)) {
+                farthestCollection = mc;
             }
         });
         return farthestCollection;
@@ -310,7 +316,7 @@ const _array = require("../../../helpers/array");
                     multiplier += 1;
                 }
             }
-        }while (inBounds(current, fillOffset))
+        }while (current !== null && inBounds(current, fillOffset))
         this.currentFillData = null;
         this.plugin.hot.render();
         if (foundMergedCells.length > 0) {
@@ -324,38 +330,35 @@ const _array = require("../../../helpers/array");
    * @param {Array} changes The changes made.
    * @returns {object} Object with `from` and `to` properties, both containing `row` and `column` keys.
    */ getRangeFromChanges(changes) {
-        const rows = {
-            min: null,
-            max: null
-        };
-        const columns = {
-            min: null,
-            max: null
-        };
+        let rowMin = null;
+        let rowMax = null;
+        let colMin = null;
+        let colMax = null;
         (0, _array.arrayEach)(changes, (change)=>{
-            const rowIndex = change[0];
-            const columnIndex = this.plugin.hot.propToCol(change[1]);
-            if (rows.min === null || rowIndex < rows.min) {
-                rows.min = rowIndex;
+            const changeArr = change;
+            const rowIndex = changeArr[0];
+            const columnIndex = this.plugin.hot.propToCol(changeArr[1]);
+            if (rowMin === null || rowIndex < rowMin) {
+                rowMin = rowIndex;
             }
-            if (rows.max === null || rowIndex > rows.max) {
-                rows.max = rowIndex;
+            if (rowMax === null || rowIndex > rowMax) {
+                rowMax = rowIndex;
             }
-            if (columns.min === null || columnIndex < columns.min) {
-                columns.min = columnIndex;
+            if (colMin === null || columnIndex < colMin) {
+                colMin = columnIndex;
             }
-            if (columns.max === null || columnIndex > columns.max) {
-                columns.max = columnIndex;
+            if (colMax === null || columnIndex > colMax) {
+                colMax = columnIndex;
             }
         });
         return {
             from: {
-                row: rows.min,
-                column: columns.min
+                row: rowMin ?? 0,
+                column: colMin ?? 0
             },
             to: {
-                row: rows.max,
-                column: columns.max
+                row: rowMax ?? 0,
+                column: colMax ?? 0
             }
         };
     }
@@ -385,7 +388,9 @@ const _array = require("../../../helpers/array");
         }
         return !mergedCellsWithoutPartials.every(({ rowspan })=>rowspan === dragRange.getHeight());
     }
-    constructor(plugin){
+    /**
+   * Initializes the autofill calculations helper with a reference to the MergeCells plugin and its merged cells collection.
+   */ constructor(plugin){
         /**
    * Cache of the currently processed autofill data.
    *