handsontable 17.1.0 → 18.0.0-rc2

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

@@ -1,139 +1,333 @@
 import Walkontable from '../core/core.mjs';
 import CoreAbstract from '../core/_base.mjs';
 class WalkontableFacade {
+    /**
+   * Initializes the facade from a settings object.
+   *
+   * @param {Record<string, any>} settings - The Walkontable settings configuration.
+   */ // eslint-disable-next-line @typescript-eslint/no-explicit-any
     _initFromSettings(settings) {
         settings.facade = (instance)=>{
             const facade = new WalkontableFacade(instance);
             return ()=>facade;
         };
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         this._wot = new Walkontable(settings.table, settings);
     }
-    get guid() {
+    /**
+   * Gets the unique identifier of the Walkontable instance.
+   *
+   * @returns {*} The unique identifier.
+   */ get guid() {
         return this._wot.guid;
     }
-    get rootDocument() {
+    /**
+   * Gets the root document used by the Walkontable instance.
+   *
+   * @returns {*} The root document.
+   */ get rootDocument() {
         return this._wot.domBindings.rootDocument;
     }
-    get rootWindow() {
+    /**
+   * Gets the root window used by the Walkontable instance.
+   *
+   * @returns {*} The root window.
+   */ get rootWindow() {
         return this._wot.domBindings.rootWindow;
     }
-    get wtSettings() {
+    /**
+   * Gets the settings manager for the Walkontable instance.
+   *
+   * @returns {*} The settings manager.
+   */ get wtSettings() {
         return this._wot.wtSettings; // todo create facade
     }
-    get cloneSource() {
+    /**
+   * Gets the clone source of the Walkontable instance.
+   *
+   * @returns {*} The clone source.
+   */ get cloneSource() {
         return this._wot.cloneSource; // todo create facade
     }
-    get cloneOverlay() {
+    /**
+   * Gets the clone overlay of the Walkontable instance.
+   *
+   * @returns {Overlay} The clone overlay.
+   */ get cloneOverlay() {
         return this._wot.cloneOverlay; // todo create facade
     }
-    get selectionManager() {
+    /**
+   * Gets the selection manager of the Walkontable instance.
+   *
+   * @returns {*} The selection manager.
+   */ get selectionManager() {
         return this._wot.selectionManager; // todo create facade
     }
-    get wtViewport() {
+    /**
+   * Gets the viewport manager of the Walkontable instance.
+   *
+   * @returns {*} The viewport manager.
+   */ get wtViewport() {
         return this._wot.wtViewport; // todo create facade
     }
-    get wtOverlays() {
+    /**
+   * Gets the overlays manager of the Walkontable instance.
+   *
+   * @returns {*} The overlays manager.
+   */ get wtOverlays() {
         return this._wot.wtOverlays; // todo create facade
     }
-    get wtTable() {
+    /**
+   * Gets the table manager of the Walkontable instance.
+   *
+   * @returns {*} The table manager.
+   */ get wtTable() {
         return this._wot.wtTable; // todo create facade
     }
-    get wtEvent() {
+    /**
+   * Gets the event manager of the Walkontable instance.
+   *
+   * @returns {*} The event manager.
+   */ get wtEvent() {
         return this._wot.wtEvent; // todo create facade
     }
-    get wtScroll() {
+    /**
+   * Gets the scroll manager of the Walkontable instance.
+   *
+   * @returns {*} The scroll manager.
+   */ get wtScroll() {
         return this._wot.wtScroll; // todo create facade
     }
-    get drawn() {
+    /**
+   * Gets whether the Walkontable instance has been drawn.
+   *
+   * @returns {*} True if drawn, false otherwise.
+   */ get drawn() {
         return this._wot.drawn;
     }
-    set drawn(value) {
+    /**
+   * Sets whether the Walkontable instance has been drawn.
+   *
+   * @param {*} value - The drawn state.
+   */ set drawn(value) {
         this._wot.drawn = value;
     }
-    get activeOverlayName() {
+    /**
+   * Gets the name of the active overlay.
+   *
+   * @returns {*} The active overlay name.
+   */ get activeOverlayName() {
         return this._wot.activeOverlayName;
     }
-    get drawInterrupted() {
+    /**
+   * Gets whether drawing has been interrupted.
+   *
+   * @returns {*} True if drawing is interrupted, false otherwise.
+   */ get drawInterrupted() {
         return this._wot.drawInterrupted;
     }
-    set drawInterrupted(value) {
+    /**
+   * Sets whether drawing has been interrupted.
+   *
+   * @param {*} value - The interrupted state.
+   */ set drawInterrupted(value) {
         this._wot.drawInterrupted = value;
     }
-    get lastMouseOver() {
+    /**
+   * Gets the last element that was moused over.
+   *
+   * @returns {HTMLElement | null} The last moused-over element, or null.
+   */ get lastMouseOver() {
         return this._wot.lastMouseOver;
     }
-    set lastMouseOver(value) {
+    /**
+   * Sets the last element that was moused over.
+   *
+   * @param {*} value - The element to set.
+   */ set lastMouseOver(value) {
         this._wot.lastMouseOver = value;
     }
-    get momentumScrolling() {
+    /**
+   * Gets the momentum scrolling state.
+   *
+   * @returns {{ ongoing?: boolean; _timeout?: ReturnType<typeof setTimeout> }} The momentum scrolling state.
+   */ get momentumScrolling() {
         return this._wot.momentumScrolling;
     }
-    set momentumScrolling(value) {
+    /**
+   * Sets the momentum scrolling state.
+   *
+   * @param {*} value - The momentum scrolling state.
+   */ set momentumScrolling(value) {
         this._wot.momentumScrolling = value;
     }
-    get touchApplied() {
+    /**
+   * Gets whether touch input has been applied.
+   *
+   * @returns {boolean} True if touch was applied, false otherwise.
+   */ get touchApplied() {
         return this._wot.touchApplied;
     }
-    set touchApplied(value) {
+    /**
+   * Sets whether touch input has been applied.
+   *
+   * @param {*} value - The touch applied state.
+   */ set touchApplied(value) {
         this._wot.touchApplied = value;
     }
-    get domBindings() {
+    /**
+   * Gets the DOM bindings configuration.
+   *
+   * @returns {*} The DOM bindings.
+   */ get domBindings() {
         return this._wot.domBindings;
     }
-    get eventListeners() {
+    /**
+   * Gets the list of event listeners.
+   *
+   * @returns {unknown[]} The array of event listeners.
+   */ get eventListeners() {
         return this._wot.eventListeners;
     }
-    set eventListeners(value) {
+    /**
+   * Sets the list of event listeners.
+   *
+   * @param {*} value - The event listeners array.
+   */ set eventListeners(value) {
         this._wot.eventListeners = value;
     }
-    get eventManager() {
+    /**
+   * Gets the event manager instance.
+   *
+   * @returns {*} The event manager.
+   */ get eventManager() {
         return this._wot.eventManager;
     }
-    createCellCoords(row, column) {
+    /**
+   * Creates a new cell coordinates object.
+   *
+   * @param {number} row - The row index.
+   * @param {number} column - The column index.
+   * @returns {*} The new cell coordinates object.
+   */ createCellCoords(row, column) {
         return this._wot.createCellCoords(row, column);
     }
-    createCellRange(highlight, from, to) {
+    /**
+   * Creates a new cell range.
+   *
+   * @param {CellCoords} highlight - The highlighted cell coordinates.
+   * @param {CellCoords} from - The starting cell coordinates.
+   * @param {CellCoords} to - The ending cell coordinates.
+   * @returns {*} The new cell range.
+   */ createCellRange(highlight, from, to) {
         return this._wot.createCellRange(highlight, from, to);
     }
-    draw(fastDraw = false) {
+    /**
+   * Redraws the table.
+   *
+   * @param {boolean} [fastDraw=false] - Whether to perform a fast draw.
+   * @returns {WalkontableFacade} This instance for method chaining.
+   */ draw(fastDraw = false) {
         this._wot.draw(fastDraw);
         return this;
     }
-    getCell(coords, topmost = false) {
+    /**
+   * Gets the DOM cell element at the specified coordinates.
+   *
+   * @param {CellCoords} coords - The cell coordinates.
+   * @param {boolean} [topmost=false] - Whether to get the topmost element.
+   * @returns {*} The DOM cell element.
+   */ getCell(coords, topmost = false) {
         return this._wot.getCell(coords, topmost);
     }
-    scrollViewport(coords, horizontalSnap, verticalSnap) {
+    /**
+   * Scrolls the viewport to the specified cell coordinates.
+   *
+   * @param {CellCoords} coords - The cell coordinates to scroll to.
+   * @param {string} horizontalSnap - The horizontal snap setting.
+   * @param {string} verticalSnap - The vertical snap setting.
+   * @returns {*} The result of the scroll operation.
+   */ scrollViewport(coords, horizontalSnap, verticalSnap) {
         return this._wot.scrollViewport(coords, horizontalSnap, verticalSnap);
     }
-    scrollViewportHorizontally(column, snapping) {
+    /**
+   * Scrolls the viewport horizontally.
+   *
+   * @param {number} column - The column index to scroll to.
+   * @param {string} snapping - The snapping setting.
+   * @returns {*} The result of the scroll operation.
+   */ scrollViewportHorizontally(column, snapping) {
         return this._wot.scrollViewportHorizontally(column, snapping);
     }
-    scrollViewportVertically(row, snapping) {
+    /**
+   * Scrolls the viewport vertically.
+   *
+   * @param {number} row - The row index to scroll to.
+   * @param {string} snapping - The snapping setting.
+   * @returns {*} The result of the scroll operation.
+   */ scrollViewportVertically(row, snapping) {
         return this._wot.scrollViewportVertically(row, snapping);
     }
-    getViewport() {
+    /**
+   * Gets the current viewport dimensions.
+   *
+   * @returns {*} The viewport dimensions.
+   */ getViewport() {
         return this._wot.getViewport();
     }
-    getOverlayName() {
+    /**
+   * Gets the name of the currently active overlay.
+   *
+   * @returns {string} The overlay type name, or 'master' if no clone overlay.
+   */ getOverlayName() {
         return this._wot.cloneOverlay ? this._wot.cloneOverlay.type : 'master';
     }
-    getOverlayByName(overlayName) {
+    /**
+   * Gets an overlay by its name.
+   *
+   * @param {string} overlayName - The name of the overlay to retrieve.
+   * @returns {Overlay | null} The overlay, or null if not found.
+   */ getOverlayByName(overlayName) {
         return this._wot.getOverlayByName(overlayName);
     }
-    exportSettingsAsClassNames() {
-        return this._wot.exportSettingsAsClassNames();
+    /**
+   * Exports the current settings as CSS class names on the table element.
+   */ exportSettingsAsClassNames() {
+        this._wot.exportSettingsAsClassNames();
     }
-    update(settings, value) {
+    /**
+   * Updates Walkontable settings.
+   *
+   * @param {string | Record<string, unknown>} settings - The setting key or settings object.
+   * @param {unknown} value - The value to set (when settings is a string).
+   * @returns {WalkontableFacade} This instance for method chaining.
+   */ update(settings, value) {
         this._wot.wtSettings.update(settings, value);
         return this;
     }
-    getSetting(key, param1, param2, param3, param4) {
+    /**
+   * Gets a setting value.
+   *
+   * @param {string} key - The setting key.
+   * @param {unknown} param1 - Optional parameter.
+   * @param {unknown} param2 - Optional parameter.
+   * @param {unknown} param3 - Optional parameter.
+   * @param {unknown} param4 - Optional parameter.
+   * @returns {unknown} The setting value.
+   */ getSetting(key, param1, param2, param3, param4) {
         return this._wot.wtSettings.getSetting(key, param1, param2, param3, param4);
     }
-    hasSetting(key) {
-        return this._wot.wtSettings.hasSetting(key);
+    /**
+   * Checks whether a setting exists.
+   *
+   * @param {string} key - The setting key.
+   * @returns {*} True if the setting exists, false otherwise.
+   */ hasSetting(key) {
+        return this._wot.wtSettings.has(key);
     }
-    destroy() {
+    /**
+   * Destroys the Walkontable instance and cleans up resources.
+   */ destroy() {
         this._wot.destroy();
     }
     /**

package/3rdparty/walkontable/src/filter/column.d.mts

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

package/3rdparty/walkontable/src/filter/column.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @class ColumnFilter
+ */
+declare class ColumnFilter {
+    /**
+     * @type {number}
+     */
+    offset: number;
+    /**
+     * @type {number}
+     */
+    total: number;
+    /**
+     * @type {number}
+     */
+    countTH: number;
+    /**
+     * @param {number} offset The scroll horizontal offset.
+     * @param {number} total The total width of the table.
+     * @param {number} countTH The number of rendered row headers.
+     */
+    constructor(offset: number, total: number, countTH: number);
+    /**
+     * @param {number} index The visual column index.
+     * @returns {number}
+     */
+    offsetted(index: number): number;
+    /**
+     * @param {number} index The visual column index.
+     * @returns {number}
+     */
+    unOffsetted(index: number): number;
+    /**
+     * @param {number} index The visual column index.
+     * @returns {number}
+     */
+    renderedToSource(index: number): number;
+    /**
+     * @param {number} index The visual column index.
+     * @returns {number}
+     */
+    sourceToRendered(index: number): number;
+    /**
+     * @param {number} index The visual column index.
+     * @returns {number}
+     */
+    offsettedTH(index: number): number;
+    /**
+     * @param {number} index The visual column index.
+     * @returns {number}
+     */
+    unOffsettedTH(index: number): number;
+    /**
+     * @param {number} index The visual column index.
+     * @returns {number}
+     */
+    visibleRowHeadedColumnToSourceColumn(index: number): number;
+    /**
+     * @param {number} index The visual column index.
+     * @returns {number}
+     */
+    sourceColumnToVisibleRowHeadedColumn(index: number): number;
+}
+export default ColumnFilter;

package/3rdparty/walkontable/src/filter/row.d.mts

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

package/3rdparty/walkontable/src/filter/row.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @class RowFilter
+ */
+declare class RowFilter {
+    /**
+     * @type {number}
+     */
+    offset: number;
+    /**
+     * @type {number}
+     */
+    total: number;
+    /**
+     * @type {number}
+     */
+    countTH: number;
+    /**
+     * @param {number} offset The scroll vertical offset.
+     * @param {number} total The total height of the table.
+     * @param {number} countTH The number of rendered column headers.
+     */
+    constructor(offset: number, total: number, countTH: number);
+    /**
+     * @param {number} index The visual row index.
+     * @returns {number}
+     */
+    offsetted(index: number): number;
+    /**
+     * @param {number} index The visual row index.
+     * @returns {number}
+     */
+    unOffsetted(index: number): number;
+    /**
+     * @param {number} index The visual row index.
+     * @returns {number}
+     */
+    renderedToSource(index: number): number;
+    /**
+     * @param {number} index The visual row index.
+     * @returns {number}
+     */
+    sourceToRendered(index: number): number;
+    /**
+     * @param {number} index The visual row index.
+     * @returns {number}
+     */
+    offsettedTH(index: number): number;
+    /**
+     * @param {number} index The visual row index.
+     * @returns {number}
+     */
+    unOffsettedTH(index: number): number;
+    /**
+     * @param {number} index The visual row index.
+     * @returns {number}
+     */
+    visibleColHeadedRowToSourceRow(index: number): number;
+    /**
+     * @param {number} index The visual row index.
+     * @returns {number}
+     */
+    sourceRowToVisibleColHeadedRow(index: number): number;
+}
+export default RowFilter;

package/3rdparty/walkontable/src/index.d.mts

@@ -0,0 +1 @@
+export * from './index.js';

package/3rdparty/walkontable/src/index.d.ts

@@ -1 +1,11 @@
-export type OverlayType = 'top' | 'bottom' | 'left' | 'top_left_corner' | 'bottom_left_corner';
+import { ViewportColumnsCalculator, ViewportRowsCalculator } from './calculator';
+import { DEFAULT_COLUMN_WIDTH } from './constants';
+import CellCoords from './cell/coords';
+import CellRange from './cell/range';
+import Walkontable from './facade/core';
+import { Selection, ACTIVE_HEADER_TYPE, AREA_TYPE, FOCUS_TYPE, FILL_TYPE, HEADER_TYPE, ROW_TYPE, COLUMN_TYPE, CUSTOM_SELECTION_TYPE } from './selection';
+import * as Renderer from './renderer';
+import { NodesPool } from './utils/nodesPool';
+export { OrderView, SharedOrderView } from './utils/orderView';
+export { getListenersCounter } from '../../../eventManager';
+export { DEFAULT_COLUMN_WIDTH, ViewportColumnsCalculator, ViewportRowsCalculator, CellCoords, CellRange, Walkontable as default, Walkontable as Core, Selection, ACTIVE_HEADER_TYPE as HIGHLIGHT_ACTIVE_HEADER_TYPE, AREA_TYPE as HIGHLIGHT_AREA_TYPE, FOCUS_TYPE as HIGHLIGHT_FOCUS_TYPE, FILL_TYPE as HIGHLIGHT_FILL_TYPE, HEADER_TYPE as HIGHLIGHT_HEADER_TYPE, ROW_TYPE as HIGHLIGHT_ROW_TYPE, COLUMN_TYPE as HIGHLIGHT_COLUMN_TYPE, CUSTOM_SELECTION_TYPE as HIGHLIGHT_CUSTOM_SELECTION_TYPE, Renderer, NodesPool };

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

@@ -80,8 +80,8 @@ const _range = /*#__PURE__*/ _interop_require_default(require("./cell/range"));
 const _core = /*#__PURE__*/ _interop_require_default(require("./facade/core"));
 const _selection = require("./selection");
 const _renderer = /*#__PURE__*/ _interop_require_wildcard(require("./renderer"));
-const _orderView = require("./utils/orderView");
 const _nodesPool = require("./utils/nodesPool");
+const _orderView = require("./utils/orderView");
 const _eventManager = require("../../../eventManager");
 function _interop_require_default(obj) {
     return obj && obj.__esModule ? obj : {

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

@@ -5,7 +5,7 @@ import CellRange from './cell/range.mjs';
 import Walkontable from './facade/core.mjs';
 import { Selection, ACTIVE_HEADER_TYPE, AREA_TYPE, FOCUS_TYPE, FILL_TYPE, HEADER_TYPE, ROW_TYPE, COLUMN_TYPE, CUSTOM_SELECTION_TYPE } from './selection/index.mjs';
 import * as Renderer from './renderer/index.mjs';
-import { OrderView, SharedOrderView } from './utils/orderView/index.mjs';
 import { NodesPool } from './utils/nodesPool.mjs';
-import { getListenersCounter } from '../../../eventManager.mjs';
-export { DEFAULT_COLUMN_WIDTH, ViewportColumnsCalculator, ViewportRowsCalculator, CellCoords, CellRange, Walkontable as default, Walkontable as Core, Selection, ACTIVE_HEADER_TYPE as HIGHLIGHT_ACTIVE_HEADER_TYPE, AREA_TYPE as HIGHLIGHT_AREA_TYPE, FOCUS_TYPE as HIGHLIGHT_FOCUS_TYPE, FILL_TYPE as HIGHLIGHT_FILL_TYPE, HEADER_TYPE as HIGHLIGHT_HEADER_TYPE, ROW_TYPE as HIGHLIGHT_ROW_TYPE, COLUMN_TYPE as HIGHLIGHT_COLUMN_TYPE, CUSTOM_SELECTION_TYPE as HIGHLIGHT_CUSTOM_SELECTION_TYPE, Renderer, NodesPool, OrderView, SharedOrderView, getListenersCounter };
+export { OrderView, SharedOrderView } from './utils/orderView/index.mjs';
+export { getListenersCounter } from '../../../eventManager.mjs';
+export { DEFAULT_COLUMN_WIDTH, ViewportColumnsCalculator, ViewportRowsCalculator, CellCoords, CellRange, Walkontable as default, Walkontable as Core, Selection, ACTIVE_HEADER_TYPE as HIGHLIGHT_ACTIVE_HEADER_TYPE, AREA_TYPE as HIGHLIGHT_AREA_TYPE, FOCUS_TYPE as HIGHLIGHT_FOCUS_TYPE, FILL_TYPE as HIGHLIGHT_FILL_TYPE, HEADER_TYPE as HIGHLIGHT_HEADER_TYPE, ROW_TYPE as HIGHLIGHT_ROW_TYPE, COLUMN_TYPE as HIGHLIGHT_COLUMN_TYPE, CUSTOM_SELECTION_TYPE as HIGHLIGHT_CUSTOM_SELECTION_TYPE, Renderer, NodesPool };

package/3rdparty/walkontable/src/overlay/_base.d.mts

@@ -0,0 +1 @@
+export * from './_base.js';