igniteui-webcomponents 7.2.4 → 7.3.0-beta.0

package/components/icon/icon.registry.d.ts

@@ -1,200 +1,138 @@
-import type { Theme } from '../../theming/types.js';
-import type { IconCallback, IconMeta, IconReferencePair, SvgIcon } from './registry/types.js';
+import type { Theme } from '#theming/types.js';
+import type { IconCallback, IconMeta, IconReferencePair, RegisterIconOptions, SvgIcon } from './registry/types.js';
 /**
  * Global singleton registry for managing SVG icons and their references.
  *
  * @remarks
- * The IconsRegistry class handles:
- * - Registration and storage of SVG icons in collections
- * - Icon reference/alias management with theme-based resolution
- * - Notification of icon changes to subscribed components
- * - Cross-context synchronization via BroadcastChannel
- * - Batched notifications for performance optimization
+ * The registry stores SVG icons in named collections, resolves aliases against
+ * the active theme, notifies subscribers once per microtask however many icons
+ * changed, and publishes user-set state to other browsing contexts (see
+ * {@link IconsStateBroadcast}).
  *
- * This is a singleton managed via Symbol.for to ensure a single instance
- * across the entire application, even with multiple bundle instances.
- *
- * @internal This class is not directly exposed. Use the exported functions instead.
+ * @internal Not exposed directly - use the exported functions.
  */
 declare class IconsRegistry {
-    /** Set of callbacks subscribed to icon change notifications */
     private readonly _listeners;
-    /** Set of pending icon:collection keys awaiting notification */
-    private readonly _pendingNotifications;
-    /** Map of icon references/aliases by collection and name */
     private readonly _references;
-    /** Map of registered SVG icons by collection and name */
     private readonly _collections;
-    /** Parser for converting SVG text to icon metadata */
     private readonly _svgIconParser;
-    /** Broadcast channel manager for cross-context synchronization */
     private readonly _broadcast;
-    /** Flag indicating if a notification microtask is scheduled */
     private _notificationScheduled;
     /**
-     * Registers an SVG icon in the registry.
-     *
-     * @param name - The unique name for the icon within its collection
-     * @param iconText - The SVG markup as a string
-     * @param collection - The collection to register the icon in (default: 'default')
-     *
-     * @remarks
-     * This method:
-     * 1. Parses the SVG text into icon metadata
-     * 2. Stores the icon in the specified collection
-     * 3. Broadcasts the registration to other contexts
-     * 4. Notifies subscribed components (batched)
+     * Parses and stores an SVG icon, then publishes and notifies.
      *
-     * @throws Will throw if the SVG text is malformed
+     * @param stripMeta - See {@link RegisterIconOptions.stripMeta}.
+     * @throws If the SVG text is malformed.
      */
-    register(name: string, iconText: string, collection?: string): void;
+    register(name: string, iconText: string, collection?: string, stripMeta?: boolean): void;
     /**
-     * Subscribes a callback to icon change notifications.
-     *
-     * @param callback - Function to call when icons are registered or updated
-     *
-     * @remarks
-     * The callback receives the icon name and collection when changes occur.
-     * Notifications are batched using microtasks for performance.
+     * Subscribes a callback to registry changes. It is invoked once per
+     * microtask, however many icons changed, so subscribers re-resolve their
+     * own state.
      */
     subscribe(callback: IconCallback): void;
-    /**
-     * Unsubscribes a callback from icon change notifications.
-     *
-     * @param callback - The previously subscribed callback to remove
-     */
+    /** Unsubscribes a previously subscribed callback. */
     unsubscribe(callback: IconCallback): void;
     /**
-     * Sets an icon reference/alias.
-     *
-     * @param options - Configuration for the icon reference
+     * Aliases an icon name to another icon.
      *
      * @remarks
-     * Icon references allow icons to be aliased with different names.
-     * They can be:
-     * - User-set (external: true) - higher priority, synced across contexts
-     * - System-set (external: false) - used internally, not synced
-     *
-     * When overwrite is true, the reference is stored and subscribers are notified.
-     * When external is true, the reference is broadcast to other contexts.
+     * `overwrite` stores the reference and notifies subscribers; `external`
+     * marks it as user-set, which takes precedence over the built-in theme
+     * aliases and is published to other browsing contexts.
      */
     setIconRef(options: IconReferencePair): void;
     /**
-     * Gets the icon reference, resolving aliases based on the provided theme.
-     *
-     * @param name - The icon name or alias
-     * @param collection - The collection name
-     * @param theme - The theme to use for resolving aliases
-     * @returns The resolved icon metadata (without the internal 'external' flag)
+     * Resolves a name that may be an alias to the icon it points at, for the
+     * given theme. The result never carries the internal `external` flag.
      */
     getIconRef(name: string, collection: string, theme?: Theme): IconMeta;
-    /**
-     * Retrieves an icon from the registry.
-     *
-     * @param name - The icon name
-     * @param collection - The collection name (default: 'default')
-     * @returns The SVG icon metadata, or undefined if not found
-     *
-     * @remarks
-     * Use `getIconRef` first to resolve aliases before calling this method.
-     */
+    /** Retrieves an icon. Resolve aliases with `getIconRef` first. */
     get(name: string, collection?: string): SvgIcon | undefined;
     /**
-     * Schedules a batched notification for icon changes.
-     *
-     * @param name - The icon name that changed
-     * @param collection - The collection name
-     *
-     * @remarks
-     * Notifications are batched in a microtask queue to avoid excessive
-     * listener calls when multiple icons are registered synchronously.
-     * Duplicate icon:collection pairs are automatically deduplicated.
-     *
-     * @internal
-     */
-    private _notifyAll;
-    /**
-     * Flushes pending notifications to all subscribed listeners.
-     *
-     * @remarks
-     * This method is called as a microtask after icons are registered.
-     * It processes all pending icon:collection pairs and notifies listeners.
-     *
-     * @internal
+     * Notifies subscribers, coalescing a burst of changes in the same microtask
+     * into a single notification.
      */
-    private _flushNotifications;
+    private _notify;
 }
 /**
- * Gets the global icon registry singleton instance.
+ * Gets the icon registry, creating it on first use. The well-known symbol on
+ * `globalThis` keeps it a single instance even across multiple bundles.
+ */
+export declare function getIconRegistry(): IconsRegistry;
+/**
+ * Registers an icon by fetching it from a URL.
  *
- * @returns The IconsRegistry singleton
+ * @param name - The unique name for the icon
+ * @param url - The URL to fetch the SVG icon from
+ * @param collection - The collection to register the icon in (default: `'default'`)
  *
- * @remarks
- * This function ensures only one instance of the registry exists globally,
- * even across multiple bundle instances. The registry is stored on globalThis
- * using a well-known Symbol.
+ * @returns A promise that resolves when the icon is registered
  *
- * @example
- * ```typescript
- * const registry = getIconRegistry();
- * registry.subscribe((name, collection) => {
- *   console.log(`Icon ${name} changed in ${collection}`);
- * });
- * ```
+ * @throws If the HTTP request fails or returns a non-OK status
  */
