@itwin/core-i18n 5.8.2 → 5.8.4

package/lib/cjs/test/webpack/bundled-tests.instrumented.js

@@ -19,7 +19,7 @@
  */
 function cov_ogldeftyv() {
   var path = "C:\\agent\\_work\\1\\s\\core\\i18n\\lib\\cjs\\ITwinLocalization.js";
-  var hash = "113751a8262a3149163a15d970bf9098e64926ce";
+  var hash = "d940188727f7c3f13464903c9fef76d730c540e6";
   var global = new Function("return this")();
   var gcv = "__coverage__";
   var coverageData = {
@@ -2123,10 +2123,10 @@ function cov_ogldeftyv() {
       sources: ["C:\\agent\\_work\\1\\s\\core\\i18n\\src\\ITwinLocalization.ts"],
       names: [],
       mappings: ";AAAA;;;+FAG+F;AAC/F;;GAEG;;;;;;AAEH,sDAA2E;AAC3E,wGAAmG;AACnG,gFAAqF;AACrF,sDAA6C;AAG7C,MAAM,mBAAmB,GAAW,CAAC,CAAC,CAAC,8GAA8G;AAcrJ;;;GAGG;AACH,MAAa,iBAAiB;IACrB,OAAO,CAAO;IACJ,YAAY,CAAc;IAC1B,eAAe,CAAiB;IAChC,iBAAiB,CAAkB;IACnC,WAAW,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEhE,YAAmB,OAA6B;QAC9C,IAAI,CAAC,OAAO,GAAG,iBAAO,CAAC,cAAc,EAAE,CAAC;QAExC,IAAI,CAAC,eAAe,GAAG;YACrB,QAAQ,EAAE,OAAO,EAAE,WAAW,IAAI,6BAA6B;YAC/D,WAAW,EAAE,IAAI;YACjB,GAAG,OAAO,EAAE,kBAAkB;SAC/B,CAAC;QAEF,IAAI,CAAC,iBAAiB,GAAG;YACvB,KAAK,EAAE,CAAC,aAAa,EAAE,WAAW,EAAE,SAAS,CAAC;YAC9C,iBAAiB,EAAE,KAAK;YACxB,MAAM,EAAE,EAAE;YACV,GAAG,OAAO,EAAE,eAAe;SAC5B,CAAC;QAEF,IAAI,CAAC,YAAY,GAAG;YAClB,aAAa,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;YACpC,WAAW,EAAE,IAAI;YACjB,UAAU,EAAE,mBAAmB;YAC/B,OAAO,EAAE,IAAI,CAAC,eAAe;YAC7B,SAAS,EAAE,IAAI,CAAC,iBAAiB;YACjC,GAAG,OAAO,EAAE,WAAW;SACxB,CAAC;QAEF,IAAI,CAAC,OAAO;aACT,GAAG,CAAC,OAAO,EAAE,cAAc,IAAI,0CAA8B,CAAC;aAC9D,GAAG,CAAC,OAAO,EAAE,aAAa,IAAI,8BAAO,CAAC;aACtC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC5B,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,UAAoB;QAE1C,mDAAmD;QACnD,MAAM,cAAc,GAAa,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACrE,MAAM,kBAAkB,GAAgB,IAAI,GAAG,CAAC,CAAC,GAAG,UAAU,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,qBAAqB;QAE1G,MAAM,gBAAgB,GAAuC,IAAI,CAAC,YAAY,CAAC,SAAS,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1G,IAAI,gBAAgB;YAClB,kBAAkB,CAAC,GAAG,CAAC,gBAA0B,CAAC,CAAC,CAAC,oDAAoD;QAE1G,MAAM,WAAW,GAAgB;YAC/B,GAAG,IAAI,CAAC,YAAY;YACpB,SAAS,EAAE,gBAAgB;YAC3B,EAAE,EAAE,CAAC,GAAG,kBAAkB,CAAC;SAC5B,CAAC;QAEF,iDAAiD;QACjD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa;YACxC,WAAW,CAAC,KAAK,GAAG,IAAI,CAAC;QAE3B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAA6B,CAAC;QAE/E,KAAK,MAAM,EAAE,IAAI,UAAU;YACzB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QAExC,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACI,gBAAgB,CAAC,IAAY;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC;IACrF,CAAC;IAED;;;;;;;;;;;;OAYG;IACI,kBAAkB,CAAC,GAAsB,EAAE,OAAsB;QACtE,IAAI,OAAO,EAAE,aAAa,IAAI,OAAO,EAAE,aAAa,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,sFAAsF,CAAC,CAAC;QAC1G,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAE3C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;OAMG;IACI,gBAAgB,CAAC,SAAiB,EAAE,GAAsB,EAAE,OAAsB;QACvF,IAAI,OAAO,EAAE,aAAa,IAAI,OAAO,EAAE,aAAa,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,sFAAsF,CAAC,CAAC;QAC1G,CAAC;QAED,OAAO,GAAG;YACR,GAAG,OAAO;YACV,EAAE,EAAE,SAAS,EAAE,oCAAoC;SACpD,CAAC;QAEF,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACnD,MAAM,GAAG,GAAG,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC7B,IAAI,OAAO,GAAG,KAAK,QAAQ;YACzB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAElD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;OAGG;IACI,mBAAmB,CAAC,IAAY;QACrC,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,gBAAgB;IACT,eAAe;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;IAChC,CAAC;IAED,qDAAqD;IAC9C,KAAK,CAAC,cAAc,CAAC,QAAgB;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,QAAQ,CAA6B,CAAC;IAC3E,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,iBAAiB,CAAC,IAAY;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,QAAQ,KAAK,SAAS;YACxB,OAAO,QAAQ,CAAC;QAElB,MAAM,cAAc,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnD,mEAAmE;YACnE,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE;gBACxC,IAAI,CAAC,GAAG;oBACN,OAAO,OAAO,EAAE,CAAC;gBAEnB,qCAAqC;gBACrC,yHAAyH;gBACzH,2GAA2G;gBAC3G,8HAA8H;gBAC9H,8IAA8I;gBAC9I,IAAI,OAAO,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,CAAC,UAAe,EAAE,EAAE,CAAC,IAAI,UAAU,GAAG,CAAC,CAAC;gBAEjF,IAAI,CAAC;oBACH,KAAK,MAAM,SAAS,IAAI,GAAG,EAAE,CAAC;wBAC5B,IAAI,OAAO,SAAS,KAAK,QAAQ;4BAC/B,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;oBAC9E,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,GAAG,EAAE,CAAC;gBACf,CAAC;gBACD,+DAA+D;gBAC/D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;oBACtB,qBAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,8BAA8B,IAAI,kBAAkB,CAAC,CAAC;gBAEhF,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAC3C,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,gBAAgB;IACT,mBAAmB,CAAC,IAAY;QACrC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;CACF;AA7MD,8CA6MC;AAED,MAAM,iBAAiB;IACd,MAAM,CAAU,IAAI,GAAG,QAAQ,CAAC;IAChC,GAAG,CAAC,IAAc,IAAI,qBAAM,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,IAAI,CAAC,IAAc,IAAI,qBAAM,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAChF,KAAK,CAAC,IAAc,IAAI,qBAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,gBAAgB,CAAC,IAAc;QACrC,IAAI,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;YACrC,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ;gBAC7B,OAAO,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAChC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC",
-      sourcesContent: ["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Localization\r\n */\r\n\r\nimport i18next, { i18n, InitOptions, Module, TOptionsBase } from \"i18next\";\r\nimport i18nextBrowserLanguageDetector, { DetectorOptions } from \"i18next-browser-languagedetector\";\r\nimport Backend, { HttpBackendOptions as BackendOptions } from \"i18next-http-backend\";\r\nimport { Logger } from \"@itwin/core-bentley\";\r\nimport type { Localization } from \"@itwin/core-common\";\r\n\r\nconst DEFAULT_MAX_RETRIES: number = 1; // a low number prevents wasted time and potential timeouts when requesting localization files throws an error\r\n\r\n/** Options for ITwinLocalization\r\n *  @public\r\n */\r\nexport interface LocalizationOptions {\r\n  urlTemplate?: string;\r\n  backendPlugin?: Module;\r\n  detectorPlugin?: Module;\r\n  initOptions?: InitOptions;\r\n  backendHttpOptions?: BackendOptions;\r\n  detectorOptions?: DetectorOptions;\r\n}\r\n\r\n/** Supplies localizations for iTwin.js\r\n * @note this class uses the [i18next](https://www.i18next.com/) package.\r\n * @public\r\n */\r\nexport class ITwinLocalization implements Localization {\r\n  public i18next: i18n;\r\n  private readonly _initOptions: InitOptions;\r\n  private readonly _backendOptions: BackendOptions;\r\n  private readonly _detectionOptions: DetectorOptions;\r\n  private readonly _namespaces = new Map<string, Promise<void>>();\r\n\r\n  public constructor(options?: LocalizationOptions) {\r\n    this.i18next = i18next.createInstance();\r\n\r\n    this._backendOptions = {\r\n      loadPath: options?.urlTemplate ?? \"locales/{{lng}}/{{ns}}.json\",\r\n      crossDomain: true,\r\n      ...options?.backendHttpOptions,\r\n    };\r\n\r\n    this._detectionOptions = {\r\n      order: [\"querystring\", \"navigator\", \"htmlTag\"],\r\n      lookupQuerystring: \"lng\",\r\n      caches: [],\r\n      ...options?.detectorOptions,\r\n    };\r\n\r\n    this._initOptions = {\r\n      interpolation: { escapeValue: true },\r\n      fallbackLng: \"en\",\r\n      maxRetries: DEFAULT_MAX_RETRIES,\r\n      backend: this._backendOptions,\r\n      detection: this._detectionOptions,\r\n      ...options?.initOptions,\r\n    };\r\n\r\n    this.i18next\r\n      .use(options?.detectorPlugin ?? i18nextBrowserLanguageDetector)\r\n      .use(options?.backendPlugin ?? Backend)\r\n      .use(TranslationLogger);\r\n  }\r\n\r\n  public async initialize(namespaces: string[]): Promise<void> {\r\n\r\n    // Also consider namespaces passed into constructor\r\n    const initNamespaces: string[] = [this._initOptions.ns || []].flat();\r\n    const combinedNamespaces: Set<string> = new Set([...namespaces, ...initNamespaces]); // without duplicates\r\n\r\n    const defaultNamespace: string | false | readonly string[] = this._initOptions.defaultNS ?? namespaces[0];\r\n    if (defaultNamespace)\r\n      combinedNamespaces.add(defaultNamespace as string); // Make sure default namespace is in namespaces list\r\n\r\n    const initOptions: InitOptions = {\r\n      ...this._initOptions,\r\n      defaultNS: defaultNamespace,\r\n      ns: [...combinedNamespaces],\r\n    };\r\n\r\n    // if in a development environment, set debugging\r\n    if (process.env.NODE_ENV === \"development\")\r\n      initOptions.debug = true;\r\n\r\n    const initPromise = this.i18next.init(initOptions) as unknown as Promise<void>;\r\n\r\n    for (const ns of namespaces)\r\n      this._namespaces.set(ns, initPromise);\r\n\r\n    return initPromise;\r\n  }\r\n\r\n  /** Replace all instances of `%{key}` within a string with the translations of those keys.\r\n   * For example:\r\n   * ``` ts\r\n   * \"MyKeys\": {\r\n   *   \"Key1\": \"First value\",\r\n   *   \"Key2\": \"Second value\"\r\n   *  }\r\n   * ```\r\n   *\r\n   * ``` ts\r\n   * i18.translateKeys(\"string with %{MyKeys.Key1} followed by %{MyKeys.Key2}!\"\") // returns \"string with First Value followed by Second Value!\"\r\n   * ```\r\n   * @param line The input line, potentially containing %{keys}.\r\n   * @returns The line with all %{keys} translated\r\n   * @public\r\n   */\r\n  public getLocalizedKeys(line: string): string {\r\n    return line.replace(/\\%\\{(.+?)\\}/g, (_match, tag) => this.getLocalizedString(tag));\r\n  }\r\n\r\n  /** Return the translated value of a key.\r\n   * @param key - the key that matches a property in the JSON localization file.\r\n   * @note The key includes the namespace, which identifies the particular localization file that contains the property,\r\n   * followed by a colon, followed by the property in the JSON file.\r\n   * For example:\r\n   * ``` ts\r\n   * const dataString: string = IModelApp.localization.getLocalizedString(\"iModelJs:BackgroundMap.BingDataAttribution\");\r\n   *  ```\r\n   * assigns to dataString the string with property BackgroundMap.BingDataAttribution from the iModelJs.json localization file.\r\n   * @returns The string corresponding to the first key that resolves.\r\n   * @throws Error if no keys resolve to a string.\r\n   * @public\r\n   */\r\n  public getLocalizedString(key: string | string[], options?: TOptionsBase): string {\r\n    if (options?.returnDetails || options?.returnObjects) {\r\n      throw new Error(\"Translation key must map to a string, but the given options will result in an object\");\r\n    }\r\n\r\n    const value = this.i18next.t(key, options);\r\n\r\n    if (typeof value !== \"string\") {\r\n      throw new Error(\"Translation key(s) string not found\");\r\n    }\r\n\r\n    return value;\r\n  }\r\n\r\n  /** Gets the English translation.\r\n   * @param namespace - the namespace that identifies the particular localization file that contains the property.\r\n   * @param key - the key that matches a property in the JSON localization file.\r\n   * @returns The string corresponding to the first key that resolves.\r\n   * @throws Error if no keys resolve to a string.\r\n   * @internal\r\n   */\r\n  public getEnglishString(namespace: string, key: string | string[], options?: TOptionsBase): string {\r\n    if (options?.returnDetails || options?.returnObjects) {\r\n      throw new Error(\"Translation key must map to a string, but the given options will result in an object\");\r\n    }\r\n\r\n    options = {\r\n      ...options,\r\n      ns: namespace, // ensure namespace argument is used\r\n    };\r\n\r\n    const en = this.i18next.getFixedT(\"en\", namespace);\r\n    const str = en(key, options);\r\n    if (typeof str !== \"string\")\r\n      throw new Error(\"Translation key(s) not found\");\r\n\r\n    return str;\r\n  }\r\n\r\n  /** Get the promise for an already registered Namespace.\r\n   * @param name - the name of the namespace\r\n   * @public\r\n   */\r\n  public getNamespacePromise(name: string): Promise<void> | undefined {\r\n    return this._namespaces.get(name);\r\n  }\r\n\r\n  /** @internal */\r\n  public getLanguageList(): readonly string[] {\r\n    return this.i18next.languages;\r\n  }\r\n\r\n  /** override the language detected in the browser  */\r\n  public async changeLanguage(language: string) {\r\n    return this.i18next.changeLanguage(language) as unknown as Promise<void>;\r\n  }\r\n\r\n  /** Register a new Namespace and return it. If the namespace is already registered, it will be returned.\r\n   * @param name - the name of the namespace, which is the base name of the JSON file that contains the localization properties.\r\n   * @note - The registerNamespace method starts fetching the appropriate version of the JSON localization file from the server,\r\n   * based on the current locale. To make sure that fetch is complete before performing translations from this namespace, await\r\n   * fulfillment of the readPromise Promise property of the returned LocalizationNamespace.\r\n   * @see [Localization in iTwin.js]($docs/learning/frontend/Localization.md)\r\n   * @public\r\n   */\r\n  public async registerNamespace(name: string): Promise<void> {\r\n    const existing = this._namespaces.get(name);\r\n    if (existing !== undefined)\r\n      return existing;\r\n\r\n    const theReadPromise = new Promise<void>((resolve) => {\r\n      // eslint-disable-next-line @typescript-eslint/no-floating-promises\r\n      this.i18next.loadNamespaces(name, (err) => {\r\n        if (!err)\r\n          return resolve();\r\n\r\n        // Here we got a non-null err object.\r\n        // This method is called when the system has attempted to load the resources for the namespaces for each possible locale.\r\n        // For example 'fr-ca' might be the most specific locale, in which case 'fr' and 'en' are fallback locales.\r\n        // Using Backend from i18next-http-backend, err will be an array of strings of each namespace it tried to read and its locale.\r\n        // There might be errs for some other namespaces as well as this one. We resolve the promise unless there's an error for each possible locale.\r\n        let locales = this.getLanguageList().map((thisLocale: any) => `/${thisLocale}/`);\r\n\r\n        try {\r\n          for (const thisError of err) {\r\n            if (typeof thisError === \"string\")\r\n              locales = locales.filter((thisLocale) => !thisError.includes(thisLocale));\r\n          }\r\n        } catch {\r\n          locales = [];\r\n        }\r\n        // if we removed every locale from the array, it wasn't loaded.\r\n        if (locales.length === 0)\r\n          Logger.logError(\"i18n\", `No resources for namespace ${name} could be loaded`);\r\n\r\n        resolve();\r\n      });\r\n    });\r\n    this._namespaces.set(name, theReadPromise);\r\n    return theReadPromise;\r\n  }\r\n\r\n  /** @internal */\r\n  public unregisterNamespace(name: string): void {\r\n    this._namespaces.delete(name);\r\n  }\r\n}\r\n\r\nclass TranslationLogger {\r\n  public static readonly type = \"logger\";\r\n  public log(args: string[]) { Logger.logInfo(\"i18n\", this.createLogMessage(args)); }\r\n  public warn(args: string[]) { Logger.logWarning(\"i18n\", this.createLogMessage(args)); }\r\n  public error(args: string[]) { Logger.logError(\"i18n\", this.createLogMessage(args)); }\r\n  private createLogMessage(args: string[]) {\r\n    let message = args[0];\r\n    for (let i = 1; i < args.length; ++i) {\r\n      if (typeof args[i] === \"string\")\r\n        message += `\\n  ${args[i]}`;\r\n    }\r\n    return message;\r\n  }\r\n}\r\n"]
+      sourcesContent: ["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Localization\n */\n\nimport i18next, { i18n, InitOptions, Module, TOptionsBase } from \"i18next\";\nimport i18nextBrowserLanguageDetector, { DetectorOptions } from \"i18next-browser-languagedetector\";\nimport Backend, { HttpBackendOptions as BackendOptions } from \"i18next-http-backend\";\nimport { Logger } from \"@itwin/core-bentley\";\nimport type { Localization } from \"@itwin/core-common\";\n\nconst DEFAULT_MAX_RETRIES: number = 1; // a low number prevents wasted time and potential timeouts when requesting localization files throws an error\n\n/** Options for ITwinLocalization\n *  @public\n */\nexport interface LocalizationOptions {\n  urlTemplate?: string;\n  backendPlugin?: Module;\n  detectorPlugin?: Module;\n  initOptions?: InitOptions;\n  backendHttpOptions?: BackendOptions;\n  detectorOptions?: DetectorOptions;\n}\n\n/** Supplies localizations for iTwin.js\n * @note this class uses the [i18next](https://www.i18next.com/) package.\n * @public\n */\nexport class ITwinLocalization implements Localization {\n  public i18next: i18n;\n  private readonly _initOptions: InitOptions;\n  private readonly _backendOptions: BackendOptions;\n  private readonly _detectionOptions: DetectorOptions;\n  private readonly _namespaces = new Map<string, Promise<void>>();\n\n  public constructor(options?: LocalizationOptions) {\n    this.i18next = i18next.createInstance();\n\n    this._backendOptions = {\n      loadPath: options?.urlTemplate ?? \"locales/{{lng}}/{{ns}}.json\",\n      crossDomain: true,\n      ...options?.backendHttpOptions,\n    };\n\n    this._detectionOptions = {\n      order: [\"querystring\", \"navigator\", \"htmlTag\"],\n      lookupQuerystring: \"lng\",\n      caches: [],\n      ...options?.detectorOptions,\n    };\n\n    this._initOptions = {\n      interpolation: { escapeValue: true },\n      fallbackLng: \"en\",\n      maxRetries: DEFAULT_MAX_RETRIES,\n      backend: this._backendOptions,\n      detection: this._detectionOptions,\n      ...options?.initOptions,\n    };\n\n    this.i18next\n      .use(options?.detectorPlugin ?? i18nextBrowserLanguageDetector)\n      .use(options?.backendPlugin ?? Backend)\n      .use(TranslationLogger);\n  }\n\n  public async initialize(namespaces: string[]): Promise<void> {\n\n    // Also consider namespaces passed into constructor\n    const initNamespaces: string[] = [this._initOptions.ns || []].flat();\n    const combinedNamespaces: Set<string> = new Set([...namespaces, ...initNamespaces]); // without duplicates\n\n    const defaultNamespace: string | false | readonly string[] = this._initOptions.defaultNS ?? namespaces[0];\n    if (defaultNamespace)\n      combinedNamespaces.add(defaultNamespace as string); // Make sure default namespace is in namespaces list\n\n    const initOptions: InitOptions = {\n      ...this._initOptions,\n      defaultNS: defaultNamespace,\n      ns: [...combinedNamespaces],\n    };\n\n    // if in a development environment, set debugging\n    if (process.env.NODE_ENV === \"development\")\n      initOptions.debug = true;\n\n    const initPromise = this.i18next.init(initOptions) as unknown as Promise<void>;\n\n    for (const ns of namespaces)\n      this._namespaces.set(ns, initPromise);\n\n    return initPromise;\n  }\n\n  /** Replace all instances of `%{key}` within a string with the translations of those keys.\n   * For example:\n   * ``` ts\n   * \"MyKeys\": {\n   *   \"Key1\": \"First value\",\n   *   \"Key2\": \"Second value\"\n   *  }\n   * ```\n   *\n   * ``` ts\n   * i18.translateKeys(\"string with %{MyKeys.Key1} followed by %{MyKeys.Key2}!\"\") // returns \"string with First Value followed by Second Value!\"\n   * ```\n   * @param line The input line, potentially containing %{keys}.\n   * @returns The line with all %{keys} translated\n   * @public\n   */\n  public getLocalizedKeys(line: string): string {\n    return line.replace(/\\%\\{(.+?)\\}/g, (_match, tag) => this.getLocalizedString(tag));\n  }\n\n  /** Return the translated value of a key.\n   * @param key - the key that matches a property in the JSON localization file.\n   * @note The key includes the namespace, which identifies the particular localization file that contains the property,\n   * followed by a colon, followed by the property in the JSON file.\n   * For example:\n   * ``` ts\n   * const dataString: string = IModelApp.localization.getLocalizedString(\"iModelJs:BackgroundMap.BingDataAttribution\");\n   *  ```\n   * assigns to dataString the string with property BackgroundMap.BingDataAttribution from the iModelJs.json localization file.\n   * @returns The string corresponding to the first key that resolves.\n   * @throws Error if no keys resolve to a string.\n   * @public\n   */\n  public getLocalizedString(key: string | string[], options?: TOptionsBase): string {\n    if (options?.returnDetails || options?.returnObjects) {\n      throw new Error(\"Translation key must map to a string, but the given options will result in an object\");\n    }\n\n    const value = this.i18next.t(key, options);\n\n    if (typeof value !== \"string\") {\n      throw new Error(\"Translation key(s) string not found\");\n    }\n\n    return value;\n  }\n\n  /** Gets the English translation.\n   * @param namespace - the namespace that identifies the particular localization file that contains the property.\n   * @param key - the key that matches a property in the JSON localization file.\n   * @returns The string corresponding to the first key that resolves.\n   * @throws Error if no keys resolve to a string.\n   * @internal\n   */\n  public getEnglishString(namespace: string, key: string | string[], options?: TOptionsBase): string {\n    if (options?.returnDetails || options?.returnObjects) {\n      throw new Error(\"Translation key must map to a string, but the given options will result in an object\");\n    }\n\n    options = {\n      ...options,\n      ns: namespace, // ensure namespace argument is used\n    };\n\n    const en = this.i18next.getFixedT(\"en\", namespace);\n    const str = en(key, options);\n    if (typeof str !== \"string\")\n      throw new Error(\"Translation key(s) not found\");\n\n    return str;\n  }\n\n  /** Get the promise for an already registered Namespace.\n   * @param name - the name of the namespace\n   * @public\n   */\n  public getNamespacePromise(name: string): Promise<void> | undefined {\n    return this._namespaces.get(name);\n  }\n\n  /** @internal */\n  public getLanguageList(): readonly string[] {\n    return this.i18next.languages;\n  }\n\n  /** override the language detected in the browser  */\n  public async changeLanguage(language: string) {\n    return this.i18next.changeLanguage(language) as unknown as Promise<void>;\n  }\n\n  /** Register a new Namespace and return it. If the namespace is already registered, it will be returned.\n   * @param name - the name of the namespace, which is the base name of the JSON file that contains the localization properties.\n   * @note - The registerNamespace method starts fetching the appropriate version of the JSON localization file from the server,\n   * based on the current locale. To make sure that fetch is complete before performing translations from this namespace, await\n   * fulfillment of the readPromise Promise property of the returned LocalizationNamespace.\n   * @see [Localization in iTwin.js]($docs/learning/frontend/Localization.md)\n   * @public\n   */\n  public async registerNamespace(name: string): Promise<void> {\n    const existing = this._namespaces.get(name);\n    if (existing !== undefined)\n      return existing;\n\n    const theReadPromise = new Promise<void>((resolve) => {\n      // eslint-disable-next-line @typescript-eslint/no-floating-promises\n      this.i18next.loadNamespaces(name, (err) => {\n        if (!err)\n          return resolve();\n\n        // Here we got a non-null err object.\n        // This method is called when the system has attempted to load the resources for the namespaces for each possible locale.\n        // For example 'fr-ca' might be the most specific locale, in which case 'fr' and 'en' are fallback locales.\n        // Using Backend from i18next-http-backend, err will be an array of strings of each namespace it tried to read and its locale.\n        // There might be errs for some other namespaces as well as this one. We resolve the promise unless there's an error for each possible locale.\n        let locales = this.getLanguageList().map((thisLocale: any) => `/${thisLocale}/`);\n\n        try {\n          for (const thisError of err) {\n            if (typeof thisError === \"string\")\n              locales = locales.filter((thisLocale) => !thisError.includes(thisLocale));\n          }\n        } catch {\n          locales = [];\n        }\n        // if we removed every locale from the array, it wasn't loaded.\n        if (locales.length === 0)\n          Logger.logError(\"i18n\", `No resources for namespace ${name} could be loaded`);\n\n        resolve();\n      });\n    });\n    this._namespaces.set(name, theReadPromise);\n    return theReadPromise;\n  }\n\n  /** @internal */\n  public unregisterNamespace(name: string): void {\n    this._namespaces.delete(name);\n  }\n}\n\nclass TranslationLogger {\n  public static readonly type = \"logger\";\n  public log(args: string[]) { Logger.logInfo(\"i18n\", this.createLogMessage(args)); }\n  public warn(args: string[]) { Logger.logWarning(\"i18n\", this.createLogMessage(args)); }\n  public error(args: string[]) { Logger.logError(\"i18n\", this.createLogMessage(args)); }\n  private createLogMessage(args: string[]) {\n    let message = args[0];\n    for (let i = 1; i < args.length; ++i) {\n      if (typeof args[i] === \"string\")\n        message += `\\n  ${args[i]}`;\n    }\n    return message;\n  }\n}\n"]
     },
     _coverageSchema: "1a1c01bbd47fc00a2c39e90264f33305004495a9",
-    hash: "113751a8262a3149163a15d970bf9098e64926ce"
+    hash: "d940188727f7c3f13464903c9fef76d730c540e6"
   };
   var coverage = global[gcv] || (global[gcv] = {});
   if (!coverage[path] || coverage[path].hash !== hash) {
@@ -23821,6 +23821,69 @@ class UnexpectedErrors {
 }
 
 
+/***/ }),
+
+/***/ "../bentley/lib/esm/UtilityFunctions.js":
+/*!**********************************************!*\
+  !*** ../bentley/lib/esm/UtilityFunctions.js ***!
+  \**********************************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   wrapTimerCallback: () => (/* binding */ wrapTimerCallback)
+/* harmony export */ });
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Utils
+ */
+/**
+ * Wrapper function designed to be used for callbacks called by setInterval or setTimeout in order to propagate any
+ * exceptions thrown in the callback to the main promise chain. It does this by creating a new promise for the callback
+ * invocation and adding it to the timerPromises set. The main promise chain can then await
+ * Promise.all(timerPromises) to catch any exceptions thrown in any of the callbacks. Note that if the callback
+ * completes successfully, the promise is resolved and removed from the set. If it throws an exception, the promise is
+ * rejected but not removed from the set, so that the main promise chain can detect that an error occurred and handle
+ * it appropriately.
+ * @param timerPromises A set of promises representing the currently active timer callbacks.
+ * @param callback The async callback to be executed within the timer.
+ * @beta
+ */
+async function wrapTimerCallback(timerPromises, callback) {
+    let resolvePromise;
+    let rejectPromise;
+    // The callback of the Promise constructor does not have access to the promise itself, so all we do there is
+    // capture the resolve and reject functions for use in the async callback that would have otherwise been
+    // placed in the setInterval or setTimeout callback.
+    const timerPromise = new Promise((resolve, reject) => {
+        resolvePromise = resolve;
+        rejectPromise = reject;
+    });
+    // Note: when we get here, resolvePromise and rejectPromise will always be defined, but there is no way to
+    // convince TS of that fact without extra unnecessary checks, so we use ?. when accessing them.
+    // Prevent unhandled rejection warnings. The rejection is still observable
+    // when the consumer awaits Promise.all(promises).
+    timerPromise.catch(() => { });
+    timerPromises.add(timerPromise);
+    const cleanupAndResolve = () => {
+        resolvePromise?.();
+        // No need to keep track of this promise anymore since it's resolved.
+        timerPromises.delete(timerPromise);
+    };
+    try {
+        await callback();
+        cleanupAndResolve();
+    }
+    catch (err) {
+        rejectPromise?.(err);
+    }
+}
+
+
 /***/ }),
 
 /***/ "../bentley/lib/esm/UtilityTypes.js":
