@arcgis/toolkit 5.0.0-next.94 → 5.0.0-next.96

package/dist/intl/index.cjs

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const dom_index = require("../dom/index.cjs");
+const log_index = require("../log/index.cjs");
 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(
   ","
 );
@@ -40,12 +41,14 @@ const fetchBundle = async (locale, path) => {
     if (process.env.NODE_ENV !== "production") {
       const is404ViteFallback = String(error).includes(`Unexpected token '<', "<!doctype "... is not valid JSON`);
       if (is404ViteFallback) {
-        console.error(`[404] Localization strings not found at ${filePath}`);
+        log_index.log("error", "intl", `Localization strings not found at ${filePath}`);
       } else {
-        console.error(`Error fetching localization strings at ${filePath}`, error);
+        log_index.log("error", "intl", `Error fetching localization strings at ${filePath}`, { detail: { error } });
       }
     } else {
-      console.error(error);
+      log_index.log("error", "intl", `An unknown error occurred while fetching localization strings at ${filePath}`, {
+        detail: { error }
+      });
     }
     return {};
   }
@@ -81,7 +84,9 @@ const startLocaleObserver = (element, getAssetsPath, onUpdated, assetName) => {
       onUpdated(newResult);
     }
     result = newResult;
-  }).catch(console.error);
+  }).catch((error) => {
+    log_index.log("error", "intl", "Error updating component locale state", { detail: { error } });
+  });
   queueMicrotask(callback);
   return dom_index.observeAncestorsMutation(element, ["lang"], callback);
 };

package/dist/intl/index.d.cts

@@ -2,7 +2,7 @@ declare const supportedLocalesArray: ["ar", "bg", "bs", "ca", "cs", "da", "de",
 /**
  * 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 declare const supportedLocales: Set<"hr" | "th" | "tr" | "el" | "ar" | "bg" | "bs" | "ca" | "cs" | "da" | "de" | "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">;
 /**
  * TypeScript union type for each locale supported by WebGIS SDK
  */

package/dist/intl/index.d.ts

@@ -2,7 +2,7 @@ declare const supportedLocalesArray: ["ar", "bg", "bs", "ca", "cs", "da", "de",
 /**
  * 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 declare const supportedLocales: Set<"hr" | "th" | "tr" | "el" | "ar" | "bg" | "bs" | "ca" | "cs" | "da" | "de" | "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">;
 /**
  * TypeScript union type for each locale supported by WebGIS SDK
  */

package/dist/intl/index.js

@@ -1,4 +1,5 @@
 import { getElementAttribute, observeAncestorsMutation } from "../dom/index.js";
+import { log } from "../log/index.js";
 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(
   ","
 );
@@ -38,12 +39,14 @@ const fetchBundle = async (locale, path) => {
     if (process.env.NODE_ENV !== "production") {
       const is404ViteFallback = String(error).includes(`Unexpected token '<', "<!doctype "... is not valid JSON`);
       if (is404ViteFallback) {
-        console.error(`[404] Localization strings not found at ${filePath}`);
+        log("error", "intl", `Localization strings not found at ${filePath}`);
       } else {
-        console.error(`Error fetching localization strings at ${filePath}`, error);
+        log("error", "intl", `Error fetching localization strings at ${filePath}`, { detail: { error } });
       }
     } else {
-      console.error(error);
+      log("error", "intl", `An unknown error occurred while fetching localization strings at ${filePath}`, {
+        detail: { error }
+      });
     }
     return {};
   }
@@ -79,7 +82,9 @@ const startLocaleObserver = (element, getAssetsPath, onUpdated, assetName) => {
       onUpdated(newResult);
     }
     result = newResult;
-  }).catch(console.error);
+  }).catch((error) => {
+    log("error", "intl", "Error updating component locale state", { detail: { error } });
+  });
   queueMicrotask(callback);
   return observeAncestorsMutation(element, ["lang"], callback);
 };

package/dist/log/index.cjs

@@ -44,12 +44,22 @@ const log = (level, context, message, options) => {
     esriConfig?.log.interceptors?.forEach(
       (interceptor) => interceptor(level, contextString, message, memorySafeDetail)
     );
-    console[level](`[${contextString}]`, message, memorySafeDetail);
+    console[level](`[${contextString}]: ${message}`, memorySafeDetail);
   } else {
     esriConfig?.log.interceptors?.forEach((interceptor) => interceptor(level, contextString, message));
-    console[level](`[${contextString}]`, message);
+    console[level](`[${contextString}]: ${message}`);
   }
 };
