handsontable 16.1.1-next-895fbb8-20250923 → 16.2.0-next-216dbd0-20251112

package/plugins/base/base.mjs

@@ -2,6 +2,7 @@ import "core-js/modules/es.error.cause.js";
 import "core-js/modules/es.array.push.js";
 import "core-js/modules/esnext.iterator.constructor.js";
 import "core-js/modules/esnext.iterator.for-each.js";
+import "core-js/modules/esnext.iterator.map.js";
 function _classPrivateMethodInitSpec(e, a) { _checkPrivateRedeclaration(e, a), a.add(e); }
 function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
@@ -203,32 +204,57 @@ export class BasePlugin {
    * @returns {*}
    */
   getSetting(settingName) {
+    var _this = this;
     const defaultSettings = this.constructor.DEFAULT_SETTINGS;
+    const settingsValidators = this.constructor.SETTINGS_VALIDATORS;
     if (settingName === undefined) {
       if (isObject(_classPrivateFieldGet(_pluginSettings, this))) {
         return assignObjectDefaults(_classPrivateFieldGet(_pluginSettings, this), defaultSettings);
       }
       return _classPrivateFieldGet(_pluginSettings, this);
     }
+    let settingValue;
     if ((Array.isArray(_classPrivateFieldGet(_pluginSettings, this)) || isObject(_classPrivateFieldGet(_pluginSettings, this))) && defaultSettings[defaultMainSettingSymbol] === settingName) {
-      var _classPrivateFieldGet2;
       if (Array.isArray(_classPrivateFieldGet(_pluginSettings, this))) {
-        return _classPrivateFieldGet(_pluginSettings, this);
+        settingValue = _classPrivateFieldGet(_pluginSettings, this);
+      } else {
+        var _classPrivateFieldGet2;
+        settingValue = (_classPrivateFieldGet2 = _classPrivateFieldGet(_pluginSettings, this)[settingName]) !== null && _classPrivateFieldGet2 !== void 0 ? _classPrivateFieldGet2 : defaultSettings[settingName];
       }
-      return (_classPrivateFieldGet2 = _classPrivateFieldGet(_pluginSettings, this)[settingName]) !== null && _classPrivateFieldGet2 !== void 0 ? _classPrivateFieldGet2 : defaultSettings[settingName];
-    }
-    if (settingName.includes('.')) {
+    } else if (settingName.includes('.')) {
       const pluginValue = getProperty(_classPrivateFieldGet(_pluginSettings, this), settingName);
       const defaultValue = getProperty(defaultSettings, settingName);
       if (isObject(pluginValue)) {
-        return assignObjectDefaults(pluginValue, defaultValue);
+        settingValue = assignObjectDefaults(pluginValue, defaultValue);
+      } else {
+        settingValue = pluginValue !== undefined ? pluginValue : defaultValue;
       }
-      return pluginValue !== undefined ? pluginValue : defaultValue;
+    } else if (isObject(_classPrivateFieldGet(_pluginSettings, this))) {
+      settingValue = assignObjectDefaults(_classPrivateFieldGet(_pluginSettings, this), defaultSettings)[settingName];
+    } else {
+      settingValue = defaultSettings[settingName];
     }
-    if (isObject(_classPrivateFieldGet(_pluginSettings, this))) {
-      return assignObjectDefaults(_classPrivateFieldGet(_pluginSettings, this), defaultSettings)[settingName];
+    if (typeof settingValue === 'function' && settingsValidators && typeof settingsValidators === 'object') {
+      const validator = settingsValidators[settingName];
+      if (validator && typeof validator === 'function') {
+        return function () {
+          for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+            args[_key] = arguments[_key];
+          }
+          const result = settingValue(...args);
+          const isValid = validator(result);
+          if (isValid === false) {
+            const formattedArgs = args.map(arg => typeof arg === 'string' ? `"${arg}"` : '').join(', ');
+            const source = args.length > 0 ? formattedArgs : '';
+            warn(`${_this.pluginName} Plugin: "${settingName}" function (${source}) result \
+               is not valid and will be ignored.`);
+            return;
+          }
+          return result;
+        };
+      }
     }
-    return defaultSettings[settingName];
+    return settingValue;
   }
 
   /**

package/plugins/columnSummary/columnSummary.d.ts

@@ -8,7 +8,7 @@ export type DetailedSettings = {
   reversedRowCoords?: boolean;
   suppressDataTypeErrors?: boolean;
   readOnly?: boolean;
-  roundFloat?: boolean | number;
+  roundFloat?: boolean | number | 'auto';
   ranges?: number[][];
   sourceColumn?: number;
 } & ({
@@ -27,7 +27,7 @@ export interface Endpoint {
   reversedRowCoords: boolean;
   suppressDataTypeErrors: boolean;
   readOnly: boolean;
-  roundFloat: boolean | number;
+  roundFloat: boolean | number | 'auto';
   ranges: number[][];
   sourceColumn: number;
   type: 'sum' | 'min' | 'max' | 'count' | 'average' | 'custom';

package/plugins/columnSummary/columnSummary.js

@@ -198,37 +198,49 @@ class ColumnSummary extends _base.BasePlugin {
       }
       return _assertClassBrand(_ColumnSummary_brand, _this, _onAfterUpdateSettings).call(_this, ...args);
     });
+    this.addHook('afterLoadData', function () {
+      for (var _len4 = arguments.length, args = new Array(_len4), _key4 = 0; _key4 < _len4; _key4++) {
+        args[_key4] = arguments[_key4];
+      }
+      return _assertClassBrand(_ColumnSummary_brand, _this, _onAfterLoadData).call(_this, ...args);
+    });
+    this.addHook('afterUpdateData', function () {
+      for (var _len5 = arguments.length, args = new Array(_len5), _key5 = 0; _key5 < _len5; _key5++) {
+        args[_key5] = arguments[_key5];
+      }
+      return _assertClassBrand(_ColumnSummary_brand, _this, _onAfterUpdateData).call(_this, ...args);
+    });
     this.addHook('beforeCreateRow', (index, amount, source) => this.endpoints.resetSetupBeforeStructureAlteration('insert_row', index, amount, null, source)); // eslint-disable-line max-len
     this.addHook('beforeCreateCol', (index, amount, source) => this.endpoints.resetSetupBeforeStructureAlteration('insert_col', index, amount, null, source)); // eslint-disable-line max-len
     this.addHook('beforeRemoveRow', function () {
-      for (var _len4 = arguments.length, args = new Array(_len4), _key4 = 0; _key4 < _len4; _key4++) {
-        args[_key4] = arguments[_key4];
+      for (var _len6 = arguments.length, args = new Array(_len6), _key6 = 0; _key6 < _len6; _key6++) {
+        args[_key6] = arguments[_key6];
       }
       return _this.endpoints.resetSetupBeforeStructureAlteration('remove_row', ...args);
     });
     this.addHook('beforeRemoveCol', function () {
-      for (var _len5 = arguments.length, args = new Array(_len5), _key5 = 0; _key5 < _len5; _key5++) {
-        args[_key5] = arguments[_key5];
+      for (var _len7 = arguments.length, args = new Array(_len7), _key7 = 0; _key7 < _len7; _key7++) {
+        args[_key7] = arguments[_key7];
       }
       return _this.endpoints.resetSetupBeforeStructureAlteration('remove_col', ...args);
     });
     this.addHook('afterCreateRow', (index, amount, source) => this.endpoints.resetSetupAfterStructureAlteration('insert_row', index, amount, null, source)); // eslint-disable-line max-len
     this.addHook('afterCreateCol', (index, amount, source) => this.endpoints.resetSetupAfterStructureAlteration('insert_col', index, amount, null, source)); // eslint-disable-line max-len
     this.addHook('afterRemoveRow', function () {
-      for (var _len6 = arguments.length, args = new Array(_len6), _key6 = 0; _key6 < _len6; _key6++) {
-        args[_key6] = arguments[_key6];
+      for (var _len8 = arguments.length, args = new Array(_len8), _key8 = 0; _key8 < _len8; _key8++) {
+        args[_key8] = arguments[_key8];
       }
       return _this.endpoints.resetSetupAfterStructureAlteration('remove_row', ...args);
     });
     this.addHook('afterRemoveCol', function () {
-      for (var _len7 = arguments.length, args = new Array(_len7), _key7 = 0; _key7 < _len7; _key7++) {
-        args[_key7] = arguments[_key7];
+      for (var _len9 = arguments.length, args = new Array(_len9), _key9 = 0; _key9 < _len9; _key9++) {
+        args[_key9] = arguments[_key9];
       }
       return _this.endpoints.resetSetupAfterStructureAlteration('remove_col', ...args);
     });
     this.addHook('afterRowMove', function () {
-      for (var _len8 = arguments.length, args = new Array(_len8), _key8 = 0; _key8 < _len8; _key8++) {
-        args[_key8] = arguments[_key8];
+      for (var _len0 = arguments.length, args = new Array(_len0), _key0 = 0; _key0 < _len0; _key0++) {
+        args[_key0] = arguments[_key0];
       }
       return _assertClassBrand(_ColumnSummary_brand, _this, _onAfterRowMove).call(_this, ...args);
     });
@@ -515,6 +527,28 @@ function _onAfterChange(changes, source) {
     this.endpoints.refreshChangedEndpoints(changes);
   }
 }
+/**
+ * `afterLoadData` hook callback.
+ *
+ * @param {Array} data The updated data.
+ * @param {boolean} firstRun `true` if called on initial load, `false` otherwise.
+ */
+function _onAfterLoadData(data, firstRun) {
+  if (!firstRun) {
+    this.endpoints.refreshAllEndpoints();
+  }
+}
+/**
+ * `afterUpdateData` hook callback.
+ *
+ * @param {Array} data The updated data.
+ * @param {boolean} firstRun `true` if called on initial load, `false` otherwise.
+ */
+function _onAfterUpdateData(data, firstRun) {
+  if (!firstRun) {
+    this.endpoints.refreshAllEndpoints();
+  }
+}
 /**
  * `beforeRowMove` hook callback.
  *

package/plugins/columnSummary/columnSummary.mjs

@@ -194,37 +194,49 @@ export class ColumnSummary extends BasePlugin {
       }
       return _assertClassBrand(_ColumnSummary_brand, _this, _onAfterUpdateSettings).call(_this, ...args);
     });
+    this.addHook('afterLoadData', function () {
+      for (var _len4 = arguments.length, args = new Array(_len4), _key4 = 0; _key4 < _len4; _key4++) {
+        args[_key4] = arguments[_key4];
+      }
+      return _assertClassBrand(_ColumnSummary_brand, _this, _onAfterLoadData).call(_this, ...args);
+    });
+    this.addHook('afterUpdateData', function () {
+      for (var _len5 = arguments.length, args = new Array(_len5), _key5 = 0; _key5 < _len5; _key5++) {
+        args[_key5] = arguments[_key5];
+      }
+      return _assertClassBrand(_ColumnSummary_brand, _this, _onAfterUpdateData).call(_this, ...args);
+    });
     this.addHook('beforeCreateRow', (index, amount, source) => this.endpoints.resetSetupBeforeStructureAlteration('insert_row', index, amount, null, source)); // eslint-disable-line max-len
     this.addHook('beforeCreateCol', (index, amount, source) => this.endpoints.resetSetupBeforeStructureAlteration('insert_col', index, amount, null, source)); // eslint-disable-line max-len
     this.addHook('beforeRemoveRow', function () {
-      for (var _len4 = arguments.length, args = new Array(_len4), _key4 = 0; _key4 < _len4; _key4++) {
-        args[_key4] = arguments[_key4];
+      for (var _len6 = arguments.length, args = new Array(_len6), _key6 = 0; _key6 < _len6; _key6++) {
+        args[_key6] = arguments[_key6];
       }
       return _this.endpoints.resetSetupBeforeStructureAlteration('remove_row', ...args);
     });
     this.addHook('beforeRemoveCol', function () {
-      for (var _len5 = arguments.length, args = new Array(_len5), _key5 = 0; _key5 < _len5; _key5++) {
-        args[_key5] = arguments[_key5];
+      for (var _len7 = arguments.length, args = new Array(_len7), _key7 = 0; _key7 < _len7; _key7++) {
+        args[_key7] = arguments[_key7];
       }
       return _this.endpoints.resetSetupBeforeStructureAlteration('remove_col', ...args);
     });
     this.addHook('afterCreateRow', (index, amount, source) => this.endpoints.resetSetupAfterStructureAlteration('insert_row', index, amount, null, source)); // eslint-disable-line max-len
     this.addHook('afterCreateCol', (index, amount, source) => this.endpoints.resetSetupAfterStructureAlteration('insert_col', index, amount, null, source)); // eslint-disable-line max-len
     this.addHook('afterRemoveRow', function () {
-      for (var _len6 = arguments.length, args = new Array(_len6), _key6 = 0; _key6 < _len6; _key6++) {
-        args[_key6] = arguments[_key6];
+      for (var _len8 = arguments.length, args = new Array(_len8), _key8 = 0; _key8 < _len8; _key8++) {
+        args[_key8] = arguments[_key8];
       }
       return _this.endpoints.resetSetupAfterStructureAlteration('remove_row', ...args);
     });
     this.addHook('afterRemoveCol', function () {
-      for (var _len7 = arguments.length, args = new Array(_len7), _key7 = 0; _key7 < _len7; _key7++) {
-        args[_key7] = arguments[_key7];
+      for (var _len9 = arguments.length, args = new Array(_len9), _key9 = 0; _key9 < _len9; _key9++) {
+        args[_key9] = arguments[_key9];
       }
       return _this.endpoints.resetSetupAfterStructureAlteration('remove_col', ...args);
     });
     this.addHook('afterRowMove', function () {
-      for (var _len8 = arguments.length, args = new Array(_len8), _key8 = 0; _key8 < _len8; _key8++) {
-        args[_key8] = arguments[_key8];
+      for (var _len0 = arguments.length, args = new Array(_len0), _key0 = 0; _key0 < _len0; _key0++) {
+        args[_key0] = arguments[_key0];
       }
       return _assertClassBrand(_ColumnSummary_brand, _this, _onAfterRowMove).call(_this, ...args);
     });
@@ -510,6 +522,28 @@ function _onAfterChange(changes, source) {
     this.endpoints.refreshChangedEndpoints(changes);
   }
 }
+/**
+ * `afterLoadData` hook callback.
+ *
+ * @param {Array} data The updated data.
+ * @param {boolean} firstRun `true` if called on initial load, `false` otherwise.
+ */
+function _onAfterLoadData(data, firstRun) {
+  if (!firstRun) {
+    this.endpoints.refreshAllEndpoints();
+  }
+}
+/**
+ * `afterUpdateData` hook callback.
+ *
+ * @param {Array} data The updated data.
+ * @param {boolean} firstRun `true` if called on initial load, `false` otherwise.
+ */
+function _onAfterUpdateData(data, firstRun) {
+  if (!firstRun) {
+    this.endpoints.refreshAllEndpoints();
+  }
+}
 /**
  * `beforeRowMove` hook callback.
  *

package/plugins/columnSummary/endpoints.js

@@ -8,6 +8,7 @@ require("core-js/modules/esnext.iterator.for-each.js");
 require("core-js/modules/esnext.iterator.some.js");
 var _array = require("../../helpers/array");
 var _console = require("../../helpers/console");
+var _utils = require("./utils");
 function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
 function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
@@ -229,6 +230,10 @@ class Endpoints {
    */
   resetSetupAfterStructureAlteration(action, index, number, logicRows, source) {
     let forceRefresh = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : true;
+    // Automatic row/column creation (`minSpareRows`/`minSpareCols`) should not trigger the endpoint recalculation.
+    if (source === 'auto') {
+      return;
+    }
     if (this.settingsType === 'function') {
       // We need to run it on a next avaiable hook, because the TrimRows' `afterCreateRow` hook triggers after this one,
       // and it needs to be run to properly calculate the endpoint value.
@@ -398,7 +403,9 @@ class Endpoints {
     (0, _array.arrayEach)(endpoints, endpoint => {
       this.resetEndpointValue(endpoint, useOffset);
     });
-    this.hot.setDataAtCell(this.cellsToSetCache, 'ColumnSummary.reset');
+    if (this.cellsToSetCache.length) {
+      this.hot.setDataAtCell(this.cellsToSetCache, 'ColumnSummary.reset');
+    }
     this.cellsToSetCache = [];
   }
 
@@ -413,7 +420,9 @@ class Endpoints {
       this.setEndpointValue(value, 'init');
     });
     this.currentEndpoint = null;
-    this.hot.setDataAtCell(this.cellsToSetCache, 'ColumnSummary.reset');
+    if (this.cellsToSetCache.length) {
+      this.hot.setDataAtCell(this.cellsToSetCache, 'ColumnSummary.reset');
+    }
     this.cellsToSetCache = [];
   }
 
@@ -439,7 +448,9 @@ class Endpoints {
     (0, _array.arrayEach)(needToRefresh, value => {
       this.refreshEndpoint(this.getEndpoint(value));
     });
-    this.hot.setDataAtCell(this.cellsToSetCache, 'ColumnSummary.reset');
+    if (this.cellsToSetCache.length) {
+      this.hot.setDataAtCell(this.cellsToSetCache, 'ColumnSummary.reset');
+    }
     this.cellsToSetCache = [];
   }
 
@@ -505,16 +516,7 @@ class Endpoints {
         cellMeta.className = 'columnSummaryResult';
       }
     }