@@ -23950,12 +24013,12 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   ByteStream: () => (/* reexport safe */ _ByteStream__WEBPACK_IMPORTED_MODULE_7__.ByteStream),
 /* harmony export */   ChangeSetStatus: () => (/* reexport safe */ _BentleyError__WEBPACK_IMPORTED_MODULE_3__.ChangeSetStatus),
 /* harmony export */   CompressedId64Set: () => (/* reexport safe */ _CompressedId64Set__WEBPACK_IMPORTED_MODULE_10__.CompressedId64Set),
-/* harmony export */   DbChangeStage: () => (/* reexport safe */ _internal_cross_package__WEBPACK_IMPORTED_MODULE_36__.DbChangeStage),
-/* harmony export */   DbConflictCause: () => (/* reexport safe */ _internal_cross_package__WEBPACK_IMPORTED_MODULE_36__.DbConflictCause),
-/* harmony export */   DbConflictResolution: () => (/* reexport safe */ _internal_cross_package__WEBPACK_IMPORTED_MODULE_36__.DbConflictResolution),
+/* harmony export */   DbChangeStage: () => (/* reexport safe */ _internal_cross_package__WEBPACK_IMPORTED_MODULE_37__.DbChangeStage),
+/* harmony export */   DbConflictCause: () => (/* reexport safe */ _internal_cross_package__WEBPACK_IMPORTED_MODULE_37__.DbConflictCause),
+/* harmony export */   DbConflictResolution: () => (/* reexport safe */ _internal_cross_package__WEBPACK_IMPORTED_MODULE_37__.DbConflictResolution),
 /* harmony export */   DbOpcode: () => (/* reexport safe */ _BeSQLite__WEBPACK_IMPORTED_MODULE_6__.DbOpcode),
 /* harmony export */   DbResult: () => (/* reexport safe */ _BeSQLite__WEBPACK_IMPORTED_MODULE_6__.DbResult),
