@arcgis/components-utils 4.34.0-next.8 → 4.34.0-next.81

package/dist/index.legacy.js

@@ -0,0 +1,89 @@
+import { mappedFind as mappedFind$1 } from "@arcgis/toolkit/dist/array";
+import { classes as classes$1, observeAncestorsMutation as observeAncestorsMutation$1, getClosestElement, unsafeGetCalciteModeName, unsafeGetElementDirection, getElementAttribute as getElementAttribute$1, focusElement as focusElement$1 } from "@arcgis/toolkit/dist/dom";
+import { setFocusOnElement } from "@arcgis/toolkit/dist/dom";
+import { devToolsAwareTimeout as devToolsAwareTimeout$1 } from "@arcgis/toolkit/dist/promise";
+import { Deferred } from "@arcgis/toolkit/dist/promise";
+import { isEsriInternalEnv as isEsriInternalEnv$1, safeCall as safeCall$1, safeAsyncCall as safeAsyncCall$1 } from "@arcgis/toolkit/dist/error";
+import { generateGuid as generateGuid$1, getMinorVersion, getPreamble as getPreamble$1, quoteString as quoteString$1, createFilterExpression as createFilterExpression$1, addLtrMark, kebabToPascal as kebabToPascal$1, camelToKebab as camelToKebab$1, camelToHuman as camelToHuman$1, capitalize as capitalize$1, uncapitalize as uncapitalize$1 } from "@arcgis/toolkit/dist/string";
+import { setValuesInString } from "@arcgis/toolkit/dist/string";
+import { supportedLocales as supportedLocales$1, defaultLocale as defaultLocale$1, fetchT9nStringsBundle as fetchT9nStringsBundle$1, getElementLocale, normalizeLocale as normalizeLocale$1, startLocaleObserver as startLocaleObserver$1 } from "@arcgis/toolkit/dist/intl";
+import { isNotNull as isNotNull$1, isNotUndefined as isNotUndefined$1 } from "@arcgis/toolkit/dist/predicate";
+import { debounce as debounce$1, identity as identity$1 } from "@arcgis/toolkit/dist/function";
+import { hasSameOrigin as hasSameOrigin$1, isURL as isURL$1 } from "@arcgis/toolkit/dist/url";
+const mappedFind = mappedFind$1;
+const classes = classes$1;
+const devToolsAwareTimeout = devToolsAwareTimeout$1;
+const observeAncestorsMutation = observeAncestorsMutation$1;
+const closestElement = getClosestElement;
+const getElementTheme = unsafeGetCalciteModeName;
+const getElementDir = unsafeGetElementDirection;
+const getElementAttribute = getElementAttribute$1;
+const focusElement = focusElement$1;
+const unsafeGetModeName = unsafeGetCalciteModeName;
+const isEsriInternalEnv = isEsriInternalEnv$1;
+const safeCall = safeCall$1;
+const safeAsyncCall = safeAsyncCall$1;
+const generateGuid = generateGuid$1;
+const extractMinorVersion = getMinorVersion;
+const getPreamble = getPreamble$1;
+const quoteString = quoteString$1;
+const createFilterExpression = createFilterExpression$1;
+const addLTRMark = addLtrMark;
+const kebabToPascal = kebabToPascal$1;
+const camelToKebab = camelToKebab$1;
+const camelToHuman = camelToHuman$1;
+const capitalize = capitalize$1;
+const uncapitalize = uncapitalize$1;
+const supportedLocales = supportedLocales$1;
+const defaultLocale = defaultLocale$1;
+const fetchT9nStringsBundle = fetchT9nStringsBundle$1;
+const getElementLocales = getElementLocale;
+const normalizeLocale = normalizeLocale$1;
+const startLocaleObserver = startLocaleObserver$1;
+const isNotNull = isNotNull$1;
+const isNotUndefined = isNotUndefined$1;
+const debounce = debounce$1;
+const identity = identity$1;
+const hasSameOrigin = hasSameOrigin$1;
+const isURL = isURL$1;
+export {
+  Deferred,
+  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,
+  unsafeGetModeName
+};

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@arcgis/components-utils",
-  "version": "4.34.0-next.8",
+  "version": "4.34.0-next.81",
   "description": "Collection of common internal patterns and utilities for ArcGIS Maps SDK for JavaScript components.",
   "homepage": "https://developers.arcgis.com/javascript/latest/",
   "sideEffects": false,
   "type": "module",
   "main": "dist/index.cjs",
