handsontable 16.2.0 → 17.0.0-rc1

package/helpers/dateTime.mjs

@@ -0,0 +1,102 @@
+import { isEmpty } from "./mixed.mjs";
+/**
+ * ISO 8601 date pattern.
+ *
+ * @type {RegExp}
+ */
+export const ISO_DATE_REGEX = /^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$/;
+
+/**
+ * Get normalized Date object for the ISO formatted date strings.
+ * Natively, the date object parsed from a ISO 8601 string will be offsetted by the timezone difference, which may result in returning a wrong date.
+ * See: Github issue #3338.
+ *
+ * @param {string} dateString String representing the date.
+ * @returns {Date} The proper Date object.
+ */
+export function getNormalizedDate(dateString) {
+  const nativeDate = new Date(dateString);
+
+  // NaN if dateString is not in ISO format
+  if (!isNaN(new Date(`${dateString}T00:00`).getDate())) {
+    // Compensate timezone offset
+    return new Date(nativeDate.getTime() + nativeDate.getTimezoneOffset() * 60000);
+  }
+  return nativeDate;
+}
+
+/**
+ * Converts a date string to a Date object.
+ *
+ * @param {*} value The value to parse.
+ * @returns {Date | null} The Date object or null if the value is invalid.
+ */
+export function parseToLocalDate(value) {
+  if (isEmpty(value)) {
+    return null;
+  }
+  if (typeof value === 'string' && ISO_DATE_REGEX.test(value)) {
+    const [y, m, d] = value.split('-').map(Number);
+    return new Date(y, m - 1, d);
+  }
+  return null;
+}
+
+/**
+ * Checks if a string is a valid ISO 8601 date.
+ *
+ * @param {string} value The value to check.
+ * @returns {boolean} True if valid ISO date string.
+ */
+export function isValidISODate(value) {
+  if (typeof value !== 'string' || !ISO_DATE_REGEX.test(value)) {
+    return false;
+  }
+  const date = new Date(value);
+  return !Number.isNaN(date.getTime()) && value === date.toISOString().slice(0, 10);
+}
+
+/**
+ * Time pattern: HH:mm, HH:mm:ss, or HH:mm:ss.SSS (24-hour).
+ * Same format as HTML input type="time" value; seconds and milliseconds optional.
+ *
+ * @type {RegExp}
+ */
+export const TIME_REGEX = /^([01]\d|2[0-3]):([0-5]\d)(?::([0-5]\d)(?:\.(\d{1,3}))?)?$/;
+
+/**
+ * Parses a time string in HH:mm, HH:mm:ss, or HH:mm:ss.SSS format to a Date with that time on the Unix epoch (1970-01-01).
+ * Useful for comparison and sorting. Same format as HTML input type="time" value.
+ *
+ * @param {*} value The value to parse.
+ * @returns {Date | null} The Date object or null if the value is invalid.
+ */
+export function parseToLocalTime(value) {
+  if (isEmpty(value)) {
+    return null;
+  }
+  if (typeof value !== 'string') {
+    return null;
+  }
+  const match = TIME_REGEX.exec(value);
+  if (!match) {
+    return null;
+  }
+  const hours = Number(match[1]);
+  const minutes = Number(match[2]);
+  const seconds = match[3] !== undefined ? Number(match[3]) : 0;
+  const msString = match[4];
+  const milliseconds = msString !== undefined ? Number(msString.padEnd(3, '0').slice(0, 3)) : 0;
+  return new Date(1970, 0, 1, hours, minutes, seconds, milliseconds);
+}
+
+/**
+ * Checks if a string is a valid time in HH:mm, HH:mm:ss, or HH:mm:ss.SSS format (00:00–23:59).
+ * Same format as HTML input type="time" value.
+ *
+ * @param {string} value The value to check.
+ * @returns {boolean} True if valid time string.
+ */
+export function isValidTime(value) {
+  return typeof value === 'string' && TIME_REGEX.test(value);
+}

package/helpers/dom/element.d.ts

