@arcgis/components-utils 4.33.0-next.16 → 4.33.0-next.160

package/dist/index.js

@@ -1,5 +1,4 @@
-// src/array-utils.ts
-function mappedFind(array, callback) {
+const mappedFind = (array, callback) => {
   for (let i = 0; i < array.length; i++) {
     const value = callback(array[i], i);
     if (value != null) {
@@ -7,10 +6,8 @@ function mappedFind(array, callback) {
     }
   }
   return;
-}
-
-// src/css-utils.ts
-function classes(...classes2) {
+};
+const classes = (...classes2) => {
   const effectiveClasses = [];
   for (let i = 0; i < classes2.length; i++) {
     const arg = classes2[i];
@@ -29,21 +26,8 @@ function classes(...classes2) {
   const className = effectiveClasses.join(" ");
   effectiveClasses.length = 0;
   return className;
-}
-
-// src/deferred.ts
-var Deferred = class {
-  /**
-   * Resolves the promise.
-   * @param value The value to resolve the promise with.
-   */
-  resolve(_value) {
-  }
-  /**
-   * Rejects the promise.
-   */
-  reject(_error) {
-  }
+};
+class Deferred {
   /**
    * Creates a new deferred promise.
    */
@@ -53,10 +37,8 @@ var Deferred = class {
       this.reject = reject;
     });
   }
-};
-
-// src/dom.ts
-function inTargetElement(element, targetElement) {
+}
+const inTargetElement = (element, targetElement) => {
   let currentElement = element;
   while (currentElement) {
     if (currentElement === targetElement) {
@@ -72,18 +54,18 @@ function inTargetElement(element, targetElement) {
     }
   }
   return false;
-}
-function observeAncestorsMutation(element, attributeFilter, callback) {
-  const { subscribe } = observe(attributeFilter);
+};
+const observeAncestorsMutation = (element, attributeFilter, callback) => {
+  const subscribe = observe(attributeFilter).subscribe;
   return subscribe((mutations) => {
     const matched = mutations.some((mutation) => inTargetElement(element, mutation.target));
     if (matched) {
       callback();
     }
   });
-}
-var observers = {};
-function observe(attributeFilter) {
+};
+const observers = {};
+const observe = (attributeFilter) => {
   const attributes = attributeFilter.join(",");
   const previousObserver = observers[attributes];
   if (previousObserver !== void 0) {
@@ -99,7 +81,7 @@ function observe(attributeFilter) {
     });
   }
   const observer = {
-    subscribe(callback) {
+    subscribe: (callback) => {
       subscribers.add(callback);
       return () => {
         subscribers.delete(callback);
@@ -112,8 +94,8 @@ function observe(attributeFilter) {
   };
   observers[attributes] = observer;
   return observer;
-}
-function closestElement(base, selector) {
+};
+const closestElement = (base, selector) => {
   let currentElement = base;
   while (currentElement) {
     const element = currentElement.closest?.(selector);
@@ -127,25 +109,19 @@ function closestElement(base, selector) {
     currentElement = rootElement.host;
   }
   return null;
-}
-function getElementTheme(base) {
+};
+const getElementTheme = (base) => {
   const themeElement = closestElement(base, ":is(.calcite-mode-light, .calcite-mode-dark)");
   return themeElement?.classList.contains("calcite-mode-dark") ? "dark" : "light";
-}
-function getElementDir(el) {
-  return getElementAttribute(el, "dir", "ltr");
-}
-function getElementAttribute(el, prop, fallbackValue) {
+};
+const getElementDir = (el) => getElementAttribute(el, "dir", "ltr");
+const getElementAttribute = (el, prop, fallbackValue) => {
   const closest = closestElement(el, `[${prop}]`);
   return closest?.getAttribute(prop) ?? fallbackValue;
-}
-function isElement(ref) {
-  return ref.nodeType === Node.ELEMENT_NODE;
-}
-function hasSetFocus(ref) {
-  return typeof ref.setFocus === "function";
-}
-function setFocus(ref, selector = "") {
+};
+const isElement = (ref) => ref.nodeType === Node.ELEMENT_NODE;
+const hasSetFocus = (ref) => typeof ref.setFocus === "function";
+const setFocus = (ref, selector = "") => {
   if (!isElement(ref)) {
     return false;
   }
@@ -169,8 +145,8 @@ function setFocus(ref, selector = "") {
     }
   }
   return false;
-}
-async function focusElement(el) {
+};
+const focusElement = async (el) => {
   if (el == null) {
     return;
   }
@@ -179,8 +155,8 @@ async function focusElement(el) {
   } else {
     el.focus();
   }
-}
-function setFocusOnElement(ref, selector) {
+};
+const setFocusOnElement = (ref, selector) => {
   if (!ref?.shadowRoot) {
     return;
   }
@@ -189,104 +165,69 @@ function setFocusOnElement(ref, selector) {
     return;
   }
   void Promise.resolve(ref.componentOnReady?.()).then(() => setFocus(ref, selector));
-}
-
-// src/errors.ts
-function isEsriInternalEnv() {
-  return typeof globalThis.process === "object" && !!process.env.ESRI_INTERNAL;
-}
-function safeCall(callback, thisContext, ...rest) {
+};
+const isEsriInternalEnv = () => (
+  /*
+   * `globalThis.` is important here. Some bundlers remove the `typeof process`
+   * checks, but don't remove the usages of undefined variables - this can cause
+   * runtime error. By adding `globalThis.`, we avoid having `typeof process`
+   * check removed by the bundler.
+   * This does meant tree-shaking won't happen for the isEsriInternalEnv()
+   * check, but this is ok since this check is meant to always be behind the
+   * development/test guard.
+   * See https://devtopia.esri.com/WebGIS/arcgis-web-components/pull/2087#issuecomment-5152454
+   */
+  typeof globalThis.process === "object" && !!process.env.ESRI_INTERNAL
+);
+const safeCall = (callback, thisContext, ...rest) => {
   try {
     return callback?.call(thisContext, ...rest);
   } catch (error) {
     console.error(error, callback);
   }
   return void 0;
-}
-async function safeAsyncCall(callback, thisContext, ...rest) {
+};
+const safeAsyncCall = async (callback, thisContext, ...rest) => {
   try {
     const result = callback?.call(thisContext, ...rest);
-    return result instanceof Promise ? await result : result;
+    return await result;
   } catch (error) {
     console.error(error, callback);
   }
   return void 0;
-}
-
-// src/guid.ts
-function gen(count) {
+};
+const gen = (count) => {
   let out = "";
   for (let i = 0; i < count; i++) {
     out += ((1 + Math.random()) * 65536 | 0).toString(16).substring(1);
   }
   return out;
-}
-function generateGuid() {
-  return [gen(2), gen(1), gen(1), gen(1), gen(3)].join("-");
-}
-
-// src/intl.ts
-var supportedLocalesArray = [
-  "ar",
-  "bg",
-  "bs",
-  "ca",
-  "cs",
-  "da",
-  "de",
-  "el",
-  "en",
-  "es",
-  "et",
-  "fi",
-  "fr",
-  "he",
-  "hr",
-  "hu",
-  "id",
-  "it",
-  "ja",
-  "ko",
-  "lt",
-  "lv",
-  "nl",
-  "nb",
-  "no",
-  "pl",
-  "pt-BR",
-  "pt-PT",
-  "ro",
-  "ru",
-  "sk",
-  "sl",
-  "sr",
-  "sv",
-  "th",
-  "tr",
-  "uk",
-  "vi",
-  "zh-CN",
-  "zh-HK",
-  "zh-TW"
-];
-var supportedLocales = /* @__PURE__ */ new Set(supportedLocalesArray);
-var defaultLocale = "en";
-var localeEquivalencies = {
+};
+const generateGuid = () => [gen(2), gen(1), gen(1), gen(1), gen(3)].join("-");
+const supportedLocalesArray = "ar,bg,bs,ca,cs,da,de,el,en,es,et,fi,fr,he,hr,hu,id,it,ja,ko,lt,lv,nl,nb,no,pl,pt-BR,pt-PT,ro,ru,sk,sl,sr,sv,th,tr,uk,vi,zh-CN,zh-HK,zh-TW".split(
+  ","
+);
+const supportedLocales = /* @__PURE__ */ new Set(supportedLocalesArray);
+const defaultLocale = "en";
+const localeEquivalencies = {
   // We use `pt-PT` as it will have the same translations as `pt`, which has no corresponding bundle
   pt: "pt-PT",
   // We support both 'nb' and 'no' (BCP 47) for Norwegian but only `no` has corresponding bundle
   nb: "no",
+  // We support both 'nn' and 'no' (BCP 47) for Norwegian but only `no` has corresponding bundle
+  // See https://devtopia.esri.com/WebGIS/arcgis-web-components/issues/4667
+  nn: "no",
   // We use `zh-CN` as base translation for chinese locales which has no corresponding bundle.
   zh: "zh-CN"
 };
-async function fetchT9nStringsBundle(locale, assetsPath, prefix = "") {
+const fetchT9nStringsBundle = async (locale, assetsPath, prefix = "") => {
   const path = `${assetsPath}/${prefix}`;
   const filePath = `${path}${locale}.json`;
   t9nStringsCache[filePath] ?? (t9nStringsCache[filePath] = fetchBundle(locale, path));
   return await t9nStringsCache[filePath];
-}
-var t9nStringsCache = {};
-async function fetchBundle(locale, path) {
+};
+const t9nStringsCache = {};
+const fetchBundle = async (locale, path) => {
   const filePath = `${path}${locale}.json`;
   try {
     const response = await fetch(filePath);
@@ -310,12 +251,12 @@ async function fetchBundle(locale, path) {
     return {};
   }
   return await fetchBundle(defaultLocale, path);
-}
-function getElementLocales(element) {
+};
+const getElementLocales = (element) => {
   const lang = getElementAttribute(element, "lang", globalThis.navigator?.language || defaultLocale);
   return { lang, t9nLocale: normalizeLocale(lang) };
-}
-function normalizeLocale(locale) {
+};
+const normalizeLocale = (locale) => {
   const [rawLanguageCode, regionCode] = locale.split("-");
   const languageCode = rawLanguageCode.toLowerCase();
   let normalizedLocale = languageCode;
@@ -330,10 +271,10 @@ function normalizeLocale(locale) {
     return normalizeLocale(languageCode);
   }
   return defaultLocale;
-}
-function startLocaleObserver(element, getAssetsPath, onUpdated, assetName) {
+};
+const startLocaleObserver = (element, getAssetsPath, onUpdated, assetName) => {
   let result = void 0;
-  const callback = () => void updateComponentLocaleState(element, getAssetsPath(), assetName).then((newResult) => {
+  const callback = () => updateComponentLocaleState(element, getAssetsPath(), assetName).then((newResult) => {
     if (result?.lang !== newResult.lang || result.t9nLocale !== newResult.t9nLocale || result.t9nStrings !== newResult.t9nStrings) {
       onUpdated(newResult);
     }
@@ -341,8 +282,8 @@ function startLocaleObserver(element, getAssetsPath, onUpdated, assetName) {
   }).catch(console.error);
   queueMicrotask(callback);
   return observeAncestorsMutation(element, ["lang"], callback);
-}
-async function updateComponentLocaleState(element, assetsPath, assetName = element.tagName.toLowerCase().split("-").slice(1).join("-")) {
+};
+const updateComponentLocaleState = async (element, assetsPath, assetName = element.localName.split("-").slice(1).join("-")) => {
   const { lang, t9nLocale } = getElementLocales(element);
   const t9nAssetsPath = `${assetsPath}/${assetName}/t9n`;
   const prefix = `messages.`;
@@ -351,23 +292,17 @@ async function updateComponentLocaleState(element, assetsPath, assetName = eleme
     assetName === null ? {} : await fetchT9nStringsBundle(t9nLocale, t9nAssetsPath, prefix)
   );
   return { lang, t9nLocale, t9nStrings };
-}
-
-// src/preamble.ts
-var blurb = "All material copyright Esri, All Rights Reserved, unless otherwise specified.\nSee https://js.arcgis.com/{minorVersion}/esri/copyright.txt for details.\nv{version}";
-var extractMinorVersion = (version) => {
+};
+const blurb = "All material copyright Esri, All Rights Reserved, unless otherwise specified.\nSee https://js.arcgis.com/{minorVersion}/esri/copyright.txt for details.\nv{version}";
+const extractMinorVersion = (version) => {
   const [major, minor] = version.split(".");
   return `${major}.${minor}`;
 };
-var getPreamble = (version) => blurb.replace("{minorVersion}", extractMinorVersion(version)).replace("{version}", version);
-
-// src/strings.ts
-var doubleQuote = '"';
-var singleQuote = "'";
-function repeatString(value, n) {
-  return new Array(n + 1).join(value);
-}
-function quoteString(value) {
+const getPreamble = (version) => blurb.replace("{minorVersion}", extractMinorVersion(version)).replace("{version}", version);
+const doubleQuote = '"';
+const singleQuote = "'";
+const repeatString = (value, n) => new Array(n + 1).join(value);
+const quoteString = (value) => {
   let quote = doubleQuote;
   let alternateQuote = singleQuote;
   const avoidEscape = value.includes(quote) && !value.includes(alternateQuote);
@@ -389,28 +324,23 @@ function quoteString(value) {
     (_, boundaryChar, leadingEscapedSlashes, quoteChars) => boundaryChar + leadingEscapedSlashes + repeatString(`\\${quote}`, quoteChars.length)
   );
   return quote + value + quote;
-}
-function createFilterExpression(filterWord) {
+};
+const createFilterExpression = (filterWord) => {
   const sanitizedWord = filterWord ? filterWord.replaceAll(/[-[\]/{}()*+?.\\^$|]/gu, "\\$&") : "^.*$";
   return new RegExp(sanitizedWord, "i");
-}
-function setValuesInString(message, values = {}) {
-  return (message ?? "").replace(/\{(?<valueName>.*?)\}/gu, (match, valueName) => values[valueName] ?? match);
-}
-function addLTRMark(value) {
-  return `\u200E${value ?? ""}\u200E`;
-}
-
-// src/text.ts
-var kebabToPascal = (string) => string.split("-").map(capitalize).join("");
-var camelToKebab = (string) => string.replace(upperBeforeLower, (upper, remainder) => `${remainder === 0 ? "" : "-"}${upper.toLowerCase()}`);
-var upperBeforeLower = /[A-Z]+(?![a-z])|[A-Z]/gu;
-var capitalize = (string) => string.charAt(0).toUpperCase() + string.slice(1);
-var uncapitalize = (string) => string.charAt(0).toLowerCase() + string.slice(1);
-var camelToHuman = (string) => capitalize(string.replace(upperBeforeLower, (upper, remainder) => `${remainder === 0 ? "" : " "}${upper}`));
-
-// src/timeouts.ts
-function devToolsAwareTimeout(callback, timeout) {
+};
+const setValuesInString = (message, values = {}) => (message ?? "").replace(/\{(?<valueName>.*?)\}/gu, (match, valueName) => values[valueName] ?? match);
+const addLTRMark = (value) => (
+  // Make sure the string value is LTR. This prevent issues with RTL language used in LTR containers.
+  `‎${value ?? ""}‎`
+);
+const kebabToPascal = (string) => string.split("-").map(capitalize).join("");
+const camelToKebab = (string) => string.replace(upperBeforeLower, (upper, remainder) => `${remainder === 0 ? "" : "-"}${upper.toLowerCase()}`);
+const upperBeforeLower = /[A-Z]+(?![a-z])|[A-Z]/gu;
+const capitalize = (string) => string.charAt(0).toUpperCase() + string.slice(1);
+const uncapitalize = (string) => string.charAt(0).toLowerCase() + string.slice(1);
+const camelToHuman = (string) => capitalize(string.replace(upperBeforeLower, (upper, remainder) => `${remainder === 0 ? "" : " "}${upper}`));
+const devToolsAwareTimeout = (callback, timeout) => {
   const interval = timeout > longTimeoutThreshold ? longTimeoutInterval : timeout / shortTimeoutIntervals;
   let elapsed = 0;
   const reference = setInterval(() => {
@@ -421,24 +351,14 @@ function devToolsAwareTimeout(callback, timeout) {
     }
   }, interval);
   return reference;
-}
-var longTimeoutThreshold = 4e3;
-var longTimeoutInterval = 2e3;
-var shortTimeoutIntervals = 4;
-
-// src/type-guards.ts
-function isNotNull(item) {
-  return item !== null;
-}
-function isNotUndefined(item) {
-  return item !== void 0;
-}
-
-// src/types.ts
-var identity = (value) => value;
-
-// src/ui.ts
-function debounce(func, waitFor = 100) {
+};
+const longTimeoutThreshold = 4e3;
+const longTimeoutInterval = 2e3;
+const shortTimeoutIntervals = 4;
+const isNotNull = (item) => item !== null;
+const isNotUndefined = (item) => item !== void 0;
+const identity = (value) => value;
+const debounce = (func, waitFor = 100) => {
   let timeout;
   return (...args) => {
     const later = () => {
@@ -448,10 +368,8 @@ function debounce(func, waitFor = 100) {
     clearTimeout(timeout);
     timeout = setTimeout(later, waitFor);
   };
-}
-
-// src/url.ts
-function hasSameOrigin(url1, url2, ignoreProtocol = false) {
+};
+const hasSameOrigin = (url1, url2, ignoreProtocol = false) => {
   if (!url1 || !url2) {
     return false;
   }
@@ -464,15 +382,15 @@ function hasSameOrigin(url1, url2, ignoreProtocol = false) {
     return false;
   }
   return url1Obj.host.toLowerCase() === url2Obj.host.toLowerCase() && url1Obj.port === url2Obj.port;
-}
-function isURL(url) {
+};
+const isURL = (url) => {
   try {
     new URL(url);
     return true;
   } catch (e) {
     return false;
   }
-}
+};
 export {
   Deferred,
   addLTRMark,

package/dist/intl.d.cts

@@ -0,0 +1,91 @@
+/**
+ * The interface for translated strings.
+ */
+export interface GenericT9nStrings {
+    [key: string]: GenericT9nStrings | string;
+}
+declare const supportedLocalesArray: ["ar", "bg", "bs", "ca", "cs", "da", "de", "el", "en", "es", "et", "fi", "fr", "he", "hr", "hu", "id", "it", "ja", "ko", "lt", "lv", "nl", "nb", "no", "pl", "pt-BR", "pt-PT", "ro", "ru", "sk", "sl", "sr", "sv", "th", "tr", "uk", "vi", "zh-CN", "zh-HK", "zh-TW"];
+/**
+ * The list of supported locales for ArcGIS Maps SDK for JavaScript components.
+ */
+export declare const supportedLocales: Set<"hr" | "th" | "tr" | "ar" | "bg" | "bs" | "ca" | "cs" | "da" | "de" | "el" | "en" | "es" | "et" | "fi" | "fr" | "he" | "hu" | "id" | "it" | "ja" | "ko" | "lt" | "lv" | "nl" | "nb" | "no" | "pl" | "pt-BR" | "pt-PT" | "ro" | "ru" | "sk" | "sl" | "sr" | "sv" | "uk" | "vi" | "zh-CN" | "zh-HK" | "zh-TW">;
+export type SupportedLocale = (typeof supportedLocalesArray)[number];
+export declare const defaultLocale = "en";
+/**
+ * Fetch the T9N strings bundle for the given locale, assets path and prefix.
+ * The locale must be one of the supported locales.
+ * If the locale is not supported, it will default to 'en'.
+ * If the T9N strings bundle cannot be found, it will default to 'en'.
+ *
+ * @remarks
+ * Rather than using this function directly, prefer the `useT9n()` controller.
+ *
+ * @example
+ * ```ts
+ * const t9nStrings = await fetchT9nStringsBundle("en", getAssetPath("./assets/coding-editor/t9n"), "messages.");
+ * ```
+ */
+export declare const fetchT9nStringsBundle: <Strings extends GenericT9nStrings>(
+/** The locale for which to fetch the T9N strings  */
+locale: string, 
+/** The path to the assets folder where the T9N strings are located */
+assetsPath: string, 
+/** The prefix to use for the T9N strings file name. */
+prefix?: string) => Promise<Strings>;
+/**
+ * Get the locale of the given element.
+ * It will look for the lang attribute on the element and its ancestors.
+ * If not lang is found, it will default to 'en'.
+ */
+export declare const getElementLocales: (element: HTMLElement) => {
+    readonly lang: string;
+    readonly t9nLocale: SupportedLocale;
+};
+export declare const normalizeLocale: (locale: string) => SupportedLocale;
+export type LocaleObserver<Strings extends GenericT9nStrings = GenericT9nStrings> = {
+    /** The T9N strings of the component */
+    t9nStrings: Strings;
+    /**
+     * The locale of the component set by the `lang` attribute on the component host element or one of its ancestors.
+     */
+    lang: string;
+    /**
+     * The locale used by the component to load the T9N strings.
+     * It may be different than the locale of the component host element that was set by the `lang` attribute.
+     */
+    t9nLocale: SupportedLocale;
+};
+/**
+ * Start the locale observer for the given component.
+ * The callback will be called when the locale changes for the component.
+ * It will observe the lang attribute on the component and its ancestors.
+ * The callback is called once at the beginning.
+ *
+ * @remarks
+ * Rather than using this function directly, prefer the `useT9n()` controller.
+ */
+export declare const startLocaleObserver: <Strings extends GenericT9nStrings = GenericT9nStrings>(
+/** The Web component HTML element that is doing the fetching */
+element: HTMLElement, 
+/**
+ * The callback to get path to the assets folder where the T9N strings are
+ * located.
+ *
+ * @example
+ * ```ts
+ * () => getAssetPath("./assets")
+ * ```
+ */
+getAssetsPath: () => string, 
+/** The callback to call when the locale changes  */
+onUpdated: (payload: LocaleObserver<Strings>) => void, 
+/**
+ * Optionally override the asset file name.
+ * Default file name is the component tag name without the part before the
+ * first dash (e.g. `arcgis-map` becomes `map`).
+ *
+ * Set to null if the component has no localization strings, but you still
+ * wish to use `startLocaleObserver` to get the locale information.
+ */
+assetName?: string | null) => (() => void);
+export {};

package/dist/intl.d.ts

@@ -0,0 +1,91 @@
+/**
+ * The interface for translated strings.
+ */
+export interface GenericT9nStrings {
+    [key: string]: GenericT9nStrings | string;
+}
+declare const supportedLocalesArray: ["ar", "bg", "bs", "ca", "cs", "da", "de", "el", "en", "es", "et", "fi", "fr", "he", "hr", "hu", "id", "it", "ja", "ko", "lt", "lv", "nl", "nb", "no", "pl", "pt-BR", "pt-PT", "ro", "ru", "sk", "sl", "sr", "sv", "th", "tr", "uk", "vi", "zh-CN", "zh-HK", "zh-TW"];
+/**
+ * The list of supported locales for ArcGIS Maps SDK for JavaScript components.
+ */
+export declare const supportedLocales: Set<"hr" | "th" | "tr" | "ar" | "bg" | "bs" | "ca" | "cs" | "da" | "de" | "el" | "en" | "es" | "et" | "fi" | "fr" | "he" | "hu" | "id" | "it" | "ja" | "ko" | "lt" | "lv" | "nl" | "nb" | "no" | "pl" | "pt-BR" | "pt-PT" | "ro" | "ru" | "sk" | "sl" | "sr" | "sv" | "uk" | "vi" | "zh-CN" | "zh-HK" | "zh-TW">;
+export type SupportedLocale = (typeof supportedLocalesArray)[number];
+export declare const defaultLocale = "en";
+/**
+ * Fetch the T9N strings bundle for the given locale, assets path and prefix.
+ * The locale must be one of the supported locales.
+ * If the locale is not supported, it will default to 'en'.
+ * If the T9N strings bundle cannot be found, it will default to 'en'.
+ *
+ * @remarks
+ * Rather than using this function directly, prefer the `useT9n()` controller.
+ *
+ * @example
+ * ```ts
+ * const t9nStrings = await fetchT9nStringsBundle("en", getAssetPath("./assets/coding-editor/t9n"), "messages.");
+ * ```
+ */
+export declare const fetchT9nStringsBundle: <Strings extends GenericT9nStrings>(
+/** The locale for which to fetch the T9N strings  */
+locale: string, 
+/** The path to the assets folder where the T9N strings are located */
+assetsPath: string, 
+/** The prefix to use for the T9N strings file name. */
+prefix?: string) => Promise<Strings>;
+/**
+ * Get the locale of the given element.
+ * It will look for the lang attribute on the element and its ancestors.
+ * If not lang is found, it will default to 'en'.
+ */
+export declare const getElementLocales: (element: HTMLElement) => {
+    readonly lang: string;
+    readonly t9nLocale: SupportedLocale;
+};
+export declare const normalizeLocale: (locale: string) => SupportedLocale;
+export type LocaleObserver<Strings extends GenericT9nStrings = GenericT9nStrings> = {
+    /** The T9N strings of the component */
+    t9nStrings: Strings;
+    /**
+     * The locale of the component set by the `lang` attribute on the component host element or one of its ancestors.
+     */
+    lang: string;
+    /**
+     * The locale used by the component to load the T9N strings.
+     * It may be different than the locale of the component host element that was set by the `lang` attribute.
+     */
+    t9nLocale: SupportedLocale;
+};
+/**
+ * Start the locale observer for the given component.
+ * The callback will be called when the locale changes for the component.
+ * It will observe the lang attribute on the component and its ancestors.
+ * The callback is called once at the beginning.
+ *
+ * @remarks
+ * Rather than using this function directly, prefer the `useT9n()` controller.
+ */
+export declare const startLocaleObserver: <Strings extends GenericT9nStrings = GenericT9nStrings>(
+/** The Web component HTML element that is doing the fetching */
+element: HTMLElement, 
+/**
+ * The callback to get path to the assets folder where the T9N strings are
+ * located.
+ *
+ * @example
+ * ```ts
+ * () => getAssetPath("./assets")
+ * ```
+ */
+getAssetsPath: () => string, 
+/** The callback to call when the locale changes  */
+onUpdated: (payload: LocaleObserver<Strings>) => void, 
+/**
+ * Optionally override the asset file name.
+ * Default file name is the component tag name without the part before the
+ * first dash (e.g. `arcgis-map` becomes `map`).
+ *
+ * Set to null if the component has no localization strings, but you still
+ * wish to use `startLocaleObserver` to get the locale information.
+ */
+assetName?: string | null) => (() => void);
+export {};

package/dist/preamble.d.cts

@@ -0,0 +1,17 @@
+export declare const extractMinorVersion: (version: string) => string;
+/**
+ * Creates preamble text from a version number. The preamble text is used in stencil.config.ts and inserts a comment at the top of the generated bundles.
+ * The preamble text contains the version number and a link to the license.
+ * The version number is typically extracted from the package.json file.
+ * @example
+ * ```ts
+ * const preamble = getPreamble("4.18.2-beta.1");
+ * console.log(preamble);
+ * // All material copyright Esri, All Rights Reserved, unless otherwise specified.
+ * // See https://js.arcgis.com/4.18/esri/copyright.txt for details.
+ * // v4.18.2-beta.1
+ * ```
+ * @param version the version number, typically coming from package.json.
+ * @returns a string containing the preamble text.
+ */
+export declare const getPreamble: (version: string) => string;