-export declare function getIconRegistry(): IconsRegistry;
+export declare function registerIcon(name: string, url: string, collection?: string): Promise<void>;
 /**
  * Registers an icon by fetching it from a URL.
  *
  * @param name - The unique name for the icon
  * @param url - The URL to fetch the SVG icon from
- * @param collection - The collection to register the icon in (default: 'default')
+ * @param options - Registration options: target collection and/or `stripMeta`
  *
  * @returns A promise that resolves when the icon is registered
  *
  * @throws If the HTTP request fails or returns a non-OK status
  *
  * @remarks
- * This function fetches SVG content from the provided URL and registers it
- * in the icon registry. The icon becomes immediately available to all icon
- * components in the application.
+ * This overload accepts a {@link RegisterIconOptions} object so you can control
+ * the target collection **and** opt into SVG meta stripping in one call:
  *
- * @example
  * ```typescript
- * // Register an icon from a URL
- * await registerIcon('custom-icon', '/assets/icons/custom.svg');
+ * // Strip <title>/<desc> to prevent browser-native tooltips on hover
+ * await registerIcon('home', '/icons/home.svg', { stripMeta: true });
  *
- * // Use in HTML
- * // <igc-icon name="custom-icon"></igc-icon>
+ * // Or with a custom collection:
+ * await registerIcon('home', '/icons/home.svg', {
+ *   collection: 'my-lib',
+ *   stripMeta: true,
+ * });
  * ```
  */
-export declare function registerIcon(name: string, url: string, collection?: string): Promise<void>;
+export declare function registerIcon(name: string, url: string, options?: RegisterIconOptions): Promise<void>;
 /**
  * Registers an icon from SVG text content.
  *
  * @param name - The unique name for the icon
  * @param iconText - The SVG markup as a string
- * @param collection - The collection to register the icon in (default: 'default')
+ * @param collection - The collection to register the icon in (default: `'default'`)
  *
  * @throws If the SVG text is malformed or doesn't contain an SVG element
+ */
+export declare function registerIconFromText(name: string, iconText: string, collection?: string): void;
+/**
+ * Registers an icon from SVG text content.
  *
- * @remarks
- * This is the preferred method for registering icons when you have the SVG
- * content directly (e.g., from a bundled asset or inline string). The icon
- * becomes immediately available to all icon components.
+ * @param name - The unique name for the icon
+ * @param iconText - The SVG markup as a string
+ * @param options - Registration options: target collection and/or `stripMeta`
  *
- * The SVG text is parsed to extract viewBox, title, and other metadata.
+ * @throws If the SVG text is malformed or doesn't contain an SVG element
+ *
+ * @remarks
+ * This overload accepts a {@link RegisterIconOptions} object so you can control
+ * the target collection **and** opt into SVG meta stripping in one call:
  *
- * @example
  * ```typescript
- * const iconSvg = '<svg viewBox="0 0 24 24"><path d="..."/></svg>';
- * registerIconFromText('my-icon', iconSvg, 'custom');
+ * const iconSvg = '<svg viewBox="0 0 24 24"><title>Home</title><path d="..."/></svg>';
+ *
+ * // Strip <title>/<desc> to prevent browser-native tooltips on hover
+ * registerIconFromText('home', iconSvg, { stripMeta: true });
  *
- * // Use in HTML
- * // <igc-icon name="my-icon" collection="custom"></igc-icon>
+ * // Or with a custom collection:
+ * registerIconFromText('home', iconSvg, { collection: 'my-lib', stripMeta: true });
  * ```
  */