@@ -13,7 +13,7 @@ export function addClass(element: HTMLElement, className: string | string[]): vo
 export function removeClass(element: HTMLElement, className: string | string[]): void;
 export function removeTextNodes(element: HTMLElement): void;
 export function empty(element: HTMLElement): void;
-export function fastInnerHTML(element: HTMLElement, content: string, sanitizeContent?: boolean): void;
+export function fastInnerHTML(element: HTMLElement, content: string, sanitizer?: (content: string, source: string) => string): void;
 export function fastInnerText(element: HTMLElement, content: string): void;
 export function isVisible(element: HTMLElement): boolean;
 export function offset(element: HTMLElement): { left: number, top: number };

package/helpers/dom/element.js

@@ -61,14 +61,11 @@ exports.selectElementIfAllowed = selectElementIfAllowed;
 exports.setAttribute = setAttribute;
 exports.setCaretPosition = setCaretPosition;
 exports.setOverlayPosition = setOverlayPosition;
-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.filter.js");
-require("core-js/modules/esnext.iterator.for-each.js");
 var _string = require("../string");
 var _a11y = require("../a11y");
 var _browser = require("../browser");
+var _console = require("../console");
+var _errors = require("../../helpers/errors");
 /**
  * Get the parent of the specified node in the DOM tree.
  *
@@ -482,18 +479,23 @@ function empty(element) {
   }
 }
 const HTML_CHARACTERS = exports.HTML_CHARACTERS = /(<(.*)>|&(.*);)/;
+let dompurifyDeprecatedMessageShown = false;
 
 /**
  * Insert content into element trying to avoid innerHTML method.
  *
  * @param {HTMLElement} element An element to write into.
  * @param {string} content The text to write.
- * @param {boolean} [sanitizeContent=true] If `true`, the content will be sanitized before writing to the element.
+ * @param {function(string): string | boolean} [sanitizer] The sanitizer to use for the content.
  */
 function fastInnerHTML(element, content) {
-  let sanitizeContent = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
+  let sanitizer = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : _string.sanitize;
   if (HTML_CHARACTERS.test(content)) {
-    element.innerHTML = sanitizeContent ? (0, _string.sanitize)(content) : content;
+    if (!dompurifyDeprecatedMessageShown && sanitizer === _string.sanitize) {
+      dompurifyDeprecatedMessageShown = true;
+      (0, _console.deprecatedWarn)('The HTML sanitization using DOMPurify library is deprecated and will be removed in the next major release. ' + 'Use the `sanitizer` option instead.\n\n' + 'Migration guide: https://handsontable.com/docs/migration-from-16.2-to-17.0/\n' + '`sanitizer` documentation: https://handsontable.com/docs/api/options/#sanitizer');
+    }
+    element.innerHTML = typeof sanitizer === 'function' ? sanitizer(content, 'innerHTML') : content;
   } else {
     fastInnerText(element, content);
   }
@@ -544,7 +546,7 @@ function isVisible(element) {
           // Chrome 33.0.1723.0 canary (2013-11-29) Web Platform features enabled
           return isVisible(next.host);
         }
-        throw new Error('Lost in Web Components world');
+        (0, _errors.throwWithCause)('Lost in Web Components world');
       } else {
         return false; // this is a node detached from document in IE8
       }