-  "module": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "module": "dist/index.legacy.js",
+  "types": "dist/index.d.cts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -20,6 +20,7 @@
   ],
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
+    "@arcgis/toolkit": "4.34.0-next.81",
     "tslib": "^2.8.1"
   }
 }

package/dist/array-utils.d.cts

@@ -1,5 +0,0 @@
-import { Nil } from './types';
-/**
- * Find a value in an array, and return it's mapped variant.
- */
-export declare const mappedFind: <Item, ReturnType>(array: readonly Item[], callback: (item: Item, index: number) => Nil | ReturnType) => ReturnType | undefined;

package/dist/array-utils.d.ts

@@ -1,5 +0,0 @@
-import { Nil } from './types';
-/**
- * Find a value in an array, and return it's mapped variant.
- */
-export declare const mappedFind: <Item, ReturnType>(array: readonly Item[], callback: (item: Item, index: number) => Nil | ReturnType) => ReturnType | undefined;

package/dist/css-utils.d.cts

@@ -1,15 +0,0 @@
-import { Nil } from './types';
-/**
- * This code contains imperative syntax (like for loops and mutation) as it is
- * in the hot path - performance optimizations are critical here.
- * See https://devtopia.esri.com/WebGIS/arcgis-js-api/commit/2565cedd87b
- *
- * Stencil has native support for passing-in class prop as an object or string,
- * but it does not support arrays or booleans, thus this utility is used
- * instead.
- *
- * @remarks
- * This function is not necessary in a Lit package as Lit's `classMap` directive
- * accepts an object
- */
-export declare const classes: (...classes: (Nil | Record<string, boolean> | string[] | string | false)[]) => string;

package/dist/css-utils.d.ts

@@ -1,15 +0,0 @@
-import { Nil } from './types';
-/**
- * This code contains imperative syntax (like for loops and mutation) as it is
- * in the hot path - performance optimizations are critical here.
- * See https://devtopia.esri.com/WebGIS/arcgis-js-api/commit/2565cedd87b
- *
- * Stencil has native support for passing-in class prop as an object or string,
- * but it does not support arrays or booleans, thus this utility is used
- * instead.
- *
- * @remarks
- * This function is not necessary in a Lit package as Lit's `classMap` directive
- * accepts an object
- */
-export declare const classes: (...classes: (Nil | Record<string, boolean> | string[] | string | false)[]) => string;

package/dist/deferred.d.cts

@@ -1,35 +0,0 @@
-/**
- * A deferred promise.
- * Useful for when you want to return a promise but don't have the value yet.
- * Example:
- * ```
- * const deferred = new Deferred<string>();
- * setTimeout(() => deferred.resolve("Hello World"), 1000);
- * return deferred.promise;
- * ```
- * @template T The type of the promise.
- */
-export declare class Deferred<T> {
-    /**
-     * The promise that can be awaited.
-     */
-    promise: Promise<T>;
-    /**
-     * Creates a new deferred promise.
-     */
-    constructor();
-}
-export interface Deferred<T> {
-    /**
-     * Resolves the promise.
-     * @param value The value to resolve the promise with.
-     *
-     * @privateRemarks
-     * Defined as a method to disable covariance checks. Overridden in constructor.
-     */
-    resolve(_value: PromiseLike<T> | T): void;
-    /**
-     * Rejects the promise.
-     */
-    reject(_error: unknown): void;
-}

package/dist/deferred.d.ts

