handsontable 16.2.0 → 17.0.0-rc1

package/editors/selectEditor/selectEditor.js

@@ -125,7 +125,7 @@ class SelectEditor extends _baseEditor.BaseEditor {
     (0, _object.objectEach)(options, (optionValue, key) => {
       const optionElement = this.hot.rootDocument.createElement('OPTION');
       optionElement.value = key;
-      (0, _element.fastInnerHTML)(optionElement, optionValue);
+      (0, _element.fastInnerHTML)(optionElement, optionValue, this.hot.getSettings().sanitizer);
       this.select.appendChild(optionElement);
     });
   }

package/editors/selectEditor/selectEditor.mjs

@@ -122,7 +122,7 @@ export class SelectEditor extends BaseEditor {
     objectEach(options, (optionValue, key) => {
       const optionElement = this.hot.rootDocument.createElement('OPTION');
       optionElement.value = key;
-      fastInnerHTML(optionElement, optionValue);
+      fastInnerHTML(optionElement, optionValue, this.hot.getSettings().sanitizer);
       this.select.appendChild(optionElement);
     });
   }

package/editors/textEditor/textEditor.js

@@ -1,7 +1,6 @@
 "use strict";
 
 exports.__esModule = true;
-require("core-js/modules/es.error.cause.js");
 var _baseEditor = require("../baseEditor");
 var _eventManager = _interopRequireDefault(require("../../eventManager"));
 var _browser = require("../../helpers/browser");
@@ -188,12 +187,15 @@ class TextEditor extends _baseEditor.BaseEditor {
 
   /**
    * Creates an editor's elements and adds necessary CSS classnames.
+   *
+   * @param {string} type The type of the element to create.
    */
   createElements() {
+    let type = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'textarea';
     const {
       rootDocument
     } = this.hot;
-    this.TEXTAREA = rootDocument.createElement('TEXTAREA');
+    this.TEXTAREA = rootDocument.createElement(type);
 
     // Makes the element recognizable by Hot as its own
     // component's element.

package/editors/textEditor/textEditor.mjs

@@ -1,4 +1,3 @@
-import "core-js/modules/es.error.cause.js";
 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); }
@@ -184,12 +183,15 @@ export class TextEditor extends BaseEditor {
 
   /**
    * Creates an editor's elements and adds necessary CSS classnames.
+   *
+   * @param {string} type The type of the element to create.
    */
   createElements() {
+    let type = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'textarea';
     const {
       rootDocument
     } = this.hot;
-    this.TEXTAREA = rootDocument.createElement('TEXTAREA');
+    this.TEXTAREA = rootDocument.createElement(type);
 
     // Makes the element recognizable by Hot as its own
     // component's element.

package/eventManager.js

@@ -2,8 +2,6 @@
 
 exports.__esModule = true;
 exports.getListenersCounter = getListenersCounter;
-require("core-js/modules/es.error.cause.js");
-require("core-js/modules/es.array.push.js");
 var _event = require("./helpers/dom/event");
 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 + ""; }

package/eventManager.mjs

@@ -1,5 +1,3 @@
-import "core-js/modules/es.error.cause.js";
-import "core-js/modules/es.array.push.js";
 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); }

package/focusManager/grid.js

@@ -1,7 +1,6 @@
 "use strict";
 
 exports.__esModule = true;
-require("core-js/modules/es.error.cause.js");
 var _console = require("../helpers/console");
 var _element = require("../helpers/dom/element");
 var _function = require("../helpers/function");

package/focusManager/grid.mjs

@@ -1,4 +1,3 @@
-import "core-js/modules/es.error.cause.js";
 function _classPrivateMethodInitSpec(e, a) { _checkPrivateRedeclaration(e, a), a.add(e); }
 function _classPrivateFieldInitSpec(e, t, a) { _checkPrivateRedeclaration(e, t), t.set(e, a); }
 function _checkPrivateRedeclaration(e, t) { if (t.has(e)) throw new TypeError("Cannot initialize the same private elements twice on an object"); }

package/focusManager/index.js

@@ -1,7 +1,5 @@
 "use strict";
 
