handsontable 18.0.0 → 18.1.0-rc7

package/plugins/customBorders/utils.d.ts

@@ -1,4 +1,12 @@
 import type { HotInstance } from '../../core/types';
+import type { CellProperties } from '../../settings';
+/**
+ * Cell meta shape for cells that carry custom borders - types the `borders` option on top of the base
+ * cell properties, so reads through `getCellMeta` are not widened to `any`.
+ */
+export interface BordersCellProperties extends CellProperties {
+    borders?: unknown;
+}
 /**
  * Describes style properties for a single border side or corner.
  */
@@ -74,6 +82,69 @@ export interface CustomBorderConfig {
  * @returns {string}
  */
 export declare function createId(row: number, col: number): string;
+/**
+ * Computes the new position of a coordinate index after `amount` rows/columns are inserted
+ * at `insertionIndex`. An index at or after the insertion point moves down/right by `amount`;
+ * an index before it stays put.
+ *
+ * @param {number} index The visual index to shift.
+ * @param {number} insertionIndex The visual index at which the insertion starts.
+ * @param {number} amount The number of inserted rows/columns.
+ * @returns {number}
+ */
+export declare function getShiftedIndexAfterInsert(index: number, insertionIndex: number, amount: number): number;
+/**
+ * Computes the new position of a coordinate index after `amount` rows/columns are removed
+ * starting at `removalIndex`. An index below the removed range moves up/left by `amount`;
+ * an index inside the removed range returns `-1` (the border no longer has a cell); an index
+ * above the removed range stays put.
+ *
+ * @param {number} index The visual index to shift.
+ * @param {number} removalIndex The visual index at which the removal starts.
+ * @param {number} amount The number of removed rows/columns.
+ * @returns {number}
+ */
+export declare function getShiftedIndexAfterRemove(index: number, removalIndex: number, amount: number): number;
+/**
+ * Builds the disjoint, ascending list of visual-index ranges the viewport working set must cover
+ * on one axis: the frozen-start area, the master rendered range (clipped so the ranges stay
+ * disjoint), and the frozen-end area. Frozen rows and columns are rendered by the overlay clones
+ * even when the master rendered range excludes them, so the working set must always include them.
+ *
+ * @param {number} firstIndex First visual index of the master rendered range.
+ * @param {number} lastIndex Last visual index of the master rendered range.
+ * @param {number} fixedStartCount Number of frozen indexes at the start of the axis.
+ * @param {number} fixedEndCount Number of frozen indexes at the end of the axis.
+ * @param {number} totalCount Total number of indexes on the axis.
+ * @returns {Array} Array of `[from, to]` tuples, disjoint and ascending.
+ */
+export declare function getViewportUnionRanges(firstIndex: number, lastIndex: number, fixedStartCount: number, fixedEndCount: number, totalCount: number): Array<[number, number]>;
+/**
+ * Checks whether a visual index lies inside the viewport working window on one axis: the
+ * frozen-start area, the frozen-end area, or the master rendered range.
+ *
+ * @param {number} index The visual index to test.
+ * @param {number} firstIndex First visual index of the master rendered range.
+ * @param {number} lastIndex Last visual index of the master rendered range.
+ * @param {number} fixedStartCount Number of frozen indexes at the start of the axis.
+ * @param {number} fixedEndCount Number of frozen indexes at the end of the axis.
+ * @param {number} totalCount Total number of indexes on the axis.
+ * @returns {boolean}
+ */
+export declare function isIndexInViewportUnion(index: number, firstIndex: number, lastIndex: number, fixedStartCount: number, fixedEndCount: number, totalCount: number): boolean;
+/**
+ * Resolves the style of a single border side declared inside a range configuration. An explicit
+ * per-side style object takes precedence and is used unchanged. An enabled but unstyled side
+ * (an empty object `{}`, an empty string, or `true`) inherits the range-level `border` object's
+ * style (width, color, and line style) so it renders with the configured look instead of the
+ * default 1px black. When no range-level `border` is provided the raw side value is kept, which
+ * preserves the previous behavior.
+ *
+ * @param {object} [rawSide] The side value from the range configuration.
+ * @param {object} [rangeBorder] The range-level `border` object shared by all sides.
+ * @returns {object}
+ */
+export declare function resolveRangeBorderSide(rawSide: BorderSettings | undefined, rangeBorder: Record<string, unknown> | undefined): BorderSettings | undefined;
 /**
  * Create default single border for each position (top/right/bottom/left).
  *

package/plugins/customBorders/utils.js

@@ -33,18 +33,33 @@ _export(exports, {
     get extendDefaultBorder () {
         return extendDefaultBorder;
     },
+    get getShiftedIndexAfterInsert () {
+        return getShiftedIndexAfterInsert;
+    },
+    get getShiftedIndexAfterRemove () {
+        return getShiftedIndexAfterRemove;
+    },
+    get getViewportUnionRanges () {
+        return getViewportUnionRanges;
+    },
     get hasLeftRightTypeOptions () {
         return hasLeftRightTypeOptions;
     },
     get hasStartEndTypeOptions () {
         return hasStartEndTypeOptions;
     },
+    get isIndexInViewportUnion () {
+        return isIndexInViewportUnion;
+    },
     get markSelected () {
         return markSelected;
     },
     get normalizeBorder () {
         return normalizeBorder;
     },
+    get resolveRangeBorderSide () {
+        return resolveRangeBorderSide;
+    },
     get toInlinePropName () {
         return toInlinePropName;
     }
@@ -55,6 +70,54 @@ const _array = require("../../helpers/array");
 function createId(row, col) {
     return `border_row${row}col${col}`;
 }
+function getShiftedIndexAfterInsert(index, insertionIndex, amount) {
+    return index >= insertionIndex ? index + amount : index;
+}
+function getShiftedIndexAfterRemove(index, removalIndex, amount) {
+    if (index >= removalIndex + amount) {
+        return index - amount;
+    }
+    if (index >= removalIndex) {
+        return -1;
+    }
+    return index;
+}
+function getViewportUnionRanges(firstIndex, lastIndex, fixedStartCount, fixedEndCount, totalCount) {
+    const ranges = [];
+    const fixedEndStart = totalCount - fixedEndCount;
+    const pushRange = (from, to)=>{
+        if (from <= to) {
+            ranges.push([
+                from,
+                to
+            ]);
+        }
+    };
+    pushRange(0, Math.min(fixedStartCount, totalCount) - 1);
+    pushRange(Math.max(firstIndex, fixedStartCount), Math.min(lastIndex, fixedEndStart - 1));
+    pushRange(Math.max(fixedEndStart, fixedStartCount), totalCount - 1);
+    return ranges;
+}
+function isIndexInViewportUnion(index, firstIndex, lastIndex, fixedStartCount, fixedEndCount, totalCount) {
+    if (index < 0 || index >= totalCount) {
+        return false;
+    }
+    return index < fixedStartCount || index >= totalCount - fixedEndCount || index >= firstIndex && index <= lastIndex;
+}
+function resolveRangeBorderSide(rawSide, rangeBorder) {
+    if (rawSide && (0, _object.isObject)(rawSide) && Object.keys(rawSide).length > 0) {
+        return rawSide;
+    }
+    if (rangeBorder && (0, _object.isObject)(rangeBorder)) {
+        const resolved = {
+            ...rangeBorder
+        };
+        // `cornerVisible` describes the selection corner, not an individual side, so it is dropped.
+        delete resolved.cornerVisible;
+        return resolved;
+    }
+    return rawSide;
+}
 function createDefaultCustomBorder() {
     return {
         width: 1,

package/plugins/customBorders/utils.mjs

@@ -10,6 +10,107 @@ import { arrayEach } from '../../helpers/array.mjs';
  */ export function createId(row, col) {
     return `border_row${row}col${col}`;
 }
+/**
+ * Computes the new position of a coordinate index after `amount` rows/columns are inserted
+ * at `insertionIndex`. An index at or after the insertion point moves down/right by `amount`;
+ * an index before it stays put.
+ *
+ * @param {number} index The visual index to shift.
+ * @param {number} insertionIndex The visual index at which the insertion starts.
+ * @param {number} amount The number of inserted rows/columns.
+ * @returns {number}
+ */ export function getShiftedIndexAfterInsert(index, insertionIndex, amount) {
+    return index >= insertionIndex ? index + amount : index;
+}
+/**
+ * Computes the new position of a coordinate index after `amount` rows/columns are removed
+ * starting at `removalIndex`. An index below the removed range moves up/left by `amount`;
+ * an index inside the removed range returns `-1` (the border no longer has a cell); an index
+ * above the removed range stays put.
+ *
+ * @param {number} index The visual index to shift.
+ * @param {number} removalIndex The visual index at which the removal starts.
+ * @param {number} amount The number of removed rows/columns.
+ * @returns {number}
+ */ export function getShiftedIndexAfterRemove(index, removalIndex, amount) {
+    if (index >= removalIndex + amount) {
+        return index - amount;
+    }
+    if (index >= removalIndex) {
+        return -1;
+    }
+    return index;
+}
+/**
+ * Builds the disjoint, ascending list of visual-index ranges the viewport working set must cover
+ * on one axis: the frozen-start area, the master rendered range (clipped so the ranges stay
+ * disjoint), and the frozen-end area. Frozen rows and columns are rendered by the overlay clones
+ * even when the master rendered range excludes them, so the working set must always include them.
+ *
+ * @param {number} firstIndex First visual index of the master rendered range.
+ * @param {number} lastIndex Last visual index of the master rendered range.
+ * @param {number} fixedStartCount Number of frozen indexes at the start of the axis.
+ * @param {number} fixedEndCount Number of frozen indexes at the end of the axis.
+ * @param {number} totalCount Total number of indexes on the axis.
+ * @returns {Array} Array of `[from, to]` tuples, disjoint and ascending.
+ */ export function getViewportUnionRanges(firstIndex, lastIndex, fixedStartCount, fixedEndCount, totalCount) {
+    const ranges = [];
+    const fixedEndStart = totalCount - fixedEndCount;
+    const pushRange = (from, to)=>{
+        if (from <= to) {
+            ranges.push([
+                from,
+                to
+            ]);
+        }
+    };
+    pushRange(0, Math.min(fixedStartCount, totalCount) - 1);
+    pushRange(Math.max(firstIndex, fixedStartCount), Math.min(lastIndex, fixedEndStart - 1));
+    pushRange(Math.max(fixedEndStart, fixedStartCount), totalCount - 1);
+    return ranges;
+}
+/**
+ * Checks whether a visual index lies inside the viewport working window on one axis: the
+ * frozen-start area, the frozen-end area, or the master rendered range.
+ *
+ * @param {number} index The visual index to test.
+ * @param {number} firstIndex First visual index of the master rendered range.
+ * @param {number} lastIndex Last visual index of the master rendered range.
+ * @param {number} fixedStartCount Number of frozen indexes at the start of the axis.
+ * @param {number} fixedEndCount Number of frozen indexes at the end of the axis.
+ * @param {number} totalCount Total number of indexes on the axis.
+ * @returns {boolean}
+ */ export function isIndexInViewportUnion(index, firstIndex, lastIndex, fixedStartCount, fixedEndCount, totalCount) {
+    if (index < 0 || index >= totalCount) {
+        return false;
+    }
+    return index < fixedStartCount || index >= totalCount - fixedEndCount || index >= firstIndex && index <= lastIndex;
+}
+/**
+ * Resolves the style of a single border side declared inside a range configuration. An explicit
+ * per-side style object takes precedence and is used unchanged. An enabled but unstyled side
+ * (an empty object `{}`, an empty string, or `true`) inherits the range-level `border` object's
+ * style (width, color, and line style) so it renders with the configured look instead of the
+ * default 1px black. When no range-level `border` is provided the raw side value is kept, which
+ * preserves the previous behavior.
+ *
+ * @param {object} [rawSide] The side value from the range configuration.
+ * @param {object} [rangeBorder] The range-level `border` object shared by all sides.
+ * @returns {object}
+ */ export function resolveRangeBorderSide(rawSide, rangeBorder) {
+    if (rawSide && isObject(rawSide) && Object.keys(rawSide).length > 0) {
+        return rawSide;
+    }
+    if (rangeBorder && isObject(rangeBorder)) {
+        const resolved = {
+            ...rangeBorder
+        };
+        // `cornerVisible` describes the selection corner, not an individual side, so it is dropped.
+        delete resolved.cornerVisible;
+        return resolved;
+    }
+    return rawSide;
+}
 /**
  * Create default single border for each position (top/right/bottom/left).
  *

package/plugins/dataProvider/dataProvider.d.ts

@@ -67,7 +67,8 @@ export interface DataProviderFetchOptions {
     signal: AbortSignal;
 }
 /**
- * @deprecated Use DataProviderFetchOptions
+ * @deprecated Since 18.0.0, renamed to `DataProviderFetchOptions`. This alias will be removed in
+ * 19.0.0. Use {@link DataProviderFetchOptions} instead.
  */
 export type DataProviderOptions = DataProviderFetchOptions;
 export interface RowsCreatePayload {

package/plugins/dataProvider/dataProvider.js

@@ -209,7 +209,16 @@ var /**
    * @param {function(): Promise<*>} userPromiseFn Server callback invocation.
    * @param {function(): Promise<void>|void} onSuccess Runs after success (e.g. `fetchData`).
    * @returns {Promise<void>}
-   */ _queueCrud = /*#__PURE__*/ new WeakSet(), _onHasExternalDataSource = /*#__PURE__*/ new WeakMap(), _onAfterInit = /*#__PURE__*/ new WeakMap(), _onAfterPageChangeExternalPagination = /*#__PURE__*/ new WeakMap(), _onAfterPageSizeChangeExternalPagination = /*#__PURE__*/ new WeakMap(), _onBeforeFilter = /*#__PURE__*/ new WeakMap(), _onBeforeColumnSort = /*#__PURE__*/ new WeakMap(), _onModifyRowHeader = /*#__PURE__*/ new WeakMap(), _onBeforeUndoStackChange = /*#__PURE__*/ new WeakMap(), _onAfterChangeForServerUpdate = /*#__PURE__*/ new WeakMap(), _onBeforeAlter = /*#__PURE__*/ new WeakMap();
+   */ _queueCrud = /*#__PURE__*/ new WeakSet(), /**
+   * Runs [[#fetchData]] for internal fire-and-forget refetches (initial load, `updatePlugin`, sort, filter, and the
+   * Refetch notification action). [[#fetchData]] already surfaces the failure – it fires
+   * [[Hooks#afterDataProviderFetchError]] and shows the error notification – before rethrowing for its public callers,
+   * so here the rejection is only logged and settled. Without this, `fetchRows` failures reach the page as
+   * `unhandledrejection` events.
+   *
+   * @param {object} [overrides] Partial query overrides passed to [[#fetchData]].
+   * @returns {Promise<{ rows: Array<*>, totalRows: number }|null>} Resolves to `null` when the fetch fails.
+   */ _fetchDataSilently = /*#__PURE__*/ new WeakSet(), _onHasExternalDataSource = /*#__PURE__*/ new WeakMap(), _onAfterInit = /*#__PURE__*/ new WeakMap(), _onAfterPageChangeExternalPagination = /*#__PURE__*/ new WeakMap(), _onAfterPageSizeChangeExternalPagination = /*#__PURE__*/ new WeakMap(), _onBeforeFilter = /*#__PURE__*/ new WeakMap(), _onBeforeColumnSort = /*#__PURE__*/ new WeakMap(), _onModifyRowHeader = /*#__PURE__*/ new WeakMap(), _onBeforeUndoStackChange = /*#__PURE__*/ new WeakMap(), _onAfterChangeForServerUpdate = /*#__PURE__*/ new WeakMap(), _onBeforeAlter = /*#__PURE__*/ new WeakMap();
 class DataProvider extends _base.BasePlugin {
     /**
    * Returns the plugin key used to identify this plugin in Handsontable settings.
@@ -270,7 +279,7 @@ class DataProvider extends _base.BasePlugin {
         this.disablePlugin();
         this.enablePlugin();
         if (this.hot.view) {
-            void this.fetchData();
+            void _class_private_method_get(this, _fetchDataSilently, fetchDataSilently).call(this);
         }
         super.updatePlugin();
     }
@@ -477,7 +486,7 @@ class DataProvider extends _base.BasePlugin {
     /**
    * @param {object} hotInstance Handsontable instance.
    */ constructor(hotInstance){
-        super(hotInstance), _class_private_method_init(this, _getConfig), _class_private_method_init(this, _getRowIdOption), _class_private_method_init(this, _getFetchFn), _class_private_method_init(this, _getOnRowsCreate), _class_private_method_init(this, _getOnRowsUpdate), _class_private_method_init(this, _getOnRowsRemove), _class_private_method_init(this, _snapshotQueryParameters), _class_private_method_init(this, _applyQueryParametersFromPlugins), _class_private_method_init(this, _abortInFlightFetch), _class_private_method_init(this, _mergeAndNormalizeFetchParams), _class_private_method_init(this, _createFetchAbortController), _class_private_method_init(this, _runAfterDataProviderFetchAbort), _class_private_method_init(this, _resetAbortController), _class_private_method_init(this, _enqueueMutation), _class_private_method_init(this, _showDataProviderRequestErrorNotification), _class_private_method_init(this, _commitRowsUpdate), _class_private_method_init(this, _queueCrud), _class_private_field_init(this, _queryParameters, {
+        super(hotInstance), _class_private_method_init(this, _getConfig), _class_private_method_init(this, _getRowIdOption), _class_private_method_init(this, _getFetchFn), _class_private_method_init(this, _getOnRowsCreate), _class_private_method_init(this, _getOnRowsUpdate), _class_private_method_init(this, _getOnRowsRemove), _class_private_method_init(this, _snapshotQueryParameters), _class_private_method_init(this, _applyQueryParametersFromPlugins), _class_private_method_init(this, _abortInFlightFetch), _class_private_method_init(this, _mergeAndNormalizeFetchParams), _class_private_method_init(this, _createFetchAbortController), _class_private_method_init(this, _runAfterDataProviderFetchAbort), _class_private_method_init(this, _resetAbortController), _class_private_method_init(this, _enqueueMutation), _class_private_method_init(this, _showDataProviderRequestErrorNotification), _class_private_method_init(this, _commitRowsUpdate), _class_private_method_init(this, _queueCrud), _class_private_method_init(this, _fetchDataSilently), _class_private_field_init(this, _queryParameters, {
             writable: true,
             value: void 0
         }), _class_private_field_init(this, _abortController, {
@@ -578,7 +587,7 @@ class DataProvider extends _base.BasePlugin {
         }), _class_private_field_set(this, _abortController, null), _class_private_field_set(this, _mutationQueue, {
             tail: Promise.resolve()
         }), _class_private_field_set(this, _onHasExternalDataSource, ()=>(0, _utils.isCompleteDataProviderConfig)(this.hot.getSettings().dataProvider)), _class_private_field_set(this, _onAfterInit, ()=>{
-            void this.fetchData();
+            void _class_private_method_get(this, _fetchDataSilently, fetchDataSilently).call(this);
         }), _class_private_field_set(this, _onAfterPageChangeExternalPagination, (oldPage, newPage)=>{
             (0, _pagination.handleAfterPageChangeExternalPagination)({
                 hot: this.hot,
@@ -607,13 +616,13 @@ class DataProvider extends _base.BasePlugin {
                 applyFiltersAndRefetch: (filtersForProvider)=>{
                     _class_private_field_get(this, _queryParameters).filters = filtersForProvider ?? null;
                     _class_private_field_get(this, _queryParameters).page = 1;
-                    void this.fetchData();
+                    void _class_private_method_get(this, _fetchDataSilently, fetchDataSilently).call(this);
                 }
             }, conditionsStack)), _class_private_field_set(this, _onBeforeColumnSort, (currentSortConfig, destinationSortConfigs, sortPossible)=>(0, _sorting.handleBeforeColumnSortForServer)({
                 hot: this.hot,
                 hasFetchFn: ()=>(0, _function.isFunction)(_class_private_method_get(this, _getFetchFn, getFetchFn).call(this)),
                 applyQueryParametersFromPlugins: ()=>_class_private_method_get(this, _applyQueryParametersFromPlugins, applyQueryParametersFromPlugins).call(this),
-                fetchData: (overrides)=>this.fetchData(overrides)
+                fetchData: (overrides)=>_class_private_method_get(this, _fetchDataSilently, fetchDataSilently).call(this, overrides)
             }, currentSortConfig, destinationSortConfigs, sortPossible)), _class_private_field_set(this, _onModifyRowHeader, (visualRowIndex)=>(0, _pagination.getPagedRowHeaderIndex)(_class_private_field_get(this, _queryParameters), visualRowIndex)), _class_private_field_set(this, _onBeforeUndoStackChange, (doneActionsCopy, source)=>{
             if (!(0, _function.isFunction)(_class_private_method_get(this, _getOnRowsUpdate, getOnRowsUpdate).call(this))) {
                 return;
@@ -753,7 +762,7 @@ function showDataProviderRequestErrorNotification(kind, err) {
                     if (toastId) {
                         notificationPlugin.hide(toastId);
                     }
-                    void this.fetchData();
+                    void _class_private_method_get(this, _fetchDataSilently, fetchDataSilently).call(this);
                 }
             }
         ];
@@ -780,3 +789,9 @@ function queueCrud(operation, payload, userPromiseFn, onSuccess) {
         onRequestFailed: (kind, err)=>_class_private_method_get(this, _showDataProviderRequestErrorNotification, showDataProviderRequestErrorNotification).call(this, kind, err)
     }, operation, payload, userPromiseFn, onSuccess);
 }
+function fetchDataSilently(overrides = {}) {
+    return this.fetchData(overrides).catch((err)=>{
+        (0, _console.error)('Data fetch failed:', err);
+        return null;
+    });
+}

package/plugins/dataProvider/dataProvider.mjs

@@ -148,7 +148,16 @@ var /**
    * @param {function(): Promise<*>} userPromiseFn Server callback invocation.
    * @param {function(): Promise<void>|void} onSuccess Runs after success (e.g. `fetchData`).
    * @returns {Promise<void>}
-   */ _queueCrud = /*#__PURE__*/ new WeakSet(), _onHasExternalDataSource = /*#__PURE__*/ new WeakMap(), _onAfterInit = /*#__PURE__*/ new WeakMap(), _onAfterPageChangeExternalPagination = /*#__PURE__*/ new WeakMap(), _onAfterPageSizeChangeExternalPagination = /*#__PURE__*/ new WeakMap(), _onBeforeFilter = /*#__PURE__*/ new WeakMap(), _onBeforeColumnSort = /*#__PURE__*/ new WeakMap(), _onModifyRowHeader = /*#__PURE__*/ new WeakMap(), _onBeforeUndoStackChange = /*#__PURE__*/ new WeakMap(), _onAfterChangeForServerUpdate = /*#__PURE__*/ new WeakMap(), _onBeforeAlter = /*#__PURE__*/ new WeakMap();
+   */ _queueCrud = /*#__PURE__*/ new WeakSet(), /**
+   * Runs [[#fetchData]] for internal fire-and-forget refetches (initial load, `updatePlugin`, sort, filter, and the
+   * Refetch notification action). [[#fetchData]] already surfaces the failure – it fires
+   * [[Hooks#afterDataProviderFetchError]] and shows the error notification – before rethrowing for its public callers,
+   * so here the rejection is only logged and settled. Without this, `fetchRows` failures reach the page as
+   * `unhandledrejection` events.
+   *
+   * @param {object} [overrides] Partial query overrides passed to [[#fetchData]].
+   * @returns {Promise<{ rows: Array<*>, totalRows: number }|null>} Resolves to `null` when the fetch fails.
+   */ _fetchDataSilently = /*#__PURE__*/ new WeakSet(), _onHasExternalDataSource = /*#__PURE__*/ new WeakMap(), _onAfterInit = /*#__PURE__*/ new WeakMap(), _onAfterPageChangeExternalPagination = /*#__PURE__*/ new WeakMap(), _onAfterPageSizeChangeExternalPagination = /*#__PURE__*/ new WeakMap(), _onBeforeFilter = /*#__PURE__*/ new WeakMap(), _onBeforeColumnSort = /*#__PURE__*/ new WeakMap(), _onModifyRowHeader = /*#__PURE__*/ new WeakMap(), _onBeforeUndoStackChange = /*#__PURE__*/ new WeakMap(), _onAfterChangeForServerUpdate = /*#__PURE__*/ new WeakMap(), _onBeforeAlter = /*#__PURE__*/ new WeakMap();
 /**
  * @plugin DataProvider
  * @class DataProvider
@@ -222,7 +231,7 @@ var /**
         this.disablePlugin();
         this.enablePlugin();
         if (this.hot.view) {
-            void this.fetchData();
+            void _class_private_method_get(this, _fetchDataSilently, fetchDataSilently).call(this);
         }
         super.updatePlugin();
     }
@@ -429,7 +438,7 @@ var /**
     /**
    * @param {object} hotInstance Handsontable instance.
    */ constructor(hotInstance){
-        super(hotInstance), _class_private_method_init(this, _getConfig), _class_private_method_init(this, _getRowIdOption), _class_private_method_init(this, _getFetchFn), _class_private_method_init(this, _getOnRowsCreate), _class_private_method_init(this, _getOnRowsUpdate), _class_private_method_init(this, _getOnRowsRemove), _class_private_method_init(this, _snapshotQueryParameters), _class_private_method_init(this, _applyQueryParametersFromPlugins), _class_private_method_init(this, _abortInFlightFetch), _class_private_method_init(this, _mergeAndNormalizeFetchParams), _class_private_method_init(this, _createFetchAbortController), _class_private_method_init(this, _runAfterDataProviderFetchAbort), _class_private_method_init(this, _resetAbortController), _class_private_method_init(this, _enqueueMutation), _class_private_method_init(this, _showDataProviderRequestErrorNotification), _class_private_method_init(this, _commitRowsUpdate), _class_private_method_init(this, _queueCrud), _class_private_field_init(this, _queryParameters, {
+        super(hotInstance), _class_private_method_init(this, _getConfig), _class_private_method_init(this, _getRowIdOption), _class_private_method_init(this, _getFetchFn), _class_private_method_init(this, _getOnRowsCreate), _class_private_method_init(this, _getOnRowsUpdate), _class_private_method_init(this, _getOnRowsRemove), _class_private_method_init(this, _snapshotQueryParameters), _class_private_method_init(this, _applyQueryParametersFromPlugins), _class_private_method_init(this, _abortInFlightFetch), _class_private_method_init(this, _mergeAndNormalizeFetchParams), _class_private_method_init(this, _createFetchAbortController), _class_private_method_init(this, _runAfterDataProviderFetchAbort), _class_private_method_init(this, _resetAbortController), _class_private_method_init(this, _enqueueMutation), _class_private_method_init(this, _showDataProviderRequestErrorNotification), _class_private_method_init(this, _commitRowsUpdate), _class_private_method_init(this, _queueCrud), _class_private_method_init(this, _fetchDataSilently), _class_private_field_init(this, _queryParameters, {
             writable: true,
             value: void 0
         }), _class_private_field_init(this, _abortController, {
@@ -530,7 +539,7 @@ var /**
         }), _class_private_field_set(this, _abortController, null), _class_private_field_set(this, _mutationQueue, {
             tail: Promise.resolve()
         }), _class_private_field_set(this, _onHasExternalDataSource, ()=>isCompleteDataProviderConfig(this.hot.getSettings().dataProvider)), _class_private_field_set(this, _onAfterInit, ()=>{
-            void this.fetchData();
+            void _class_private_method_get(this, _fetchDataSilently, fetchDataSilently).call(this);
         }), _class_private_field_set(this, _onAfterPageChangeExternalPagination, (oldPage, newPage)=>{
             handleAfterPageChangeExternalPagination({
                 hot: this.hot,
@@ -559,13 +568,13 @@ var /**
                 applyFiltersAndRefetch: (filtersForProvider)=>{
                     _class_private_field_get(this, _queryParameters).filters = filtersForProvider ?? null;
                     _class_private_field_get(this, _queryParameters).page = 1;
-                    void this.fetchData();
+                    void _class_private_method_get(this, _fetchDataSilently, fetchDataSilently).call(this);
                 }
             }, conditionsStack)), _class_private_field_set(this, _onBeforeColumnSort, (currentSortConfig, destinationSortConfigs, sortPossible)=>handleBeforeColumnSortForServer({
                 hot: this.hot,
                 hasFetchFn: ()=>isFunction(_class_private_method_get(this, _getFetchFn, getFetchFn).call(this)),
                 applyQueryParametersFromPlugins: ()=>_class_private_method_get(this, _applyQueryParametersFromPlugins, applyQueryParametersFromPlugins).call(this),
-                fetchData: (overrides)=>this.fetchData(overrides)
+                fetchData: (overrides)=>_class_private_method_get(this, _fetchDataSilently, fetchDataSilently).call(this, overrides)
             }, currentSortConfig, destinationSortConfigs, sortPossible)), _class_private_field_set(this, _onModifyRowHeader, (visualRowIndex)=>getPagedRowHeaderIndex(_class_private_field_get(this, _queryParameters), visualRowIndex)), _class_private_field_set(this, _onBeforeUndoStackChange, (doneActionsCopy, source)=>{
             if (!isFunction(_class_private_method_get(this, _getOnRowsUpdate, getOnRowsUpdate).call(this))) {
                 return;
@@ -705,7 +714,7 @@ function showDataProviderRequestErrorNotification(kind, err) {
                     if (toastId) {
                         notificationPlugin.hide(toastId);
                     }
-                    void this.fetchData();
+                    void _class_private_method_get(this, _fetchDataSilently, fetchDataSilently).call(this);
                 }
             }
         ];
@@ -732,3 +741,9 @@ function queueCrud1(operation, payload, userPromiseFn, onSuccess) {
         onRequestFailed: (kind, err)=>_class_private_method_get(this, _showDataProviderRequestErrorNotification, showDataProviderRequestErrorNotification).call(this, kind, err)
     }, operation, payload, userPromiseFn, onSuccess);
 }
+function fetchDataSilently(overrides = {}) {
+    return this.fetchData(overrides).catch((err)=>{
+        logError('Data fetch failed:', err);
+        return null;
+    });
+}

package/plugins/dataProvider/query/crud.js

@@ -249,7 +249,7 @@ function filterChangesForBatchedServerUpdate(hot, changes) {
         if (col === undefined || col < 0) {
             return false;
         }
-        return hot.getCellMeta(c[0], col).valid !== false;
+        return hot.getCellMetaTransient(c[0], col).valid !== false;
     });
 }
 function buildManualUpdateRowPayloads(hot, rowIdOption, rows) {

package/plugins/dataProvider/query/crud.mjs

@@ -271,7 +271,7 @@ import { DATA_PROVIDER_BATCH_UPDATE_SOURCES, DATA_PROVIDER_ERROR_UPDATE_MISSING_
         if (col === undefined || col < 0) {
             return false;
         }
-        return hot.getCellMeta(c[0], col).valid !== false;
+        return hot.getCellMetaTransient(c[0], col).valid !== false;
     });
 }
 /**

package/plugins/dialog/dialog.js

@@ -24,6 +24,8 @@ const _errors = require("../../helpers/errors");
 const _ui = require("./ui");
 const _object = require("../../helpers/object");
 const _element = require("../../helpers/dom/element");
+const _uiButton = require("../../helpers/uiButton");
+const _sanitizer = require("../../utils/sanitizer");
 const _constants = /*#__PURE__*/ _interop_require_wildcard(require("../../i18n/constants"));
 function _check_private_redeclaration(obj, privateCollection) {
     if (privateCollection.has(obj)) {
@@ -181,10 +183,7 @@ class Dialog extends _base.BasePlugin {
             template: (value)=>(0, _object.isPlainObject)(value) && typeof [
                     'alert',
                     'confirm'
-                ].includes(String(value.type)) && typeof value.title === 'string' && (typeof value?.description === 'undefined' || typeof value?.description === 'string') && (typeof value?.buttons === 'undefined' || Array.isArray(value?.buttons) && value.buttons.every((item)=>(0, _object.isPlainObject)(item) && typeof item.text === 'string' && [
-                        'primary',
-                        'secondary'
-                    ].includes(String(item.type)) && (typeof item.callback === 'undefined' || typeof item.callback === 'function'))),
+                ].includes(String(value.type)) && typeof value.title === 'string' && (typeof value?.description === 'undefined' || typeof value?.description === 'string') && (typeof value?.buttons === 'undefined' || Array.isArray(value?.buttons) && value.buttons.every((item)=>(0, _object.isPlainObject)(item) && typeof item.text === 'string' && (0, _uiButton.isButtonType)(item.type) && (typeof item.callback === 'undefined' || typeof item.callback === 'function'))),
             content: (value)=>typeof value === 'string' || (0, _element.isHTMLElement)(value) || typeof DocumentFragment !== 'undefined' && value instanceof DocumentFragment,
             customClassName: (value)=>typeof value === 'string',
             background: (value)=>typeof value === 'string' && [
@@ -216,7 +215,8 @@ class Dialog extends _base.BasePlugin {
         if (!_class_private_field_get(this, _ui1)) {
             _class_private_field_set(this, _ui1, new _ui.DialogUI({
                 overlayContainer: this.hot.rootOverlaysElement,
-                sanitizer: this.hot.getSettings().sanitizer,
+                sanitizer: (0, _sanitizer.getSanitizer)(this.hot),
+                warnScope: this.hot.rootElement,
                 isRtl: this.hot.isRtl()
             }));
         }
@@ -360,9 +360,14 @@ class Dialog extends _base.BasePlugin {
         }
         if (templateValue) {
             const template = templateValue;
+            // `id` is assigned AFTER the spread on purpose. The template interpolates it into the `id`
+            // attribute of its title and description elements, so a caller-supplied `template.id`
+            // carrying a quote used to break out of that attribute. A benign custom value was no good
+            // either: two grids configured with the same one emitted duplicate element ids into a single
+            // document. The grid's own GUID always wins, and it cannot collide.
             _class_private_field_get(this, _ui1).useTemplate(template.type, {
-                id: this.hot.guid,
-                ...template
+                ...template,
+                id: this.hot.guid
             });
         } else {
             _class_private_field_get(this, _ui1).useDefaultTemplate();
@@ -521,9 +526,9 @@ function registerFocusScope() {
             const focusableElements = _class_private_field_get(this, _ui1).getFocusableElements();
             if (focusableElements.length > 0) {
                 if (focusSource === 'tab_from_above') {
-                    focusableElements.at(0)?.focus();
+                    focusableElements[0]?.focus();
                 } else if (focusSource === 'tab_from_below') {
-                    focusableElements.at(-1)?.focus();
+                    focusableElements[focusableElements.length - 1]?.focus();
                 }
             } else if (focusSource !== 'tab_from_above' && focusSource !== 'tab_from_below' && isListening && !_class_private_field_get(this, _ui1).getContainer().contains(this.hot.rootDocument.activeElement)) {
                 _class_private_field_get(this, _ui1).getContainer().focus();

package/plugins/dialog/dialog.mjs

@@ -53,6 +53,8 @@ import { throwWithCause } from '../../helpers/errors.mjs';
 import { DialogUI } from './ui.mjs';
 import { isObject, isPlainObject } from '../../helpers/object.mjs';
 import { isHTMLElement } from '../../helpers/dom/element.mjs';
+import { isButtonType } from '../../helpers/uiButton.mjs';
+import { getSanitizer } from '../../utils/sanitizer.mjs';
 import * as C from '../../i18n/constants.mjs';
 export const PLUGIN_KEY = 'dialog';
 export const PLUGIN_PRIORITY = 360;
@@ -267,10 +269,7 @@ var /**
             template: (value)=>isPlainObject(value) && typeof [
                     'alert',
                     'confirm'
-                ].includes(String(value.type)) && typeof value.title === 'string' && (typeof value?.description === 'undefined' || typeof value?.description === 'string') && (typeof value?.buttons === 'undefined' || Array.isArray(value?.buttons) && value.buttons.every((item)=>isPlainObject(item) && typeof item.text === 'string' && [
-                        'primary',
-                        'secondary'
-                    ].includes(String(item.type)) && (typeof item.callback === 'undefined' || typeof item.callback === 'function'))),
+                ].includes(String(value.type)) && typeof value.title === 'string' && (typeof value?.description === 'undefined' || typeof value?.description === 'string') && (typeof value?.buttons === 'undefined' || Array.isArray(value?.buttons) && value.buttons.every((item)=>isPlainObject(item) && typeof item.text === 'string' && isButtonType(item.type) && (typeof item.callback === 'undefined' || typeof item.callback === 'function'))),
             content: (value)=>typeof value === 'string' || isHTMLElement(value) || typeof DocumentFragment !== 'undefined' && value instanceof DocumentFragment,
             customClassName: (value)=>typeof value === 'string',
             background: (value)=>typeof value === 'string' && [
@@ -302,7 +301,8 @@ var /**
         if (!_class_private_field_get(this, _ui)) {
             _class_private_field_set(this, _ui, new DialogUI({
                 overlayContainer: this.hot.rootOverlaysElement,
-                sanitizer: this.hot.getSettings().sanitizer,
+                sanitizer: getSanitizer(this.hot),
+                warnScope: this.hot.rootElement,
                 isRtl: this.hot.isRtl()
             }));
         }
@@ -446,9 +446,14 @@ var /**
         }
         if (templateValue) {
             const template = templateValue;
+            // `id` is assigned AFTER the spread on purpose. The template interpolates it into the `id`
+            // attribute of its title and description elements, so a caller-supplied `template.id`
+            // carrying a quote used to break out of that attribute. A benign custom value was no good
+            // either: two grids configured with the same one emitted duplicate element ids into a single
+            // document. The grid's own GUID always wins, and it cannot collide.
             _class_private_field_get(this, _ui).useTemplate(template.type, {
-                id: this.hot.guid,
-                ...template
+                ...template,
+                id: this.hot.guid
             });
         } else {
             _class_private_field_get(this, _ui).useDefaultTemplate();
@@ -607,9 +612,9 @@ function registerFocusScope() {
             const focusableElements = _class_private_field_get(this, _ui).getFocusableElements();
             if (focusableElements.length > 0) {
                 if (focusSource === 'tab_from_above') {
-                    focusableElements.at(0)?.focus();
+                    focusableElements[0]?.focus();
                 } else if (focusSource === 'tab_from_below') {
-                    focusableElements.at(-1)?.focus();
+                    focusableElements[focusableElements.length - 1]?.focus();
                 }
             } else if (focusSource !== 'tab_from_above' && focusSource !== 'tab_from_below' && isListening && !_class_private_field_get(this, _ui).getContainer().contains(this.hot.rootDocument.activeElement)) {
                 _class_private_field_get(this, _ui).getContainer().focus();

package/plugins/dialog/templates/confirm.d.ts

@@ -16,7 +16,7 @@ export declare function confirmTemplate({ id, title, description, buttons }: {
     title?: string;
     description?: string;
     buttons?: Array<{
-        type: string;
+        type: unknown;
         text: string;
         callback?: Function;
     }>;

package/plugins/dialog/templates/confirm.js

@@ -12,6 +12,7 @@ const _constants = require("../constants");
 const _errors = require("../../../helpers/errors");
 const _string = require("../../../helpers/string");
 const _templateLiteralTag = require("../../../helpers/templateLiteralTag");
+const _uiButton = require("../../../helpers/uiButton");
 function confirmTemplate({ id = '', title = '', description = '', buttons = [] }) {
     /**
    * Returns the HTML string for the template.
@@ -31,7 +32,7 @@ function confirmTemplate({ id = '', title = '', description = '', buttons = [] }
         ${buttons.length > 0 ? `
           <div data-ref="buttonsContainer" class="${_constants.DIALOG_CLASS_NAME}__buttons">
             ${buttons.map((button)=>`
-              <button class="ht-button ht-button--${button.type}">${(0, _string.stripTags)(button.text)}</button>
+              <button class="ht-button ht-button--${(0, _uiButton.resolveButtonType)(button.type)}">${(0, _string.stripTags)(button.text)}</button>
             `).join('')}
           </div>
         ` : ''}

package/plugins/dialog/templates/confirm.mjs

@@ -2,6 +2,7 @@ import { DIALOG_CLASS_NAME } from '../constants.mjs';
 import { throwWithCause } from '../../../helpers/errors.mjs';
 import { stripTags } from '../../../helpers/string.mjs';
 import { html } from '../../../helpers/templateLiteralTag.mjs';
+import { resolveButtonType } from '../../../helpers/uiButton.mjs';
 /**
  * The `confirmTemplate` function returns a HTML string with the confirm template.
  *
@@ -33,7 +34,7 @@ import { html } from '../../../helpers/templateLiteralTag.mjs';
         ${buttons.length > 0 ? `
           <div data-ref="buttonsContainer" class="${DIALOG_CLASS_NAME}__buttons">
             ${buttons.map((button)=>`
-              <button class="ht-button ht-button--${button.type}">${stripTags(button.text)}</button>
+              <button class="ht-button ht-button--${resolveButtonType(button.type)}">${stripTags(button.text)}</button>
             `).join('')}
           </div>
         ` : ''}