-    if ((endpoint.roundFloat === true || Number.isInteger(endpoint.roundFloat)) && !isNaN(endpoint.result)) {
-      const roundFloatValue = endpoint.roundFloat;
-      let decimalPlacesCount = 0;
-
-      // `toFixed` method accepts only values between 0 and 100
-      if (Number.isInteger(roundFloatValue)) {
-        decimalPlacesCount = Math.min(Math.max(0, roundFloatValue), 100);
-      }
-      endpoint.result = endpoint.result.toFixed(decimalPlacesCount);
-    }
+    endpoint.result = (0, _utils.roundFloat)(endpoint.result, endpoint.roundFloat);
     if (render) {
       this.hot.setDataAtCell(visualEndpointRowIndex, endpoint.destinationColumn, endpoint.result, 'ColumnSummary.set');
     } else {

package/plugins/columnSummary/endpoints.mjs

@@ -8,6 +8,7 @@ function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol"
 function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import { arrayEach } from "../../helpers/array.mjs";
 import { warn } from "../../helpers/console.mjs";
+import { roundFloat } from "./utils.mjs";
 /**
  * Class used to make all endpoint-related operations.
  *
@@ -226,6 +227,10 @@ class Endpoints {
    */
   resetSetupAfterStructureAlteration(action, index, number, logicRows, source) {
     let forceRefresh = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : true;
+    // Automatic row/column creation (`minSpareRows`/`minSpareCols`) should not trigger the endpoint recalculation.
+    if (source === 'auto') {
+      return;
+    }
     if (this.settingsType === 'function') {
       // We need to run it on a next avaiable hook, because the TrimRows' `afterCreateRow` hook triggers after this one,
       // and it needs to be run to properly calculate the endpoint value.
@@ -395,7 +400,9 @@ class Endpoints {
     arrayEach(endpoints, endpoint => {
       this.resetEndpointValue(endpoint, useOffset);
     });
-    this.hot.setDataAtCell(this.cellsToSetCache, 'ColumnSummary.reset');
+    if (this.cellsToSetCache.length) {
+      this.hot.setDataAtCell(this.cellsToSetCache, 'ColumnSummary.reset');
+    }
     this.cellsToSetCache = [];
   }
 
@@ -410,7 +417,9 @@ class Endpoints {
       this.setEndpointValue(value, 'init');
     });
     this.currentEndpoint = null;
-    this.hot.setDataAtCell(this.cellsToSetCache, 'ColumnSummary.reset');
+    if (this.cellsToSetCache.length) {
+      this.hot.setDataAtCell(this.cellsToSetCache, 'ColumnSummary.reset');
+    }
     this.cellsToSetCache = [];
   }
 
@@ -436,7 +445,9 @@ class Endpoints {
     arrayEach(needToRefresh, value => {
       this.refreshEndpoint(this.getEndpoint(value));
     });
-    this.hot.setDataAtCell(this.cellsToSetCache, 'ColumnSummary.reset');
+    if (this.cellsToSetCache.length) {
+      this.hot.setDataAtCell(this.cellsToSetCache, 'ColumnSummary.reset');
+    }
     this.cellsToSetCache = [];
   }
 
@@ -502,16 +513,7 @@ class Endpoints {
         cellMeta.className = 'columnSummaryResult';
       }
     }