-require("core-js/modules/esnext.iterator.constructor.js");
-require("core-js/modules/esnext.iterator.for-each.js");
 exports.__esModule = true;
 var _exportNames = {
   createFocusScopeManager: true,

package/focusManager/scopeManager.js

@@ -2,11 +2,8 @@
 
 exports.__esModule = true;
 exports.createFocusScopeManager = createFocusScopeManager;
-require("core-js/modules/es.error.cause.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 _uniqueMap = require("../utils/dataStructures/uniqueMap");
+var _errors = require("../helpers/errors");
 var _scope = require("./scope");
 var _eventListener = require("./eventListener");
 var _constants = require("./constants");
@@ -107,7 +104,7 @@ function createFocusScopeManager(hotInstance) {
   function registerScope(scopeId, container) {
     let options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
     if (SCOPES.hasItem(scopeId)) {
-      throw new Error(`Scope with id "${scopeId}" already registered`);
+      (0, _errors.throwWithCause)(`Scope with id "${scopeId}" already registered`);
     }
     const scope = (0, _scope.createFocusScope)(hotInstance, container, options);
     SCOPES.addItem(scopeId, scope);
@@ -122,7 +119,7 @@ function createFocusScopeManager(hotInstance) {
    */
   function unregisterScope(scopeId) {
     if (!SCOPES.hasItem(scopeId)) {
-      throw new Error(`Scope with id "${scopeId}" not found`);
+      (0, _errors.throwWithCause)(`Scope with id "${scopeId}" not found`);
     }
     const scope = SCOPES.getItem(scopeId);
     scope.destroy();
@@ -138,7 +135,7 @@ function createFocusScopeManager(hotInstance) {
    */
   function activateScopeById(scopeId) {
     if (!SCOPES.hasItem(scopeId)) {
-      throw new Error(`Scope with id "${scopeId}" not found`);
+      (0, _errors.throwWithCause)(`Scope with id "${scopeId}" not found`);
     }
     activateScope(SCOPES.getItem(scopeId));
   }
@@ -152,7 +149,7 @@ function createFocusScopeManager(hotInstance) {
    */
   function deactivateScopeById(scopeId) {
     if (!SCOPES.hasItem(scopeId)) {
-      throw new Error(`Scope with id "${scopeId}" not found`);
+      (0, _errors.throwWithCause)(`Scope with id "${scopeId}" not found`);
     }
     deactivateScope(SCOPES.getItem(scopeId));
   }

package/focusManager/scopeManager.mjs

@@ -1,8 +1,5 @@
-import "core-js/modules/es.error.cause.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 { createUniqueMap } from "../utils/dataStructures/uniqueMap.mjs";
+import { throwWithCause } from "../helpers/errors.mjs";
 import { createFocusScope } from "./scope.mjs";
 import { useEventListener } from "./eventListener.mjs";
 import { FOCUS_SOURCES } from "./constants.mjs";
@@ -102,7 +99,7 @@ export function createFocusScopeManager(hotInstance) {
   function registerScope(scopeId, container) {
     let options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
     if (SCOPES.hasItem(scopeId)) {
-      throw new Error(`Scope with id "${scopeId}" already registered`);
+      throwWithCause(`Scope with id "${scopeId}" already registered`);
     }
     const scope = createFocusScope(hotInstance, container, options);
     SCOPES.addItem(scopeId, scope);
@@ -117,7 +114,7 @@ export function createFocusScopeManager(hotInstance) {
    */
   function unregisterScope(scopeId) {
     if (!SCOPES.hasItem(scopeId)) {
-      throw new Error(`Scope with id "${scopeId}" not found`);
+      throwWithCause(`Scope with id "${scopeId}" not found`);
     }
     const scope = SCOPES.getItem(scopeId);
     scope.destroy();
@@ -133,7 +130,7 @@ export function createFocusScopeManager(hotInstance) {
    */
   function activateScopeById(scopeId) {
     if (!SCOPES.hasItem(scopeId)) {
-      throw new Error(`Scope with id "${scopeId}" not found`);
+      throwWithCause(`Scope with id "${scopeId}" not found`);
     }
     activateScope(SCOPES.getItem(scopeId));
   }
@@ -147,7 +144,7 @@ export function createFocusScopeManager(hotInstance) {
    */
   function deactivateScopeById(scopeId) {
     if (!SCOPES.hasItem(scopeId)) {
-      throw new Error(`Scope with id "${scopeId}" not found`);
+      throwWithCause(`Scope with id "${scopeId}" not found`);
     }
     deactivateScope(SCOPES.getItem(scopeId));
   }

package/focusManager/utils/focusDetector.js

@@ -2,8 +2,6 @@
 
 exports.__esModule = true;
 exports.installFocusDetector = installFocusDetector;
-var _element = require("../../helpers/dom/element");
-var _a11y = require("../../helpers/a11y");
 var _constants = require("../constants");
 /**
  * @typedef {object} FocusDetector
@@ -60,13 +58,9 @@ function installFocusDetector(hot, wrapperElement) {
  */
 function createInputElement(hot, focusSource) {
   const rootDocument = hot.rootDocument;
-  const input = rootDocument.createElement('input');
-  input.type = 'text';
-  input.name = 'htFocusCatcher';
-  input.classList.add('htFocusCatcher');
-  input.dataset.htFocusSource = focusSource;
-  if (hot.getSettings().ariaTags) {
-    (0, _element.setAttribute)(input, [(0, _a11y.A11Y_LABEL)('Focus catcher')]);
-  }
-  return input;
+  const catcher = rootDocument.createElement('div');
+  catcher.style.display = 'none';
+  catcher.classList.add('htFocusCatcher');
+  catcher.dataset.htFocusSource = focusSource;
+  return catcher;
 }

package/focusManager/utils/focusDetector.mjs

@@ -1,5 +1,3 @@
-import { setAttribute } from "../../helpers/dom/element.mjs";
-import { A11Y_LABEL } from "../../helpers/a11y.mjs";
 import { FOCUS_SOURCES } from "../constants.mjs";
 /**
  * @typedef {object} FocusDetector
@@ -56,13 +54,9 @@ export function installFocusDetector(hot, wrapperElement) {
  */
 function createInputElement(hot, focusSource) {
   const rootDocument = hot.rootDocument;
-  const input = rootDocument.createElement('input');
-  input.type = 'text';
-  input.name = 'htFocusCatcher';
-  input.classList.add('htFocusCatcher');
-  input.dataset.htFocusSource = focusSource;
-  if (hot.getSettings().ariaTags) {
-    setAttribute(input, [A11Y_LABEL('Focus catcher')]);
-  }
-  return input;
+  const catcher = rootDocument.createElement('div');
+  catcher.style.display = 'none';
+  catcher.classList.add('htFocusCatcher');
+  catcher.dataset.htFocusSource = focusSource;
+  return catcher;
 }

package/helpers/a11y.js

@@ -37,6 +37,8 @@ const A11Y_DIALOG = () => ['role', 'dialog'];
 exports.A11Y_DIALOG = A11Y_DIALOG;
 const A11Y_ALERTDIALOG = () => ['role', 'alertdialog'];
 exports.A11Y_ALERTDIALOG = A11Y_ALERTDIALOG;
+const A11Y_GROUP = () => ['role', 'group'];
+exports.A11Y_GROUP = A11Y_GROUP;
 const A11Y_SCOPE_COL = () => ['scope', 'col'];
 exports.A11Y_SCOPE_COL = A11Y_SCOPE_COL;
 const A11Y_SCOPE_ROW = () => ['scope', 'row'];

package/helpers/a11y.mjs

@@ -16,6 +16,7 @@ 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_GROUP = () => ['role', 'group'];
 export const A11Y_SCOPE_COL = () => ['scope', 'col'];
 export const A11Y_SCOPE_ROW = () => ['scope', 'row'];
 export const A11Y_TEXT = () => ['type', 'text'];

package/helpers/array.js

@@ -10,6 +10,7 @@ exports.arrayMax = arrayMax;
 exports.arrayMin = arrayMin;
 exports.arrayReduce = arrayReduce;
 exports.arraySum = arraySum;
+exports.arrayToString = arrayToString;
 exports.arrayUnique = arrayUnique;
 exports.extendArray = extendArray;
 exports.getDifferenceOfArrays = getDifferenceOfArrays;
@@ -18,16 +19,6 @@ exports.getUnionOfArrays = getUnionOfArrays;
 exports.pivot = pivot;
 exports.stringToArray = stringToArray;
 exports.to2dArray = to2dArray;
-require("core-js/modules/es.array.push.js");
-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.filter.js");
 /**
  * @param {Array} arr An array to process.
  */
@@ -281,17 +272,25 @@ function getDifferenceOfArrays() {
 /**
  * Intersection of two or more arrays.
  *
- * @param {...Array} arrays Array of strings or array of numbers.
+ * @param {...Array<*|Function>} args Array of elements followed by a comparator function.
  * @returns {Array} Returns elements that exists in every array.
  */
 function getIntersectionOfArrays() {
-  for (var _len2 = arguments.length, arrays = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
-    arrays[_key2] = arguments[_key2];
+  for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
+    args[_key2] = arguments[_key2];
   }
-  const [first, ...rest] = [...arrays];
+  const lastArgument = args[args.length - 1];
+  let comparator;
+  let arrays = args;
+  if (typeof lastArgument === 'function') {
+    comparator = lastArgument;
+    arrays = arrays.slice(0, -1);
+  }
+  const isMatch = comparator ? (value, array) => array.some(item => comparator(value, item)) : (value, array) => array.includes(value);
+  const [first, ...rest] = arrays;
   let filteredFirstArray = first;
   arrayEach(rest, array => {
-    filteredFirstArray = filteredFirstArray.filter(value => array.includes(value));
+    filteredFirstArray = filteredFirstArray.filter(value => isMatch(value, array));
   });
   return filteredFirstArray;
 }
@@ -328,4 +327,16 @@ function getUnionOfArrays() {
 function stringToArray(value) {
   let delimiter = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : ' ';
   return value.split(delimiter);
+}
+
+/**
+ * Convert an array of strings to a single string.
+ *
+ * @param {string[]} array Array of strings.
+ * @param {string} separator Separator string.
+ * @returns {string} Returns a string made by joining all array elements with a separator.
+ */
+function arrayToString(array) {
+  let separator = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : ' ';
+  return array.join(separator);
 }

package/helpers/array.mjs

@@ -1,13 +1,3 @@
-import "core-js/modules/es.array.push.js";
-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.filter.js";
 /**
  * @param {Array} arr An array to process.
  */
@@ -261,17 +251,25 @@ export function getDifferenceOfArrays() {
 /**
  * Intersection of two or more arrays.
  *
- * @param {...Array} arrays Array of strings or array of numbers.
+ * @param {...Array<*|Function>} args Array of elements followed by a comparator function.
  * @returns {Array} Returns elements that exists in every array.
  */
 export function getIntersectionOfArrays() {
-  for (var _len2 = arguments.length, arrays = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
-    arrays[_key2] = arguments[_key2];
+  for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
+    args[_key2] = arguments[_key2];
   }
-  const [first, ...rest] = [...arrays];
+  const lastArgument = args[args.length - 1];
+  let comparator;
+  let arrays = args;
+  if (typeof lastArgument === 'function') {
+    comparator = lastArgument;
+    arrays = arrays.slice(0, -1);
+  }
+  const isMatch = comparator ? (value, array) => array.some(item => comparator(value, item)) : (value, array) => array.includes(value);
+  const [first, ...rest] = arrays;
   let filteredFirstArray = first;
   arrayEach(rest, array => {
-    filteredFirstArray = filteredFirstArray.filter(value => array.includes(value));
+    filteredFirstArray = filteredFirstArray.filter(value => isMatch(value, array));
   });
   return filteredFirstArray;
 }
@@ -308,4 +306,16 @@ export function getUnionOfArrays() {
 export function stringToArray(value) {
   let delimiter = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : ' ';
   return value.split(delimiter);
+}
+
+/**
+ * Convert an array of strings to a single string.
+ *
+ * @param {string[]} array Array of strings.
+ * @param {string} separator Separator string.
+ * @returns {string} Returns a string made by joining all array elements with a separator.
+ */
+export function arrayToString(array) {
+  let separator = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : ' ';
+  return array.join(separator);
 }

package/helpers/console.js

@@ -5,7 +5,9 @@ exports.deprecatedWarn = deprecatedWarn;
 exports.error = error;
 exports.info = info;
 exports.log = log;
+exports.logAggregatedItems = logAggregatedItems;
 exports.warn = warn;
+var _string = require("./string");
 var _mixed = require("./mixed");
 /* eslint-disable no-console */
 /* eslint-disable no-restricted-globals */
@@ -70,4 +72,35 @@ function error() {
   if ((0, _mixed.isDefined)(console)) {
     console.error(...arguments);
   }
+}
+
+/**
+ * Logs an aggregated log message with a sample list of items.
+ *
+ * @param {object} options Log options.
+ * @param {Function} [options.logFunction] Function to log the message.
+ * @param {string} options.message Message template.
+ * @param {Array} options.items List of items to aggregate.
+ * @param {number} [options.maxSample=5] Maximum number of items to list.
+ * @param {Function} [options.itemFormatter] Formatter for each item.
+ */
+function logAggregatedItems() {
+  let {
+    logFunction = log,
+    message,
+    items,
+    maxSample = 5,
+    itemFormatter = item => `${item}`
+  } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  if (!Array.isArray(items) || items.length === 0) {
+    return;
+  }
+  const count = items.length;
+  const formattedItems = items.slice(0, maxSample).map(item => `  - ${itemFormatter(item)}`);
+  const more = count > maxSample ? `  - ...and ${count - maxSample} more` : '';
+  const affectedLines = ['Affected cells:', ...formattedItems, ...(more ? [more] : [])].join('\n');
+  logFunction((0, _string.substitute)(message, {
+    itemsCount: `${count} cell${count > 1 ? 's' : ''}`,
+    affectedCells: affectedLines
+  }));
 }

package/helpers/console.mjs

@@ -1,3 +1,4 @@
+import { substitute } from "./string.mjs";
 /* eslint-disable no-console */
 /* eslint-disable no-restricted-globals */
 /**
@@ -60,4 +61,35 @@ export function error() {
   if (isDefined(console)) {
     console.error(...arguments);
   }
+}
+
+/**
+ * Logs an aggregated log message with a sample list of items.
+ *
+ * @param {object} options Log options.
+ * @param {Function} [options.logFunction] Function to log the message.
+ * @param {string} options.message Message template.
+ * @param {Array} options.items List of items to aggregate.
+ * @param {number} [options.maxSample=5] Maximum number of items to list.
+ * @param {Function} [options.itemFormatter] Formatter for each item.
+ */
+export function logAggregatedItems() {
+  let {
+    logFunction = log,
+    message,
+    items,
+    maxSample = 5,
+    itemFormatter = item => `${item}`
+  } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  if (!Array.isArray(items) || items.length === 0) {
+    return;
+  }
+  const count = items.length;
+  const formattedItems = items.slice(0, maxSample).map(item => `  - ${itemFormatter(item)}`);
+  const more = count > maxSample ? `  - ...and ${count - maxSample} more` : '';
+  const affectedLines = ['Affected cells:', ...formattedItems, ...(more ? [more] : [])].join('\n');
+  logFunction(substitute(message, {
+    itemsCount: `${count} cell${count > 1 ? 's' : ''}`,
+    affectedCells: affectedLines
+  }));
 }

package/helpers/constants.js

@@ -0,0 +1,4 @@
+"use strict";
+
+exports.__esModule = true;
+const BAD_VALUE_TEXT = exports.BAD_VALUE_TEXT = '#bad-value#';

package/helpers/constants.mjs

@@ -0,0 +1 @@
+export const BAD_VALUE_TEXT = '#bad-value#';

package/helpers/data.js

@@ -10,10 +10,6 @@ exports.isArrayOfArrays = isArrayOfArrays;
 exports.isArrayOfObjects = isArrayOfObjects;
 exports.spreadsheetColumnIndex = spreadsheetColumnIndex;
 exports.spreadsheetColumnLabel = spreadsheetColumnLabel;
-require("core-js/modules/es.array.push.js");
-require("core-js/modules/esnext.iterator.constructor.js");
-require("core-js/modules/esnext.iterator.every.js");
-require("core-js/modules/esnext.iterator.for-each.js");
 var _object = require("./object");
 const COLUMN_LABEL_BASE = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
 const COLUMN_LABEL_BASE_LENGTH = COLUMN_LABEL_BASE.length;

package/helpers/data.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.every.js";
-import "core-js/modules/esnext.iterator.for-each.js";
 import { deepObjectSize, isObject } from "./object.mjs";
 const COLUMN_LABEL_BASE = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
 const COLUMN_LABEL_BASE_LENGTH = COLUMN_LABEL_BASE.length;

package/helpers/dateTime.d.ts

@@ -0,0 +1,5 @@
+export function getNormalizedDate(dateString: string): Date;
+export function parseToLocalTime(timeString: string): Date | null;
+export function isValidTime(timeString: string): boolean;
+export function parseToLocalDate(dateString: string): Date | null;
+export function isValidDate(dateString: string): boolean;

package/helpers/dateTime.js

@@ -0,0 +1,110 @@
+"use strict";
+
+exports.__esModule = true;
+exports.getNormalizedDate = getNormalizedDate;
+exports.isValidISODate = isValidISODate;
+exports.isValidTime = isValidTime;
+exports.parseToLocalDate = parseToLocalDate;
+exports.parseToLocalTime = parseToLocalTime;
+var _mixed = require("./mixed");
+/**
+ * ISO 8601 date pattern.
+ *
+ * @type {RegExp}
+ */
+const ISO_DATE_REGEX = exports.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.
+ */
+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.
+ */
+function parseToLocalDate(value) {
+  if ((0, _mixed.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.
+ */
+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}
+ */
+const TIME_REGEX = exports.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.
+ */
+function parseToLocalTime(value) {
+  if ((0, _mixed.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.
+ */
+function isValidTime(value) {
+  return typeof value === 'string' && TIME_REGEX.test(value);
+}