@arcgis/components-utils 4.32.0-next.99 → 4.33.0-next.0

package/LICENSE.md

@@ -1,6 +1,6 @@
 # Licensing
 
-COPYRIGHT © 2024 Esri
+COPYRIGHT © 2025 Esri
 
 All rights reserved under the copyright laws of the United States and applicable international laws, treaties, and conventions.
 

package/README.md

@@ -8,7 +8,7 @@ It is not intended to be used directly, but rather used as a dependency by other
 
 ## License
 
-COPYRIGHT © 2024 Esri
+COPYRIGHT © 2025 Esri
 
 All rights reserved under the copyright laws of the United States and applicable international laws, treaties, and conventions.
 

package/dist/index.cjs

@@ -164,13 +164,11 @@ function observe(attributeFilter) {
   const observer = {
     subscribe(callback) {
       subscribers.add(callback);
-      return {
-        remove: () => {
-          subscribers.delete(callback);
-          if (subscribers.size === 0) {
-            mutationObserver.disconnect();
-            observers[attributes] = void 0;
-          }
+      return () => {
+        subscribers.delete(callback);
+        if (subscribers.size === 0) {
+          mutationObserver.disconnect();
+          observers[attributes] = void 0;
         }
       };
     }
@@ -396,15 +394,15 @@ function normalizeLocale(locale) {
   }
   return defaultLocale;
 }
-function startLocaleObserver(element, assetsPath, onUpdated, assetName) {
+function startLocaleObserver(element, getAssetsPath, onUpdated, assetName) {
   let result = void 0;
-  const callback = () => void updateComponentLocaleState(element, assetsPath, assetName).then((newResult) => {
+  const callback = () => void updateComponentLocaleState(element, getAssetsPath(), assetName).then((newResult) => {
     if (result?.lang !== newResult.lang || result.t9nLocale !== newResult.t9nLocale || result.t9nStrings !== newResult.t9nStrings) {
       onUpdated(newResult);
     }
     result = newResult;
   }).catch(console.error);
-  callback();
+  queueMicrotask(callback);
   return observeAncestorsMutation(element, ["lang"], callback);
 }
 async function updateComponentLocaleState(element, assetsPath, assetName = element.tagName.toLowerCase().split("-").slice(1).join("-")) {

package/dist/index.d.cts

@@ -89,7 +89,7 @@ declare class Deferred<T> {
  * @param callback The callback to invoke when the attributes have been changed.
  * @returns The mutation observer
  */
-declare function observeAncestorsMutation(element: Node, attributeFilter: string[], callback: () => void): IHandle;
+declare function observeAncestorsMutation(element: Node, attributeFilter: string[], callback: () => void): () => void;
 /**
  * Find the closest element that matches the selector.
  * It will traverse the element's ancestors to find the target element.
@@ -252,8 +252,16 @@ type LocaleObserver<Strings extends GenericT9nStrings = GenericT9nStrings> = {
 declare function startLocaleObserver<Strings extends GenericT9nStrings = GenericT9nStrings>(
 /** The Web component HTML element that is doing the fetching */
 element: HTMLElement, 
-/** The path to the assets folder where the T9N strings are located */
-assetsPath: string, 
+/**
+ * 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, 
 /**
@@ -264,7 +272,7 @@ onUpdated: (payload: LocaleObserver<Strings>) => void,
  * 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): IHandle;
+assetName?: string | null): () => void;
 
 declare const extractMinorVersion: (version: string) => string;
 /**

package/dist/index.d.ts

@@ -89,7 +89,7 @@ declare class Deferred<T> {
  * @param callback The callback to invoke when the attributes have been changed.
  * @returns The mutation observer
  */
-declare function observeAncestorsMutation(element: Node, attributeFilter: string[], callback: () => void): IHandle;
+declare function observeAncestorsMutation(element: Node, attributeFilter: string[], callback: () => void): () => void;
 /**
  * Find the closest element that matches the selector.
  * It will traverse the element's ancestors to find the target element.
@@ -252,8 +252,16 @@ type LocaleObserver<Strings extends GenericT9nStrings = GenericT9nStrings> = {
 declare function startLocaleObserver<Strings extends GenericT9nStrings = GenericT9nStrings>(
 /** The Web component HTML element that is doing the fetching */
 element: HTMLElement, 
-/** The path to the assets folder where the T9N strings are located */
-assetsPath: string, 
+/**
+ * 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, 
 /**
@@ -264,7 +272,7 @@ onUpdated: (payload: LocaleObserver<Strings>) => void,
  * 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): IHandle;
+assetName?: string | null): () => void;
 
 declare const extractMinorVersion: (version: string) => string;
 /**

package/dist/index.js

@@ -101,13 +101,11 @@ function observe(attributeFilter) {
   const observer = {
     subscribe(callback) {
       subscribers.add(callback);
-      return {
-        remove: () => {
-          subscribers.delete(callback);
-          if (subscribers.size === 0) {
-            mutationObserver.disconnect();
-            observers[attributes] = void 0;
-          }
+      return () => {
+        subscribers.delete(callback);
+        if (subscribers.size === 0) {
+          mutationObserver.disconnect();
+          observers[attributes] = void 0;
         }
       };
     }
@@ -333,15 +331,15 @@ function normalizeLocale(locale) {
   }
   return defaultLocale;
 }
-function startLocaleObserver(element, assetsPath, onUpdated, assetName) {
+function startLocaleObserver(element, getAssetsPath, onUpdated, assetName) {
   let result = void 0;
-  const callback = () => void updateComponentLocaleState(element, assetsPath, assetName).then((newResult) => {
+  const callback = () => void updateComponentLocaleState(element, getAssetsPath(), assetName).then((newResult) => {
     if (result?.lang !== newResult.lang || result.t9nLocale !== newResult.t9nLocale || result.t9nStrings !== newResult.t9nStrings) {
       onUpdated(newResult);
     }
     result = newResult;
   }).catch(console.error);
-  callback();
+  queueMicrotask(callback);
   return observeAncestorsMutation(element, ["lang"], callback);
 }
 async function updateComponentLocaleState(element, assetsPath, assetName = element.tagName.toLowerCase().split("-").slice(1).join("-")) {

package/package.json

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