@@ -1,35 +0,0 @@
-/**
- * A deferred promise.
- * Useful for when you want to return a promise but don't have the value yet.
- * Example:
- * ```
- * const deferred = new Deferred<string>();
- * setTimeout(() => deferred.resolve("Hello World"), 1000);
- * return deferred.promise;
- * ```
- * @template T The type of the promise.
- */
-export declare class Deferred<T> {
-    /**
-     * The promise that can be awaited.
-     */
-    promise: Promise<T>;
-    /**
-     * Creates a new deferred promise.
-     */
-    constructor();
-}
-export interface Deferred<T> {
-    /**
-     * Resolves the promise.
-     * @param value The value to resolve the promise with.
-     *
-     * @privateRemarks
-     * Defined as a method to disable covariance checks. Overridden in constructor.
-     */
-    resolve(_value: PromiseLike<T> | T): void;
-    /**
-     * Rejects the promise.
-     */
-    reject(_error: unknown): void;
-}

package/dist/dom.d.cts

@@ -1,65 +0,0 @@
-/**
- * Observe the element and its ancestors for attribute mutations.
- * If the attributes have been changed in the ancestor tree then the callback will be invoked.
- * Example: `observeAncestorsMutation(element, ["dir", "lang"], () => console.log("dir or lang changed"));`
- * @param element The element on which to observe the attribute mutations.
- * @param attributeFilter The list of attributes to observe.
- * @param callback The callback to invoke when the attributes have been changed.
- * @returns The mutation observer
- */
-export declare const 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.
- * Shadow DOM boundaries are also taken into account.
- * @param base The element to start the search from.
- * @param selector The selector to match.
- * @returns The closest element that matches the selector or null if not found.
- */
-export declare const closestElement: (base: Element, selector: string) => Element | null;
-/**
- * Use the Calcite mode to determine the theme of the element.
- * It will traverse the element's ancestors to find the theme.
- * Shadow DOM boundaries are also taken into account.
- * @param base The element to start the search from.
- * @returns The theme of the element, either "light" or "dark", "light" is the default.
- */
-export declare const getElementTheme: (base: Element) => "dark" | "light";
-/**
- * Get direction property of closest element.
- * @param el The element to start the search from.
- * @returns The direction of the element, either "ltr" | "rtl", "ltr" is the default.
- */
-export declare const getElementDir: (el: HTMLElement) => "ltr" | "rtl";
-/**
- * Get the attribute value from the element.
- * It will traverse the element's ancestors to find the attribute.
- * Shadow DOM boundaries are also taken into account.
- * If the attribute is not found then the fallback value is returned.
- * Example: `getElementAttribute(element, "dir", "ltr");`
- * @param base The element to start the search from.
- * @param prop The attribute name.
- * @param fallbackValue The fallback value if the attribute is not found.
- * @returns The attribute value or the fallback value if the attribute is not found.
- */
-export declare const getElementAttribute: (el: Element, prop: string, fallbackValue: string) => string;
-export interface FocusableElement extends HTMLElement {
-    setFocus?: () => Promise<void>;
-}
-export declare const 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.
- * Shadow DOM boundaries are also taken into account.
- * If the element is not found then the focus is not set.
- * Example: `setFocusOnElement(element, "[role='menuitem']");`
- * @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
- */
-export declare const setFocusOnElement: (ref: (Element & {
-    componentOnReady?: () => Promise<void>;
-}) | null | undefined, selector: string) => void;

package/dist/dom.d.ts

