vinext 0.0.49 → 0.0.51

package/dist/shims/font-google-base.js

@@ -1,3 +1,4 @@
+import { escapeCSSString, formatFontClassRule, resolveSingleFaceStyle, sanitizeCSSVarName, sanitizeFallback } from "./font-utils.js";
 import { buildGoogleFontsUrl as buildGoogleFontsUrl$1 } from "../build/google-fonts/build-url.js";
 //#region src/shims/font-google-base.ts
 /**
@@ -15,57 +16,9 @@ import { buildGoogleFontsUrl as buildGoogleFontsUrl$1 } from "../build/google-fo
 *   import { Inter } from 'next/font/google';
 *   const inter = Inter({ subsets: ['latin'], weight: ['400', '700'] });
 *   // inter.className -> stable CSS class for this font/options pair
-*   // inter.style -> { fontFamily: "'Inter', sans-serif" }
-*   // inter.variable -> CSS class that sets the font CSS variable
+*   // inter.style -> { fontFamily: "'Inter', 'Inter Fallback'", fontStyle: "normal" }
+*   // inter.variable -> CSS class that sets the font CSS variable when requested
 */
-/**
-* Escape a string for safe interpolation inside a CSS single-quoted string.
-*
-* Prevents CSS injection by escaping characters that could break out of
-* a `'...'` CSS string context: backslashes, single quotes, and newlines.
-*/
-function escapeCSSString(value) {
-	return value.replace(/\\/g, "\\\\").replace(/'/g, "\\'").replace(/\n/g, "\\a ").replace(/\r/g, "\\d ");
-}
-/**
-* Validate a CSS custom property name (e.g. `--font-inter`).
-*
-* Custom properties must start with `--` and only contain alphanumeric
-* characters, hyphens, and underscores. Anything else could be used to
-* break out of the CSS declaration and inject arbitrary rules.
-*
-* Returns the name if valid, undefined otherwise.
-*/
-function sanitizeCSSVarName(name) {
-	if (/^--[a-zA-Z0-9_-]+$/.test(name)) return name;
-}
-/**
-* Sanitize a CSS font-family fallback name.
-*
-* Generic family names (sans-serif, serif, monospace, etc.) are used as-is.
-* Named families are wrapped in escaped quotes. This prevents injection via
-* crafted fallback values like `); } body { color: red; } .x {`.
-*/
-function sanitizeFallback(name) {
-	const generics = new Set([
-		"serif",
-		"sans-serif",
-		"monospace",
-		"cursive",
-		"fantasy",
-		"system-ui",
-		"ui-serif",
-		"ui-sans-serif",
-		"ui-monospace",
-		"ui-rounded",
-		"emoji",
-		"math",
-		"fangsong"
-	]);
-	const trimmed = name.trim();
-	if (generics.has(trimmed)) return trimmed;
-	return `'${escapeCSSString(trimmed)}'`;
-}
 const injectedFonts = /* @__PURE__ */ new Set();
 /**
 * Convert a font family name to a CSS variable name.
@@ -124,7 +77,9 @@ function createFontIdentity(family, options, cssVarName, fallback) {
 		normalizeFallbackOption(fallback),
 		normalizeStringOrBooleanOption(options.adjustFontFallback),
 		normalizeStringSetOption(options.axes),
-		options._selfHostedCSS ?? ""
+		options._vinext?.font?.selfHostedCSS ?? "",
+		options._vinext?.font?.fontWeight?.toString() ?? "",
+		options._vinext?.font?.fontStyle ?? ""
 	].join("\0"));
 }
 /**
@@ -133,10 +88,10 @@ function createFontIdentity(family, options, cssVarName, fallback) {
 * In production this code path is dead. The build plugin
 * (`vinext:google-fonts` in `src/plugins/fonts.ts`) statically resolves
 * each font call's axis values against the bundled metadata, fetches the
-* Google Fonts CSS, and injects the resulting CSS as `_selfHostedCSS` so
-* the runtime never queries Google. The shim only reaches this builder
-* when the plugin's static parser bails (dynamic options, eval-only
-* shapes), which is dev-only.
+* Google Fonts CSS, and injects the resulting CSS as
+* `_vinext.font.selfHostedCSS` so the runtime never queries Google. The shim
+* only reaches this builder when the plugin's static parser bails (dynamic
+* options, eval-only shapes), which is dev-only.
 *
 * The dev fallback intentionally has no metadata: shipping the 388 KB
 * `font-data.json` to the Worker bundle would dwarf the rest of the shim,
@@ -175,26 +130,26 @@ function injectFontStylesheet(url) {
 /** Track which className CSS rules have been injected. */
 const injectedClassRules = /* @__PURE__ */ new Set();
 /**
-* Inject a CSS rule that maps a className to a font-family.
+* Inject a CSS rule that maps a className to the exported font style.
 *
 * This is what makes `<div className={inter.className}>` apply the font.
 * Next.js generates equivalent rules at build time.
 *
-* In Next.js, the .className class ONLY sets font-family — it does NOT
-* set CSS variables. CSS variables are handled separately by the .variable class.
+* In Next.js, the .className class sets font-family and any single
+* font-weight/font-style. CSS variables are handled separately by .variable.
 */
-function injectClassNameRule(className, fontFamily) {
+function injectClassNameRule(className, fontStyle) {
 	if (injectedClassRules.has(className)) return;
 	injectedClassRules.add(className);
-	const css = `.${className} { font-family: ${fontFamily}; }\n`;
+	const css = formatFontClassRule(className, fontStyle);
 	if (typeof document === "undefined") {
 		ssrFontStyles.push(css);
 		return;
 	}
-	const style = document.createElement("style");
-	style.textContent = css;
-	style.setAttribute("data-vinext-font-class", className);
-	document.head.appendChild(style);
+	const styleElement = document.createElement("style");
+	styleElement.textContent = css;
+	styleElement.setAttribute("data-vinext-font-class", className);
+	document.head.appendChild(styleElement);
 }
 /** Track which variable class CSS rules have been injected. */
 const injectedVariableRules = /* @__PURE__ */ new Set();
@@ -310,15 +265,29 @@ function injectSelfHostedCSS(css) {
 }
 function createFontLoader(family) {
 	return function fontLoader(options = {}) {
-		const fallback = options.fallback ?? ["sans-serif"];
-		const fontFamily = `'${escapeCSSString(family)}', ${fallback.map(sanitizeFallback).join(", ")}`;
+		const internal = options._vinext?.font;
+		const fallback = options.fallback ?? [];
+		const adjustedFallback = options.adjustFontFallback === false || !internal?.adjustedFallbackCSS ? [] : [`'${escapeCSSString(family)} Fallback'`];
+		const fontFamily = [
+			`'${escapeCSSString(family)}'`,
+			...adjustedFallback,
+			...fallback.map(sanitizeFallback)
+		].join(", ");
 		const defaultVarName = toVarName(family);
 		const cssVarName = options.variable ? sanitizeCSSVarName(options.variable) ?? defaultVarName : defaultVarName;
 		const id = createFontIdentity(family, options, cssVarName, fallback);
 		const classSegment = fontClassSegment(family);
 		const className = `__font_${classSegment}_${id}`;
 		const variableClassName = `__variable_${classSegment}_${id}`;
-		if (options._selfHostedCSS) injectSelfHostedCSS(options._selfHostedCSS);
+		const style = resolveSingleFaceStyle({
+			fontFamily,
+			weight: options.weight,
+			style: options.style,
+			internalWeight: internal?.fontWeight,
+			internalStyle: internal?.fontStyle,
+			google: true
+		});
+		if (internal?.selfHostedCSS) injectSelfHostedCSS(internal.selfHostedCSS);
 		else {
 			const url = buildGoogleFontsUrl(family, options);
 			injectFontStylesheet(url);
@@ -326,12 +295,13 @@ function createFontLoader(family) {
 				if (!ssrFontUrls.includes(url)) ssrFontUrls.push(url);
 			}
 		}
-		injectClassNameRule(className, fontFamily);
-		injectVariableClassRule(variableClassName, cssVarName, fontFamily);
+		if (options.adjustFontFallback !== false && internal?.adjustedFallbackCSS) injectSelfHostedCSS(internal.adjustedFallbackCSS);
+		injectClassNameRule(className, style);
+		if (options.variable) injectVariableClassRule(variableClassName, cssVarName, fontFamily);
 		return {
 			className,
-			style: { fontFamily },
-			variable: variableClassName
+			style,
+			...options.variable ? { variable: variableClassName } : {}
 		};
 	};
 }

package/dist/shims/font-google-base.js.map

@@ -1 +1 @@
-{"version":3,"file":"font-google-base.js","names":["buildUrlFromAxes"],"sources":["../../src/shims/font-google-base.ts"],"sourcesContent":["import { buildGoogleFontsUrl as buildUrlFromAxes } from \"../build/google-fonts/build-url.js\";\n\n/**\n * next/font/google shim\n *\n * Provides a compatible shim for Next.js Google Fonts.\n *\n * Two modes:\n * 1. **Dev / CDN mode** (default): Loads fonts from Google Fonts CDN via <link> tags.\n * 2. **Self-hosted mode** (production build): The vinext:google-fonts Vite plugin\n *    fetches font CSS + .woff2 files at build time, caches them locally, and injects\n *    @font-face CSS pointing at local assets. No requests to Google at runtime.\n *\n * Usage:\n *   import { Inter } from 'next/font/google';\n *   const inter = Inter({ subsets: ['latin'], weight: ['400', '700'] });\n *   // inter.className -> stable CSS class for this font/options pair\n *   // inter.style -> { fontFamily: \"'Inter', sans-serif\" }\n *   // inter.variable -> CSS class that sets the font CSS variable\n */\n\n/**\n * Escape a string for safe interpolation inside a CSS single-quoted string.\n *\n * Prevents CSS injection by escaping characters that could break out of\n * a `'...'` CSS string context: backslashes, single quotes, and newlines.\n */\nfunction escapeCSSString(value: string): string {\n  return value\n    .replace(/\\\\/g, \"\\\\\\\\\")\n    .replace(/'/g, \"\\\\'\")\n    .replace(/\\n/g, \"\\\\a \")\n    .replace(/\\r/g, \"\\\\d \");\n}\n\n/**\n * Validate a CSS custom property name (e.g. `--font-inter`).\n *\n * Custom properties must start with `--` and only contain alphanumeric\n * characters, hyphens, and underscores. Anything else could be used to\n * break out of the CSS declaration and inject arbitrary rules.\n *\n * Returns the name if valid, undefined otherwise.\n */\nfunction sanitizeCSSVarName(name: string): string | undefined {\n  if (/^--[a-zA-Z0-9_-]+$/.test(name)) return name;\n  return undefined;\n}\n\n/**\n * Sanitize a CSS font-family fallback name.\n *\n * Generic family names (sans-serif, serif, monospace, etc.) are used as-is.\n * Named families are wrapped in escaped quotes. This prevents injection via\n * crafted fallback values like `); } body { color: red; } .x {`.\n */\nfunction sanitizeFallback(name: string): string {\n  // CSS generic font families — safe to use unquoted\n  const generics = new Set([\n    \"serif\",\n    \"sans-serif\",\n    \"monospace\",\n    \"cursive\",\n    \"fantasy\",\n    \"system-ui\",\n    \"ui-serif\",\n    \"ui-sans-serif\",\n    \"ui-monospace\",\n    \"ui-rounded\",\n    \"emoji\",\n    \"math\",\n    \"fangsong\",\n  ]);\n  const trimmed = name.trim();\n  if (generics.has(trimmed)) return trimmed;\n  // Wrap in single quotes with escaping to prevent CSS injection\n  return `'${escapeCSSString(trimmed)}'`;\n}\n\n// Track which font stylesheets have been injected (SSR + client)\nconst injectedFonts = new Set<string>();\n\nexport type FontOptions = {\n  weight?: string | string[];\n  style?: string | string[];\n  subsets?: string[];\n  display?: string;\n  preload?: boolean;\n  fallback?: string[];\n  adjustFontFallback?: boolean | string;\n  variable?: string;\n  axes?: string[];\n};\n\nexport type FontResult = {\n  className: string;\n  style: { fontFamily: string };\n  variable?: string;\n};\n\ntype FontLoaderOptions = FontOptions & { _selfHostedCSS?: string };\n\n/**\n * Convert a font family name to a CSS variable name.\n * e.g., \"Inter\" -> \"--font-inter\", \"Roboto Mono\" -> \"--font-roboto-mono\"\n */\nfunction toVarName(family: string): string {\n  return \"--font-\" + family.toLowerCase().replace(/\\s+/g, \"-\");\n}\n\nfunction fontClassSegment(family: string): string {\n  const segment = family\n    .toLowerCase()\n    .replace(/[^a-z0-9_-]+/g, \"_\")\n    .replace(/^_+|_+$/g, \"\");\n  return segment || \"font\";\n}\n\nfunction normalizeStringSetOption(value: string | string[] | undefined): string {\n  if (!value) return \"\";\n  const values = Array.isArray(value) ? value : [value];\n  return [...new Set(values.map((item) => item.trim()).filter(Boolean))].sort().join(\",\");\n}\n\nfunction normalizeWeightOption(value: string | string[] | undefined): string {\n  const normalized = normalizeStringSetOption(value);\n  return normalized === \"variable\" ? \"\" : normalized;\n}\n\nfunction normalizeStyleOption(value: string | string[] | undefined): string {\n  const values = new Set(\n    (Array.isArray(value) ? value : value ? [value] : [])\n      .map((item) => item.trim())\n      .filter(Boolean),\n  );\n  const hasItalic = values.has(\"italic\");\n  const hasNormal = values.has(\"normal\");\n  if (!hasItalic) return \"\";\n  return hasNormal ? \"italic,normal\" : \"italic\";\n}\n\nfunction normalizeFallbackOption(value: string[] | undefined): string {\n  if (!value) return \"\";\n  return value.map((item) => item.trim()).join(\",\");\n}\n\nfunction normalizeBooleanOption(value: boolean | undefined): string {\n  if (value === undefined) return \"\";\n  return value ? \"1\" : \"0\";\n}\n\nfunction normalizeStringOrBooleanOption(value: boolean | string | undefined): string {\n  if (value === undefined) return \"\";\n  return typeof value === \"boolean\" ? normalizeBooleanOption(value) : value;\n}\n\nfunction hashString(value: string): string {\n  let hash = 0x811c9dc5;\n  for (let i = 0; i < value.length; i++) {\n    hash ^= value.charCodeAt(i);\n    hash = Math.imul(hash, 0x01000193) >>> 0;\n  }\n  return hash.toString(36).padStart(7, \"0\");\n}\n\nfunction createFontIdentity(\n  family: string,\n  options: FontLoaderOptions,\n  cssVarName: string,\n  fallback: string[],\n): string {\n  return hashString(\n    [\n      family,\n      cssVarName,\n      normalizeWeightOption(options.weight),\n      normalizeStyleOption(options.style),\n      normalizeStringSetOption(options.subsets),\n      options.display ?? \"swap\",\n      normalizeBooleanOption(options.preload),\n      normalizeFallbackOption(fallback),\n      normalizeStringOrBooleanOption(options.adjustFontFallback),\n      normalizeStringSetOption(options.axes),\n      options._selfHostedCSS ?? \"\",\n    ].join(\"\\0\"),\n  );\n}\n\n/**\n * Build a Google Fonts CSS URL.\n *\n * In production this code path is dead. The build plugin\n * (`vinext:google-fonts` in `src/plugins/fonts.ts`) statically resolves\n * each font call's axis values against the bundled metadata, fetches the\n * Google Fonts CSS, and injects the resulting CSS as `_selfHostedCSS` so\n * the runtime never queries Google. The shim only reaches this builder\n * when the plugin's static parser bails (dynamic options, eval-only\n * shapes), which is dev-only.\n *\n * The dev fallback intentionally has no metadata: shipping the 388 KB\n * `font-data.json` to the Worker bundle would dwarf the rest of the shim,\n * and the production path already has the metadata-aware variant. The\n * tradeoff is that the dev fallback cannot resolve a variable font's\n * actual `wght` axis range. It emits no axis segment when no `weight` is\n * given, which makes Google return the default static face (200) instead\n * of the broken `:wght@100..900` URL that issue #885 reports.\n */\nexport function buildGoogleFontsUrl(family: string, options: FontOptions): string {\n  const weights = options.weight\n    ? Array.isArray(options.weight)\n      ? options.weight\n      : [options.weight]\n    : [];\n  const styles = options.style\n    ? Array.isArray(options.style)\n      ? options.style\n      : [options.style]\n    : [];\n\n  const hasItalic = styles.includes(\"italic\");\n  const hasNormal = styles.includes(\"normal\");\n  // Google treats omitted ital as ital=0, so italic-only requests emit\n  // ['1']; mixed requests emit ['0','1']; normal-only stays undefined so\n  // the URL has no ital axis at all.\n  const ital = hasItalic ? [...(hasNormal ? [\"0\"] : []), \"1\"] : undefined;\n\n  // The dev fallback has no metadata, so the variable sentinel cannot be\n  // resolved to the font's real axis range here. Drop it like empty options\n  // instead of emitting the invalid Google Fonts URL `:wght@variable`.\n  const normalizedWeights = weights.length === 1 && weights[0] === \"variable\" ? [] : weights;\n\n  // Italic-only with no explicit weight still needs a wght value or the\n  // ital axis has nowhere to attach in Google's URL grammar. Fall back to\n  // '400' because every Google Font has it and it is the visible default.\n  // The plugin's metadata-aware path covers the variable-font case in\n  // production.\n  const wght = normalizedWeights.length > 0 ? normalizedWeights : ital ? [\"400\"] : undefined;\n\n  return buildUrlFromAxes(family, { wght, ital }, options.display ?? \"swap\");\n}\n\n/**\n * Inject a <link> tag for the font (client-side only).\n * On the server, we track font URLs for SSR head injection.\n */\nfunction injectFontStylesheet(url: string): void {\n  if (injectedFonts.has(url)) return;\n  injectedFonts.add(url);\n\n  if (typeof document !== \"undefined\") {\n    const link = document.createElement(\"link\");\n    link.rel = \"stylesheet\";\n    link.href = url;\n    document.head.appendChild(link);\n  }\n}\n\n/** Track which className CSS rules have been injected. */\nconst injectedClassRules = new Set<string>();\n\n/**\n * Inject a CSS rule that maps a className to a font-family.\n *\n * This is what makes `<div className={inter.className}>` apply the font.\n * Next.js generates equivalent rules at build time.\n *\n * In Next.js, the .className class ONLY sets font-family — it does NOT\n * set CSS variables. CSS variables are handled separately by the .variable class.\n */\nfunction injectClassNameRule(className: string, fontFamily: string): void {\n  if (injectedClassRules.has(className)) return;\n  injectedClassRules.add(className);\n\n  const css = `.${className} { font-family: ${fontFamily}; }\\n`;\n\n  // On server, store the CSS for SSR injection\n  if (typeof document === \"undefined\") {\n    ssrFontStyles.push(css);\n    return;\n  }\n\n  // On client, inject a <style> tag\n  const style = document.createElement(\"style\");\n  style.textContent = css;\n  style.setAttribute(\"data-vinext-font-class\", className);\n  document.head.appendChild(style);\n}\n\n/** Track which variable class CSS rules have been injected. */\nconst injectedVariableRules = new Set<string>();\n\n/**\n * Inject a CSS rule that sets a CSS variable on an element.\n * This is what makes `<html className={inter.variable}>` set the CSS variable\n * that can be referenced by other styles (e.g., Tailwind's font-sans).\n *\n * In Next.js, the .variable class ONLY sets the CSS variable — it does NOT\n * set font-family. This is critical because apps commonly apply multiple\n * .variable classes to <body> (e.g., geistSans.variable + geistMono.variable).\n * If we also set font-family here, the last class wins due to CSS cascade,\n * causing all text to use that font (e.g., everything becomes monospace).\n */\nfunction injectVariableClassRule(\n  variableClassName: string,\n  cssVarName: string,\n  fontFamily: string,\n): void {\n  if (injectedVariableRules.has(variableClassName)) return;\n  injectedVariableRules.add(variableClassName);\n\n  // Only set the CSS variable — do NOT set font-family.\n  // This matches Next.js behavior where .variable classes only define CSS variables.\n  const css = `.${variableClassName} { ${cssVarName}: ${fontFamily}; }\\n`;\n\n  // On server, store the CSS for SSR injection\n  if (typeof document === \"undefined\") {\n    ssrFontStyles.push(css);\n    return;\n  }\n\n  // On client, inject a <style> tag\n  const style = document.createElement(\"style\");\n  style.textContent = css;\n  style.setAttribute(\"data-vinext-font-variable\", variableClassName);\n  document.head.appendChild(style);\n}\n\n// SSR: collect font class CSS for injection in <head>\nconst ssrFontStyles: string[] = [];\n\n/**\n * Get collected SSR font class styles (used by the renderer).\n * Note: We don't clear the arrays because fonts are loaded at module import\n * time and need to persist across all requests in the Workers environment.\n */\nexport function getSSRFontStyles(): string[] {\n  return [...ssrFontStyles];\n}\n\n// SSR: collect font URLs to inject in <head>\nconst ssrFontUrls: string[] = [];\n\n/**\n * Get collected SSR font URLs (used by the renderer).\n * Note: We don't clear the arrays because fonts are loaded at module import\n * time and need to persist across all requests in the Workers environment.\n */\nexport function getSSRFontLinks(): string[] {\n  return [...ssrFontUrls];\n}\n\n// SSR: collect font file URLs for <link rel=\"preload\"> injection (self-hosted Google fonts)\nconst ssrFontPreloads: Array<{ href: string; type: string }> = [];\nconst ssrFontPreloadHrefs = new Set<string>();\n\n/**\n * Get collected SSR font preload data (used by the renderer).\n * Returns an array of { href, type } objects for emitting\n * <link rel=\"preload\" as=\"font\" ...> tags.\n */\nexport function getSSRFontPreloads(): Array<{ href: string; type: string }> {\n  return [...ssrFontPreloads];\n}\n\n/**\n * Determine the MIME type for a font file based on its extension.\n */\nfunction getFontMimeType(pathOrUrl: string): string {\n  if (pathOrUrl.endsWith(\".woff2\")) return \"font/woff2\";\n  if (pathOrUrl.endsWith(\".woff\")) return \"font/woff\";\n  if (pathOrUrl.endsWith(\".ttf\")) return \"font/ttf\";\n  if (pathOrUrl.endsWith(\".otf\")) return \"font/opentype\";\n  return \"font/woff2\";\n}\n\n/**\n * Extract font file URLs from @font-face CSS rules.\n * Parses url('...') references from the CSS text.\n */\nfunction extractFontUrlsFromCSS(css: string): string[] {\n  const urls: string[] = [];\n  const urlRegex = /url\\(['\"]?([^'\")]+)['\"]?\\)/g;\n  let match: RegExpExecArray | null;\n  while ((match = urlRegex.exec(css)) !== null) {\n    const url = match[1];\n    // Only collect absolute paths (starting with /) — these are self-hosted font files\n    if (url && url.startsWith(\"/\")) {\n      urls.push(url);\n    }\n  }\n  return urls;\n}\n\n/**\n * Collect font file URLs from self-hosted CSS for preload link generation.\n * Only collects on the server (SSR). Deduplicates by href using a Set for O(1) lookups.\n */\nfunction collectFontPreloadsFromCSS(css: string): void {\n  if (typeof document !== \"undefined\") return; // client-side, skip\n\n  const urls = extractFontUrlsFromCSS(css);\n  for (const href of urls) {\n    if (!ssrFontPreloadHrefs.has(href)) {\n      ssrFontPreloadHrefs.add(href);\n      ssrFontPreloads.push({ href, type: getFontMimeType(href) });\n    }\n  }\n}\n\n/** Track injected self-hosted @font-face blocks (deduplicate) */\nconst injectedSelfHosted = new Set<string>();\n\n/**\n * Inject self-hosted @font-face CSS (from the build plugin).\n * This replaces the CDN <link> tag with inline CSS.\n */\nfunction injectSelfHostedCSS(css: string): void {\n  if (injectedSelfHosted.has(css)) return;\n  injectedSelfHosted.add(css);\n\n  // Extract font file URLs for preload hints (SSR only)\n  collectFontPreloadsFromCSS(css);\n\n  if (typeof document === \"undefined\") {\n    // SSR: add to collected styles\n    ssrFontStyles.push(css);\n    return;\n  }\n\n  // Client: inject <style> tag\n  const style = document.createElement(\"style\");\n  style.textContent = css;\n  style.setAttribute(\"data-vinext-font-selfhosted\", \"true\");\n  document.head.appendChild(style);\n}\n\nexport type FontLoader = (options?: FontLoaderOptions) => FontResult;\n\nexport function createFontLoader(family: string): FontLoader {\n  return function fontLoader(options: FontLoaderOptions = {}): FontResult {\n    const fallback = options.fallback ?? [\"sans-serif\"];\n    // Sanitize each fallback name to prevent CSS injection via crafted values\n    const fontFamily = `'${escapeCSSString(family)}', ${fallback.map(sanitizeFallback).join(\", \")}`;\n    // Validate CSS variable name — reject anything that could inject CSS.\n    // Fall back to auto-generated name if invalid.\n    const defaultVarName = toVarName(family);\n    const cssVarName = options.variable\n      ? (sanitizeCSSVarName(options.variable) ?? defaultVarName)\n      : defaultVarName;\n    const id = createFontIdentity(family, options, cssVarName, fallback);\n    const classSegment = fontClassSegment(family);\n    const className = `__font_${classSegment}_${id}`;\n    // In Next.js, `variable` returns a CLASS NAME that sets the CSS variable.\n    // Users apply this class to set the CSS variable on that element.\n    const variableClassName = `__variable_${classSegment}_${id}`;\n\n    if (options._selfHostedCSS) {\n      // Self-hosted mode: inject local @font-face CSS instead of CDN link\n      injectSelfHostedCSS(options._selfHostedCSS);\n    } else {\n      // CDN mode: inject <link> to Google Fonts\n      const url = buildGoogleFontsUrl(family, options);\n      injectFontStylesheet(url);\n\n      // On SSR, collect the URL for head injection\n      if (typeof document === \"undefined\") {\n        if (!ssrFontUrls.includes(url)) {\n          ssrFontUrls.push(url);\n        }\n      }\n    }\n\n    // Inject a CSS rule that maps className to font-family.\n    // This is what makes `<div className={inter.className}>` work.\n    injectClassNameRule(className, fontFamily);\n\n    // Inject a CSS rule for the variable class name.\n    // This is what makes `<html className={inter.variable}>` set the CSS variable.\n    injectVariableClassRule(variableClassName, cssVarName, fontFamily);\n\n    return {\n      className,\n      style: { fontFamily },\n      variable: variableClassName,\n    };\n  };\n}\n\n// Export a Proxy that creates font loaders for any Google Font family.\n// Usage: import { Inter } from 'next/font/google'\n// The proxy intercepts property access and returns a loader for that font.\nconst googleFontLoaders: Record<string, FontLoader> = {};\n\nconst googleFonts = new Proxy(googleFontLoaders, {\n  get(_target, prop: string | symbol) {\n    if (typeof prop !== \"string\") return undefined;\n    if (prop === \"__esModule\") return true;\n    if (prop === \"default\") return googleFonts;\n    // Convert export-style names to proper font family names:\n    // - Underscores to spaces: \"Roboto_Mono\" -> \"Roboto Mono\"\n    // - PascalCase to spaces:  \"RobotoMono\"  -> \"Roboto Mono\"\n    const family = prop.replace(/_/g, \" \").replace(/([a-z])([A-Z])/g, \"$1 $2\");\n    return createFontLoader(family);\n  },\n});\n\nexport default googleFonts;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,SAAS,gBAAgB,OAAuB;AAC9C,QAAO,MACJ,QAAQ,OAAO,OAAO,CACtB,QAAQ,MAAM,MAAM,CACpB,QAAQ,OAAO,OAAO,CACtB,QAAQ,OAAO,OAAO;;;;;;;;;;;AAY3B,SAAS,mBAAmB,MAAkC;AAC5D,KAAI,qBAAqB,KAAK,KAAK,CAAE,QAAO;;;;;;;;;AAW9C,SAAS,iBAAiB,MAAsB;CAE9C,MAAM,WAAW,IAAI,IAAI;EACvB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC;CACF,MAAM,UAAU,KAAK,MAAM;AAC3B,KAAI,SAAS,IAAI,QAAQ,CAAE,QAAO;AAElC,QAAO,IAAI,gBAAgB,QAAQ,CAAC;;AAItC,MAAM,gCAAgB,IAAI,KAAa;;;;;AA0BvC,SAAS,UAAU,QAAwB;AACzC,QAAO,YAAY,OAAO,aAAa,CAAC,QAAQ,QAAQ,IAAI;;AAG9D,SAAS,iBAAiB,QAAwB;AAKhD,QAJgB,OACb,aAAa,CACb,QAAQ,iBAAiB,IAAI,CAC7B,QAAQ,YAAY,GAAG,IACR;;AAGpB,SAAS,yBAAyB,OAA8C;AAC9E,KAAI,CAAC,MAAO,QAAO;AAEnB,QAAO,CAAC,GAAG,IAAI,KADA,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,MAAM,EAC3B,KAAK,SAAS,KAAK,MAAM,CAAC,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI;;AAGzF,SAAS,sBAAsB,OAA8C;CAC3E,MAAM,aAAa,yBAAyB,MAAM;AAClD,QAAO,eAAe,aAAa,KAAK;;AAG1C,SAAS,qBAAqB,OAA8C;CAC1E,MAAM,SAAS,IAAI,KAChB,MAAM,QAAQ,MAAM,GAAG,QAAQ,QAAQ,CAAC,MAAM,GAAG,EAAE,EACjD,KAAK,SAAS,KAAK,MAAM,CAAC,CAC1B,OAAO,QAAQ,CACnB;CACD,MAAM,YAAY,OAAO,IAAI,SAAS;CACtC,MAAM,YAAY,OAAO,IAAI,SAAS;AACtC,KAAI,CAAC,UAAW,QAAO;AACvB,QAAO,YAAY,kBAAkB;;AAGvC,SAAS,wBAAwB,OAAqC;AACpE,KAAI,CAAC,MAAO,QAAO;AACnB,QAAO,MAAM,KAAK,SAAS,KAAK,MAAM,CAAC,CAAC,KAAK,IAAI;;AAGnD,SAAS,uBAAuB,OAAoC;AAClE,KAAI,UAAU,KAAA,EAAW,QAAO;AAChC,QAAO,QAAQ,MAAM;;AAGvB,SAAS,+BAA+B,OAA6C;AACnF,KAAI,UAAU,KAAA,EAAW,QAAO;AAChC,QAAO,OAAO,UAAU,YAAY,uBAAuB,MAAM,GAAG;;AAGtE,SAAS,WAAW,OAAuB;CACzC,IAAI,OAAO;AACX,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACrC,UAAQ,MAAM,WAAW,EAAE;AAC3B,SAAO,KAAK,KAAK,MAAM,SAAW,KAAK;;AAEzC,QAAO,KAAK,SAAS,GAAG,CAAC,SAAS,GAAG,IAAI;;AAG3C,SAAS,mBACP,QACA,SACA,YACA,UACQ;AACR,QAAO,WACL;EACE;EACA;EACA,sBAAsB,QAAQ,OAAO;EACrC,qBAAqB,QAAQ,MAAM;EACnC,yBAAyB,QAAQ,QAAQ;EACzC,QAAQ,WAAW;EACnB,uBAAuB,QAAQ,QAAQ;EACvC,wBAAwB,SAAS;EACjC,+BAA+B,QAAQ,mBAAmB;EAC1D,yBAAyB,QAAQ,KAAK;EACtC,QAAQ,kBAAkB;EAC3B,CAAC,KAAK,KAAK,CACb;;;;;;;;;;;;;;;;;;;;;AAsBH,SAAgB,oBAAoB,QAAgB,SAA8B;CAChF,MAAM,UAAU,QAAQ,SACpB,MAAM,QAAQ,QAAQ,OAAO,GAC3B,QAAQ,SACR,CAAC,QAAQ,OAAO,GAClB,EAAE;CACN,MAAM,SAAS,QAAQ,QACnB,MAAM,QAAQ,QAAQ,MAAM,GAC1B,QAAQ,QACR,CAAC,QAAQ,MAAM,GACjB,EAAE;CAEN,MAAM,YAAY,OAAO,SAAS,SAAS;CAC3C,MAAM,YAAY,OAAO,SAAS,SAAS;CAI3C,MAAM,OAAO,YAAY,CAAC,GAAI,YAAY,CAAC,IAAI,GAAG,EAAE,EAAG,IAAI,GAAG,KAAA;CAK9D,MAAM,oBAAoB,QAAQ,WAAW,KAAK,QAAQ,OAAO,aAAa,EAAE,GAAG;AASnF,QAAOA,sBAAiB,QAAQ;EAAE,MAFrB,kBAAkB,SAAS,IAAI,oBAAoB,OAAO,CAAC,MAAM,GAAG,KAAA;EAEzC;EAAM,EAAE,QAAQ,WAAW,OAAO;;;;;;AAO5E,SAAS,qBAAqB,KAAmB;AAC/C,KAAI,cAAc,IAAI,IAAI,CAAE;AAC5B,eAAc,IAAI,IAAI;AAEtB,KAAI,OAAO,aAAa,aAAa;EACnC,MAAM,OAAO,SAAS,cAAc,OAAO;AAC3C,OAAK,MAAM;AACX,OAAK,OAAO;AACZ,WAAS,KAAK,YAAY,KAAK;;;;AAKnC,MAAM,qCAAqB,IAAI,KAAa;;;;;;;;;;AAW5C,SAAS,oBAAoB,WAAmB,YAA0B;AACxE,KAAI,mBAAmB,IAAI,UAAU,CAAE;AACvC,oBAAmB,IAAI,UAAU;CAEjC,MAAM,MAAM,IAAI,UAAU,kBAAkB,WAAW;AAGvD,KAAI,OAAO,aAAa,aAAa;AACnC,gBAAc,KAAK,IAAI;AACvB;;CAIF,MAAM,QAAQ,SAAS,cAAc,QAAQ;AAC7C,OAAM,cAAc;AACpB,OAAM,aAAa,0BAA0B,UAAU;AACvD,UAAS,KAAK,YAAY,MAAM;;;AAIlC,MAAM,wCAAwB,IAAI,KAAa;;;;;;;;;;;;AAa/C,SAAS,wBACP,mBACA,YACA,YACM;AACN,KAAI,sBAAsB,IAAI,kBAAkB,CAAE;AAClD,uBAAsB,IAAI,kBAAkB;CAI5C,MAAM,MAAM,IAAI,kBAAkB,KAAK,WAAW,IAAI,WAAW;AAGjE,KAAI,OAAO,aAAa,aAAa;AACnC,gBAAc,KAAK,IAAI;AACvB;;CAIF,MAAM,QAAQ,SAAS,cAAc,QAAQ;AAC7C,OAAM,cAAc;AACpB,OAAM,aAAa,6BAA6B,kBAAkB;AAClE,UAAS,KAAK,YAAY,MAAM;;AAIlC,MAAM,gBAA0B,EAAE;;;;;;AAOlC,SAAgB,mBAA6B;AAC3C,QAAO,CAAC,GAAG,cAAc;;AAI3B,MAAM,cAAwB,EAAE;;;;;;AAOhC,SAAgB,kBAA4B;AAC1C,QAAO,CAAC,GAAG,YAAY;;AAIzB,MAAM,kBAAyD,EAAE;AACjE,MAAM,sCAAsB,IAAI,KAAa;;;;;;AAO7C,SAAgB,qBAA4D;AAC1E,QAAO,CAAC,GAAG,gBAAgB;;;;;AAM7B,SAAS,gBAAgB,WAA2B;AAClD,KAAI,UAAU,SAAS,SAAS,CAAE,QAAO;AACzC,KAAI,UAAU,SAAS,QAAQ,CAAE,QAAO;AACxC,KAAI,UAAU,SAAS,OAAO,CAAE,QAAO;AACvC,KAAI,UAAU,SAAS,OAAO,CAAE,QAAO;AACvC,QAAO;;;;;;AAOT,SAAS,uBAAuB,KAAuB;CACrD,MAAM,OAAiB,EAAE;CACzB,MAAM,WAAW;CACjB,IAAI;AACJ,SAAQ,QAAQ,SAAS,KAAK,IAAI,MAAM,MAAM;EAC5C,MAAM,MAAM,MAAM;AAElB,MAAI,OAAO,IAAI,WAAW,IAAI,CAC5B,MAAK,KAAK,IAAI;;AAGlB,QAAO;;;;;;AAOT,SAAS,2BAA2B,KAAmB;AACrD,KAAI,OAAO,aAAa,YAAa;CAErC,MAAM,OAAO,uBAAuB,IAAI;AACxC,MAAK,MAAM,QAAQ,KACjB,KAAI,CAAC,oBAAoB,IAAI,KAAK,EAAE;AAClC,sBAAoB,IAAI,KAAK;AAC7B,kBAAgB,KAAK;GAAE;GAAM,MAAM,gBAAgB,KAAK;GAAE,CAAC;;;;AAMjE,MAAM,qCAAqB,IAAI,KAAa;;;;;AAM5C,SAAS,oBAAoB,KAAmB;AAC9C,KAAI,mBAAmB,IAAI,IAAI,CAAE;AACjC,oBAAmB,IAAI,IAAI;AAG3B,4BAA2B,IAAI;AAE/B,KAAI,OAAO,aAAa,aAAa;AAEnC,gBAAc,KAAK,IAAI;AACvB;;CAIF,MAAM,QAAQ,SAAS,cAAc,QAAQ;AAC7C,OAAM,cAAc;AACpB,OAAM,aAAa,+BAA+B,OAAO;AACzD,UAAS,KAAK,YAAY,MAAM;;AAKlC,SAAgB,iBAAiB,QAA4B;AAC3D,QAAO,SAAS,WAAW,UAA6B,EAAE,EAAc;EACtE,MAAM,WAAW,QAAQ,YAAY,CAAC,aAAa;EAEnD,MAAM,aAAa,IAAI,gBAAgB,OAAO,CAAC,KAAK,SAAS,IAAI,iBAAiB,CAAC,KAAK,KAAK;EAG7F,MAAM,iBAAiB,UAAU,OAAO;EACxC,MAAM,aAAa,QAAQ,WACtB,mBAAmB,QAAQ,SAAS,IAAI,iBACzC;EACJ,MAAM,KAAK,mBAAmB,QAAQ,SAAS,YAAY,SAAS;EACpE,MAAM,eAAe,iBAAiB,OAAO;EAC7C,MAAM,YAAY,UAAU,aAAa,GAAG;EAG5C,MAAM,oBAAoB,cAAc,aAAa,GAAG;AAExD,MAAI,QAAQ,eAEV,qBAAoB,QAAQ,eAAe;OACtC;GAEL,MAAM,MAAM,oBAAoB,QAAQ,QAAQ;AAChD,wBAAqB,IAAI;AAGzB,OAAI,OAAO,aAAa;QAClB,CAAC,YAAY,SAAS,IAAI,CAC5B,aAAY,KAAK,IAAI;;;AAO3B,sBAAoB,WAAW,WAAW;AAI1C,0BAAwB,mBAAmB,YAAY,WAAW;AAElE,SAAO;GACL;GACA,OAAO,EAAE,YAAY;GACrB,UAAU;GACX;;;AASL,MAAM,cAAc,IAAI,MAF8B,EAAE,EAEP,EAC/C,IAAI,SAAS,MAAuB;AAClC,KAAI,OAAO,SAAS,SAAU,QAAO,KAAA;AACrC,KAAI,SAAS,aAAc,QAAO;AAClC,KAAI,SAAS,UAAW,QAAO;AAK/B,QAAO,iBADQ,KAAK,QAAQ,MAAM,IAAI,CAAC,QAAQ,mBAAmB,QAAQ,CAC3C;GAElC,CAAC"}
+{"version":3,"file":"font-google-base.js","names":["buildUrlFromAxes"],"sources":["../../src/shims/font-google-base.ts"],"sourcesContent":["import { buildGoogleFontsUrl as buildUrlFromAxes } from \"../build/google-fonts/build-url.js\";\nimport {\n  escapeCSSString,\n  formatFontClassRule,\n  resolveSingleFaceStyle,\n  sanitizeCSSVarName,\n  sanitizeFallback,\n  type FontStyle,\n} from \"./font-utils.js\";\n\n/**\n * next/font/google shim\n *\n * Provides a compatible shim for Next.js Google Fonts.\n *\n * Two modes:\n * 1. **Dev / CDN mode** (default): Loads fonts from Google Fonts CDN via <link> tags.\n * 2. **Self-hosted mode** (production build): The vinext:google-fonts Vite plugin\n *    fetches font CSS + .woff2 files at build time, caches them locally, and injects\n *    @font-face CSS pointing at local assets. No requests to Google at runtime.\n *\n * Usage:\n *   import { Inter } from 'next/font/google';\n *   const inter = Inter({ subsets: ['latin'], weight: ['400', '700'] });\n *   // inter.className -> stable CSS class for this font/options pair\n *   // inter.style -> { fontFamily: \"'Inter', 'Inter Fallback'\", fontStyle: \"normal\" }\n *   // inter.variable -> CSS class that sets the font CSS variable when requested\n */\n\n// Track which font stylesheets have been injected (SSR + client)\nconst injectedFonts = new Set<string>();\n\nexport type FontOptions = {\n  weight?: string | string[];\n  style?: string | string[];\n  subsets?: string[];\n  display?: string;\n  preload?: boolean;\n  fallback?: string[];\n  adjustFontFallback?: boolean | string;\n  variable?: string;\n  axes?: string[];\n};\n\nexport type FontResult = {\n  className: string;\n  style: FontStyle;\n  variable?: string;\n};\n\ntype InternalGoogleFontRuntimeOptions = {\n  selfHostedCSS?: string;\n  adjustedFallbackCSS?: string;\n  fontWeight?: number;\n  fontStyle?: \"normal\" | \"italic\";\n};\n\ntype FontLoaderOptions = FontOptions & {\n  /**\n   * Internal payload injected by the vinext:google-fonts transform after\n   * metadata validation. Runtime must prefer these values over user options\n   * because they represent the resolved Next-compatible face, including\n   * metadata defaults such as italic-only families.\n   */\n  _vinext?: {\n    font?: InternalGoogleFontRuntimeOptions;\n  };\n};\n\n/**\n * Convert a font family name to a CSS variable name.\n * e.g., \"Inter\" -> \"--font-inter\", \"Roboto Mono\" -> \"--font-roboto-mono\"\n */\nfunction toVarName(family: string): string {\n  return \"--font-\" + family.toLowerCase().replace(/\\s+/g, \"-\");\n}\n\nfunction fontClassSegment(family: string): string {\n  const segment = family\n    .toLowerCase()\n    .replace(/[^a-z0-9_-]+/g, \"_\")\n    .replace(/^_+|_+$/g, \"\");\n  return segment || \"font\";\n}\n\nfunction normalizeStringSetOption(value: string | string[] | undefined): string {\n  if (!value) return \"\";\n  const values = Array.isArray(value) ? value : [value];\n  return [...new Set(values.map((item) => item.trim()).filter(Boolean))].sort().join(\",\");\n}\n\nfunction normalizeWeightOption(value: string | string[] | undefined): string {\n  const normalized = normalizeStringSetOption(value);\n  return normalized === \"variable\" ? \"\" : normalized;\n}\n\nfunction normalizeStyleOption(value: string | string[] | undefined): string {\n  const values = new Set(\n    (Array.isArray(value) ? value : value ? [value] : [])\n      .map((item) => item.trim())\n      .filter(Boolean),\n  );\n  const hasItalic = values.has(\"italic\");\n  const hasNormal = values.has(\"normal\");\n  if (!hasItalic) return \"\";\n  return hasNormal ? \"italic,normal\" : \"italic\";\n}\n\nfunction normalizeFallbackOption(value: string[] | undefined): string {\n  if (!value) return \"\";\n  return value.map((item) => item.trim()).join(\",\");\n}\n\nfunction normalizeBooleanOption(value: boolean | undefined): string {\n  if (value === undefined) return \"\";\n  return value ? \"1\" : \"0\";\n}\n\nfunction normalizeStringOrBooleanOption(value: boolean | string | undefined): string {\n  if (value === undefined) return \"\";\n  return typeof value === \"boolean\" ? normalizeBooleanOption(value) : value;\n}\n\nfunction hashString(value: string): string {\n  let hash = 0x811c9dc5;\n  for (let i = 0; i < value.length; i++) {\n    hash ^= value.charCodeAt(i);\n    hash = Math.imul(hash, 0x01000193) >>> 0;\n  }\n  return hash.toString(36).padStart(7, \"0\");\n}\n\nfunction createFontIdentity(\n  family: string,\n  options: FontLoaderOptions,\n  cssVarName: string,\n  fallback: string[],\n): string {\n  return hashString(\n    [\n      family,\n      cssVarName,\n      normalizeWeightOption(options.weight),\n      normalizeStyleOption(options.style),\n      normalizeStringSetOption(options.subsets),\n      options.display ?? \"swap\",\n      normalizeBooleanOption(options.preload),\n      normalizeFallbackOption(fallback),\n      normalizeStringOrBooleanOption(options.adjustFontFallback),\n      normalizeStringSetOption(options.axes),\n      options._vinext?.font?.selfHostedCSS ?? \"\",\n      options._vinext?.font?.fontWeight?.toString() ?? \"\",\n      options._vinext?.font?.fontStyle ?? \"\",\n    ].join(\"\\0\"),\n  );\n}\n\n/**\n * Build a Google Fonts CSS URL.\n *\n * In production this code path is dead. The build plugin\n * (`vinext:google-fonts` in `src/plugins/fonts.ts`) statically resolves\n * each font call's axis values against the bundled metadata, fetches the\n * Google Fonts CSS, and injects the resulting CSS as\n * `_vinext.font.selfHostedCSS` so the runtime never queries Google. The shim\n * only reaches this builder when the plugin's static parser bails (dynamic\n * options, eval-only shapes), which is dev-only.\n *\n * The dev fallback intentionally has no metadata: shipping the 388 KB\n * `font-data.json` to the Worker bundle would dwarf the rest of the shim,\n * and the production path already has the metadata-aware variant. The\n * tradeoff is that the dev fallback cannot resolve a variable font's\n * actual `wght` axis range. It emits no axis segment when no `weight` is\n * given, which makes Google return the default static face (200) instead\n * of the broken `:wght@100..900` URL that issue #885 reports.\n */\nexport function buildGoogleFontsUrl(family: string, options: FontOptions): string {\n  const weights = options.weight\n    ? Array.isArray(options.weight)\n      ? options.weight\n      : [options.weight]\n    : [];\n  const styles = options.style\n    ? Array.isArray(options.style)\n      ? options.style\n      : [options.style]\n    : [];\n\n  const hasItalic = styles.includes(\"italic\");\n  const hasNormal = styles.includes(\"normal\");\n  // Google treats omitted ital as ital=0, so italic-only requests emit\n  // ['1']; mixed requests emit ['0','1']; normal-only stays undefined so\n  // the URL has no ital axis at all.\n  const ital = hasItalic ? [...(hasNormal ? [\"0\"] : []), \"1\"] : undefined;\n\n  // The dev fallback has no metadata, so the variable sentinel cannot be\n  // resolved to the font's real axis range here. Drop it like empty options\n  // instead of emitting the invalid Google Fonts URL `:wght@variable`.\n  const normalizedWeights = weights.length === 1 && weights[0] === \"variable\" ? [] : weights;\n\n  // Italic-only with no explicit weight still needs a wght value or the\n  // ital axis has nowhere to attach in Google's URL grammar. Fall back to\n  // '400' because every Google Font has it and it is the visible default.\n  // The plugin's metadata-aware path covers the variable-font case in\n  // production.\n  const wght = normalizedWeights.length > 0 ? normalizedWeights : ital ? [\"400\"] : undefined;\n\n  return buildUrlFromAxes(family, { wght, ital }, options.display ?? \"swap\");\n}\n\n/**\n * Inject a <link> tag for the font (client-side only).\n * On the server, we track font URLs for SSR head injection.\n */\nfunction injectFontStylesheet(url: string): void {\n  if (injectedFonts.has(url)) return;\n  injectedFonts.add(url);\n\n  if (typeof document !== \"undefined\") {\n    const link = document.createElement(\"link\");\n    link.rel = \"stylesheet\";\n    link.href = url;\n    document.head.appendChild(link);\n  }\n}\n\n/** Track which className CSS rules have been injected. */\nconst injectedClassRules = new Set<string>();\n\n/**\n * Inject a CSS rule that maps a className to the exported font style.\n *\n * This is what makes `<div className={inter.className}>` apply the font.\n * Next.js generates equivalent rules at build time.\n *\n * In Next.js, the .className class sets font-family and any single\n * font-weight/font-style. CSS variables are handled separately by .variable.\n */\nfunction injectClassNameRule(className: string, fontStyle: FontStyle): void {\n  if (injectedClassRules.has(className)) return;\n  injectedClassRules.add(className);\n\n  const css = formatFontClassRule(className, fontStyle);\n\n  // On server, store the CSS for SSR injection\n  if (typeof document === \"undefined\") {\n    ssrFontStyles.push(css);\n    return;\n  }\n\n  // On client, inject a <style> tag\n  const styleElement = document.createElement(\"style\");\n  styleElement.textContent = css;\n  styleElement.setAttribute(\"data-vinext-font-class\", className);\n  document.head.appendChild(styleElement);\n}\n\n/** Track which variable class CSS rules have been injected. */\nconst injectedVariableRules = new Set<string>();\n\n/**\n * Inject a CSS rule that sets a CSS variable on an element.\n * This is what makes `<html className={inter.variable}>` set the CSS variable\n * that can be referenced by other styles (e.g., Tailwind's font-sans).\n *\n * In Next.js, the .variable class ONLY sets the CSS variable — it does NOT\n * set font-family. This is critical because apps commonly apply multiple\n * .variable classes to <body> (e.g., geistSans.variable + geistMono.variable).\n * If we also set font-family here, the last class wins due to CSS cascade,\n * causing all text to use that font (e.g., everything becomes monospace).\n */\nfunction injectVariableClassRule(\n  variableClassName: string,\n  cssVarName: string,\n  fontFamily: string,\n): void {\n  if (injectedVariableRules.has(variableClassName)) return;\n  injectedVariableRules.add(variableClassName);\n\n  // Only set the CSS variable — do NOT set font-family.\n  // This matches Next.js behavior where .variable classes only define CSS variables.\n  const css = `.${variableClassName} { ${cssVarName}: ${fontFamily}; }\\n`;\n\n  // On server, store the CSS for SSR injection\n  if (typeof document === \"undefined\") {\n    ssrFontStyles.push(css);\n    return;\n  }\n\n  // On client, inject a <style> tag\n  const style = document.createElement(\"style\");\n  style.textContent = css;\n  style.setAttribute(\"data-vinext-font-variable\", variableClassName);\n  document.head.appendChild(style);\n}\n\n// SSR: collect font class CSS for injection in <head>\nconst ssrFontStyles: string[] = [];\n\n/**\n * Get collected SSR font class styles (used by the renderer).\n * Note: We don't clear the arrays because fonts are loaded at module import\n * time and need to persist across all requests in the Workers environment.\n */\nexport function getSSRFontStyles(): string[] {\n  return [...ssrFontStyles];\n}\n\n// SSR: collect font URLs to inject in <head>\nconst ssrFontUrls: string[] = [];\n\n/**\n * Get collected SSR font URLs (used by the renderer).\n * Note: We don't clear the arrays because fonts are loaded at module import\n * time and need to persist across all requests in the Workers environment.\n */\nexport function getSSRFontLinks(): string[] {\n  return [...ssrFontUrls];\n}\n\n// SSR: collect font file URLs for <link rel=\"preload\"> injection (self-hosted Google fonts)\nconst ssrFontPreloads: Array<{ href: string; type: string }> = [];\nconst ssrFontPreloadHrefs = new Set<string>();\n\n/**\n * Get collected SSR font preload data (used by the renderer).\n * Returns an array of { href, type } objects for emitting\n * <link rel=\"preload\" as=\"font\" ...> tags.\n */\nexport function getSSRFontPreloads(): Array<{ href: string; type: string }> {\n  return [...ssrFontPreloads];\n}\n\n/**\n * Determine the MIME type for a font file based on its extension.\n */\nfunction getFontMimeType(pathOrUrl: string): string {\n  if (pathOrUrl.endsWith(\".woff2\")) return \"font/woff2\";\n  if (pathOrUrl.endsWith(\".woff\")) return \"font/woff\";\n  if (pathOrUrl.endsWith(\".ttf\")) return \"font/ttf\";\n  if (pathOrUrl.endsWith(\".otf\")) return \"font/opentype\";\n  return \"font/woff2\";\n}\n\n/**\n * Extract font file URLs from @font-face CSS rules.\n * Parses url('...') references from the CSS text.\n */\nfunction extractFontUrlsFromCSS(css: string): string[] {\n  const urls: string[] = [];\n  const urlRegex = /url\\(['\"]?([^'\")]+)['\"]?\\)/g;\n  let match: RegExpExecArray | null;\n  while ((match = urlRegex.exec(css)) !== null) {\n    const url = match[1];\n    // Only collect absolute paths (starting with /) — these are self-hosted font files\n    if (url && url.startsWith(\"/\")) {\n      urls.push(url);\n    }\n  }\n  return urls;\n}\n\n/**\n * Collect font file URLs from self-hosted CSS for preload link generation.\n * Only collects on the server (SSR). Deduplicates by href using a Set for O(1) lookups.\n */\nfunction collectFontPreloadsFromCSS(css: string): void {\n  if (typeof document !== \"undefined\") return; // client-side, skip\n\n  const urls = extractFontUrlsFromCSS(css);\n  for (const href of urls) {\n    if (!ssrFontPreloadHrefs.has(href)) {\n      ssrFontPreloadHrefs.add(href);\n      ssrFontPreloads.push({ href, type: getFontMimeType(href) });\n    }\n  }\n}\n\n/** Track injected self-hosted @font-face blocks (deduplicate) */\nconst injectedSelfHosted = new Set<string>();\n\n/**\n * Inject self-hosted @font-face CSS (from the build plugin).\n * This replaces the CDN <link> tag with inline CSS.\n */\nfunction injectSelfHostedCSS(css: string): void {\n  if (injectedSelfHosted.has(css)) return;\n  injectedSelfHosted.add(css);\n\n  // Extract font file URLs for preload hints (SSR only)\n  collectFontPreloadsFromCSS(css);\n\n  if (typeof document === \"undefined\") {\n    // SSR: add to collected styles\n    ssrFontStyles.push(css);\n    return;\n  }\n\n  // Client: inject <style> tag\n  const style = document.createElement(\"style\");\n  style.textContent = css;\n  style.setAttribute(\"data-vinext-font-selfhosted\", \"true\");\n  document.head.appendChild(style);\n}\n\nexport type FontLoader = (options?: FontLoaderOptions) => FontResult;\n\nexport function createFontLoader(family: string): FontLoader {\n  return function fontLoader(options: FontLoaderOptions = {}): FontResult {\n    const internal = options._vinext?.font;\n    const fallback = options.fallback ?? [];\n    // The adjusted fallback family name must match the font-family emitted by\n    // buildFallbackFontFace() in build/google-fonts/fallback-metrics.ts ('{family} Fallback').\n    // Keep these two sites in sync to prevent silent fallback mismatches.\n    const adjustedFallback =\n      options.adjustFontFallback === false || !internal?.adjustedFallbackCSS\n        ? []\n        : [`'${escapeCSSString(family)} Fallback'`];\n    // Sanitize each fallback name to prevent CSS injection via crafted values\n    const fontFamily = [\n      `'${escapeCSSString(family)}'`,\n      ...adjustedFallback,\n      ...fallback.map(sanitizeFallback),\n    ].join(\", \");\n    // Validate CSS variable name — reject anything that could inject CSS.\n    // Fall back to auto-generated name if invalid.\n    const defaultVarName = toVarName(family);\n    const cssVarName = options.variable\n      ? (sanitizeCSSVarName(options.variable) ?? defaultVarName)\n      : defaultVarName;\n    const id = createFontIdentity(family, options, cssVarName, fallback);\n    const classSegment = fontClassSegment(family);\n    const className = `__font_${classSegment}_${id}`;\n    // In Next.js, `variable` returns a CLASS NAME that sets the CSS variable.\n    // Users apply this class to set the CSS variable on that element.\n    const variableClassName = `__variable_${classSegment}_${id}`;\n    const style = resolveSingleFaceStyle({\n      fontFamily,\n      weight: options.weight,\n      style: options.style,\n      internalWeight: internal?.fontWeight,\n      internalStyle: internal?.fontStyle,\n      google: true,\n    });\n\n    if (internal?.selfHostedCSS) {\n      // Self-hosted mode: inject local @font-face CSS instead of CDN link\n      injectSelfHostedCSS(internal.selfHostedCSS);\n    } else {\n      // CDN mode: inject <link> to Google Fonts\n      const url = buildGoogleFontsUrl(family, options);\n      injectFontStylesheet(url);\n\n      // On SSR, collect the URL for head injection\n      if (typeof document === \"undefined\") {\n        if (!ssrFontUrls.includes(url)) {\n          ssrFontUrls.push(url);\n        }\n      }\n    }\n\n    if (options.adjustFontFallback !== false && internal?.adjustedFallbackCSS) {\n      injectSelfHostedCSS(internal.adjustedFallbackCSS);\n    }\n\n    // Inject a CSS rule that maps className to font-family.\n    // This is what makes `<div className={inter.className}>` work.\n    injectClassNameRule(className, style);\n\n    if (options.variable) {\n      // Inject a CSS rule for the variable class name.\n      // This is what makes `<html className={inter.variable}>` set the CSS variable.\n      injectVariableClassRule(variableClassName, cssVarName, fontFamily);\n    }\n\n    return {\n      className,\n      style,\n      ...(options.variable ? { variable: variableClassName } : {}),\n    };\n  };\n}\n\n// Export a Proxy that creates font loaders for any Google Font family.\n// Usage: import { Inter } from 'next/font/google'\n// The proxy intercepts property access and returns a loader for that font.\nconst googleFontLoaders: Record<string, FontLoader> = {};\n\nconst googleFonts = new Proxy(googleFontLoaders, {\n  get(_target, prop: string | symbol) {\n    if (typeof prop !== \"string\") return undefined;\n    if (prop === \"__esModule\") return true;\n    if (prop === \"default\") return googleFonts;\n    // Convert export-style names to proper font family names:\n    // - Underscores to spaces: \"Roboto_Mono\" -> \"Roboto Mono\"\n    // - PascalCase to spaces:  \"RobotoMono\"  -> \"Roboto Mono\"\n    const family = prop.replace(/_/g, \" \").replace(/([a-z])([A-Z])/g, \"$1 $2\");\n    return createFontLoader(family);\n  },\n});\n\nexport default googleFonts;\n"],"mappings":"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"}

package/dist/shims/font-local.d.ts

@@ -1,21 +1,6 @@
+import { FontStyle } from "./font-utils.js";
+
 //#region src/shims/font-local.d.ts
-/**
- * next/font/local shim
- *
- * Provides a runtime-compatible shim for Next.js local fonts.
- * Generates @font-face CSS declarations and returns an object
- * with className, style, and variable properties.
- *
- * Supports both client-side injection and SSR collection,
- * matching the patterns used by the Google font shim.
- *
- * Usage:
- *   import localFont from 'next/font/local';
- *   const myFont = localFont({ src: './my-font.woff2' });
- *   // myFont.className -> unique CSS class
- *   // myFont.style -> { fontFamily: "'__local_font_0', sans-serif" }
- *   // myFont.variable -> generated class name (e.g. "__variable_local_0")
- */
 type LocalFontSrc = {
   path: string;
   weight?: string;
@@ -37,9 +22,7 @@ type LocalFontOptions = {
 };
 type FontResult = {
   className: string;
-  style: {
-    fontFamily: string;
-  };
+  style: FontStyle;
   variable?: string;
 };
 /**

package/dist/shims/font-local.js

@@ -1,3 +1,4 @@
+import { escapeCSSString, formatFontClassRule, resolveSingleFaceStyle, sanitizeCSSVarName, sanitizeFallback, sanitizeFontDescriptorValue } from "./font-utils.js";
 //#region src/shims/font-local.ts
 /**
 * next/font/local shim
@@ -14,57 +15,9 @@
 *   const myFont = localFont({ src: './my-font.woff2' });
 *   // myFont.className -> unique CSS class
 *   // myFont.style -> { fontFamily: "'__local_font_0', sans-serif" }
-*   // myFont.variable -> generated class name (e.g. "__variable_local_0")
+*   // myFont.variable -> generated class name when requested
 */
 /**
-* Escape a string for safe interpolation inside a CSS single-quoted string.
-*
-* Prevents CSS injection by escaping characters that could break out of
-* a `'...'` CSS string context: backslashes, single quotes, and newlines.
-*/
-function escapeCSSString(value) {
-	return value.replace(/\\/g, "\\\\").replace(/'/g, "\\'").replace(/\n/g, "\\a ").replace(/\r/g, "\\d ");
-}
-/**
-* Validate a CSS custom property name (e.g. `--font-inter`).
-*
-* Custom properties must start with `--` and only contain alphanumeric
-* characters, hyphens, and underscores. Anything else could be used to
-* break out of the CSS declaration and inject arbitrary rules.
-*
-* Returns the name if valid, undefined otherwise.
-*/
-function sanitizeCSSVarName(name) {
-	if (/^--[a-zA-Z0-9_-]+$/.test(name)) return name;
-}
-/**
-* Sanitize a CSS font-family fallback name.
-*
-* Generic family names (sans-serif, serif, monospace, etc.) are used as-is.
-* Named families are wrapped in escaped quotes. This prevents injection via
-* crafted fallback values like `); } body { color: red; } .x {`.
-*/
-function sanitizeFallback(name) {
-	const generics = new Set([
-		"serif",
-		"sans-serif",
-		"monospace",
-		"cursive",
-		"fantasy",
-		"system-ui",
-		"ui-serif",
-		"ui-sans-serif",
-		"ui-monospace",
-		"ui-rounded",
-		"emoji",
-		"math",
-		"fangsong"
-	]);
-	const trimmed = name.trim();
-	if (generics.has(trimmed)) return trimmed;
-	return `'${escapeCSSString(trimmed)}'`;
-}
-/**
 * Validate a CSS property name for use in declarations.
 *
 * Only allows standard CSS property names (lowercase letters and hyphens)
@@ -74,25 +27,14 @@ function sanitizeFallback(name) {
 function sanitizeCSSProperty(prop) {
 	if (/^(--)?[a-zA-Z][a-zA-Z0-9-]*$/.test(prop)) return prop;
 }
-/**
-* Sanitize a CSS property value for use in declarations.
-*
-* Rejects values containing characters that could break out of a CSS
-* declaration: `{`, `}`, `;`, and `</` (to prevent closing style tags).
-*/
-function sanitizeCSSValue(value) {
-	if (/[{}]|<\//.test(value)) return void 0;
-	return value;
-}
 let classCounter = 0;
 const injectedFonts = /* @__PURE__ */ new Set();
-function generateFontFaceCSS(family, options) {
-	const sources = normalizeSources(options);
+function generateFontFaceCSS(family, options, sources) {
 	const display = options.display ?? "swap";
 	const rules = [];
 	for (const src of sources) {
-		const weight = src.weight ?? options.weight ?? "400";
-		const style = src.style ?? options.style ?? "normal";
+		const weight = sanitizeFontDescriptorValue(src.weight ?? options.weight ?? "400") ?? "400";
+		const style = sanitizeFontDescriptorValue(src.style ?? options.style ?? "normal") ?? "normal";
 		const format = src.path.endsWith(".woff2") ? "woff2" : src.path.endsWith(".woff") ? "woff" : src.path.endsWith(".ttf") ? "truetype" : src.path.endsWith(".otf") ? "opentype" : "woff2";
 		rules.push(`@font-face {
   font-family: '${escapeCSSString(family)}';
@@ -104,7 +46,7 @@ function generateFontFaceCSS(family, options) {
 	}
 	if (options.declarations) for (const decl of options.declarations) {
 		const safeProp = sanitizeCSSProperty(decl.prop);
-		const safeValue = sanitizeCSSValue(decl.value);
+		const safeValue = sanitizeFontDescriptorValue(decl.value);
 		if (safeProp && safeValue) rules.push(`@font-face { font-family: '${escapeCSSString(family)}'; ${safeProp}: ${safeValue}; }`);
 	}
 	return rules.join("\n");
@@ -143,17 +85,17 @@ function injectFontFaceCSS(css, id) {
 /** Track which className CSS rules have been injected. */
 const injectedClassRules = /* @__PURE__ */ new Set();
 /**
-* Inject a CSS rule that maps a className to a font-family.
+* Inject a CSS rule that maps a className to the exported font style.
 *
 * This is what makes `<div className={font.className}>` apply the font.
 *
-* In Next.js, the .className class ONLY sets font-family — it does NOT
-* set CSS variables. CSS variables are handled separately by the .variable class.
+* In Next.js, the .className class sets font-family and any single
+* font-weight/font-style. CSS variables are handled separately by .variable.
 */
-function injectClassNameRule(className, fontFamily) {
+function injectClassNameRule(className, fontStyle) {
 	if (injectedClassRules.has(className)) return;
 	injectedClassRules.add(className);
-	const css = `.${className} { font-family: ${fontFamily}; }\n`;
+	const css = formatFontClassRule(className, fontStyle);
 	if (typeof document === "undefined") {
 		ssrFontStyles.push(css);
 		return;
@@ -220,9 +162,8 @@ function getFontMimeType(pathOrUrl) {
 * Collect font source URLs for preload link generation.
 * Only collects on the server (SSR). Deduplicates by href using a Set for O(1) lookups.
 */
-function collectFontPreloads(options) {
+function collectFontPreloads(sources) {
 	if (typeof document !== "undefined") return;
-	const sources = normalizeSources(options);
 	for (const src of sources) {
 		const href = src.path;
 		if (href && href.startsWith("/") && !ssrFontPreloadHrefs.has(href)) {
@@ -236,18 +177,25 @@ function collectFontPreloads(options) {
 }
 function localFont(options) {
 	const id = classCounter++;
+	const sources = normalizeSources(options);
+	const singleSource = sources.length === 1 ? sources[0] : void 0;
 	const family = `__local_font_${id}`;
 	const className = `__font_local_${id}`;
 	const fontFamily = `'${family}', ${(options.fallback ?? ["sans-serif"]).map(sanitizeFallback).join(", ")}`;
 	const cssVarName = options.variable ? sanitizeCSSVarName(options.variable) : void 0;
 	const variableClassName = `__variable_local_${id}`;
-	collectFontPreloads(options);
-	injectFontFaceCSS(generateFontFaceCSS(family, options), family);
-	injectClassNameRule(className, fontFamily);
+	const style = singleSource ? resolveSingleFaceStyle({
+		fontFamily,
+		weight: singleSource.weight ?? options.weight,
+		style: singleSource.style ?? options.style
+	}) : { fontFamily };
+	collectFontPreloads(sources);
+	injectFontFaceCSS(generateFontFaceCSS(family, options, sources), family);
+	injectClassNameRule(className, style);
 	if (cssVarName) injectVariableClassRule(variableClassName, cssVarName, fontFamily);
 	return {
 		className,
-		style: { fontFamily },
+		style,
 		...cssVarName ? { variable: variableClassName } : {}
 	};
 }

package/dist/shims/font-local.js.map

@@ -1 +1 @@
-{"version":3,"file":"font-local.js","names":[],"sources":["../../src/shims/font-local.ts"],"sourcesContent":["/**\n * next/font/local shim\n *\n * Provides a runtime-compatible shim for Next.js local fonts.\n * Generates @font-face CSS declarations and returns an object\n * with className, style, and variable properties.\n *\n * Supports both client-side injection and SSR collection,\n * matching the patterns used by the Google font shim.\n *\n * Usage:\n *   import localFont from 'next/font/local';\n *   const myFont = localFont({ src: './my-font.woff2' });\n *   // myFont.className -> unique CSS class\n *   // myFont.style -> { fontFamily: \"'__local_font_0', sans-serif\" }\n *   // myFont.variable -> generated class name (e.g. \"__variable_local_0\")\n */\n\n/**\n * Escape a string for safe interpolation inside a CSS single-quoted string.\n *\n * Prevents CSS injection by escaping characters that could break out of\n * a `'...'` CSS string context: backslashes, single quotes, and newlines.\n */\nfunction escapeCSSString(value: string): string {\n  return value\n    .replace(/\\\\/g, \"\\\\\\\\\")\n    .replace(/'/g, \"\\\\'\")\n    .replace(/\\n/g, \"\\\\a \")\n    .replace(/\\r/g, \"\\\\d \");\n}\n\n/**\n * Validate a CSS custom property name (e.g. `--font-inter`).\n *\n * Custom properties must start with `--` and only contain alphanumeric\n * characters, hyphens, and underscores. Anything else could be used to\n * break out of the CSS declaration and inject arbitrary rules.\n *\n * Returns the name if valid, undefined otherwise.\n */\nfunction sanitizeCSSVarName(name: string): string | undefined {\n  if (/^--[a-zA-Z0-9_-]+$/.test(name)) return name;\n  return undefined;\n}\n\n/**\n * Sanitize a CSS font-family fallback name.\n *\n * Generic family names (sans-serif, serif, monospace, etc.) are used as-is.\n * Named families are wrapped in escaped quotes. This prevents injection via\n * crafted fallback values like `); } body { color: red; } .x {`.\n */\nfunction sanitizeFallback(name: string): string {\n  // CSS generic font families — safe to use unquoted\n  const generics = new Set([\n    \"serif\",\n    \"sans-serif\",\n    \"monospace\",\n    \"cursive\",\n    \"fantasy\",\n    \"system-ui\",\n    \"ui-serif\",\n    \"ui-sans-serif\",\n    \"ui-monospace\",\n    \"ui-rounded\",\n    \"emoji\",\n    \"math\",\n    \"fangsong\",\n  ]);\n  const trimmed = name.trim();\n  if (generics.has(trimmed)) return trimmed;\n  // Wrap in single quotes with escaping to prevent CSS injection\n  return `'${escapeCSSString(trimmed)}'`;\n}\n\n/**\n * Validate a CSS property name for use in declarations.\n *\n * Only allows standard CSS property names (lowercase letters and hyphens)\n * and custom properties (--prefixed). Rejects anything that could inject\n * CSS rules via crafted property names.\n */\nfunction sanitizeCSSProperty(prop: string): string | undefined {\n  if (/^(--)?[a-zA-Z][a-zA-Z0-9-]*$/.test(prop)) return prop;\n  return undefined;\n}\n\n/**\n * Sanitize a CSS property value for use in declarations.\n *\n * Rejects values containing characters that could break out of a CSS\n * declaration: `{`, `}`, `;`, and `</` (to prevent closing style tags).\n */\nfunction sanitizeCSSValue(value: string): string | undefined {\n  if (/[{}]|<\\//.test(value)) return undefined;\n  return value;\n}\n\nlet classCounter = 0;\nconst injectedFonts = new Set<string>();\n\ntype LocalFontSrc = {\n  path: string;\n  weight?: string;\n  style?: string;\n};\n\ntype LocalFontOptions = {\n  src: string | LocalFontSrc | LocalFontSrc[];\n  display?: string;\n  weight?: string;\n  style?: string;\n  fallback?: string[];\n  preload?: boolean;\n  variable?: string;\n  adjustFontFallback?: boolean | string;\n  declarations?: Array<{ prop: string; value: string }>;\n};\n\ntype FontResult = {\n  className: string;\n  style: { fontFamily: string };\n  variable?: string;\n};\n\nfunction generateFontFaceCSS(family: string, options: LocalFontOptions): string {\n  const sources = normalizeSources(options);\n\n  const display = options.display ?? \"swap\";\n  const rules: string[] = [];\n\n  for (const src of sources) {\n    const weight = src.weight ?? options.weight ?? \"400\";\n    const style = src.style ?? options.style ?? \"normal\";\n    const format = src.path.endsWith(\".woff2\")\n      ? \"woff2\"\n      : src.path.endsWith(\".woff\")\n        ? \"woff\"\n        : src.path.endsWith(\".ttf\")\n          ? \"truetype\"\n          : src.path.endsWith(\".otf\")\n            ? \"opentype\"\n            : \"woff2\";\n\n    rules.push(`@font-face {\n  font-family: '${escapeCSSString(family)}';\n  src: url('${escapeCSSString(src.path)}') format('${format}');\n  font-weight: ${weight};\n  font-style: ${style};\n  font-display: ${display};\n}`);\n  }\n\n  // Add extra declarations if provided — sanitize prop/value to prevent injection\n  if (options.declarations) {\n    for (const decl of options.declarations) {\n      const safeProp = sanitizeCSSProperty(decl.prop);\n      const safeValue = sanitizeCSSValue(decl.value);\n      if (safeProp && safeValue) {\n        rules.push(\n          `@font-face { font-family: '${escapeCSSString(family)}'; ${safeProp}: ${safeValue}; }`,\n        );\n      }\n    }\n  }\n\n  return rules.join(\"\\n\");\n}\n\n// SSR: collect font styles for injection in <head>\nconst ssrFontStyles: string[] = [];\n\n// SSR: collect font file URLs for <link rel=\"preload\"> injection\nconst ssrFontPreloads: Array<{ href: string; type: string }> = [];\nconst ssrFontPreloadHrefs = new Set<string>();\n\n/**\n * Get collected SSR font styles (used by the renderer).\n * Note: We don't clear the arrays because fonts are loaded at module import\n * time and need to persist across all requests in the Workers environment.\n */\nexport function getSSRFontStyles(): string[] {\n  return [...ssrFontStyles];\n}\n\n/**\n * Get collected SSR font preload data (used by the renderer).\n * Returns an array of { href, type } objects for emitting\n * <link rel=\"preload\" as=\"font\" ...> tags.\n */\nexport function getSSRFontPreloads(): Array<{ href: string; type: string }> {\n  return [...ssrFontPreloads];\n}\n\nfunction injectFontFaceCSS(css: string, id: string): void {\n  if (injectedFonts.has(id)) return;\n  injectedFonts.add(id);\n\n  // On server, store the CSS for SSR injection\n  if (typeof document === \"undefined\") {\n    ssrFontStyles.push(css);\n    return;\n  }\n\n  const style = document.createElement(\"style\");\n  style.textContent = css;\n  style.setAttribute(\"data-vinext-font\", id);\n  document.head.appendChild(style);\n}\n\n/** Track which className CSS rules have been injected. */\nconst injectedClassRules = new Set<string>();\n\n/**\n * Inject a CSS rule that maps a className to a font-family.\n *\n * This is what makes `<div className={font.className}>` apply the font.\n *\n * In Next.js, the .className class ONLY sets font-family — it does NOT\n * set CSS variables. CSS variables are handled separately by the .variable class.\n */\nfunction injectClassNameRule(className: string, fontFamily: string): void {\n  if (injectedClassRules.has(className)) return;\n  injectedClassRules.add(className);\n\n  const css = `.${className} { font-family: ${fontFamily}; }\\n`;\n\n  // On server, store the CSS for SSR injection\n  if (typeof document === \"undefined\") {\n    ssrFontStyles.push(css);\n    return;\n  }\n\n  // On client, inject a <style> tag\n  const style = document.createElement(\"style\");\n  style.textContent = css;\n  style.setAttribute(\"data-vinext-font-class\", className);\n  document.head.appendChild(style);\n}\n\n/** Track which variable class CSS rules have been injected. */\nconst injectedVariableRules = new Set<string>();\n\n/** Track which :root CSS variable rules have been injected. */\nconst injectedRootVariables = new Set<string>();\n\n/**\n * Inject a CSS rule that sets a CSS variable on an element.\n * This is what makes `<html className={font.variable}>` set the CSS variable\n * that can be referenced by other styles (e.g., Tailwind's font-sans).\n *\n * In Next.js, the .variable class ONLY sets the CSS variable — it does NOT\n * set font-family. This is critical because apps commonly apply multiple\n * .variable classes to <body> (e.g., geistSans.variable + geistMono.variable).\n * If we also set font-family here, the last class wins due to CSS cascade,\n * causing all text to use that font (e.g., everything becomes monospace).\n */\nfunction injectVariableClassRule(\n  variableClassName: string,\n  cssVarName: string,\n  fontFamily: string,\n): void {\n  if (injectedVariableRules.has(variableClassName)) return;\n  injectedVariableRules.add(variableClassName);\n\n  // Only set the CSS variable — do NOT set font-family.\n  // This matches Next.js behavior where .variable classes only define CSS variables.\n  let css = `.${variableClassName} { ${cssVarName}: ${fontFamily}; }\\n`;\n\n  // Also inject at :root so CSS variable inheritance works throughout the page.\n  // This ensures Tailwind utilities like `font-sans` that reference these\n  // variables via var(--font-geist-sans) work correctly.\n  if (!injectedRootVariables.has(cssVarName)) {\n    injectedRootVariables.add(cssVarName);\n    css += `:root { ${cssVarName}: ${fontFamily}; }\\n`;\n  }\n\n  // On server, store the CSS for SSR injection\n  if (typeof document === \"undefined\") {\n    ssrFontStyles.push(css);\n    return;\n  }\n\n  // On client, inject a <style> tag\n  const style = document.createElement(\"style\");\n  style.textContent = css;\n  style.setAttribute(\"data-vinext-font-variable\", variableClassName);\n  document.head.appendChild(style);\n}\n\n/**\n * Normalize the `src` option into a flat array of `{ path, weight?, style? }`.\n * Handles string, single object, and array forms.\n */\nfunction normalizeSources(options: LocalFontOptions): LocalFontSrc[] {\n  if (Array.isArray(options.src)) return options.src;\n  if (typeof options.src === \"string\") return [{ path: options.src }];\n  return [options.src];\n}\n\n/**\n * Determine the MIME type for a font file based on its extension.\n * Uses endsWith() only — matching the approach in generateFontFaceCSS —\n * to avoid false positives from substring matches (e.g. \".woff\" matching \".woff2\").\n */\nfunction getFontMimeType(pathOrUrl: string): string {\n  if (pathOrUrl.endsWith(\".woff2\")) return \"font/woff2\";\n  if (pathOrUrl.endsWith(\".woff\")) return \"font/woff\";\n  if (pathOrUrl.endsWith(\".ttf\")) return \"font/ttf\";\n  if (pathOrUrl.endsWith(\".otf\")) return \"font/opentype\";\n  return \"font/woff2\";\n}\n\n/**\n * Collect font source URLs for preload link generation.\n * Only collects on the server (SSR). Deduplicates by href using a Set for O(1) lookups.\n */\nfunction collectFontPreloads(options: LocalFontOptions): void {\n  if (typeof document !== \"undefined\") return; // client-side, skip\n\n  const sources = normalizeSources(options);\n\n  for (const src of sources) {\n    const href = src.path;\n    // Only collect URLs that are absolute (start with /) — relative paths\n    // would resolve incorrectly from different page URLs. The vinext:local-fonts\n    // Vite transform should have already resolved them to absolute URLs.\n    if (href && href.startsWith(\"/\") && !ssrFontPreloadHrefs.has(href)) {\n      ssrFontPreloadHrefs.add(href);\n      ssrFontPreloads.push({ href, type: getFontMimeType(href) });\n    }\n  }\n}\n\nexport default function localFont(options: LocalFontOptions): FontResult {\n  const id = classCounter++;\n  const family = `__local_font_${id}`;\n  const className = `__font_local_${id}`;\n  const fallback = options.fallback ?? [\"sans-serif\"];\n  // Sanitize each fallback name to prevent CSS injection via crafted values\n  const fontFamily = `'${family}', ${fallback.map(sanitizeFallback).join(\", \")}`;\n  // Validate CSS variable name — reject anything that could inject CSS\n  const cssVarName = options.variable ? sanitizeCSSVarName(options.variable) : undefined;\n  // In Next.js, `variable` returns a CLASS NAME that sets the CSS variable.\n  // Users apply this class to set the CSS variable on that element.\n  const variableClassName = `__variable_local_${id}`;\n\n  // Collect font URLs for preload <link> tags (SSR only)\n  collectFontPreloads(options);\n\n  // Inject @font-face declarations\n  const css = generateFontFaceCSS(family, options);\n  injectFontFaceCSS(css, family);\n\n  // Inject the className -> font-family CSS rule\n  injectClassNameRule(className, fontFamily);\n\n  // Inject a CSS rule for the variable class name if variable is specified.\n  // This is what makes `<html className={font.variable}>` set the CSS variable.\n  if (cssVarName) {\n    injectVariableClassRule(variableClassName, cssVarName, fontFamily);\n  }\n\n  return {\n    className,\n    style: { fontFamily },\n    ...(cssVarName ? { variable: variableClassName } : {}),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"font-local.js","names":[],"sources":["../../src/shims/font-local.ts"],"sourcesContent":["/**\n * next/font/local shim\n *\n * Provides a runtime-compatible shim for Next.js local fonts.\n * Generates @font-face CSS declarations and returns an object\n * with className, style, and variable properties.\n *\n * Supports both client-side injection and SSR collection,\n * matching the patterns used by the Google font shim.\n *\n * Usage:\n *   import localFont from 'next/font/local';\n *   const myFont = localFont({ src: './my-font.woff2' });\n *   // myFont.className -> unique CSS class\n *   // myFont.style -> { fontFamily: \"'__local_font_0', sans-serif\" }\n *   // myFont.variable -> generated class name when requested\n */\nimport {\n  escapeCSSString,\n  formatFontClassRule,\n  resolveSingleFaceStyle,\n  sanitizeCSSVarName,\n  sanitizeFallback,\n  sanitizeFontDescriptorValue,\n  type FontStyle,\n} from \"./font-utils.js\";\n\n/**\n * Validate a CSS property name for use in declarations.\n *\n * Only allows standard CSS property names (lowercase letters and hyphens)\n * and custom properties (--prefixed). Rejects anything that could inject\n * CSS rules via crafted property names.\n */\nfunction sanitizeCSSProperty(prop: string): string | undefined {\n  if (/^(--)?[a-zA-Z][a-zA-Z0-9-]*$/.test(prop)) return prop;\n  return undefined;\n}\n\nlet classCounter = 0;\nconst injectedFonts = new Set<string>();\n\ntype LocalFontSrc = {\n  path: string;\n  weight?: string;\n  style?: string;\n};\n\ntype LocalFontOptions = {\n  src: string | LocalFontSrc | LocalFontSrc[];\n  display?: string;\n  weight?: string;\n  style?: string;\n  fallback?: string[];\n  preload?: boolean;\n  variable?: string;\n  adjustFontFallback?: boolean | string;\n  declarations?: Array<{ prop: string; value: string }>;\n};\n\ntype FontResult = {\n  className: string;\n  style: FontStyle;\n  variable?: string;\n};\n\nfunction generateFontFaceCSS(\n  family: string,\n  options: LocalFontOptions,\n  sources: LocalFontSrc[],\n): string {\n  const display = options.display ?? \"swap\";\n  const rules: string[] = [];\n\n  for (const src of sources) {\n    const weight = sanitizeFontDescriptorValue(src.weight ?? options.weight ?? \"400\") ?? \"400\";\n    const style = sanitizeFontDescriptorValue(src.style ?? options.style ?? \"normal\") ?? \"normal\";\n    const format = src.path.endsWith(\".woff2\")\n      ? \"woff2\"\n      : src.path.endsWith(\".woff\")\n        ? \"woff\"\n        : src.path.endsWith(\".ttf\")\n          ? \"truetype\"\n          : src.path.endsWith(\".otf\")\n            ? \"opentype\"\n            : \"woff2\";\n\n    rules.push(`@font-face {\n  font-family: '${escapeCSSString(family)}';\n  src: url('${escapeCSSString(src.path)}') format('${format}');\n  font-weight: ${weight};\n  font-style: ${style};\n  font-display: ${display};\n}`);\n  }\n\n  // Add extra declarations if provided — sanitize prop/value to prevent injection\n  if (options.declarations) {\n    for (const decl of options.declarations) {\n      const safeProp = sanitizeCSSProperty(decl.prop);\n      const safeValue = sanitizeFontDescriptorValue(decl.value);\n      if (safeProp && safeValue) {\n        rules.push(\n          `@font-face { font-family: '${escapeCSSString(family)}'; ${safeProp}: ${safeValue}; }`,\n        );\n      }\n    }\n  }\n\n  return rules.join(\"\\n\");\n}\n\n// SSR: collect font styles for injection in <head>\nconst ssrFontStyles: string[] = [];\n\n// SSR: collect font file URLs for <link rel=\"preload\"> injection\nconst ssrFontPreloads: Array<{ href: string; type: string }> = [];\nconst ssrFontPreloadHrefs = new Set<string>();\n\n/**\n * Get collected SSR font styles (used by the renderer).\n * Note: We don't clear the arrays because fonts are loaded at module import\n * time and need to persist across all requests in the Workers environment.\n */\nexport function getSSRFontStyles(): string[] {\n  return [...ssrFontStyles];\n}\n\n/**\n * Get collected SSR font preload data (used by the renderer).\n * Returns an array of { href, type } objects for emitting\n * <link rel=\"preload\" as=\"font\" ...> tags.\n */\nexport function getSSRFontPreloads(): Array<{ href: string; type: string }> {\n  return [...ssrFontPreloads];\n}\n\nfunction injectFontFaceCSS(css: string, id: string): void {\n  if (injectedFonts.has(id)) return;\n  injectedFonts.add(id);\n\n  // On server, store the CSS for SSR injection\n  if (typeof document === \"undefined\") {\n    ssrFontStyles.push(css);\n    return;\n  }\n\n  const style = document.createElement(\"style\");\n  style.textContent = css;\n  style.setAttribute(\"data-vinext-font\", id);\n  document.head.appendChild(style);\n}\n\n/** Track which className CSS rules have been injected. */\nconst injectedClassRules = new Set<string>();\n\n/**\n * Inject a CSS rule that maps a className to the exported font style.\n *\n * This is what makes `<div className={font.className}>` apply the font.\n *\n * In Next.js, the .className class sets font-family and any single\n * font-weight/font-style. CSS variables are handled separately by .variable.\n */\nfunction injectClassNameRule(className: string, fontStyle: FontStyle): void {\n  if (injectedClassRules.has(className)) return;\n  injectedClassRules.add(className);\n\n  const css = formatFontClassRule(className, fontStyle);\n\n  // On server, store the CSS for SSR injection\n  if (typeof document === \"undefined\") {\n    ssrFontStyles.push(css);\n    return;\n  }\n\n  // On client, inject a <style> tag\n  const style = document.createElement(\"style\");\n  style.textContent = css;\n  style.setAttribute(\"data-vinext-font-class\", className);\n  document.head.appendChild(style);\n}\n\n/** Track which variable class CSS rules have been injected. */\nconst injectedVariableRules = new Set<string>();\n\n/** Track which :root CSS variable rules have been injected. */\nconst injectedRootVariables = new Set<string>();\n\n/**\n * Inject a CSS rule that sets a CSS variable on an element.\n * This is what makes `<html className={font.variable}>` set the CSS variable\n * that can be referenced by other styles (e.g., Tailwind's font-sans).\n *\n * In Next.js, the .variable class ONLY sets the CSS variable — it does NOT\n * set font-family. This is critical because apps commonly apply multiple\n * .variable classes to <body> (e.g., geistSans.variable + geistMono.variable).\n * If we also set font-family here, the last class wins due to CSS cascade,\n * causing all text to use that font (e.g., everything becomes monospace).\n */\nfunction injectVariableClassRule(\n  variableClassName: string,\n  cssVarName: string,\n  fontFamily: string,\n): void {\n  if (injectedVariableRules.has(variableClassName)) return;\n  injectedVariableRules.add(variableClassName);\n\n  // Only set the CSS variable — do NOT set font-family.\n  // This matches Next.js behavior where .variable classes only define CSS variables.\n  let css = `.${variableClassName} { ${cssVarName}: ${fontFamily}; }\\n`;\n\n  // Also inject at :root so CSS variable inheritance works throughout the page.\n  // This ensures Tailwind utilities like `font-sans` that reference these\n  // variables via var(--font-geist-sans) work correctly.\n  if (!injectedRootVariables.has(cssVarName)) {\n    injectedRootVariables.add(cssVarName);\n    css += `:root { ${cssVarName}: ${fontFamily}; }\\n`;\n  }\n\n  // On server, store the CSS for SSR injection\n  if (typeof document === \"undefined\") {\n    ssrFontStyles.push(css);\n    return;\n  }\n\n  // On client, inject a <style> tag\n  const style = document.createElement(\"style\");\n  style.textContent = css;\n  style.setAttribute(\"data-vinext-font-variable\", variableClassName);\n  document.head.appendChild(style);\n}\n\n/**\n * Normalize the `src` option into a flat array of `{ path, weight?, style? }`.\n * Handles string, single object, and array forms.\n */\nfunction normalizeSources(options: LocalFontOptions): LocalFontSrc[] {\n  if (Array.isArray(options.src)) return options.src;\n  if (typeof options.src === \"string\") return [{ path: options.src }];\n  return [options.src];\n}\n\n/**\n * Determine the MIME type for a font file based on its extension.\n * Uses endsWith() only — matching the approach in generateFontFaceCSS —\n * to avoid false positives from substring matches (e.g. \".woff\" matching \".woff2\").\n */\nfunction getFontMimeType(pathOrUrl: string): string {\n  if (pathOrUrl.endsWith(\".woff2\")) return \"font/woff2\";\n  if (pathOrUrl.endsWith(\".woff\")) return \"font/woff\";\n  if (pathOrUrl.endsWith(\".ttf\")) return \"font/ttf\";\n  if (pathOrUrl.endsWith(\".otf\")) return \"font/opentype\";\n  return \"font/woff2\";\n}\n\n/**\n * Collect font source URLs for preload link generation.\n * Only collects on the server (SSR). Deduplicates by href using a Set for O(1) lookups.\n */\nfunction collectFontPreloads(sources: LocalFontSrc[]): void {\n  if (typeof document !== \"undefined\") return; // client-side, skip\n\n  for (const src of sources) {\n    const href = src.path;\n    // Only collect URLs that are absolute (start with /) — relative paths\n    // would resolve incorrectly from different page URLs. The vinext:local-fonts\n    // Vite transform should have already resolved them to absolute URLs.\n    if (href && href.startsWith(\"/\") && !ssrFontPreloadHrefs.has(href)) {\n      ssrFontPreloadHrefs.add(href);\n      ssrFontPreloads.push({ href, type: getFontMimeType(href) });\n    }\n  }\n}\n\nexport default function localFont(options: LocalFontOptions): FontResult {\n  const id = classCounter++;\n  const sources = normalizeSources(options);\n  const singleSource = sources.length === 1 ? sources[0] : undefined;\n  const family = `__local_font_${id}`;\n  const className = `__font_local_${id}`;\n  const fallback = options.fallback ?? [\"sans-serif\"];\n  // Sanitize each fallback name to prevent CSS injection via crafted values\n  const fontFamily = `'${family}', ${fallback.map(sanitizeFallback).join(\", \")}`;\n  // Validate CSS variable name — reject anything that could inject CSS\n  const cssVarName = options.variable ? sanitizeCSSVarName(options.variable) : undefined;\n  // In Next.js, `variable` returns a CLASS NAME that sets the CSS variable.\n  // Users apply this class to set the CSS variable on that element.\n  const variableClassName = `__variable_local_${id}`;\n  const style = singleSource\n    ? resolveSingleFaceStyle({\n        fontFamily,\n        weight: singleSource.weight ?? options.weight,\n        style: singleSource.style ?? options.style,\n      })\n    : { fontFamily };\n\n  // Collect font URLs for preload <link> tags (SSR only)\n  collectFontPreloads(sources);\n\n  // Inject @font-face declarations\n  const css = generateFontFaceCSS(family, options, sources);\n  injectFontFaceCSS(css, family);\n\n  // Inject the className -> font-family CSS rule\n  injectClassNameRule(className, style);\n\n  // Inject a CSS rule for the variable class name if variable is specified.\n  // This is what makes `<html className={font.variable}>` set the CSS variable.\n  if (cssVarName) {\n    injectVariableClassRule(variableClassName, cssVarName, fontFamily);\n  }\n\n  return {\n    className,\n    style,\n    ...(cssVarName ? { variable: variableClassName } : {}),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAS,oBAAoB,MAAkC;CAC7D,IAAI,+BAA+B,KAAK,KAAK,EAAE,OAAO;;AAIxD,IAAI,eAAe;AACnB,MAAM,gCAAgB,IAAI,KAAa;AA0BvC,SAAS,oBACP,QACA,SACA,SACQ;CACR,MAAM,UAAU,QAAQ,WAAW;CACnC,MAAM,QAAkB,EAAE;CAE1B,KAAK,MAAM,OAAO,SAAS;EACzB,MAAM,SAAS,4BAA4B,IAAI,UAAU,QAAQ,UAAU,MAAM,IAAI;EACrF,MAAM,QAAQ,4BAA4B,IAAI,SAAS,QAAQ,SAAS,SAAS,IAAI;EACrF,MAAM,SAAS,IAAI,KAAK,SAAS,SAAS,GACtC,UACA,IAAI,KAAK,SAAS,QAAQ,GACxB,SACA,IAAI,KAAK,SAAS,OAAO,GACvB,aACA,IAAI,KAAK,SAAS,OAAO,GACvB,aACA;EAEV,MAAM,KAAK;kBACG,gBAAgB,OAAO,CAAC;cAC5B,gBAAgB,IAAI,KAAK,CAAC,aAAa,OAAO;iBAC3C,OAAO;gBACR,MAAM;kBACJ,QAAQ;GACvB;;CAID,IAAI,QAAQ,cACV,KAAK,MAAM,QAAQ,QAAQ,cAAc;EACvC,MAAM,WAAW,oBAAoB,KAAK,KAAK;EAC/C,MAAM,YAAY,4BAA4B,KAAK,MAAM;EACzD,IAAI,YAAY,WACd,MAAM,KACJ,8BAA8B,gBAAgB,OAAO,CAAC,KAAK,SAAS,IAAI,UAAU,KACnF;;CAKP,OAAO,MAAM,KAAK,KAAK;;AAIzB,MAAM,gBAA0B,EAAE;AAGlC,MAAM,kBAAyD,EAAE;AACjE,MAAM,sCAAsB,IAAI,KAAa;;;;;;AAO7C,SAAgB,mBAA6B;CAC3C,OAAO,CAAC,GAAG,cAAc;;;;;;;AAQ3B,SAAgB,qBAA4D;CAC1E,OAAO,CAAC,GAAG,gBAAgB;;AAG7B,SAAS,kBAAkB,KAAa,IAAkB;CACxD,IAAI,cAAc,IAAI,GAAG,EAAE;CAC3B,cAAc,IAAI,GAAG;CAGrB,IAAI,OAAO,aAAa,aAAa;EACnC,cAAc,KAAK,IAAI;EACvB;;CAGF,MAAM,QAAQ,SAAS,cAAc,QAAQ;CAC7C,MAAM,cAAc;CACpB,MAAM,aAAa,oBAAoB,GAAG;CAC1C,SAAS,KAAK,YAAY,MAAM;;;AAIlC,MAAM,qCAAqB,IAAI,KAAa;;;;;;;;;AAU5C,SAAS,oBAAoB,WAAmB,WAA4B;CAC1E,IAAI,mBAAmB,IAAI,UAAU,EAAE;CACvC,mBAAmB,IAAI,UAAU;CAEjC,MAAM,MAAM,oBAAoB,WAAW,UAAU;CAGrD,IAAI,OAAO,aAAa,aAAa;EACnC,cAAc,KAAK,IAAI;EACvB;;CAIF,MAAM,QAAQ,SAAS,cAAc,QAAQ;CAC7C,MAAM,cAAc;CACpB,MAAM,aAAa,0BAA0B,UAAU;CACvD,SAAS,KAAK,YAAY,MAAM;;;AAIlC,MAAM,wCAAwB,IAAI,KAAa;;AAG/C,MAAM,wCAAwB,IAAI,KAAa;;;;;;;;;;;;AAa/C,SAAS,wBACP,mBACA,YACA,YACM;CACN,IAAI,sBAAsB,IAAI,kBAAkB,EAAE;CAClD,sBAAsB,IAAI,kBAAkB;CAI5C,IAAI,MAAM,IAAI,kBAAkB,KAAK,WAAW,IAAI,WAAW;CAK/D,IAAI,CAAC,sBAAsB,IAAI,WAAW,EAAE;EAC1C,sBAAsB,IAAI,WAAW;EACrC,OAAO,WAAW,WAAW,IAAI,WAAW;;CAI9C,IAAI,OAAO,aAAa,aAAa;EACnC,cAAc,KAAK,IAAI;EACvB;;CAIF,MAAM,QAAQ,SAAS,cAAc,QAAQ;CAC7C,MAAM,cAAc;CACpB,MAAM,aAAa,6BAA6B,kBAAkB;CAClE,SAAS,KAAK,YAAY,MAAM;;;;;;AAOlC,SAAS,iBAAiB,SAA2C;CACnE,IAAI,MAAM,QAAQ,QAAQ,IAAI,EAAE,OAAO,QAAQ;CAC/C,IAAI,OAAO,QAAQ,QAAQ,UAAU,OAAO,CAAC,EAAE,MAAM,QAAQ,KAAK,CAAC;CACnE,OAAO,CAAC,QAAQ,IAAI;;;;;;;AAQtB,SAAS,gBAAgB,WAA2B;CAClD,IAAI,UAAU,SAAS,SAAS,EAAE,OAAO;CACzC,IAAI,UAAU,SAAS,QAAQ,EAAE,OAAO;CACxC,IAAI,UAAU,SAAS,OAAO,EAAE,OAAO;CACvC,IAAI,UAAU,SAAS,OAAO,EAAE,OAAO;CACvC,OAAO;;;;;;AAOT,SAAS,oBAAoB,SAA+B;CAC1D,IAAI,OAAO,aAAa,aAAa;CAErC,KAAK,MAAM,OAAO,SAAS;EACzB,MAAM,OAAO,IAAI;EAIjB,IAAI,QAAQ,KAAK,WAAW,IAAI,IAAI,CAAC,oBAAoB,IAAI,KAAK,EAAE;GAClE,oBAAoB,IAAI,KAAK;GAC7B,gBAAgB,KAAK;IAAE;IAAM,MAAM,gBAAgB,KAAK;IAAE,CAAC;;;;AAKjE,SAAwB,UAAU,SAAuC;CACvE,MAAM,KAAK;CACX,MAAM,UAAU,iBAAiB,QAAQ;CACzC,MAAM,eAAe,QAAQ,WAAW,IAAI,QAAQ,KAAK,KAAA;CACzD,MAAM,SAAS,gBAAgB;CAC/B,MAAM,YAAY,gBAAgB;CAGlC,MAAM,aAAa,IAAI,OAAO,MAFb,QAAQ,YAAY,CAAC,aAAa,EAEP,IAAI,iBAAiB,CAAC,KAAK,KAAK;CAE5E,MAAM,aAAa,QAAQ,WAAW,mBAAmB,QAAQ,SAAS,GAAG,KAAA;CAG7E,MAAM,oBAAoB,oBAAoB;CAC9C,MAAM,QAAQ,eACV,uBAAuB;EACrB;EACA,QAAQ,aAAa,UAAU,QAAQ;EACvC,OAAO,aAAa,SAAS,QAAQ;EACtC,CAAC,GACF,EAAE,YAAY;CAGlB,oBAAoB,QAAQ;CAI5B,kBADY,oBAAoB,QAAQ,SAAS,QAC5B,EAAE,OAAO;CAG9B,oBAAoB,WAAW,MAAM;CAIrC,IAAI,YACF,wBAAwB,mBAAmB,YAAY,WAAW;CAGpE,OAAO;EACL;EACA;EACA,GAAI,aAAa,EAAE,UAAU,mBAAmB,GAAG,EAAE;EACtD"}

package/dist/shims/font-utils.d.ts

@@ -0,0 +1,51 @@
+//#region src/shims/font-utils.d.ts
+type FontStyle = {
+  fontFamily: string;
+  fontWeight?: number;
+  fontStyle?: string;
+};
+type FontFaceStyleInput = {
+  fontFamily: string;
+  weight?: string | string[];
+  style?: string | string[];
+  internalWeight?: number;
+  internalStyle?: string;
+  google?: boolean;
+};
+/**
+ * Escape a string for safe interpolation inside a CSS single-quoted string.
+ *
+ * Prevents CSS injection by escaping characters that could break out of
+ * a `'...'` CSS string context: backslashes, single quotes, and newlines.
+ *
+ * Used by font-google-base.ts, font-local.ts, and fallback-metrics.ts.
+ */
+declare function escapeCSSString(value: string): string;
+/**
+ * Validate a CSS custom property name (e.g. `--font-inter`).
+ *
+ * Custom properties must start with `--` and only contain alphanumeric
+ * characters, hyphens, and underscores. Anything else could be used to
+ * break out of the CSS declaration and inject arbitrary rules.
+ *
+ * Returns the name if valid, undefined otherwise.
+ */
+declare function sanitizeCSSVarName(name: string): string | undefined;
+/**
+ * Sanitize a CSS font-family fallback name.
+ *
+ * Generic family names (sans-serif, serif, monospace, etc.) are used as-is.
+ * Named families are wrapped in escaped quotes. This prevents injection via
+ * crafted fallback values like `); } body { color: red; } .x {`.
+ */
+declare function sanitizeFallback(name: string): string;
+declare function singleFontOptionValue(value: string | string[] | undefined): string | undefined;
+declare function sanitizeFontDescriptorValue(value: string): string | undefined;
+declare function resolveFontWeight(weight: string | string[] | undefined): number | undefined;
+declare function resolveFontStyle(style: string | string[] | undefined): string | undefined;
+declare function resolveGoogleFontStyle(style: string | string[] | undefined): string | undefined;
+declare function resolveSingleFaceStyle(input: FontFaceStyleInput): FontStyle;
+declare function formatFontClassRule(className: string, style: FontStyle): string;
+//#endregion
+export { FontFaceStyleInput, FontStyle, escapeCSSString, formatFontClassRule, resolveFontStyle, resolveFontWeight, resolveGoogleFontStyle, resolveSingleFaceStyle, sanitizeCSSVarName, sanitizeFallback, sanitizeFontDescriptorValue, singleFontOptionValue };
+//# sourceMappingURL=font-utils.d.ts.map