@arcgis/components-utils 4.32.0-next.7 → 4.32.0-next.71

package/dist/index.cjs

@@ -33,6 +33,7 @@ __export(src_exports, {
   devToolsAwareTimeout: () => devToolsAwareTimeout,
   extractMinorVersion: () => extractMinorVersion,
   fetchT9nStringsBundle: () => fetchT9nStringsBundle,
+  focusElement: () => focusElement,
   generateGuid: () => generateGuid,
   getElementAttribute: () => getElementAttribute,
   getElementDir: () => getElementDir,
@@ -41,6 +42,7 @@ __export(src_exports, {
   getPreamble: () => getPreamble,
   hasSameOrigin: () => hasSameOrigin,
   identity: () => identity,
+  isEsriInternalEnv: () => isEsriInternalEnv,
   isNotNull: () => isNotNull,
   isNotUndefined: () => isNotUndefined,
   isURL: () => isURL,
@@ -205,16 +207,16 @@ function getElementAttribute(el, prop, fallbackValue) {
 function isElement(ref) {
   return ref.nodeType === Node.ELEMENT_NODE;
 }
-function isHTMLWithSetFocus(ref) {
-  return "setFocus" in ref && typeof ref.setFocus === "function";
+function hasSetFocus(ref) {
+  return typeof ref.setFocus === "function";
 }
 function setFocus(ref, selector = "") {
   if (!isElement(ref)) {
     return false;
   }
   if (ref.matches(selector)) {
-    if (isHTMLWithSetFocus(ref)) {
-      setTimeout(() => ref.setFocus(), 0);
+    if (hasSetFocus(ref)) {
+      setTimeout(() => void ref.setFocus(), 0);
     }
     return true;
   }
@@ -233,6 +235,16 @@ function setFocus(ref, selector = "") {
   }
   return false;
 }
+async function focusElement(el) {
+  if (el == null) {
+    return;
+  }
+  if (hasSetFocus(el)) {
+    await el.setFocus();
+  } else {
+    el.focus();
+  }
+}
 function setFocusOnElement(ref, selector) {
   if (!ref?.shadowRoot) {
     return;
@@ -241,17 +253,13 @@ function setFocusOnElement(ref, selector) {
     setFocus(ref, selector);
     return;
   }
-  const mutationObserver = new MutationObserver(() => {
-    mutationObserver.disconnect();
-    setFocus(ref, selector);
-  });
-  mutationObserver.observe(ref, {
-    attributes: true,
-    attributeFilter: ["hydrated", "calcite-hydrated"]
-  });
+  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) {
   try {
     return callback?.call(thisContext, ...rest);
@@ -308,6 +316,7 @@ var supportedLocalesArray = [
   "lv",
   "nl",
   "nb",
+  "no",
   "pl",
   "pt-BR",
   "pt-PT",
@@ -325,13 +334,13 @@ var supportedLocalesArray = [
   "zh-HK",
   "zh-TW"
 ];
-var supportedLocales = new Set(supportedLocalesArray);
+var supportedLocales = /* @__PURE__ */ new Set(supportedLocalesArray);
 var defaultLocale = "en";
 var localeEquivalencies = {
-  // We use `pt-BR` as it will have the same translations as `pt`, which has no corresponding bundle
+  // 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 `nb` has corresponding bundle
-  no: "nb",
+  // We support both 'nb' and 'no' (BCP 47) for Norwegian but only `no` has corresponding bundle
+  nb: "no",
   // We use `zh-CN` as base translation for chinese locales which has no corresponding bundle.
   zh: "zh-CN"
 };
@@ -350,7 +359,19 @@ async function fetchBundle(locale, path) {
       return await response.json();
     }
   } catch (error) {
-    console.error(error);
+    if (typeof process === "object" && process.env.NODE_ENV !== "production") {
+      const is404ViteFallback = String(error).includes(`Unexpected token '<', "<!doctype "... is not valid JSON`);
+      if (is404ViteFallback) {
+        if (filePath.includes("calcite")) {
+          return {};
+        }
+        console.error(`[404] Localization strings not found at ${filePath}`);
+      } else {
+        console.error(`Error fetching localization strings at ${filePath}`, error);
+      }
+    } else {
+      console.error(error);
+    }
     return {};
   }
   if (locale === defaultLocale) {
@@ -392,11 +413,15 @@ function startLocaleObserver(element, assetsPath, onUpdated, assetName) {
 async function updateComponentLocaleState(element, assetsPath, assetName = element.tagName.toLowerCase().split("-").slice(1).join("-")) {
   const { lang, t9nLocale } = getElementLocales(element);
   const t9nAssetsPath = `${assetsPath}/${assetName}/t9n`;
-  const prefix = `${assetName}.t9n.`;
-  const t9nStrings = (
+  const prefix = `messages.`;
+  let t9nStrings = (
     // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
     assetName === null ? {} : await fetchT9nStringsBundle(t9nLocale, t9nAssetsPath, prefix)
   );
+  if (assetName !== null && Object.keys(t9nStrings).length === 0) {
+    const prefix2 = `${assetName}.t9n.`;
+    t9nStrings = await fetchT9nStringsBundle(t9nLocale, t9nAssetsPath, prefix2);
+  }
   return { lang, t9nLocale, t9nStrings };
 }
 
@@ -535,6 +560,7 @@ function isURL(url) {
   devToolsAwareTimeout,
   extractMinorVersion,
   fetchT9nStringsBundle,
+  focusElement,
   generateGuid,
   getElementAttribute,
   getElementDir,
@@ -543,6 +569,7 @@ function isURL(url) {
   getPreamble,
   hasSameOrigin,
   identity,
+  isEsriInternalEnv,
   isNotNull,
   isNotUndefined,
   isURL,

package/dist/index.d.cts

@@ -125,6 +125,10 @@ declare function getElementDir(el: HTMLElement): "ltr" | "rtl";
  * @returns The attribute value or the fallback value if the attribute is not found.
  */
 declare function getElementAttribute(el: Element, prop: string, fallbackValue: string): string;
+interface FocusableElement extends HTMLElement {
+    setFocus?: () => Promise<void>;
+}
+declare function focusElement(el: FocusableElement | undefined): Promise<void>;
 /**
  * Set the focus on the element that matches the selector.
  * It will traverse the element's ancestors to find the target element.
@@ -134,9 +138,32 @@ declare function getElementAttribute(el: Element, prop: string, fallbackValue: s
  * @param ref The element to start the search from.
  * @param selector The selector to match.
  * @returns Returns true if the focus is set on the element.
+ *
+ * REFACTOR: this is doing too much. break it into separate find element and focus
+ * element utilities
  */
-declare function setFocusOnElement(ref: Element | null | undefined, selector: string): void;
+declare function setFocusOnElement(ref: (Element & {
+    componentOnReady?: () => Promise<void>;
+}) | null | undefined, selector: string): void;
 
+/**
+ * Check whether the code is executing in an Esri internal environment (for
+ * example, Lumina dev server). When true, your code can enable extra validation
+ * to detect incorrect usages or do runtime bug detection.
+ *
+ * The call to isEsriInternalEnv() MUST always appear behind one of the
+ * following guards to ensure it is correctly eliminated in production bundles:
+ *
+ * - `typeof process === 'object' && process.env.NODE_ENV !== "production"`
+ * - `typeof process === 'object' && process.env.NODE_ENV === "development"`
+ * - `typeof process === 'object' && process.env.NODE_ENV === "test"`
+ *
+ * @remarks
+ * This function is primary for usage in support packages. In Lumina component
+ * packages, simpler alternatives are provided:
+ * https://qawebgis.esri.com/components/lumina/publishing#bundling-code-conditionally
+ */
+declare function isEsriInternalEnv(): boolean;
 /**
  * Calls a sync method and catch any errors. Returns undefined if error occurred.
  *
@@ -162,11 +189,11 @@ declare function generateGuid(): string;
 interface GenericT9nStrings {
     [key: string]: GenericT9nStrings | string;
 }
-declare const supportedLocalesArray: readonly ["ar", "bg", "bs", "ca", "cs", "da", "de", "el", "en", "es", "et", "fi", "fr", "he", "hr", "hu", "id", "it", "ja", "ko", "lt", "lv", "nl", "nb", "pl", "pt-BR", "pt-PT", "ro", "ru", "sk", "sl", "sr", "sv", "th", "tr", "uk", "vi", "zh-CN", "zh-HK", "zh-TW"];
+declare const supportedLocalesArray: readonly ["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.
  */
-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" | "pl" | "pt-BR" | "pt-PT" | "ro" | "ru" | "sk" | "sl" | "sr" | "sv" | "uk" | "vi" | "zh-CN" | "zh-HK" | "zh-TW">;
+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">;
 type SupportedLocale = (typeof supportedLocalesArray)[number];
 declare const defaultLocale = "en";
 /**
@@ -180,7 +207,7 @@ declare const defaultLocale = "en";
  *
  * @example
  * ```ts
- * const t9nStrings = await fetchT9nStringsBundle("en", getAssetPath("./assets/coding-editor/t9n"), "coding-editor.t9n.");
+ * const t9nStrings = await fetchT9nStringsBundle("en", getAssetPath("./assets/coding-editor/t9n"), "messages.");
  * ```
  */
 declare function fetchT9nStringsBundle<Strings extends GenericT9nStrings>(
@@ -340,4 +367,4 @@ declare function hasSameOrigin(url1: string | null | undefined, url2: string | n
  */
 declare function isURL(url: string): boolean;
 
-export { Deferred, type GenericT9nStrings, type IHandle, type LocaleObserver, type Nil, type SupportedLocale, type Writable, addLTRMark, camelToHuman, camelToKebab, capitalize, classes, closestElement, createFilterExpression, debounce, defaultLocale, devToolsAwareTimeout, extractMinorVersion, fetchT9nStringsBundle, generateGuid, getElementAttribute, getElementDir, getElementLocales, getElementTheme, getPreamble, hasSameOrigin, identity, isNotNull, isNotUndefined, isURL, kebabToPascal, mappedFind, normalizeLocale, observeAncestorsMutation, quoteString, safeAsyncCall, safeCall, setFocusOnElement, setValuesInString, startLocaleObserver, supportedLocales, uncapitalize };
+export { Deferred, type FocusableElement, type GenericT9nStrings, type IHandle, type LocaleObserver, type Nil, type SupportedLocale, type Writable, addLTRMark, camelToHuman, camelToKebab, capitalize, classes, closestElement, createFilterExpression, debounce, defaultLocale, devToolsAwareTimeout, extractMinorVersion, fetchT9nStringsBundle, focusElement, generateGuid, getElementAttribute, getElementDir, getElementLocales, getElementTheme, getPreamble, hasSameOrigin, identity, isEsriInternalEnv, isNotNull, isNotUndefined, isURL, kebabToPascal, mappedFind, normalizeLocale, observeAncestorsMutation, quoteString, safeAsyncCall, safeCall, setFocusOnElement, setValuesInString, startLocaleObserver, supportedLocales, uncapitalize };

package/dist/index.d.ts

@@ -125,6 +125,10 @@ declare function getElementDir(el: HTMLElement): "ltr" | "rtl";
  * @returns The attribute value or the fallback value if the attribute is not found.
  */
 declare function getElementAttribute(el: Element, prop: string, fallbackValue: string): string;
+interface FocusableElement extends HTMLElement {
+    setFocus?: () => Promise<void>;
+}
+declare function focusElement(el: FocusableElement | undefined): Promise<void>;
 /**
  * Set the focus on the element that matches the selector.
  * It will traverse the element's ancestors to find the target element.
@@ -134,9 +138,32 @@ declare function getElementAttribute(el: Element, prop: string, fallbackValue: s
  * @param ref The element to start the search from.
  * @param selector The selector to match.
  * @returns Returns true if the focus is set on the element.
+ *
+ * REFACTOR: this is doing too much. break it into separate find element and focus
+ * element utilities
  */
-declare function setFocusOnElement(ref: Element | null | undefined, selector: string): void;
+declare function setFocusOnElement(ref: (Element & {
+    componentOnReady?: () => Promise<void>;
+}) | null | undefined, selector: string): void;
 
+/**
+ * Check whether the code is executing in an Esri internal environment (for
+ * example, Lumina dev server). When true, your code can enable extra validation
+ * to detect incorrect usages or do runtime bug detection.
+ *
+ * The call to isEsriInternalEnv() MUST always appear behind one of the
+ * following guards to ensure it is correctly eliminated in production bundles:
+ *
+ * - `typeof process === 'object' && process.env.NODE_ENV !== "production"`
+ * - `typeof process === 'object' && process.env.NODE_ENV === "development"`
+ * - `typeof process === 'object' && process.env.NODE_ENV === "test"`
+ *
+ * @remarks
+ * This function is primary for usage in support packages. In Lumina component
+ * packages, simpler alternatives are provided:
+ * https://qawebgis.esri.com/components/lumina/publishing#bundling-code-conditionally
+ */
+declare function isEsriInternalEnv(): boolean;
 /**
  * Calls a sync method and catch any errors. Returns undefined if error occurred.
  *
@@ -162,11 +189,11 @@ declare function generateGuid(): string;
 interface GenericT9nStrings {
     [key: string]: GenericT9nStrings | string;
 }
-declare const supportedLocalesArray: readonly ["ar", "bg", "bs", "ca", "cs", "da", "de", "el", "en", "es", "et", "fi", "fr", "he", "hr", "hu", "id", "it", "ja", "ko", "lt", "lv", "nl", "nb", "pl", "pt-BR", "pt-PT", "ro", "ru", "sk", "sl", "sr", "sv", "th", "tr", "uk", "vi", "zh-CN", "zh-HK", "zh-TW"];
+declare const supportedLocalesArray: readonly ["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.
  */
-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" | "pl" | "pt-BR" | "pt-PT" | "ro" | "ru" | "sk" | "sl" | "sr" | "sv" | "uk" | "vi" | "zh-CN" | "zh-HK" | "zh-TW">;
+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">;
 type SupportedLocale = (typeof supportedLocalesArray)[number];
 declare const defaultLocale = "en";
 /**
@@ -180,7 +207,7 @@ declare const defaultLocale = "en";
  *
  * @example
  * ```ts
- * const t9nStrings = await fetchT9nStringsBundle("en", getAssetPath("./assets/coding-editor/t9n"), "coding-editor.t9n.");
+ * const t9nStrings = await fetchT9nStringsBundle("en", getAssetPath("./assets/coding-editor/t9n"), "messages.");
  * ```
  */
 declare function fetchT9nStringsBundle<Strings extends GenericT9nStrings>(
@@ -340,4 +367,4 @@ declare function hasSameOrigin(url1: string | null | undefined, url2: string | n
  */
 declare function isURL(url: string): boolean;
 
-export { Deferred, type GenericT9nStrings, type IHandle, type LocaleObserver, type Nil, type SupportedLocale, type Writable, addLTRMark, camelToHuman, camelToKebab, capitalize, classes, closestElement, createFilterExpression, debounce, defaultLocale, devToolsAwareTimeout, extractMinorVersion, fetchT9nStringsBundle, generateGuid, getElementAttribute, getElementDir, getElementLocales, getElementTheme, getPreamble, hasSameOrigin, identity, isNotNull, isNotUndefined, isURL, kebabToPascal, mappedFind, normalizeLocale, observeAncestorsMutation, quoteString, safeAsyncCall, safeCall, setFocusOnElement, setValuesInString, startLocaleObserver, supportedLocales, uncapitalize };
+export { Deferred, type FocusableElement, type GenericT9nStrings, type IHandle, type LocaleObserver, type Nil, type SupportedLocale, type Writable, addLTRMark, camelToHuman, camelToKebab, capitalize, classes, closestElement, createFilterExpression, debounce, defaultLocale, devToolsAwareTimeout, extractMinorVersion, fetchT9nStringsBundle, focusElement, generateGuid, getElementAttribute, getElementDir, getElementLocales, getElementTheme, getPreamble, hasSameOrigin, identity, isEsriInternalEnv, isNotNull, isNotUndefined, isURL, kebabToPascal, mappedFind, normalizeLocale, observeAncestorsMutation, quoteString, safeAsyncCall, safeCall, setFocusOnElement, setValuesInString, startLocaleObserver, supportedLocales, uncapitalize };

package/dist/index.js

@@ -144,16 +144,16 @@ function getElementAttribute(el, prop, fallbackValue) {
 function isElement(ref) {
   return ref.nodeType === Node.ELEMENT_NODE;
 }
-function isHTMLWithSetFocus(ref) {
-  return "setFocus" in ref && typeof ref.setFocus === "function";
+function hasSetFocus(ref) {
+  return typeof ref.setFocus === "function";
 }
 function setFocus(ref, selector = "") {
   if (!isElement(ref)) {
     return false;
   }
   if (ref.matches(selector)) {
-    if (isHTMLWithSetFocus(ref)) {
-      setTimeout(() => ref.setFocus(), 0);
+    if (hasSetFocus(ref)) {
+      setTimeout(() => void ref.setFocus(), 0);
     }
     return true;
   }
@@ -172,6 +172,16 @@ function setFocus(ref, selector = "") {
   }
   return false;
 }
+async function focusElement(el) {
+  if (el == null) {
+    return;
+  }
+  if (hasSetFocus(el)) {
+    await el.setFocus();
+  } else {
+    el.focus();
+  }
+}
 function setFocusOnElement(ref, selector) {
   if (!ref?.shadowRoot) {
     return;
@@ -180,17 +190,13 @@ function setFocusOnElement(ref, selector) {
     setFocus(ref, selector);
     return;
   }
-  const mutationObserver = new MutationObserver(() => {
-    mutationObserver.disconnect();
-    setFocus(ref, selector);
-  });
-  mutationObserver.observe(ref, {
-    attributes: true,
-    attributeFilter: ["hydrated", "calcite-hydrated"]
-  });
+  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) {
   try {
     return callback?.call(thisContext, ...rest);
@@ -247,6 +253,7 @@ var supportedLocalesArray = [
   "lv",
   "nl",
   "nb",
+  "no",
   "pl",
   "pt-BR",
   "pt-PT",
@@ -264,13 +271,13 @@ var supportedLocalesArray = [
   "zh-HK",
   "zh-TW"
 ];
-var supportedLocales = new Set(supportedLocalesArray);
+var supportedLocales = /* @__PURE__ */ new Set(supportedLocalesArray);
 var defaultLocale = "en";
 var localeEquivalencies = {
-  // We use `pt-BR` as it will have the same translations as `pt`, which has no corresponding bundle
+  // 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 `nb` has corresponding bundle
-  no: "nb",
+  // We support both 'nb' and 'no' (BCP 47) for Norwegian but only `no` has corresponding bundle
+  nb: "no",
   // We use `zh-CN` as base translation for chinese locales which has no corresponding bundle.
   zh: "zh-CN"
 };
@@ -289,7 +296,19 @@ async function fetchBundle(locale, path) {
       return await response.json();
     }
   } catch (error) {
-    console.error(error);
+    if (typeof process === "object" && process.env.NODE_ENV !== "production") {
+      const is404ViteFallback = String(error).includes(`Unexpected token '<', "<!doctype "... is not valid JSON`);
+      if (is404ViteFallback) {
+        if (filePath.includes("calcite")) {
+          return {};
+        }
+        console.error(`[404] Localization strings not found at ${filePath}`);
+      } else {
+        console.error(`Error fetching localization strings at ${filePath}`, error);
+      }
+    } else {
+      console.error(error);
+    }
     return {};
   }
   if (locale === defaultLocale) {
@@ -331,11 +350,15 @@ function startLocaleObserver(element, assetsPath, onUpdated, assetName) {
 async function updateComponentLocaleState(element, assetsPath, assetName = element.tagName.toLowerCase().split("-").slice(1).join("-")) {
   const { lang, t9nLocale } = getElementLocales(element);
   const t9nAssetsPath = `${assetsPath}/${assetName}/t9n`;
-  const prefix = `${assetName}.t9n.`;
-  const t9nStrings = (
+  const prefix = `messages.`;
+  let t9nStrings = (
     // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
     assetName === null ? {} : await fetchT9nStringsBundle(t9nLocale, t9nAssetsPath, prefix)
   );
+  if (assetName !== null && Object.keys(t9nStrings).length === 0) {
+    const prefix2 = `${assetName}.t9n.`;
+    t9nStrings = await fetchT9nStringsBundle(t9nLocale, t9nAssetsPath, prefix2);
+  }
   return { lang, t9nLocale, t9nStrings };
 }
 
@@ -473,6 +496,7 @@ export {
   devToolsAwareTimeout,
   extractMinorVersion,
   fetchT9nStringsBundle,
+  focusElement,
   generateGuid,
   getElementAttribute,
   getElementDir,
@@ -481,6 +505,7 @@ export {
   getPreamble,
   hasSameOrigin,
   identity,
+  isEsriInternalEnv,
   isNotNull,
   isNotUndefined,
   isURL,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/components-utils",
-  "version": "4.32.0-next.7",
+  "version": "4.32.0-next.71",
   "description": "Collection of common internal patterns and utilities for ArcGIS Maps SDK for JavaScript components.",
   "homepage": "https://developers.arcgis.com/javascript/latest/",
   "sideEffects": false,