-/* harmony export */   DbValueType: () => (/* reexport safe */ _internal_cross_package__WEBPACK_IMPORTED_MODULE_36__.DbValueType),
+/* harmony export */   DbValueType: () => (/* reexport safe */ _internal_cross_package__WEBPACK_IMPORTED_MODULE_37__.DbValueType),
 /* harmony export */   Dictionary: () => (/* reexport safe */ _Dictionary__WEBPACK_IMPORTED_MODULE_11__.Dictionary),
 /* harmony export */   DisposableList: () => (/* reexport safe */ _Disposable__WEBPACK_IMPORTED_MODULE_12__.DisposableList),
 /* harmony export */   DuplicatePolicy: () => (/* reexport safe */ _SortedArray__WEBPACK_IMPORTED_MODULE_27__.DuplicatePolicy),
@@ -23989,7 +24052,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   ReadonlyOrderedSet: () => (/* reexport safe */ _OrderedSet__WEBPACK_IMPORTED_MODULE_23__.ReadonlyOrderedSet),
 /* harmony export */   ReadonlySortedArray: () => (/* reexport safe */ _SortedArray__WEBPACK_IMPORTED_MODULE_27__.ReadonlySortedArray),
 /* harmony export */   RealityDataStatus: () => (/* reexport safe */ _BentleyError__WEBPACK_IMPORTED_MODULE_3__.RealityDataStatus),
