@esri/calcite-components 1.9.0-next.9 → 1.9.0

package/dist/components/globalAttributes.js

@@ -0,0 +1,69 @@
+/*!
+ * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
+ * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
+ * v1.9.0
+ */
+import { c as createObserver } from './observers.js';
+
+const allowedGlobalAttributes = ["lang", "role", "aria-expanded"];
+const elementToComponentAndObserverOptionsMap = new Map();
+let mutationObserver;
+function updateGlobalAttributes(component, attributeFilter, reuseAttributes = false) {
+  const { el } = component;
+  const updatedAttributes = reuseAttributes ? component.globalAttributes : {};
+  attributeFilter
+    .filter((attr) => !!allowedGlobalAttributes.includes(attr) && !!el.hasAttribute(attr))
+    .forEach((attr) => {
+    const value = el.getAttribute(attr);
+    if (value !== null) {
+      updatedAttributes[attr] = value;
+    }
+  });
+  component.globalAttributes = updatedAttributes;
+}
+function processMutations(mutations) {
+  mutations.forEach(({ target }) => {
+    const [component, options] = elementToComponentAndObserverOptionsMap.get(target);
+    updateGlobalAttributes(component, options.attributeFilter);
+  });
+}
+/**
+ * Helper to set up listening for changes to global attributes.
+ *
+ * render(): VNode {
+ * return (<Host>
+ * <ul {...this.globalAttributes}></div>
+ * </Host>);
+ * }
+ *
+ * @param component
+ * @param attributeFilter
+ */
+function watchGlobalAttributes(component, attributeFilter) {
+  const { el } = component;
+  const observerOptions = { attributeFilter };
+  elementToComponentAndObserverOptionsMap.set(el, [component, observerOptions]);
+  updateGlobalAttributes(component, attributeFilter, true);
+  if (!mutationObserver) {
+    mutationObserver = createObserver("mutation", processMutations);
+  }
+  mutationObserver.observe(el, observerOptions);
+}
+/**
+ * Helper remove listening for changes to inherited attributes.
+ *
+ * @param component
+ */
+function unwatchGlobalAttributes(component) {
+  elementToComponentAndObserverOptionsMap.delete(component.el);
+  // we explicitly process queued mutations and disconnect and reconnect
+  // the observer until MutationObserver gets an `unobserve` method
+  // see https://github.com/whatwg/dom/issues/126
+  processMutations(mutationObserver.takeRecords());
+  mutationObserver.disconnect();
+  for (const [element, [, observerOptions]] of elementToComponentAndObserverOptionsMap.entries()) {
+    mutationObserver.observe(element, observerOptions);
+  }
+}
+
+export { unwatchGlobalAttributes as u, watchGlobalAttributes as w };

package/dist/components/graph.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { proxyCustomElement, HTMLElement, forceUpdate, h } from '@stencil/core/internal/client/index.js';
 import { g as guid } from './guid.js';