-    if ((endpoint.roundFloat === true || Number.isInteger(endpoint.roundFloat)) && !isNaN(endpoint.result)) {
-      const roundFloatValue = endpoint.roundFloat;
-      let decimalPlacesCount = 0;
-
-      // `toFixed` method accepts only values between 0 and 100
-      if (Number.isInteger(roundFloatValue)) {
-        decimalPlacesCount = Math.min(Math.max(0, roundFloatValue), 100);
-      }
-      endpoint.result = endpoint.result.toFixed(decimalPlacesCount);
-    }
+    endpoint.result = roundFloat(endpoint.result, endpoint.roundFloat);
     if (render) {
       this.hot.setDataAtCell(visualEndpointRowIndex, endpoint.destinationColumn, endpoint.result, 'ColumnSummary.set');
     } else {

package/plugins/columnSummary/utils.js

@@ -2,6 +2,7 @@
 
 exports.__esModule = true;
 exports.isNullishOrNaN = isNullishOrNaN;
+exports.roundFloat = roundFloat;
 /**
  * Returns `true` if the value is one of the type: `null`, `undefined` or `NaN`.
  *
@@ -10,4 +11,34 @@ exports.isNullishOrNaN = isNullishOrNaN;
  */
 function isNullishOrNaN(value) {
   return value === null || value === undefined || isNaN(value);
+}
+
+/**
+ * Rounds a number to a specific number of decimal places.
+ *
+ * @param {number} value The value to round.
+ * @param {number|boolean|string|undefined} [option] Either a number of decimal places to round to, a boolean or "auto".
+ * @returns {string|number} The (possibly) rounded number as a string (for displaying the correct precision).
+ */
+function roundFloat(value, option) {
+  if (typeof value !== 'number') {
+    return value;
+  }
+  const stringifyValue = number => number.toString();
+  switch (typeof option) {
+    case 'number':
+      return stringifyValue(value.toFixed(Math.min(Math.max(0, option), 100)));
+    case 'boolean':
+      return option ? stringifyValue(Math.round(value)) : value;
+    case 'string':
+      if (option === 'auto') {
+        const integerDigits = Math.round(value).toString().length;
+
+        // Make the entire number fit into 8 digits
+        return stringifyValue(value.toFixed(8 - integerDigits));
+      }
+      return value;
+    default:
+      return value;
+  }
 }

package/plugins/columnSummary/utils.mjs

@@ -6,4 +6,34 @@
  */
 export function isNullishOrNaN(value) {
   return value === null || value === undefined || isNaN(value);
+}
+
+/**
+ * Rounds a number to a specific number of decimal places.
+ *
+ * @param {number} value The value to round.
+ * @param {number|boolean|string|undefined} [option] Either a number of decimal places to round to, a boolean or "auto".
+ * @returns {string|number} The (possibly) rounded number as a string (for displaying the correct precision).
+ */
+export function roundFloat(value, option) {
+  if (typeof value !== 'number') {
+    return value;
+  }
+  const stringifyValue = number => number.toString();
+  switch (typeof option) {
+    case 'number':
+      return stringifyValue(value.toFixed(Math.min(Math.max(0, option), 100)));
+    case 'boolean':
+      return option ? stringifyValue(Math.round(value)) : value;
+    case 'string':
+      if (option === 'auto') {
+        const integerDigits = Math.round(value).toString().length;
+
+        // Make the entire number fit into 8 digits
+        return stringifyValue(value.toFixed(8 - integerDigits));
+      }
+      return value;
+    default:
+      return value;
+  }
 }

package/plugins/customBorders/customBorders.d.ts

@@ -7,6 +7,7 @@ export interface BorderOptions {
   width?: number;
   color?: string;
   hide?: boolean;
+  style?: 'dashed' | 'dotted' | 'solid';
 }
 export interface BorderRange {
   range: {

package/plugins/customBorders/customBorders.js

@@ -3,14 +3,18 @@
 exports.__esModule = true;
 require("core-js/modules/es.error.cause.js");
 require("core-js/modules/es.array.push.js");
+require("core-js/modules/esnext.iterator.constructor.js");
+require("core-js/modules/esnext.iterator.for-each.js");
 var _base = require("../base");
 var _object = require("../../helpers/object");
+var _console = require("../../helpers/console");
 var _number = require("../../helpers/number");
 var _array = require("../../helpers/array");
 var C = _interopRequireWildcard(require("../../i18n/constants"));
 var _contextMenuItem = require("./contextMenuItem");
 var _utils = require("./utils");
 var _selection = require("../../selection");
+var _mixed = require("../../helpers/mixed");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 function _classPrivateMethodInitSpec(e, a) { _checkPrivateRedeclaration(e, a), a.add(e); }
 function _checkPrivateRedeclaration(e, t) { if (t.has(e)) throw new TypeError("Cannot initialize the same private elements twice on an object"); }
@@ -20,6 +24,7 @@ function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e =
 function _assertClassBrand(e, t, n) { if ("function" == typeof e ? e === t : e.has(t)) return arguments.length < 3 ? t : n; throw new TypeError("Private element is not present on this object"); }
 const PLUGIN_KEY = exports.PLUGIN_KEY = 'customBorders';
 const PLUGIN_PRIORITY = exports.PLUGIN_PRIORITY = 90;
+const SUPPORTED_STYLES = ['dashed', 'dotted', 'solid'];
 
 /* eslint-disable jsdoc/require-description-complete-sentence */
 
@@ -65,10 +70,12 @@ const PLUGIN_PRIORITY = exports.PLUGIN_PRIORITY = 90;
  *     start: {
  *       width: 2,
  *       color: 'red',
+ *       style: 'dotted'
  *     },
  *     end: {
  *       width: 1,
  *       color: 'green',
+ *       style: 'dashed'
  *     },
  *     top: '',
  *     bottom: '',
@@ -81,9 +88,10 @@ class CustomBorders extends _base.BasePlugin {
   constructor() {
     super(...arguments);
     /**
-     * Add border options to context menu.
+     * Validate the style settings. If the style value is not supported, the property is removed from the configuration.
      *
-     * @param {object} defaultOptions Context menu items.
+     * @private
+     * @param {object[]} customBorders The user defined custom border objects array.
      */
     _classPrivateMethodInitSpec(this, _CustomBorders_brand);
     /**
@@ -700,6 +708,7 @@ class CustomBorders extends _base.BasePlugin {
     if (this.hot.isRtl() && hasLeftOrRight) {
       throw new Error('The "left"/"right" properties are not supported for RTL. Please use option "start"/"end".');
     }
+    _assertClassBrand(_CustomBorders_brand, this, _validateStyleSettings).call(this, customBorders);
   }
   /**
    * Destroys the plugin instance.
@@ -709,6 +718,27 @@ class CustomBorders extends _base.BasePlugin {
   }
 }
 exports.CustomBorders = CustomBorders;
+function _validateStyleSettings(customBorders) {
+  customBorders.forEach(customBorder => {
+    Object.keys(customBorder).forEach(key => {
+      const style = customBorder[key].style;
+      if ((0, _mixed.isDefined)(style) && !SUPPORTED_STYLES.includes(style)) {
+        // eslint-disable-next-line max-len
+        (0, _console.warn)(`The "${style}" border style is not supported. Please use one of the following styles: ${SUPPORTED_STYLES.join(', ')}.
+The border style will be ignored.`);
+        delete customBorder[key].style;
+      } else if ((0, _mixed.isDefined)(style) && style === 'solid') {
+        // 'solid' is the default style
+        delete customBorder[key].style;
+      }
+    });
+  });
+}
+/**
+ * Add border options to context menu.
+ *
+ * @param {object} defaultOptions Context menu items.
+ */
 function _onAfterContextMenuDefaultOptions(defaultOptions) {
   if (!this.hot.getSettings()[PLUGIN_KEY]) {
     return;