+const rethrowError = (context) => {
+  const prefix = `[${getContextString(context)}] `;
+  return (error) => {
+    const errorToRethrow = error instanceof Error && error.message ? error : new Error(String(error));
+    errorToRethrow.message = `${prefix}${errorToRethrow.message}`;
+    setTimeout(() => {
+      throw error;
+    });
+  };
+};
 const composeMissingPropertyMessage = (property) => (
   //#endregion composeMissingPropertyMessage
   `The property \`${property.toString()}\` is required but missing.`
@@ -66,4 +76,5 @@ exports.composeEmptyPropertyMessage = composeEmptyPropertyMessage;
 exports.composeMissingPropertyMessage = composeMissingPropertyMessage;
 exports.log = log;
 exports.logDeprecatedProperty = logDeprecatedProperty;
+exports.rethrowError = rethrowError;
 exports.setEsriConfig = setEsriConfig;

package/dist/log/index.d.cts

@@ -45,6 +45,11 @@ export declare const setEsriConfig: (config: EsriConfig) => void;
 /**
  * Helper utility for logging messages in a consistent manner.
  *
+ * @param level The log level
+ * @param context The context of the log message (e.g., `this` inside a Lit-like component, or just a custom string)
+ * @param message A custom message to log
+ * @param options Additional options for logging, such as to provide a context object
+ *
  * @see [setEsriConfig](#setEsriConfig)
  *
  * @example
@@ -62,6 +67,28 @@ export declare const setEsriConfig: (config: EsriConfig) => void;
  * });
  */
 export declare const log: (level: LogLevel, context: LogContext, message: string, options?: LogOptions) => void;
+/**
+ * Rethrows an error and prepends context information to the error message. The error is
+ * thrown asynchronously to avoid interrupting the current execution stack, so it cannot be caught
+ * with `try/catch` and will bubble to the global object.
+ * @param context From where the error is being thrown (e.g., `this` inside a Lit-like component, or just a custom string)
+ * @returns A function that can be used in `try-catch`/`.catch` to rethrow an error
+ *
+ * @example
+ * ```ts
+ * try {
+ *   functionThatMightThrow();
+ * } catch (error) {
+ *   rethrowError(this)(error);
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * promise.then().catch(rethrowError("context string"));
+ * ```
+ */
+export declare const rethrowError: (context: LogContext) => ((error: unknown) => void);
 type LogContextOrObject = Exclude<LogContext, string> | object;
 type InferPropertyType<T extends LogContextOrObject> = [object] extends [T] ? string : keyof T;
 /**

package/dist/log/index.d.ts

@@ -45,6 +45,11 @@ export declare const setEsriConfig: (config: EsriConfig) => void;
 /**
  * Helper utility for logging messages in a consistent manner.
  *
+ * @param level The log level
+ * @param context The context of the log message (e.g., `this` inside a Lit-like component, or just a custom string)
+ * @param message A custom message to log
+ * @param options Additional options for logging, such as to provide a context object
+ *
  * @see [setEsriConfig](#setEsriConfig)
  *
  * @example
@@ -62,6 +67,28 @@ export declare const setEsriConfig: (config: EsriConfig) => void;
  * });
  */
 export declare const log: (level: LogLevel, context: LogContext, message: string, options?: LogOptions) => void;
+/**
+ * Rethrows an error and prepends context information to the error message. The error is
+ * thrown asynchronously to avoid interrupting the current execution stack, so it cannot be caught
+ * with `try/catch` and will bubble to the global object.
+ * @param context From where the error is being thrown (e.g., `this` inside a Lit-like component, or just a custom string)
+ * @returns A function that can be used in `try-catch`/`.catch` to rethrow an error
+ *
+ * @example
+ * ```ts
+ * try {
+ *   functionThatMightThrow();
+ * } catch (error) {
+ *   rethrowError(this)(error);
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * promise.then().catch(rethrowError("context string"));
+ * ```
+ */
+export declare const rethrowError: (context: LogContext) => ((error: unknown) => void);
 type LogContextOrObject = Exclude<LogContext, string> | object;
 type InferPropertyType<T extends LogContextOrObject> = [object] extends [T] ? string : keyof T;
 /**

package/dist/log/index.js

@@ -42,12 +42,22 @@ const log = (level, context, message, options) => {
     esriConfig?.log.interceptors?.forEach(
       (interceptor) => interceptor(level, contextString, message, memorySafeDetail)
     );
-    console[level](`[${contextString}]`, message, memorySafeDetail);
+    console[level](`[${contextString}]: ${message}`, memorySafeDetail);
   } else {
     esriConfig?.log.interceptors?.forEach((interceptor) => interceptor(level, contextString, message));
-    console[level](`[${contextString}]`, message);
+    console[level](`[${contextString}]: ${message}`);
   }
 };
+const rethrowError = (context) => {
+  const prefix = `[${getContextString(context)}] `;
+  return (error) => {
+    const errorToRethrow = error instanceof Error && error.message ? error : new Error(String(error));
+    errorToRethrow.message = `${prefix}${errorToRethrow.message}`;
+    setTimeout(() => {
+      throw error;
+    });
+  };
+};
 const composeMissingPropertyMessage = (property) => (
   //#endregion composeMissingPropertyMessage
   `The property \`${property.toString()}\` is required but missing.`
@@ -65,5 +75,6 @@ export {
   composeMissingPropertyMessage,
   log,
   logDeprecatedProperty,
+  rethrowError,
   setEsriConfig
 };

package/package.json

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