-/* harmony export */   RepositoryStatus: () => (/* reexport safe */ _internal_cross_package__WEBPACK_IMPORTED_MODULE_36__.RepositoryStatus),
+/* harmony export */   RepositoryStatus: () => (/* reexport safe */ _internal_cross_package__WEBPACK_IMPORTED_MODULE_37__.RepositoryStatus),
 /* harmony export */   RpcInterfaceStatus: () => (/* reexport safe */ _BentleyError__WEBPACK_IMPORTED_MODULE_3__.RpcInterfaceStatus),
 /* harmony export */   SortedArray: () => (/* reexport safe */ _SortedArray__WEBPACK_IMPORTED_MODULE_27__.SortedArray),
 /* harmony export */   SpanKind: () => (/* reexport safe */ _Tracing__WEBPACK_IMPORTED_MODULE_30__.SpanKind),
@@ -24005,9 +24068,9 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   Uint8ArrayBuilder: () => (/* reexport safe */ _TypedArrayBuilder__WEBPACK_IMPORTED_MODULE_32__.Uint8ArrayBuilder),
 /* harmony export */   UintArrayBuilder: () => (/* reexport safe */ _TypedArrayBuilder__WEBPACK_IMPORTED_MODULE_32__.UintArrayBuilder),
 /* harmony export */   UnexpectedErrors: () => (/* reexport safe */ _UnexpectedErrors__WEBPACK_IMPORTED_MODULE_33__.UnexpectedErrors),