@@ -568,7 +570,8 @@ function hasZeroHeight(element) {
   let currentElement = element;
   while (currentElement.parentNode) {
     if (currentElement.style.height === '0px' || currentElement.style.height === '0') {
-      return rootWindow.getComputedStyle(currentElement).overflow === 'hidden';
+      const computedOverflow = rootWindow.getComputedStyle(currentElement).getPropertyValue('overflow');
+      return computedOverflow === 'hidden' || computedOverflow === 'clip';
     }
     currentElement = currentElement.parentNode;
   }
@@ -758,7 +761,7 @@ function getTrimmingContainer(base) {
       return el;
     }
     const computedStyle = rootWindow.getComputedStyle(el);
-    const allowedProperties = ['scroll', 'hidden', 'auto'];
+    const allowedProperties = ['scroll', 'hidden', 'auto', 'clip'];
     const property = computedStyle.getPropertyValue('overflow');
     const propertyY = computedStyle.getPropertyValue('overflow-y');
     const propertyX = computedStyle.getPropertyValue('overflow-x');
@@ -840,7 +843,7 @@ function outerWidth(element) {
  * @returns {number} Element's outer height.
  */
 function outerHeight(element) {
-  return element.getBoundingClientRect().height;
+  return element.offsetHeight;
 }
 
 /**
@@ -972,7 +975,6 @@ function setCaretPosition(element, pos, endPos) {
     }
   }
 }
-let cachedScrollbarWidth;
 
 /**
  * Returns the fractional scaling compensation for scrollbar width calculation.
@@ -997,7 +999,7 @@ function getFractionalScalingCompensation() {
  * Source: https://stackoverflow.com/questions/986937/how-can-i-get-the-browsers-scrollbar-sizes.
  *
  * @private
- * @param {Document} rootDocument The onwer of the document.
+ * @param {Document} rootDocument The owner of the document.
  * @returns {number}
  */
 // eslint-disable-next-line no-restricted-globals
@@ -1021,22 +1023,23 @@ function walkontableCalculateScrollbarWidth() {
   outer.style.width = '200px';
   outer.style.visibility = 'hidden';
   outer.appendChild(inner);
-  (rootDocument.body || rootDocument.documentElement).appendChild(outer);
-  const w1 = inner.getBoundingClientRect().width;
+  rootDocument.body.appendChild(outer);
+  const w1 = inner.offsetWidth;
   outer.style.overflow = 'scroll';
-  let w2 = inner.getBoundingClientRect().width;
+  let w2 = inner.offsetWidth;
   if (w1 === w2) {
     w2 = outer.clientWidth;
   }
-  (rootDocument.body || rootDocument.documentElement).removeChild(outer);
-  return parseFloat((w1 - w2).toFixed(3));
+  rootDocument.body.removeChild(outer);
+  return w1 - w2;
 }
+let cachedScrollbarWidth;
 
 /**
  * Returns the computed width of the native browser scroll bar.
  *
  * @param {Document} [rootDocument] The owner of the document.
- * @returns {number} Width.
+ * @returns {number} The computed width of the native browser scroll bar.
  */
 // eslint-disable-next-line no-restricted-globals
 function getScrollbarWidth() {

package/helpers/dom/element.mjs

@@ -1,11 +1,8 @@
-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.filter.js";
-import "core-js/modules/esnext.iterator.for-each.js";
 import { sanitize } from "../string.mjs";
 import { A11Y_HIDDEN } from "../a11y.mjs";
 import { isWindowsOS, isSafari, isMobileBrowser, isIpadOS } from "../browser.mjs";
+import { deprecatedWarn } from "../console.mjs";
+import { throwWithCause } from "../../helpers/errors.mjs";
 /**
  * Get the parent of the specified node in the DOM tree.
  *
@@ -419,18 +416,23 @@ export function empty(element) {
   }
 }
 export const HTML_CHARACTERS = /(<(.*)>|&(.*);)/;
+let dompurifyDeprecatedMessageShown = false;
 
 /**
  * Insert content into element trying to avoid innerHTML method.
  *
  * @param {HTMLElement} element An element to write into.
  * @param {string} content The text to write.
- * @param {boolean} [sanitizeContent=true] If `true`, the content will be sanitized before writing to the element.
+ * @param {function(string): string | boolean} [sanitizer] The sanitizer to use for the content.
  */
 export function fastInnerHTML(element, content) {
-  let sanitizeContent = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
+  let sanitizer = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : sanitize;
   if (HTML_CHARACTERS.test(content)) {
-    element.innerHTML = sanitizeContent ? sanitize(content) : content;
+    if (!dompurifyDeprecatedMessageShown && sanitizer === sanitize) {
+      dompurifyDeprecatedMessageShown = true;
+      deprecatedWarn('The HTML sanitization using DOMPurify library is deprecated and will be removed in the next major release. ' + 'Use the `sanitizer` option instead.\n\n' + 'Migration guide: https://handsontable.com/docs/migration-from-16.2-to-17.0/\n' + '`sanitizer` documentation: https://handsontable.com/docs/api/options/#sanitizer');
+    }
+    element.innerHTML = typeof sanitizer === 'function' ? sanitizer(content, 'innerHTML') : content;
   } else {
     fastInnerText(element, content);
   }
@@ -481,7 +483,7 @@ export function isVisible(element) {
           // Chrome 33.0.1723.0 canary (2013-11-29) Web Platform features enabled
           return isVisible(next.host);
         }
-        throw new Error('Lost in Web Components world');
+        throwWithCause('Lost in Web Components world');
       } else {
         return false; // this is a node detached from document in IE8
       }
@@ -505,7 +507,8 @@ export function hasZeroHeight(element) {
   let currentElement = element;
   while (currentElement.parentNode) {
     if (currentElement.style.height === '0px' || currentElement.style.height === '0') {
-      return rootWindow.getComputedStyle(currentElement).overflow === 'hidden';
+      const computedOverflow = rootWindow.getComputedStyle(currentElement).getPropertyValue('overflow');
+      return computedOverflow === 'hidden' || computedOverflow === 'clip';
     }
     currentElement = currentElement.parentNode;
   }
@@ -695,7 +698,7 @@ export function getTrimmingContainer(base) {
       return el;
     }
     const computedStyle = rootWindow.getComputedStyle(el);
-    const allowedProperties = ['scroll', 'hidden', 'auto'];
+    const allowedProperties = ['scroll', 'hidden', 'auto', 'clip'];
     const property = computedStyle.getPropertyValue('overflow');
     const propertyY = computedStyle.getPropertyValue('overflow-y');
     const propertyX = computedStyle.getPropertyValue('overflow-x');
@@ -777,7 +780,7 @@ export function outerWidth(element) {
  * @returns {number} Element's outer height.
  */
 export function outerHeight(element) {
-  return element.getBoundingClientRect().height;
+  return element.offsetHeight;
 }
 
 /**
@@ -909,7 +912,6 @@ export function setCaretPosition(element, pos, endPos) {
     }
   }
 }
-let cachedScrollbarWidth;
 
 /**
  * Returns the fractional scaling compensation for scrollbar width calculation.
@@ -934,7 +936,7 @@ export function getFractionalScalingCompensation() {
  * Source: https://stackoverflow.com/questions/986937/how-can-i-get-the-browsers-scrollbar-sizes.
  *
  * @private
- * @param {Document} rootDocument The onwer of the document.
+ * @param {Document} rootDocument The owner of the document.
  * @returns {number}
  */
 // eslint-disable-next-line no-restricted-globals
@@ -958,22 +960,23 @@ function walkontableCalculateScrollbarWidth() {
   outer.style.width = '200px';
   outer.style.visibility = 'hidden';
   outer.appendChild(inner);
-  (rootDocument.body || rootDocument.documentElement).appendChild(outer);
-  const w1 = inner.getBoundingClientRect().width;
+  rootDocument.body.appendChild(outer);
+  const w1 = inner.offsetWidth;
   outer.style.overflow = 'scroll';
-  let w2 = inner.getBoundingClientRect().width;
+  let w2 = inner.offsetWidth;
   if (w1 === w2) {
     w2 = outer.clientWidth;
   }
-  (rootDocument.body || rootDocument.documentElement).removeChild(outer);
-  return parseFloat((w1 - w2).toFixed(3));
+  rootDocument.body.removeChild(outer);
+  return w1 - w2;
 }
+let cachedScrollbarWidth;
 
 /**
  * Returns the computed width of the native browser scroll bar.
  *
  * @param {Document} [rootDocument] The owner of the document.
- * @returns {number} Width.
+ * @returns {number} The computed width of the native browser scroll bar.
  */
 // eslint-disable-next-line no-restricted-globals
 export function getScrollbarWidth() {

package/helpers/errors.d.ts

@@ -0,0 +1 @@
+export function throwWithCause(message: string): never;

package/helpers/errors.js

@@ -0,0 +1,21 @@
+"use strict";
+
+exports.__esModule = true;
+exports.throwWithCause = throwWithCause;
+/**
+ * Throws an Error with a Handsontable-specific cause for easy identification.
+ *
+ * Use this helper instead of `throw new Error()` to ensure all Handsontable errors
+ * can be recognized by checking `error.cause?.handsontable === true`.
+ *
+ * @param {string} message The error message to display.
+ * @throws {Error} Always throws an Error with `cause: { handsontable: true }`.
+ */
+function throwWithCause(message) {
+  // eslint-disable-next-line handsontable/no-native-error-throw
+  throw new Error(message, {
+    cause: {
+      handsontable: true
+    }
+  });
+}

package/helpers/errors.mjs

@@ -0,0 +1,17 @@
+/**
+ * Throws an Error with a Handsontable-specific cause for easy identification.
+ *
+ * Use this helper instead of `throw new Error()` to ensure all Handsontable errors
+ * can be recognized by checking `error.cause?.handsontable === true`.
+ *
+ * @param {string} message The error message to display.
+ * @throws {Error} Always throws an Error with `cause: { handsontable: true }`.
+ */
+export function throwWithCause(message) {
+  // eslint-disable-next-line handsontable/no-native-error-throw
+  throw new Error(message, {
+    cause: {
+      handsontable: true
+    }
+  });
+}

package/helpers/index.d.ts

@@ -2,7 +2,8 @@ export * from './array';
 export * from './browser';
 export * from './console';
 export * from './data';
-export * from './date';
+export * from './dateTime';
+export * from './errors';
 export * from './feature';
 export * from './function';
 export * from './mixed';

package/helpers/mixed.js

@@ -7,9 +7,7 @@ exports.isEmpty = isEmpty;
 exports.isRegExp = isRegExp;
 exports.isUndefined = isUndefined;
 exports.stringify = stringify;
-var _moment = _interopRequireDefault(require("moment"));
 var _templateLiteralTag = require("./templateLiteralTag");
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 /**
  * Converts any value to string.
  *
@@ -131,10 +129,10 @@ const domMessages = {
     the documentation or contact us at <a href="mailto:support@handsontable.com">support@handsontable.com</a>.`,
   non_commercial: () => ''
 };
-function _injectProductInfo(key, element) {
+function _injectProductInfo(key, element, releaseDate) {
   const hasValidType = !isEmpty(key);
   const isNonCommercial = typeof key === 'string' && key.toLowerCase() === 'non-commercial-and-evaluation';
-  const hotVersion = "16.2.0";
+  const hotVersion = "17.0.0-rc1";
   let keyValidityDate;
   let consoleMessageState = 'invalid';
   let domMessageState = 'invalid';
@@ -142,10 +140,15 @@ function _injectProductInfo(key, element) {
   const schemaValidity = _checkKeySchema(key);
   if (hasValidType || isNonCommercial || schemaValidity) {
     if (schemaValidity) {
-      const releaseDate = (0, _moment.default)("25/11/2025", 'DD/MM/YYYY');
-      const releaseDays = Math.floor(releaseDate.toDate().getTime() / 8.64e7);
+      const [dd, mm, yyyy] = releaseDate.split('/').map(Number);
+      const releaseDays = Math.floor(Date.UTC(yyyy, mm - 1, dd) / 8.64e7);
       const keyValidityDays = _extractTime(key);
-      keyValidityDate = (0, _moment.default)((keyValidityDays + 1) * 8.64e7, 'x').format('MMMM DD, YYYY');
+      keyValidityDate = new Intl.DateTimeFormat('en-US', {
+        year: 'numeric',
+        month: 'long',
+        day: '2-digit',
+        timeZone: 'UTC'
+      }).format((keyValidityDays + 1) * 8.64e7);
       if (releaseDays > keyValidityDays) {
         consoleMessageState = 'expired';
         domMessageState = 'expired';

package/helpers/mixed.mjs

@@ -1,4 +1,3 @@
-import moment from 'moment';
 import { toSingleLine } from "./templateLiteralTag.mjs";
 /**
  * Converts any value to string.
@@ -121,10 +120,10 @@ const domMessages = {
     the documentation or contact us at <a href="mailto:support@handsontable.com">support@handsontable.com</a>.`,
   non_commercial: () => ''
 };
-export function _injectProductInfo(key, element) {
+export function _injectProductInfo(key, element, releaseDate) {
   const hasValidType = !isEmpty(key);
   const isNonCommercial = typeof key === 'string' && key.toLowerCase() === 'non-commercial-and-evaluation';
-  const hotVersion = "16.2.0";
+  const hotVersion = "17.0.0-rc1";
   let keyValidityDate;
   let consoleMessageState = 'invalid';
   let domMessageState = 'invalid';
@@ -132,10 +131,15 @@ export function _injectProductInfo(key, element) {
   const schemaValidity = _checkKeySchema(key);
   if (hasValidType || isNonCommercial || schemaValidity) {
     if (schemaValidity) {
-      const releaseDate = moment("25/11/2025", 'DD/MM/YYYY');
-      const releaseDays = Math.floor(releaseDate.toDate().getTime() / 8.64e7);
+      const [dd, mm, yyyy] = releaseDate.split('/').map(Number);
+      const releaseDays = Math.floor(Date.UTC(yyyy, mm - 1, dd) / 8.64e7);
       const keyValidityDays = _extractTime(key);
-      keyValidityDate = moment((keyValidityDays + 1) * 8.64e7, 'x').format('MMMM DD, YYYY');
+      keyValidityDate = new Intl.DateTimeFormat('en-US', {
+        year: 'numeric',
+        month: 'long',
+        day: '2-digit',
+        timeZone: 'UTC'
+      }).format((keyValidityDays + 1) * 8.64e7);
       if (releaseDays > keyValidityDays) {
         consoleMessageState = 'expired';
         domMessageState = 'expired';

package/helpers/moves.js

@@ -2,10 +2,6 @@
 
 exports.__esModule = true;
 exports.getMoves = getMoves;
-require("core-js/modules/es.array.push.js");
-require("core-js/modules/esnext.iterator.constructor.js");
-require("core-js/modules/esnext.iterator.filter.js");
-require("core-js/modules/esnext.iterator.for-each.js");
 /**
  * Gets first position where to move element (respecting the fact that some element will be sooner or later
  * taken out of the dataset in order to move them).

package/helpers/moves.mjs

@@ -1,7 +1,3 @@
-import "core-js/modules/es.array.push.js";
-import "core-js/modules/esnext.iterator.constructor.js";
-import "core-js/modules/esnext.iterator.filter.js";
-import "core-js/modules/esnext.iterator.for-each.js";
 /**
  * Gets first position where to move element (respecting the fact that some element will be sooner or later
  * taken out of the dataset in order to move them).

package/helpers/number.js

@@ -9,15 +9,6 @@ exports.isUnsignedNumber = isUnsignedNumber;
 exports.rangeEach = rangeEach;
 exports.rangeEachReverse = rangeEachReverse;
 exports.valueAccordingPercent = valueAccordingPercent;
-require("core-js/modules/es.set.difference.v2.js");
-require("core-js/modules/es.set.intersection.v2.js");
-require("core-js/modules/es.set.is-disjoint-from.v2.js");
-require("core-js/modules/es.set.is-subset-of.v2.js");
-require("core-js/modules/es.set.is-superset-of.v2.js");
-require("core-js/modules/es.set.symmetric-difference.v2.js");
-require("core-js/modules/es.set.union.v2.js");
-require("core-js/modules/esnext.iterator.constructor.js");
-require("core-js/modules/esnext.iterator.map.js");
 /* eslint-disable jsdoc/require-description-complete-sentence */
 /**
  * Checks if the passed value is numeric one. For example these values (passed as string or number)

package/helpers/number.mjs

@@ -1,12 +1,3 @@
-import "core-js/modules/es.set.difference.v2.js";
-import "core-js/modules/es.set.intersection.v2.js";
-import "core-js/modules/es.set.is-disjoint-from.v2.js";
-import "core-js/modules/es.set.is-subset-of.v2.js";
-import "core-js/modules/es.set.is-superset-of.v2.js";
-import "core-js/modules/es.set.symmetric-difference.v2.js";
-import "core-js/modules/es.set.union.v2.js";
-import "core-js/modules/esnext.iterator.constructor.js";
-import "core-js/modules/esnext.iterator.map.js";
 /* eslint-disable jsdoc/require-description-complete-sentence */
 /**
  * Checks if the passed value is numeric one. For example these values (passed as string or number)

package/helpers/object.js

@@ -6,6 +6,7 @@ exports.clone = clone;
 exports.createObjectPropListener = createObjectPropListener;
 exports.deepClone = deepClone;
 exports.deepExtend = deepExtend;
+exports.deepMerge = deepMerge;
 exports.deepObjectSize = deepObjectSize;
 exports.defineGetter = defineGetter;
 exports.duckSchema = duckSchema;
@@ -13,17 +14,15 @@ exports.extend = extend;
 exports.getProperty = getProperty;
 exports.hasOwnProperty = hasOwnProperty;
 exports.inherit = inherit;
+exports.isKeyValueObject = isKeyValueObject;
 exports.isObject = isObject;
 exports.isObjectEqual = isObjectEqual;
 exports.mixin = mixin;
 exports.objectEach = objectEach;
 exports.setProperty = setProperty;
-require("core-js/modules/es.error.cause.js");
-require("core-js/modules/es.array.push.js");
-require("core-js/modules/es.json.stringify.js");
-require("core-js/modules/esnext.iterator.constructor.js");
-require("core-js/modules/esnext.iterator.for-each.js");
 var _array = require("./array");
+var _mixed = require("./mixed");
+var _errors = require("../helpers/errors");
 /**
  * Generate schema for passed object.
  *
@@ -161,7 +160,7 @@ function mixin(Base) {
     Base.MIXINS.push(mixinItem.MIXIN_NAME);
     objectEach(mixinItem, (value, key) => {
       if (Base.prototype[key] !== undefined) {
-        throw new Error(`Mixin conflict. Property '${key}' already exist and cannot be overwritten.`);
+        (0, _errors.throwWithCause)(`Mixin conflict. Property '${key}' already exist and cannot be overwritten.`);
       }
       if (typeof value === 'function') {
         Base.prototype[key] = value;
@@ -404,4 +403,46 @@ function assignObjectDefaults(target, defaults) {
     }
   });
   return result;
+}
+
+/**
+ * Deeply merges two objects.
+ * For every key:
+ *  - If both source and target values are plain objects, they are merged recursively.
+ *  - Otherwise, the source value replaces the target value.
+ *
+ * @param {object} target The target object.
+ * @param {object} source The source object.
+ * @returns {object} The merged object.
+ */
+function deepMerge() {
+  let target = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  let source = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  const result = {
+    ...target
+  };
+  Object.keys(source).forEach(key => {
+    // Prevent prototype pollution
+    if (key === '__proto__' || key === 'constructor' || key === 'prototype') {
+      return;
+    }
+    const sourceValue = source[key];
+    const targetValue = result[key];
+    if (isObject(sourceValue) && isObject(targetValue)) {
+      result[key] = deepMerge(targetValue, sourceValue);
+    } else {
+      result[key] = sourceValue;
+    }
+  });
+  return result;
+}
+
+/**
+ * Checks if the value is a key/value object.
+ *
+ * @param {*} value The value to check.
+ * @returns {boolean}
+ */
+function isKeyValueObject(value) {
+  return isObject(value) && (0, _mixed.isDefined)(value.key) && (0, _mixed.isDefined)(value.value);
 }