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

package/dist/components/da.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.1-next.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/date-picker-day.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.1-next.0
  */
 import { proxyCustomElement, HTMLElement, createEvent, h, Host } from '@stencil/core/internal/client/index.js';
 import { c as dateToISO } from './date.js';

package/dist/components/date-picker-month-header.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.1-next.0
  */
 import { proxyCustomElement, HTMLElement, createEvent, h, Fragment } from '@stencil/core/internal/client/index.js';
 import { j as getOrder, f as dateFromRange, n as nextMonth, p as prevMonth, k as formatCalendarYear, l as parseCalendarYear } from './date.js';

package/dist/components/date-picker-month.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.1-next.0
  */
 import { proxyCustomElement, HTMLElement, createEvent, h, Host } from '@stencil/core/internal/client/index.js';
 import { h as sameDate, f as dateFromRange, i as inRange } from './date.js';

package/dist/components/date-picker.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.1-next.0
  */
 import { getAssetPath, proxyCustomElement, HTMLElement, createEvent, h, Host, Build } from '@stencil/core/internal/client/index.js';
 import { e as dateFromISO, g as getDaysDiff, c as dateToISO, f as dateFromRange, s as setEndOfDay } from './date.js';

package/dist/components/date.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.1-next.0
  */
 import { n as numberStringFormatter } from './locale.js';
 

package/dist/components/de-at.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.1-next.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/de-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.1-next.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/de.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.1-next.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/debounce.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.1-next.0
  */
 /** Detect free variable `global` from Node.js. */
 var freeGlobal = typeof global == 'object' && global && global.Object === Object && global;

package/dist/components/dom.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.1-next.0
  */
 import { g as guid } from './guid.js';
 

package/dist/components/dropdown.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.1-next.0
  */
 import { proxyCustomElement, HTMLElement, createEvent, h, Host } from '@stencil/core/internal/client/index.js';
 import { t as toAriaBoolean, j as isPrimaryPointerButton, i as focusElementInGroup, k as focusElement } from './dom.js';

package/dist/components/el.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.1-next.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/en-au.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.1-next.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/en-ca.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.1-next.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/en-gb.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.1-next.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/es-mx.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.1-next.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/es.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.1-next.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/et.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.1-next.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/fi.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.1-next.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/filter.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.1-next.0
  */
 import { proxyCustomElement, HTMLElement, createEvent, h, Fragment } from '@stencil/core/internal/client/index.js';
 import { f as filter } from './filter2.js';

package/dist/components/filter2.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.1-next.0
  */
 import { a as isSymbol, S as Symbol, i as isObject, b as baseGetTag, c as isObjectLike, r as root, f as freeGlobal } from './debounce.js';
 

package/dist/components/floating-ui.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.1-next.0
  */
 import { Build } from '@stencil/core/internal/client/index.js';
 import { b as getElementDir } from './dom.js';

package/dist/components/focusTrapComponent.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.1-next.0
  */
 import { y as tabbable, z as focusable, A as isTabbable, B as getTabIndex, D as isFocusable, k as focusElement, E as tabbableOptions } from './dom.js';
 

package/dist/components/form.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.1-next.0
  */
 import { q as queryElementRoots, c as closestElementCrossShadowBoundary } from './dom.js';
 import { h } from '@stencil/core/internal/client/index.js';

package/dist/components/fr-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.1-next.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

package/dist/components/fr.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.1-next.0
  */
 import { d as dayjs } from './calcite-input-time-picker.js';
 

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.1-next.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.1-next.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.1-next.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.1-next.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.1-next.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.1-next.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.1-next.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.1-next.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.1-next.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.1-next.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.1-next.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.1-next.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.1-next.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 };