@turntrout/subfont 1.6.0 → 1.7.1

package/lib/subsetFonts.js

@@ -1,106 +1,101 @@
-const urltools = require('urltools');
-
-const fontverter = require('fontverter');
-
-const compileQuery = require('assetgraph/lib/compileQuery');
-
-const findCustomPropertyDefinitions = require('./findCustomPropertyDefinitions');
-const extractReferencedCustomPropertyNames = require('./extractReferencedCustomPropertyNames');
-const injectSubsetDefinitions = require('./injectSubsetDefinitions');
-const { makePhaseTracker } = require('./progress');
-const cssFontParser = require('css-font-parser');
-const cssListHelpers = require('css-list-helpers');
-const unquote = require('./unquote');
-const normalizeFontPropertyValue = require('./normalizeFontPropertyValue');
-const unicodeRange = require('./unicodeRange');
-const getFontInfo = require('./getFontInfo');
-const collectTextsByPage = require('./collectTextsByPage');
-
-const {
-  maybeCssQuote,
-  getFontFaceDeclarationText,
-  getUnusedVariantsStylesheet,
-  getFontUsageStylesheet,
-  getCodepoints,
-  cssAssetIsEmpty,
-  parseFontWeightRange,
-  parseFontStretchRange,
-  hashHexPrefix,
-} = require('./fontFaceHelpers');
-const { getVariationAxisUsage } = require('./variationAxes');
-const { getSubsetsForFontUsage } = require('./subsetGeneration');
-const subsetFontWithGlyphs = require('./subsetFontWithGlyphs');
-
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+const urltools = __importStar(require("urltools"));
+const fontverter = __importStar(require("fontverter"));
+const compileQuery = require("assetgraph/lib/compileQuery");
+const findCustomPropertyDefinitions = require("./findCustomPropertyDefinitions");
+const extractReferencedCustomPropertyNames = require("./extractReferencedCustomPropertyNames");
+const injectSubsetDefinitions = require("./injectSubsetDefinitions");
+const progress_1 = require("./progress");
+const cssFontParser = __importStar(require("css-font-parser"));
+const cssListHelpers = __importStar(require("css-list-helpers"));
+const unquote = require("./unquote");
+const normalizeFontPropertyValue = require("./normalizeFontPropertyValue");
+const unicodeRange = require("./unicodeRange");
+const getFontInfo = require("./getFontInfo");
+const collectTextsByPage = require("./collectTextsByPage");
+const escapeJsStringLiteral = require("./escapeJsStringLiteral");
+const fontFaceHelpers_1 = require("./fontFaceHelpers");
+const variationAxes_1 = require("./variationAxes");
+const subsetGeneration_1 = require("./subsetGeneration");
+const subsetFontWithGlyphs = require("./subsetFontWithGlyphs");
+const warnAboutMissingGlyphs = require("./warnAboutMissingGlyphs");
 const googleFontsCssUrlRegex = /^(?:https?:)?\/\/fonts\.googleapis\.com\/css/;
-
 function getParents(asset, assetQuery) {
-  const assetMatcher = compileQuery(assetQuery);
-  const seenAssets = new Set();
-  const parents = [];
-  (function visit(asset) {
-    if (seenAssets.has(asset)) {
-      return;
-    }
-    seenAssets.add(asset);
-
-    for (const incomingRelation of asset.incomingRelations) {
-      if (assetMatcher(incomingRelation.from)) {
-        parents.push(incomingRelation.from);
-      } else {
-        visit(incomingRelation.from);
-      }
-    }
-  })(asset);
-
-  return parents;
-}
-
-// Escape a value for safe inclusion in any JS string context (single-quoted,
-// double-quoted, or template literal). Uses JSON.stringify for robust escaping
-// of backslashes, quotes, newlines, U+2028, U+2029, etc.
-// The < escape prevents </script> from closing an inline script tag.
-function escapeJsStringLiteral(str) {
-  return JSON.stringify(str)
-    .slice(1, -1)
-    .replace(/'/g, "\\'")
-    .replace(/`/g, '\\x60')
-    .replace(/</g, '\\x3c');
+    const assetMatcher = compileQuery(assetQuery);
+    const seenAssets = new Set();
+    const parents = [];
+    (function visit(asset) {
+        if (seenAssets.has(asset)) {
+            return;
+        }
+        seenAssets.add(asset);
+        for (const incomingRelation of asset.incomingRelations) {
+            if (assetMatcher(incomingRelation.from)) {
+                parents.push(incomingRelation.from);
+            }
+            else {
+                visit(incomingRelation.from);
+            }
+        }
+    })(asset);
+    return parents;
 }
-
 function countUniqueFontUrls(htmlOrSvgAssetTextsWithProps) {
-  const urls = new Set();
-  for (const item of htmlOrSvgAssetTextsWithProps) {
-    for (const fu of item.fontUsages) {
-      if (fu.fontUrl) urls.add(fu.fontUrl);
+    const urls = new Set();
+    for (const item of htmlOrSvgAssetTextsWithProps) {
+        for (const fu of item.fontUsages) {
+            if (fu.fontUrl)
+                urls.add(fu.fontUrl);
+        }
     }
-  }
-  return urls.size;
+    return urls.size;
 }
-
-function asyncLoadStyleRelationWithFallback(
-  htmlOrSvgAsset,
-  originalRelation,
-  hrefType
-) {
-  // Async load google font stylesheet
-  // Insert async CSS loading <script>
-  const href = escapeJsStringLiteral(
-    htmlOrSvgAsset.assetGraph.buildHref(
-      originalRelation.to.url,
-      htmlOrSvgAsset.url,
-      { hrefType }
-    )
-  );
-  const mediaAssignment = originalRelation.media
-    ? `el.media = '${escapeJsStringLiteral(originalRelation.media)}';`
-    : '';
-  const asyncCssLoadingRelation = htmlOrSvgAsset.addRelation(
-    {
-      type: 'HtmlScript',
-      hrefType: 'inline',
-      to: {
-        type: 'JavaScript',
-        text: `
+function asyncLoadStyleRelationWithFallback(htmlOrSvgAsset, originalRelation, hrefType) {
+    // Async load google font stylesheet
+    // Insert async CSS loading <script>
+    const href = escapeJsStringLiteral(htmlOrSvgAsset.assetGraph.buildHref(originalRelation.to.url, htmlOrSvgAsset.url, { hrefType }));
+    const mediaAssignment = originalRelation.media
+        ? `el.media = '${escapeJsStringLiteral(originalRelation.media)}';`
+        : '';
+    const asyncCssLoadingRelation = htmlOrSvgAsset.addRelation({
+        type: 'HtmlScript',
+        hrefType: 'inline',
+        to: {
+            type: 'JavaScript',
+            text: `
           (function () {
             var el = document.createElement('link');
             el.href = '${href}'.toString('url');
@@ -109,1141 +104,887 @@ function asyncLoadStyleRelationWithFallback(
             document.body.appendChild(el);
           }())
         `,
-      },
-    },
-    'lastInBody'
-  );
-
-  // Insert <noscript> fallback sync CSS loading
-  const noScriptFallbackRelation = htmlOrSvgAsset.addRelation(
-    {
-      type: 'HtmlNoscript',
-      to: {
-        type: 'Html',
-        text: '',
-      },
-    },
-    'lastInBody'
-  );
-
-  noScriptFallbackRelation.to.addRelation(
-    {
-      type: 'HtmlStyle',
-      media: originalRelation.media,
-      to: originalRelation.to,
-      hrefType,
-    },
-    'last'
-  );
-
-  noScriptFallbackRelation.inline();
-  asyncCssLoadingRelation.to.minify();
-  htmlOrSvgAsset.markDirty();
+        },
+    }, 'lastInBody');
+    // Insert <noscript> fallback sync CSS loading
+    const noScriptFallbackRelation = htmlOrSvgAsset.addRelation({
+        type: 'HtmlNoscript',
+        to: {
+            type: 'Html',
+            text: '',
+        },
+    }, 'lastInBody');
+    noScriptFallbackRelation.to.addRelation({
+        type: 'HtmlStyle',
+        media: originalRelation.media,
+        to: originalRelation.to,
+        hrefType,
+    }, 'last');
+    noScriptFallbackRelation.inline();
+    asyncCssLoadingRelation.to.minify();
+    htmlOrSvgAsset.markDirty();
 }
-
 const extensionByFormat = {
-  truetype: '.ttf',
-  woff: '.woff',
-  woff2: '.woff2',
+    truetype: '.ttf',
+    woff: '.woff',
+    woff2: '.woff2',
 };