-export declare function registerIconFromText(name: string, iconText: string, collection?: string): void;
+export declare function registerIconFromText(name: string, iconText: string, options?: RegisterIconOptions): void;
 /**
  * Sets an icon reference/alias that points to another icon.
  *
@@ -210,7 +148,7 @@ export declare function registerIconFromText(name: string, iconText: string, col
  * - Providing fallbacks for missing icons
  *
  * User-set references are marked as external and have higher priority than
- * theme-based aliases. They are also synchronized across browsing contexts.
+ * theme-based aliases. They are also published to other browsing contexts.
  *
  * @example
  * ```typescript

package/components/icon/icon.registry.js

@@ -1,29 +1,44 @@
 import { ICON_REFERENCES } from './icon-references.js';
 import { IconsStateBroadcast } from './icon-state.broadcast.js';
 import { internalIcons } from './internal-icons-lib.js';
-import { createIconDefaultMap } from './registry/default-map.js';
 import { SvgIconParser } from './registry/parser.js';
 import { ActionType } from './registry/types.js';
+function resolveIconOptions(collectionOrOptions) {
+    if (typeof collectionOrOptions === 'string') {
+        return { collection: collectionOrOptions, stripMeta: false };
+    }
+    return {
+        collection: collectionOrOptions?.collection ?? 'default',
+        stripMeta: collectionOrOptions?.stripMeta ?? false,
+    };
+}
+function collectionOf(collections, name) {
+    let collection = collections.get(name);
+    if (!collection) {
+        collection = new Map();
+        collections.set(name, collection);
+    }
+    return collection;
+}
 class IconsRegistry {
     constructor() {
         this._listeners = new Set();
-        this._pendingNotifications = new Set();
-        this._references = createIconDefaultMap();
-        this._collections = createIconDefaultMap().set('internal', internalIcons);
+        this._references = new Map();
+        this._collections = new Map([
+            ['internal', internalIcons],
+        ]);
         this._svgIconParser = new SvgIconParser();
         this._broadcast = new IconsStateBroadcast(this._collections, this._references);
         this._notificationScheduled = false;
     }
-    register(name, iconText, collection = 'default') {
-        const svgIcon = this._svgIconParser.parse(iconText);
-        this._collections.getOrCreate(collection).set(name, svgIcon);
-        const icons = createIconDefaultMap();
-        icons.getOrCreate(collection).set(name, svgIcon);
+    register(name, iconText, collection = 'default', stripMeta = false) {
+        const svgIcon = this._svgIconParser.parse(iconText, stripMeta);
+        collectionOf(this._collections, collection).set(name, svgIcon);
         this._broadcast.send({
             actionType: ActionType.RegisterIcon,
-            collections: icons.toPlainMap(),
+            collections: new Map([[collection, new Map([[name, svgIcon]])]]),
         });
-        this._notifyAll(name, collection);
+        this._notify();
     }
     subscribe(callback) {
         this._listeners.add(callback);
@@ -33,24 +48,19 @@ class IconsRegistry {
     }
     setIconRef(options) {
         const { alias, target, overwrite } = options;
-        const reference = this._references.getOrCreate(alias.collection);
         if (overwrite) {
-            reference.set(alias.name, {
+            collectionOf(this._references, alias.collection).set(alias.name, {
                 name: target.name,
                 collection: target.collection,
                 external: target.external,
             });
-            this._notifyAll(alias.name, alias.collection);
+            this._notify();
         }
         if (target.external) {
-            const refs = createIconDefaultMap();
-            refs.getOrCreate(alias.collection).set(alias.name, {
-                name: target.name,
-                collection: target.collection,
-            });
+            const ref = { name: target.name, collection: target.collection };
             this._broadcast.send({
                 actionType: ActionType.UpdateIconReference,
-                references: refs.toPlainMap(),
+                references: new Map([[alias.collection, new Map([[alias.name, ref]])]]),
             });
         }
     }
@@ -63,12 +73,10 @@ class IconsRegistry {
             };
         }
         if (collection === 'default' && theme) {
-            const alias = ICON_REFERENCES.find((ref) => ref.alias.name === name && ref.alias.collection === 'default');
-            if (alias) {
-                const target = alias.target.get(theme) ?? alias.target.get('default');
-                if (target) {
-                    return target;
-                }
+            const targets = ICON_REFERENCES.get(name);
+            const target = targets?.get(theme) ?? targets?.get('default');
+            if (target) {
+                return target;
             }
         }
         return { name, collection };
@@ -76,49 +84,39 @@ class IconsRegistry {
     get(name, collection = 'default') {
         return this._collections.get(collection)?.get(name);
     }
-    _notifyAll(name, collection) {
-        const key = `${collection}:${name}`;
-        this._pendingNotifications.add(key);
-        if (!this._notificationScheduled) {
-            this._notificationScheduled = true;
-            queueMicrotask(() => {
-                this._flushNotifications();
-            });
+    _notify() {
+        if (this._notificationScheduled) {
+            return;
         }
-    }
-    _flushNotifications() {
-        const notifications = Array.from(this._pendingNotifications);
-        this._pendingNotifications.clear();
-        this._notificationScheduled = false;
-        for (const key of notifications) {
-            const [collection, ...nameParts] = key.split(':');
-            const name = nameParts.join(':');
+        this._notificationScheduled = true;
+        queueMicrotask(() => {
+            this._notificationScheduled = false;
             for (const listener of this._listeners) {
-                listener(name, collection);
+                listener();
             }
-        }
+        });
     }
 }
 const registry = Symbol.for('igc.icons-registry.instance');
 export function getIconRegistry() {
-    const _global = globalThis;
-    if (!_global[registry]) {
-        _global[registry] = new IconsRegistry();
-    }
-    return _global[registry];
+    const global = globalThis;
+    global[registry] ??= new IconsRegistry();
+    return global[registry];
 }
-export async function registerIcon(name, url, collection = 'default') {
+export async function registerIcon(name, url, collectionOrOptions) {
+    const { collection, stripMeta } = resolveIconOptions(collectionOrOptions);
     const response = await fetch(url);
     if (response.ok) {
         const value = await response.text();
-        getIconRegistry().register(name, value, collection);
+        getIconRegistry().register(name, value, collection, stripMeta);
     }
     else {
         throw new Error(`Icon request failed. Status: ${response.status}.`);
     }
 }
-export function registerIconFromText(name, iconText, collection = 'default') {
-    getIconRegistry().register(name, iconText, collection);
+export function registerIconFromText(name, iconText, collectionOrOptions) {
+    const { collection, stripMeta } = resolveIconOptions(collectionOrOptions);
+    getIconRegistry().register(name, iconText, collection, stripMeta);
 }
 export function setIconRef(name, collection, icon) {
     getIconRegistry().setIconRef({

package/components/icon/icon.registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"icon.registry.js","sourceRoot":"","sources":["../../../src/components/icon/icon.registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAOrD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAkBjD,MAAM,aAAa;IAAnB;QAEmB,eAAU,GAAG,IAAI,GAAG,EAAgB,CAAC;QAGrC,0BAAqB,GAAG,IAAI,GAAG,EAAU,CAAC;QAG1C,gBAAW,GAAG,oBAAoB,EAAoB,CAAC;QAGvD,iBAAY,GAAG,oBAAoB,EAAmB,CAAC,GAAG,CACzE,UAAU,EACV,aAAa,CACd,CAAC;QAGe,mBAAc,GAAG,IAAI,aAAa,EAAE,CAAC;QAGrC,eAAU,GAAG,IAAI,mBAAmB,CACnD,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,WAAW,CACjB,CAAC;QAGM,2BAAsB,GAAG,KAAK,CAAC;IAqMzC,CAAC;IAnLQ,QAAQ,CACb,IAAY,EACZ,QAAgB,EAChB,UAAU,GAAG,SAAS;QAEtB,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAE7D,MAAM,KAAK,GAAG,oBAAoB,EAAmB,CAAC;QACtD,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAEjD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YACnB,UAAU,EAAE,UAAU,CAAC,YAAY;YACnC,WAAW,EAAE,KAAK,CAAC,UAAU,EAAE;SAChC,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACpC,CAAC;IAWM,SAAS,CAAC,QAAsB;QACrC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAOM,WAAW,CAAC,QAAsB;QACvC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAgBM,UAAU,CAAC,OAA0B;QAC1C,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;QAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAEjE,IAAI,SAAS,EAAE,CAAC;YACd,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;gBACxB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC,CAAC;YACH,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,oBAAoB,EAAoB,CAAC;YACtD,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;gBACjD,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CAAC,CAAC;YAEH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBACnB,UAAU,EAAE,UAAU,CAAC,mBAAmB;gBAC1C,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE;aAC9B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAUM,UAAU,CAAC,IAAY,EAAE,UAAkB,EAAE,KAAa;QAE/D,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9D,IAAI,SAAS,EAAE,CAAC;YACd,OAAO;gBACL,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,UAAU,EAAE,SAAS,CAAC,UAAU;aACjC,CAAC;QACJ,CAAC;QAGD,IAAI,UAAU,KAAK,SAAS,IAAI,KAAK,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAChC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CACvE,CAAC;YAEF,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBACtE,IAAI,MAAM,EAAE,CAAC;oBACX,OAAO,MAAM,CAAC;gBAChB,CAAC;YACH,CAAC;QACH,CAAC;QAGD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC9B,CAAC;IAYM,GAAG,CAAC,IAAY,EAAE,UAAU,GAAG,SAAS;QAC7C,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IAeO,UAAU,CAAC,IAAY,EAAE,UAAkB;QACjD,MAAM,GAAG,GAAG,GAAG,UAAU,IAAI,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEpC,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC;YACjC,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC;YACnC,cAAc,CAAC,GAAG,EAAE;gBAClB,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC7B,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAWO,mBAAmB;QACzB,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAC7D,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,CAAC;QACnC,IAAI,CAAC,sBAAsB,GAAG,KAAK,CAAC;QAEpC,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAChC,MAAM,CAAC,UAAU,EAAE,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAClD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAEjC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACvC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAGD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;AAyB3D,MAAM,UAAU,eAAe;IAC7B,MAAM,OAAO,GAAG,UAA6B,CAAC;IAC9C,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,aAAa,EAAE,CAAC;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC3B,CAAC;AA2BD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAY,EACZ,GAAW,EACX,UAAU,GAAG,SAAS;IAEtB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAElC,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;QAChB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpC,eAAe,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IACtD,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AA2BD,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,QAAgB,EAChB,UAAU,GAAG,SAAS;IAEtB,eAAe,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;AACzD,CAAC;AAmCD,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,UAAkB,EAAE,IAAc;IACzE,eAAe,EAAE,CAAC,UAAU,CAAC;QAC3B,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;QAC3B,MAAM,EAAE;YACN,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI;SACf;QACD,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { Theme } from '../../theming/types.js';\nimport { ICON_REFERENCES } from './icon-references.js';\nimport { IconsStateBroadcast } from './icon-state.broadcast.js';\nimport { internalIcons } from './internal-icons-lib.js';\nimport { createIconDefaultMap } from './registry/default-map.js';\nimport { SvgIconParser } from './registry/parser.js';\nimport type {\n  IconCallback,\n  IconMeta,\n  IconReferencePair,\n  SvgIcon,\n} from './registry/types.js';\nimport { ActionType } from './registry/types.js';\n\n/**\n * Global singleton registry for managing SVG icons and their references.\n *\n * @remarks\n * The IconsRegistry class handles:\n * - Registration and storage of SVG icons in collections\n * - Icon reference/alias management with theme-based resolution\n * - Notification of icon changes to subscribed components\n * - Cross-context synchronization via BroadcastChannel\n * - Batched notifications for performance optimization\n *\n * This is a singleton managed via Symbol.for to ensure a single instance\n * across the entire application, even with multiple bundle instances.\n *\n * @internal This class is not directly exposed. Use the exported functions instead.\n */\nclass IconsRegistry {\n  /** Set of callbacks subscribed to icon change notifications */\n  private readonly _listeners = new Set<IconCallback>();\n\n  /** Set of pending icon:collection keys awaiting notification */\n  private readonly _pendingNotifications = new Set<string>();\n\n  /** Map of icon references/aliases by collection and name */\n  private readonly _references = createIconDefaultMap<string, IconMeta>();\n\n  /** Map of registered SVG icons by collection and name */\n  private readonly _collections = createIconDefaultMap<string, SvgIcon>().set(\n    'internal',\n    internalIcons\n  );\n\n  /** Parser for converting SVG text to icon metadata */\n  private readonly _svgIconParser = new SvgIconParser();\n\n  /** Broadcast channel manager for cross-context synchronization */\n  private readonly _broadcast = new IconsStateBroadcast(\n    this._collections,\n    this._references\n  );\n\n  /** Flag indicating if a notification microtask is scheduled */\n  private _notificationScheduled = false;\n\n  /**\n   * Registers an SVG icon in the registry.\n   *\n   * @param name - The unique name for the icon within its collection\n   * @param iconText - The SVG markup as a string\n   * @param collection - The collection to register the icon in (default: 'default')\n   *\n   * @remarks\n   * This method:\n   * 1. Parses the SVG text into icon metadata\n   * 2. Stores the icon in the specified collection\n   * 3. Broadcasts the registration to other contexts\n   * 4. Notifies subscribed components (batched)\n   *\n   * @throws Will throw if the SVG text is malformed\n   */\n  public register(\n    name: string,\n    iconText: string,\n    collection = 'default'\n  ): void {\n    const svgIcon = this._svgIconParser.parse(iconText);\n    this._collections.getOrCreate(collection).set(name, svgIcon);\n\n    const icons = createIconDefaultMap<string, SvgIcon>();\n    icons.getOrCreate(collection).set(name, svgIcon);\n\n    this._broadcast.send({\n      actionType: ActionType.RegisterIcon,\n      collections: icons.toPlainMap(),\n    });\n\n    this._notifyAll(name, collection);\n  }\n\n  /**\n   * Subscribes a callback to icon change notifications.\n   *\n   * @param callback - Function to call when icons are registered or updated\n   *\n   * @remarks\n   * The callback receives the icon name and collection when changes occur.\n   * Notifications are batched using microtasks for performance.\n   */\n  public subscribe(callback: IconCallback): void {\n    this._listeners.add(callback);\n  }\n\n  /**\n   * Unsubscribes a callback from icon change notifications.\n   *\n   * @param callback - The previously subscribed callback to remove\n   */\n  public unsubscribe(callback: IconCallback): void {\n    this._listeners.delete(callback);\n  }\n\n  /**\n   * Sets an icon reference/alias.\n   *\n   * @param options - Configuration for the icon reference\n   *\n   * @remarks\n   * Icon references allow icons to be aliased with different names.\n   * They can be:\n   * - User-set (external: true) - higher priority, synced across contexts\n   * - System-set (external: false) - used internally, not synced\n   *\n   * When overwrite is true, the reference is stored and subscribers are notified.\n   * When external is true, the reference is broadcast to other contexts.\n   */\n  public setIconRef(options: IconReferencePair): void {\n    const { alias, target, overwrite } = options;\n    const reference = this._references.getOrCreate(alias.collection);\n\n    if (overwrite) {\n      reference.set(alias.name, {\n        name: target.name,\n        collection: target.collection,\n        external: target.external,\n      });\n      this._notifyAll(alias.name, alias.collection);\n    }\n    if (target.external) {\n      const refs = createIconDefaultMap<string, IconMeta>();\n      refs.getOrCreate(alias.collection).set(alias.name, {\n        name: target.name,\n        collection: target.collection,\n      });\n\n      this._broadcast.send({\n        actionType: ActionType.UpdateIconReference,\n        references: refs.toPlainMap(),\n      });\n    }\n  }\n\n  /**\n   * Gets the icon reference, resolving aliases based on the provided theme.\n   *\n   * @param name - The icon name or alias\n   * @param collection - The collection name\n   * @param theme - The theme to use for resolving aliases\n   * @returns The resolved icon metadata (without the internal 'external' flag)\n   */\n  public getIconRef(name: string, collection: string, theme?: Theme): IconMeta {\n    // Check for any user-set reference first (external or internal)\n    const storedRef = this._references.get(collection)?.get(name);\n    if (storedRef) {\n      return {\n        name: storedRef.name,\n        collection: storedRef.collection,\n      };\n    }\n\n    // Resolve theme-based alias for default collection\n    if (collection === 'default' && theme) {\n      const alias = ICON_REFERENCES.find(\n        (ref) => ref.alias.name === name && ref.alias.collection === 'default'\n      );\n\n      if (alias) {\n        const target = alias.target.get(theme) ?? alias.target.get('default');\n        if (target) {\n          return target;\n        }\n      }\n    }\n\n    // Return as-is if no reference found\n    return { name, collection };\n  }\n\n  /**\n   * Retrieves an icon from the registry.\n   *\n   * @param name - The icon name\n   * @param collection - The collection name (default: 'default')\n   * @returns The SVG icon metadata, or undefined if not found\n   *\n   * @remarks\n   * Use `getIconRef` first to resolve aliases before calling this method.\n   */\n  public get(name: string, collection = 'default'): SvgIcon | undefined {\n    return this._collections.get(collection)?.get(name);\n  }\n\n  /**\n   * Schedules a batched notification for icon changes.\n   *\n   * @param name - The icon name that changed\n   * @param collection - The collection name\n   *\n   * @remarks\n   * Notifications are batched in a microtask queue to avoid excessive\n   * listener calls when multiple icons are registered synchronously.\n   * Duplicate icon:collection pairs are automatically deduplicated.\n   *\n   * @internal\n   */\n  private _notifyAll(name: string, collection: string): void {\n    const key = `${collection}:${name}`;\n    this._pendingNotifications.add(key);\n\n    if (!this._notificationScheduled) {\n      this._notificationScheduled = true;\n      queueMicrotask(() => {\n        this._flushNotifications();\n      });\n    }\n  }\n\n  /**\n   * Flushes pending notifications to all subscribed listeners.\n   *\n   * @remarks\n   * This method is called as a microtask after icons are registered.\n   * It processes all pending icon:collection pairs and notifies listeners.\n   *\n   * @internal\n   */\n  private _flushNotifications(): void {\n    const notifications = Array.from(this._pendingNotifications);\n    this._pendingNotifications.clear();\n    this._notificationScheduled = false;\n\n    for (const key of notifications) {\n      const [collection, ...nameParts] = key.split(':');\n      const name = nameParts.join(':');\n\n      for (const listener of this._listeners) {\n        listener(name, collection);\n      }\n    }\n  }\n}\n\n/** Global symbol key for the singleton registry instance */\nconst registry = Symbol.for('igc.icons-registry.instance');\n\n/** Type augmentation for globalThis to include the registry */\ntype IgcIconRegistry = typeof globalThis & {\n  [registry]?: IconsRegistry;\n};\n\n/**\n * Gets the global icon registry singleton instance.\n *\n * @returns The IconsRegistry singleton\n *\n * @remarks\n * This function ensures only one instance of the registry exists globally,\n * even across multiple bundle instances. The registry is stored on globalThis\n * using a well-known Symbol.\n *\n * @example\n * ```typescript\n * const registry = getIconRegistry();\n * registry.subscribe((name, collection) => {\n *   console.log(`Icon ${name} changed in ${collection}`);\n * });\n * ```\n */\nexport function getIconRegistry() {\n  const _global = globalThis as IgcIconRegistry;\n  if (!_global[registry]) {\n    _global[registry] = new IconsRegistry();\n  }\n  return _global[registry];\n}\n\n/**\n * Registers an icon by fetching it from a URL.\n *\n * @param name - The unique name for the icon\n * @param url - The URL to fetch the SVG icon from\n * @param collection - The collection to register the icon in (default: 'default')\n *\n * @returns A promise that resolves when the icon is registered\n *\n * @throws If the HTTP request fails or returns a non-OK status\n *\n * @remarks\n * This function fetches SVG content from the provided URL and registers it\n * in the icon registry. The icon becomes immediately available to all icon\n * components in the application.\n *\n * @example\n * ```typescript\n * // Register an icon from a URL\n * await registerIcon('custom-icon', '/assets/icons/custom.svg');\n *\n * // Use in HTML\n * // <igc-icon name=\"custom-icon\"></igc-icon>\n * ```\n */\nexport async function registerIcon(\n  name: string,\n  url: string,\n  collection = 'default'\n) {\n  const response = await fetch(url);\n\n  if (response.ok) {\n    const value = await response.text();\n    getIconRegistry().register(name, value, collection);\n  } else {\n    throw new Error(`Icon request failed. Status: ${response.status}.`);\n  }\n}\n\n/**\n * Registers an icon from SVG text content.\n *\n * @param name - The unique name for the icon\n * @param iconText - The SVG markup as a string\n * @param collection - The collection to register the icon in (default: 'default')\n *\n * @throws If the SVG text is malformed or doesn't contain an SVG element\n *\n * @remarks\n * This is the preferred method for registering icons when you have the SVG\n * content directly (e.g., from a bundled asset or inline string). The icon\n * becomes immediately available to all icon components.\n *\n * The SVG text is parsed to extract viewBox, title, and other metadata.\n *\n * @example\n * ```typescript\n * const iconSvg = '<svg viewBox=\"0 0 24 24\"><path d=\"...\"/></svg>';\n * registerIconFromText('my-icon', iconSvg, 'custom');\n *\n * // Use in HTML\n * // <igc-icon name=\"my-icon\" collection=\"custom\"></igc-icon>\n * ```\n */\nexport function registerIconFromText(\n  name: string,\n  iconText: string,\n  collection = 'default'\n) {\n  getIconRegistry().register(name, iconText, collection);\n}\n\n/**\n * Sets an icon reference/alias that points to another icon.\n *\n * @param name - The alias name\n * @param collection - The collection for the alias\n * @param icon - The target icon metadata (name and collection)\n *\n * @remarks\n * Icon references allow you to create aliases that point to other icons.\n * This is useful for:\n * - Creating semantic names (e.g., 'close' → 'x')\n * - Overriding default icon mappings\n * - Providing fallbacks for missing icons\n *\n * User-set references are marked as external and have higher priority than\n * theme-based aliases. They are also synchronized across browsing contexts.\n *\n * @example\n * ```typescript\n * // Register target icon\n * registerIconFromText('x-mark', '<svg>...</svg>');\n *\n * // Create an alias\n * setIconRef('close', 'default', {\n *   name: 'x-mark',\n *   collection: 'default'\n * });\n *\n * // Both work the same way:\n * // <igc-icon name=\"close\"></igc-icon>\n * // <igc-icon name=\"x-mark\"></igc-icon>\n * ```\n */\nexport function setIconRef(name: string, collection: string, icon: IconMeta) {\n  getIconRegistry().setIconRef({\n    alias: { name, collection },\n    target: {\n      name: icon.name,\n      collection: icon.collection,\n      external: true,\n    },\n    overwrite: true,\n  });\n}\n"]}
+{"version":3,"file":"icon.registry.js","sourceRoot":"","sources":["../../../src/components/icon/icon.registry.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Theme } from '#theming/types.js';\nimport { ICON_REFERENCES } from './icon-references.js';\nimport { IconsStateBroadcast } from './icon-state.broadcast.js';\nimport { internalIcons } from './internal-icons-lib.js';\nimport { SvgIconParser } from './registry/parser.js';\nimport type {\n  IconCallback,\n  IconMeta,\n  IconReferencePair,\n  IconsCollection,\n  RegisterIconOptions,\n  SvgIcon,\n} from './registry/types.js';\nimport { ActionType } from './registry/types.js';\n\n/**\n * Normalizes the third argument of `registerIcon` / `registerIconFromText`,\n * which is either a collection name or a {@link RegisterIconOptions} object.\n */\nfunction resolveIconOptions(\n  collectionOrOptions?: string | RegisterIconOptions\n): Required<RegisterIconOptions> {\n  if (typeof collectionOrOptions === 'string') {\n    return { collection: collectionOrOptions, stripMeta: false };\n  }\n\n  return {\n    collection: collectionOrOptions?.collection ?? 'default',\n    stripMeta: collectionOrOptions?.stripMeta ?? false,\n  };\n}\n\n/** Returns the named collection, creating it when absent. */\nfunction collectionOf<V>(\n  collections: IconsCollection<V>,\n  name: string\n): Map<string, V> {\n  let collection = collections.get(name);\n\n  if (!collection) {\n    collection = new Map();\n    collections.set(name, collection);\n  }\n\n  return collection;\n}\n\n/**\n * Global singleton registry for managing SVG icons and their references.\n *\n * @remarks\n * The registry stores SVG icons in named collections, resolves aliases against\n * the active theme, notifies subscribers once per microtask however many icons\n * changed, and publishes user-set state to other browsing contexts (see\n * {@link IconsStateBroadcast}).\n *\n * @internal Not exposed directly - use the exported functions.\n */\nclass IconsRegistry {\n  private readonly _listeners = new Set<IconCallback>();\n  private readonly _references: IconsCollection<IconMeta> = new Map();\n  private readonly _collections: IconsCollection<SvgIcon> = new Map([\n    ['internal', internalIcons],\n  ]);\n  private readonly _svgIconParser = new SvgIconParser();\n  private readonly _broadcast = new IconsStateBroadcast(\n    this._collections,\n    this._references\n  );\n  private _notificationScheduled = false;\n\n  /**\n   * Parses and stores an SVG icon, then publishes and notifies.\n   *\n   * @param stripMeta - See {@link RegisterIconOptions.stripMeta}.\n   * @throws If the SVG text is malformed.\n   */\n  public register(\n    name: string,\n    iconText: string,\n    collection = 'default',\n    stripMeta = false\n  ): void {\n    const svgIcon = this._svgIconParser.parse(iconText, stripMeta);\n    collectionOf(this._collections, collection).set(name, svgIcon);\n\n    this._broadcast.send({\n      actionType: ActionType.RegisterIcon,\n      collections: new Map([[collection, new Map([[name, svgIcon]])]]),\n    });\n\n    this._notify();\n  }\n\n  /**\n   * Subscribes a callback to registry changes. It is invoked once per\n   * microtask, however many icons changed, so subscribers re-resolve their\n   * own state.\n   */\n  public subscribe(callback: IconCallback): void {\n    this._listeners.add(callback);\n  }\n\n  /** Unsubscribes a previously subscribed callback. */\n  public unsubscribe(callback: IconCallback): void {\n    this._listeners.delete(callback);\n  }\n\n  /**\n   * Aliases an icon name to another icon.\n   *\n   * @remarks\n   * `overwrite` stores the reference and notifies subscribers; `external`\n   * marks it as user-set, which takes precedence over the built-in theme\n   * aliases and is published to other browsing contexts.\n   */\n  public setIconRef(options: IconReferencePair): void {\n    const { alias, target, overwrite } = options;\n\n    if (overwrite) {\n      collectionOf(this._references, alias.collection).set(alias.name, {\n        name: target.name,\n        collection: target.collection,\n        external: target.external,\n      });\n      this._notify();\n    }\n\n    if (target.external) {\n      const ref = { name: target.name, collection: target.collection };\n\n      this._broadcast.send({\n        actionType: ActionType.UpdateIconReference,\n        references: new Map([[alias.collection, new Map([[alias.name, ref]])]]),\n      });\n    }\n  }\n\n  /**\n   * Resolves a name that may be an alias to the icon it points at, for the\n   * given theme. The result never carries the internal `external` flag.\n   */\n  public getIconRef(name: string, collection: string, theme?: Theme): IconMeta {\n    // Check for any user-set reference first (external or internal)\n    const storedRef = this._references.get(collection)?.get(name);\n    if (storedRef) {\n      return {\n        name: storedRef.name,\n        collection: storedRef.collection,\n      };\n    }\n\n    // Resolve theme-based alias for the default collection\n    if (collection === 'default' && theme) {\n      const targets = ICON_REFERENCES.get(name);\n      const target = targets?.get(theme) ?? targets?.get('default');\n\n      if (target) {\n        return target;\n      }\n    }\n\n    return { name, collection };\n  }\n\n  /** Retrieves an icon. Resolve aliases with `getIconRef` first. */\n  public get(name: string, collection = 'default'): SvgIcon | undefined {\n    return this._collections.get(collection)?.get(name);\n  }\n\n  /**\n   * Notifies subscribers, coalescing a burst of changes in the same microtask\n   * into a single notification.\n   */\n  private _notify(): void {\n    if (this._notificationScheduled) {\n      return;\n    }\n\n    this._notificationScheduled = true;\n\n    queueMicrotask(() => {\n      this._notificationScheduled = false;\n\n      for (const listener of this._listeners) {\n        listener();\n      }\n    });\n  }\n}\n\nconst registry = Symbol.for('igc.icons-registry.instance');\n\ntype IgcIconRegistry = typeof globalThis & {\n  [registry]?: IconsRegistry;\n};\n\n/**\n * Gets the icon registry, creating it on first use. The well-known symbol on\n * `globalThis` keeps it a single instance even across multiple bundles.\n */\nexport function getIconRegistry(): IconsRegistry {\n  const global = globalThis as IgcIconRegistry;\n  global[registry] ??= new IconsRegistry();\n  return global[registry];\n}\n\n/**\n * Registers an icon by fetching it from a URL.\n *\n * @param name - The unique name for the icon\n * @param url - The URL to fetch the SVG icon from\n * @param collection - The collection to register the icon in (default: `'default'`)\n *\n * @returns A promise that resolves when the icon is registered\n *\n * @throws If the HTTP request fails or returns a non-OK status\n */\nexport async function registerIcon(\n  name: string,\n  url: string,\n  collection?: string\n): Promise<void>;\n\n/**\n * Registers an icon by fetching it from a URL.\n *\n * @param name - The unique name for the icon\n * @param url - The URL to fetch the SVG icon from\n * @param options - Registration options: target collection and/or `stripMeta`\n *\n * @returns A promise that resolves when the icon is registered\n *\n * @throws If the HTTP request fails or returns a non-OK status\n *\n * @remarks\n * This overload accepts a {@link RegisterIconOptions} object so you can control\n * the target collection **and** opt into SVG meta stripping in one call:\n *\n * ```typescript\n * // Strip <title>/<desc> to prevent browser-native tooltips on hover\n * await registerIcon('home', '/icons/home.svg', { stripMeta: true });\n *\n * // Or with a custom collection:\n * await registerIcon('home', '/icons/home.svg', {\n *   collection: 'my-lib',\n *   stripMeta: true,\n * });\n * ```\n */\nexport async function registerIcon(\n  name: string,\n  url: string,\n  options?: RegisterIconOptions\n): Promise<void>;\n\nexport async function registerIcon(\n  name: string,\n  url: string,\n  collectionOrOptions?: string | RegisterIconOptions\n): Promise<void> {\n  const { collection, stripMeta } = resolveIconOptions(collectionOrOptions);\n  const response = await fetch(url);\n\n  if (response.ok) {\n    const value = await response.text();\n    getIconRegistry().register(name, value, collection, stripMeta);\n  } else {\n    throw new Error(`Icon request failed. Status: ${response.status}.`);\n  }\n}\n\n/**\n * Registers an icon from SVG text content.\n *\n * @param name - The unique name for the icon\n * @param iconText - The SVG markup as a string\n * @param collection - The collection to register the icon in (default: `'default'`)\n *\n * @throws If the SVG text is malformed or doesn't contain an SVG element\n */\nexport function registerIconFromText(\n  name: string,\n  iconText: string,\n  collection?: string\n): void;\n\n/**\n * Registers an icon from SVG text content.\n *\n * @param name - The unique name for the icon\n * @param iconText - The SVG markup as a string\n * @param options - Registration options: target collection and/or `stripMeta`\n *\n * @throws If the SVG text is malformed or doesn't contain an SVG element\n *\n * @remarks\n * This overload accepts a {@link RegisterIconOptions} object so you can control\n * the target collection **and** opt into SVG meta stripping in one call:\n *\n * ```typescript\n * const iconSvg = '<svg viewBox=\"0 0 24 24\"><title>Home</title><path d=\"...\"/></svg>';\n *\n * // Strip <title>/<desc> to prevent browser-native tooltips on hover\n * registerIconFromText('home', iconSvg, { stripMeta: true });\n *\n * // Or with a custom collection:\n * registerIconFromText('home', iconSvg, { collection: 'my-lib', stripMeta: true });\n * ```\n */\nexport function registerIconFromText(\n  name: string,\n  iconText: string,\n  options?: RegisterIconOptions\n): void;\n\nexport function registerIconFromText(\n  name: string,\n  iconText: string,\n  collectionOrOptions?: string | RegisterIconOptions\n): void {\n  const { collection, stripMeta } = resolveIconOptions(collectionOrOptions);\n  getIconRegistry().register(name, iconText, collection, stripMeta);\n}\n\n/**\n * Sets an icon reference/alias that points to another icon.\n *\n * @param name - The alias name\n * @param collection - The collection for the alias\n * @param icon - The target icon metadata (name and collection)\n *\n * @remarks\n * Icon references allow you to create aliases that point to other icons.\n * This is useful for:\n * - Creating semantic names (e.g., 'close' → 'x')\n * - Overriding default icon mappings\n * - Providing fallbacks for missing icons\n *\n * User-set references are marked as external and have higher priority than\n * theme-based aliases. They are also published to other browsing contexts.\n *\n * @example\n * ```typescript\n * // Register target icon\n * registerIconFromText('x-mark', '<svg>...</svg>');\n *\n * // Create an alias\n * setIconRef('close', 'default', {\n *   name: 'x-mark',\n *   collection: 'default'\n * });\n *\n * // Both work the same way:\n * // <igc-icon name=\"close\"></igc-icon>\n * // <igc-icon name=\"x-mark\"></igc-icon>\n * ```\n */\nexport function setIconRef(name: string, collection: string, icon: IconMeta) {\n  getIconRegistry().setIconRef({\n    alias: { name, collection },\n    target: {\n      name: icon.name,\n      collection: icon.collection,\n      external: true,\n    },\n    overwrite: true,\n  });\n}\n"]}

package/components/icon/internal-icons-lib.js

@@ -111,7 +111,7 @@ export const internalIcons = new Map(Object.entries({
         svg: `<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 -960 960 960"><path d="M240-400q-33 0-56.5-23.5T160-480q0-33 23.5-56.5T240-560q33 0 56.5 23.5T320-480q0 33-23.5 56.5T240-400Zm240 0q-33 0-56.5-23.5T400-480q0-33 23.5-56.5T480-560q33 0 56.5 23.5T560-480q0 33-23.5 56.5T480-400Zm240 0q-33 0-56.5-23.5T640-480q0-33 23.5-56.5T720-560q33 0 56.5 23.5T800-480q0 33-23.5 56.5T720-400Z"/></svg>`,
     },
     open_in_new: {
-        svg: `<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24"><path d="M6.75 1.5 5.378 3H3c-.825 0-1.5.675-1.5 1.5v9c0 .825.675 1.5 1.5 1.5h12c.825 0 1.5-.675 1.5-1.5v-9c0-.825-.675-1.5-1.5-1.5h-2.377L11.25 1.5h-4.5ZM9 12.75c-2.07 0-3.75-1.68-3.75-3.75 0-2.07 1.68-3.75 3.75-3.75 2.07 0 3.75 1.68 3.75 3.75 0 2.07-1.68 3.75-3.75 3.75Z"/></svg>`,
+        svg: `<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 18 18"><path d="M6.75 1.5 5.378 3H3c-.825 0-1.5.675-1.5 1.5v9c0 .825.675 1.5 1.5 1.5h12c.825 0 1.5-.675 1.5-1.5v-9c0-.825-.675-1.5-1.5-1.5h-2.377L11.25 1.5h-4.5ZM9 12.75c-2.07 0-3.75-1.68-3.75-3.75 0-2.07 1.68-3.75 3.75-3.75 2.07 0 3.75 1.68 3.75 3.75 0 2.07-1.68 3.75-3.75 3.75Z"/></svg>`,
     },
     star: {
         svg: `<svg xmlns="http://www.w3.org/2000/svg" height="24px" viewBox="0 0 24 24" width="24px"><path d="M0 0h24v24H0z" fill="none"/><path d="M0 0h24v24H0z" fill="none"/><path d="M12 17.27L18.18 21l-1.64-7.03L22 9.24l-7.19-.61L12 2 9.19 8.63 2 9.24l5.46 4.73L5.82 21z"/></svg>`,
@@ -325,7 +325,7 @@ export const internalIcons = new Map(Object.entries({
         svg: `<svg xmlns="http://www.w3.org/2000/svg" width="512" height="512" viewBox="0 0 24 24"><path d="M14.068 3.247a9.05 9.05 0 0 0-8.98 2.925c-1.08 1.263-1.79 2.35-2.054 3.991a1.58 1.58 0 0 0-.034.315v.003A1.519 1.519 0 0 0 4.504 12a1.458 1.458 0 0 0 1.515-1.184l.002-.012.002-.012c.148-1.107.602-1.702 1.312-2.565a5.999 5.999 0 0 1 8.533-.75l-1.314 1.308a1.396 1.396 0 0 0-.314.445.761.761 0 0 0-.015.582.756.756 0 0 0 .418.406c.163.07.347.095.531.095H20.03A.985.985 0 0 0 21 9.348v-4.84c0-.323-.09-.772-.5-.94-.407-.17-.79.084-1.022.315l-1.45 1.444a9.05 9.05 0 0 0-3.96-2.08ZM3.977 13.687H3.97A.984.984 0 0 0 3 14.65v4.84c0 .324.09.773.499.942.408.17.79-.084 1.023-.315l1.45-1.444a9.049 9.049 0 0 0 12.94-.845c1.08-1.263 1.79-2.35 2.054-3.991.022-.104.033-.209.034-.315v-.003A1.518 1.518 0 0 0 19.496 12a1.458 1.458 0 0 0-1.513 1.184l-.002.012-.002.012c-.148 1.108-.602 1.702-1.312 2.565a6 6 0 0 1-8.535.75l1.314-1.308c.133-.132.246-.281.314-.445a.76.76 0 0 0 .015-.582.756.756 0 0 0-.418-.406 1.364 1.364 0 0 0-.531-.095h-4.85Z"/></svg>`,
     },
     indigo_search: {
-        svg: `<svg xmlns="http://www.w3.org/2000/svg" width="512" height="512" viewBox="0 0 24 24"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.393 3a7.393 7.393 0 1 0 4.068 13.567l3.996 3.997a1.49 1.49 0 1 0 2.107-2.107l-3.997-3.996A7.393 7.393 0 0 0 10.393 3ZM6 10.393a4.393 4.393 0 1 1 8.786 0 4.393 4.393 0 0 1-8.786 0Z"></svg>`,
+        svg: `<svg xmlns="http://www.w3.org/2000/svg" width="512" height="512" viewBox="0 0 24 24"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.393 3a7.393 7.393 0 1 0 4.068 13.567l3.996 3.997a1.49 1.49 0 1 0 2.107-2.107l-3.997-3.996A7.393 7.393 0 0 0 10.393 3ZM6 10.393a4.393 4.393 0 1 1 8.786 0 4.393 4.393 0 0 1-8.786 0Z"/></svg>`,
     },
     indigo_send: {
         svg: `<svg xmlns="http://www.w3.org/2000/svg" width="512" height="512" viewBox="0 0 24 24"><path fill-rule="evenodd" clip-rule="evenodd" d="M20.302 10.84S5.5 2.591 4.352 2.13C3.207 1.666 3 2.59 3 2.59v17.791c0 .277.077.549.223.79.146.242.356.444.611.589a1.871 1.871 0 0 0 1.708.064l14.5-8.216c.29-.136.533-.343.702-.6.17-.256.258-.551.256-.851a1.528 1.528 0 0 0-.267-.85 1.672 1.672 0 0 0-.431-.433v-.035ZM6.5 10.021V6.803l9.5 5.385-9.5 5.555v-3.146l3.583-.645.036-.01a1.76 1.76 0 0 0 .913-.572 1.54 1.54 0 0 0 .361-.964 1.535 1.535 0 0 0-.336-.972 1.753 1.753 0 0 0-.898-.593l-.034-.01-3.625-.81Z"/></svg>`,