-/* harmony export */   YieldManager: () => (/* reexport safe */ _YieldManager__WEBPACK_IMPORTED_MODULE_35__.YieldManager),
+/* harmony export */   YieldManager: () => (/* reexport safe */ _YieldManager__WEBPACK_IMPORTED_MODULE_36__.YieldManager),
 /* harmony export */   areEqualPossiblyUndefined: () => (/* reexport safe */ _Compare__WEBPACK_IMPORTED_MODULE_9__.areEqualPossiblyUndefined),
-/* harmony export */   asInstanceOf: () => (/* reexport safe */ _UtilityTypes__WEBPACK_IMPORTED_MODULE_34__.asInstanceOf),
+/* harmony export */   asInstanceOf: () => (/* reexport safe */ _UtilityTypes__WEBPACK_IMPORTED_MODULE_35__.asInstanceOf),
 /* harmony export */   assert: () => (/* reexport safe */ _Assert__WEBPACK_IMPORTED_MODULE_1__.assert),
 /* harmony export */   base64StringToUint8Array: () => (/* reexport safe */ _StringUtils__WEBPACK_IMPORTED_MODULE_28__.base64StringToUint8Array),
 /* harmony export */   compareArrays: () => (/* reexport safe */ _Compare__WEBPACK_IMPORTED_MODULE_9__.compareArrays),
