handsontable 16.0.1-next-eee5f08-20250710 → 16.1.0-next-abd8f2e-20250904

package/editors/textEditor/textEditor.mjs

@@ -342,13 +342,6 @@ export class TextEditor extends BaseEditor {
     });
   }
 
-  /**
-   * Ugly hack for autocompleteEditor.
-   *
-   * @private
-   */
-  allowKeyEventPropagation() {}
-
   /**
    * Destroys the internal event manager and clears attached hooks.
    *

package/focusManager.js

@@ -178,7 +178,7 @@ class FocusManager {
   focusOnHighlightedCell(selectedCell) {
     const focusElement = element => {
       var _classPrivateFieldGet3, _classPrivateFieldGet4;
-      const currentHighlightCoords = (_classPrivateFieldGet3 = _classPrivateFieldGet(_hot, this).getSelectedRangeLast()) === null || _classPrivateFieldGet3 === void 0 ? void 0 : _classPrivateFieldGet3.highlight;
+      const currentHighlightCoords = (_classPrivateFieldGet3 = _classPrivateFieldGet(_hot, this).getSelectedRangeActive()) === null || _classPrivateFieldGet3 === void 0 ? void 0 : _classPrivateFieldGet3.highlight;
       if (!currentHighlightCoords) {
         return;
       }
@@ -227,7 +227,7 @@ class FocusManager {
 exports.FocusManager = FocusManager;
 function _getSelectedCell(callback) {
   var _classPrivateFieldGet8;
-  const highlight = (_classPrivateFieldGet8 = _classPrivateFieldGet(_hot, this).getSelectedRangeLast()) === null || _classPrivateFieldGet8 === void 0 ? void 0 : _classPrivateFieldGet8.highlight;
+  const highlight = (_classPrivateFieldGet8 = _classPrivateFieldGet(_hot, this).getSelectedRangeActive()) === null || _classPrivateFieldGet8 === void 0 ? void 0 : _classPrivateFieldGet8.highlight;
   if (!highlight || !_classPrivateFieldGet(_hot, this).selection.isCellVisible(highlight)) {
     callback(null);
     return;

package/focusManager.mjs

@@ -175,7 +175,7 @@ export class FocusManager {
   focusOnHighlightedCell(selectedCell) {
     const focusElement = element => {
       var _classPrivateFieldGet3, _classPrivateFieldGet4;
-      const currentHighlightCoords = (_classPrivateFieldGet3 = _classPrivateFieldGet(_hot, this).getSelectedRangeLast()) === null || _classPrivateFieldGet3 === void 0 ? void 0 : _classPrivateFieldGet3.highlight;
+      const currentHighlightCoords = (_classPrivateFieldGet3 = _classPrivateFieldGet(_hot, this).getSelectedRangeActive()) === null || _classPrivateFieldGet3 === void 0 ? void 0 : _classPrivateFieldGet3.highlight;
       if (!currentHighlightCoords) {
         return;
       }
@@ -223,7 +223,7 @@ export class FocusManager {
 }
 function _getSelectedCell(callback) {
   var _classPrivateFieldGet8;
-  const highlight = (_classPrivateFieldGet8 = _classPrivateFieldGet(_hot, this).getSelectedRangeLast()) === null || _classPrivateFieldGet8 === void 0 ? void 0 : _classPrivateFieldGet8.highlight;
+  const highlight = (_classPrivateFieldGet8 = _classPrivateFieldGet(_hot, this).getSelectedRangeActive()) === null || _classPrivateFieldGet8 === void 0 ? void 0 : _classPrivateFieldGet8.highlight;
   if (!highlight || !_classPrivateFieldGet(_hot, this).selection.isCellVisible(highlight)) {
     callback(null);
     return;

package/helpers/a11y.js

@@ -33,6 +33,10 @@ const A11Y_OPTION = () => ['role', 'option'];
 exports.A11Y_OPTION = A11Y_OPTION;
 const A11Y_CHECKBOX = () => ['role', 'checkbox'];
 exports.A11Y_CHECKBOX = A11Y_CHECKBOX;
+const A11Y_DIALOG = () => ['role', 'dialog'];
+exports.A11Y_DIALOG = A11Y_DIALOG;
+const A11Y_ALERTDIALOG = () => ['role', 'alertdialog'];
+exports.A11Y_ALERTDIALOG = A11Y_ALERTDIALOG;
 const A11Y_SCOPE_COL = () => ['scope', 'col'];
 exports.A11Y_SCOPE_COL = A11Y_SCOPE_COL;
 const A11Y_SCOPE_ROW = () => ['scope', 'row'];
@@ -41,9 +45,16 @@ const A11Y_TEXT = () => ['type', 'text'];
 exports.A11Y_TEXT = A11Y_TEXT;
 const A11Y_LABEL = val => ['aria-label', val];
 exports.A11Y_LABEL = A11Y_LABEL;
+const A11Y_LABELED_BY = val => ['aria-labelledby', val];
+exports.A11Y_LABELED_BY = A11Y_LABELED_BY;
+const A11Y_DESCRIBED_BY = val => ['aria-describedby', val];
+exports.A11Y_DESCRIBED_BY = A11Y_DESCRIBED_BY;
 const A11Y_HIDDEN = () => ['aria-hidden', 'true'];
 exports.A11Y_HIDDEN = A11Y_HIDDEN;
-const A11Y_DISABLED = () => ['aria-disabled', 'true'];
+const A11Y_DISABLED = function () {
+  let val = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+  return ['aria-disabled', val];
+};
 exports.A11Y_DISABLED = A11Y_DISABLED;
 const A11Y_MULTISELECTABLE = () => ['aria-multiselectable', 'true'];
 exports.A11Y_MULTISELECTABLE = A11Y_MULTISELECTABLE;
@@ -82,4 +93,6 @@ exports.A11Y_RELEVANT = A11Y_RELEVANT;
 const A11Y_SETSIZE = val => ['aria-setsize', val];
 exports.A11Y_SETSIZE = A11Y_SETSIZE;
 const A11Y_POSINSET = val => ['aria-posinset', val];
-exports.A11Y_POSINSET = A11Y_POSINSET;
+exports.A11Y_POSINSET = A11Y_POSINSET;
+const A11Y_MODAL = () => ['aria-modal', 'true'];
+exports.A11Y_MODAL = A11Y_MODAL;

package/helpers/a11y.mjs

@@ -14,12 +14,19 @@ export const A11Y_COMBOBOX = () => ['role', 'combobox'];
 export const A11Y_LISTBOX = () => ['role', 'listbox'];
 export const A11Y_OPTION = () => ['role', 'option'];
 export const A11Y_CHECKBOX = () => ['role', 'checkbox'];
+export const A11Y_DIALOG = () => ['role', 'dialog'];
+export const A11Y_ALERTDIALOG = () => ['role', 'alertdialog'];
 export const A11Y_SCOPE_COL = () => ['scope', 'col'];
 export const A11Y_SCOPE_ROW = () => ['scope', 'row'];
 export const A11Y_TEXT = () => ['type', 'text'];
 export const A11Y_LABEL = val => ['aria-label', val];
+export const A11Y_LABELED_BY = val => ['aria-labelledby', val];
+export const A11Y_DESCRIBED_BY = val => ['aria-describedby', val];
 export const A11Y_HIDDEN = () => ['aria-hidden', 'true'];
-export const A11Y_DISABLED = () => ['aria-disabled', 'true'];
+export const A11Y_DISABLED = function () {
+  let val = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+  return ['aria-disabled', val];
+};
 export const A11Y_MULTISELECTABLE = () => ['aria-multiselectable', 'true'];
 export const A11Y_HASPOPUP = val => ['aria-haspopup', val];
 export const A11Y_ROWCOUNT = val => ['aria-rowcount', val];
@@ -38,4 +45,5 @@ export const A11Y_ACTIVEDESCENDANT = val => ['aria-activedescendant', val];
 export const A11Y_LIVE = val => ['aria-live', val];
 export const A11Y_RELEVANT = val => ['aria-relevant', val];
 export const A11Y_SETSIZE = val => ['aria-setsize', val];
-export const A11Y_POSINSET = val => ['aria-posinset', val];
+export const A11Y_POSINSET = val => ['aria-posinset', val];
+export const A11Y_MODAL = () => ['aria-modal', 'true'];

package/helpers/console.js

@@ -1,6 +1,7 @@
 "use strict";
 
 exports.__esModule = true;
+exports.deprecatedWarn = deprecatedWarn;
 exports.error = error;
 exports.info = info;
 exports.log = log;
@@ -38,6 +39,17 @@ function warn() {
   }
 }
 
+/**
+ * Logs deprecated warn to the console if the `console` object is exposed.
+ *
+ * @param {string} message The message to log.
+ */
+function deprecatedWarn(message) {
+  if ((0, _mixed.isDefined)(console)) {
+    console.warn(`Deprecated: ${message}`);
+  }
+}
+
 /**
  * Logs info to the console if the `console` object is exposed.
  *

package/helpers/console.mjs

@@ -29,6 +29,17 @@ export function warn() {
   }
 }
 
+/**
+ * Logs deprecated warn to the console if the `console` object is exposed.
+ *
+ * @param {string} message The message to log.
+ */
+export function deprecatedWarn(message) {
+  if (isDefined(console)) {
+    console.warn(`Deprecated: ${message}`);
+  }
+}
+
 /**
  * Logs info to the console if the `console` object is exposed.
  *

package/helpers/dom/element.js

@@ -840,7 +840,7 @@ function outerWidth(element) {
  * @returns {number} Element's outer height.
  */
 function outerHeight(element) {
-  return element.offsetHeight;
+  return element.getBoundingClientRect().height;
 }
 
 /**
@@ -1022,14 +1022,14 @@ function walkontableCalculateScrollbarWidth() {
   outer.style.visibility = 'hidden';
   outer.appendChild(inner);
   (rootDocument.body || rootDocument.documentElement).appendChild(outer);
-  const w1 = inner.offsetWidth;
+  const w1 = inner.getBoundingClientRect().width;
   outer.style.overflow = 'scroll';
-  let w2 = inner.offsetWidth;
+  let w2 = inner.getBoundingClientRect().width;
   if (w1 === w2) {
     w2 = outer.clientWidth;
   }
   (rootDocument.body || rootDocument.documentElement).removeChild(outer);
-  return w1 - w2 + getFractionalScalingCompensation(rootDocument);
+  return parseFloat((w1 - w2).toFixed(3));
 }
 
 /**

package/helpers/dom/element.mjs

@@ -777,7 +777,7 @@ export function outerWidth(element) {
  * @returns {number} Element's outer height.
  */
 export function outerHeight(element) {
-  return element.offsetHeight;
+  return element.getBoundingClientRect().height;
 }
 
 /**
@@ -959,14 +959,14 @@ function walkontableCalculateScrollbarWidth() {
   outer.style.visibility = 'hidden';
   outer.appendChild(inner);
   (rootDocument.body || rootDocument.documentElement).appendChild(outer);
-  const w1 = inner.offsetWidth;
+  const w1 = inner.getBoundingClientRect().width;
   outer.style.overflow = 'scroll';
-  let w2 = inner.offsetWidth;
+  let w2 = inner.getBoundingClientRect().width;
   if (w1 === w2) {
     w2 = outer.clientWidth;
   }
   (rootDocument.body || rootDocument.documentElement).removeChild(outer);
-  return w1 - w2 + getFractionalScalingCompensation(rootDocument);
+  return parseFloat((w1 - w2).toFixed(3));
 }
 
 /**

package/helpers/mixed.js

@@ -2,6 +2,8 @@
 
 exports.__esModule = true;
 exports._injectProductInfo = _injectProductInfo;
+exports.getMostBottomEndPosition = getMostBottomEndPosition;
+exports.getMostTopStartPosition = getMostTopStartPosition;
 exports.isDefined = isDefined;
 exports.isEmpty = isEmpty;
 exports.isRegExp = isRegExp;
@@ -134,7 +136,7 @@ const domMessages = {
 function _injectProductInfo(key, element) {
   const hasValidType = !isEmpty(key);
   const isNonCommercial = typeof key === 'string' && key.toLowerCase() === 'non-commercial-and-evaluation';
-  const hotVersion = "16.0.1-next-eee5f08-20250710";
+  const hotVersion = "16.1.0-next-abd8f2e-20250904";
   let keyValidityDate;
   let consoleMessageState = 'invalid';
   let domMessageState = 'invalid';
@@ -142,7 +144,7 @@ function _injectProductInfo(key, element) {
   const schemaValidity = _checkKeySchema(key);
   if (hasValidType || isNonCommercial || schemaValidity) {
     if (schemaValidity) {
-      const releaseDate = (0, _moment.default)("10/07/2025", 'DD/MM/YYYY');
+      const releaseDate = (0, _moment.default)("11/09/2025", 'DD/MM/YYYY');
       const releaseDays = Math.floor(releaseDate.toDate().getTime() / 8.64e7);
       const keyValidityDays = _extractTime(key);
       keyValidityDate = (0, _moment.default)((keyValidityDays + 1) * 8.64e7, 'x').format('MMMM DD, YYYY');
@@ -208,4 +210,65 @@ function _checkKeySchema(v) {
   }
   return p === z;
 }
+
+/**
+ * Gets the coordinates of the most top-start cell or header (depends on the table settings and its size).
+ *
+ * @param {Core} hot The Handsontable instance.
+ * @returns {CellCoords|null}
+ */
+function getMostTopStartPosition(hot) {
+  const {
+    rowIndexMapper,
+    columnIndexMapper
+  } = hot;
+  const {
+    navigableHeaders
+  } = hot.getSettings();
+  let topRow = navigableHeaders && hot.countColHeaders() > 0 ? -hot.countColHeaders() : 0;
+  let startColumn = navigableHeaders && hot.countRowHeaders() > 0 ? -hot.countRowHeaders() : 0;
+  if (topRow === 0) {
+    topRow = rowIndexMapper.getVisualFromRenderableIndex(topRow);
+  }
+  if (startColumn === 0) {
+    startColumn = columnIndexMapper.getVisualFromRenderableIndex(startColumn);
+  }
+  if (topRow === null || startColumn === null) {
+    return null;
+  }
+  return hot._createCellCoords(topRow, startColumn);
+}
+
+/**
+ * Gets the coordinates of the most bottom-end cell or header (depends on the table settings and its size).
+ *
+ * @param {Core} hot The Handsontable instance.
+ * @returns {CellCoords|null}
+ */
+function getMostBottomEndPosition(hot) {
+  var _rowIndexMapper$getVi, _columnIndexMapper$ge;
+  const {
+    rowIndexMapper,
+    columnIndexMapper
+  } = hot;
+  const {
+    navigableHeaders
+  } = hot.getSettings();
+  let bottomRow = rowIndexMapper.getRenderableIndexesLength() - 1;
+  let endColumn = columnIndexMapper.getRenderableIndexesLength() - 1;
+  if (bottomRow < 0) {
+    if (!navigableHeaders || hot.countColHeaders() === 0) {
+      return null;
+    }
+    bottomRow = -1;
+  }
+  if (endColumn < 0) {
+    if (!navigableHeaders || hot.countColHeaders() === 0) {
+      return null;
+    }
+    endColumn = -1;
+  }
+  return hot._createCellCoords((_rowIndexMapper$getVi = rowIndexMapper.getVisualFromRenderableIndex(bottomRow)) !== null && _rowIndexMapper$getVi !== void 0 ? _rowIndexMapper$getVi : bottomRow, (_columnIndexMapper$ge = columnIndexMapper.getVisualFromRenderableIndex(endColumn)) !== null && _columnIndexMapper$ge !== void 0 ? _columnIndexMapper$ge : endColumn);
+}
+
 /* eslint-enable */

