@angular/material 21.0.0-next.9 → 21.0.0-rc.0

package/fesm2022/_icon-registry-chunk.mjs

@@ -5,606 +5,381 @@ import * as i2 from '@angular/platform-browser';
 import { of, throwError, forkJoin } from 'rxjs';
 import { tap, map, catchError, finalize, share } from 'rxjs/operators';
 
-/**
- * The Trusted Types policy, or null if Trusted Types are not
- * enabled/supported, or undefined if the policy has not been created yet.
- */
 let policy;
-/**
- * Returns the Trusted Types policy, or null if Trusted Types are not
- * enabled/supported. The first call to this function will create the policy.
- */
 function getPolicy() {
-    if (policy === undefined) {
-        policy = null;
-        if (typeof window !== 'undefined') {
-            const ttWindow = window;
-            if (ttWindow.trustedTypes !== undefined) {
-                policy = ttWindow.trustedTypes.createPolicy('angular#components', {
-                    createHTML: (s) => s,
-                });
-            }
-        }
+  if (policy === undefined) {
+    policy = null;
+    if (typeof window !== 'undefined') {
+      const ttWindow = window;
+      if (ttWindow.trustedTypes !== undefined) {
+        policy = ttWindow.trustedTypes.createPolicy('angular#components', {
+          createHTML: s => s
+        });
+      }
     }
-    return policy;
+  }
+  return policy;
 }
-/**
- * Unsafely promote a string to a TrustedHTML, falling back to strings when
- * Trusted Types are not available.
- * @security This is a security-sensitive function; any use of this function
- * must go through security review. In particular, it must be assured that the
- * provided string will never cause an XSS vulnerability if used in a context
- * that will be interpreted as HTML by a browser, e.g. when assigning to
- * element.innerHTML.
- */
 function trustedHTMLFromString(html) {
-    return getPolicy()?.createHTML(html) || html;
+  return getPolicy()?.createHTML(html) || html;
 }
 
-/**
- * Returns an exception to be thrown in the case when attempting to
- * load an icon with a name that cannot be found.
- * @docs-private
- */
 function getMatIconNameNotFoundError(iconName) {
-    return Error(`Unable to find icon with the name "${iconName}"`);
+  return Error(`Unable to find icon with the name "${iconName}"`);
 }
-/**
- * Returns an exception to be thrown when the consumer attempts to use
- * `<mat-icon>` without including @angular/common/http.
- * @docs-private
- */
 function getMatIconNoHttpProviderError() {
-    return Error('Could not find HttpClient for use with Angular Material icons. ' +
-        'Please add provideHttpClient() to your providers.');
+  return Error('Could not find HttpClient for use with Angular Material icons. ' + 'Please add provideHttpClient() to your providers.');
 }
-/**
- * Returns an exception to be thrown when a URL couldn't be sanitized.
- * @param url URL that was attempted to be sanitized.
- * @docs-private
- */
 function getMatIconFailedToSanitizeUrlError(url) {
-    return Error(`The URL provided to MatIconRegistry was not trusted as a resource URL ` +
-        `via Angular's DomSanitizer. Attempted URL was "${url}".`);
+  return Error(`The URL provided to MatIconRegistry was not trusted as a resource URL ` + `via Angular's DomSanitizer. Attempted URL was "${url}".`);
 }
-/**
- * Returns an exception to be thrown when a HTML string couldn't be sanitized.
- * @param literal HTML that was attempted to be sanitized.
- * @docs-private
- */
 function getMatIconFailedToSanitizeLiteralError(literal) {
-    return Error(`The literal provided to MatIconRegistry was not trusted as safe HTML by ` +
-        `Angular's DomSanitizer. Attempted literal was "${literal}".`);
+  return Error(`The literal provided to MatIconRegistry was not trusted as safe HTML by ` + `Angular's DomSanitizer. Attempted literal was "${literal}".`);
 }
-/**
- * Configuration for an icon, including the URL and possibly the cached SVG element.
- * @docs-private
- */
 class SvgIconConfig {
-    url;
-    svgText;
-    options;
-    svgElement;
-    constructor(url, svgText, options) {
-        this.url = url;
-        this.svgText = svgText;
-        this.options = options;
-    }
+  url;
+  svgText;
+  options;
+  svgElement;
+  constructor(url, svgText, options) {
+    this.url = url;
+    this.svgText = svgText;
+    this.options = options;
+  }
 }
-/**
- * Service to register and display icons used by the `<mat-icon>` component.
- * - Registers icon URLs by namespace and name.
- * - Registers icon set URLs by namespace.
- * - Registers aliases for CSS classes, for use with icon fonts.
- * - Loads icons from URLs and extracts individual icons from icon sets.
- */
 class MatIconRegistry {
-    _httpClient;
-    _sanitizer;
-    _errorHandler;
-    _document;
-    /**
-     * URLs and cached SVG elements for individual icons. Keys are of the format "[namespace]:[icon]".
-     */
-    _svgIconConfigs = new Map();
-    /**
-     * SvgIconConfig objects and cached SVG elements for icon sets, keyed by namespace.
-     * Multiple icon sets can be registered under the same namespace.
-     */
-    _iconSetConfigs = new Map();
-    /** Cache for icons loaded by direct URLs. */
-    _cachedIconsByUrl = new Map();
-    /** In-progress icon fetches. Used to coalesce multiple requests to the same URL. */
-    _inProgressUrlFetches = new Map();
-    /** Map from font identifiers to their CSS class names. Used for icon fonts. */
-    _fontCssClassesByAlias = new Map();
-    /** Registered icon resolver functions. */
-    _resolvers = [];
-    /**
-     * The CSS classes to apply when an `<mat-icon>` component has no icon name, url, or font
-     * specified. The default 'material-icons' value assumes that the material icon font has been
-     * loaded as described at https://google.github.io/material-design-icons/#icon-font-for-the-web
-     */
-    _defaultFontSetClass = ['material-icons', 'mat-ligature-font'];
-    constructor(_httpClient, _sanitizer, document, _errorHandler) {
-        this._httpClient = _httpClient;
-        this._sanitizer = _sanitizer;
-        this._errorHandler = _errorHandler;
-        this._document = document;
-    }
-    /**
-     * Registers an icon by URL in the default namespace.
-     * @param iconName Name under which the icon should be registered.
-     * @param url
-     */
-    addSvgIcon(iconName, url, options) {
-        return this.addSvgIconInNamespace('', iconName, url, options);
-    }
-    /**
-     * Registers an icon using an HTML string in the default namespace.
-     * @param iconName Name under which the icon should be registered.
-     * @param literal SVG source of the icon.
-     */
-    addSvgIconLiteral(iconName, literal, options) {
-        return this.addSvgIconLiteralInNamespace('', iconName, literal, options);
-    }
-    /**
-     * Registers an icon by URL in the specified namespace.
-     * @param namespace Namespace in which the icon should be registered.
-     * @param iconName Name under which the icon should be registered.
-     * @param url
-     */
-    addSvgIconInNamespace(namespace, iconName, url, options) {
-        return this._addSvgIconConfig(namespace, iconName, new SvgIconConfig(url, null, options));
-    }
-    /**
-     * Registers an icon resolver function with the registry. The function will be invoked with the
-     * name and namespace of an icon when the registry tries to resolve the URL from which to fetch
-     * the icon. The resolver is expected to return a `SafeResourceUrl` that points to the icon,
-     * an object with the icon URL and icon options, or `null` if the icon is not supported. Resolvers
-     * will be invoked in the order in which they have been registered.
-     * @param resolver Resolver function to be registered.
-     */
-    addSvgIconResolver(resolver) {
-        this._resolvers.push(resolver);
-        return this;
-    }
-    /**
-     * Registers an icon using an HTML string in the specified namespace.
-     * @param namespace Namespace in which the icon should be registered.
-     * @param iconName Name under which the icon should be registered.
-     * @param literal SVG source of the icon.
-     */
-    addSvgIconLiteralInNamespace(namespace, iconName, literal, options) {
-        const cleanLiteral = this._sanitizer.sanitize(SecurityContext.HTML, literal);
-        // TODO: add an ngDevMode check
-        if (!cleanLiteral) {
-            throw getMatIconFailedToSanitizeLiteralError(literal);
+  _httpClient;
+  _sanitizer;
+  _errorHandler;
+  _document;
+  _svgIconConfigs = new Map();
+  _iconSetConfigs = new Map();
+  _cachedIconsByUrl = new Map();
+  _inProgressUrlFetches = new Map();
+  _fontCssClassesByAlias = new Map();
+  _resolvers = [];
+  _defaultFontSetClass = ['material-icons', 'mat-ligature-font'];
+  constructor(_httpClient, _sanitizer, document, _errorHandler) {
+    this._httpClient = _httpClient;
+    this._sanitizer = _sanitizer;
+    this._errorHandler = _errorHandler;
+    this._document = document;
+  }
+  addSvgIcon(iconName, url, options) {
+    return this.addSvgIconInNamespace('', iconName, url, options);
+  }
+  addSvgIconLiteral(iconName, literal, options) {
+    return this.addSvgIconLiteralInNamespace('', iconName, literal, options);
+  }
+  addSvgIconInNamespace(namespace, iconName, url, options) {
+    return this._addSvgIconConfig(namespace, iconName, new SvgIconConfig(url, null, options));
+  }
+  addSvgIconResolver(resolver) {
+    this._resolvers.push(resolver);
+    return this;
+  }
+  addSvgIconLiteralInNamespace(namespace, iconName, literal, options) {
+    const cleanLiteral = this._sanitizer.sanitize(SecurityContext.HTML, literal);
+    if (!cleanLiteral) {
+      throw getMatIconFailedToSanitizeLiteralError(literal);
+    }
+    const trustedLiteral = trustedHTMLFromString(cleanLiteral);
+    return this._addSvgIconConfig(namespace, iconName, new SvgIconConfig('', trustedLiteral, options));
+  }
+  addSvgIconSet(url, options) {
+    return this.addSvgIconSetInNamespace('', url, options);
+  }
+  addSvgIconSetLiteral(literal, options) {
+    return this.addSvgIconSetLiteralInNamespace('', literal, options);
+  }
+  addSvgIconSetInNamespace(namespace, url, options) {
+    return this._addSvgIconSetConfig(namespace, new SvgIconConfig(url, null, options));
+  }
+  addSvgIconSetLiteralInNamespace(namespace, literal, options) {
+    const cleanLiteral = this._sanitizer.sanitize(SecurityContext.HTML, literal);
+    if (!cleanLiteral) {
+      throw getMatIconFailedToSanitizeLiteralError(literal);
+    }
+    const trustedLiteral = trustedHTMLFromString(cleanLiteral);
+    return this._addSvgIconSetConfig(namespace, new SvgIconConfig('', trustedLiteral, options));
+  }
+  registerFontClassAlias(alias, classNames = alias) {
+    this._fontCssClassesByAlias.set(alias, classNames);
+    return this;
+  }
+  classNameForFontAlias(alias) {
+    return this._fontCssClassesByAlias.get(alias) || alias;
+  }
+  setDefaultFontSetClass(...classNames) {
+    this._defaultFontSetClass = classNames;
+    return this;
+  }
+  getDefaultFontSetClass() {
+    return this._defaultFontSetClass;
+  }
+  getSvgIconFromUrl(safeUrl) {
+    const url = this._sanitizer.sanitize(SecurityContext.RESOURCE_URL, safeUrl);
+    if (!url) {
+      throw getMatIconFailedToSanitizeUrlError(safeUrl);
+    }
+    const cachedIcon = this._cachedIconsByUrl.get(url);
+    if (cachedIcon) {
+      return of(cloneSvg(cachedIcon));
+    }
+    return this._loadSvgIconFromConfig(new SvgIconConfig(safeUrl, null)).pipe(tap(svg => this._cachedIconsByUrl.set(url, svg)), map(svg => cloneSvg(svg)));
+  }
+  getNamedSvgIcon(name, namespace = '') {
+    const key = iconKey(namespace, name);
+    let config = this._svgIconConfigs.get(key);
+    if (config) {
+      return this._getSvgFromConfig(config);
+    }
+    config = this._getIconConfigFromResolvers(namespace, name);
+    if (config) {
+      this._svgIconConfigs.set(key, config);
+      return this._getSvgFromConfig(config);
+    }
+    const iconSetConfigs = this._iconSetConfigs.get(namespace);
+    if (iconSetConfigs) {
+      return this._getSvgFromIconSetConfigs(name, iconSetConfigs);
+    }
+    return throwError(getMatIconNameNotFoundError(key));
+  }
+  ngOnDestroy() {
+    this._resolvers = [];
+    this._svgIconConfigs.clear();
+    this._iconSetConfigs.clear();
+    this._cachedIconsByUrl.clear();
+  }
+  _getSvgFromConfig(config) {
+    if (config.svgText) {
+      return of(cloneSvg(this._svgElementFromConfig(config)));
+    } else {
+      return this._loadSvgIconFromConfig(config).pipe(map(svg => cloneSvg(svg)));
+    }
+  }
+  _getSvgFromIconSetConfigs(name, iconSetConfigs) {
+    const namedIcon = this._extractIconWithNameFromAnySet(name, iconSetConfigs);
+    if (namedIcon) {
+      return of(namedIcon);
+    }
+    const iconSetFetchRequests = iconSetConfigs.filter(iconSetConfig => !iconSetConfig.svgText).map(iconSetConfig => {
+      return this._loadSvgIconSetFromConfig(iconSetConfig).pipe(catchError(err => {
+        const url = this._sanitizer.sanitize(SecurityContext.RESOURCE_URL, iconSetConfig.url);
+        const errorMessage = `Loading icon set URL: ${url} failed: ${err.message}`;
+        this._errorHandler.handleError(new Error(errorMessage));
+        return of(null);
+      }));
+    });
+    return forkJoin(iconSetFetchRequests).pipe(map(() => {
+      const foundIcon = this._extractIconWithNameFromAnySet(name, iconSetConfigs);
+      if (!foundIcon) {
+        throw getMatIconNameNotFoundError(name);
+      }
+      return foundIcon;
+    }));
+  }
+  _extractIconWithNameFromAnySet(iconName, iconSetConfigs) {
+    for (let i = iconSetConfigs.length - 1; i >= 0; i--) {
+      const config = iconSetConfigs[i];
+      if (config.svgText && config.svgText.toString().indexOf(iconName) > -1) {
+        const svg = this._svgElementFromConfig(config);
+        const foundIcon = this._extractSvgIconFromSet(svg, iconName, config.options);
+        if (foundIcon) {
+          return foundIcon;
         }
-        // Security: The literal is passed in as SafeHtml, and is thus trusted.
-        const trustedLiteral = trustedHTMLFromString(cleanLiteral);
-        return this._addSvgIconConfig(namespace, iconName, new SvgIconConfig('', trustedLiteral, options));
-    }
-    /**
-     * Registers an icon set by URL in the default namespace.
-     * @param url
-     */
-    addSvgIconSet(url, options) {
-        return this.addSvgIconSetInNamespace('', url, options);
-    }
-    /**
-     * Registers an icon set using an HTML string in the default namespace.
-     * @param literal SVG source of the icon set.
-     */
-    addSvgIconSetLiteral(literal, options) {
-        return this.addSvgIconSetLiteralInNamespace('', literal, options);
-    }
-    /**
-     * Registers an icon set by URL in the specified namespace.
-     * @param namespace Namespace in which to register the icon set.
-     * @param url
-     */
-    addSvgIconSetInNamespace(namespace, url, options) {
-        return this._addSvgIconSetConfig(namespace, new SvgIconConfig(url, null, options));
-    }
-    /**
-     * Registers an icon set using an HTML string in the specified namespace.
-     * @param namespace Namespace in which to register the icon set.
-     * @param literal SVG source of the icon set.
-     */
-    addSvgIconSetLiteralInNamespace(namespace, literal, options) {
-        const cleanLiteral = this._sanitizer.sanitize(SecurityContext.HTML, literal);
-        if (!cleanLiteral) {
-            throw getMatIconFailedToSanitizeLiteralError(literal);
-        }
-        // Security: The literal is passed in as SafeHtml, and is thus trusted.
-        const trustedLiteral = trustedHTMLFromString(cleanLiteral);
-        return this._addSvgIconSetConfig(namespace, new SvgIconConfig('', trustedLiteral, options));
-    }
-    /**
-     * Defines an alias for CSS class names to be used for icon fonts. Creating an matIcon
-     * component with the alias as the fontSet input will cause the class name to be applied
-     * to the `<mat-icon>` element.
-     *
-     * If the registered font is a ligature font, then don't forget to also include the special
-     * class `mat-ligature-font` to allow the usage via attribute. So register like this:
-     *
-     * ```ts
-     * iconRegistry.registerFontClassAlias('f1', 'font1 mat-ligature-font');
-     * ```
-     *
-     * And use like this:
-     *
-     * ```html
-     * <mat-icon fontSet="f1" fontIcon="home"></mat-icon>
-     * ```
-     *
-     * @param alias Alias for the font.
-     * @param classNames Class names override to be used instead of the alias.
-     */
-    registerFontClassAlias(alias, classNames = alias) {
-        this._fontCssClassesByAlias.set(alias, classNames);
-        return this;
-    }
-    /**
-     * Returns the CSS class name associated with the alias by a previous call to
-     * registerFontClassAlias. If no CSS class has been associated, returns the alias unmodified.
-     */
-    classNameForFontAlias(alias) {
-        return this._fontCssClassesByAlias.get(alias) || alias;
-    }
-    /**
-     * Sets the CSS classes to be used for icon fonts when an `<mat-icon>` component does not
-     * have a fontSet input value, and is not loading an icon by name or URL.
-     */
-    setDefaultFontSetClass(...classNames) {
-        this._defaultFontSetClass = classNames;
-        return this;
-    }
-    /**
-     * Returns the CSS classes to be used for icon fonts when an `<mat-icon>` component does not
-     * have a fontSet input value, and is not loading an icon by name or URL.
-     */
-    getDefaultFontSetClass() {
-        return this._defaultFontSetClass;
-    }
-    /**
-     * Returns an Observable that produces the icon (as an `<svg>` DOM element) from the given URL.
-     * The response from the URL may be cached so this will not always cause an HTTP request, but
-     * the produced element will always be a new copy of the originally fetched icon. (That is,
-     * it will not contain any modifications made to elements previously returned).
-     *
-     * @param safeUrl URL from which to fetch the SVG icon.
-     */
-    getSvgIconFromUrl(safeUrl) {
-        const url = this._sanitizer.sanitize(SecurityContext.RESOURCE_URL, safeUrl);
-        if (!url) {
-            throw getMatIconFailedToSanitizeUrlError(safeUrl);
-        }
-        const cachedIcon = this._cachedIconsByUrl.get(url);
-        if (cachedIcon) {
-            return of(cloneSvg(cachedIcon));
-        }
-        return this._loadSvgIconFromConfig(new SvgIconConfig(safeUrl, null)).pipe(tap(svg => this._cachedIconsByUrl.set(url, svg)), map(svg => cloneSvg(svg)));
-    }
-    /**
-     * Returns an Observable that produces the icon (as an `<svg>` DOM element) with the given name
-     * and namespace. The icon must have been previously registered with addIcon or addIconSet;
-     * if not, the Observable will throw an error.
-     *
-     * @param name Name of the icon to be retrieved.
-     * @param namespace Namespace in which to look for the icon.
-     */
-    getNamedSvgIcon(name, namespace = '') {
-        const key = iconKey(namespace, name);
-        let config = this._svgIconConfigs.get(key);
-        // Return (copy of) cached icon if possible.
-        if (config) {
-            return this._getSvgFromConfig(config);
-        }
-        // Otherwise try to resolve the config from one of the resolver functions.
-        config = this._getIconConfigFromResolvers(namespace, name);
-        if (config) {
-            this._svgIconConfigs.set(key, config);
-            return this._getSvgFromConfig(config);
-        }
-        // See if we have any icon sets registered for the namespace.
-        const iconSetConfigs = this._iconSetConfigs.get(namespace);
-        if (iconSetConfigs) {
-            return this._getSvgFromIconSetConfigs(name, iconSetConfigs);
-        }
-        return throwError(getMatIconNameNotFoundError(key));
-    }
-    ngOnDestroy() {
-        this._resolvers = [];
-        this._svgIconConfigs.clear();
-        this._iconSetConfigs.clear();
-        this._cachedIconsByUrl.clear();
-    }
-    /**
-     * Returns the cached icon for a SvgIconConfig if available, or fetches it from its URL if not.
-     */
-    _getSvgFromConfig(config) {
-        if (config.svgText) {
-            // We already have the SVG element for this icon, return a copy.
-            return of(cloneSvg(this._svgElementFromConfig(config)));
-        }
-        else {
-            // Fetch the icon from the config's URL, cache it, and return a copy.
-            return this._loadSvgIconFromConfig(config).pipe(map(svg => cloneSvg(svg)));
-        }
-    }
-    /**
-     * Attempts to find an icon with the specified name in any of the SVG icon sets.
-     * First searches the available cached icons for a nested element with a matching name, and
-     * if found copies the element to a new `<svg>` element. If not found, fetches all icon sets
-     * that have not been cached, and searches again after all fetches are completed.
-     * The returned Observable produces the SVG element if possible, and throws
-     * an error if no icon with the specified name can be found.
-     */
-    _getSvgFromIconSetConfigs(name, iconSetConfigs) {
-        // For all the icon set SVG elements we've fetched, see if any contain an icon with the
-        // requested name.
-        const namedIcon = this._extractIconWithNameFromAnySet(name, iconSetConfigs);
-        if (namedIcon) {
-            // We could cache namedIcon in _svgIconConfigs, but since we have to make a copy every
-            // time anyway, there's probably not much advantage compared to just always extracting
-            // it from the icon set.
-            return of(namedIcon);
-        }
-        // Not found in any cached icon sets. If there are icon sets with URLs that we haven't
-        // fetched, fetch them now and look for iconName in the results.
-        const iconSetFetchRequests = iconSetConfigs
-            .filter(iconSetConfig => !iconSetConfig.svgText)
-            .map(iconSetConfig => {
-            return this._loadSvgIconSetFromConfig(iconSetConfig).pipe(catchError((err) => {
-                const url = this._sanitizer.sanitize(SecurityContext.RESOURCE_URL, iconSetConfig.url);
-                // Swallow errors fetching individual URLs so the
-                // combined Observable won't necessarily fail.
-                const errorMessage = `Loading icon set URL: ${url} failed: ${err.message}`;
-                this._errorHandler.handleError(new Error(errorMessage));
-                return of(null);
-            }));
-        });
-        // Fetch all the icon set URLs. When the requests complete, every IconSet should have a
-        // cached SVG element (unless the request failed), and we can check again for the icon.
-        return forkJoin(iconSetFetchRequests).pipe(map(() => {
-            const foundIcon = this._extractIconWithNameFromAnySet(name, iconSetConfigs);
-            // TODO: add an ngDevMode check
-            if (!foundIcon) {
-                throw getMatIconNameNotFoundError(name);
-            }
-            return foundIcon;
-        }));
-    }
-    /**
-     * Searches the cached SVG elements for the given icon sets for a nested icon element whose "id"
-     * tag matches the specified name. If found, copies the nested element to a new SVG element and
-     * returns it. Returns null if no matching element is found.
-     */
-    _extractIconWithNameFromAnySet(iconName, iconSetConfigs) {
-        // Iterate backwards, so icon sets added later have precedence.
-        for (let i = iconSetConfigs.length - 1; i >= 0; i--) {
-            const config = iconSetConfigs[i];
-            // Parsing the icon set's text into an SVG element can be expensive. We can avoid some of
-            // the parsing by doing a quick check using `indexOf` to see if there's any chance for the
-            // icon to be in the set. This won't be 100% accurate, but it should help us avoid at least
-            // some of the parsing.
-            if (config.svgText && config.svgText.toString().indexOf(iconName) > -1) {
-                const svg = this._svgElementFromConfig(config);
-                const foundIcon = this._extractSvgIconFromSet(svg, iconName, config.options);
-                if (foundIcon) {
-                    return foundIcon;
-                }
-            }
-        }
-        return null;
-    }
-    /**
-     * Loads the content of the icon URL specified in the SvgIconConfig and creates an SVG element
-     * from it.
-     */
-    _loadSvgIconFromConfig(config) {
-        return this._fetchIcon(config).pipe(tap(svgText => (config.svgText = svgText)), map(() => this._svgElementFromConfig(config)));
-    }
-    /**
-     * Loads the content of the icon set URL specified in the
-     * SvgIconConfig and attaches it to the config.
-     */
-    _loadSvgIconSetFromConfig(config) {
-        if (config.svgText) {
-            return of(null);
-        }
-        return this._fetchIcon(config).pipe(tap(svgText => (config.svgText = svgText)));
-    }
-    /**
-     * Searches the cached element of the given SvgIconConfig for a nested icon element whose "id"
-     * tag matches the specified name. If found, copies the nested element to a new SVG element and
-     * returns it. Returns null if no matching element is found.
-     */
-    _extractSvgIconFromSet(iconSet, iconName, options) {
-        // Use the `id="iconName"` syntax in order to escape special
-        // characters in the ID (versus using the #iconName syntax).
-        const iconSource = iconSet.querySelector(`[id="${iconName}"]`);
-        if (!iconSource) {
-            return null;
-        }
-        // Clone the element and remove the ID to prevent multiple elements from being added
-        // to the page with the same ID.
-        const iconElement = iconSource.cloneNode(true);
-        iconElement.removeAttribute('id');
-        // If the icon node is itself an <svg> node, clone and return it directly. If not, set it as
-        // the content of a new <svg> node.
-        if (iconElement.nodeName.toLowerCase() === 'svg') {
-            return this._setSvgAttributes(iconElement, options);
-        }
-        // If the node is a <symbol>, it won't be rendered so we have to convert it into <svg>. Note
-        // that the same could be achieved by referring to it via <use href="#id">, however the <use>
-        // tag is problematic on Firefox, because it needs to include the current page path.
-        if (iconElement.nodeName.toLowerCase() === 'symbol') {
-            return this._setSvgAttributes(this._toSvgElement(iconElement), options);
-        }
-        // createElement('SVG') doesn't work as expected; the DOM ends up with
-        // the correct nodes, but the SVG content doesn't render. Instead we
-        // have to create an empty SVG node using innerHTML and append its content.
-        // Elements created using DOMParser.parseFromString have the same problem.
-        // http://stackoverflow.com/questions/23003278/svg-innerhtml-in-firefox-can-not-display
-        const svg = this._svgElementFromString(trustedHTMLFromString('<svg></svg>'));
-        // Clone the node so we don't remove it from the parent icon set element.
-        svg.appendChild(iconElement);
-        return this._setSvgAttributes(svg, options);
-    }
-    /**
-     * Creates a DOM element from the given SVG string.
-     */
-    _svgElementFromString(str) {
-        const div = this._document.createElement('DIV');
-        div.innerHTML = str;
-        const svg = div.querySelector('svg');
-        // TODO: add an ngDevMode check
-        if (!svg) {
-            throw Error('<svg> tag not found');
-        }
-        return svg;
-    }
-    /**
-     * Converts an element into an SVG node by cloning all of its children.
-     */
-    _toSvgElement(element) {
-        const svg = this._svgElementFromString(trustedHTMLFromString('<svg></svg>'));
-        const attributes = element.attributes;
-        // Copy over all the attributes from the `symbol` to the new SVG, except the id.
-        for (let i = 0; i < attributes.length; i++) {
-            const { name, value } = attributes[i];
-            if (name !== 'id') {
-                svg.setAttribute(name, value);
-            }
-        }
-        for (let i = 0; i < element.childNodes.length; i++) {
-            if (element.childNodes[i].nodeType === this._document.ELEMENT_NODE) {
-                svg.appendChild(element.childNodes[i].cloneNode(true));
-            }
-        }
-        return svg;
-    }
-    /**
-     * Sets the default attributes for an SVG element to be used as an icon.
-     */
-    _setSvgAttributes(svg, options) {
-        svg.setAttribute('fit', '');
-        svg.setAttribute('height', '100%');
-        svg.setAttribute('width', '100%');
-        svg.setAttribute('preserveAspectRatio', 'xMidYMid meet');
-        svg.setAttribute('focusable', 'false'); // Disable IE11 default behavior to make SVGs focusable.
-        if (options && options.viewBox) {
-            svg.setAttribute('viewBox', options.viewBox);
-        }
-        return svg;
-    }
-    /**
-     * Returns an Observable which produces the string contents of the given icon. Results may be
-     * cached, so future calls with the same URL may not cause another HTTP request.
-     */
-    _fetchIcon(iconConfig) {
-        const { url: safeUrl, options } = iconConfig;
-        const withCredentials = options?.withCredentials ?? false;
-        if (!this._httpClient) {
-            throw getMatIconNoHttpProviderError();
-        }
-        // TODO: add an ngDevMode check
-        if (safeUrl == null) {
-            throw Error(`Cannot fetch icon from URL "${safeUrl}".`);
-        }
-        const url = this._sanitizer.sanitize(SecurityContext.RESOURCE_URL, safeUrl);
-        // TODO: add an ngDevMode check
-        if (!url) {
-            throw getMatIconFailedToSanitizeUrlError(safeUrl);
-        }
-        // Store in-progress fetches to avoid sending a duplicate request for a URL when there is
-        // already a request in progress for that URL. It's necessary to call share() on the
-        // Observable returned by http.get() so that multiple subscribers don't cause multiple XHRs.
-        const inProgressFetch = this._inProgressUrlFetches.get(url);
-        if (inProgressFetch) {
-            return inProgressFetch;
-        }
-        const req = this._httpClient.get(url, { responseType: 'text', withCredentials }).pipe(map(svg => {
-            // Security: This SVG is fetched from a SafeResourceUrl, and is thus
-            // trusted HTML.
-            return trustedHTMLFromString(svg);
-        }), finalize(() => this._inProgressUrlFetches.delete(url)), share());
-        this._inProgressUrlFetches.set(url, req);
-        return req;
-    }
-    /**
-     * Registers an icon config by name in the specified namespace.
-     * @param namespace Namespace in which to register the icon config.
-     * @param iconName Name under which to register the config.
-     * @param config Config to be registered.
-     */
-    _addSvgIconConfig(namespace, iconName, config) {
-        this._svgIconConfigs.set(iconKey(namespace, iconName), config);
-        return this;
-    }
-    /**
-     * Registers an icon set config in the specified namespace.
-     * @param namespace Namespace in which to register the icon config.
-     * @param config Config to be registered.
-     */
-    _addSvgIconSetConfig(namespace, config) {
-        const configNamespace = this._iconSetConfigs.get(namespace);
-        if (configNamespace) {
-            configNamespace.push(config);
-        }
-        else {
-            this._iconSetConfigs.set(namespace, [config]);
-        }
-        return this;
-    }
-    /** Parses a config's text into an SVG element. */
-    _svgElementFromConfig(config) {
-        if (!config.svgElement) {
-            const svg = this._svgElementFromString(config.svgText);
-            this._setSvgAttributes(svg, config.options);
-            config.svgElement = svg;
-        }
-        return config.svgElement;
-    }
-    /** Tries to create an icon config through the registered resolver functions. */
-    _getIconConfigFromResolvers(namespace, name) {
-        for (let i = 0; i < this._resolvers.length; i++) {
-            const result = this._resolvers[i](name, namespace);
-            if (result) {
-                return isSafeUrlWithOptions(result)
-                    ? new SvgIconConfig(result.url, null, result.options)
-                    : new SvgIconConfig(result, null);
-            }
-        }
-        return undefined;
-    }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.2.0-next.2", ngImport: i0, type: MatIconRegistry, deps: [{ token: i1.HttpClient, optional: true }, { token: i2.DomSanitizer }, { token: DOCUMENT, optional: true }, { token: i0.ErrorHandler }], target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.2.0-next.2", ngImport: i0, type: MatIconRegistry, providedIn: 'root' });
+      }
+    }
+    return null;
+  }
+  _loadSvgIconFromConfig(config) {
+    return this._fetchIcon(config).pipe(tap(svgText => config.svgText = svgText), map(() => this._svgElementFromConfig(config)));
+  }
+  _loadSvgIconSetFromConfig(config) {
+    if (config.svgText) {
+      return of(null);
+    }
+    return this._fetchIcon(config).pipe(tap(svgText => config.svgText = svgText));
+  }
+  _extractSvgIconFromSet(iconSet, iconName, options) {
+    const iconSource = iconSet.querySelector(`[id="${iconName}"]`);
+    if (!iconSource) {
+      return null;
+    }
+    const iconElement = iconSource.cloneNode(true);
+    iconElement.removeAttribute('id');
+    if (iconElement.nodeName.toLowerCase() === 'svg') {
+      return this._setSvgAttributes(iconElement, options);
+    }
+    if (iconElement.nodeName.toLowerCase() === 'symbol') {
+      return this._setSvgAttributes(this._toSvgElement(iconElement), options);
+    }
+    const svg = this._svgElementFromString(trustedHTMLFromString('<svg></svg>'));
+    svg.appendChild(iconElement);
+    return this._setSvgAttributes(svg, options);
+  }
+  _svgElementFromString(str) {
+    const div = this._document.createElement('DIV');
+    div.innerHTML = str;
+    const svg = div.querySelector('svg');
+    if (!svg) {
+      throw Error('<svg> tag not found');
+    }
+    return svg;
+  }
+  _toSvgElement(element) {
+    const svg = this._svgElementFromString(trustedHTMLFromString('<svg></svg>'));
+    const attributes = element.attributes;
+    for (let i = 0; i < attributes.length; i++) {
+      const {
+        name,
+        value
+      } = attributes[i];
+      if (name !== 'id') {
+        svg.setAttribute(name, value);
+      }
+    }
+    for (let i = 0; i < element.childNodes.length; i++) {
+      if (element.childNodes[i].nodeType === this._document.ELEMENT_NODE) {
+        svg.appendChild(element.childNodes[i].cloneNode(true));
+      }
+    }
+    return svg;
+  }
+  _setSvgAttributes(svg, options) {
+    svg.setAttribute('fit', '');
+    svg.setAttribute('height', '100%');
+    svg.setAttribute('width', '100%');
+    svg.setAttribute('preserveAspectRatio', 'xMidYMid meet');
+    svg.setAttribute('focusable', 'false');
+    if (options && options.viewBox) {
+      svg.setAttribute('viewBox', options.viewBox);
+    }
+    return svg;
+  }
+  _fetchIcon(iconConfig) {
+    const {
+      url: safeUrl,
+      options
+    } = iconConfig;
+    const withCredentials = options?.withCredentials ?? false;
+    if (!this._httpClient) {
+      throw getMatIconNoHttpProviderError();
+    }
+    if (safeUrl == null) {
+      throw Error(`Cannot fetch icon from URL "${safeUrl}".`);
+    }
+    const url = this._sanitizer.sanitize(SecurityContext.RESOURCE_URL, safeUrl);
+    if (!url) {
+      throw getMatIconFailedToSanitizeUrlError(safeUrl);
+    }
+    const inProgressFetch = this._inProgressUrlFetches.get(url);
+    if (inProgressFetch) {
+      return inProgressFetch;
+    }
+    const req = this._httpClient.get(url, {
+      responseType: 'text',
+      withCredentials
+    }).pipe(map(svg => {
+      return trustedHTMLFromString(svg);
+    }), finalize(() => this._inProgressUrlFetches.delete(url)), share());
+    this._inProgressUrlFetches.set(url, req);
+    return req;
+  }
+  _addSvgIconConfig(namespace, iconName, config) {
+    this._svgIconConfigs.set(iconKey(namespace, iconName), config);
+    return this;
+  }
+  _addSvgIconSetConfig(namespace, config) {
+    const configNamespace = this._iconSetConfigs.get(namespace);
+    if (configNamespace) {
+      configNamespace.push(config);
+    } else {
+      this._iconSetConfigs.set(namespace, [config]);
+    }
+    return this;
+  }
+  _svgElementFromConfig(config) {
+    if (!config.svgElement) {
+      const svg = this._svgElementFromString(config.svgText);
+      this._setSvgAttributes(svg, config.options);
+      config.svgElement = svg;
+    }
+    return config.svgElement;
+  }
+  _getIconConfigFromResolvers(namespace, name) {
+    for (let i = 0; i < this._resolvers.length; i++) {
+      const result = this._resolvers[i](name, namespace);
+      if (result) {
+        return isSafeUrlWithOptions(result) ? new SvgIconConfig(result.url, null, result.options) : new SvgIconConfig(result, null);
+      }
+    }
+    return undefined;
+  }
+  static ɵfac = i0.ɵɵngDeclareFactory({
+    minVersion: "12.0.0",
+    version: "20.2.0-next.2",
+    ngImport: i0,
+    type: MatIconRegistry,
+    deps: [{
+      token: i1.HttpClient,
+      optional: true
+    }, {
+      token: i2.DomSanitizer
+    }, {
+      token: DOCUMENT,
+      optional: true
+    }, {
+      token: i0.ErrorHandler
+    }],
+    target: i0.ɵɵFactoryTarget.Injectable
+  });
+  static ɵprov = i0.ɵɵngDeclareInjectable({
+    minVersion: "12.0.0",
+    version: "20.2.0-next.2",
+    ngImport: i0,
+    type: MatIconRegistry,
+    providedIn: 'root'
+  });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.2.0-next.2", ngImport: i0, type: MatIconRegistry, decorators: [{
-            type: Injectable,
-            args: [{ providedIn: 'root' }]
-        }], ctorParameters: () => [{ type: i1.HttpClient, decorators: [{
-                    type: Optional
-                }] }, { type: i2.DomSanitizer }, { type: undefined, decorators: [{
-                    type: Optional
-                }, {
-                    type: Inject,
-                    args: [DOCUMENT]
-                }] }, { type: i0.ErrorHandler }] });
-/** Clones an SVGElement while preserving type information. */
+i0.ɵɵngDeclareClassMetadata({
+  minVersion: "12.0.0",
+  version: "20.2.0-next.2",
+  ngImport: i0,
+  type: MatIconRegistry,
+  decorators: [{
+    type: Injectable,
+    args: [{
+      providedIn: 'root'
+    }]
+  }],
+  ctorParameters: () => [{
+    type: i1.HttpClient,
+    decorators: [{
+      type: Optional
+    }]
+  }, {
+    type: i2.DomSanitizer
+  }, {
+    type: undefined,
+    decorators: [{
+      type: Optional
+    }, {
+      type: Inject,
+      args: [DOCUMENT]
+    }]
+  }, {
+    type: i0.ErrorHandler
+  }]
+});
 function cloneSvg(svg) {
-    return svg.cloneNode(true);
+  return svg.cloneNode(true);
 }
-/** Returns the cache key to use for an icon namespace and name. */
 function iconKey(namespace, name) {
-    return namespace + ':' + name;
+  return namespace + ':' + name;
 }
 function isSafeUrlWithOptions(value) {
-    return !!(value.url && value.options);
+  return !!(value.url && value.options);
 }
 
 export { MatIconRegistry, getMatIconFailedToSanitizeLiteralError, getMatIconFailedToSanitizeUrlError, getMatIconNameNotFoundError, getMatIconNoHttpProviderError };