@@ -1,65 +0,0 @@
-/**
- * Observe the element and its ancestors for attribute mutations.
- * If the attributes have been changed in the ancestor tree then the callback will be invoked.
- * Example: `observeAncestorsMutation(element, ["dir", "lang"], () => console.log("dir or lang changed"));`
- * @param element The element on which to observe the attribute mutations.
- * @param attributeFilter The list of attributes to observe.
- * @param callback The callback to invoke when the attributes have been changed.
- * @returns The mutation observer
- */
-export declare const 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.
- * Shadow DOM boundaries are also taken into account.
- * @param base The element to start the search from.
- * @param selector The selector to match.
- * @returns The closest element that matches the selector or null if not found.
- */
-export declare const closestElement: (base: Element, selector: string) => Element | null;
-/**
- * Use the Calcite mode to determine the theme of the element.
- * It will traverse the element's ancestors to find the theme.
- * Shadow DOM boundaries are also taken into account.
- * @param base The element to start the search from.
- * @returns The theme of the element, either "light" or "dark", "light" is the default.
- */
-export declare const getElementTheme: (base: Element) => "dark" | "light";
-/**
- * Get direction property of closest element.
- * @param el The element to start the search from.
- * @returns The direction of the element, either "ltr" | "rtl", "ltr" is the default.
- */
-export declare const getElementDir: (el: HTMLElement) => "ltr" | "rtl";
-/**
- * Get the attribute value from the element.
- * It will traverse the element's ancestors to find the attribute.
- * Shadow DOM boundaries are also taken into account.
- * If the attribute is not found then the fallback value is returned.
- * Example: `getElementAttribute(element, "dir", "ltr");`
- * @param base The element to start the search from.
- * @param prop The attribute name.
- * @param fallbackValue The fallback value if the attribute is not found.
- * @returns The attribute value or the fallback value if the attribute is not found.
- */
-export declare const getElementAttribute: (el: Element, prop: string, fallbackValue: string) => string;
-export interface FocusableElement extends HTMLElement {
-    setFocus?: () => Promise<void>;
-}
-export declare const 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.
- * Shadow DOM boundaries are also taken into account.
- * If the element is not found then the focus is not set.
- * Example: `setFocusOnElement(element, "[role='menuitem']");`
- * @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
- */
-export declare const setFocusOnElement: (ref: (Element & {
-    componentOnReady?: () => Promise<void>;
-}) | null | undefined, selector: string) => void;

package/dist/errors.d.cts

@@ -1,30 +0,0 @@
-/**
- * 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:
- *
- * - `process.env.NODE_ENV !== "production"`
- * - `process.env.NODE_ENV === "development"`
- * - `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
- */
-export declare const isEsriInternalEnv: () => boolean;
-/**
- * Calls a sync method and catch any errors. Returns undefined if error occurred.
- *
- * Can also provide a thisContext and rest arguments
- */
-export declare const safeCall: <Callback extends (...args: never[]) => unknown>(callback?: Callback, thisContext?: ThisParameterType<Callback>, ...rest: Parameters<Callback>) => ReturnType<Callback> | void;
-/**
- * Calls an async method and catch any errors. Returns undefined if error occurred.
- *
- * Can also provide a thisContext and rest arguments
- */
-export declare const safeAsyncCall: <Callback extends (...args: never[]) => unknown>(callback?: Callback, thisContext?: ThisParameterType<Callback>, ...rest: Parameters<Callback>) => Promise<Awaited<ReturnType<Callback>> | void>;

package/dist/errors.d.ts

@@ -1,30 +0,0 @@
-/**
- * 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:
- *
- * - `process.env.NODE_ENV !== "production"`
- * - `process.env.NODE_ENV === "development"`
- * - `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
- */
-export declare const isEsriInternalEnv: () => boolean;
-/**
- * Calls a sync method and catch any errors. Returns undefined if error occurred.
- *
- * Can also provide a thisContext and rest arguments
- */
-export declare const safeCall: <Callback extends (...args: never[]) => unknown>(callback?: Callback, thisContext?: ThisParameterType<Callback>, ...rest: Parameters<Callback>) => ReturnType<Callback> | void;
-/**
- * Calls an async method and catch any errors. Returns undefined if error occurred.
- *
- * Can also provide a thisContext and rest arguments
- */
-export declare const safeAsyncCall: <Callback extends (...args: never[]) => unknown>(callback?: Callback, thisContext?: ThisParameterType<Callback>, ...rest: Parameters<Callback>) => Promise<Awaited<ReturnType<Callback>> | void>;

package/dist/guid.d.cts

@@ -1,5 +0,0 @@
-/**
- * Generates a GUID string.
- * @returns A GUID string with the pattern 00000000-0000-0000-0000-000000000000.
- */
-export declare const generateGuid: () => string;

package/dist/guid.d.ts

@@ -1,5 +0,0 @@
-/**
- * Generates a GUID string.
- * @returns A GUID string with the pattern 00000000-0000-0000-0000-000000000000.
- */
-export declare const generateGuid: () => string;

package/dist/intl.d.cts

@@ -1,91 +0,0 @@
-/**
- * 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

@@ -1,91 +0,0 @@
-/**
- * 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

@@ -1,17 +0,0 @@
-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;

package/dist/preamble.d.ts

@@ -1,17 +0,0 @@
-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;