-
-async function createSelfHostedGoogleFontsCssAsset(
-  assetGraph,
-  googleFontsCssAsset,
-  formats,
-  hrefType,
-  subsetUrl
-) {
-  const lines = [];
-  for (const cssFontFaceSrc of assetGraph.findRelations({
-    from: googleFontsCssAsset,
-    type: 'CssFontFaceSrc',
-  })) {
-    lines.push(`@font-face {`);
-    const fontFaceDeclaration = cssFontFaceSrc.node;
-    fontFaceDeclaration.walkDecls((declaration) => {
-      const propName = declaration.prop.toLowerCase();
-      if (propName !== 'src') {
-        lines.push(`  ${propName}: ${declaration.value};`);
-      }
-    });
-    // Convert to all formats in parallel
-    const convertedFonts = await Promise.all(
-      formats.map((format) =>
-        fontverter.convert(cssFontFaceSrc.to.rawSrc, format)
-      )
-    );
-    const srcFragments = [];
-    for (let fi = 0; fi < formats.length; fi++) {
-      const format = formats[fi];
-      const rawSrc = convertedFonts[fi];
-      const url = assetGraph.resolveUrl(
-        subsetUrl,
-        `${cssFontFaceSrc.to.baseName}-${hashHexPrefix(rawSrc)}${
-          extensionByFormat[format]
-        }`
-      );
-      const fontAsset =
-        assetGraph.findAssets({ url })[0] ||
-        (await assetGraph.addAsset({
-          url,
-          rawSrc,
-        }));
-      srcFragments.push(
-        `url(${assetGraph.buildHref(fontAsset.url, subsetUrl, {
-          hrefType,
-        })}) format('${format}')`
-      );
+async function createSelfHostedGoogleFontsCssAsset(assetGraph, googleFontsCssAsset, formats, hrefType, subsetUrl) {
+    const lines = [];
+    for (const cssFontFaceSrc of assetGraph.findRelations({
+        from: googleFontsCssAsset,
+        type: 'CssFontFaceSrc',
+    })) {
+        lines.push(`@font-face {`);
+        const fontFaceDeclaration = cssFontFaceSrc.node;
+        fontFaceDeclaration.walkDecls((declaration) => {
+            const propName = declaration.prop.toLowerCase();
+            if (propName !== 'src') {
+                lines.push(`  ${propName}: ${declaration.value};`);
+            }
+        });
+        // Convert to all formats in parallel
+        const convertedFonts = await Promise.all(formats.map((format) => fontverter.convert(cssFontFaceSrc.to.rawSrc, format)));
+        const srcFragments = [];
+        for (let fi = 0; fi < formats.length; fi++) {
+            const format = formats[fi];
+            const rawSrc = convertedFonts[fi];
+            const url = assetGraph.resolveUrl(subsetUrl, `${cssFontFaceSrc.to.baseName}-${(0, fontFaceHelpers_1.hashHexPrefix)(rawSrc)}${extensionByFormat[format]}`);
+            const fontAsset = assetGraph.findAssets({ url })[0] ||
+                (await assetGraph.addAsset({
+                    url,
+                    rawSrc,
+                }));
+            srcFragments.push(`url(${assetGraph.buildHref(fontAsset.url, subsetUrl, {
+                hrefType,
+            })}) format('${format}')`);
+        }
+        lines.push(`  src: ${srcFragments.join(', ')};`);
+        lines.push(`  unicode-range: ${unicodeRange((await getFontInfo(cssFontFaceSrc.to.rawSrc)).characterSet)};`);
+        lines.push('}');
     }
-    lines.push(`  src: ${srcFragments.join(', ')};`);
-    lines.push(
-      `  unicode-range: ${unicodeRange(
-        (await getFontInfo(cssFontFaceSrc.to.rawSrc)).characterSet
-      )};`
-    );
-    lines.push('}');
-  }
-  const text = lines.join('\n');
-  const fallbackAsset = assetGraph.addAsset({
-    type: 'Css',
-    url: assetGraph.resolveUrl(
-      subsetUrl,
-      `fallback-${hashHexPrefix(text)}.css`
-    ),
-    text,
-  });
-  return fallbackAsset;
+    const text = lines.join('\n');
+    const fallbackAsset = assetGraph.addAsset({
+        type: 'Css',
+        url: assetGraph.resolveUrl(subsetUrl, `fallback-${(0, fontFaceHelpers_1.hashHexPrefix)(text)}.css`),
+        text,
+    });
+    return fallbackAsset;
 }
-
 const validFontDisplayValues = [
-  'auto',
-  'block',
-  'swap',
-  'fallback',
-  'optional',
+    'auto',
+    'block',
+    'swap',
+    'fallback',
+    'optional',
 ];
-
-const warnAboutMissingGlyphs = require('./warnAboutMissingGlyphs');
-
-// Extract subset CSS asset creation/caching into a standalone function
-// to reduce cyclomatic complexity of the main injection loop.
-async function getOrCreateSubsetCssAsset({
-  assetGraph,
-  subsetCssText,
-  subsetFontUsages,
-  formats,
-  subsetUrl,
-  hrefType,
-  inlineCss,
-  fontUrlsUsedOnEveryPage,
-  numPages,
-  subsetCssAssetCache,
-}) {
-  let cssAsset = subsetCssAssetCache.get(subsetCssText);
-  if (cssAsset) return cssAsset;
-
-  cssAsset = assetGraph.addAsset({
-    type: 'Css',
-    url: `${subsetUrl}subfontTemp.css`,
-    text: subsetCssText,
-  });
-
-  await cssAsset.minify();
-
-  for (const [i, fontRelation] of cssAsset.outgoingRelations.entries()) {
-    const fontAsset = fontRelation.to;
-    if (!fontAsset.isLoaded) {
-      // An unused variant that does not exist, don't try to hash
-      fontRelation.hrefType = hrefType;
-      continue;
+// Create (or retrieve from disk cache) the subset CSS asset for a set of
+// fontUsages, relocating the font binary to its hashed URL under subsetUrl.
+async function getOrCreateSubsetCssAsset({ assetGraph, subsetCssText, subsetFontUsages, formats, subsetUrl, hrefType, inlineCss, fontUrlsUsedOnEveryPage, numPages, subsetCssAssetCache, }) {
+    let cssAsset = subsetCssAssetCache.get(subsetCssText);
+    if (cssAsset)
+        return cssAsset;
+    cssAsset = assetGraph.addAsset({
+        type: 'Css',
+        url: `${subsetUrl}subfontTemp.css`,
+        text: subsetCssText,
+    });
+    await cssAsset.minify();
+    for (const [i, fontRelation] of cssAsset.outgoingRelations.entries()) {
+        const fontAsset = fontRelation.to;
+        if (!fontAsset.isLoaded) {
+            // An unused variant that does not exist, don't try to hash
+            fontRelation.hrefType = hrefType;
+            continue;
+        }
+        const fontUsage = subsetFontUsages[i];
+        if (formats.length === 1 &&
+            fontUsage &&
+            fontUsage.fontUrl &&
+            (!inlineCss || numPages === 1) &&
+            fontUrlsUsedOnEveryPage.has(fontUsage.fontUrl)) {
+            // We're only outputting one font format, we're not inlining the subfont CSS (or there's only one page), and this font is used on every page -- keep it inline in the subfont CSS
+            continue;
+        }
+        const extension = (fontAsset.contentType ?? '').split('/').pop();
+        const nameProps = ['font-family', 'font-weight', 'font-style']
+            .map((prop) => fontRelation.node.nodes?.find((decl) => decl.prop === prop))
+            .map((decl) => decl?.value);
+        const fontWeightRangeStr = nameProps[1]
+            .split(/\s+/)
+            .map((token) => normalizeFontPropertyValue('font-weight', token))
+            .join('_');
+        const fileNamePrefix = `${unquote(cssFontParser.parseFontFamily(nameProps[0])[0])
+            .replace(/__subset$/, '')
+            .replace(/[^a-z0-9_-]/gi, '_')}-${fontWeightRangeStr}${nameProps[2] === 'italic' ? 'i' : ''}`;
+        const fontFileName = `${fileNamePrefix}-${fontAsset.md5Hex.slice(0, 10)}.${extension}`;
+        // If it's not inline, it's one of the unused variants that gets a mirrored declaration added
+        // for the __subset @font-face. Do not move it to /subfont/
+        if (fontAsset.isInline) {
+            const fontAssetUrl = subsetUrl + fontFileName;
+            const existingFontAsset = assetGraph.findAssets({
+                url: fontAssetUrl,
+            })[0];
+            if (existingFontAsset) {
+                fontRelation.to = existingFontAsset;
+                assetGraph.removeAsset(fontAsset);
+            }
+            else {
+                fontAsset.url = subsetUrl + fontFileName;
+            }
+        }
+        fontRelation.hrefType = hrefType;
     }
-
-    const fontUsage = subsetFontUsages[i];
-    if (
-      formats.length === 1 &&
-      fontUsage &&
-      (!inlineCss || numPages === 1) &&
-      fontUrlsUsedOnEveryPage.has(fontUsage.fontUrl)
-    ) {
-      // We're only outputting one font format, we're not inlining the subfont CSS (or there's only one page), and this font is used on every page -- keep it inline in the subfont CSS
-      continue;
+    const cssAssetUrl = `${subsetUrl}fonts-${cssAsset.md5Hex.slice(0, 10)}.css`;
+    const existingCssAsset = assetGraph.findAssets({ url: cssAssetUrl })[0];
+    if (existingCssAsset) {
+        assetGraph.removeAsset(cssAsset);
+        cssAsset = existingCssAsset;
     }
-
-    const extension = fontAsset.contentType.split('/').pop();
-
-    const nameProps = ['font-family', 'font-weight', 'font-style']
-      .map((prop) => fontRelation.node.nodes.find((decl) => decl.prop === prop))
-      .map((decl) => decl.value);
-
-    const fontWeightRangeStr = nameProps[1]
-      .split(/\s+/)
-      .map((token) => normalizeFontPropertyValue('font-weight', token))
-      .join('_');
-    const fileNamePrefix = `${unquote(
-      cssFontParser.parseFontFamily(nameProps[0])[0]
-    )
-      .replace(/__subset$/, '')
-      .replace(/[^a-z0-9_-]/gi, '_')}-${fontWeightRangeStr}${
-      nameProps[2] === 'italic' ? 'i' : ''
-    }`;
-
-    const fontFileName = `${fileNamePrefix}-${fontAsset.md5Hex.slice(
-      0,
-      10
-    )}.${extension}`;
-
-    // If it's not inline, it's one of the unused variants that gets a mirrored declaration added
-    // for the __subset @font-face. Do not move it to /subfont/
-    if (fontAsset.isInline) {
-      const fontAssetUrl = subsetUrl + fontFileName;
-      const existingFontAsset = assetGraph.findAssets({
-        url: fontAssetUrl,
-      })[0];
-      if (existingFontAsset) {
-        fontRelation.to = existingFontAsset;
-        assetGraph.removeAsset(fontAsset);
-      } else {
-        fontAsset.url = subsetUrl + fontFileName;
-      }
+    else {
+        cssAsset.url = cssAssetUrl;
     }
-
-    fontRelation.hrefType = hrefType;
-  }
-
-  const cssAssetUrl = `${subsetUrl}fonts-${cssAsset.md5Hex.slice(0, 10)}.css`;
-  const existingCssAsset = assetGraph.findAssets({ url: cssAssetUrl })[0];
-  if (existingCssAsset) {
-    assetGraph.removeAsset(cssAsset);
-    cssAsset = existingCssAsset;
-  } else {
-    cssAsset.url = cssAssetUrl;
-  }
-  subsetCssAssetCache.set(subsetCssText, cssAsset);
-  return cssAsset;
+    subsetCssAssetCache.set(subsetCssText, cssAsset);
+    return cssAsset;
 }
-
-// Extract subset font preload insertion to reduce injection loop complexity.
-function addSubsetFontPreloads({
-  cssAsset,
-  fontUsages,
-  htmlOrSvgAsset,
-  subsetUrl,
-  hrefType,
-  insertionPoint,
-}) {
-  if (htmlOrSvgAsset.type !== 'Html') return insertionPoint;
-
-  // Only <link rel="preload"> for woff2 subset files whose original
-  // font-family is marked for preloading.
-  for (const fontRelation of cssAsset.outgoingRelations) {
-    if (fontRelation.hrefType === 'inline') continue;
-
-    const fontAsset = fontRelation.to;
-    if (
-      fontAsset.contentType !== 'font/woff2' ||
-      !fontRelation.to.url.startsWith(subsetUrl)
-    ) {
-      continue;
-    }
-
-    const originalFontFamily = unquote(
-      fontRelation.node.nodes.find((node) => node.prop === 'font-family').value
-    ).replace(/__subset$/, '');
-    if (
-      !fontUsages.some(
-        (fontUsage) =>
-          fontUsage.fontFamilies.has(originalFontFamily) && fontUsage.preload
-      )
-    ) {
-      continue;
+// Insert <link rel="preload"> hints for every woff2 subset flagged as
+// preload-worthy, so the browser starts fetching them during HTML parse.
+function addSubsetFontPreloads({ cssAsset, fontUsages, htmlOrSvgAsset, subsetUrl, hrefType, insertionPoint, }) {
+    if (htmlOrSvgAsset.type !== 'Html')
+        return insertionPoint;
+    // Only <link rel="preload"> for woff2 subset files whose original
+    // font-family is marked for preloading.
+    for (const fontRelation of cssAsset.outgoingRelations) {
+        if (fontRelation.hrefType === 'inline')
+            continue;
+        const fontAsset = fontRelation.to;
+        if (fontAsset.contentType !== 'font/woff2' ||
+            !fontRelation.to.url.startsWith(subsetUrl)) {
+            continue;
+        }
+        const familyDecl = fontRelation.node.nodes?.find((node) => node.prop === 'font-family');
+        const originalFontFamily = unquote(familyDecl?.value ?? '').replace(/__subset$/, '');
+        if (!fontUsages.some((fontUsage) => fontUsage.fontFamilies.has(originalFontFamily) && fontUsage.preload)) {
+            continue;
+        }
+        const htmlPreloadLink = htmlOrSvgAsset.addRelation({
+            type: 'HtmlPreloadLink',
+            hrefType,
+            to: fontAsset,
+            as: 'font',
+        }, insertionPoint ? 'before' : 'firstInHead', insertionPoint);
+        insertionPoint = insertionPoint || htmlPreloadLink;
     }
-
-    const htmlPreloadLink = htmlOrSvgAsset.addRelation(
-      {
-        type: 'HtmlPreloadLink',
-        hrefType,
-        to: fontAsset,
-        as: 'font',
-      },
-      insertionPoint ? 'before' : 'firstInHead',
-      insertionPoint
-    );
-    insertionPoint = insertionPoint || htmlPreloadLink;
-  }
-  return insertionPoint;
+    return insertionPoint;
 }
-
-async function subsetFonts(
-  assetGraph,
-  {
-    formats = ['woff2'],
-    subsetPath = 'subfont/',
-    omitFallbacks = false,
-    inlineCss,
-    fontDisplay,
-    hrefType = 'rootRelative',
-    onlyInfo,
-    dynamic,
-    console = global.console,
-    text,
-    sourceMaps = false,
-    debug = false,
-    concurrency,
-    chromeArgs = [],
-    cacheDir = null,
-  } = {}
-) {
-  if (!validFontDisplayValues.includes(fontDisplay)) {
-    fontDisplay = undefined;
-  }
-
-  // Pre-warm the WASM pool: start compiling harfbuzz WASM while
-  // collectTextsByPage traces fonts. Compilation (~50-200ms) overlaps
-  // with tracing work rather than appearing on the critical path.
-  // Catch silently — the error will surface when subsetFontWithGlyphs
-  // is actually called, where it's properly handled.
-  subsetFontWithGlyphs.warmup().catch(() => {});
-
-  const subsetUrl = urltools.ensureTrailingSlash(assetGraph.root + subsetPath);
-
-  const timings = {};
-  const trackPhase = makePhaseTracker(console, debug);
-
-  const applySourceMapsPhase = trackPhase('applySourceMaps');
-  if (sourceMaps) {
-    await assetGraph.applySourceMaps({ type: 'Css' });
-  }
-  timings.applySourceMaps = applySourceMapsPhase.end();
-
-  // Only run Google Fonts populate if there are actually Google Fonts
-  // references in the graph. This avoids ~30s of wasted work on sites
-  // that use only self-hosted fonts.
-  const hasGoogleFonts =
-    assetGraph.findRelations({
-      to: { url: { $regex: googleFontsCssUrlRegex } },
+// Skip Google Fonts populate when no Google Fonts references exist —
+// otherwise assetgraph spends ~30s network-walking for nothing on sites
+// that only self-host. Returns whether the populate ran so callers can
+// annotate their phase timing.
+async function populateGoogleFontsIfPresent(assetGraph) {
+    const hasGoogleFonts = assetGraph.findRelations({
+        to: { url: { $regex: googleFontsCssUrlRegex } },
     }).length > 0;
-
-  const googlePopulatePhase = trackPhase('populate (google fonts)');
-  if (hasGoogleFonts) {
+    if (!hasGoogleFonts)
+        return false;
     await assetGraph.populate({
-      followRelations: {
+        followRelations: {
+            $or: [
+                { to: { url: { $regex: googleFontsCssUrlRegex } } },
+                {
+                    type: 'CssFontFaceSrc',
+                    from: { url: { $regex: googleFontsCssUrlRegex } },
+                },
+            ],
+        },
+    });
+    return true;
+}
+// Strip every original @font-face rule when --no-fallbacks is set. The
+// severed assets are returned via the `potentiallyOrphanedAssets` set so
+// the final orphan sweep can remove anything left dangling.
+function removeOriginalFontFaceRules(htmlOrSvgAssets, fontFaceDeclarationsByHtmlOrSvgAsset, potentiallyOrphanedAssets) {
+    for (const htmlOrSvgAsset of htmlOrSvgAssets) {
+        const accumulatedFontFaceDeclarations = fontFaceDeclarationsByHtmlOrSvgAsset.get(htmlOrSvgAsset);
+        if (!accumulatedFontFaceDeclarations)
+            continue;
+        for (const { relations } of accumulatedFontFaceDeclarations) {
+            for (const relation of relations) {
+                potentiallyOrphanedAssets.add(relation.to);
+                if (relation.node.parentNode) {
+                    relation.node.parentNode.removeChild(relation.node);
+                }
+                relation.remove();
+            }
+        }
+        htmlOrSvgAsset.markDirty();
+    }
+}
+// Rewrite CSS source-map relations to the caller's chosen hrefType so they
+// align with the rest of the emitted assets. Only invoked when sourceMaps is
+// enabled — subsetFonts normally skips source-map serialization for speed.
+async function rewriteCssSourceMaps(assetGraph, hrefType) {
+    await assetGraph.serializeSourceMaps(undefined, {
+        type: 'Css',
+        outgoingRelations: {
+            $where: (relations) => relations.some((relation) => relation.type === 'CssSourceMappingUrl'),
+        },
+    });
+    for (const relation of assetGraph.findRelations({
+        type: 'SourceMapSource',
+    })) {
+        relation.hrefType = hrefType;
+    }
+    for (const relation of assetGraph.findRelations({
+        type: 'CssSourceMappingUrl',
+        hrefType: { $in: ['relative', 'inline'] },
+    })) {
+        relation.hrefType = hrefType;
+    }
+}
+// Remove assets whose last incoming relation was severed during subset
+// injection (original @font-face rules, merged Google Fonts CSS, etc.) so
+// the emitted site doesn't ship with dangling files.
+function removeOrphanedAssets(assetGraph, potentiallyOrphanedAssets) {
+    for (const asset of potentiallyOrphanedAssets) {
+        if (asset.incomingRelations.length === 0) {
+            assetGraph.removeAsset(asset);
+        }
+    }
+}
+// Shape the per-page fontUsages into the external fontInfo report: strip
+// internal bookkeeping (subsets buffer, feature-tag scratch) and flatten
+// each page to { assetFileName, fontUsages }.
+function buildFontInfoReport(htmlOrSvgAssetTextsWithProps) {
+    return htmlOrSvgAssetTextsWithProps.map(({ fontUsages, htmlOrSvgAsset }) => ({
+        assetFileName: htmlOrSvgAsset.nonInlineAncestor.urlOrDescription,
+        fontUsages: fontUsages.map((fontUsage) => (({ subsets, hasFontFeatureSettings, fontFeatureTags, ...rest }) => rest)(fontUsage)),
+    }));
+}
+async function subsetFonts(assetGraph, { formats = ['woff2'], subsetPath = 'subfont/', omitFallbacks = false, inlineCss = false, fontDisplay, hrefType = 'rootRelative', onlyInfo, dynamic, console = global.console, text, sourceMaps = false, debug = false, concurrency, chromeArgs = [], cacheDir = null, } = {}) {
+    if (fontDisplay && !validFontDisplayValues.includes(fontDisplay)) {
+        fontDisplay = undefined;
+    }
+    // Pre-warm the WASM pool: start compiling harfbuzz WASM while
+    // collectTextsByPage traces fonts. Compilation (~50-200ms) overlaps
+    // with tracing work rather than appearing on the critical path.
+    // Catch silently — the error will surface when subsetFontWithGlyphs
+    // is actually called, where it's properly handled.
+    subsetFontWithGlyphs.warmup().catch(() => { });
+    const subsetUrl = urltools.ensureTrailingSlash(assetGraph.root + subsetPath);
+    const timings = {};
+    const trackPhase = (0, progress_1.makePhaseTracker)(console, debug);
+    const applySourceMapsPhase = trackPhase('applySourceMaps');
+    if (sourceMaps) {
+        await assetGraph.applySourceMaps({ type: 'Css' });
+    }
+    timings.applySourceMaps = applySourceMapsPhase.end();
+    const googlePopulatePhase = trackPhase('populate (google fonts)');
+    const hasGoogleFonts = await populateGoogleFontsIfPresent(assetGraph);
+    timings['populate (google fonts)'] = googlePopulatePhase.end(hasGoogleFonts ? null : 'skipped, no Google Fonts found');
+    const htmlOrSvgAssets = assetGraph.findAssets({
         $or: [
-          {
-            to: {
-              url: { $regex: googleFontsCssUrlRegex },
+            {
+                type: 'Html',
+                isInline: false,
             },
-          },
-          {
-            type: 'CssFontFaceSrc',
-            from: {
-              url: { $regex: googleFontsCssUrlRegex },
+            {
+                type: 'Svg',
             },
-          },
         ],
-      },
     });
-  }
-  timings['populate (google fonts)'] = googlePopulatePhase.end(
-    hasGoogleFonts ? null : 'skipped, no Google Fonts found'
-  );
-
-  const htmlOrSvgAssets = assetGraph.findAssets({
-    $or: [
-      {
-        type: 'Html',
-        isInline: false,
-      },
-      {
-        type: 'Svg',
-      },
-    ],
-  });
-
-  const collectPhase = trackPhase(
-    `collectTextsByPage (${htmlOrSvgAssets.length} pages)`
-  );
-  const {
-    htmlOrSvgAssetTextsWithProps,
-    fontFaceDeclarationsByHtmlOrSvgAsset,
-    subTimings,
-  } = await collectTextsByPage(assetGraph, htmlOrSvgAssets, {
-    text,
-    console,
-    dynamic,
-    debug,
-    concurrency,
-    chromeArgs,
-  });
-  timings.collectTextsByPage = collectPhase.end();
-  timings.collectTextsByPageDetails = subTimings;
-
-  const omitFallbacksPhase = trackPhase('omitFallbacks processing');
-
-  const potentiallyOrphanedAssets = new Set();
-  if (omitFallbacks) {
-    for (const htmlOrSvgAsset of htmlOrSvgAssets) {
-      const accumulatedFontFaceDeclarations =
-        fontFaceDeclarationsByHtmlOrSvgAsset.get(htmlOrSvgAsset);
-      // Remove the original @font-face rules:
-      for (const { relations } of accumulatedFontFaceDeclarations) {
-        for (const relation of relations) {
-          potentiallyOrphanedAssets.add(relation.to);
-          if (relation.node.parentNode) {
-            relation.node.parentNode.removeChild(relation.node);
-          }
-          relation.remove();
+    const collectPhase = trackPhase(`collectTextsByPage (${htmlOrSvgAssets.length} pages)`);
+    const { htmlOrSvgAssetTextsWithProps, fontFaceDeclarationsByHtmlOrSvgAsset, subTimings, } = await collectTextsByPage(assetGraph, htmlOrSvgAssets, {
+        text,
+        console,
+        dynamic,
+        debug,
+        concurrency,
+        chromeArgs,
+    });
+    timings.collectTextsByPage = collectPhase.end();
+    timings.collectTextsByPageDetails = subTimings;
+    const omitFallbacksPhase = trackPhase('omitFallbacks processing');
+    const potentiallyOrphanedAssets = new Set();
+    if (omitFallbacks) {
+        removeOriginalFontFaceRules(htmlOrSvgAssets, fontFaceDeclarationsByHtmlOrSvgAsset, potentiallyOrphanedAssets);
+    }
+    timings['omitFallbacks processing'] = omitFallbacksPhase.end();
+    const codepointPhase = trackPhase('codepoint generation');
+    if (fontDisplay) {
+        for (const htmlOrSvgAssetTextWithProps of htmlOrSvgAssetTextsWithProps) {
+            for (const fontUsage of htmlOrSvgAssetTextWithProps.fontUsages) {
+                fontUsage.props['font-display'] = fontDisplay;
+            }
         }
-      }
-      htmlOrSvgAsset.markDirty();
     }
-  }
-
-  timings['omitFallbacks processing'] = omitFallbacksPhase.end();
-
-  const codepointPhase = trackPhase('codepoint generation');
-
-  if (fontDisplay) {
-    for (const htmlOrSvgAssetTextWithProps of htmlOrSvgAssetTextsWithProps) {
-      for (const fontUsage of htmlOrSvgAssetTextWithProps.fontUsages) {
-        fontUsage.props['font-display'] = fontDisplay;
-      }
+    // Pre-compute the global codepoints (original, used, unused) once per fontUrl
+    // since fontUsage.text is the same global union on every page.
+    // Pre-index all loaded assets by URL for O(1) lookups instead of O(n) scans.
+    const loadedAssetsByUrl = new Map();
+    for (const asset of assetGraph.findAssets({ isLoaded: true })) {
+        if (asset.url)
+            loadedAssetsByUrl.set(asset.url, asset);
     }
-  }
-
-  // Pre-compute the global codepoints (original, used, unused) once per fontUrl
-  // since fontUsage.text is the same global union on every page.
-  // Pre-index all loaded assets by URL for O(1) lookups instead of O(n) scans.
-  const loadedAssetsByUrl = new Map();
-  for (const asset of assetGraph.findAssets({ isLoaded: true })) {
-    if (asset.url) loadedAssetsByUrl.set(asset.url, asset);
-  }
-  const codepointFontAssetByUrl = new Map();
-  for (const htmlOrSvgAssetTextWithProps of htmlOrSvgAssetTextsWithProps) {
-    for (const fontUsage of htmlOrSvgAssetTextWithProps.fontUsages) {
-      if (
-        fontUsage.fontUrl &&
-        !codepointFontAssetByUrl.has(fontUsage.fontUrl)
-      ) {
-        const originalFont = loadedAssetsByUrl.get(fontUsage.fontUrl);
-        if (originalFont) {
-          codepointFontAssetByUrl.set(fontUsage.fontUrl, originalFont);
+    const codepointFontAssetByUrl = new Map();
+    for (const htmlOrSvgAssetTextWithProps of htmlOrSvgAssetTextsWithProps) {
+        for (const fontUsage of htmlOrSvgAssetTextWithProps.fontUsages) {
+            if (fontUsage.fontUrl &&
+                !codepointFontAssetByUrl.has(fontUsage.fontUrl)) {
+                const originalFont = loadedAssetsByUrl.get(fontUsage.fontUrl);
+                if (originalFont) {
+                    codepointFontAssetByUrl.set(fontUsage.fontUrl, originalFont);
+                }
+            }
         }
-      }
     }
-  }
-
-  // getFontInfo internally serializes harfbuzzjs WASM calls (which are
-  // not concurrency-safe), so Promise.all here just queues them up
-  // and avoids awaiting each individually in the loop below.
-  const fontInfoPromises = new Map();
-  for (const [fontUrl, fontAsset] of codepointFontAssetByUrl) {
-    if (fontAsset.isLoaded) {
-      fontInfoPromises.set(
-        fontUrl,
-        getFontInfo(fontAsset.rawSrc).catch((err) => {
-          err.asset = err.asset || fontAsset;
-          assetGraph.warn(err);
-          return null;
-        })
-      );
-    }
-  }
-  const fontInfoResults = new Map(
-    await Promise.all(
-      [...fontInfoPromises].map(async ([key, promise]) => [key, await promise])
-    )
-  );
-
-  // Build global codepoints synchronously from pre-fetched results
-  const globalCodepointsByFontUrl = new Map();
-  const codepointsCache = new Map();
-  for (const htmlOrSvgAssetTextWithProps of htmlOrSvgAssetTextsWithProps) {
-    for (const fontUsage of htmlOrSvgAssetTextWithProps.fontUsages) {
-      let cached = globalCodepointsByFontUrl.get(fontUsage.fontUrl);
-      if (!cached) {
-        cached = { originalCodepoints: null };
-        const fontInfo = fontInfoResults.get(fontUsage.fontUrl);
-        if (fontInfo) {
-          cached.originalCodepoints = fontInfo.characterSet;
-          cached.usedCodepoints = getCodepoints(fontUsage.text);
-          const usedCodepointsSet = new Set(cached.usedCodepoints);
-          cached.unusedCodepoints = cached.originalCodepoints.filter(
-            (n) => !usedCodepointsSet.has(n)
-          );
-        }
-        globalCodepointsByFontUrl.set(fontUsage.fontUrl, cached);
-      }
-
-      if (cached.originalCodepoints) {
-        // Cache getCodepoints result by pageText string to avoid
-        // recomputing for pages with identical text per font
-        let pageCodepoints = codepointsCache.get(fontUsage.pageText);
-        if (!pageCodepoints) {
-          pageCodepoints = getCodepoints(fontUsage.pageText);
-          codepointsCache.set(fontUsage.pageText, pageCodepoints);
+    const fontInfoPromises = new Map();
+    for (const [fontUrl, fontAsset] of codepointFontAssetByUrl) {
+        if (fontAsset.isLoaded) {
+            fontInfoPromises.set(fontUrl, 
+            // Catch-clause idiom: TypeScript types caught errors as `unknown`.
+            // eslint-disable-next-line no-restricted-syntax
+            getFontInfo(fontAsset.rawSrc).catch((rawErr) => {
+                const err = rawErr;
+                err.asset = err.asset || fontAsset;
+                assetGraph.warn(err);
+                return null;
+            }));
         }
-        fontUsage.codepoints = {
-          original: cached.originalCodepoints,
-          used: cached.usedCodepoints,
-          unused: cached.unusedCodepoints,
-          page: pageCodepoints,
-        };
-      } else {
-        fontUsage.codepoints = {
-          original: [],
-          used: [],
-          unused: [],
-          page: [],
-        };
-      }
     }
-  }
-
-  timings['codepoint generation'] = codepointPhase.end();
-
-  if (onlyInfo) {
-    return {
-      fontInfo: htmlOrSvgAssetTextsWithProps.map(
-        ({ fontUsages, htmlOrSvgAsset }) => ({
-          assetFileName: htmlOrSvgAsset.nonInlineAncestor.urlOrDescription,
-          fontUsages: fontUsages.map((fontUsage) =>
-            (({ hasFontFeatureSettings, fontFeatureTags, ...rest }) => rest)(
-              fontUsage
-            )
-          ),
-        })
-      ),
-      timings,
-    };
-  }
-
-  const variationPhase = trackPhase('variation axis usage');
-  const { seenAxisValuesByFontUrlAndAxisName } = getVariationAxisUsage(
-    htmlOrSvgAssetTextsWithProps,
-    parseFontWeightRange,
-    parseFontStretchRange
-  );
-  timings['variation axis usage'] = variationPhase.end();
-
-  // Generate subsets:
-  if (console) {
-    const uniqueFontUrls = countUniqueFontUrls(htmlOrSvgAssetTextsWithProps);
-    if (uniqueFontUrls > 0) {
-      console.log(
-        `  Subsetting ${uniqueFontUrls} unique font file${uniqueFontUrls === 1 ? '' : 's'}...`
-      );
-    }
-  }
-  const subsetPhase = trackPhase('getSubsetsForFontUsage');
-  await getSubsetsForFontUsage(
-    assetGraph,
-    htmlOrSvgAssetTextsWithProps,
-    formats,
-    seenAxisValuesByFontUrlAndAxisName,
-    cacheDir,
-    console,
-    debug
-  );
-  timings.getSubsetsForFontUsage = subsetPhase.end();
-
-  const warnGlyphsPhase = trackPhase('warnAboutMissingGlyphs');
-  await warnAboutMissingGlyphs(htmlOrSvgAssetTextsWithProps, assetGraph);
-  timings.warnAboutMissingGlyphs = warnGlyphsPhase.end();
-
-  // Insert subsets:
-
-  // Pre-compute which fontUrls are used (with text) on every page,
-  // so we can avoid O(pages × fontUsages) checks inside the font loop.
-  const fontUrlsUsedOnEveryPage = new Set();
-  if (htmlOrSvgAssetTextsWithProps.length > 0) {
-    // Start with all fontUrls from the first page
-    const firstPageFontUrls = new Set();
-    for (const fu of htmlOrSvgAssetTextsWithProps[0].fontUsages) {
-      if (fu.pageText) firstPageFontUrls.add(fu.fontUrl);
+    const fontInfoResults = new Map(await Promise.all([...fontInfoPromises].map(async ([key, promise]) => [key, await promise])));
+    // Build global codepoints synchronously from pre-fetched results
+    const globalCodepointsByFontUrl = new Map();
+    const codepointsCache = new Map();
+    for (const htmlOrSvgAssetTextWithProps of htmlOrSvgAssetTextsWithProps) {
+        for (const fontUsage of htmlOrSvgAssetTextWithProps.fontUsages) {
+            let cached = globalCodepointsByFontUrl.get(fontUsage.fontUrl);
+            if (!cached) {
+                cached = { originalCodepoints: null };
+                const fontInfo = fontUsage.fontUrl
+                    ? fontInfoResults.get(fontUsage.fontUrl)
+                    : undefined;
+                if (fontInfo) {
+                    const originalCodepoints = fontInfo.characterSet;
+                    const usedCodepoints = (0, fontFaceHelpers_1.getCodepoints)(fontUsage.text);
+                    const usedCodepointsSet = new Set(usedCodepoints);
+                    cached.originalCodepoints = originalCodepoints;
+                    cached.usedCodepoints = usedCodepoints;
+                    cached.unusedCodepoints = originalCodepoints.filter((n) => !usedCodepointsSet.has(n));
+                }
+                globalCodepointsByFontUrl.set(fontUsage.fontUrl, cached);
+            }
+            if (cached.originalCodepoints) {
+                // Cache getCodepoints result by pageText string to avoid
+                // recomputing for pages with identical text per font
+                const pageText = fontUsage.pageText ?? '';
+                let pageCodepoints = codepointsCache.get(pageText);
+                if (!pageCodepoints) {
+                    pageCodepoints = (0, fontFaceHelpers_1.getCodepoints)(pageText);
+                    codepointsCache.set(pageText, pageCodepoints);
+                }
+                fontUsage.codepoints = {
+                    original: cached.originalCodepoints,
+                    used: cached.usedCodepoints ?? [],
+                    unused: cached.unusedCodepoints ?? [],
+                    page: pageCodepoints,
+                };
+            }
+            else {
+                fontUsage.codepoints = {
+                    original: [],
+                    used: [],
+                    unused: [],
+                    page: [],
+                };
+            }
+        }
     }
-    for (const fontUrl of firstPageFontUrls) {
-      if (
-        htmlOrSvgAssetTextsWithProps.every(({ fontUsages }) =>
-          fontUsages.some((fu) => fu.pageText && fu.fontUrl === fontUrl)
-        )
-      ) {
-        fontUrlsUsedOnEveryPage.add(fontUrl);
-      }
+    timings['codepoint generation'] = codepointPhase.end();
+    if (onlyInfo) {
+        return {
+            fontInfo: htmlOrSvgAssetTextsWithProps.map(({ fontUsages, htmlOrSvgAsset }) => ({
+                assetFileName: htmlOrSvgAsset.nonInlineAncestor.urlOrDescription,
+                fontUsages: fontUsages.map((fontUsage) => (({ hasFontFeatureSettings, fontFeatureTags, ...rest }) => rest)(fontUsage)),
+            })),
+            timings,
+        };
     }
-  }
-
-  // Cache subset CSS assets by their source text to avoid redundant
-  // addAsset/minify/removeAsset cycles for pages sharing identical CSS.
-  const subsetCssAssetCache = new Map();
-
-  // Pre-index relations by source asset to avoid O(allRelations) scans
-  // in the per-page injection loop below. Build indices once, then use
-  // O(1) lookups per page instead of repeated assetGraph.findRelations.
-  const styleRelsByAsset = new Map();
-  const noscriptRelsByAsset = new Map();
-  const preloadRelsByAsset = new Map();
-  const relTypeToIndex = {
-    HtmlStyle: styleRelsByAsset,
-    SvgStyle: styleRelsByAsset,
-    HtmlNoscript: noscriptRelsByAsset,
-    HtmlPrefetchLink: preloadRelsByAsset,
-    HtmlPreloadLink: preloadRelsByAsset,
-  };
-  for (const relation of assetGraph.findRelations({
-    type: { $in: Object.keys(relTypeToIndex) },
-  })) {
-    const index = relTypeToIndex[relation.type];
-    const from = relation.from;
-    if (!index.has(from)) index.set(from, []);
-    index.get(from).push(relation);
-  }
-
-  const insertPhase = trackPhase(
-    `insert subsets loop (${htmlOrSvgAssetTextsWithProps.length} pages)`
-  );
-  let numFontUsagesWithSubset = 0;
-  for (const {
-    htmlOrSvgAsset,
-    fontUsages,
-    accumulatedFontFaceDeclarations,
-  } of htmlOrSvgAssetTextsWithProps) {
-    const styleRels = styleRelsByAsset.get(htmlOrSvgAsset) || [];
-    let insertionPoint = styleRels[0];
-
-    // Fall back to inserting before a <noscript> that contains a stylesheet
-    // when no direct stylesheet relation exists (assetgraph#1251)
-    if (!insertionPoint && htmlOrSvgAsset.type === 'Html') {
-      for (const htmlNoScript of noscriptRelsByAsset.get(htmlOrSvgAsset) ||
-        []) {
-        const noscriptStyleRels = styleRelsByAsset.get(htmlNoScript.to) || [];
-        if (noscriptStyleRels.length > 0) {
-          insertionPoint = htmlNoScript;
-          break;
+    const variationPhase = trackPhase('variation axis usage');
+    const { seenAxisValuesByFontUrlAndAxisName } = (0, variationAxes_1.getVariationAxisUsage)(htmlOrSvgAssetTextsWithProps, fontFaceHelpers_1.parseFontWeightRange, fontFaceHelpers_1.parseFontStretchRange);
+    timings['variation axis usage'] = variationPhase.end();
+    // Generate subsets:
+    if (console) {
+        const uniqueFontUrls = countUniqueFontUrls(htmlOrSvgAssetTextsWithProps);
+        if (uniqueFontUrls > 0) {
+            console.log(`  Subsetting ${uniqueFontUrls} unique font file${uniqueFontUrls === 1 ? '' : 's'}...`);
         }
-      }
     }
-    const subsetFontUsages = fontUsages.filter(
-      (fontUsage) => fontUsage.subsets
-    );
-    const subsetFontUsagesSet = new Set(subsetFontUsages);
-    const unsubsettedFontUsages = fontUsages.filter(
-      (fontUsage) => !subsetFontUsagesSet.has(fontUsage)
-    );
-
-    // Remove all existing preload hints to fonts that might have new subsets
-    const fontUrls = new Set(fontUsages.map((fu) => fu.fontUrl));
-    for (const relation of preloadRelsByAsset.get(htmlOrSvgAsset) || []) {
-      if (!relation.to || !fontUrls.has(relation.to.url)) continue;
-
-      if (relation.type === 'HtmlPrefetchLink') {
-        const err = new Error(
-          `Detached ${relation.node.outerHTML}. Will be replaced with preload with JS fallback.\nIf you feel this is wrong, open an issue at https://github.com/alexander-turner/subfont/issues`
-        );
-        err.asset = relation.from;
-        err.relation = relation;
-        assetGraph.info(err);
-      }
-      relation.detach();
+    const subsetPhase = trackPhase('getSubsetsForFontUsage');
+    await (0, subsetGeneration_1.getSubsetsForFontUsage)(assetGraph, htmlOrSvgAssetTextsWithProps, formats, seenAxisValuesByFontUrlAndAxisName, cacheDir, console, debug);
+    timings.getSubsetsForFontUsage = subsetPhase.end();
+    const warnGlyphsPhase = trackPhase('warnAboutMissingGlyphs');
+    await warnAboutMissingGlyphs(htmlOrSvgAssetTextsWithProps, assetGraph);
+    timings.warnAboutMissingGlyphs = warnGlyphsPhase.end();
+    // Insert subsets:
+    // Pre-compute which fontUrls are used (with text) on every page.
+    // Set intersection: O(pages × fonts_per_page) vs the old every+some approach.
+    const fontUrlsUsedOnEveryPage = new Set();
+    if (htmlOrSvgAssetTextsWithProps.length > 0) {
+        const firstPageFontUrls = new Set();
+        for (const fu of htmlOrSvgAssetTextsWithProps[0]
+            .fontUsages) {
+            if (fu.pageText && fu.fontUrl)
+                firstPageFontUrls.add(fu.fontUrl);
+        }
+        for (const fontUrl of firstPageFontUrls) {
+            fontUrlsUsedOnEveryPage.add(fontUrl);
+        }
+        for (let i = 1; i < htmlOrSvgAssetTextsWithProps.length; i++) {
+            const pageFontUrls = new Set();
+            for (const fu of htmlOrSvgAssetTextsWithProps[i]
+                .fontUsages) {
+                if (fu.pageText && fu.fontUrl)
+                    pageFontUrls.add(fu.fontUrl);
+            }
+            for (const fontUrl of fontUrlsUsedOnEveryPage) {
+                if (!pageFontUrls.has(fontUrl)) {
+                    fontUrlsUsedOnEveryPage.delete(fontUrl);
+                }
+            }
+        }
     }
-
-    const unsubsettedFontUsagesToPreload = unsubsettedFontUsages.filter(
-      (fontUsage) => fontUsage.preload
-    );
-
-    if (unsubsettedFontUsagesToPreload.length > 0) {
-      // Insert <link rel="preload">
-      for (const fontUsage of unsubsettedFontUsagesToPreload) {
-        // Always preload unsubsetted font files, they might be any format, so can't be clever here
-        const preloadRelation = htmlOrSvgAsset.addRelation(
-          {
-            type: 'HtmlPreloadLink',
+    // Cache subset CSS assets by their source text to avoid redundant
+    // addAsset/minify/removeAsset cycles for pages sharing identical CSS.
+    const subsetCssAssetCache = new Map();
+    // Cache the heavy CSS-text assembly (including base64-encoded font data)
+    // keyed by the shared accumulatedFontFaceDeclarations array. Pages grouped
+    // under the same stylesheet config produce byte-identical output, so this
+    // collapses the per-page string build from O(pages) to O(unique configs).
+    const subsetCssTextCache = new WeakMap();
+    // Pre-index relations by source asset to avoid O(allRelations) scans
+    // in the per-page injection loop below. Build indices once, then use
+    // O(1) lookups per page instead of repeated assetGraph.findRelations.
+    const styleRelsByAsset = new Map();
+    const noscriptRelsByAsset = new Map();
+    const preloadRelsByAsset = new Map();
+    const relTypeToIndex = {
+        HtmlStyle: styleRelsByAsset,
+        SvgStyle: styleRelsByAsset,
+        HtmlNoscript: noscriptRelsByAsset,
+        HtmlPrefetchLink: preloadRelsByAsset,
+        HtmlPreloadLink: preloadRelsByAsset,
+    };
+    for (const relation of assetGraph.findRelations({
+        type: { $in: Object.keys(relTypeToIndex) },
+    })) {
+        const index = relTypeToIndex[relation.type];
+        const from = relation.from;
+        if (!index.has(from))
+            index.set(from, []);
+        index.get(from).push(relation);
+    }
+    const insertPhase = trackPhase(`insert subsets loop (${htmlOrSvgAssetTextsWithProps.length} pages)`);
+    let numFontUsagesWithSubset = 0;
+    for (const { htmlOrSvgAsset, fontUsages, accumulatedFontFaceDeclarations, } of htmlOrSvgAssetTextsWithProps) {
+        const styleRels = styleRelsByAsset.get(htmlOrSvgAsset) || [];
+        let insertionPoint = styleRels[0];
+        // Fall back to inserting before a <noscript> that contains a stylesheet
+        // when no direct stylesheet relation exists (assetgraph#1251)
+        if (!insertionPoint && htmlOrSvgAsset.type === 'Html') {
+            for (const htmlNoScript of noscriptRelsByAsset.get(htmlOrSvgAsset) ||
+                []) {
+                const noscriptStyleRels = styleRelsByAsset.get(htmlNoScript.to) || [];
+                if (noscriptStyleRels.length > 0) {
+                    insertionPoint = htmlNoScript;
+                    break;
+                }
+            }
+        }
+        const subsetFontUsages = fontUsages.filter((fontUsage) => fontUsage.subsets);
+        const subsetFontUsagesSet = new Set(subsetFontUsages);
+        const unsubsettedFontUsages = fontUsages.filter((fontUsage) => !subsetFontUsagesSet.has(fontUsage));
+        // Remove all existing preload hints to fonts that might have new subsets
+        const fontUrls = new Set(fontUsages.map((fu) => fu.fontUrl));
+        for (const relation of preloadRelsByAsset.get(htmlOrSvgAsset) || []) {
+            if (!relation.to || !fontUrls.has(relation.to.url))
+                continue;
+            if (relation.type === 'HtmlPrefetchLink') {
+                const err = new Error(`Detached ${relation.node.outerHTML}. Will be replaced with preload with JS fallback.\nIf you feel this is wrong, open an issue at https://github.com/alexander-turner/subfont/issues`);
+                err.asset = relation.from;
+                err.relation = relation;
+                assetGraph.info(err);
+            }
+            relation.detach();
+        }
+        const unsubsettedFontUsagesToPreload = unsubsettedFontUsages.filter((fontUsage) => fontUsage.preload);
+        if (unsubsettedFontUsagesToPreload.length > 0) {
+            // Insert <link rel="preload">
+            for (const fontUsage of unsubsettedFontUsagesToPreload) {
+                // Always preload unsubsetted font files, they might be any format, so can't be clever here
+                const preloadRelation = htmlOrSvgAsset.addRelation({
+                    type: 'HtmlPreloadLink',
+                    hrefType,
+                    to: fontUsage.fontUrl,
+                    as: 'font',
+                }, insertionPoint ? 'before' : 'firstInHead', insertionPoint);
+                insertionPoint = insertionPoint || preloadRelation;
+            }
+        }
+        if (subsetFontUsages.length === 0) {
+            continue;
+        }
+        numFontUsagesWithSubset += subsetFontUsages.length;
+        let cssTextParts = subsetCssTextCache.get(accumulatedFontFaceDeclarations);
+        if (!cssTextParts) {
+            cssTextParts = {
+                subset: (0, fontFaceHelpers_1.getFontUsageStylesheet)(subsetFontUsages),
+                unused: (0, fontFaceHelpers_1.getUnusedVariantsStylesheet)(fontUsages, accumulatedFontFaceDeclarations),
+            };
+            subsetCssTextCache.set(accumulatedFontFaceDeclarations, cssTextParts);
+        }
+        let subsetCssText = cssTextParts.subset;
+        const unusedVariantsCss = cssTextParts.unused;
+        if (!inlineCss && !omitFallbacks) {
+            // This can go into the same stylesheet because we won't reload all __subset suffixed families in the JS preload fallback
+            subsetCssText += unusedVariantsCss;
+        }
+        const cssAsset = await getOrCreateSubsetCssAsset({
+            assetGraph,
+            subsetCssText,
+            subsetFontUsages,
+            formats,
+            subsetUrl,
             hrefType,
-            to: fontUsage.fontUrl,
-            as: 'font',
-          },
-          insertionPoint ? 'before' : 'firstInHead',
-          insertionPoint
-        );
-        insertionPoint = insertionPoint || preloadRelation;
-      }
-    }
-
-    if (subsetFontUsages.length === 0) {
-      continue;
-    }
-    numFontUsagesWithSubset += subsetFontUsages.length;
-
-    let subsetCssText = getFontUsageStylesheet(subsetFontUsages);
-    const unusedVariantsCss = getUnusedVariantsStylesheet(
-      fontUsages,
-      accumulatedFontFaceDeclarations
-    );
-    if (!inlineCss && !omitFallbacks) {
-      // This can go into the same stylesheet because we won't reload all __subset suffixed families in the JS preload fallback
-      subsetCssText += unusedVariantsCss;
-    }
-
-    const cssAsset = await getOrCreateSubsetCssAsset({
-      assetGraph,
-      subsetCssText,
-      subsetFontUsages,
-      formats,
-      subsetUrl,
-      hrefType,
-      inlineCss,
-      fontUrlsUsedOnEveryPage,
-      numPages: htmlOrSvgAssetTextsWithProps.length,
-      subsetCssAssetCache,
-    });
-
-    insertionPoint = addSubsetFontPreloads({
-      cssAsset,
-      fontUsages,
-      htmlOrSvgAsset,
-      subsetUrl,
-      hrefType,
-      insertionPoint,
-    });
-    const cssRelation = htmlOrSvgAsset.addRelation(
-      {
-        type: `${htmlOrSvgAsset.type}Style`,
-        hrefType:
-          inlineCss || htmlOrSvgAsset.type === 'Svg' ? 'inline' : hrefType,
-        to: cssAsset,
-      },
-      insertionPoint ? 'before' : 'firstInHead',
-      insertionPoint
-    );
-    insertionPoint = insertionPoint || cssRelation;
-
-    if (!omitFallbacks && inlineCss && unusedVariantsCss) {
-      // The fallback CSS for unused variants needs to go into its own stylesheet after the crude version of the JS-based preload "polyfill"
-      const cssAsset = htmlOrSvgAsset.addRelation(
-        {
-          type: 'HtmlStyle',
-          to: {
-            type: 'Css',
-            text: unusedVariantsCss,
-          },
-        },
-        'after',
-        cssRelation
-      ).to;
-      for (const relation of cssAsset.outgoingRelations) {
-        relation.hrefType = hrefType;
-      }
-    }
-  }
-
-  timings['insert subsets loop'] = insertPhase.end();
-
-  if (numFontUsagesWithSubset === 0) {
-    return { fontInfo: [], timings };
-  }
-
-  const lazyFallbackPhase = trackPhase('lazy load fallback CSS');
-  const relationsToRemove = new Set();
-
-  // Lazy load the original @font-face declarations of self-hosted fonts (unless omitFallbacks)
-  const originalRelations = new Set();
-  const fallbackCssAssetCache = new Map();
-  for (const htmlOrSvgAsset of htmlOrSvgAssets) {
-    const accumulatedFontFaceDeclarations =
-      fontFaceDeclarationsByHtmlOrSvgAsset.get(htmlOrSvgAsset);
-    const containedRelationsByFontFaceRule = new Map();
-    for (const { relations } of accumulatedFontFaceDeclarations) {
-      for (const relation of relations) {
-        if (
-          relation.from.hostname === 'fonts.googleapis.com' || // Google Web Fonts handled separately below
-          containedRelationsByFontFaceRule.has(relation.node)
-        ) {
-          continue;
+            inlineCss,
+            fontUrlsUsedOnEveryPage,
+            numPages: htmlOrSvgAssetTextsWithProps.length,
+            subsetCssAssetCache,
+        });
+        insertionPoint = addSubsetFontPreloads({
+            cssAsset,
+            fontUsages,
+            htmlOrSvgAsset,
+            subsetUrl,
+            hrefType,
+            insertionPoint,
+        });
+        const cssRelation = htmlOrSvgAsset.addRelation({
+            type: `${htmlOrSvgAsset.type}Style`,
+            hrefType: inlineCss || htmlOrSvgAsset.type === 'Svg' ? 'inline' : hrefType,
+            to: cssAsset,
+        }, insertionPoint ? 'before' : 'firstInHead', insertionPoint);
+        insertionPoint = insertionPoint || cssRelation;
+        if (!omitFallbacks && inlineCss && unusedVariantsCss) {
+            // The fallback CSS for unused variants needs to go into its own stylesheet after the crude version of the JS-based preload "polyfill"
+            const cssAsset = htmlOrSvgAsset.addRelation({
+                type: 'HtmlStyle',
+                to: {
+                    type: 'Css',
+                    text: unusedVariantsCss,
+                },
+            }, 'after', cssRelation).to;
+            for (const relation of cssAsset.outgoingRelations) {
+                relation.hrefType = hrefType;
+            }
         }
-        originalRelations.add(relation);
-        containedRelationsByFontFaceRule.set(
-          relation.node,
-          relation.from.outgoingRelations.filter(
-            (otherRelation) => otherRelation.node === relation.node
-          )
-        );
-      }
     }
-
-    if (
-      containedRelationsByFontFaceRule.size === 0 ||
-      omitFallbacks ||
-      htmlOrSvgAsset.type !== 'Html'
-    ) {
-      continue;
+    timings['insert subsets loop'] = insertPhase.end();
+    if (numFontUsagesWithSubset === 0) {
+        return { fontInfo: [], timings };
     }
-
-    // Group @font-face rules by their enclosing @media context so the
-    // fallback CSS preserves the original media-conditional loading.
-    // Walk up the ancestor chain in case the rule is nested (e.g.
-    // inside @supports inside @media).
-    const rulesByMedia = new Map(); // media params (or '') → [cssText, ...]
-    for (const rule of containedRelationsByFontFaceRule.keys()) {
-      let mediaKey = '';
-      let ancestor = rule.parent;
-      while (ancestor) {
-        if (
-          ancestor.type === 'atrule' &&
-          ancestor.name.toLowerCase() === 'media'
-        ) {
-          mediaKey = ancestor.params;
-          break;
+    const lazyFallbackPhase = trackPhase('lazy load fallback CSS');
+    const relationsToRemove = new Set();
+    // Lazy load the original @font-face declarations of self-hosted fonts (unless omitFallbacks)
+    const originalRelations = new Set();
+    const fallbackCssAssetCache = new Map();
+    for (const htmlOrSvgAsset of htmlOrSvgAssets) {
+        const accumulatedFontFaceDeclarations = fontFaceDeclarationsByHtmlOrSvgAsset.get(htmlOrSvgAsset);
+        if (!accumulatedFontFaceDeclarations)
+            continue;
+        const containedRelationsByFontFaceRule = new Map();
+        for (const { relations } of accumulatedFontFaceDeclarations) {
+            for (const relation of relations) {
+                if (relation.from.hostname ===
+                    'fonts.googleapis.com' || // Google Web Fonts handled separately below
+                    containedRelationsByFontFaceRule.has(relation.node)) {
+                    continue;
+                }
+                originalRelations.add(relation);
+                containedRelationsByFontFaceRule.set(relation.node, relation.from.outgoingRelations.filter((otherRelation) => otherRelation.node === relation.node));
+            }
         }
-        ancestor = ancestor.parent;
-      }
-      if (!rulesByMedia.has(mediaKey)) rulesByMedia.set(mediaKey, []);
-      rulesByMedia
-        .get(mediaKey)
-        .push(
-          getFontFaceDeclarationText(
-            rule,
-            containedRelationsByFontFaceRule.get(rule)
-          )
-        );
-    }
-    let fallbackCssText = '';
-    for (const [media, texts] of rulesByMedia) {
-      if (media) {
-        fallbackCssText += `@media ${media}{${texts.join('')}}`;
-      } else {
-        fallbackCssText += texts.join('');
-      }
-    }
-
-    let cssAsset = fallbackCssAssetCache.get(fallbackCssText);
-    if (!cssAsset) {
-      cssAsset = assetGraph.addAsset({
-        type: 'Css',
-        text: fallbackCssText,
-      });
-      for (const relation of cssAsset.outgoingRelations) {
-        relation.hrefType = hrefType;
-      }
-      await cssAsset.minify();
-      cssAsset.url = `${subsetUrl}fallback-${cssAsset.md5Hex.slice(0, 10)}.css`;
-      fallbackCssAssetCache.set(fallbackCssText, cssAsset);
-    }
-
-    // Create a <link rel="stylesheet"> that asyncLoadStyleRelationWithFallback can convert to async with noscript fallback:
-    const fallbackHtmlStyle = htmlOrSvgAsset.addRelation({
-      type: 'HtmlStyle',
-      to: cssAsset,
-    });
-
-    asyncLoadStyleRelationWithFallback(
-      htmlOrSvgAsset,
-      fallbackHtmlStyle,
-      hrefType
-    );
-    relationsToRemove.add(fallbackHtmlStyle);
-  }
-
-  timings['lazy load fallback CSS'] = lazyFallbackPhase.end();
-
-  const removeFontFacePhase = trackPhase('remove original @font-face');
-
-  // Remove the original @font-face blocks, and don't leave behind empty stylesheets:
-  const maybeEmptyCssAssets = new Set();
-  for (const relation of originalRelations) {
-    const cssAsset = relation.from;
-    if (relation.node.parent) {
-      relation.node.parent.removeChild(relation.node);
-    }
-    relation.remove();
-    cssAsset.markDirty();
-    maybeEmptyCssAssets.add(cssAsset);
-  }
-
-  for (const cssAsset of maybeEmptyCssAssets) {
-    if (cssAssetIsEmpty(cssAsset)) {
-      for (const incomingRelation of cssAsset.incomingRelations) {
-        incomingRelation.detach();
-      }
-      assetGraph.removeAsset(cssAsset);
-    }
-  }
-
-  timings['remove original @font-face'] = removeFontFacePhase.end();
-
-  const googleCleanupPhase = trackPhase('Google Fonts + cleanup');
-
-  // Async load Google Web Fonts CSS
-  const googleFontStylesheets = assetGraph.findAssets({
-    type: 'Css',
-    url: { $regex: googleFontsCssUrlRegex },
-  });
-  const selfHostedGoogleCssByUrl = new Map();
-  for (const googleFontStylesheet of googleFontStylesheets) {
-    const seenPages = new Set(); // Only do the work once for each font on each page
-    for (const googleFontStylesheetRelation of googleFontStylesheet.incomingRelations) {
-      let htmlParents;
-
-      if (googleFontStylesheetRelation.type === 'CssImport') {
-        // Gather Html parents. Relevant if we are dealing with CSS @import relations
-        htmlParents = getParents(googleFontStylesheetRelation.to, {
-          type: { $in: ['Html', 'Svg'] },
-          isInline: false,
-          isLoaded: true,
-        });
-      } else if (
-        ['Html', 'Svg'].includes(googleFontStylesheetRelation.from.type)
-      ) {
-        htmlParents = [googleFontStylesheetRelation.from];
-      } else {
-        htmlParents = [];
-      }
-      for (const htmlParent of htmlParents) {
-        if (seenPages.has(htmlParent)) continue;
-        seenPages.add(htmlParent);
-        relationsToRemove.add(googleFontStylesheetRelation);
-
-        if (omitFallbacks) continue;
-
-        let selfHostedGoogleFontsCssAsset = selfHostedGoogleCssByUrl.get(
-          googleFontStylesheetRelation.to.url
-        );
-        if (!selfHostedGoogleFontsCssAsset) {
-          selfHostedGoogleFontsCssAsset =
-            await createSelfHostedGoogleFontsCssAsset(
-              assetGraph,
-              googleFontStylesheetRelation.to,
-              formats,
-              hrefType,
-              subsetUrl
-            );
-          await selfHostedGoogleFontsCssAsset.minify();
-          selfHostedGoogleCssByUrl.set(
-            googleFontStylesheetRelation.to.url,
-            selfHostedGoogleFontsCssAsset
-          );
+        if (containedRelationsByFontFaceRule.size === 0 ||
+            omitFallbacks ||
+            htmlOrSvgAsset.type !== 'Html') {
+            continue;
         }
-        const selfHostedFallbackRelation = htmlParent.addRelation(
-          {
-            type: `${htmlParent.type}Style`,
-            to: selfHostedGoogleFontsCssAsset,
-            hrefType,
-          },
-          'lastInBody'
-        );
-        relationsToRemove.add(selfHostedFallbackRelation);
-        if (htmlParent.type === 'Html') {
-          asyncLoadStyleRelationWithFallback(
-            htmlParent,
-            selfHostedFallbackRelation,
-            hrefType
-          );
+        // Group @font-face rules by their enclosing @media context so the
+        // fallback CSS preserves the original media-conditional loading.
+        // Walk up the ancestor chain in case the rule is nested (e.g.
+        // inside @supports inside @media).
+        const rulesByMedia = new Map();
+        for (const rule of containedRelationsByFontFaceRule.keys()) {
+            let mediaKey = '';
+            let ancestor = rule.parent;
+            while (ancestor) {
+                if (ancestor.type === 'atrule' &&
+                    ancestor.name?.toLowerCase() === 'media') {
+                    mediaKey = ancestor.params ?? '';
+                    break;
+                }
+                ancestor = ancestor.parent;
+            }
+            if (!rulesByMedia.has(mediaKey))
+                rulesByMedia.set(mediaKey, []);
+            rulesByMedia
+                .get(mediaKey)
+                .push((0, fontFaceHelpers_1.getFontFaceDeclarationText)(rule, containedRelationsByFontFaceRule.get(rule) ?? []));
         }
-      }
-    }
-    googleFontStylesheet.unload();
-  }
-
-  // Clean up, making sure not to detach the same relation twice, eg. when multiple pages use the same stylesheet that imports a font
-  for (const relation of relationsToRemove) {
-    relation.detach();
-  }
-
-  timings['Google Fonts + cleanup'] = googleCleanupPhase.end();
-
-  const injectPhase = trackPhase('inject subset font-family into CSS/SVG');
-
-  // Use subsets in font-family:
-
-  const webfontNameMap = {};
-
-  for (const { fontUsages } of htmlOrSvgAssetTextsWithProps) {
-    for (const { subsets, fontFamilies, props } of fontUsages) {
-      if (subsets) {
-        for (const fontFamily of fontFamilies) {
-          webfontNameMap[fontFamily.toLowerCase()] =
-            `${props['font-family']}__subset`;
+        let fallbackCssText = '';
+        for (const [media, texts] of rulesByMedia) {
+            if (media) {
+                fallbackCssText += `@media ${media}{${texts.join('')}}`;
+            }
+            else {
+                fallbackCssText += texts.join('');
+            }
         }
-      }
-    }
-  }
-
-  let customPropertyDefinitions; // Avoid computing this unless necessary
-  // Inject subset font name before original webfont in SVG font-family attributes
-  const svgAssets = assetGraph.findAssets({ type: 'Svg' });
-  for (const svgAsset of svgAssets) {
-    if (!svgAsset.isLoaded) continue;
-    let changesMade = false;
-    for (const element of Array.from(
-      svgAsset.parseTree.querySelectorAll('[font-family]')
-    )) {
-      const fontFamilies = cssListHelpers.splitByCommas(
-        element.getAttribute('font-family')
-      );
-      for (let i = 0; i < fontFamilies.length; i += 1) {
-        const subsetFontFamily =
-          webfontNameMap[
-            cssFontParser.parseFontFamily(fontFamilies[i])[0].toLowerCase()
-          ];
-        if (subsetFontFamily && !fontFamilies.includes(subsetFontFamily)) {
-          fontFamilies.splice(
-            i,
-            omitFallbacks ? 1 : 0,
-            maybeCssQuote(subsetFontFamily)
-          );
-          i += 1;
-          element.setAttribute('font-family', fontFamilies.join(', '));
-          changesMade = true;
+        let cssAsset = fallbackCssAssetCache.get(fallbackCssText);
+        if (!cssAsset) {
+            cssAsset = assetGraph.addAsset({
+                type: 'Css',
+                text: fallbackCssText,
+            });
+            for (const relation of cssAsset.outgoingRelations) {
+                relation.hrefType = hrefType;
+            }
+            await cssAsset.minify();
+            cssAsset.url = `${subsetUrl}fallback-${cssAsset.md5Hex.slice(0, 10)}.css`;
+            fallbackCssAssetCache.set(fallbackCssText, cssAsset);
+        }
+        // Create a <link rel="stylesheet"> that asyncLoadStyleRelationWithFallback can convert to async with noscript fallback:
+        const fallbackHtmlStyle = htmlOrSvgAsset.addRelation({
+            type: 'HtmlStyle',
+            to: cssAsset,
+        });
+        asyncLoadStyleRelationWithFallback(htmlOrSvgAsset, fallbackHtmlStyle, hrefType);
+        relationsToRemove.add(fallbackHtmlStyle);
+    }
+    timings['lazy load fallback CSS'] = lazyFallbackPhase.end();
+    const removeFontFacePhase = trackPhase('remove original @font-face');
+    // Remove the original @font-face blocks, and don't leave behind empty stylesheets:
+    const maybeEmptyCssAssets = new Set();
+    for (const relation of originalRelations) {
+        const cssAsset = relation.from;
+        if (relation.node.parent) {
+            relation.node.parent.removeChild(relation.node);
+        }
+        relation.remove();
+        cssAsset.markDirty();
+        maybeEmptyCssAssets.add(cssAsset);
+    }
+    for (const cssAsset of maybeEmptyCssAssets) {
+        if ((0, fontFaceHelpers_1.cssAssetIsEmpty)(cssAsset)) {
+            for (const incomingRelation of cssAsset.incomingRelations) {
+                incomingRelation.detach();
+            }
+            assetGraph.removeAsset(cssAsset);
         }
-      }
-    }
-    if (changesMade) {
-      svgAsset.markDirty();
     }
-  }
-
-  // Inject subset font name before original webfont in CSS
-  const cssAssets = assetGraph.findAssets({
-    type: 'Css',
-    isLoaded: true,
-  });
-  let changesMadeToCustomPropertyDefinitions = false;
-  for (const cssAsset of cssAssets) {
-    let changesMade = false;
-    cssAsset.eachRuleInParseTree((cssRule) => {
-      if (cssRule.parent.type !== 'rule' || cssRule.type !== 'decl') return;
-
-      const propName = cssRule.prop.toLowerCase();
-      if (
-        (propName === 'font' || propName === 'font-family') &&
-        cssRule.value.includes('var(')
-      ) {
-        if (!customPropertyDefinitions) {
-          customPropertyDefinitions = findCustomPropertyDefinitions(cssAssets);
+    timings['remove original @font-face'] = removeFontFacePhase.end();
+    const googleCleanupPhase = trackPhase('Google Fonts + cleanup');
+    // Async load Google Web Fonts CSS.  Skip the regex findAssets scan and
+    // the surrounding loop entirely when no Google Fonts were detected up
+    // front — the final detach loop below still runs because other phases
+    // (lazy fallback CSS) populate relationsToRemove.
+    const googleFontStylesheets = hasGoogleFonts
+        ? assetGraph.findAssets({
+            type: 'Css',
+            url: { $regex: googleFontsCssUrlRegex },
+        })
+        : [];
+    const selfHostedGoogleCssByUrl = new Map();
+    for (const googleFontStylesheet of googleFontStylesheets) {
+        const seenPages = new Set(); // Only do the work once for each font on each page
+        for (const googleFontStylesheetRelation of googleFontStylesheet.incomingRelations) {
+            let htmlParents;
+            if (googleFontStylesheetRelation.type === 'CssImport') {
+                // Gather Html parents. Relevant if we are dealing with CSS @import relations
+                htmlParents = getParents(googleFontStylesheetRelation.to, {
+                    type: { $in: ['Html', 'Svg'] },
+                    isInline: false,
+                    isLoaded: true,
+                });
+            }
+            else if (['Html', 'Svg'].includes(googleFontStylesheetRelation.from.type ?? '')) {
+                htmlParents = [googleFontStylesheetRelation.from];
+            }
+            else {
+                htmlParents = [];
+            }
+            for (const htmlParent of htmlParents) {
+                if (seenPages.has(htmlParent))
+                    continue;
+                seenPages.add(htmlParent);
+                relationsToRemove.add(googleFontStylesheetRelation);
+                if (omitFallbacks)
+                    continue;
+                let selfHostedGoogleFontsCssAsset = selfHostedGoogleCssByUrl.get(googleFontStylesheetRelation.to.url);
+                if (!selfHostedGoogleFontsCssAsset) {
+                    selfHostedGoogleFontsCssAsset =
+                        await createSelfHostedGoogleFontsCssAsset(assetGraph, googleFontStylesheetRelation.to, formats, hrefType, subsetUrl);
+                    await selfHostedGoogleFontsCssAsset.minify();
+                    selfHostedGoogleCssByUrl.set(googleFontStylesheetRelation.to.url, selfHostedGoogleFontsCssAsset);
+                }
+                const selfHostedFallbackRelation = htmlParent.addRelation({
+                    type: `${htmlParent.type}Style`,
+                    to: selfHostedGoogleFontsCssAsset,
+                    hrefType,
+                }, 'lastInBody');
+                relationsToRemove.add(selfHostedFallbackRelation);
+                if (htmlParent.type === 'Html') {
+                    asyncLoadStyleRelationWithFallback(htmlParent, selfHostedFallbackRelation, hrefType);
+                }
+            }
         }
-        for (const customPropertyName of extractReferencedCustomPropertyNames(
-          cssRule.value
-        )) {
-          for (const relatedCssRule of [
-            cssRule,
-            ...(customPropertyDefinitions[customPropertyName] || []),
-          ]) {
-            const modifiedValue = injectSubsetDefinitions(
-              relatedCssRule.value,
-              webfontNameMap,
-              omitFallbacks // replaceOriginal
-            );
-            if (modifiedValue !== relatedCssRule.value) {
-              relatedCssRule.value = modifiedValue;
-              changesMadeToCustomPropertyDefinitions = true;
+        googleFontStylesheet.unload();
+    }
+    // Clean up, making sure not to detach the same relation twice, eg. when multiple pages use the same stylesheet that imports a font
+    for (const relation of relationsToRemove) {
+        relation.detach();
+    }
+    timings['Google Fonts + cleanup'] = googleCleanupPhase.end();
+    const injectPhase = trackPhase('inject subset font-family into CSS/SVG');
+    // Use subsets in font-family:
+    const webfontNameMap = Object.create(null);
+    for (const { fontUsages } of htmlOrSvgAssetTextsWithProps) {
+        for (const { subsets, fontFamilies, props } of fontUsages) {
+            if (subsets) {
+                for (const fontFamily of fontFamilies) {
+                    webfontNameMap[fontFamily.toLowerCase()] =
+                        `${props['font-family']}__subset`;
+                }
             }
-          }
         }
-      } else if (propName === 'font-family') {
-        const fontFamilies = cssListHelpers.splitByCommas(cssRule.value);
-        for (let i = 0; i < fontFamilies.length; i += 1) {
-          const subsetFontFamily =
-            webfontNameMap[
-              cssFontParser.parseFontFamily(fontFamilies[i])[0].toLowerCase()
-            ];
-          if (subsetFontFamily && !fontFamilies.includes(subsetFontFamily)) {
-            fontFamilies.splice(
-              i,
-              omitFallbacks ? 1 : 0,
-              maybeCssQuote(subsetFontFamily)
-            );
-            i += 1;
-            cssRule.value = fontFamilies.join(', ');
-            changesMade = true;
-          }
+    }
+    let customPropertyDefinitions;
+    const cssAssetsDirtiedByCustomProps = new Set();
+    // Inject subset font name before original webfont in SVG font-family attributes
+    const svgAssets = assetGraph.findAssets({ type: 'Svg' });
+    for (const svgAsset of svgAssets) {
+        if (!svgAsset.isLoaded)
+            continue;
+        let changesMade = false;
+        for (const element of Array.from(svgAsset.parseTree.querySelectorAll('[font-family]'))) {
+            const fontFamilies = cssListHelpers.splitByCommas(element.getAttribute('font-family'));
+            for (let i = 0; i < fontFamilies.length; i += 1) {
+                const subsetFontFamily = webfontNameMap[cssFontParser.parseFontFamily(fontFamilies[i])[0].toLowerCase()];
+                if (subsetFontFamily && !fontFamilies.includes(subsetFontFamily)) {
+                    fontFamilies.splice(i, omitFallbacks ? 1 : 0, (0, fontFaceHelpers_1.maybeCssQuote)(subsetFontFamily));
+                    i += 1;
+                    element.setAttribute('font-family', fontFamilies.join(', '));
+                    changesMade = true;
+                }
+            }
         }
-      } else if (propName === 'font') {
-        const fontProperties = cssFontParser.parseFont(cssRule.value);
-        const fontFamilies =
-          fontProperties && fontProperties['font-family'].map(unquote);
-        if (!fontFamilies) return;
-
-        const subsetFontFamily = webfontNameMap[fontFamilies[0].toLowerCase()];
-        if (!subsetFontFamily || fontFamilies.includes(subsetFontFamily))
-          return;
-
-        // Rebuild the font shorthand with the subset family prepended
-        if (omitFallbacks) {
-          fontFamilies.shift();
+        if (changesMade) {
+            svgAsset.markDirty();
         }
-        fontFamilies.unshift(subsetFontFamily);
-        const stylePrefix = fontProperties['font-style']
-          ? `${fontProperties['font-style']} `
-          : '';
-        const weightPrefix = fontProperties['font-weight']
-          ? `${fontProperties['font-weight']} `
-          : '';
-        const lineHeightSuffix = fontProperties['line-height']
-          ? `/${fontProperties['line-height']}`
-          : '';
-        cssRule.value = `${stylePrefix}${weightPrefix}${
-          fontProperties['font-size']
-        }${lineHeightSuffix} ${fontFamilies.map(maybeCssQuote).join(', ')}`;
-        changesMade = true;
-      }
-    });
-    if (changesMade) {
-      cssAsset.markDirty();
     }
-  }
-
-  // This is a bit crude, could be more efficient if we tracked the containing asset in findCustomPropertyDefinitions
-  if (changesMadeToCustomPropertyDefinitions) {
+    // Inject subset font name before original webfont in CSS
+    const cssAssets = assetGraph.findAssets({
+        type: 'Css',
+        isLoaded: true,
+    });
+    const parseTreeToAsset = new Map();
     for (const cssAsset of cssAssets) {
-      cssAsset.markDirty();
+        parseTreeToAsset.set(cssAsset.parseTree, cssAsset);
     }
-  }
-
-  timings['inject subset font-family'] = injectPhase.end();
-
-  const orphanCleanupPhase = trackPhase('source maps + orphan cleanup');
-  if (sourceMaps) {
-    await assetGraph.serializeSourceMaps(undefined, {
-      type: 'Css',
-      outgoingRelations: {
-        $where: (relations) =>
-          relations.some((relation) => relation.type === 'CssSourceMappingUrl'),
-      },
-    });
-    for (const relation of assetGraph.findRelations({
-      type: 'SourceMapSource',
-    })) {
-      relation.hrefType = hrefType;
+    for (const cssAsset of cssAssets) {
+        let changesMade = false;
+        cssAsset.eachRuleInParseTree((cssRule) => {
+            if (cssRule.parent.type !== 'rule' || cssRule.type !== 'decl')
+                return;
+            const propName = cssRule.prop.toLowerCase();
+            if ((propName === 'font' || propName === 'font-family') &&
+                cssRule.value.includes('var(')) {
+                if (!customPropertyDefinitions) {
+                    customPropertyDefinitions = findCustomPropertyDefinitions(cssAssets);
+                }
+                for (const customPropertyName of extractReferencedCustomPropertyNames(cssRule.value)) {
+                    for (const relatedCssRule of [
+                        cssRule,
+                        ...(customPropertyDefinitions[customPropertyName] || []),
+                    ]) {
+                        const modifiedValue = injectSubsetDefinitions(relatedCssRule.value, webfontNameMap, omitFallbacks // replaceOriginal
+                        );
+                        if (modifiedValue !== relatedCssRule.value) {
+                            relatedCssRule.value = modifiedValue;
+                            const ownerAsset = parseTreeToAsset.get(relatedCssRule.root());
+                            if (ownerAsset) {
+                                cssAssetsDirtiedByCustomProps.add(ownerAsset);
+                            }
+                        }
+                    }
+                }
+            }
+            else if (propName === 'font-family') {
+                const fontFamilies = cssListHelpers.splitByCommas(cssRule.value);
+                for (let i = 0; i < fontFamilies.length; i += 1) {
+                    const subsetFontFamily = webfontNameMap[cssFontParser.parseFontFamily(fontFamilies[i])[0].toLowerCase()];
+                    if (subsetFontFamily && !fontFamilies.includes(subsetFontFamily)) {
+                        fontFamilies.splice(i, omitFallbacks ? 1 : 0, (0, fontFaceHelpers_1.maybeCssQuote)(subsetFontFamily));
+                        i += 1;
+                        cssRule.value = fontFamilies.join(', ');
+                        changesMade = true;
+                    }
+                }
+            }
+            else if (propName === 'font') {
+                const fontProperties = cssFontParser.parseFont(cssRule.value);
+                const fontFamilies = fontProperties && fontProperties['font-family'].map(unquote);
+                if (!fontFamilies)
+                    return;
+                const subsetFontFamily = webfontNameMap[fontFamilies[0].toLowerCase()];
+                if (!subsetFontFamily || fontFamilies.includes(subsetFontFamily))
+                    return;
+                // Rebuild the font shorthand with the subset family prepended
+                if (omitFallbacks) {
+                    fontFamilies.shift();
+                }
+                fontFamilies.unshift(subsetFontFamily);
+                const stylePrefix = fontProperties['font-style']
+                    ? `${fontProperties['font-style']} `
+                    : '';
+                const weightPrefix = fontProperties['font-weight']
+                    ? `${fontProperties['font-weight']} `
+                    : '';
+                const lineHeightSuffix = fontProperties['line-height']
+                    ? `/${fontProperties['line-height']}`
+                    : '';
+                cssRule.value = `${stylePrefix}${weightPrefix}${fontProperties['font-size']}${lineHeightSuffix} ${fontFamilies.map(fontFaceHelpers_1.maybeCssQuote).join(', ')}`;
+                changesMade = true;
+            }
+        });
+        if (changesMade) {
+            cssAsset.markDirty();
+        }
     }
-    for (const relation of assetGraph.findRelations({
-      type: 'CssSourceMappingUrl',
-      hrefType: { $in: ['relative', 'inline'] },
-    })) {
-      relation.hrefType = hrefType;
+    for (const dirtiedAsset of cssAssetsDirtiedByCustomProps) {
+        dirtiedAsset.markDirty();
     }
-  }
-
-  for (const asset of potentiallyOrphanedAssets) {
-    if (asset.incomingRelations.length === 0) {
-      assetGraph.removeAsset(asset);
+    timings['inject subset font-family'] = injectPhase.end();
+    const orphanCleanupPhase = trackPhase('source maps + orphan cleanup');
+    if (sourceMaps) {
+        await rewriteCssSourceMaps(assetGraph, hrefType);
     }
-  }
-
-  timings['source maps + orphan cleanup'] = orphanCleanupPhase.end();
-
-  // Hand out some useful info about the detected subsets:
-  return {
-    fontInfo: htmlOrSvgAssetTextsWithProps.map(
-      ({ fontUsages, htmlOrSvgAsset }) => ({
-        assetFileName: htmlOrSvgAsset.nonInlineAncestor.urlOrDescription,
-        fontUsages: fontUsages.map((fontUsage) =>
-          (({ subsets, hasFontFeatureSettings, fontFeatureTags, ...rest }) =>
-            rest)(fontUsage)
-        ),
-      })
-    ),
-    timings,
-  };
+    removeOrphanedAssets(assetGraph, potentiallyOrphanedAssets);
+    timings['source maps + orphan cleanup'] = orphanCleanupPhase.end();
+    return {
+        fontInfo: buildFontInfoReport(htmlOrSvgAssetTextsWithProps),
+        timings,
+    };
 }
-
 module.exports = subsetFonts;
-// Exported for testing
-module.exports._escapeJsStringLiteral = escapeJsStringLiteral;
+//# sourceMappingURL=subsetFonts.js.map