@@ -24027,15 +24090,16 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   expectNotNull: () => (/* reexport safe */ _Expect__WEBPACK_IMPORTED_MODULE_13__.expectNotNull),
 /* harmony export */   isDisposable: () => (/* reexport safe */ _Disposable__WEBPACK_IMPORTED_MODULE_12__.isDisposable),
 /* harmony export */   isIDisposable: () => (/* reexport safe */ _Disposable__WEBPACK_IMPORTED_MODULE_12__.isIDisposable),
-/* harmony export */   isInstanceOf: () => (/* reexport safe */ _UtilityTypes__WEBPACK_IMPORTED_MODULE_34__.isInstanceOf),
+/* harmony export */   isInstanceOf: () => (/* reexport safe */ _UtilityTypes__WEBPACK_IMPORTED_MODULE_35__.isInstanceOf),
 /* harmony export */   isProperSubclassOf: () => (/* reexport safe */ _ClassUtils__WEBPACK_IMPORTED_MODULE_8__.isProperSubclassOf),
 /* harmony export */   isSubclassOf: () => (/* reexport safe */ _ClassUtils__WEBPACK_IMPORTED_MODULE_8__.isSubclassOf),
 /* harmony export */   lowerBound: () => (/* reexport safe */ _SortedArray__WEBPACK_IMPORTED_MODULE_27__.lowerBound),