package/helpers/mixed.mjs

@@ -124,7 +124,7 @@ const domMessages = {
 export function _injectProductInfo(key, element) {
   const hasValidType = !isEmpty(key);
   const isNonCommercial = typeof key === 'string' && key.toLowerCase() === 'non-commercial-and-evaluation';
-  const hotVersion = "16.0.1-next-eee5f08-20250710";
+  const hotVersion = "16.1.0-next-abd8f2e-20250904";
   let keyValidityDate;
   let consoleMessageState = 'invalid';
   let domMessageState = 'invalid';
@@ -132,7 +132,7 @@ export function _injectProductInfo(key, element) {
   const schemaValidity = _checkKeySchema(key);
   if (hasValidType || isNonCommercial || schemaValidity) {
     if (schemaValidity) {
-      const releaseDate = moment("10/07/2025", 'DD/MM/YYYY');
+      const releaseDate = moment("11/09/2025", 'DD/MM/YYYY');
       const releaseDays = Math.floor(releaseDate.toDate().getTime() / 8.64e7);
       const keyValidityDays = _extractTime(key);
       keyValidityDate = moment((keyValidityDays + 1) * 8.64e7, 'x').format('MMMM DD, YYYY');
@@ -198,4 +198,65 @@ function _checkKeySchema(v) {
   }
   return p === z;
 }
+
+/**
+ * Gets the coordinates of the most top-start cell or header (depends on the table settings and its size).
+ *
+ * @param {Core} hot The Handsontable instance.
+ * @returns {CellCoords|null}
+ */
+export function getMostTopStartPosition(hot) {
+  const {
+    rowIndexMapper,
+    columnIndexMapper
+  } = hot;
+  const {
+    navigableHeaders
+  } = hot.getSettings();
+  let topRow = navigableHeaders && hot.countColHeaders() > 0 ? -hot.countColHeaders() : 0;
+  let startColumn = navigableHeaders && hot.countRowHeaders() > 0 ? -hot.countRowHeaders() : 0;
+  if (topRow === 0) {
+    topRow = rowIndexMapper.getVisualFromRenderableIndex(topRow);
+  }
+  if (startColumn === 0) {
+    startColumn = columnIndexMapper.getVisualFromRenderableIndex(startColumn);
+  }
+  if (topRow === null || startColumn === null) {
+    return null;
+  }
+  return hot._createCellCoords(topRow, startColumn);
+}
+
+/**
+ * Gets the coordinates of the most bottom-end cell or header (depends on the table settings and its size).
+ *
+ * @param {Core} hot The Handsontable instance.
+ * @returns {CellCoords|null}
+ */
+export function getMostBottomEndPosition(hot) {
+  var _rowIndexMapper$getVi, _columnIndexMapper$ge;
+  const {
+    rowIndexMapper,
+    columnIndexMapper
+  } = hot;
+  const {
+    navigableHeaders
+  } = hot.getSettings();
+  let bottomRow = rowIndexMapper.getRenderableIndexesLength() - 1;
+  let endColumn = columnIndexMapper.getRenderableIndexesLength() - 1;
+  if (bottomRow < 0) {
+    if (!navigableHeaders || hot.countColHeaders() === 0) {
+      return null;
+    }
+    bottomRow = -1;
+  }
+  if (endColumn < 0) {
+    if (!navigableHeaders || hot.countColHeaders() === 0) {
+      return null;
+    }
+    endColumn = -1;
+  }
+  return hot._createCellCoords((_rowIndexMapper$getVi = rowIndexMapper.getVisualFromRenderableIndex(bottomRow)) !== null && _rowIndexMapper$getVi !== void 0 ? _rowIndexMapper$getVi : bottomRow, (_columnIndexMapper$ge = columnIndexMapper.getVisualFromRenderableIndex(endColumn)) !== null && _columnIndexMapper$ge !== void 0 ? _columnIndexMapper$ge : endColumn);
+}
+
 /* eslint-enable */

package/helpers/number.js

@@ -2,8 +2,10 @@
 
 exports.__esModule = true;
 exports.clamp = clamp;
+exports.getParsedNumber = getParsedNumber;
 exports.isNumeric = isNumeric;
 exports.isNumericLike = isNumericLike;
+exports.isUnsignedNumber = isUnsignedNumber;
 exports.rangeEach = rangeEach;
 exports.rangeEachReverse = rangeEachReverse;
 exports.valueAccordingPercent = valueAccordingPercent;
@@ -141,4 +143,30 @@ function clamp(value, minValue, maxValue) {
     return maxValue;
   }
   return value;
+}
+
+/**
+ * Get parsed number from numeric string.
+ *
+ * @param {string} numericData Float (separated by a dot or a comma) or integer.
+ * @returns {number|null} Number if we get data in parsable format, not changed value otherwise.
+ */
+function getParsedNumber(numericData) {
+  // Unifying "float like" string. Change from value with comma determiner to value with dot determiner,
+  // for example from `450,65` to `450.65`.
+  const unifiedNumericData = numericData.replace(',', '.');
+  if (isNaN(parseFloat(unifiedNumericData)) === false) {
+    return parseFloat(unifiedNumericData);
+  }
+  return null;
+}
+
+/**
+ * Check if the provided argument is an unsigned number.
+ *
+ * @param {*} value Value to check.
+ * @returns {boolean}
+ */
+function isUnsignedNumber(value) {
+  return Number.isInteger(value) && value >= 0;
 }

package/helpers/number.mjs

@@ -132,4 +132,30 @@ export function clamp(value, minValue, maxValue) {
     return maxValue;
   }
   return value;
+}
+
+/**
+ * Get parsed number from numeric string.
+ *
+ * @param {string} numericData Float (separated by a dot or a comma) or integer.
+ * @returns {number|null} Number if we get data in parsable format, not changed value otherwise.
+ */
+export function getParsedNumber(numericData) {
+  // Unifying "float like" string. Change from value with comma determiner to value with dot determiner,
+  // for example from `450,65` to `450.65`.
+  const unifiedNumericData = numericData.replace(',', '.');
+  if (isNaN(parseFloat(unifiedNumericData)) === false) {
+    return parseFloat(unifiedNumericData);
+  }
+  return null;
+}
+
+/**
+ * Check if the provided argument is an unsigned number.
+ *
+ * @param {*} value Value to check.
+ * @returns {boolean}
+ */
+export function isUnsignedNumber(value) {
+  return Number.isInteger(value) && value >= 0;
 }

package/helpers/object.js

@@ -1,6 +1,7 @@
 "use strict";
 
 exports.__esModule = true;
+exports.assignObjectDefaults = assignObjectDefaults;
 exports.clone = clone;
 exports.createObjectPropListener = createObjectPropListener;
 exports.deepClone = deepClone;
@@ -369,4 +370,38 @@ function createObjectPropListener(defaultValue) {
  */
 function hasOwnProperty(object, key) {
   return Object.prototype.hasOwnProperty.call(object, key);
+}
+
+/**
+ * Assign default values to an object.
+ *
+ * @param {object} target The object to assign defaults to.
+ * @param {object} defaults The default values to assign.
+ * @returns {object} The object with defaults assigned.
+ */
+function assignObjectDefaults(target, defaults) {
+  if (typeof target !== 'object' || target === null) {
+    return defaults;
+  }
+  if (typeof defaults !== 'object' || defaults === null) {
+    return target;
+  }
+  const result = {};
+
+  // Assign defaults
+  Object.keys(defaults).forEach(key => {
+    if (typeof defaults[key] === 'object' && defaults[key] !== null && !Array.isArray(defaults[key])) {
+      result[key] = assignObjectDefaults(target[key], defaults[key]);
+    } else {
+      result[key] = hasOwnProperty(target, key) && target[key] !== undefined ? target[key] : defaults[key];
+    }
+  });
+
+  // Copy extra keys from target that aren't in defaults
+  Object.keys(target).forEach(key => {
+    if (!hasOwnProperty(result, key)) {
+      result[key] = target[key];
+    }
+  });
+  return result;
 }

package/helpers/object.mjs

@@ -350,4 +350,38 @@ export function createObjectPropListener(defaultValue) {
  */
 export function hasOwnProperty(object, key) {
   return Object.prototype.hasOwnProperty.call(object, key);
+}
+
+/**
+ * Assign default values to an object.
+ *
+ * @param {object} target The object to assign defaults to.
+ * @param {object} defaults The default values to assign.
+ * @returns {object} The object with defaults assigned.
+ */
+export function assignObjectDefaults(target, defaults) {
+  if (typeof target !== 'object' || target === null) {
+    return defaults;
+  }
+  if (typeof defaults !== 'object' || defaults === null) {
+    return target;
+  }
+  const result = {};
+
+  // Assign defaults
+  Object.keys(defaults).forEach(key => {
+    if (typeof defaults[key] === 'object' && defaults[key] !== null && !Array.isArray(defaults[key])) {
+      result[key] = assignObjectDefaults(target[key], defaults[key]);
+    } else {
+      result[key] = hasOwnProperty(target, key) && target[key] !== undefined ? target[key] : defaults[key];
+    }
+  });
+
+  // Copy extra keys from target that aren't in defaults
+  Object.keys(target).forEach(key => {
+    if (!hasOwnProperty(result, key)) {
+      result[key] = target[key];
+    }
+  });
+  return result;
 }

package/helpers/string.js

@@ -2,6 +2,7 @@
 
 exports.__esModule = true;
 exports.equalsIgnoreCase = equalsIgnoreCase;
+exports.isJSON = isJSON;
 exports.isPercentValue = isPercentValue;
 exports.randomString = randomString;
 exports.sanitize = sanitize;
@@ -59,6 +60,24 @@ function randomString() {
   return s4() + s4() + s4() + s4();
 }
 
+/**
+ * Checks if a string is a valid JSON object.
+ *
+ * @param {string} string The string to check.
+ * @returns {boolean}
+ */
+function isJSON(string) {
+  if (typeof string !== 'string') {
+    return false;
+  }
+  try {
+    const parsed = JSON.parse(string);
+    return typeof parsed === 'object' && parsed !== null;
+  } catch {
+    return false;
+  }
+}
+
 /**
  * Checks if value is valid percent.
  *

package/helpers/string.mjs

@@ -48,6 +48,24 @@ export function randomString() {
   return s4() + s4() + s4() + s4();
 }
 
+/**
+ * Checks if a string is a valid JSON object.
+ *
+ * @param {string} string The string to check.
+ * @returns {boolean}
+ */
+export function isJSON(string) {
+  if (typeof string !== 'string') {
+    return false;
+  }
+  try {
+    const parsed = JSON.parse(string);
+    return typeof parsed === 'object' && parsed !== null;
+  } catch {
+    return false;
+  }
+}
+
 /**
  * Checks if value is valid percent.
  *