igniteui-webcomponents 7.3.1 → 7.4.0

package/internals/i18n/i18n-controller.d.ts

@@ -1,67 +1,64 @@
 import { type IResourceChangeEventArgs } from 'igniteui-i18n-core';
 import type { ReactiveController, ReactiveControllerHost } from 'lit';
-import { type I18nResourceMapNames } from './utils.js';
-/**
- * Defines the structure for the host element that will use this controller.
- * The host must be a Lit element (ReactiveControllerHost) and an HTMLElement.
- */
+import { type ResourceMap } from './utils.js';
 interface I18nControllerHost extends ReactiveControllerHost, HTMLElement {
     resourceStrings?: unknown;
     locale?: string;
 }
 type ResourceChangeCallback = (event: CustomEvent<IResourceChangeEventArgs>) => unknown;
-/** Configuration object for the I18nController. */
+/** Configuration object for the `I18nController`. */
 export type I18nControllerConfig<T extends object> = {
-    /** The full default English resource strings object for the component. Should always come from igniteui-i18n-core. */
+    /** Default English resource strings, always from `igniteui-i18n-core`. */
     defaultEN: T;
-    /** @deprecated since 7.2.0. Optional name if component uses mixed resource strings. To be removed with deprecated resources. */
-    resourceMapName?: I18nResourceMapNames;
-    /** An optional callback to execute when the global locale changes. */
+    /**
+     * @deprecated since 7.2.0. The map of the component, if it uses mixed
+     * resource strings. To be removed with the deprecated resources.
+     */
+    resourceMap?: ResourceMap;
+    /** Optional callback for a change of the global locale. */
     onResourceChange?: ResourceChangeCallback;
 };
 /**
- * Manages localization (i18n) for a Lit web component.
- * It handles the current locale, component-specific resource overrides,
- * and updates when the global localization state changes.
+ * Manages the localization (i18n) of a Lit web component, and updates it on
+ * a change of the global localization state.
  */
 declare class I18nController<T extends object> implements ReactiveController {
     private readonly _host;
     private readonly _defaultEN;
-    /** @deprecated since 7.2.0. Resource name to use when converting new to old and vice versa resource objects. */
-    private readonly _resourceMapName?;
+    /**
+     * @deprecated since 7.2.0. The map that converts between the new and the old
+     * resource objects.
+     */
+    private readonly _resourceMap?;
     private readonly _resourceChangeCallback?;
     private _locale?;
-    /** Resolved lazily, and again whenever the locale or the locale data changes. */
+    /** Resolved lazily, and again after a locale or locale data change. */
     private _dateTimeFormats?;
-    /** Cache of default resource strings coming from i18n Manager. */
+    /** Cache of the default resource strings from the i18n manager. */
     private _defaultResourceStrings;
-    /** Collection containing only custom resource strings provided. Allows for partial override of resource strings. */
+    /** Only the custom strings, which override a part of the defaults. */
     private _customResourceStrings?;
-    /** Merged collection of custom resource strings and default resource strings. */
+    /** The custom resource strings merged over the default ones. */
     private _resourceStrings?;
     /**
-     * Sets a custom locale that overrides the global one for this host component instance.
-     * Setting a new locale triggers an update of the resource strings.
+     * Sets a custom locale for this host component instance, which overrides
+     * the global locale.
      */
     set locale(value: string | undefined);
     /**
-     * Gets the resolved locale for the host component.
-     * This is the component's custom locale if set, otherwise it falls back to the
-     * global locale.
+     * Gets the resolved locale of the host component: its custom locale, or
+     * the global one.
      */
     get locale(): string;
-    /**
-     * Sets custom resource string for component with this controller.
-     * Gets the resolved resource string for component.
-     */
+    /** Sets the custom resource strings of the component. */
     set resourceStrings(value: T | undefined);
-    /** Get resolved resource strings for component */
+    /** Gets the resolved resource strings of the component. */
     get resourceStrings(): T;
     /** The locale-default format for displaying a date-time value. */
     get localeDisplayFormat(): string;
     /**
-     * The locale-default format for editing a date-time value - the display
-     * format with leading zeros forced, the shape a mask needs.
+     * The locale-default format for editing a date-time value: the display
+     * format with the leading zeros a mask needs.
      */
     get localeInputFormat(): string;
     constructor(host: I18nControllerHost, config: I18nControllerConfig<T>);
@@ -72,33 +69,34 @@ declare class I18nController<T extends object> implements ReactiveController {
     /** @internal */
     handleEvent(event: CustomEvent<IResourceChangeEventArgs>): void;
     /**
-     * Re-resolves the locale defaults and re-applies the custom overrides on top,
-     * so the merged strings never keep values resolved for a previous locale.
+     * Resolves the locale defaults again, then applies the custom overrides, so
+     * that the merged strings keep no value of an earlier locale.
      */
     private _refreshResourceStrings;
     /**
-     * Gets the current, locale-specific resource strings for the component.
-     * The logic maps component keys (from defaultEN) to core library keys
-     * and retrieves the localized string from the i18n manager.
+     * The resource strings of the component for the current locale.
      *
-     * Result is truncated, containing only relevant locale strings.
+     * @remarks
+     * Maps the `defaultEN` keys to the core library keys, and reads each string
+     * from the i18n manager. Each instance gets the same result, so the result is
+     * cached. See {@link defaultStringsCache}.
      */
     private _getDefaultResourceStrings;
     /**
-     * Deriving a format string from `Intl` is not free and the date editors
-     * consult these on every render, so they are cached against the resolved
-     * locale. A global resource change invalidates the cache, since the shared
-     * date formatter may have received new locale data.
+     * The date-time formats of the resolved locale.
+     *
+     * @remarks
+     * An `Intl` format string is expensive, and the date editors read these on
+     * each render, so they are cached against the locale. A global resource
+     * change clears the cache, because the shared date formatter can then hold
+     * new locale data.
      */
     private _getDateTimeFormats;
     private getMixedResourceStrings;
 }
-/** Returns the date-time format string with the appropriate suffix if it's a predefined style */
+/** Returns the date-time format string with a predefined style suffix. */
 export declare function getDateTimeFormat(format?: string, suffix?: 'Date' | 'Time'): string | undefined;
-/**
- * Formats a date for display using the specified format.
- */
 export declare function formatDisplayDate(value: Date, locale: string, displayFormat?: string): string;
-/** Factory function to create and attach the I18nController to a host. */
+/** Creates an `I18nController`, and adds it to the host. */
 export declare function addI18nController<T extends object>(host: I18nControllerHost, config: I18nControllerConfig<T>): I18nController<T>;
 export type { I18nController };

package/internals/i18n/i18n-controller.js

@@ -1,5 +1,7 @@
 import { getCurrentI18n, getDateFormatter, getI18nManager, } from 'igniteui-i18n-core';
 import { convertToCoreResource, convertToIgcResource, } from './utils.js';
+const defaultStringsCache = new WeakMap();
+const registeredDefaults = new WeakSet();
 class I18nController {
     set locale(value) {
         if (this._locale !== value) {
@@ -14,7 +16,7 @@ class I18nController {
     set resourceStrings(value) {
         if (this._resourceStrings !== value) {
             if (value) {
-                this._customResourceStrings = this._resourceMapName
+                this._customResourceStrings = this._resourceMap
                     ? this.getMixedResourceStrings(value)
                     : value;
                 this._resourceStrings = Object.assign({}, this._defaultResourceStrings, this._customResourceStrings);
@@ -38,10 +40,14 @@ class I18nController {
     constructor(host, config) {
         this._host = host;
         this._defaultEN = config.defaultEN;
-        this._resourceMapName = config.resourceMapName;
+        this._resourceMap = config.resourceMap;
         this._resourceChangeCallback = config.onResourceChange;
+        if (!registeredDefaults.has(this._defaultEN)) {
+            registeredDefaults.add(this._defaultEN);
+            const manager = getI18nManager();
+            manager.registerI18n(this._defaultEN, manager.defaultLocale);
+        }
         this._defaultResourceStrings = this._getDefaultResourceStrings();
-        getI18nManager().registerI18n(this._defaultEN, getI18nManager().defaultLocale);
         this._host.addController(this);
     }
     hostConnected() {
@@ -67,16 +73,26 @@ class I18nController {
     }
     _getDefaultResourceStrings() {
         const coreResourceStrings = getI18nManager().getCurrentResourceStrings(this.locale);
-        const normalizedResourceStrings = {};
-        const defaultComponentKeys = Object.keys(this._defaultEN);
-        for (const key of defaultComponentKeys) {
-            let resolvedValue = this._defaultEN[key];
-            if (key in coreResourceStrings) {
-                resolvedValue = coreResourceStrings[key];
+        let perResources = defaultStringsCache.get(this._defaultEN);
+        if (!perResources) {
+            perResources = new WeakMap();
+            defaultStringsCache.set(this._defaultEN, perResources);
+        }
+        let strings = perResources.get(coreResourceStrings);
+        if (!strings) {
+            const normalizedResourceStrings = {};
+            const defaultComponentKeys = Object.keys(this._defaultEN);
+            for (const key of defaultComponentKeys) {
+                let resolvedValue = this._defaultEN[key];
+                if (key in coreResourceStrings) {
+                    resolvedValue = coreResourceStrings[key];
+                }
+                normalizedResourceStrings[key] = resolvedValue;
             }
-            normalizedResourceStrings[key] = resolvedValue;
+            strings = this.getMixedResourceStrings(normalizedResourceStrings);
+            perResources.set(coreResourceStrings, strings);
         }
-        return this.getMixedResourceStrings(normalizedResourceStrings);
+        return { ...strings };
     }
     _getDateTimeFormats() {
         const locale = this.locale;
@@ -91,8 +107,9 @@ class I18nController {
         return this._dateTimeFormats;
     }
     getMixedResourceStrings(value) {
-        if (this._resourceMapName) {
-            return Object.assign({}, convertToCoreResource(value, this._resourceMapName), convertToIgcResource(value, this._resourceMapName));
+        const map = this._resourceMap;
+        if (map) {
+            return Object.assign({}, convertToCoreResource(value, map), convertToIgcResource(value, map));
         }
         return value;
     }
@@ -105,29 +122,25 @@ export function getDateTimeFormat(format, suffix = 'Date') {
     return format && DATE_TIME_STYLES.has(format) ? `${format}${suffix}` : format;
 }
 export function formatDisplayDate(value, locale, displayFormat) {
+    const formatter = getDateFormatter();
+    let options;
     if (!displayFormat) {
-        return getDateFormatter().formatDateTime(value, locale, {});
+        options = {};
     }
-    if (DATE_TIME_STYLES.has(displayFormat)) {
+    else if (DATE_TIME_STYLES.has(displayFormat)) {
         const style = displayFormat;
-        return getDateFormatter().formatDateTime(value, locale, {
-            dateStyle: style,
-            timeStyle: style,
-        });
-    }
-    if (displayFormat.endsWith('Date')) {
-        return getDateFormatter().formatDateTime(value, locale, {
-            dateStyle: extractStyle(displayFormat, 'date'),
-        });
-    }
-    if (displayFormat.endsWith('Time')) {
-        return getDateFormatter().formatDateTime(value, locale, {
-            timeStyle: extractStyle(displayFormat, 'time'),
-        });
-    }
-    return getDateFormatter().formatDateCustomFormat(value, displayFormat, {
-        locale,
-    });
+        options = { dateStyle: style, timeStyle: style };
+    }
+    else if (displayFormat.endsWith('Date')) {
+        options = { dateStyle: extractStyle(displayFormat, 'date') };
+    }
+    else if (displayFormat.endsWith('Time')) {
+        options = { timeStyle: extractStyle(displayFormat, 'time') };
+    }
+    else {
+        return formatter.formatDateCustomFormat(value, displayFormat, { locale });
+    }
+    return formatter.formatDateTime(value, locale, options);
 }
 export function addI18nController(host, config) {
     return new I18nController(host, config);

package/internals/i18n/i18n-controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"i18n-controller.js","sourceRoot":"","sources":["../../../src/internals/i18n/i18n-controller.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  getCurrentI18n,\n  getDateFormatter,\n  getI18nManager,\n  type IResourceChangeEventArgs,\n  type IResourceStrings,\n} from 'igniteui-i18n-core';\nimport type { ReactiveController, ReactiveControllerHost } from 'lit';\nimport {\n  convertToCoreResource,\n  convertToIgcResource,\n  type I18nResourceMapNames,\n} from './utils.js';\n\n/**\n * Defines the structure for the host element that will use this controller.\n * The host must be a Lit element (ReactiveControllerHost) and an HTMLElement.\n */\ninterface I18nControllerHost extends ReactiveControllerHost, HTMLElement {\n  // Properties the host is expected to have/use, though they are managed by the controller.\n  resourceStrings?: unknown;\n  locale?: string;\n}\n\ntype ResourceChangeCallback = (\n  event: CustomEvent<IResourceChangeEventArgs>\n) => unknown;\n\n/** The date-time formats a locale resolves to, cached against that locale. */\ntype LocaleDateTimeFormats = {\n  locale: string;\n  display: string;\n  input: string;\n};\n\n/** Configuration object for the I18nController. */\nexport type I18nControllerConfig<T extends object> = {\n  /** The full default English resource strings object for the component. Should always come from igniteui-i18n-core. */\n  defaultEN: T;\n  /** @deprecated since 7.2.0. Optional name if component uses mixed resource strings. To be removed with deprecated resources. */\n  resourceMapName?: I18nResourceMapNames;\n  /** An optional callback to execute when the global locale changes. */\n  onResourceChange?: ResourceChangeCallback;\n};\n\n/**\n * Manages localization (i18n) for a Lit web component.\n * It handles the current locale, component-specific resource overrides,\n * and updates when the global localization state changes.\n */\nclass I18nController<T extends object> implements ReactiveController {\n  //#region Internal properties and state\n\n  private readonly _host: I18nControllerHost;\n  private readonly _defaultEN: T;\n  /** @deprecated since 7.2.0. Resource name to use when converting new to old and vice versa resource objects. */\n  private readonly _resourceMapName?: I18nResourceMapNames;\n  private readonly _resourceChangeCallback?: ResourceChangeCallback;\n\n  private _locale?: string;\n  /** Resolved lazily, and again whenever the locale or the locale data changes. */\n  private _dateTimeFormats?: LocaleDateTimeFormats;\n  /** Cache of default resource strings coming from i18n Manager. */\n  private _defaultResourceStrings: T;\n  /** Collection containing only custom resource strings provided. Allows for partial override of resource strings. */\n  private _customResourceStrings?: T;\n  /** Merged collection of custom resource strings and default resource strings. */\n  private _resourceStrings?: T;\n\n  //#endregion\n\n  //#region Public properties\n\n  /**\n   * Sets a custom locale that overrides the global one for this host component instance.\n   * Setting a new locale triggers an update of the resource strings.\n   */\n  public set locale(value: string | undefined) {\n    if (this._locale !== value) {\n      this._locale = value;\n      this._refreshResourceStrings();\n      this._host.requestUpdate();\n    }\n  }\n\n  /**\n   * Gets the resolved locale for the host component.\n   * This is the component's custom locale if set, otherwise it falls back to the\n   * global locale.\n   */\n  public get locale(): string {\n    return this._locale ?? getCurrentI18n();\n  }\n\n  /**\n   * Sets custom resource string for component with this controller.\n   * Gets the resolved resource string for component.\n   */\n  public set resourceStrings(value: T | undefined) {\n    if (this._resourceStrings !== value) {\n      if (value) {\n        this._customResourceStrings = this._resourceMapName\n          ? this.getMixedResourceStrings(value)\n          : value;\n        this._resourceStrings = Object.assign(\n          {},\n          this._defaultResourceStrings,\n          this._customResourceStrings\n        );\n      } else {\n        this._customResourceStrings = value;\n        this._resourceStrings = value;\n      }\n\n      this._host.requestUpdate();\n    }\n  }\n\n  /** Get resolved resource strings for component */\n  public get resourceStrings(): T {\n    return this._resourceStrings ?? this._defaultResourceStrings;\n  }\n\n  /** The locale-default format for displaying a date-time value. */\n  public get localeDisplayFormat(): string {\n    return this._getDateTimeFormats().display;\n  }\n\n  /**\n   * The locale-default format for editing a date-time value - the display\n   * format with leading zeros forced, the shape a mask needs.\n   */\n  public get localeInputFormat(): string {\n    return this._getDateTimeFormats().input;\n  }\n\n  //#endregion\n\n  //#region Life-cycle hooks and event listener\n\n  constructor(host: I18nControllerHost, config: I18nControllerConfig<T>) {\n    this._host = host;\n    this._defaultEN = config.defaultEN;\n    this._resourceMapName = config.resourceMapName;\n    this._resourceChangeCallback = config.onResourceChange;\n\n    this._defaultResourceStrings = this._getDefaultResourceStrings();\n    getI18nManager().registerI18n(\n      this._defaultEN,\n      getI18nManager().defaultLocale\n    );\n\n    this._host.addController(this);\n  }\n\n  /** @internal */\n  public hostConnected(): void {\n    getI18nManager().addEventListener('onResourceChange', this);\n\n    // A global change while detached went unheard, so the resolved state can\n    // be one of a locale that is no longer current.\n    this._dateTimeFormats = undefined;\n    this._refreshResourceStrings();\n    this._host.requestUpdate();\n  }\n\n  /** @internal */\n  public hostDisconnected(): void {\n    getI18nManager().removeEventListener('onResourceChange', this);\n  }\n\n  /** @internal */\n  public handleEvent(event: CustomEvent<IResourceChangeEventArgs>): void {\n    this._dateTimeFormats = undefined;\n    this._refreshResourceStrings();\n    this._resourceChangeCallback?.call(this._host, event);\n    this._host.requestUpdate();\n  }\n\n  //#endregion\n\n  //#region Internal API\n\n  /**\n   * Re-resolves the locale defaults and re-applies the custom overrides on top,\n   * so the merged strings never keep values resolved for a previous locale.\n   */\n  private _refreshResourceStrings(): void {\n    this._defaultResourceStrings = this._getDefaultResourceStrings();\n\n    if (this._customResourceStrings) {\n      this._resourceStrings = Object.assign(\n        {},\n        this._defaultResourceStrings,\n        this._customResourceStrings\n      );\n    }\n  }\n\n  /**\n   * Gets the current, locale-specific resource strings for the component.\n   * The logic maps component keys (from defaultEN) to core library keys\n   * and retrieves the localized string from the i18n manager.\n   *\n   * Result is truncated, containing only relevant locale strings.\n   */\n  private _getDefaultResourceStrings(): T {\n    const coreResourceStrings = getI18nManager().getCurrentResourceStrings(\n      this.locale\n    );\n\n    // Get all related resources to the component, based on the default resources.\n    const normalizedResourceStrings: T = {} as T;\n    const defaultComponentKeys = Object.keys(this._defaultEN) as (keyof T)[];\n    for (const key of defaultComponentKeys) {\n      let resolvedValue: T[keyof T] = this._defaultEN[key];\n      if (key in coreResourceStrings) {\n        // For a mix of old and core resources.\n        // Only for internal default resources. Users shouldn't mix them.\n        resolvedValue = coreResourceStrings[\n          key as keyof IResourceStrings\n        ] as T[keyof T];\n      }\n\n      normalizedResourceStrings[key] = resolvedValue;\n    }\n\n    return this.getMixedResourceStrings(normalizedResourceStrings);\n  }\n\n  /**\n   * Deriving a format string from `Intl` is not free and the date editors\n   * consult these on every render, so they are cached against the resolved\n   * locale. A global resource change invalidates the cache, since the shared\n   * date formatter may have received new locale data.\n   */\n  private _getDateTimeFormats(): LocaleDateTimeFormats {\n    const locale = this.locale;\n\n    if (this._dateTimeFormats?.locale !== locale) {\n      const formatter = getDateFormatter();\n      this._dateTimeFormats = {\n        locale,\n        display: formatter.getLocaleDateTimeFormat(locale),\n        input: formatter.getLocaleDateTimeFormat(locale, true),\n      };\n    }\n\n    return this._dateTimeFormats;\n  }\n\n  private getMixedResourceStrings(value: T): T {\n    if (this._resourceMapName) {\n      return Object.assign(\n        {},\n        convertToCoreResource(value, this._resourceMapName),\n        convertToIgcResource(value, this._resourceMapName)\n      ) as T;\n    }\n    return value;\n  }\n\n  //#endregion\n}\n\n/**\n * Formats a date for display based on the specified format and locale.\n */\ntype DateTimeStyle = 'short' | 'long' | 'medium' | 'full';\n\nconst DATE_TIME_STYLES = new Set<string>(['short', 'long', 'medium', 'full']);\n\nfunction extractStyle(format: string, suffix: string): DateTimeStyle {\n  return format.toLowerCase().split(suffix)[0] as DateTimeStyle;\n}\n\n/** Returns the date-time format string with the appropriate suffix if it's a predefined style */\nexport function getDateTimeFormat(\n  format?: string,\n  suffix: 'Date' | 'Time' = 'Date'\n): string | undefined {\n  return format && DATE_TIME_STYLES.has(format) ? `${format}${suffix}` : format;\n}\n\n/**\n * Formats a date for display using the specified format.\n */\nexport function formatDisplayDate(\n  value: Date,\n  locale: string,\n  displayFormat?: string\n): string {\n  if (!displayFormat) {\n    return getDateFormatter().formatDateTime(value, locale, {});\n  }\n\n  // Full date+time styles (short, long, medium, full)\n  if (DATE_TIME_STYLES.has(displayFormat)) {\n    const style = displayFormat as DateTimeStyle;\n    return getDateFormatter().formatDateTime(value, locale, {\n      dateStyle: style,\n      timeStyle: style,\n    });\n  }\n\n  // Date-only styles (shortDate, longDate, etc.)\n  if (displayFormat.endsWith('Date')) {\n    return getDateFormatter().formatDateTime(value, locale, {\n      dateStyle: extractStyle(displayFormat, 'date'),\n    });\n  }\n\n  // Time-only styles (shortTime, longTime, etc.)\n  if (displayFormat.endsWith('Time')) {\n    return getDateFormatter().formatDateTime(value, locale, {\n      timeStyle: extractStyle(displayFormat, 'time'),\n    });\n  }\n\n  // Custom format string\n  return getDateFormatter().formatDateCustomFormat(value, displayFormat, {\n    locale,\n  });\n}\n\n/** Factory function to create and attach the I18nController to a host. */\nexport function addI18nController<T extends object>(\n  host: I18nControllerHost,\n  config: I18nControllerConfig<T>\n): I18nController<T> {\n  return new I18nController<T>(host, config);\n}\n\nexport type { I18nController };\n"]}
+{"version":3,"file":"i18n-controller.js","sourceRoot":"","sources":["../../../src/internals/i18n/i18n-controller.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  getCurrentI18n,\n  getDateFormatter,\n  getI18nManager,\n  type IResourceChangeEventArgs,\n  type IResourceStrings,\n} from 'igniteui-i18n-core';\nimport type { ReactiveController, ReactiveControllerHost } from 'lit';\nimport {\n  convertToCoreResource,\n  convertToIgcResource,\n  type ResourceMap,\n} from './utils.js';\n\ninterface I18nControllerHost extends ReactiveControllerHost, HTMLElement {\n  // Declared by the host, managed by the controller.\n  resourceStrings?: unknown;\n  locale?: string;\n}\n\ntype ResourceChangeCallback = (\n  event: CustomEvent<IResourceChangeEventArgs>\n) => unknown;\n\n/** The date-time formats a locale resolves to, cached against that locale. */\ntype LocaleDateTimeFormats = {\n  locale: string;\n  display: string;\n  input: string;\n};\n\n/** Configuration object for the `I18nController`. */\nexport type I18nControllerConfig<T extends object> = {\n  /** Default English resource strings, always from `igniteui-i18n-core`. */\n  defaultEN: T;\n  /**\n   * @deprecated since 7.2.0. The map of the component, if it uses mixed\n   * resource strings. To be removed with the deprecated resources.\n   */\n  resourceMap?: ResourceMap;\n  /** Optional callback for a change of the global locale. */\n  onResourceChange?: ResourceChangeCallback;\n};\n\n/**\n * The default strings each component resolves, keyed by `defaultEN` and by\n * the core resource object of the locale.\n *\n * @remarks\n * Every instance resolves the same strings through the same key walk and\n * converters, so they share one result. The manager replaces the core\n * resource object on each store, so its identity expires the entry. An event\n * cannot, because `registerI18n` for a non-current locale fires none.\n */\nconst defaultStringsCache = new WeakMap<object, WeakMap<object, object>>();\n\n/** The `defaultEN` objects already registered with the i18n manager. */\nconst registeredDefaults = new WeakSet<object>();\n\n/**\n * Manages the localization (i18n) of a Lit web component, and updates it on\n * a change of the global localization state.\n */\nclass I18nController<T extends object> implements ReactiveController {\n  //#region Internal properties and state\n\n  private readonly _host: I18nControllerHost;\n  private readonly _defaultEN: T;\n  /**\n   * @deprecated since 7.2.0. The map that converts between the new and the old\n   * resource objects.\n   */\n  private readonly _resourceMap?: ResourceMap;\n  private readonly _resourceChangeCallback?: ResourceChangeCallback;\n\n  private _locale?: string;\n  /** Resolved lazily, and again after a locale or locale data change. */\n  private _dateTimeFormats?: LocaleDateTimeFormats;\n  /** Cache of the default resource strings from the i18n manager. */\n  private _defaultResourceStrings: T;\n  /** Only the custom strings, which override a part of the defaults. */\n  private _customResourceStrings?: T;\n  /** The custom resource strings merged over the default ones. */\n  private _resourceStrings?: T;\n\n  //#endregion\n\n  //#region Public properties\n\n  /**\n   * Sets a custom locale for this host component instance, which overrides\n   * the global locale.\n   */\n  public set locale(value: string | undefined) {\n    if (this._locale !== value) {\n      this._locale = value;\n      this._refreshResourceStrings();\n      this._host.requestUpdate();\n    }\n  }\n\n  /**\n   * Gets the resolved locale of the host component: its custom locale, or\n   * the global one.\n   */\n  public get locale(): string {\n    return this._locale ?? getCurrentI18n();\n  }\n\n  /** Sets the custom resource strings of the component. */\n  public set resourceStrings(value: T | undefined) {\n    if (this._resourceStrings !== value) {\n      if (value) {\n        this._customResourceStrings = this._resourceMap\n          ? this.getMixedResourceStrings(value)\n          : value;\n        this._resourceStrings = Object.assign(\n          {},\n          this._defaultResourceStrings,\n          this._customResourceStrings\n        );\n      } else {\n        this._customResourceStrings = value;\n        this._resourceStrings = value;\n      }\n\n      this._host.requestUpdate();\n    }\n  }\n\n  /** Gets the resolved resource strings of the component. */\n  public get resourceStrings(): T {\n    return this._resourceStrings ?? this._defaultResourceStrings;\n  }\n\n  /** The locale-default format for displaying a date-time value. */\n  public get localeDisplayFormat(): string {\n    return this._getDateTimeFormats().display;\n  }\n\n  /**\n   * The locale-default format for editing a date-time value: the display\n   * format with the leading zeros a mask needs.\n   */\n  public get localeInputFormat(): string {\n    return this._getDateTimeFormats().input;\n  }\n\n  //#endregion\n\n  //#region Life-cycle hooks and event listener\n\n  constructor(host: I18nControllerHost, config: I18nControllerConfig<T>) {\n    this._host = host;\n    this._defaultEN = config.defaultEN;\n    this._resourceMap = config.resourceMap;\n    this._resourceChangeCallback = config.onResourceChange;\n\n    if (!registeredDefaults.has(this._defaultEN)) {\n      registeredDefaults.add(this._defaultEN);\n      const manager = getI18nManager();\n      manager.registerI18n(this._defaultEN, manager.defaultLocale);\n    }\n\n    this._defaultResourceStrings = this._getDefaultResourceStrings();\n\n    this._host.addController(this);\n  }\n\n  /** @internal */\n  public hostConnected(): void {\n    getI18nManager().addEventListener('onResourceChange', this);\n\n    // Global changes are missed while disconnected, so the resolved state\n    // can hold a locale that is no longer current.\n    this._dateTimeFormats = undefined;\n    this._refreshResourceStrings();\n    this._host.requestUpdate();\n  }\n\n  /** @internal */\n  public hostDisconnected(): void {\n    getI18nManager().removeEventListener('onResourceChange', this);\n  }\n\n  /** @internal */\n  public handleEvent(event: CustomEvent<IResourceChangeEventArgs>): void {\n    this._dateTimeFormats = undefined;\n    this._refreshResourceStrings();\n    this._resourceChangeCallback?.call(this._host, event);\n    this._host.requestUpdate();\n  }\n\n  //#endregion\n\n  //#region Internal API\n\n  /**\n   * Resolves the locale defaults again, then applies the custom overrides, so\n   * that the merged strings keep no value of an earlier locale.\n   */\n  private _refreshResourceStrings(): void {\n    this._defaultResourceStrings = this._getDefaultResourceStrings();\n\n    if (this._customResourceStrings) {\n      this._resourceStrings = Object.assign(\n        {},\n        this._defaultResourceStrings,\n        this._customResourceStrings\n      );\n    }\n  }\n\n  /**\n   * The resource strings of the component for the current locale.\n   *\n   * @remarks\n   * Maps the `defaultEN` keys to the core library keys, and reads each string\n   * from the i18n manager. Each instance gets the same result, so the result is\n   * cached. See {@link defaultStringsCache}.\n   */\n  private _getDefaultResourceStrings(): T {\n    const coreResourceStrings = getI18nManager().getCurrentResourceStrings(\n      this.locale\n    );\n\n    let perResources = defaultStringsCache.get(this._defaultEN);\n\n    if (!perResources) {\n      perResources = new WeakMap();\n      defaultStringsCache.set(this._defaultEN, perResources);\n    }\n\n    let strings = perResources.get(coreResourceStrings) as T | undefined;\n\n    if (!strings) {\n      const normalizedResourceStrings: T = {} as T;\n      const defaultComponentKeys = Object.keys(this._defaultEN) as (keyof T)[];\n      for (const key of defaultComponentKeys) {\n        let resolvedValue: T[keyof T] = this._defaultEN[key];\n        if (key in coreResourceStrings) {\n          // Internal defaults only. A user must not mix old and core\n          // resources.\n          resolvedValue = coreResourceStrings[\n            key as keyof IResourceStrings\n          ] as T[keyof T];\n        }\n\n        normalizedResourceStrings[key] = resolvedValue;\n      }\n\n      strings = this.getMixedResourceStrings(normalizedResourceStrings);\n      perResources.set(coreResourceStrings, strings);\n    }\n\n    // A copy per instance, because the cached object is shared.\n    return { ...strings };\n  }\n\n  /**\n   * The date-time formats of the resolved locale.\n   *\n   * @remarks\n   * An `Intl` format string is expensive, and the date editors read these on\n   * each render, so they are cached against the locale. A global resource\n   * change clears the cache, because the shared date formatter can then hold\n   * new locale data.\n   */\n  private _getDateTimeFormats(): LocaleDateTimeFormats {\n    const locale = this.locale;\n\n    if (this._dateTimeFormats?.locale !== locale) {\n      const formatter = getDateFormatter();\n      this._dateTimeFormats = {\n        locale,\n        display: formatter.getLocaleDateTimeFormat(locale),\n        input: formatter.getLocaleDateTimeFormat(locale, true),\n      };\n    }\n\n    return this._dateTimeFormats;\n  }\n\n  private getMixedResourceStrings(value: T): T {\n    const map = this._resourceMap;\n\n    if (map) {\n      return Object.assign(\n        {},\n        convertToCoreResource(value, map),\n        convertToIgcResource(value, map)\n      ) as T;\n    }\n    return value;\n  }\n\n  //#endregion\n}\n\ntype DateTimeStyle = 'short' | 'long' | 'medium' | 'full';\n\nconst DATE_TIME_STYLES = new Set<string>(['short', 'long', 'medium', 'full']);\n\nfunction extractStyle(format: string, suffix: string): DateTimeStyle {\n  return format.toLowerCase().split(suffix)[0] as DateTimeStyle;\n}\n\n/** Returns the date-time format string with a predefined style suffix. */\nexport function getDateTimeFormat(\n  format?: string,\n  suffix: 'Date' | 'Time' = 'Date'\n): string | undefined {\n  return format && DATE_TIME_STYLES.has(format) ? `${format}${suffix}` : format;\n}\n\nexport function formatDisplayDate(\n  value: Date,\n  locale: string,\n  displayFormat?: string\n): string {\n  const formatter = getDateFormatter();\n  let options: Intl.DateTimeFormatOptions;\n\n  if (!displayFormat) {\n    options = {};\n  } else if (DATE_TIME_STYLES.has(displayFormat)) {\n    const style = displayFormat as DateTimeStyle;\n    options = { dateStyle: style, timeStyle: style };\n  } else if (displayFormat.endsWith('Date')) {\n    options = { dateStyle: extractStyle(displayFormat, 'date') };\n  } else if (displayFormat.endsWith('Time')) {\n    options = { timeStyle: extractStyle(displayFormat, 'time') };\n  } else {\n    return formatter.formatDateCustomFormat(value, displayFormat, { locale });\n  }\n\n  return formatter.formatDateTime(value, locale, options);\n}\n\n/** Creates an `I18nController`, and adds it to the host. */\nexport function addI18nController<T extends object>(\n  host: I18nControllerHost,\n  config: I18nControllerConfig<T>\n): I18nController<T> {\n  return new I18nController<T>(host, config);\n}\n\nexport type { I18nController };\n"]}

package/internals/i18n/utils.d.ts

@@ -3,11 +3,16 @@ import type { IgcCalendarResourceStrings } from './EN/calendar.resources.js';
 import type { IgcChatResourceStrings } from './EN/chat.resources.js';
 import type { IgcDatePickerResourceStrings } from './EN/date-picker.resources.js';
 import type { IgcDateRangePickerResourceStrings } from './EN/date-range-picker.resources.js';
-/** Names of components currently handling a mix of old and new resource strings. */
-export type I18nResourceMapNames = 'calendar' | 'date-picker' | 'date-range-picker' | 'chat';
+/**
+ * Maps the resource keys of a component to the keys of the core library. An
+ * `undefined` core key has no counterpart in the core resources.
+ */
+export type ResourceMap = ReadonlyMap<string, string | undefined>;
 export declare const calendarResourcesMap: Map<keyof IgcCalendarResourceStrings, string | undefined>;
 export declare const chatResourcesMap: Map<keyof IgcChatResourceStrings, string>;
 export declare const dateRangePickerResourcesMap: Map<keyof IgcDateRangePickerResourceStrings, string | undefined>;
 export declare const datePickerResourcesMap: Map<keyof IgcDatePickerResourceStrings, string | undefined>;
-export declare function convertToIgcResource<T extends object>(resource: IResourceStrings, resourceMapName: I18nResourceMapNames): T;
-export declare function convertToCoreResource<T extends object>(resource: T, resourceMapName: I18nResourceMapNames): IResourceStrings;
+/** Converts core resource strings to the deprecated shape via `resourceMap`. */
+export declare function convertToIgcResource<T extends object>(resource: IResourceStrings, resourceMap: ResourceMap): T;
+/** Converts the deprecated shape to core resource strings via `resourceMap`. */
+export declare function convertToCoreResource<T extends object>(resource: T, resourceMap: ResourceMap): IResourceStrings;

package/internals/i18n/utils.js

@@ -33,34 +33,15 @@ export const dateRangePickerResourcesMap = new Map([
     ['last30Days', 'date_range_picker_last30Days'],
     ['currentMonth', 'date_range_picker_currentMonth'],
     ['yearToDate', 'date_range_picker_yearToDate'],
-    ...calendarResourcesMap.entries(),
+    ...calendarResourcesMap,
 ]);
 export const datePickerResourcesMap = new Map([
     ['changeDate', 'date_picker_change_date'],
     ['chooseDate', 'date_picker_choose_date'],
-    ...calendarResourcesMap.entries(),
+    ...calendarResourcesMap,
 ]);
-function getResourceMap(name) {
-    switch (name) {
-        case 'calendar':
-            return calendarResourcesMap;
-        case 'chat':
-            return chatResourcesMap;
-        case 'date-picker':
-            return datePickerResourcesMap;
-        case 'date-range-picker':
-            return dateRangePickerResourcesMap;
-        default:
-            break;
-    }
-    return new Map();
-}
-export function convertToIgcResource(resource, resourceMapName) {
+export function convertToIgcResource(resource, resourceMap) {
     const result = {};
-    const resourceMap = getResourceMap(resourceMapName);
-    if (!resourceMap) {
-        return resource;
-    }
     for (const [igcKey, coreKey] of resourceMap) {
         if (igcKey in resource) {
             result[igcKey] = resource[igcKey];
@@ -74,12 +55,8 @@ export function convertToIgcResource(resource, resourceMapName) {
     }
     return result;
 }
-export function convertToCoreResource(resource, resourceMapName) {
+export function convertToCoreResource(resource, resourceMap) {
     const result = {};
-    const resourceMap = getResourceMap(resourceMapName);
-    if (!resourceMap) {
-        return resource;
-    }
     for (const [igcKey, coreKey] of resourceMap) {
         if (coreKey && coreKey in resource) {
             result[coreKey] = resource[coreKey];

package/internals/i18n/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/internals/i18n/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IResourceStrings } from 'igniteui-i18n-core';\nimport { isString } from '../utils/types.js';\nimport type { IgcCalendarResourceStrings } from './EN/calendar.resources.js';\nimport type { IgcChatResourceStrings } from './EN/chat.resources.js';\nimport type { IgcDatePickerResourceStrings } from './EN/date-picker.resources.js';\nimport type { IgcDateRangePickerResourceStrings } from './EN/date-range-picker.resources.js';\n\n/** Names of components currently handling a mix of old and new resource strings. */\nexport type I18nResourceMapNames =\n  | 'calendar'\n  | 'date-picker'\n  | 'date-range-picker'\n  | 'chat';\n\nexport const calendarResourcesMap = new Map<\n  keyof IgcCalendarResourceStrings,\n  string | undefined\n>([\n  ['selectMonth', 'calendar_select_month'],\n  ['selectYear', 'calendar_select_year'],\n  ['selectDate', 'calendar_select_date'],\n  ['selectRange', 'calendar_range_placeholder'],\n  ['selectedDate', undefined], // This one seems not to be in use anyway\n  ['startDate', 'calendar_range_label_start'],\n  ['endDate', 'calendar_range_label_end'],\n  ['previousMonth', 'calendar_previous_month'],\n  ['nextMonth', 'calendar_next_month'],\n  ['previousYear', 'calendar_previous_year'],\n  ['nextYear', 'calendar_next_year'],\n  ['previousYears', 'calendar_previous_years'],\n  ['nextYears', 'calendar_next_years'],\n  ['weekLabel', 'i18n/getWeekLabel'],\n]);\n\nexport const chatResourcesMap = new Map<keyof IgcChatResourceStrings, string>([\n  ['suggestionsHeader', 'chat_suggestions_header'],\n  ['reactionCopy', 'chat_reaction_copy'],\n  ['reactionLike', 'chat_reaction_like'],\n  ['reactionDislike', 'chat_reaction_dislike'],\n  ['reactionRegenerate', 'chat_reaction_regenerate'],\n  ['attachmentLabel', 'chat_attachment_label'],\n  ['attachmentsListLabel', 'chat_attachments_list_label'],\n  ['messageCopied', 'chat_message_copied'],\n]);\n\nexport const dateRangePickerResourcesMap = new Map<\n  keyof IgcDateRangePickerResourceStrings,\n  string | undefined\n>([\n  ['separator', 'date_range_picker_date_separator'],\n  ['done', 'date_range_picker_done_button'],\n  ['cancel', 'date_range_picker_cancel_button'],\n  ['last7Days', 'date_range_picker_last7Days'],\n  ['last30Days', 'date_range_picker_last30Days'],\n  ['currentMonth', 'date_range_picker_currentMonth'],\n  ['yearToDate', 'date_range_picker_yearToDate'],\n  ...(\n    calendarResourcesMap as Map<\n      keyof IgcDateRangePickerResourceStrings,\n      string | undefined\n    >\n  ).entries(),\n]);\n\nexport const datePickerResourcesMap = new Map<\n  keyof IgcDatePickerResourceStrings,\n  string | undefined\n>([\n  ['changeDate', 'date_picker_change_date'],\n  ['chooseDate', 'date_picker_choose_date'],\n  ...(\n    calendarResourcesMap as Map<\n      keyof IgcCalendarResourceStrings,\n      string | undefined\n    >\n  ).entries(),\n]);\n\nfunction getResourceMap(\n  name: I18nResourceMapNames\n): Map<string, string | undefined> | undefined {\n  switch (name) {\n    case 'calendar':\n      return calendarResourcesMap;\n    case 'chat':\n      return chatResourcesMap;\n    case 'date-picker':\n      return datePickerResourcesMap;\n    case 'date-range-picker':\n      return dateRangePickerResourcesMap;\n    default:\n      break;\n  }\n\n  return new Map<string, string | undefined>();\n}\n\nexport function convertToIgcResource<T extends object>(\n  resource: IResourceStrings,\n  resourceMapName: I18nResourceMapNames\n): T {\n  const result = {} as T;\n  const resourceMap = getResourceMap(resourceMapName);\n\n  if (!resourceMap) {\n    return resource as T;\n  }\n\n  for (const [igcKey, coreKey] of resourceMap) {\n    if (igcKey in resource) {\n      result[igcKey as keyof T] = resource[\n        igcKey as keyof IResourceStrings\n      ] as T[keyof T];\n    } else if (coreKey && coreKey in resource) {\n      const value = resource[coreKey as keyof IResourceStrings];\n      if (isString(value)) {\n        result[igcKey as keyof T] = value as T[keyof T];\n      }\n    }\n  }\n\n  return result;\n}\n\nexport function convertToCoreResource<T extends object>(\n  resource: T,\n  resourceMapName: I18nResourceMapNames\n): IResourceStrings {\n  const result: IResourceStrings = {};\n  const resourceMap = getResourceMap(resourceMapName);\n\n  if (!resourceMap) {\n    return resource as IResourceStrings;\n  }\n\n  for (const [igcKey, coreKey] of resourceMap) {\n    if (coreKey && coreKey in resource) {\n      result[coreKey as keyof IResourceStrings] = resource[\n        coreKey as keyof T\n      ] as string;\n    } else if (coreKey) {\n      const value = resource[igcKey as keyof T];\n      if (isString(value)) {\n        result[coreKey as keyof IResourceStrings] = value;\n      }\n    }\n  }\n\n  return result;\n}\n"]}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/internals/i18n/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IResourceStrings } from 'igniteui-i18n-core';\nimport { isString } from '../utils/types.js';\nimport type { IgcCalendarResourceStrings } from './EN/calendar.resources.js';\nimport type { IgcChatResourceStrings } from './EN/chat.resources.js';\nimport type { IgcDatePickerResourceStrings } from './EN/date-picker.resources.js';\nimport type { IgcDateRangePickerResourceStrings } from './EN/date-range-picker.resources.js';\n\n/**\n * Maps the resource keys of a component to the keys of the core library. An\n * `undefined` core key has no counterpart in the core resources.\n */\nexport type ResourceMap = ReadonlyMap<string, string | undefined>;\n\nexport const calendarResourcesMap = new Map<\n  keyof IgcCalendarResourceStrings,\n  string | undefined\n>([\n  ['selectMonth', 'calendar_select_month'],\n  ['selectYear', 'calendar_select_year'],\n  ['selectDate', 'calendar_select_date'],\n  ['selectRange', 'calendar_range_placeholder'],\n  ['selectedDate', undefined], // This key is not in use.\n  ['startDate', 'calendar_range_label_start'],\n  ['endDate', 'calendar_range_label_end'],\n  ['previousMonth', 'calendar_previous_month'],\n  ['nextMonth', 'calendar_next_month'],\n  ['previousYear', 'calendar_previous_year'],\n  ['nextYear', 'calendar_next_year'],\n  ['previousYears', 'calendar_previous_years'],\n  ['nextYears', 'calendar_next_years'],\n  ['weekLabel', 'i18n/getWeekLabel'],\n]);\n\nexport const chatResourcesMap = new Map<keyof IgcChatResourceStrings, string>([\n  ['suggestionsHeader', 'chat_suggestions_header'],\n  ['reactionCopy', 'chat_reaction_copy'],\n  ['reactionLike', 'chat_reaction_like'],\n  ['reactionDislike', 'chat_reaction_dislike'],\n  ['reactionRegenerate', 'chat_reaction_regenerate'],\n  ['attachmentLabel', 'chat_attachment_label'],\n  ['attachmentsListLabel', 'chat_attachments_list_label'],\n  ['messageCopied', 'chat_message_copied'],\n]);\n\nexport const dateRangePickerResourcesMap = new Map<\n  keyof IgcDateRangePickerResourceStrings,\n  string | undefined\n>([\n  ['separator', 'date_range_picker_date_separator'],\n  ['done', 'date_range_picker_done_button'],\n  ['cancel', 'date_range_picker_cancel_button'],\n  ['last7Days', 'date_range_picker_last7Days'],\n  ['last30Days', 'date_range_picker_last30Days'],\n  ['currentMonth', 'date_range_picker_currentMonth'],\n  ['yearToDate', 'date_range_picker_yearToDate'],\n  ...calendarResourcesMap,\n]);\n\nexport const datePickerResourcesMap = new Map<\n  keyof IgcDatePickerResourceStrings,\n  string | undefined\n>([\n  ['changeDate', 'date_picker_change_date'],\n  ['chooseDate', 'date_picker_choose_date'],\n  ...calendarResourcesMap,\n]);\n\n/** Converts core resource strings to the deprecated shape via `resourceMap`. */\nexport function convertToIgcResource<T extends object>(\n  resource: IResourceStrings,\n  resourceMap: ResourceMap\n): T {\n  const result = {} as T;\n\n  for (const [igcKey, coreKey] of resourceMap) {\n    if (igcKey in resource) {\n      result[igcKey as keyof T] = resource[\n        igcKey as keyof IResourceStrings\n      ] as T[keyof T];\n    } else if (coreKey && coreKey in resource) {\n      const value = resource[coreKey as keyof IResourceStrings];\n      if (isString(value)) {\n        result[igcKey as keyof T] = value as T[keyof T];\n      }\n    }\n  }\n\n  return result;\n}\n\n/** Converts the deprecated shape to core resource strings via `resourceMap`. */\nexport function convertToCoreResource<T extends object>(\n  resource: T,\n  resourceMap: ResourceMap\n): IResourceStrings {\n  const result: IResourceStrings = {};\n\n  for (const [igcKey, coreKey] of resourceMap) {\n    if (coreKey && coreKey in resource) {\n      result[coreKey as keyof IResourceStrings] = resource[\n        coreKey as keyof T\n      ] as string;\n    } else if (coreKey) {\n      const value = resource[igcKey as keyof T];\n      if (isString(value)) {\n        result[coreKey as keyof IResourceStrings] = value;\n      }\n    }\n  }\n\n  return result;\n}\n"]}

package/internals/mixins/alert.d.ts

@@ -4,21 +4,21 @@ export declare abstract class IgcBaseAlertLikeComponent extends LitElement {
     protected readonly _player: import("#animations/player.js").AnimationController;
     private readonly _autoHideTimer;
     /**
-     * Whether the component is in shown state.
+     * Sets the open state of the component.
      *
      * @attr open
      * @default false
      */
     open: boolean;
     /**
-     * Determines the duration in milliseconds in which the component will be visible.
+     * Sets the time in milliseconds that the component stays visible.
      *
      * @attr display-time
      * @default 4000
      */
     displayTime: number;
     /**
-     * Determines whether the component should close after the `displayTime` is over.
+     * Keeps the component open after the `displayTime` is over.
      *
      * @attr keep-open
      * @default false
@@ -27,10 +27,6 @@ export declare abstract class IgcBaseAlertLikeComponent extends LitElement {
     /**
      * Sets the position of the component in the viewport.
      *
-     * `bottom` - positions the component at the bottom. This is the default.
-     * `middle` - positions the component at the center.
-     * `top` - positions the component at the top.
-     *
      * @attr position
      * @default 'bottom'
      */
@@ -38,8 +34,9 @@ export declare abstract class IgcBaseAlertLikeComponent extends LitElement {
     /**
      * Sets the positioning strategy of the component.
      *
-     * `viewport` - positions the component relative to the viewport, ignoring any ancestor elements. This is the default behavior.
-     * `container` - positions the component relative to the nearest visible ancestor. In this mode, the component will be constrained within the bounding box of the ancestor and will be positioned according to the `position` attribute.
+     * `viewport` - positions against the viewport, ignoring every ancestor.
+     * `container` - positions inside the bounding box of the closest visible
+     * ancestor, at the place that `position` sets.
      *
      * @attr positioning
      * @default 'viewport'
@@ -52,24 +49,12 @@ export declare abstract class IgcBaseAlertLikeComponent extends LitElement {
     private _setOpenState;
     private _setAutoHideTimer;
     /**
-     * Opens the component.
-     *
-     * Returns a promise that resolves to `true` if the component was successfully opened, or `false`
-     * if it was already open or could not be shown (e.g., in `container` positioning mode with no visible ancestors).
+     * Opens the component. Resolves to `false` when it is already open, or
+     * when `container` positioning finds no visible ancestor.
      */
     show(): Promise<boolean>;
-    /**
-     * Closes the component.
-     *
-     * Returns a promise that resolves to `true` if the component was successfully closed, or `false`
-     * if it was already closed.
-     */
+    /** Closes the component. Resolves to `false` when it is already closed. */
     hide(): Promise<boolean>;
-    /**
-     * Toggles the open state of the component.
-     *
-     * Returns a promise that resolves to `true` if the operation completed successfully, or `false`
-     * if it was already in the desired state.
-     */
+    /** Toggles the component. Resolves to `true` when the state changed. */
     toggle(): Promise<boolean>;
 }

package/internals/mixins/alert.js.map

@@ -1 +1 @@
-{"version":3,"file":"alert.js","sourceRoot":"","sources":["../../../src/internals/mixins/alert.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAuB,MAAM,KAAK,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AAKpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGpE,MAAM,OAAgB,yBAA0B,SAAQ,UAAU;IAyDhE;QACE,KAAK,EAAE,CAAC;QAzDS,YAAO,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAEzC,mBAAc,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAS1D,SAAI,GAAG,KAAK,CAAC;QASb,gBAAW,GAAG,IAAI,CAAC;QASnB,aAAQ,GAAG,KAAK,CAAC;QAajB,aAAQ,GAAqB,QAAQ,CAAC;QAYtC,gBAAW,GAA4B,UAAU,CAAC;QAKvD,oBAAoB,CAAC,IAAI,CAAC;aACvB,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC;aACxB,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC;aACxB,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhC,sBAAsB,CAAC,IAAI,EAAE;YAC3B,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,QAAQ;aACnB;SACF,CAAC,CAAC;IACL,CAAC;IAEe,iBAAiB;QAC/B,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC;IAC1B,CAAC;IAEkB,MAAM,CAAC,KAA2B;QACnD,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtC,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,CAAC;iBAAM,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7C,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;YACrE,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC;QAED,IACE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC;YACjB,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC;YACxB,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,EACrB,CAAC;YACD,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC3B,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAEO,YAAY;QAClB,IAAI,IAAI,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;YACrC,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,eAAe,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,IAAa;QACvC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YAEjB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;gBACzB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;gBAClB,OAAO,KAAK,CAAC;YACf,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;YACzD,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;QAClB,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,iBAAiB;QACvB,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACxD,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAQM,KAAK,CAAC,IAAI;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IAQM,KAAK,CAAC,IAAI;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACvD,CAAC;IAQM,KAAK,CAAC,MAAM;QACjB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC/C,CAAC;CACF;AAnKQ;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;uDACvB;AASb;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC;8DAC5B;AASnB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;2DAC3C;AAajB;IADN,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;2DACiB;AAYtC;IADN,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;8DAC6B","sourcesContent":["import { LitElement, type PropertyValues } from 'lit';\nimport { property } from 'lit/decorators.js';\nimport { addAnimationController } from '#animations/player.js';\nimport { fadeIn, fadeOut } from '#animations/presets/fade/index.js';\nimport type {\n  AbsolutePosition,\n  NotificationPositioning,\n} from '../../components/types.js';\nimport { addCommandController } from '../controllers/command.js';\nimport { addInternalsController } from '../controllers/internals.js';\nimport { createTimer } from '../timing.js';\nimport { getVisibleAncestor, isPopoverOpen } from '../utils/dom.js';\n\n/* omitModule */\nexport abstract class IgcBaseAlertLikeComponent extends LitElement {\n  protected readonly _player = addAnimationController(this);\n\n  private readonly _autoHideTimer = createTimer(() => this.hide());\n\n  /**\n   * Whether the component is in shown state.\n   *\n   * @attr open\n   * @default false\n   */\n  @property({ type: Boolean, reflect: true })\n  public open = false;\n\n  /**\n   * Determines the duration in milliseconds in which the component will be visible.\n   *\n   * @attr display-time\n   * @default 4000\n   */\n  @property({ type: Number, attribute: 'display-time' })\n  public displayTime = 4000;\n\n  /**\n   * Determines whether the component should close after the `displayTime` is over.\n   *\n   * @attr keep-open\n   * @default false\n   */\n  @property({ type: Boolean, reflect: true, attribute: 'keep-open' })\n  public keepOpen = false;\n\n  /**\n   * Sets the position of the component in the viewport.\n   *\n   * `bottom` - positions the component at the bottom. This is the default.\n   * `middle` - positions the component at the center.\n   * `top` - positions the component at the top.\n   *\n   * @attr position\n   * @default 'bottom'\n   */\n  @property({ reflect: true })\n  public position: AbsolutePosition = 'bottom';\n\n  /**\n   * Sets the positioning strategy of the component.\n   *\n   * `viewport` - positions the component relative to the viewport, ignoring any ancestor elements. This is the default behavior.\n   * `container` - positions the component relative to the nearest visible ancestor. In this mode, the component will be constrained within the bounding box of the ancestor and will be positioned according to the `position` attribute.\n   *\n   * @attr positioning\n   * @default 'viewport'\n   */\n  @property({ reflect: true })\n  public positioning: NotificationPositioning = 'viewport';\n\n  constructor() {\n    super();\n\n    addCommandController(this)\n      .set('--show', this.show)\n      .set('--hide', this.hide)\n      .set('--toggle', this.toggle);\n\n    addInternalsController(this, {\n      initialARIA: {\n        role: 'status',\n        ariaLive: 'polite',\n      },\n    });\n  }\n\n  public override connectedCallback(): void {\n    super.connectedCallback();\n    this.popover = 'manual';\n  }\n\n  protected override update(props: PropertyValues<this>): void {\n    if (props.has('open')) {\n      if (this.open && !isPopoverOpen(this)) {\n        this._showPopover();\n      } else if (!this.open && isPopoverOpen(this)) {\n        this.hidePopover();\n      }\n    }\n\n    if (this.open && (props.has('positioning') || props.has('position'))) {\n      this.hidePopover();\n      this._showPopover();\n    }\n\n    if (\n      props.has('open') ||\n      props.has('displayTime') ||\n      props.has('keepOpen')\n    ) {\n      this._setAutoHideTimer();\n    }\n\n    super.update(props);\n  }\n\n  private _showPopover(): boolean {\n    if (this.positioning !== 'container') {\n      this.showPopover();\n      return true;\n    }\n\n    const visibleAncestor = getVisibleAncestor(this);\n    if (!visibleAncestor) {\n      return false;\n    }\n\n    this.showPopover({ source: visibleAncestor });\n    return true;\n  }\n\n  private async _setOpenState(open: boolean): Promise<boolean> {\n    if (open) {\n      this.open = true;\n\n      if (!this._showPopover()) {\n        this.open = false;\n        return false;\n      }\n\n      const state = await this._player.playExclusive(fadeIn());\n      this._setAutoHideTimer();\n      return state;\n    }\n\n    this._autoHideTimer.stop();\n    const state = await this._player.playExclusive(fadeOut());\n    this.hidePopover();\n    this.open = false;\n    return state;\n  }\n\n  private _setAutoHideTimer(): void {\n    this._autoHideTimer.stop();\n    if (this.open && this.displayTime > 0 && !this.keepOpen) {\n      this._autoHideTimer.start(this.displayTime);\n    }\n  }\n\n  /**\n   * Opens the component.\n   *\n   * Returns a promise that resolves to `true` if the component was successfully opened, or `false`\n   * if it was already open or could not be shown (e.g., in `container` positioning mode with no visible ancestors).\n   */\n  public async show(): Promise<boolean> {\n    return this.open ? false : this._setOpenState(true);\n  }\n\n  /**\n   * Closes the component.\n   *\n   * Returns a promise that resolves to `true` if the component was successfully closed, or `false`\n   * if it was already closed.\n   */\n  public async hide(): Promise<boolean> {\n    return this.open ? this._setOpenState(false) : false;\n  }\n\n  /**\n   * Toggles the open state of the component.\n   *\n   * Returns a promise that resolves to `true` if the operation completed successfully, or `false`\n   * if it was already in the desired state.\n   */\n  public async toggle(): Promise<boolean> {\n    return this.open ? this.hide() : this.show();\n  }\n}\n"]}
+{"version":3,"file":"alert.js","sourceRoot":"","sources":["../../../src/internals/mixins/alert.ts"],"names":[],"mappings":"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","sourcesContent":["import { LitElement, type PropertyValues } from 'lit';\nimport { property } from 'lit/decorators.js';\nimport { addAnimationController } from '#animations/player.js';\nimport { fadeIn, fadeOut } from '#animations/presets/fade/index.js';\nimport type {\n  AbsolutePosition,\n  NotificationPositioning,\n} from '../../components/types.js';\nimport { addCommandController } from '../controllers/command.js';\nimport { addInternalsController } from '../controllers/internals.js';\nimport { createTimer } from '../timing.js';\nimport { getVisibleAncestor, isPopoverOpen } from '../utils/dom.js';\n\n/* omitModule */\nexport abstract class IgcBaseAlertLikeComponent extends LitElement {\n  protected readonly _player = addAnimationController(this);\n\n  private readonly _autoHideTimer = createTimer(() => this.hide());\n\n  /**\n   * Sets the open state of the component.\n   *\n   * @attr open\n   * @default false\n   */\n  @property({ type: Boolean, reflect: true })\n  public open = false;\n\n  /**\n   * Sets the time in milliseconds that the component stays visible.\n   *\n   * @attr display-time\n   * @default 4000\n   */\n  @property({ type: Number, attribute: 'display-time' })\n  public displayTime = 4000;\n\n  /**\n   * Keeps the component open after the `displayTime` is over.\n   *\n   * @attr keep-open\n   * @default false\n   */\n  @property({ type: Boolean, reflect: true, attribute: 'keep-open' })\n  public keepOpen = false;\n\n  /**\n   * Sets the position of the component in the viewport.\n   *\n   * @attr position\n   * @default 'bottom'\n   */\n  @property({ reflect: true })\n  public position: AbsolutePosition = 'bottom';\n\n  /**\n   * Sets the positioning strategy of the component.\n   *\n   * `viewport` - positions against the viewport, ignoring every ancestor.\n   * `container` - positions inside the bounding box of the closest visible\n   * ancestor, at the place that `position` sets.\n   *\n   * @attr positioning\n   * @default 'viewport'\n   */\n  @property({ reflect: true })\n  public positioning: NotificationPositioning = 'viewport';\n\n  constructor() {\n    super();\n\n    addCommandController(this)\n      .set('--show', this.show)\n      .set('--hide', this.hide)\n      .set('--toggle', this.toggle);\n\n    addInternalsController(this, {\n      initialARIA: {\n        role: 'status',\n        ariaLive: 'polite',\n      },\n    });\n  }\n\n  public override connectedCallback(): void {\n    super.connectedCallback();\n    this.popover = 'manual';\n  }\n\n  protected override update(props: PropertyValues<this>): void {\n    if (props.has('open')) {\n      if (this.open && !isPopoverOpen(this)) {\n        this._showPopover();\n      } else if (!this.open && isPopoverOpen(this)) {\n        this.hidePopover();\n      }\n    }\n\n    if (this.open && (props.has('positioning') || props.has('position'))) {\n      this.hidePopover();\n      this._showPopover();\n    }\n\n    if (\n      props.has('open') ||\n      props.has('displayTime') ||\n      props.has('keepOpen')\n    ) {\n      this._setAutoHideTimer();\n    }\n\n    super.update(props);\n  }\n\n  private _showPopover(): boolean {\n    if (this.positioning !== 'container') {\n      this.showPopover();\n      return true;\n    }\n\n    const visibleAncestor = getVisibleAncestor(this);\n    if (!visibleAncestor) {\n      return false;\n    }\n\n    this.showPopover({ source: visibleAncestor });\n    return true;\n  }\n\n  private async _setOpenState(open: boolean): Promise<boolean> {\n    if (open) {\n      this.open = true;\n\n      if (!this._showPopover()) {\n        this.open = false;\n        return false;\n      }\n\n      const state = await this._player.playExclusive(fadeIn());\n      this._setAutoHideTimer();\n      return state;\n    }\n\n    this._autoHideTimer.stop();\n    const state = await this._player.playExclusive(fadeOut());\n    this.hidePopover();\n    this.open = false;\n    return state;\n  }\n\n  private _setAutoHideTimer(): void {\n    this._autoHideTimer.stop();\n    if (this.open && this.displayTime > 0 && !this.keepOpen) {\n      this._autoHideTimer.start(this.displayTime);\n    }\n  }\n\n  /**\n   * Opens the component. Resolves to `false` when it is already open, or\n   * when `container` positioning finds no visible ancestor.\n   */\n  public async show(): Promise<boolean> {\n    return this.open ? false : this._setOpenState(true);\n  }\n\n  /** Closes the component. Resolves to `false` when it is already closed. */\n  public async hide(): Promise<boolean> {\n    return this.open ? this._setOpenState(false) : false;\n  }\n\n  /** Toggles the component. Resolves to `true` when the state changed. */\n  public async toggle(): Promise<boolean> {\n    return this.open ? this.hide() : this.show();\n  }\n}\n"]}