-/* harmony export */   omit: () => (/* reexport safe */ _UtilityTypes__WEBPACK_IMPORTED_MODULE_34__.omit),
+/* harmony export */   omit: () => (/* reexport safe */ _UtilityTypes__WEBPACK_IMPORTED_MODULE_35__.omit),
 /* harmony export */   partitionArray: () => (/* reexport safe */ _partitionArray__WEBPACK_IMPORTED_MODULE_24__.partitionArray),
 /* harmony export */   shallowClone: () => (/* reexport safe */ _SortedArray__WEBPACK_IMPORTED_MODULE_27__.shallowClone),
 /* harmony export */   using: () => (/* reexport safe */ _Disposable__WEBPACK_IMPORTED_MODULE_12__.using),
-/* harmony export */   utf8ToString: () => (/* reexport safe */ _StringUtils__WEBPACK_IMPORTED_MODULE_28__.utf8ToString)
+/* harmony export */   utf8ToString: () => (/* reexport safe */ _StringUtils__WEBPACK_IMPORTED_MODULE_28__.utf8ToString),
+/* harmony export */   wrapTimerCallback: () => (/* reexport safe */ _UtilityFunctions__WEBPACK_IMPORTED_MODULE_34__.wrapTimerCallback)
 /* harmony export */ });
 /* harmony import */ var _AccessToken__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./AccessToken */ "../bentley/lib/esm/AccessToken.js");
 /* harmony import */ var _Assert__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./Assert */ "../bentley/lib/esm/Assert.js");