package/dist/components/guid.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 function gen(counts) {
   return counts

package/dist/components/handle.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { proxyCustomElement, HTMLElement, createEvent, h } from '@stencil/core/internal/client/index.js';
 import { t as toAriaBoolean } from './dom.js';

package/dist/components/he.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/hi.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/hr.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/hu.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/icon.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { getAssetPath, proxyCustomElement, HTMLElement, h, Host, Build } from '@stencil/core/internal/client/index.js';
 import { b as getElementDir, t as toAriaBoolean } from './dom.js';

package/dist/components/id.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/index.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 export { getAssetPath, setAssetPath, setNonce, setPlatformOptions } from '@stencil/core/internal/client/index.js';
 import { d as darkMode, a as autoMode } from './dom.js';

package/dist/components/index2.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 function createCommonjsModule(fn, basedir, module) {
 	return module = {

package/dist/components/index3.js

@@ -0,0 +1,170 @@
+/*!
+ * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
+ * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
+ * v1.9.0
+ */
+const supportedTimeZones = Intl.supportedValuesOf('timeZone');
+
+const now = new Date();
+const startDate = now.toISOString();
+const daysInYear = 365;
+const groupDateRange = daysInYear;
+const defaultGroupingOptions = {
+    startDate,
+    groupDateRange,
+    debug: false,
+};
+
+/* eslint-disable @typescript-eslint/no-unsafe-argument, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-return */
+const continentAllowList = new Set([
+    'Europe',
+    'Asia',
+    'America',
+    'America/Argentina',
+    'Africa',
+    'Australia',
+    'Pacific',
+    'Atlantic',
+    'Antarctica',
+    'Arctic',
+    'Indian',
+]);
+const _getDates = (startDate, numberDays, dateEngine) => {
+    const dateArray = [];
+    let date = dateEngine.create(startDate);
+    for (let i = 0; i <= numberDays; i++) {
+        date = dateEngine.increase(date);
+        dateArray.push(dateEngine.formatToIsoDateString(date));
+    }
+    return dateArray;
+};
+const _extractContinent = (label) => {
+    if (label.includes('Istanbul')) {
+        return 'Europe';
+    }
+    const lastIndex = label.lastIndexOf('/');
+    return lastIndex === -1 ? label : label.slice(0, lastIndex);
+};
+const _isRegularContinent = (continent) => continentAllowList.has(continent);
+const generateTimeZoneMetadata = (timeZoneItems, startDate, numberDays, dateEngine, debug = false) => {
+    const processedDates = new Map();
+    if (debug) {
+        console.log(`Initializing data starting ${startDate} with ${numberDays} days in the future, comparing ${timeZoneItems.length} timezones`);
+    }
+    const theDates = _getDates(startDate, numberDays, dateEngine);
+    return timeZoneItems.map((tzItem) => {
+        const label = tzItem.label;
+        const continent = _extractContinent(label);
+        const dates = theDates.map((date) => {
+            const key = `${date}-${label}`;
+            let utc = processedDates.get(key);
+            if (utc) {
+                return utc;
+            }
+            utc = dateEngine.isoToTimeZone(date, label);
+            processedDates.set(key, utc);
+            return utc;
+        });
+        return {
+            ...tzItem,
+            continent,
+            isRegularContinent: _isRegularContinent(continent),
+            dates,
+        };
+    });
+};
+const compareDateArrs = (array1, array2, dateEngine) => array1.length === array2.length &&
+    array1.every((value, index) => dateEngine.same(value, array2[index]));
+const getGroupLabelTimeZoneIndices = (rawTZs, max = 5) => {
+    const shrinkedTzs = rawTZs.filter(({ label }) => _isRegularContinent(_extractContinent(label)));
+    rawTZs = shrinkedTzs.length === 0 ? [rawTZs[0]] : shrinkedTzs;
+    const uniqueLabels = [...new Set(rawTZs.map((_tz, index) => index))];
+    return equallyDistributedSampling(uniqueLabels, max);
+};
+function equallyDistributedSampling(items, maxItems = 5) {
+    const totalItems = items.length;
+    if (totalItems <= maxItems) {
+        return items;
+    }
+    const numberItemsToSelect = Math.min(totalItems - 2, maxItems - 2);
+    const stepSize = (totalItems - 1) / (numberItemsToSelect + 1);
+    return [
+        items[0],
+        ...Array.from({ length: numberItemsToSelect }, (_, i) => items[Math.round((i + 1) * stepSize)]),
+        items[totalItems - 1],
+    ];
+}
+
+async function groupTimeZones(options) {
+    const { debug, groupDateRange, hooks, startDate, dateEngine } = {
+        ...defaultGroupingOptions,
+        ...options,
+    };
+    const grouping = [];
+    if (!dateEngine) {
+        throw new Error('dateEngine is required');
+    }
+    const timeZoneItems = supportedTimeZones.map((tz) => ({ label: tz }));
+    hooks?.onBeforeTimeZoneMetadataCreate?.(timeZoneItems);
+    const timeZoneMetadata = generateTimeZoneMetadata(timeZoneItems, startDate, groupDateRange, dateEngine, debug);
+    hooks?.onTimeZoneMetadataCreate?.(timeZoneMetadata);
+    // We traverse the mappedDB and see if we find matches by comparing each set
+    // of transformed date for that specific TZ.
+    for (const tzMetadatumI of timeZoneMetadata) {
+        const { label, continent, dates } = tzMetadatumI;
+        // ignore if we visited this element already
+        if (tzMetadatumI.visited) {
+            continue;
+        }
+        // Mark element as already visited
+        tzMetadatumI.visited = true;
+        // The grouped timezone that we want as a result
+        const newGroup = {
+            labelTzIndices: undefined,
+            tzs: [{ label }],
+        };
+        hooks?.onGroupCreate?.(newGroup, tzMetadatumI);
+        for (const tzMetadatumJ of timeZoneMetadata.filter((_) => !_.visited)) {
+            const { label: labelJ, continent: continentJ, isRegularContinent: isRegularContinentJ, dates: datesJ, } = tzMetadatumJ;
+            // We define a matching TZ by:
+            // 1) if both continents match (avoid grouping Antarctica with anything else)
+            // 2) if the transformed dates match in both TZs
+            if ((continent === continentJ || !isRegularContinentJ) &&
+                compareDateArrs(dates, datesJ, dateEngine)) {
+                const tzItem = { label: labelJ };
+                newGroup.tzs.push(tzItem);
+                hooks?.onGroupTimeZoneAdd?.(newGroup, tzItem, tzMetadatumJ);
+                // Mark element as already visited
+                tzMetadatumJ.visited = true;
+            }
+        }
+        grouping.push(newGroup);
+        hooks?.onGroupAdd?.(newGroup);
+    }
+    // Now that we have a group, we want an easy way to find a fitting label for the group
+    // which is defined as the list of the most-common 7 cities, shown in alphabetical order
+    const finalGrouping = grouping
+        .map((group) => {
+        hooks?.onBeforeFinalGroupCreate?.(group);
+        const finalGrouping = {
+            labelTzIndices: getGroupLabelTimeZoneIndices(group.tzs, 7),
+            tzs: group.tzs.map((_) => _.label).sort(),
+        };
+        hooks?.onFinalGroupCreate?.(finalGrouping, group);
+        return finalGrouping;
+    })
+        .sort((a, b) => b.tzs.length - a.tzs.length);
+    if (debug) {
+        const missingTzs = supportedTimeZones
+            .map((tz) => (finalGrouping.some((y) => y.tzs.includes(tz)) ? null : tz))
+            .filter(Boolean);
+        if (missingTzs.length > 0) {
+            throw new Error(`There are ${missingTzs.length} missing timezones: ${missingTzs.toString()}`);
+        }
+    }
+    return hooks?.onFinalGroupingCreate
+        ? hooks.onFinalGroupingCreate(finalGrouping)
+        : finalGrouping;
+}
+
+export { groupTimeZones };

package/dist/components/index4.js

@@ -0,0 +1,71 @@
+/*!
+ * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
+ * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
+ * v1.9.0
+ */
+class NativeDateEngine {
+    _formatterCache = new Map();
+    _commonDateTimeFormatterOptions = {
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        timeZoneName: 'shortOffset',
+    };
+    get name() {
+        return 'native';
+    }
+    create(date) {
+        return new Date(date);
+    }
+    increase(date) {
+        const oneDayInMs = 86400000;
+        return new Date(date.getTime() + oneDayInMs);
+    }
+    formatToIsoDateString(date) {
+        const year = date.getFullYear();
+        const month = date.getMonth() + 1;
+        const day = date.getDate();
+        return `${year}-${month.toString().padStart(2, '0')}-${day
+            .toString()
+            .padStart(2, '0')}`;
+    }
+    isoToTimeZone(isoDate, tz) {
+        const date = this._toDate(isoDate);
+        const formatter = this._getFormatter(tz);
+        const parts = formatter.formatToParts(date);
+        const [month, day, year, offset] = parts
+            .filter(({ type }) => type !== 'literal')
+            .map(({ value }) => value);
+        const tzOffset = this._getTimeZoneOffsetInMins(offset);
+        return new Date(Date.UTC(Number(year), Number(month) - 1, Number(day), 0, -tzOffset));
+    }
+    same(date1, date2) {
+        return date1.getTime() === date2.getTime();
+    }
+    _toDate(isoDate) {
+        const dateParts = isoDate.split('-');
+        const year = Number(dateParts[0]);
+        const month = Number(dateParts[1]) - 1;
+        const day = Number(dateParts[2]);
+        return new Date(year, month, day);
+    }
+    _getFormatter(tz) {
+        let formatter = this._formatterCache.get(tz);
+        if (!formatter) {
+            formatter = new Intl.DateTimeFormat('en-US', {
+                timeZone: tz,
+                ...this._commonDateTimeFormatterOptions,
+            });
+            this._formatterCache.set(tz, formatter);
+        }
+        return formatter;
+    }
+    _getTimeZoneOffsetInMins(gmtTimeZone) {
+        const [sign, ...hoursMinutes] = gmtTimeZone.slice(3);
+        const [hours, minutes] = hoursMinutes.join('').split(':');
+        const signMultiplier = sign === '+' ? 1 : -1;
+        return signMultiplier * (Number(hours) * 60 + Number(minutes || 0));
+    }
+}
+
+export { NativeDateEngine as DateEngine };

package/dist/components/input-number.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { proxyCustomElement, HTMLElement, createEvent, h, Host } from '@stencil/core/internal/client/index.js';
 import { g as getSlotted, j as isPrimaryPointerButton, h as setRequestedIcon, b as getElementDir, C as CSS_UTILITY } from './dom.js';

package/dist/components/input-text.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { proxyCustomElement, HTMLElement, createEvent, h, Host } from '@stencil/core/internal/client/index.js';
 import { g as getSlotted, h as setRequestedIcon, b as getElementDir, C as CSS_UTILITY } from './dom.js';

package/dist/components/input.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { proxyCustomElement, HTMLElement, createEvent, h, Host } from '@stencil/core/internal/client/index.js';
 import { g as getSlotted, j as isPrimaryPointerButton, h as setRequestedIcon, b as getElementDir, C as CSS_UTILITY } from './dom.js';

package/dist/components/interactive.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { Build } from '@stencil/core/internal/client/index.js';
 

package/dist/components/it-ch.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/it.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/ja.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/key.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 function isActivationKey(key) {
   return key === "Enter" || key === " ";

package/dist/components/ko.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/label.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { proxyCustomElement, HTMLElement, createEvent, h, Host } from '@stencil/core/internal/client/index.js';
 import { l as labelConnectedEvent, a as labelDisconnectedEvent } from './label2.js';

package/dist/components/label2.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { x as isBefore, q as queryElementRoots, c as closestElementCrossShadowBoundary } from './dom.js';
 

package/dist/components/link.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { proxyCustomElement, HTMLElement, h, Host } from '@stencil/core/internal/client/index.js';
 import { b as getElementDir, C as CSS_UTILITY, k as focusElement } from './dom.js';

package/dist/components/loadable.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { Build, forceUpdate } from '@stencil/core/internal/client/index.js';
 

package/dist/components/loader.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { proxyCustomElement, HTMLElement, h, Host } from '@stencil/core/internal/client/index.js';
 import { g as guid } from './guid.js';

package/dist/components/locale.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { w as containsCrossShadowBoundary, c as closestElementCrossShadowBoundary } from './dom.js';
 import { n as numberKeys } from './key.js';

package/dist/components/lt.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/lv.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/math.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-design-system/blob/main/LICENSE.md for details.
- * v1.9.0-next.9
+ * v1.9.0
  */
 const clamp = (value, min, max) => Math.max(min, Math.min(value, max));
 const decimalNumberRegex = new RegExp(/(?:\.(\d+))?(?:[eE]([+-]?\d+))?$/);