@@ -24071,9 +24135,10 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _TupleKeyedMap__WEBPACK_IMPORTED_MODULE_31__ = __webpack_require__(/*! ./TupleKeyedMap */ "../bentley/lib/esm/TupleKeyedMap.js");
 /* harmony import */ var _TypedArrayBuilder__WEBPACK_IMPORTED_MODULE_32__ = __webpack_require__(/*! ./TypedArrayBuilder */ "../bentley/lib/esm/TypedArrayBuilder.js");
 /* harmony import */ var _UnexpectedErrors__WEBPACK_IMPORTED_MODULE_33__ = __webpack_require__(/*! ./UnexpectedErrors */ "../bentley/lib/esm/UnexpectedErrors.js");
-/* harmony import */ var _UtilityTypes__WEBPACK_IMPORTED_MODULE_34__ = __webpack_require__(/*! ./UtilityTypes */ "../bentley/lib/esm/UtilityTypes.js");
-/* harmony import */ var _YieldManager__WEBPACK_IMPORTED_MODULE_35__ = __webpack_require__(/*! ./YieldManager */ "../bentley/lib/esm/YieldManager.js");
-/* harmony import */ var _internal_cross_package__WEBPACK_IMPORTED_MODULE_36__ = __webpack_require__(/*! ./internal/cross-package */ "../bentley/lib/esm/internal/cross-package.js");
+/* harmony import */ var _UtilityFunctions__WEBPACK_IMPORTED_MODULE_34__ = __webpack_require__(/*! ./UtilityFunctions */ "../bentley/lib/esm/UtilityFunctions.js");
+/* harmony import */ var _UtilityTypes__WEBPACK_IMPORTED_MODULE_35__ = __webpack_require__(/*! ./UtilityTypes */ "../bentley/lib/esm/UtilityTypes.js");
+/* harmony import */ var _YieldManager__WEBPACK_IMPORTED_MODULE_36__ = __webpack_require__(/*! ./YieldManager */ "../bentley/lib/esm/YieldManager.js");
+/* harmony import */ var _internal_cross_package__WEBPACK_IMPORTED_MODULE_37__ = __webpack_require__(/*! ./internal/cross-package */ "../bentley/lib/esm/internal/cross-package.js");
 /*---------------------------------------------------------------------------------------------
 * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
 * See LICENSE.md in the project root for license terms and full copyright notice.
@@ -24112,6 +24177,7 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
+
 
 
 // Temporarily (until 5.0) export top-level internal APIs to avoid breaking callers.