vinext 0.0.49 → 0.0.51

package/dist/build/google-fonts/fallback-metrics-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback-metrics-data.js","names":[],"sources":["../../../src/build/google-fonts/fallback-metrics-data.json"],"sourcesContent":[""],"mappings":""}

package/dist/build/google-fonts/fallback-metrics.d.ts

@@ -0,0 +1,13 @@
+//#region src/build/google-fonts/fallback-metrics.d.ts
+type AdjustFontFallback = {
+  fallbackFont: string;
+  ascentOverride: string;
+  descentOverride: string;
+  lineGapOverride: string;
+  sizeAdjust: string;
+};
+declare function getFallbackFontOverrideMetrics(fontFamily: string): AdjustFontFallback | undefined;
+declare function buildFallbackFontFace(family: string, metrics: AdjustFontFallback): string;
+//#endregion
+export { buildFallbackFontFace, getFallbackFontOverrideMetrics };
+//# sourceMappingURL=fallback-metrics.d.ts.map

package/dist/build/google-fonts/fallback-metrics.js

@@ -0,0 +1,46 @@
+import { escapeCSSString } from "../../shims/font-utils.js";
+import fallback_metrics_data_default from "./fallback-metrics-data.js";
+//#region src/build/google-fonts/fallback-metrics.ts
+const EXPECTED_METRIC_LENGTH = 6;
+const fallbackMetrics = fallback_metrics_data_default;
+function formatName(value) {
+	return value.replace(/(?:^\w|[A-Z]|\b\w)/g, (word, index) => index === 0 ? word.toLowerCase() : word.toUpperCase()).replace(/\s+/g, "");
+}
+function formatOverrideValue(value) {
+	return Math.abs(value * 100).toFixed(2);
+}
+function getFallbackFontOverrideMetrics(fontFamily) {
+	const metric = fallbackMetrics[formatName(fontFamily)];
+	if (!metric || metric.length !== EXPECTED_METRIC_LENGTH) return void 0;
+	const [serifFlag, ascent, descent, lineGap, unitsPerEm, xWidthAvg] = metric;
+	if (unitsPerEm === 0) return void 0;
+	const fallbackFont = serifFlag === 1 ? "Times New Roman" : "Arial";
+	const fallbackMetric = fallbackMetrics[formatName(fallbackFont)];
+	if (!fallbackMetric || fallbackMetric.length !== EXPECTED_METRIC_LENGTH) return void 0;
+	const [, , , , fallbackUnitsPerEm, fallbackXWidthAvg] = fallbackMetric;
+	if (fallbackUnitsPerEm === 0) return void 0;
+	const mainFontAvgWidth = xWidthAvg / unitsPerEm;
+	const fallbackFontAvgWidth = fallbackXWidthAvg / fallbackUnitsPerEm;
+	const sizeAdjust = xWidthAvg && fallbackFontAvgWidth ? mainFontAvgWidth / fallbackFontAvgWidth : 1;
+	return {
+		fallbackFont,
+		ascentOverride: `${formatOverrideValue(ascent / (unitsPerEm * sizeAdjust))}%`,
+		descentOverride: `${formatOverrideValue(descent / (unitsPerEm * sizeAdjust))}%`,
+		lineGapOverride: `${formatOverrideValue(lineGap / (unitsPerEm * sizeAdjust))}%`,
+		sizeAdjust: `${formatOverrideValue(sizeAdjust)}%`
+	};
+}
+function buildFallbackFontFace(family, metrics) {
+	return `@font-face {
+  font-family: ${`'${escapeCSSString(family)} Fallback'`};
+  src: local("${escapeCSSString(metrics.fallbackFont)}");
+  ascent-override: ${metrics.ascentOverride};
+  descent-override: ${metrics.descentOverride};
+  line-gap-override: ${metrics.lineGapOverride};
+  size-adjust: ${metrics.sizeAdjust};
+}\n`;
+}
+//#endregion
+export { buildFallbackFontFace, getFallbackFontOverrideMetrics };
+
+//# sourceMappingURL=fallback-metrics.js.map

package/dist/build/google-fonts/fallback-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback-metrics.js","names":["rawFallbackMetrics"],"sources":["../../../src/build/google-fonts/fallback-metrics.ts"],"sourcesContent":["// Compact fallback metrics derived from Next.js\n// `next/dist/server/capsize-font-metrics.json`.\n//\n// The tuple shape is:\n// [serifFlag, ascent, descent, lineGap, unitsPerEm, xWidthAvg]\n\nimport { escapeCSSString } from \"vinext/shims/font-utils\";\nimport rawFallbackMetrics from \"./fallback-metrics-data.json\" with { type: \"json\" };\n\ntype AdjustFontFallback = {\n  fallbackFont: string;\n  ascentOverride: string;\n  descentOverride: string;\n  lineGapOverride: string;\n  sizeAdjust: string;\n};\n\nconst EXPECTED_METRIC_LENGTH = 6;\nconst fallbackMetrics: Record<string, number[]> = rawFallbackMetrics;\n\nfunction formatName(value: string): string {\n  return value\n    .replace(/(?:^\\w|[A-Z]|\\b\\w)/g, (word, index) =>\n      index === 0 ? word.toLowerCase() : word.toUpperCase(),\n    )\n    .replace(/\\s+/g, \"\");\n}\n\nfunction formatOverrideValue(value: number): string {\n  return Math.abs(value * 100).toFixed(2);\n}\n\nexport function getFallbackFontOverrideMetrics(fontFamily: string): AdjustFontFallback | undefined {\n  const metric = fallbackMetrics[formatName(fontFamily)];\n  if (!metric || metric.length !== EXPECTED_METRIC_LENGTH) return undefined;\n\n  const [serifFlag, ascent, descent, lineGap, unitsPerEm, xWidthAvg] = metric;\n  if (unitsPerEm === 0) return undefined;\n\n  const fallbackFont = serifFlag === 1 ? \"Times New Roman\" : \"Arial\";\n  const fallbackMetric = fallbackMetrics[formatName(fallbackFont)];\n  if (!fallbackMetric || fallbackMetric.length !== EXPECTED_METRIC_LENGTH) return undefined;\n\n  const [, , , , fallbackUnitsPerEm, fallbackXWidthAvg] = fallbackMetric;\n  if (fallbackUnitsPerEm === 0) return undefined;\n\n  const mainFontAvgWidth = xWidthAvg / unitsPerEm;\n  const fallbackFontAvgWidth = fallbackXWidthAvg / fallbackUnitsPerEm;\n  const sizeAdjust =\n    xWidthAvg && fallbackFontAvgWidth ? mainFontAvgWidth / fallbackFontAvgWidth : 1;\n\n  return {\n    fallbackFont,\n    ascentOverride: `${formatOverrideValue(ascent / (unitsPerEm * sizeAdjust))}%`,\n    descentOverride: `${formatOverrideValue(descent / (unitsPerEm * sizeAdjust))}%`,\n    lineGapOverride: `${formatOverrideValue(lineGap / (unitsPerEm * sizeAdjust))}%`,\n    sizeAdjust: `${formatOverrideValue(sizeAdjust)}%`,\n  };\n}\n\n// The fallback family name pattern '{family} Fallback' must match the name\n// constructed in createFontLoader() in shims/font-google-base.ts. Keep both\n// sites in sync to prevent silent fallback mismatches.\nexport function buildFallbackFontFace(family: string, metrics: AdjustFontFallback): string {\n  const fallbackFamily = `'${escapeCSSString(family)} Fallback'`;\n  return `@font-face {\n  font-family: ${fallbackFamily};\n  src: local(\"${escapeCSSString(metrics.fallbackFont)}\");\n  ascent-override: ${metrics.ascentOverride};\n  descent-override: ${metrics.descentOverride};\n  line-gap-override: ${metrics.lineGapOverride};\n  size-adjust: ${metrics.sizeAdjust};\n}\\n`;\n}\n"],"mappings":";;;AAiBA,MAAM,yBAAyB;AAC/B,MAAM,kBAA4CA;AAElD,SAAS,WAAW,OAAuB;CACzC,OAAO,MACJ,QAAQ,wBAAwB,MAAM,UACrC,UAAU,IAAI,KAAK,aAAa,GAAG,KAAK,aAAa,CACtD,CACA,QAAQ,QAAQ,GAAG;;AAGxB,SAAS,oBAAoB,OAAuB;CAClD,OAAO,KAAK,IAAI,QAAQ,IAAI,CAAC,QAAQ,EAAE;;AAGzC,SAAgB,+BAA+B,YAAoD;CACjG,MAAM,SAAS,gBAAgB,WAAW,WAAW;CACrD,IAAI,CAAC,UAAU,OAAO,WAAW,wBAAwB,OAAO,KAAA;CAEhE,MAAM,CAAC,WAAW,QAAQ,SAAS,SAAS,YAAY,aAAa;CACrE,IAAI,eAAe,GAAG,OAAO,KAAA;CAE7B,MAAM,eAAe,cAAc,IAAI,oBAAoB;CAC3D,MAAM,iBAAiB,gBAAgB,WAAW,aAAa;CAC/D,IAAI,CAAC,kBAAkB,eAAe,WAAW,wBAAwB,OAAO,KAAA;CAEhF,MAAM,SAAS,oBAAoB,qBAAqB;CACxD,IAAI,uBAAuB,GAAG,OAAO,KAAA;CAErC,MAAM,mBAAmB,YAAY;CACrC,MAAM,uBAAuB,oBAAoB;CACjD,MAAM,aACJ,aAAa,uBAAuB,mBAAmB,uBAAuB;CAEhF,OAAO;EACL;EACA,gBAAgB,GAAG,oBAAoB,UAAU,aAAa,YAAY,CAAC;EAC3E,iBAAiB,GAAG,oBAAoB,WAAW,aAAa,YAAY,CAAC;EAC7E,iBAAiB,GAAG,oBAAoB,WAAW,aAAa,YAAY,CAAC;EAC7E,YAAY,GAAG,oBAAoB,WAAW,CAAC;EAChD;;AAMH,SAAgB,sBAAsB,QAAgB,SAAqC;CAEzF,OAAO;iBACQ,IAFY,gBAAgB,OAAO,CAAC,YAErB;gBAChB,gBAAgB,QAAQ,aAAa,CAAC;qBACjC,QAAQ,eAAe;sBACtB,QAAQ,gBAAgB;uBACvB,QAAQ,gBAAgB;iBAC9B,QAAQ,WAAW"}

package/dist/build/google-fonts/get-axes.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-axes.js","names":[],"sources":["../../../src/build/google-fonts/get-axes.ts"],"sourcesContent":["// Ported from Next.js: packages/font/src/google/get-font-axes.ts\n// https://github.com/vercel/next.js/blob/canary/packages/font/src/google/get-font-axes.ts\n//\n// Resolves the axis values that belong in a Google Fonts URL given the\n// caller's requested weights, styles, and (optional) selected variable axes.\n// For variable fonts this is the only place that turns the literal sentinel\n// `\"variable\"` into the actual `min..max` range from the bundled metadata.\n\nimport { googleFontsMetadata } from \"./font-metadata.js\";\nimport type { FontAxes } from \"./build-url.js\";\n\nconst formatAvailableValues = (values: string[]): string =>\n  values.map((val) => `\\`${val}\\``).join(\", \");\n\nexport function getFontAxes(\n  fontFamily: string,\n  weights: string[],\n  styles: string[],\n  selectedVariableAxes?: string[],\n): FontAxes {\n  const hasItalic = styles.includes(\"italic\");\n  const hasNormal = styles.includes(\"normal\");\n  // Google treats omitted ital as ital=0, so italic-only requests do not need\n  // to enumerate ital=0; just ['1'] suffices.\n  const ital = hasItalic ? [...(hasNormal ? [\"0\"] : []), \"1\"] : undefined;\n\n  // Variable-font sentinel: a single \"variable\" entry means the caller wants\n  // the full axis range from metadata, not a list of explicit weights.\n  if (weights[0] === \"variable\") {\n    const allAxes = googleFontsMetadata[fontFamily].axes;\n    if (!allAxes) {\n      // Reaching this branch means validate accepted a \"variable\" weight for\n      // a non-variable font, which should be impossible because the\n      // metadata-based validator rejects this earlier. Treat as an internal\n      // invariant.\n      throw new Error(\"invariant variable font without axes\");\n    }\n\n    if (selectedVariableAxes) {\n      const definableAxes = allAxes.map(({ tag }) => tag).filter((tag) => tag !== \"wght\");\n      if (definableAxes.length === 0) {\n        throw new Error(`Font \\`${fontFamily}\\` has no definable \\`axes\\``);\n      }\n      if (!Array.isArray(selectedVariableAxes)) {\n        throw new Error(\n          `Invalid axes value for font \\`${fontFamily}\\`, expected an array of axes.\\nAvailable axes: ${formatAvailableValues(definableAxes)}`,\n        );\n      }\n      for (const key of selectedVariableAxes) {\n        if (!definableAxes.includes(key)) {\n          throw new Error(\n            `Invalid axes value \\`${key}\\` for font \\`${fontFamily}\\`.\\nAvailable axes: ${formatAvailableValues(definableAxes)}`,\n          );\n        }\n      }\n    }\n\n    let weightAxis: string | undefined;\n    let variableAxes: [string, string][] | undefined;\n    for (const { tag, min, max } of allAxes) {\n      if (tag === \"wght\") {\n        weightAxis = `${min}..${max}`;\n      } else if (selectedVariableAxes?.includes(tag)) {\n        if (!variableAxes) variableAxes = [];\n        variableAxes.push([tag, `${min}..${max}`]);\n      }\n    }\n\n    return {\n      wght: weightAxis ? [weightAxis] : undefined,\n      ital,\n      variableAxes,\n    };\n  }\n\n  // Non-variable path: weights are explicit face values that the URL builder\n  // emits verbatim.\n  return {\n    wght: weights,\n    ital,\n    variableAxes: undefined,\n  };\n}\n"],"mappings":";;AAWA,MAAM,yBAAyB,WAC7B,OAAO,KAAK,QAAQ,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK;AAE9C,SAAgB,YACd,YACA,SACA,QACA,sBACU;CACV,MAAM,YAAY,OAAO,SAAS,SAAS;CAC3C,MAAM,YAAY,OAAO,SAAS,SAAS;CAG3C,MAAM,OAAO,YAAY,CAAC,GAAI,YAAY,CAAC,IAAI,GAAG,EAAE,EAAG,IAAI,GAAG,KAAA;AAI9D,KAAI,QAAQ,OAAO,YAAY;EAC7B,MAAM,UAAU,oBAAoB,YAAY;AAChD,MAAI,CAAC,QAKH,OAAM,IAAI,MAAM,uCAAuC;AAGzD,MAAI,sBAAsB;GACxB,MAAM,gBAAgB,QAAQ,KAAK,EAAE,UAAU,IAAI,CAAC,QAAQ,QAAQ,QAAQ,OAAO;AACnF,OAAI,cAAc,WAAW,EAC3B,OAAM,IAAI,MAAM,UAAU,WAAW,8BAA8B;AAErE,OAAI,CAAC,MAAM,QAAQ,qBAAqB,CACtC,OAAM,IAAI,MACR,iCAAiC,WAAW,kDAAkD,sBAAsB,cAAc,GACnI;AAEH,QAAK,MAAM,OAAO,qBAChB,KAAI,CAAC,cAAc,SAAS,IAAI,CAC9B,OAAM,IAAI,MACR,wBAAwB,IAAI,gBAAgB,WAAW,uBAAuB,sBAAsB,cAAc,GACnH;;EAKP,IAAI;EACJ,IAAI;AACJ,OAAK,MAAM,EAAE,KAAK,KAAK,SAAS,QAC9B,KAAI,QAAQ,OACV,cAAa,GAAG,IAAI,IAAI;WACf,sBAAsB,SAAS,IAAI,EAAE;AAC9C,OAAI,CAAC,aAAc,gBAAe,EAAE;AACpC,gBAAa,KAAK,CAAC,KAAK,GAAG,IAAI,IAAI,MAAM,CAAC;;AAI9C,SAAO;GACL,MAAM,aAAa,CAAC,WAAW,GAAG,KAAA;GAClC;GACA;GACD;;AAKH,QAAO;EACL,MAAM;EACN;EACA,cAAc,KAAA;EACf"}
+{"version":3,"file":"get-axes.js","names":[],"sources":["../../../src/build/google-fonts/get-axes.ts"],"sourcesContent":["// Ported from Next.js: packages/font/src/google/get-font-axes.ts\n// https://github.com/vercel/next.js/blob/canary/packages/font/src/google/get-font-axes.ts\n//\n// Resolves the axis values that belong in a Google Fonts URL given the\n// caller's requested weights, styles, and (optional) selected variable axes.\n// For variable fonts this is the only place that turns the literal sentinel\n// `\"variable\"` into the actual `min..max` range from the bundled metadata.\n\nimport { googleFontsMetadata } from \"./font-metadata.js\";\nimport type { FontAxes } from \"./build-url.js\";\n\nconst formatAvailableValues = (values: string[]): string =>\n  values.map((val) => `\\`${val}\\``).join(\", \");\n\nexport function getFontAxes(\n  fontFamily: string,\n  weights: string[],\n  styles: string[],\n  selectedVariableAxes?: string[],\n): FontAxes {\n  const hasItalic = styles.includes(\"italic\");\n  const hasNormal = styles.includes(\"normal\");\n  // Google treats omitted ital as ital=0, so italic-only requests do not need\n  // to enumerate ital=0; just ['1'] suffices.\n  const ital = hasItalic ? [...(hasNormal ? [\"0\"] : []), \"1\"] : undefined;\n\n  // Variable-font sentinel: a single \"variable\" entry means the caller wants\n  // the full axis range from metadata, not a list of explicit weights.\n  if (weights[0] === \"variable\") {\n    const allAxes = googleFontsMetadata[fontFamily].axes;\n    if (!allAxes) {\n      // Reaching this branch means validate accepted a \"variable\" weight for\n      // a non-variable font, which should be impossible because the\n      // metadata-based validator rejects this earlier. Treat as an internal\n      // invariant.\n      throw new Error(\"invariant variable font without axes\");\n    }\n\n    if (selectedVariableAxes) {\n      const definableAxes = allAxes.map(({ tag }) => tag).filter((tag) => tag !== \"wght\");\n      if (definableAxes.length === 0) {\n        throw new Error(`Font \\`${fontFamily}\\` has no definable \\`axes\\``);\n      }\n      if (!Array.isArray(selectedVariableAxes)) {\n        throw new Error(\n          `Invalid axes value for font \\`${fontFamily}\\`, expected an array of axes.\\nAvailable axes: ${formatAvailableValues(definableAxes)}`,\n        );\n      }\n      for (const key of selectedVariableAxes) {\n        if (!definableAxes.includes(key)) {\n          throw new Error(\n            `Invalid axes value \\`${key}\\` for font \\`${fontFamily}\\`.\\nAvailable axes: ${formatAvailableValues(definableAxes)}`,\n          );\n        }\n      }\n    }\n\n    let weightAxis: string | undefined;\n    let variableAxes: [string, string][] | undefined;\n    for (const { tag, min, max } of allAxes) {\n      if (tag === \"wght\") {\n        weightAxis = `${min}..${max}`;\n      } else if (selectedVariableAxes?.includes(tag)) {\n        if (!variableAxes) variableAxes = [];\n        variableAxes.push([tag, `${min}..${max}`]);\n      }\n    }\n\n    return {\n      wght: weightAxis ? [weightAxis] : undefined,\n      ital,\n      variableAxes,\n    };\n  }\n\n  // Non-variable path: weights are explicit face values that the URL builder\n  // emits verbatim.\n  return {\n    wght: weights,\n    ital,\n    variableAxes: undefined,\n  };\n}\n"],"mappings":";;AAWA,MAAM,yBAAyB,WAC7B,OAAO,KAAK,QAAQ,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK;AAE9C,SAAgB,YACd,YACA,SACA,QACA,sBACU;CACV,MAAM,YAAY,OAAO,SAAS,SAAS;CAC3C,MAAM,YAAY,OAAO,SAAS,SAAS;CAG3C,MAAM,OAAO,YAAY,CAAC,GAAI,YAAY,CAAC,IAAI,GAAG,EAAE,EAAG,IAAI,GAAG,KAAA;CAI9D,IAAI,QAAQ,OAAO,YAAY;EAC7B,MAAM,UAAU,oBAAoB,YAAY;EAChD,IAAI,CAAC,SAKH,MAAM,IAAI,MAAM,uCAAuC;EAGzD,IAAI,sBAAsB;GACxB,MAAM,gBAAgB,QAAQ,KAAK,EAAE,UAAU,IAAI,CAAC,QAAQ,QAAQ,QAAQ,OAAO;GACnF,IAAI,cAAc,WAAW,GAC3B,MAAM,IAAI,MAAM,UAAU,WAAW,8BAA8B;GAErE,IAAI,CAAC,MAAM,QAAQ,qBAAqB,EACtC,MAAM,IAAI,MACR,iCAAiC,WAAW,kDAAkD,sBAAsB,cAAc,GACnI;GAEH,KAAK,MAAM,OAAO,sBAChB,IAAI,CAAC,cAAc,SAAS,IAAI,EAC9B,MAAM,IAAI,MACR,wBAAwB,IAAI,gBAAgB,WAAW,uBAAuB,sBAAsB,cAAc,GACnH;;EAKP,IAAI;EACJ,IAAI;EACJ,KAAK,MAAM,EAAE,KAAK,KAAK,SAAS,SAC9B,IAAI,QAAQ,QACV,aAAa,GAAG,IAAI,IAAI;OACnB,IAAI,sBAAsB,SAAS,IAAI,EAAE;GAC9C,IAAI,CAAC,cAAc,eAAe,EAAE;GACpC,aAAa,KAAK,CAAC,KAAK,GAAG,IAAI,IAAI,MAAM,CAAC;;EAI9C,OAAO;GACL,MAAM,aAAa,CAAC,WAAW,GAAG,KAAA;GAClC;GACA;GACD;;CAKH,OAAO;EACL,MAAM;EACN;EACA,cAAc,KAAA;EACf"}

package/dist/build/google-fonts/sort-variants.js.map

@@ -1 +1 @@
-{"version":3,"file":"sort-variants.js","names":[],"sources":["../../../src/build/google-fonts/sort-variants.ts"],"sourcesContent":["// Ported from Next.js: packages/font/src/google/sort-fonts-variant-values.ts\n// https://github.com/vercel/next.js/blob/canary/packages/font/src/google/sort-fonts-variant-values.ts\n//\n// Comparator used by `Array.prototype.sort` when assembling the variant\n// segment of a Google Fonts URL. Google's CSS API requires variant values to\n// be ordered numerically, not lexically. The string ordering of\n// `[\"100\",\"1000\",\"300\"]` would put 1000 before 300, and `[\"1,100\",\"0,200\"]`\n// would put the higher ital prefix first; both produce HTTP 400.\n\nexport function sortFontsVariantValues(valA: string, valB: string): number {\n  // \"ital,wght\" pair format: compare ital first, then wght when ital matches.\n  if (valA.includes(\",\") && valB.includes(\",\")) {\n    const [aPrefix, aSuffix] = valA.split(\",\", 2);\n    const [bPrefix, bSuffix] = valB.split(\",\", 2);\n\n    if (aPrefix === bPrefix) {\n      return parseInt(aSuffix) - parseInt(bSuffix);\n    }\n    return parseInt(aPrefix) - parseInt(bPrefix);\n  }\n\n  // Plain weight string: numeric compare.\n  return parseInt(valA) - parseInt(valB);\n}\n"],"mappings":";AASA,SAAgB,uBAAuB,MAAc,MAAsB;AAEzE,KAAI,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,IAAI,EAAE;EAC5C,MAAM,CAAC,SAAS,WAAW,KAAK,MAAM,KAAK,EAAE;EAC7C,MAAM,CAAC,SAAS,WAAW,KAAK,MAAM,KAAK,EAAE;AAE7C,MAAI,YAAY,QACd,QAAO,SAAS,QAAQ,GAAG,SAAS,QAAQ;AAE9C,SAAO,SAAS,QAAQ,GAAG,SAAS,QAAQ;;AAI9C,QAAO,SAAS,KAAK,GAAG,SAAS,KAAK"}
+{"version":3,"file":"sort-variants.js","names":[],"sources":["../../../src/build/google-fonts/sort-variants.ts"],"sourcesContent":["// Ported from Next.js: packages/font/src/google/sort-fonts-variant-values.ts\n// https://github.com/vercel/next.js/blob/canary/packages/font/src/google/sort-fonts-variant-values.ts\n//\n// Comparator used by `Array.prototype.sort` when assembling the variant\n// segment of a Google Fonts URL. Google's CSS API requires variant values to\n// be ordered numerically, not lexically. The string ordering of\n// `[\"100\",\"1000\",\"300\"]` would put 1000 before 300, and `[\"1,100\",\"0,200\"]`\n// would put the higher ital prefix first; both produce HTTP 400.\n\nexport function sortFontsVariantValues(valA: string, valB: string): number {\n  // \"ital,wght\" pair format: compare ital first, then wght when ital matches.\n  if (valA.includes(\",\") && valB.includes(\",\")) {\n    const [aPrefix, aSuffix] = valA.split(\",\", 2);\n    const [bPrefix, bSuffix] = valB.split(\",\", 2);\n\n    if (aPrefix === bPrefix) {\n      return parseInt(aSuffix) - parseInt(bSuffix);\n    }\n    return parseInt(aPrefix) - parseInt(bPrefix);\n  }\n\n  // Plain weight string: numeric compare.\n  return parseInt(valA) - parseInt(valB);\n}\n"],"mappings":";AASA,SAAgB,uBAAuB,MAAc,MAAsB;CAEzE,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,IAAI,EAAE;EAC5C,MAAM,CAAC,SAAS,WAAW,KAAK,MAAM,KAAK,EAAE;EAC7C,MAAM,CAAC,SAAS,WAAW,KAAK,MAAM,KAAK,EAAE;EAE7C,IAAI,YAAY,SACd,OAAO,SAAS,QAAQ,GAAG,SAAS,QAAQ;EAE9C,OAAO,SAAS,QAAQ,GAAG,SAAS,QAAQ;;CAI9C,OAAO,SAAS,KAAK,GAAG,SAAS,KAAK"}

package/dist/build/google-fonts/validate.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate.js","names":[],"sources":["../../../src/build/google-fonts/validate.ts"],"sourcesContent":["// Ported from Next.js: packages/font/src/google/validate-google-font-function-call.ts\n// https://github.com/vercel/next.js/blob/canary/packages/font/src/google/validate-google-font-function-call.ts\n//\n// Vinext drops Next's SWC-coupled `(functionName, fontFunctionArgument)`\n// calling convention because the plugin already knows the family at parse\n// time. Behaviour is otherwise identical: validate the caller's options\n// against the bundled metadata, default missing fields, and reject anything\n// Google Fonts would reject at request time.\n\nimport { googleFontsMetadata } from \"./font-metadata.js\";\n\nconst ALLOWED_DISPLAY_VALUES = [\"auto\", \"block\", \"swap\", \"fallback\", \"optional\"];\n\ntype GoogleFontOptions = {\n  weight?: string | string[];\n  style?: string | string[];\n  preload?: boolean;\n  display?: string;\n  axes?: string[];\n  fallback?: string[];\n  adjustFontFallback?: boolean;\n  variable?: string;\n  subsets?: string[];\n};\n\ntype ValidatedGoogleFontOptions = {\n  fontFamily: string;\n  weights: string[];\n  styles: string[];\n  display: string;\n  preload: boolean;\n  selectedVariableAxes?: string[];\n  fallback?: string[];\n  adjustFontFallback: boolean;\n  variable?: string;\n  subsets: string[];\n};\n\nconst formatAvailableValues = (values: string[]): string =>\n  values.map((val) => `\\`${val}\\``).join(\", \");\n\nconst dedupe = (values: string[]): string[] => Array.from(new Set(values));\n\nexport function validateGoogleFontOptions(\n  fontFamily: string,\n  options: GoogleFontOptions,\n): ValidatedGoogleFontOptions {\n  const {\n    weight,\n    style,\n    display = \"swap\",\n    axes,\n    fallback,\n    adjustFontFallback = true,\n    variable,\n    subsets = [],\n  } = options;\n  let preload = options.preload ?? true;\n\n  const fontFamilyData = googleFontsMetadata[fontFamily];\n  if (!fontFamilyData) {\n    throw new Error(`Unknown font \\`${fontFamily}\\``);\n  }\n\n  if (axes !== undefined && !Array.isArray(axes)) {\n    throw new Error(\n      `Invalid axes value for font \\`${fontFamily}\\`, expected an array of axis names.`,\n    );\n  }\n\n  const availableSubsets = fontFamilyData.subsets;\n  if (availableSubsets.length === 0) {\n    // No preloadable subsets means preload is meaningless. Silently disable\n    // it rather than forcing the caller to opt out.\n    preload = false;\n  } else if (preload) {\n    // Deliberate parity gap: Next.js uses `if (!subsets)` so an explicit\n    // `subsets: []` passes silently. vinext rejects it as well, since an\n    // empty subsets array with preload enabled is always a caller mistake.\n    if (subsets.length === 0) {\n      throw new Error(\n        `Preload is enabled but no subsets were specified for font \\`${fontFamily}\\`. Please specify subsets or disable preloading if your intended subset can't be preloaded.\\nAvailable subsets: ${formatAvailableValues(availableSubsets)}`,\n      );\n    }\n    for (const subset of subsets) {\n      if (!availableSubsets.includes(subset)) {\n        throw new Error(\n          `Unknown subset \\`${subset}\\` for font \\`${fontFamily}\\`.\\nAvailable subsets: ${formatAvailableValues(availableSubsets)}`,\n        );\n      }\n    }\n  }\n\n  const fontWeights = fontFamilyData.weights;\n  const fontStyles = fontFamilyData.styles;\n\n  const weights = !weight ? [] : dedupe(Array.isArray(weight) ? weight : [weight]);\n  const styles = !style ? [] : dedupe(Array.isArray(style) ? style : [style]);\n\n  if (weights.length === 0) {\n    if (fontWeights.includes(\"variable\")) {\n      // Caller said \"any weight\" and the font has a variable face, so use it.\n      weights.push(\"variable\");\n    } else {\n      throw new Error(\n        `Missing weight for font \\`${fontFamily}\\`.\\nAvailable weights: ${formatAvailableValues(fontWeights)}`,\n      );\n    }\n  }\n\n  if (weights.length > 1 && weights.includes(\"variable\")) {\n    throw new Error(\n      `Unexpected \\`variable\\` in weight array for font \\`${fontFamily}\\`. You only need \\`variable\\`, it includes all available weights.`,\n    );\n  }\n\n  for (const selectedWeight of weights) {\n    if (!fontWeights.includes(selectedWeight)) {\n      throw new Error(\n        `Unknown weight \\`${selectedWeight}\\` for font \\`${fontFamily}\\`.\\nAvailable weights: ${formatAvailableValues(fontWeights)}`,\n      );\n    }\n  }\n\n  if (styles.length === 0) {\n    if (fontStyles.length === 1) {\n      // Italic-only fonts (rare) have no normal face, so use that face.\n      styles.push(fontStyles[0]);\n    } else {\n      styles.push(\"normal\");\n    }\n  }\n\n  for (const selectedStyle of styles) {\n    if (!fontStyles.includes(selectedStyle)) {\n      throw new Error(\n        `Unknown style \\`${selectedStyle}\\` for font \\`${fontFamily}\\`.\\nAvailable styles: ${formatAvailableValues(fontStyles)}`,\n      );\n    }\n  }\n\n  if (!ALLOWED_DISPLAY_VALUES.includes(display)) {\n    throw new Error(\n      `Invalid display value \\`${display}\\` for font \\`${fontFamily}\\`.\\nAvailable display values: ${formatAvailableValues(ALLOWED_DISPLAY_VALUES)}`,\n    );\n  }\n\n  if (axes) {\n    if (!fontWeights.includes(\"variable\")) {\n      throw new Error(\"Axes can only be defined for variable fonts.\");\n    }\n    if (weights[0] !== \"variable\") {\n      throw new Error(\n        \"Axes can only be defined for variable fonts when the weight property is nonexistent or set to `variable`.\",\n      );\n    }\n  }\n\n  return {\n    fontFamily,\n    weights,\n    styles,\n    display,\n    preload,\n    selectedVariableAxes: axes,\n    fallback,\n    adjustFontFallback,\n    variable,\n    subsets,\n  };\n}\n"],"mappings":";;AAWA,MAAM,yBAAyB;CAAC;CAAQ;CAAS;CAAQ;CAAY;CAAW;AA2BhF,MAAM,yBAAyB,WAC7B,OAAO,KAAK,QAAQ,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK;AAE9C,MAAM,UAAU,WAA+B,MAAM,KAAK,IAAI,IAAI,OAAO,CAAC;AAE1E,SAAgB,0BACd,YACA,SAC4B;CAC5B,MAAM,EACJ,QACA,OACA,UAAU,QACV,MACA,UACA,qBAAqB,MACrB,UACA,UAAU,EAAE,KACV;CACJ,IAAI,UAAU,QAAQ,WAAW;CAEjC,MAAM,iBAAiB,oBAAoB;AAC3C,KAAI,CAAC,eACH,OAAM,IAAI,MAAM,kBAAkB,WAAW,IAAI;AAGnD,KAAI,SAAS,KAAA,KAAa,CAAC,MAAM,QAAQ,KAAK,CAC5C,OAAM,IAAI,MACR,iCAAiC,WAAW,sCAC7C;CAGH,MAAM,mBAAmB,eAAe;AACxC,KAAI,iBAAiB,WAAW,EAG9B,WAAU;UACD,SAAS;AAIlB,MAAI,QAAQ,WAAW,EACrB,OAAM,IAAI,MACR,+DAA+D,WAAW,mHAAmH,sBAAsB,iBAAiB,GACrO;AAEH,OAAK,MAAM,UAAU,QACnB,KAAI,CAAC,iBAAiB,SAAS,OAAO,CACpC,OAAM,IAAI,MACR,oBAAoB,OAAO,gBAAgB,WAAW,0BAA0B,sBAAsB,iBAAiB,GACxH;;CAKP,MAAM,cAAc,eAAe;CACnC,MAAM,aAAa,eAAe;CAElC,MAAM,UAAU,CAAC,SAAS,EAAE,GAAG,OAAO,MAAM,QAAQ,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;CAChF,MAAM,SAAS,CAAC,QAAQ,EAAE,GAAG,OAAO,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;AAE3E,KAAI,QAAQ,WAAW,EACrB,KAAI,YAAY,SAAS,WAAW,CAElC,SAAQ,KAAK,WAAW;KAExB,OAAM,IAAI,MACR,6BAA6B,WAAW,0BAA0B,sBAAsB,YAAY,GACrG;AAIL,KAAI,QAAQ,SAAS,KAAK,QAAQ,SAAS,WAAW,CACpD,OAAM,IAAI,MACR,sDAAsD,WAAW,oEAClE;AAGH,MAAK,MAAM,kBAAkB,QAC3B,KAAI,CAAC,YAAY,SAAS,eAAe,CACvC,OAAM,IAAI,MACR,oBAAoB,eAAe,gBAAgB,WAAW,0BAA0B,sBAAsB,YAAY,GAC3H;AAIL,KAAI,OAAO,WAAW,EACpB,KAAI,WAAW,WAAW,EAExB,QAAO,KAAK,WAAW,GAAG;KAE1B,QAAO,KAAK,SAAS;AAIzB,MAAK,MAAM,iBAAiB,OAC1B,KAAI,CAAC,WAAW,SAAS,cAAc,CACrC,OAAM,IAAI,MACR,mBAAmB,cAAc,gBAAgB,WAAW,yBAAyB,sBAAsB,WAAW,GACvH;AAIL,KAAI,CAAC,uBAAuB,SAAS,QAAQ,CAC3C,OAAM,IAAI,MACR,2BAA2B,QAAQ,gBAAgB,WAAW,iCAAiC,sBAAsB,uBAAuB,GAC7I;AAGH,KAAI,MAAM;AACR,MAAI,CAAC,YAAY,SAAS,WAAW,CACnC,OAAM,IAAI,MAAM,+CAA+C;AAEjE,MAAI,QAAQ,OAAO,WACjB,OAAM,IAAI,MACR,4GACD;;AAIL,QAAO;EACL;EACA;EACA;EACA;EACA;EACA,sBAAsB;EACtB;EACA;EACA;EACA;EACD"}
+{"version":3,"file":"validate.js","names":[],"sources":["../../../src/build/google-fonts/validate.ts"],"sourcesContent":["// Ported from Next.js: packages/font/src/google/validate-google-font-function-call.ts\n// https://github.com/vercel/next.js/blob/canary/packages/font/src/google/validate-google-font-function-call.ts\n//\n// Vinext drops Next's SWC-coupled `(functionName, fontFunctionArgument)`\n// calling convention because the plugin already knows the family at parse\n// time. Behaviour is otherwise identical: validate the caller's options\n// against the bundled metadata, default missing fields, and reject anything\n// Google Fonts would reject at request time.\n\nimport { googleFontsMetadata } from \"./font-metadata.js\";\n\nconst ALLOWED_DISPLAY_VALUES = [\"auto\", \"block\", \"swap\", \"fallback\", \"optional\"];\n\ntype GoogleFontOptions = {\n  weight?: string | string[];\n  style?: string | string[];\n  preload?: boolean;\n  display?: string;\n  axes?: string[];\n  fallback?: string[];\n  adjustFontFallback?: boolean;\n  variable?: string;\n  subsets?: string[];\n};\n\ntype ValidatedGoogleFontOptions = {\n  fontFamily: string;\n  weights: string[];\n  styles: string[];\n  display: string;\n  preload: boolean;\n  selectedVariableAxes?: string[];\n  fallback?: string[];\n  adjustFontFallback: boolean;\n  variable?: string;\n  subsets: string[];\n};\n\nconst formatAvailableValues = (values: string[]): string =>\n  values.map((val) => `\\`${val}\\``).join(\", \");\n\nconst dedupe = (values: string[]): string[] => Array.from(new Set(values));\n\nexport function validateGoogleFontOptions(\n  fontFamily: string,\n  options: GoogleFontOptions,\n): ValidatedGoogleFontOptions {\n  const {\n    weight,\n    style,\n    display = \"swap\",\n    axes,\n    fallback,\n    adjustFontFallback = true,\n    variable,\n    subsets = [],\n  } = options;\n  let preload = options.preload ?? true;\n\n  const fontFamilyData = googleFontsMetadata[fontFamily];\n  if (!fontFamilyData) {\n    throw new Error(`Unknown font \\`${fontFamily}\\``);\n  }\n\n  if (axes !== undefined && !Array.isArray(axes)) {\n    throw new Error(\n      `Invalid axes value for font \\`${fontFamily}\\`, expected an array of axis names.`,\n    );\n  }\n\n  const availableSubsets = fontFamilyData.subsets;\n  if (availableSubsets.length === 0) {\n    // No preloadable subsets means preload is meaningless. Silently disable\n    // it rather than forcing the caller to opt out.\n    preload = false;\n  } else if (preload) {\n    // Deliberate parity gap: Next.js uses `if (!subsets)` so an explicit\n    // `subsets: []` passes silently. vinext rejects it as well, since an\n    // empty subsets array with preload enabled is always a caller mistake.\n    if (subsets.length === 0) {\n      throw new Error(\n        `Preload is enabled but no subsets were specified for font \\`${fontFamily}\\`. Please specify subsets or disable preloading if your intended subset can't be preloaded.\\nAvailable subsets: ${formatAvailableValues(availableSubsets)}`,\n      );\n    }\n    for (const subset of subsets) {\n      if (!availableSubsets.includes(subset)) {\n        throw new Error(\n          `Unknown subset \\`${subset}\\` for font \\`${fontFamily}\\`.\\nAvailable subsets: ${formatAvailableValues(availableSubsets)}`,\n        );\n      }\n    }\n  }\n\n  const fontWeights = fontFamilyData.weights;\n  const fontStyles = fontFamilyData.styles;\n\n  const weights = !weight ? [] : dedupe(Array.isArray(weight) ? weight : [weight]);\n  const styles = !style ? [] : dedupe(Array.isArray(style) ? style : [style]);\n\n  if (weights.length === 0) {\n    if (fontWeights.includes(\"variable\")) {\n      // Caller said \"any weight\" and the font has a variable face, so use it.\n      weights.push(\"variable\");\n    } else {\n      throw new Error(\n        `Missing weight for font \\`${fontFamily}\\`.\\nAvailable weights: ${formatAvailableValues(fontWeights)}`,\n      );\n    }\n  }\n\n  if (weights.length > 1 && weights.includes(\"variable\")) {\n    throw new Error(\n      `Unexpected \\`variable\\` in weight array for font \\`${fontFamily}\\`. You only need \\`variable\\`, it includes all available weights.`,\n    );\n  }\n\n  for (const selectedWeight of weights) {\n    if (!fontWeights.includes(selectedWeight)) {\n      throw new Error(\n        `Unknown weight \\`${selectedWeight}\\` for font \\`${fontFamily}\\`.\\nAvailable weights: ${formatAvailableValues(fontWeights)}`,\n      );\n    }\n  }\n\n  if (styles.length === 0) {\n    if (fontStyles.length === 1) {\n      // Italic-only fonts (rare) have no normal face, so use that face.\n      styles.push(fontStyles[0]);\n    } else {\n      styles.push(\"normal\");\n    }\n  }\n\n  for (const selectedStyle of styles) {\n    if (!fontStyles.includes(selectedStyle)) {\n      throw new Error(\n        `Unknown style \\`${selectedStyle}\\` for font \\`${fontFamily}\\`.\\nAvailable styles: ${formatAvailableValues(fontStyles)}`,\n      );\n    }\n  }\n\n  if (!ALLOWED_DISPLAY_VALUES.includes(display)) {\n    throw new Error(\n      `Invalid display value \\`${display}\\` for font \\`${fontFamily}\\`.\\nAvailable display values: ${formatAvailableValues(ALLOWED_DISPLAY_VALUES)}`,\n    );\n  }\n\n  if (axes) {\n    if (!fontWeights.includes(\"variable\")) {\n      throw new Error(\"Axes can only be defined for variable fonts.\");\n    }\n    if (weights[0] !== \"variable\") {\n      throw new Error(\n        \"Axes can only be defined for variable fonts when the weight property is nonexistent or set to `variable`.\",\n      );\n    }\n  }\n\n  return {\n    fontFamily,\n    weights,\n    styles,\n    display,\n    preload,\n    selectedVariableAxes: axes,\n    fallback,\n    adjustFontFallback,\n    variable,\n    subsets,\n  };\n}\n"],"mappings":";;AAWA,MAAM,yBAAyB;CAAC;CAAQ;CAAS;CAAQ;CAAY;CAAW;AA2BhF,MAAM,yBAAyB,WAC7B,OAAO,KAAK,QAAQ,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK;AAE9C,MAAM,UAAU,WAA+B,MAAM,KAAK,IAAI,IAAI,OAAO,CAAC;AAE1E,SAAgB,0BACd,YACA,SAC4B;CAC5B,MAAM,EACJ,QACA,OACA,UAAU,QACV,MACA,UACA,qBAAqB,MACrB,UACA,UAAU,EAAE,KACV;CACJ,IAAI,UAAU,QAAQ,WAAW;CAEjC,MAAM,iBAAiB,oBAAoB;CAC3C,IAAI,CAAC,gBACH,MAAM,IAAI,MAAM,kBAAkB,WAAW,IAAI;CAGnD,IAAI,SAAS,KAAA,KAAa,CAAC,MAAM,QAAQ,KAAK,EAC5C,MAAM,IAAI,MACR,iCAAiC,WAAW,sCAC7C;CAGH,MAAM,mBAAmB,eAAe;CACxC,IAAI,iBAAiB,WAAW,GAG9B,UAAU;MACL,IAAI,SAAS;EAIlB,IAAI,QAAQ,WAAW,GACrB,MAAM,IAAI,MACR,+DAA+D,WAAW,mHAAmH,sBAAsB,iBAAiB,GACrO;EAEH,KAAK,MAAM,UAAU,SACnB,IAAI,CAAC,iBAAiB,SAAS,OAAO,EACpC,MAAM,IAAI,MACR,oBAAoB,OAAO,gBAAgB,WAAW,0BAA0B,sBAAsB,iBAAiB,GACxH;;CAKP,MAAM,cAAc,eAAe;CACnC,MAAM,aAAa,eAAe;CAElC,MAAM,UAAU,CAAC,SAAS,EAAE,GAAG,OAAO,MAAM,QAAQ,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;CAChF,MAAM,SAAS,CAAC,QAAQ,EAAE,GAAG,OAAO,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;CAE3E,IAAI,QAAQ,WAAW,GACrB,IAAI,YAAY,SAAS,WAAW,EAElC,QAAQ,KAAK,WAAW;MAExB,MAAM,IAAI,MACR,6BAA6B,WAAW,0BAA0B,sBAAsB,YAAY,GACrG;CAIL,IAAI,QAAQ,SAAS,KAAK,QAAQ,SAAS,WAAW,EACpD,MAAM,IAAI,MACR,sDAAsD,WAAW,oEAClE;CAGH,KAAK,MAAM,kBAAkB,SAC3B,IAAI,CAAC,YAAY,SAAS,eAAe,EACvC,MAAM,IAAI,MACR,oBAAoB,eAAe,gBAAgB,WAAW,0BAA0B,sBAAsB,YAAY,GAC3H;CAIL,IAAI,OAAO,WAAW,GACpB,IAAI,WAAW,WAAW,GAExB,OAAO,KAAK,WAAW,GAAG;MAE1B,OAAO,KAAK,SAAS;CAIzB,KAAK,MAAM,iBAAiB,QAC1B,IAAI,CAAC,WAAW,SAAS,cAAc,EACrC,MAAM,IAAI,MACR,mBAAmB,cAAc,gBAAgB,WAAW,yBAAyB,sBAAsB,WAAW,GACvH;CAIL,IAAI,CAAC,uBAAuB,SAAS,QAAQ,EAC3C,MAAM,IAAI,MACR,2BAA2B,QAAQ,gBAAgB,WAAW,iCAAiC,sBAAsB,uBAAuB,GAC7I;CAGH,IAAI,MAAM;EACR,IAAI,CAAC,YAAY,SAAS,WAAW,EACnC,MAAM,IAAI,MAAM,+CAA+C;EAEjE,IAAI,QAAQ,OAAO,YACjB,MAAM,IAAI,MACR,4GACD;;CAIL,OAAO;EACL;EACA;EACA;EACA;EACA;EACA,sBAAsB;EACtB;EACA;EACA;EACA;EACD"}

package/dist/build/layout-classification.js.map

@@ -1 +1 @@
-{"version":3,"file":"layout-classification.js","names":[],"sources":["../../src/build/layout-classification.ts"],"sourcesContent":["/**\n * Layout classification — determines whether each layout in an App Router\n * route tree is static or dynamic via two complementary detection layers:\n *\n *   Layer 1: Segment config (`export const dynamic`, `export const revalidate`)\n *   Layer 2: Module graph traversal (checks for transitive dynamic shim imports)\n *\n * Layer 3 (probe-based runtime detection) is handled separately in\n * `app-page-execution.ts` at request time.\n *\n * Every result is carried as a `LayoutBuildClassification` tagged variant so\n * operators can trace which layer produced a decision via the structured\n * `ClassificationReason` sidecar without that metadata leaking onto the wire.\n */\n\nimport { classifyLayoutSegmentConfig } from \"./report.js\";\nimport { AppElementsWire } from \"../server/app-elements.js\";\nimport { createAppPageTreePath } from \"../server/app-page-route-wiring.js\";\nimport type {\n  ClassificationReason,\n  LayoutBuildClassification,\n  ModuleGraphStaticReason,\n} from \"./layout-classification-types.js\";\n\ntype ModuleGraphClassification = \"static\" | \"needs-probe\";\n\ntype ModuleGraphClassificationResult = {\n  result: ModuleGraphClassification;\n  /** First dynamic shim module ID encountered during BFS, when any. */\n  firstShimMatch?: string;\n};\n\nexport type ModuleInfoProvider = {\n  getModuleInfo(id: string): {\n    importedIds: string[];\n    dynamicImportedIds: string[];\n  } | null;\n};\n\ntype LayoutEntry = {\n  /** Rollup/Vite module ID for the layout file. */\n  moduleId: string;\n  /** Directory depth from the app root, used to build the stable layout ID. */\n  treePosition: number;\n  /** Segment config source code extracted at build time, or null when absent. */\n  segmentConfig?: { code: string } | null;\n};\n\ntype RouteForClassification = {\n  layouts: readonly LayoutEntry[];\n  routeSegments: string[];\n};\n\n/**\n * BFS traversal of a layout's dependency tree. If any transitive import\n * resolves to a dynamic shim path (headers, cache, server), the layout\n * cannot be proven static at build time and needs a runtime probe.\n *\n * The returned object carries the classification plus the first matching\n * shim module ID (when any). Operators use the shim ID via the debug\n * channel to trace why a layout was flagged for probing.\n */\nexport function classifyLayoutByModuleGraph(\n  layoutModuleId: string,\n  dynamicShimPaths: ReadonlySet<string>,\n  moduleInfo: ModuleInfoProvider,\n): ModuleGraphClassificationResult {\n  const visited = new Set<string>();\n  const queue: string[] = [layoutModuleId];\n  let head = 0;\n\n  while (head < queue.length) {\n    const currentId = queue[head++]!;\n\n    if (visited.has(currentId)) continue;\n    visited.add(currentId);\n\n    if (dynamicShimPaths.has(currentId)) {\n      return { result: \"needs-probe\", firstShimMatch: currentId };\n    }\n\n    const info = moduleInfo.getModuleInfo(currentId);\n    if (!info) continue;\n\n    for (const importedId of info.importedIds) {\n      if (!visited.has(importedId)) queue.push(importedId);\n    }\n    for (const dynamicId of info.dynamicImportedIds) {\n      if (!visited.has(dynamicId)) queue.push(dynamicId);\n    }\n  }\n\n  return { result: \"static\" };\n}\n\nexport function moduleGraphReason(\n  graphResult: ModuleGraphClassificationResult & { result: \"static\" },\n): ModuleGraphStaticReason;\nexport function moduleGraphReason(\n  graphResult: ModuleGraphClassificationResult,\n): ClassificationReason;\nexport function moduleGraphReason(\n  graphResult: ModuleGraphClassificationResult,\n): ClassificationReason {\n  if (graphResult.firstShimMatch === undefined) {\n    return { layer: \"module-graph\", result: graphResult.result };\n  }\n  return {\n    layer: \"module-graph\",\n    result: graphResult.result,\n    firstShimMatch: graphResult.firstShimMatch,\n  };\n}\n\nexport function isStaticModuleGraphResult(\n  graphResult: ModuleGraphClassificationResult,\n): graphResult is ModuleGraphClassificationResult & { result: \"static\" } {\n  return graphResult.result === \"static\";\n}\n\n/**\n * Classifies all layouts across all routes using a two-layer strategy:\n *\n * 1. Segment config (Layer 1) — short-circuits to \"static\" or \"dynamic\"\n * 2. Module graph (Layer 2) — BFS for dynamic shim imports → \"static\" or \"needs-probe\"\n *\n * Shared layouts (same file appearing in multiple routes) are classified once\n * and deduplicated by layout ID.\n *\n * @internal Not called by production code. The `generateBundle` hook in\n * `index.ts` calls `classifyLayoutByModuleGraph` directly and composes\n * via the numeric-index manifest in `route-classification-manifest.ts`.\n * Used only by `tests/layout-classification.test.ts`.\n */\nexport function classifyAllRouteLayouts(\n  routes: readonly RouteForClassification[],\n  dynamicShimPaths: ReadonlySet<string>,\n  moduleInfo: ModuleInfoProvider,\n): Map<string, LayoutBuildClassification> {\n  const result = new Map<string, LayoutBuildClassification>();\n\n  for (const route of routes) {\n    for (const layout of route.layouts) {\n      const layoutId = AppElementsWire.encodeLayoutId(\n        createAppPageTreePath(route.routeSegments, layout.treePosition),\n      );\n\n      if (result.has(layoutId)) continue;\n\n      // Layer 1: segment config\n      if (layout.segmentConfig) {\n        const configResult = classifyLayoutSegmentConfig(layout.segmentConfig.code);\n        if (configResult.kind !== \"absent\") {\n          result.set(layoutId, configResult);\n          continue;\n        }\n      }\n\n      // Layer 2: module graph\n      const graphResult = classifyLayoutByModuleGraph(\n        layout.moduleId,\n        dynamicShimPaths,\n        moduleInfo,\n      );\n      const reason = moduleGraphReason(graphResult);\n      result.set(layoutId, { kind: graphResult.result, reason });\n    }\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8DA,SAAgB,4BACd,gBACA,kBACA,YACiC;CACjC,MAAM,0BAAU,IAAI,KAAa;CACjC,MAAM,QAAkB,CAAC,eAAe;CACxC,IAAI,OAAO;AAEX,QAAO,OAAO,MAAM,QAAQ;EAC1B,MAAM,YAAY,MAAM;AAExB,MAAI,QAAQ,IAAI,UAAU,CAAE;AAC5B,UAAQ,IAAI,UAAU;AAEtB,MAAI,iBAAiB,IAAI,UAAU,CACjC,QAAO;GAAE,QAAQ;GAAe,gBAAgB;GAAW;EAG7D,MAAM,OAAO,WAAW,cAAc,UAAU;AAChD,MAAI,CAAC,KAAM;AAEX,OAAK,MAAM,cAAc,KAAK,YAC5B,KAAI,CAAC,QAAQ,IAAI,WAAW,CAAE,OAAM,KAAK,WAAW;AAEtD,OAAK,MAAM,aAAa,KAAK,mBAC3B,KAAI,CAAC,QAAQ,IAAI,UAAU,CAAE,OAAM,KAAK,UAAU;;AAItD,QAAO,EAAE,QAAQ,UAAU;;AAS7B,SAAgB,kBACd,aACsB;AACtB,KAAI,YAAY,mBAAmB,KAAA,EACjC,QAAO;EAAE,OAAO;EAAgB,QAAQ,YAAY;EAAQ;AAE9D,QAAO;EACL,OAAO;EACP,QAAQ,YAAY;EACpB,gBAAgB,YAAY;EAC7B;;AAGH,SAAgB,0BACd,aACuE;AACvE,QAAO,YAAY,WAAW;;;;;;;;;;;;;;;;AAiBhC,SAAgB,wBACd,QACA,kBACA,YACwC;CACxC,MAAM,yBAAS,IAAI,KAAwC;AAE3D,MAAK,MAAM,SAAS,OAClB,MAAK,MAAM,UAAU,MAAM,SAAS;EAClC,MAAM,WAAW,gBAAgB,eAC/B,sBAAsB,MAAM,eAAe,OAAO,aAAa,CAChE;AAED,MAAI,OAAO,IAAI,SAAS,CAAE;AAG1B,MAAI,OAAO,eAAe;GACxB,MAAM,eAAe,4BAA4B,OAAO,cAAc,KAAK;AAC3E,OAAI,aAAa,SAAS,UAAU;AAClC,WAAO,IAAI,UAAU,aAAa;AAClC;;;EAKJ,MAAM,cAAc,4BAClB,OAAO,UACP,kBACA,WACD;EACD,MAAM,SAAS,kBAAkB,YAAY;AAC7C,SAAO,IAAI,UAAU;GAAE,MAAM,YAAY;GAAQ;GAAQ,CAAC;;AAI9D,QAAO"}
+{"version":3,"file":"layout-classification.js","names":[],"sources":["../../src/build/layout-classification.ts"],"sourcesContent":["/**\n * Layout classification — determines whether each layout in an App Router\n * route tree is static or dynamic via two complementary detection layers:\n *\n *   Layer 1: Segment config (`export const dynamic`, `export const revalidate`)\n *   Layer 2: Module graph traversal (checks for transitive dynamic shim imports)\n *\n * Layer 3 (probe-based runtime detection) is handled separately in\n * `app-page-execution.ts` at request time.\n *\n * Every result is carried as a `LayoutBuildClassification` tagged variant so\n * operators can trace which layer produced a decision via the structured\n * `ClassificationReason` sidecar without that metadata leaking onto the wire.\n */\n\nimport { classifyLayoutSegmentConfig } from \"./report.js\";\nimport { AppElementsWire } from \"../server/app-elements.js\";\nimport { createAppPageTreePath } from \"../server/app-page-route-wiring.js\";\nimport type {\n  ClassificationReason,\n  LayoutBuildClassification,\n  ModuleGraphStaticReason,\n} from \"./layout-classification-types.js\";\n\ntype ModuleGraphClassification = \"static\" | \"needs-probe\";\n\ntype ModuleGraphClassificationResult = {\n  result: ModuleGraphClassification;\n  /** First dynamic shim module ID encountered during BFS, when any. */\n  firstShimMatch?: string;\n};\n\nexport type ModuleInfoProvider = {\n  getModuleInfo(id: string): {\n    importedIds: string[];\n    dynamicImportedIds: string[];\n  } | null;\n};\n\ntype LayoutEntry = {\n  /** Rollup/Vite module ID for the layout file. */\n  moduleId: string;\n  /** Directory depth from the app root, used to build the stable layout ID. */\n  treePosition: number;\n  /** Segment config source code extracted at build time, or null when absent. */\n  segmentConfig?: { code: string } | null;\n};\n\ntype RouteForClassification = {\n  layouts: readonly LayoutEntry[];\n  routeSegments: string[];\n};\n\n/**\n * BFS traversal of a layout's dependency tree. If any transitive import\n * resolves to a dynamic shim path (headers, cache, server), the layout\n * cannot be proven static at build time and needs a runtime probe.\n *\n * The returned object carries the classification plus the first matching\n * shim module ID (when any). Operators use the shim ID via the debug\n * channel to trace why a layout was flagged for probing.\n */\nexport function classifyLayoutByModuleGraph(\n  layoutModuleId: string,\n  dynamicShimPaths: ReadonlySet<string>,\n  moduleInfo: ModuleInfoProvider,\n): ModuleGraphClassificationResult {\n  const visited = new Set<string>();\n  const queue: string[] = [layoutModuleId];\n  let head = 0;\n\n  while (head < queue.length) {\n    const currentId = queue[head++]!;\n\n    if (visited.has(currentId)) continue;\n    visited.add(currentId);\n\n    if (dynamicShimPaths.has(currentId)) {\n      return { result: \"needs-probe\", firstShimMatch: currentId };\n    }\n\n    const info = moduleInfo.getModuleInfo(currentId);\n    if (!info) continue;\n\n    for (const importedId of info.importedIds) {\n      if (!visited.has(importedId)) queue.push(importedId);\n    }\n    for (const dynamicId of info.dynamicImportedIds) {\n      if (!visited.has(dynamicId)) queue.push(dynamicId);\n    }\n  }\n\n  return { result: \"static\" };\n}\n\nexport function moduleGraphReason(\n  graphResult: ModuleGraphClassificationResult & { result: \"static\" },\n): ModuleGraphStaticReason;\nexport function moduleGraphReason(\n  graphResult: ModuleGraphClassificationResult,\n): ClassificationReason;\nexport function moduleGraphReason(\n  graphResult: ModuleGraphClassificationResult,\n): ClassificationReason {\n  if (graphResult.firstShimMatch === undefined) {\n    return { layer: \"module-graph\", result: graphResult.result };\n  }\n  return {\n    layer: \"module-graph\",\n    result: graphResult.result,\n    firstShimMatch: graphResult.firstShimMatch,\n  };\n}\n\nexport function isStaticModuleGraphResult(\n  graphResult: ModuleGraphClassificationResult,\n): graphResult is ModuleGraphClassificationResult & { result: \"static\" } {\n  return graphResult.result === \"static\";\n}\n\n/**\n * Classifies all layouts across all routes using a two-layer strategy:\n *\n * 1. Segment config (Layer 1) — short-circuits to \"static\" or \"dynamic\"\n * 2. Module graph (Layer 2) — BFS for dynamic shim imports → \"static\" or \"needs-probe\"\n *\n * Shared layouts (same file appearing in multiple routes) are classified once\n * and deduplicated by layout ID.\n *\n * @internal Not called by production code. The `generateBundle` hook in\n * `index.ts` calls `classifyLayoutByModuleGraph` directly and composes\n * via the numeric-index manifest in `route-classification-manifest.ts`.\n * Used only by `tests/layout-classification.test.ts`.\n */\nexport function classifyAllRouteLayouts(\n  routes: readonly RouteForClassification[],\n  dynamicShimPaths: ReadonlySet<string>,\n  moduleInfo: ModuleInfoProvider,\n): Map<string, LayoutBuildClassification> {\n  const result = new Map<string, LayoutBuildClassification>();\n\n  for (const route of routes) {\n    for (const layout of route.layouts) {\n      const layoutId = AppElementsWire.encodeLayoutId(\n        createAppPageTreePath(route.routeSegments, layout.treePosition),\n      );\n\n      if (result.has(layoutId)) continue;\n\n      // Layer 1: segment config\n      if (layout.segmentConfig) {\n        const configResult = classifyLayoutSegmentConfig(layout.segmentConfig.code);\n        if (configResult.kind !== \"absent\") {\n          result.set(layoutId, configResult);\n          continue;\n        }\n      }\n\n      // Layer 2: module graph\n      const graphResult = classifyLayoutByModuleGraph(\n        layout.moduleId,\n        dynamicShimPaths,\n        moduleInfo,\n      );\n      const reason = moduleGraphReason(graphResult);\n      result.set(layoutId, { kind: graphResult.result, reason });\n    }\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8DA,SAAgB,4BACd,gBACA,kBACA,YACiC;CACjC,MAAM,0BAAU,IAAI,KAAa;CACjC,MAAM,QAAkB,CAAC,eAAe;CACxC,IAAI,OAAO;CAEX,OAAO,OAAO,MAAM,QAAQ;EAC1B,MAAM,YAAY,MAAM;EAExB,IAAI,QAAQ,IAAI,UAAU,EAAE;EAC5B,QAAQ,IAAI,UAAU;EAEtB,IAAI,iBAAiB,IAAI,UAAU,EACjC,OAAO;GAAE,QAAQ;GAAe,gBAAgB;GAAW;EAG7D,MAAM,OAAO,WAAW,cAAc,UAAU;EAChD,IAAI,CAAC,MAAM;EAEX,KAAK,MAAM,cAAc,KAAK,aAC5B,IAAI,CAAC,QAAQ,IAAI,WAAW,EAAE,MAAM,KAAK,WAAW;EAEtD,KAAK,MAAM,aAAa,KAAK,oBAC3B,IAAI,CAAC,QAAQ,IAAI,UAAU,EAAE,MAAM,KAAK,UAAU;;CAItD,OAAO,EAAE,QAAQ,UAAU;;AAS7B,SAAgB,kBACd,aACsB;CACtB,IAAI,YAAY,mBAAmB,KAAA,GACjC,OAAO;EAAE,OAAO;EAAgB,QAAQ,YAAY;EAAQ;CAE9D,OAAO;EACL,OAAO;EACP,QAAQ,YAAY;EACpB,gBAAgB,YAAY;EAC7B;;AAGH,SAAgB,0BACd,aACuE;CACvE,OAAO,YAAY,WAAW;;;;;;;;;;;;;;;;AAiBhC,SAAgB,wBACd,QACA,kBACA,YACwC;CACxC,MAAM,yBAAS,IAAI,KAAwC;CAE3D,KAAK,MAAM,SAAS,QAClB,KAAK,MAAM,UAAU,MAAM,SAAS;EAClC,MAAM,WAAW,gBAAgB,eAC/B,sBAAsB,MAAM,eAAe,OAAO,aAAa,CAChE;EAED,IAAI,OAAO,IAAI,SAAS,EAAE;EAG1B,IAAI,OAAO,eAAe;GACxB,MAAM,eAAe,4BAA4B,OAAO,cAAc,KAAK;GAC3E,IAAI,aAAa,SAAS,UAAU;IAClC,OAAO,IAAI,UAAU,aAAa;IAClC;;;EAKJ,MAAM,cAAc,4BAClB,OAAO,UACP,kBACA,WACD;EACD,MAAM,SAAS,kBAAkB,YAAY;EAC7C,OAAO,IAAI,UAAU;GAAE,MAAM,YAAY;GAAQ;GAAQ,CAAC;;CAI9D,OAAO"}

package/dist/build/nitro-route-rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"nitro-route-rules.js","names":[],"sources":["../../src/build/nitro-route-rules.ts"],"sourcesContent":["import { appRouter, type AppRoute } from \"../routing/app-router.js\";\nimport { apiRouter, pagesRouter, type Route } from \"../routing/pages-router.js\";\nimport { buildReportRows, type RouteRow } from \"./report.js\";\n\n// Mirrors Nitro's NitroRouteConfig — hand-rolled because nitropack is not a direct dependency.\nexport type NitroRouteRuleConfig = Record<string, unknown> & {\n  swr?: boolean | number;\n  cache?: unknown;\n  static?: boolean;\n  isr?: boolean | number;\n  prerender?: boolean;\n};\n\ntype NitroRouteRules = Record<string, { swr: number }>;\n\n/**\n * Scans the filesystem for route files and generates Nitro `routeRules` for ISR routes.\n *\n * Note: this duplicates the filesystem scanning that `printBuildReport` also performs.\n * The `nitro.setup` hook runs during Nitro initialization (before the build), while\n * `printBuildReport` runs after the build, so sharing results is non-trivial. This is\n * a future optimization target.\n *\n * Unlike `printBuildReport`, this path does not receive `prerenderResult`, so routes\n * classified as `unknown` by static analysis (which `printBuildReport` might upgrade\n * to `static` via speculative prerender) are skipped here.\n */\nexport async function collectNitroRouteRules(options: {\n  appDir?: string | null;\n  pagesDir?: string | null;\n  pageExtensions: string[];\n}): Promise<NitroRouteRules> {\n  const { appDir, pageExtensions, pagesDir } = options;\n\n  let appRoutes: AppRoute[] = [];\n  let pageRoutes: Route[] = [];\n  let apiRoutes: Route[] = [];\n\n  if (appDir) {\n    appRoutes = await appRouter(appDir, pageExtensions);\n  }\n\n  if (pagesDir) {\n    const [pages, apis] = await Promise.all([\n      pagesRouter(pagesDir, pageExtensions),\n      apiRouter(pagesDir, pageExtensions),\n    ]);\n    pageRoutes = pages;\n    apiRoutes = apis;\n  }\n\n  return generateNitroRouteRules(buildReportRows({ appRoutes, pageRoutes, apiRoutes }));\n}\n\nexport function generateNitroRouteRules(rows: RouteRow[]): NitroRouteRules {\n  const rules: NitroRouteRules = {};\n\n  for (const row of rows) {\n    if (\n      row.type === \"isr\" &&\n      typeof row.revalidate === \"number\" &&\n      Number.isFinite(row.revalidate) &&\n      row.revalidate > 0\n    ) {\n      rules[convertToNitroPattern(row.pattern)] = { swr: row.revalidate };\n    }\n  }\n\n  return rules;\n}\n\n/**\n * Converts vinext's internal `:param` route syntax to Nitro's rou3\n * pattern format. Nitro uses `rou3` for routeRules matching, which\n * supports `*` (single-segment) and `**` (multi-segment) wildcards.\n *\n *   /blog/:slug   -> /blog/*   (single segment)\n *   /docs/:slug+  -> /docs/**  (one or more segments — catch-all)\n *   /docs/:slug*  -> /docs/**  (zero or more segments — optional catch-all)\n *   /about        -> /about    (unchanged)\n *   /:a/:b produces `/*`/`/*` (consecutive single-segment params)\n */\nexport function convertToNitroPattern(pattern: string): string {\n  return pattern\n    .split(\"/\")\n    .map((segment) => {\n      if (segment.startsWith(\":\")) {\n        // Catch-all (:param+) and optional catch-all (:param*) match multiple segments → **\n        // Single dynamic param (:param) matches one segment → *\n        return segment.endsWith(\"+\") || segment.endsWith(\"*\") ? \"**\" : \"*\";\n      }\n      return segment;\n    })\n    .join(\"/\");\n}\n\nexport function mergeNitroRouteRules(\n  existingRouteRules: Record<string, NitroRouteRuleConfig> | undefined,\n  generatedRouteRules: NitroRouteRules,\n): {\n  routeRules: Record<string, NitroRouteRuleConfig>;\n  skippedRoutes: string[];\n} {\n  const routeRules = { ...existingRouteRules };\n  const skippedRoutes: string[] = [];\n\n  for (const [route, generatedRule] of Object.entries(generatedRouteRules)) {\n    const existingRule = routeRules[route];\n\n    if (existingRule && hasUserDefinedCacheRule(existingRule)) {\n      skippedRoutes.push(route);\n      continue;\n    }\n\n    routeRules[route] = {\n      ...existingRule,\n      ...generatedRule,\n    };\n  }\n\n  return { routeRules, skippedRoutes };\n}\n\nfunction hasUserDefinedCacheRule(rule: NitroRouteRuleConfig): boolean {\n  return (\n    rule.swr !== undefined ||\n    rule.cache !== undefined ||\n    rule.static !== undefined ||\n    rule.isr !== undefined ||\n    rule.prerender !== undefined\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;AA2BA,eAAsB,uBAAuB,SAIhB;CAC3B,MAAM,EAAE,QAAQ,gBAAgB,aAAa;CAE7C,IAAI,YAAwB,EAAE;CAC9B,IAAI,aAAsB,EAAE;CAC5B,IAAI,YAAqB,EAAE;AAE3B,KAAI,OACF,aAAY,MAAM,UAAU,QAAQ,eAAe;AAGrD,KAAI,UAAU;EACZ,MAAM,CAAC,OAAO,QAAQ,MAAM,QAAQ,IAAI,CACtC,YAAY,UAAU,eAAe,EACrC,UAAU,UAAU,eAAe,CACpC,CAAC;AACF,eAAa;AACb,cAAY;;AAGd,QAAO,wBAAwB,gBAAgB;EAAE;EAAW;EAAY;EAAW,CAAC,CAAC;;AAGvF,SAAgB,wBAAwB,MAAmC;CACzE,MAAM,QAAyB,EAAE;AAEjC,MAAK,MAAM,OAAO,KAChB,KACE,IAAI,SAAS,SACb,OAAO,IAAI,eAAe,YAC1B,OAAO,SAAS,IAAI,WAAW,IAC/B,IAAI,aAAa,EAEjB,OAAM,sBAAsB,IAAI,QAAQ,IAAI,EAAE,KAAK,IAAI,YAAY;AAIvE,QAAO;;;;;;;;;;;;;AAcT,SAAgB,sBAAsB,SAAyB;AAC7D,QAAO,QACJ,MAAM,IAAI,CACV,KAAK,YAAY;AAChB,MAAI,QAAQ,WAAW,IAAI,CAGzB,QAAO,QAAQ,SAAS,IAAI,IAAI,QAAQ,SAAS,IAAI,GAAG,OAAO;AAEjE,SAAO;GACP,CACD,KAAK,IAAI;;AAGd,SAAgB,qBACd,oBACA,qBAIA;CACA,MAAM,aAAa,EAAE,GAAG,oBAAoB;CAC5C,MAAM,gBAA0B,EAAE;AAElC,MAAK,MAAM,CAAC,OAAO,kBAAkB,OAAO,QAAQ,oBAAoB,EAAE;EACxE,MAAM,eAAe,WAAW;AAEhC,MAAI,gBAAgB,wBAAwB,aAAa,EAAE;AACzD,iBAAc,KAAK,MAAM;AACzB;;AAGF,aAAW,SAAS;GAClB,GAAG;GACH,GAAG;GACJ;;AAGH,QAAO;EAAE;EAAY;EAAe;;AAGtC,SAAS,wBAAwB,MAAqC;AACpE,QACE,KAAK,QAAQ,KAAA,KACb,KAAK,UAAU,KAAA,KACf,KAAK,WAAW,KAAA,KAChB,KAAK,QAAQ,KAAA,KACb,KAAK,cAAc,KAAA"}
+{"version":3,"file":"nitro-route-rules.js","names":[],"sources":["../../src/build/nitro-route-rules.ts"],"sourcesContent":["import { appRouter, type AppRoute } from \"../routing/app-router.js\";\nimport { apiRouter, pagesRouter, type Route } from \"../routing/pages-router.js\";\nimport { buildReportRows, type RouteRow } from \"./report.js\";\n\n// Mirrors Nitro's NitroRouteConfig — hand-rolled because nitropack is not a direct dependency.\nexport type NitroRouteRuleConfig = Record<string, unknown> & {\n  swr?: boolean | number;\n  cache?: unknown;\n  static?: boolean;\n  isr?: boolean | number;\n  prerender?: boolean;\n};\n\ntype NitroRouteRules = Record<string, { swr: number }>;\n\n/**\n * Scans the filesystem for route files and generates Nitro `routeRules` for ISR routes.\n *\n * Note: this duplicates the filesystem scanning that `printBuildReport` also performs.\n * The `nitro.setup` hook runs during Nitro initialization (before the build), while\n * `printBuildReport` runs after the build, so sharing results is non-trivial. This is\n * a future optimization target.\n *\n * Unlike `printBuildReport`, this path does not receive `prerenderResult`, so routes\n * classified as `unknown` by static analysis (which `printBuildReport` might upgrade\n * to `static` via speculative prerender) are skipped here.\n */\nexport async function collectNitroRouteRules(options: {\n  appDir?: string | null;\n  pagesDir?: string | null;\n  pageExtensions: string[];\n}): Promise<NitroRouteRules> {\n  const { appDir, pageExtensions, pagesDir } = options;\n\n  let appRoutes: AppRoute[] = [];\n  let pageRoutes: Route[] = [];\n  let apiRoutes: Route[] = [];\n\n  if (appDir) {\n    appRoutes = await appRouter(appDir, pageExtensions);\n  }\n\n  if (pagesDir) {\n    const [pages, apis] = await Promise.all([\n      pagesRouter(pagesDir, pageExtensions),\n      apiRouter(pagesDir, pageExtensions),\n    ]);\n    pageRoutes = pages;\n    apiRoutes = apis;\n  }\n\n  return generateNitroRouteRules(buildReportRows({ appRoutes, pageRoutes, apiRoutes }));\n}\n\nexport function generateNitroRouteRules(rows: RouteRow[]): NitroRouteRules {\n  const rules: NitroRouteRules = {};\n\n  for (const row of rows) {\n    if (\n      row.type === \"isr\" &&\n      typeof row.revalidate === \"number\" &&\n      Number.isFinite(row.revalidate) &&\n      row.revalidate > 0\n    ) {\n      rules[convertToNitroPattern(row.pattern)] = { swr: row.revalidate };\n    }\n  }\n\n  return rules;\n}\n\n/**\n * Converts vinext's internal `:param` route syntax to Nitro's rou3\n * pattern format. Nitro uses `rou3` for routeRules matching, which\n * supports `*` (single-segment) and `**` (multi-segment) wildcards.\n *\n *   /blog/:slug   -> /blog/*   (single segment)\n *   /docs/:slug+  -> /docs/**  (one or more segments — catch-all)\n *   /docs/:slug*  -> /docs/**  (zero or more segments — optional catch-all)\n *   /about        -> /about    (unchanged)\n *   /:a/:b produces `/*`/`/*` (consecutive single-segment params)\n */\nexport function convertToNitroPattern(pattern: string): string {\n  return pattern\n    .split(\"/\")\n    .map((segment) => {\n      if (segment.startsWith(\":\")) {\n        // Catch-all (:param+) and optional catch-all (:param*) match multiple segments → **\n        // Single dynamic param (:param) matches one segment → *\n        return segment.endsWith(\"+\") || segment.endsWith(\"*\") ? \"**\" : \"*\";\n      }\n      return segment;\n    })\n    .join(\"/\");\n}\n\nexport function mergeNitroRouteRules(\n  existingRouteRules: Record<string, NitroRouteRuleConfig> | undefined,\n  generatedRouteRules: NitroRouteRules,\n): {\n  routeRules: Record<string, NitroRouteRuleConfig>;\n  skippedRoutes: string[];\n} {\n  const routeRules = { ...existingRouteRules };\n  const skippedRoutes: string[] = [];\n\n  for (const [route, generatedRule] of Object.entries(generatedRouteRules)) {\n    const existingRule = routeRules[route];\n\n    if (existingRule && hasUserDefinedCacheRule(existingRule)) {\n      skippedRoutes.push(route);\n      continue;\n    }\n\n    routeRules[route] = {\n      ...existingRule,\n      ...generatedRule,\n    };\n  }\n\n  return { routeRules, skippedRoutes };\n}\n\nfunction hasUserDefinedCacheRule(rule: NitroRouteRuleConfig): boolean {\n  return (\n    rule.swr !== undefined ||\n    rule.cache !== undefined ||\n    rule.static !== undefined ||\n    rule.isr !== undefined ||\n    rule.prerender !== undefined\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;AA2BA,eAAsB,uBAAuB,SAIhB;CAC3B,MAAM,EAAE,QAAQ,gBAAgB,aAAa;CAE7C,IAAI,YAAwB,EAAE;CAC9B,IAAI,aAAsB,EAAE;CAC5B,IAAI,YAAqB,EAAE;CAE3B,IAAI,QACF,YAAY,MAAM,UAAU,QAAQ,eAAe;CAGrD,IAAI,UAAU;EACZ,MAAM,CAAC,OAAO,QAAQ,MAAM,QAAQ,IAAI,CACtC,YAAY,UAAU,eAAe,EACrC,UAAU,UAAU,eAAe,CACpC,CAAC;EACF,aAAa;EACb,YAAY;;CAGd,OAAO,wBAAwB,gBAAgB;EAAE;EAAW;EAAY;EAAW,CAAC,CAAC;;AAGvF,SAAgB,wBAAwB,MAAmC;CACzE,MAAM,QAAyB,EAAE;CAEjC,KAAK,MAAM,OAAO,MAChB,IACE,IAAI,SAAS,SACb,OAAO,IAAI,eAAe,YAC1B,OAAO,SAAS,IAAI,WAAW,IAC/B,IAAI,aAAa,GAEjB,MAAM,sBAAsB,IAAI,QAAQ,IAAI,EAAE,KAAK,IAAI,YAAY;CAIvE,OAAO;;;;;;;;;;;;;AAcT,SAAgB,sBAAsB,SAAyB;CAC7D,OAAO,QACJ,MAAM,IAAI,CACV,KAAK,YAAY;EAChB,IAAI,QAAQ,WAAW,IAAI,EAGzB,OAAO,QAAQ,SAAS,IAAI,IAAI,QAAQ,SAAS,IAAI,GAAG,OAAO;EAEjE,OAAO;GACP,CACD,KAAK,IAAI;;AAGd,SAAgB,qBACd,oBACA,qBAIA;CACA,MAAM,aAAa,EAAE,GAAG,oBAAoB;CAC5C,MAAM,gBAA0B,EAAE;CAElC,KAAK,MAAM,CAAC,OAAO,kBAAkB,OAAO,QAAQ,oBAAoB,EAAE;EACxE,MAAM,eAAe,WAAW;EAEhC,IAAI,gBAAgB,wBAAwB,aAAa,EAAE;GACzD,cAAc,KAAK,MAAM;GACzB;;EAGF,WAAW,SAAS;GAClB,GAAG;GACH,GAAG;GACJ;;CAGH,OAAO;EAAE;EAAY;EAAe;;AAGtC,SAAS,wBAAwB,MAAqC;CACpE,OACE,KAAK,QAAQ,KAAA,KACb,KAAK,UAAU,KAAA,KACf,KAAK,WAAW,KAAA,KAChB,KAAK,QAAQ,KAAA,KACb,KAAK,cAAc,KAAA"}

package/dist/build/precompress.d.ts

@@ -5,13 +5,24 @@ type PrecompressResult = {
   totalBrotliBytes: number;
 };
 /**
- * Precompress all compressible hashed assets under `clientDir/assets/`.
+ * Precompress all compressible hashed assets under `clientDir/<assetsDir>/`.
  *
  * Writes `.br`, `.gz`, and `.zst` files alongside each original.
  * Safe to re-run — overwrites existing compressed variants with identical
  * output, and never compresses `.br`, `.gz`, or `.zst` files themselves.
+ *
+ * `assetsDir` defaults to `"assets"` (Vite's historical default). When
+ * `assetPrefix` is configured the build writes assets to a different
+ * directory (e.g. `"cdn/_next/static"` for a path prefix, or `"_next/static"`
+ * for an absolute URL prefix); callers should resolve that with
+ * `resolveAssetsDir(assetPrefix)` and thread it through. Without this,
+ * `assetPrefix` builds would walk an empty `assets/` directory and emit
+ * zero compressed variants.
  */
-declare function precompressAssets(clientDir: string, onProgress?: (completed: number, total: number, file: string) => void): Promise<PrecompressResult>;
+declare function precompressAssets(clientDir: string, options?: {
+  /** Subdirectory under `clientDir` containing hashed assets. Defaults to `"assets"`. */assetsDir?: string;
+  onProgress?: (completed: number, total: number, file: string) => void;
+}): Promise<PrecompressResult>;
 //#endregion
 export { precompressAssets };
 //# sourceMappingURL=precompress.d.ts.map

package/dist/build/precompress.js

@@ -56,14 +56,23 @@ async function* walkFiles(dir, base = dir) {
 	}
 }
 /**
-* Precompress all compressible hashed assets under `clientDir/assets/`.
+* Precompress all compressible hashed assets under `clientDir/<assetsDir>/`.
 *
 * Writes `.br`, `.gz`, and `.zst` files alongside each original.
 * Safe to re-run — overwrites existing compressed variants with identical
 * output, and never compresses `.br`, `.gz`, or `.zst` files themselves.
+*
+* `assetsDir` defaults to `"assets"` (Vite's historical default). When
+* `assetPrefix` is configured the build writes assets to a different
+* directory (e.g. `"cdn/_next/static"` for a path prefix, or `"_next/static"`
+* for an absolute URL prefix); callers should resolve that with
+* `resolveAssetsDir(assetPrefix)` and thread it through. Without this,
+* `assetPrefix` builds would walk an empty `assets/` directory and emit
+* zero compressed variants.
 */
-async function precompressAssets(clientDir, onProgress) {
-	const assetsDir = path.join(clientDir, "assets");
+async function precompressAssets(clientDir, options = {}) {
+	const { assetsDir: assetsSubdir = "assets", onProgress } = options;
+	const assetsDir = path.join(clientDir, assetsSubdir);
 	const result = {
 		filesCompressed: 0,
 		totalOriginalBytes: 0,

package/dist/build/precompress.js.map

@@ -1 +1 @@
-{"version":3,"file":"precompress.js","names":[],"sources":["../../src/build/precompress.ts"],"sourcesContent":["/**\n * Build-time precompression for hashed static assets.\n *\n * Generates .br (brotli q5), .gz (gzip l8), and .zst (zstd l8) files\n * alongside compressible assets in dist/client/assets/. Served directly by\n * the production server — no per-request compression needed for immutable\n * build output.\n *\n * Only targets assets/ (hashed, immutable) — public directory files use\n * on-the-fly compression since they may change between deploys.\n */\nimport fsp from \"node:fs/promises\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport zlib from \"node:zlib\";\nimport { promisify } from \"node:util\";\n\nconst brotliCompress = promisify(zlib.brotliCompress);\nconst gzip = promisify(zlib.gzip);\nconst zstdCompress = typeof zlib.zstdCompress === \"function\" ? promisify(zlib.zstdCompress) : null;\n\n/** File extensions worth compressing (text-based, not already compressed). */\nconst COMPRESSIBLE_EXTENSIONS = new Set([\n  \".js\",\n  \".mjs\",\n  \".css\",\n  \".html\",\n  \".json\",\n  \".xml\",\n  \".svg\",\n  \".txt\",\n  \".map\",\n  \".wasm\",\n]);\n\n/** Below this size, compression overhead exceeds savings. */\nconst MIN_SIZE = 1024;\n\n/**\n * Past ~8 parallel files, mixed-size asset sets spend more time queueing zlib\n * work than making forward progress. Keep the batch size bounded even on\n * higher-core machines.\n */\nconst CONCURRENCY = Math.min(os.availableParallelism(), 8);\n\ntype PrecompressResult = {\n  filesCompressed: number;\n  totalOriginalBytes: number;\n  /** Sum of brotli-compressed sizes (used for compression ratio reporting). */\n  totalBrotliBytes: number;\n};\n\n/**\n * Walk a directory recursively, yielding relative paths for regular files.\n */\nasync function* walkFiles(dir: string, base: string = dir): AsyncGenerator<string> {\n  let entries;\n  try {\n    entries = await fsp.readdir(dir, { withFileTypes: true });\n  } catch {\n    return; // directory doesn't exist\n  }\n  for (const entry of entries) {\n    const fullPath = path.join(dir, entry.name);\n    if (entry.isDirectory()) {\n      yield* walkFiles(fullPath, base);\n    } else if (entry.isFile()) {\n      yield path.relative(base, fullPath);\n    }\n  }\n}\n\n/**\n * Precompress all compressible hashed assets under `clientDir/assets/`.\n *\n * Writes `.br`, `.gz`, and `.zst` files alongside each original.\n * Safe to re-run — overwrites existing compressed variants with identical\n * output, and never compresses `.br`, `.gz`, or `.zst` files themselves.\n */\nexport async function precompressAssets(\n  clientDir: string,\n  onProgress?: (completed: number, total: number, file: string) => void,\n): Promise<PrecompressResult> {\n  const assetsDir = path.join(clientDir, \"assets\");\n  const result: PrecompressResult = {\n    filesCompressed: 0,\n    totalOriginalBytes: 0,\n    totalBrotliBytes: 0,\n  };\n\n  // Collect compressible file paths, then read + compress in bounded chunks\n  // to keep peak memory at O(CONCURRENCY * max_file_size) instead of\n  // O(total_assets).\n  const filePaths: string[] = [];\n\n  for await (const relativePath of walkFiles(assetsDir)) {\n    const ext = path.extname(relativePath).toLowerCase();\n\n    if (!COMPRESSIBLE_EXTENSIONS.has(ext)) continue;\n    // .br/.gz/.zst are intentionally absent from COMPRESSIBLE_EXTENSIONS, so\n    // precompressed variants generated by a previous run are never re-compressed.\n\n    filePaths.push(path.join(assetsDir, relativePath));\n  }\n\n  let processed = 0;\n  for (let i = 0; i < filePaths.length; i += CONCURRENCY) {\n    const chunk = filePaths.slice(i, i + CONCURRENCY);\n    await Promise.all(\n      chunk.map(async (fullPath) => {\n        const content = await fsp.readFile(fullPath);\n        // readFile already done before this check — stat()-first would save\n        // the read for tiny files but costs an extra syscall per file;\n        // sub-1KB hashed assets are rare enough that read-first is cheaper.\n        if (content.length < MIN_SIZE) return;\n\n        // Compress all variants concurrently within each file\n        const compressions: Promise<Buffer>[] = [\n          brotliCompress(content, {\n            params: { [zlib.constants.BROTLI_PARAM_QUALITY]: 5 },\n          }),\n          gzip(content, { level: 8 }),\n        ];\n        if (zstdCompress) {\n          compressions.push(\n            zstdCompress(content, {\n              params: { [zlib.constants.ZSTD_c_compressionLevel]: 8 },\n            }),\n          );\n        }\n\n        const results = await Promise.all(compressions);\n        const [brContent, gzContent, zstdContent] = results;\n\n        const writes = [\n          fsp.writeFile(fullPath + \".br\", brContent),\n          fsp.writeFile(fullPath + \".gz\", gzContent),\n        ];\n        if (zstdContent) {\n          writes.push(fsp.writeFile(fullPath + \".zst\", zstdContent));\n        }\n        await Promise.all(writes);\n\n        // Increment counters only after all writes succeed, so partial\n        // failures (e.g. ENOSPC mid-write) don't inflate the reported totals.\n        result.filesCompressed++;\n        result.totalOriginalBytes += content.length;\n        result.totalBrotliBytes += brContent.length;\n      }),\n    );\n    // Report progress once per chunk to avoid non-deterministic ordering\n    // within Promise.all (smaller files complete before larger ones).\n    // Progress tracks all files (including skipped ones below MIN_SIZE),\n    // which differs from filesCompressed (only files actually compressed).\n    processed += chunk.length;\n    onProgress?.(processed, filePaths.length, path.basename(chunk[chunk.length - 1]));\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,MAAM,iBAAiB,UAAU,KAAK,eAAe;AACrD,MAAM,OAAO,UAAU,KAAK,KAAK;AACjC,MAAM,eAAe,OAAO,KAAK,iBAAiB,aAAa,UAAU,KAAK,aAAa,GAAG;;AAG9F,MAAM,0BAA0B,IAAI,IAAI;CACtC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;AAGF,MAAM,WAAW;;;;;;AAOjB,MAAM,cAAc,KAAK,IAAI,GAAG,sBAAsB,EAAE,EAAE;;;;AAY1D,gBAAgB,UAAU,KAAa,OAAe,KAA6B;CACjF,IAAI;AACJ,KAAI;AACF,YAAU,MAAM,IAAI,QAAQ,KAAK,EAAE,eAAe,MAAM,CAAC;SACnD;AACN;;AAEF,MAAK,MAAM,SAAS,SAAS;EAC3B,MAAM,WAAW,KAAK,KAAK,KAAK,MAAM,KAAK;AAC3C,MAAI,MAAM,aAAa,CACrB,QAAO,UAAU,UAAU,KAAK;WACvB,MAAM,QAAQ,CACvB,OAAM,KAAK,SAAS,MAAM,SAAS;;;;;;;;;;AAYzC,eAAsB,kBACpB,WACA,YAC4B;CAC5B,MAAM,YAAY,KAAK,KAAK,WAAW,SAAS;CAChD,MAAM,SAA4B;EAChC,iBAAiB;EACjB,oBAAoB;EACpB,kBAAkB;EACnB;CAKD,MAAM,YAAsB,EAAE;AAE9B,YAAW,MAAM,gBAAgB,UAAU,UAAU,EAAE;EACrD,MAAM,MAAM,KAAK,QAAQ,aAAa,CAAC,aAAa;AAEpD,MAAI,CAAC,wBAAwB,IAAI,IAAI,CAAE;AAIvC,YAAU,KAAK,KAAK,KAAK,WAAW,aAAa,CAAC;;CAGpD,IAAI,YAAY;AAChB,MAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK,aAAa;EACtD,MAAM,QAAQ,UAAU,MAAM,GAAG,IAAI,YAAY;AACjD,QAAM,QAAQ,IACZ,MAAM,IAAI,OAAO,aAAa;GAC5B,MAAM,UAAU,MAAM,IAAI,SAAS,SAAS;AAI5C,OAAI,QAAQ,SAAS,SAAU;GAG/B,MAAM,eAAkC,CACtC,eAAe,SAAS,EACtB,QAAQ,GAAG,KAAK,UAAU,uBAAuB,GAAG,EACrD,CAAC,EACF,KAAK,SAAS,EAAE,OAAO,GAAG,CAAC,CAC5B;AACD,OAAI,aACF,cAAa,KACX,aAAa,SAAS,EACpB,QAAQ,GAAG,KAAK,UAAU,0BAA0B,GAAG,EACxD,CAAC,CACH;GAIH,MAAM,CAAC,WAAW,WAAW,eADb,MAAM,QAAQ,IAAI,aAAa;GAG/C,MAAM,SAAS,CACb,IAAI,UAAU,WAAW,OAAO,UAAU,EAC1C,IAAI,UAAU,WAAW,OAAO,UAAU,CAC3C;AACD,OAAI,YACF,QAAO,KAAK,IAAI,UAAU,WAAW,QAAQ,YAAY,CAAC;AAE5D,SAAM,QAAQ,IAAI,OAAO;AAIzB,UAAO;AACP,UAAO,sBAAsB,QAAQ;AACrC,UAAO,oBAAoB,UAAU;IACrC,CACH;AAKD,eAAa,MAAM;AACnB,eAAa,WAAW,UAAU,QAAQ,KAAK,SAAS,MAAM,MAAM,SAAS,GAAG,CAAC;;AAGnF,QAAO"}
+{"version":3,"file":"precompress.js","names":[],"sources":["../../src/build/precompress.ts"],"sourcesContent":["/**\n * Build-time precompression for hashed static assets.\n *\n * Generates .br (brotli q5), .gz (gzip l8), and .zst (zstd l8) files\n * alongside compressible assets in dist/client/assets/. Served directly by\n * the production server — no per-request compression needed for immutable\n * build output.\n *\n * Only targets assets/ (hashed, immutable) — public directory files use\n * on-the-fly compression since they may change between deploys.\n */\nimport fsp from \"node:fs/promises\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport zlib from \"node:zlib\";\nimport { promisify } from \"node:util\";\n\nconst brotliCompress = promisify(zlib.brotliCompress);\nconst gzip = promisify(zlib.gzip);\nconst zstdCompress = typeof zlib.zstdCompress === \"function\" ? promisify(zlib.zstdCompress) : null;\n\n/** File extensions worth compressing (text-based, not already compressed). */\nconst COMPRESSIBLE_EXTENSIONS = new Set([\n  \".js\",\n  \".mjs\",\n  \".css\",\n  \".html\",\n  \".json\",\n  \".xml\",\n  \".svg\",\n  \".txt\",\n  \".map\",\n  \".wasm\",\n]);\n\n/** Below this size, compression overhead exceeds savings. */\nconst MIN_SIZE = 1024;\n\n/**\n * Past ~8 parallel files, mixed-size asset sets spend more time queueing zlib\n * work than making forward progress. Keep the batch size bounded even on\n * higher-core machines.\n */\nconst CONCURRENCY = Math.min(os.availableParallelism(), 8);\n\ntype PrecompressResult = {\n  filesCompressed: number;\n  totalOriginalBytes: number;\n  /** Sum of brotli-compressed sizes (used for compression ratio reporting). */\n  totalBrotliBytes: number;\n};\n\n/**\n * Walk a directory recursively, yielding relative paths for regular files.\n */\nasync function* walkFiles(dir: string, base: string = dir): AsyncGenerator<string> {\n  let entries;\n  try {\n    entries = await fsp.readdir(dir, { withFileTypes: true });\n  } catch {\n    return; // directory doesn't exist\n  }\n  for (const entry of entries) {\n    const fullPath = path.join(dir, entry.name);\n    if (entry.isDirectory()) {\n      yield* walkFiles(fullPath, base);\n    } else if (entry.isFile()) {\n      yield path.relative(base, fullPath);\n    }\n  }\n}\n\n/**\n * Precompress all compressible hashed assets under `clientDir/<assetsDir>/`.\n *\n * Writes `.br`, `.gz`, and `.zst` files alongside each original.\n * Safe to re-run — overwrites existing compressed variants with identical\n * output, and never compresses `.br`, `.gz`, or `.zst` files themselves.\n *\n * `assetsDir` defaults to `\"assets\"` (Vite's historical default). When\n * `assetPrefix` is configured the build writes assets to a different\n * directory (e.g. `\"cdn/_next/static\"` for a path prefix, or `\"_next/static\"`\n * for an absolute URL prefix); callers should resolve that with\n * `resolveAssetsDir(assetPrefix)` and thread it through. Without this,\n * `assetPrefix` builds would walk an empty `assets/` directory and emit\n * zero compressed variants.\n */\nexport async function precompressAssets(\n  clientDir: string,\n  options: {\n    /** Subdirectory under `clientDir` containing hashed assets. Defaults to `\"assets\"`. */\n    assetsDir?: string;\n    onProgress?: (completed: number, total: number, file: string) => void;\n  } = {},\n): Promise<PrecompressResult> {\n  const { assetsDir: assetsSubdir = \"assets\", onProgress } = options;\n  const assetsDir = path.join(clientDir, assetsSubdir);\n  const result: PrecompressResult = {\n    filesCompressed: 0,\n    totalOriginalBytes: 0,\n    totalBrotliBytes: 0,\n  };\n\n  // Collect compressible file paths, then read + compress in bounded chunks\n  // to keep peak memory at O(CONCURRENCY * max_file_size) instead of\n  // O(total_assets).\n  const filePaths: string[] = [];\n\n  for await (const relativePath of walkFiles(assetsDir)) {\n    const ext = path.extname(relativePath).toLowerCase();\n\n    if (!COMPRESSIBLE_EXTENSIONS.has(ext)) continue;\n    // .br/.gz/.zst are intentionally absent from COMPRESSIBLE_EXTENSIONS, so\n    // precompressed variants generated by a previous run are never re-compressed.\n\n    filePaths.push(path.join(assetsDir, relativePath));\n  }\n\n  let processed = 0;\n  for (let i = 0; i < filePaths.length; i += CONCURRENCY) {\n    const chunk = filePaths.slice(i, i + CONCURRENCY);\n    await Promise.all(\n      chunk.map(async (fullPath) => {\n        const content = await fsp.readFile(fullPath);\n        // readFile already done before this check — stat()-first would save\n        // the read for tiny files but costs an extra syscall per file;\n        // sub-1KB hashed assets are rare enough that read-first is cheaper.\n        if (content.length < MIN_SIZE) return;\n\n        // Compress all variants concurrently within each file\n        const compressions: Promise<Buffer>[] = [\n          brotliCompress(content, {\n            params: { [zlib.constants.BROTLI_PARAM_QUALITY]: 5 },\n          }),\n          gzip(content, { level: 8 }),\n        ];\n        if (zstdCompress) {\n          compressions.push(\n            zstdCompress(content, {\n              params: { [zlib.constants.ZSTD_c_compressionLevel]: 8 },\n            }),\n          );\n        }\n\n        const results = await Promise.all(compressions);\n        const [brContent, gzContent, zstdContent] = results;\n\n        const writes = [\n          fsp.writeFile(fullPath + \".br\", brContent),\n          fsp.writeFile(fullPath + \".gz\", gzContent),\n        ];\n        if (zstdContent) {\n          writes.push(fsp.writeFile(fullPath + \".zst\", zstdContent));\n        }\n        await Promise.all(writes);\n\n        // Increment counters only after all writes succeed, so partial\n        // failures (e.g. ENOSPC mid-write) don't inflate the reported totals.\n        result.filesCompressed++;\n        result.totalOriginalBytes += content.length;\n        result.totalBrotliBytes += brContent.length;\n      }),\n    );\n    // Report progress once per chunk to avoid non-deterministic ordering\n    // within Promise.all (smaller files complete before larger ones).\n    // Progress tracks all files (including skipped ones below MIN_SIZE),\n    // which differs from filesCompressed (only files actually compressed).\n    processed += chunk.length;\n    onProgress?.(processed, filePaths.length, path.basename(chunk[chunk.length - 1]));\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,MAAM,iBAAiB,UAAU,KAAK,eAAe;AACrD,MAAM,OAAO,UAAU,KAAK,KAAK;AACjC,MAAM,eAAe,OAAO,KAAK,iBAAiB,aAAa,UAAU,KAAK,aAAa,GAAG;;AAG9F,MAAM,0BAA0B,IAAI,IAAI;CACtC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;AAGF,MAAM,WAAW;;;;;;AAOjB,MAAM,cAAc,KAAK,IAAI,GAAG,sBAAsB,EAAE,EAAE;;;;AAY1D,gBAAgB,UAAU,KAAa,OAAe,KAA6B;CACjF,IAAI;CACJ,IAAI;EACF,UAAU,MAAM,IAAI,QAAQ,KAAK,EAAE,eAAe,MAAM,CAAC;SACnD;EACN;;CAEF,KAAK,MAAM,SAAS,SAAS;EAC3B,MAAM,WAAW,KAAK,KAAK,KAAK,MAAM,KAAK;EAC3C,IAAI,MAAM,aAAa,EACrB,OAAO,UAAU,UAAU,KAAK;OAC3B,IAAI,MAAM,QAAQ,EACvB,MAAM,KAAK,SAAS,MAAM,SAAS;;;;;;;;;;;;;;;;;;AAoBzC,eAAsB,kBACpB,WACA,UAII,EAAE,EACsB;CAC5B,MAAM,EAAE,WAAW,eAAe,UAAU,eAAe;CAC3D,MAAM,YAAY,KAAK,KAAK,WAAW,aAAa;CACpD,MAAM,SAA4B;EAChC,iBAAiB;EACjB,oBAAoB;EACpB,kBAAkB;EACnB;CAKD,MAAM,YAAsB,EAAE;CAE9B,WAAW,MAAM,gBAAgB,UAAU,UAAU,EAAE;EACrD,MAAM,MAAM,KAAK,QAAQ,aAAa,CAAC,aAAa;EAEpD,IAAI,CAAC,wBAAwB,IAAI,IAAI,EAAE;EAIvC,UAAU,KAAK,KAAK,KAAK,WAAW,aAAa,CAAC;;CAGpD,IAAI,YAAY;CAChB,KAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK,aAAa;EACtD,MAAM,QAAQ,UAAU,MAAM,GAAG,IAAI,YAAY;EACjD,MAAM,QAAQ,IACZ,MAAM,IAAI,OAAO,aAAa;GAC5B,MAAM,UAAU,MAAM,IAAI,SAAS,SAAS;GAI5C,IAAI,QAAQ,SAAS,UAAU;GAG/B,MAAM,eAAkC,CACtC,eAAe,SAAS,EACtB,QAAQ,GAAG,KAAK,UAAU,uBAAuB,GAAG,EACrD,CAAC,EACF,KAAK,SAAS,EAAE,OAAO,GAAG,CAAC,CAC5B;GACD,IAAI,cACF,aAAa,KACX,aAAa,SAAS,EACpB,QAAQ,GAAG,KAAK,UAAU,0BAA0B,GAAG,EACxD,CAAC,CACH;GAIH,MAAM,CAAC,WAAW,WAAW,eAAe,MADtB,QAAQ,IAAI,aAAa;GAG/C,MAAM,SAAS,CACb,IAAI,UAAU,WAAW,OAAO,UAAU,EAC1C,IAAI,UAAU,WAAW,OAAO,UAAU,CAC3C;GACD,IAAI,aACF,OAAO,KAAK,IAAI,UAAU,WAAW,QAAQ,YAAY,CAAC;GAE5D,MAAM,QAAQ,IAAI,OAAO;GAIzB,OAAO;GACP,OAAO,sBAAsB,QAAQ;GACrC,OAAO,oBAAoB,UAAU;IACrC,CACH;EAKD,aAAa,MAAM;EACnB,aAAa,WAAW,UAAU,QAAQ,KAAK,SAAS,MAAM,MAAM,SAAS,GAAG,CAAC;;CAGnF,OAAO"}

package/dist/build/prerender.d.ts

@@ -107,6 +107,22 @@ type PrerenderAppOptionsInternal = PrerenderAppOptions & {
     port: number;
   };
 };
+/**
+ * Reconstruct the RSC payload from a prerender HTML response by parsing the
+ * inline bootstrap chunk scripts emitted by createRscEmbedTransform.
+ *
+ * Returns null when the HTML contains no chunk scripts at all — the caller
+ * should fall back to a second handler invocation. This is reachable when
+ * middleware short-circuits the App Router pipeline with a custom 200 HTML
+ * response that never went through createRscEmbedTransform.
+ *
+ * Throws on partial or malformed embeds (chunks present but no done marker,
+ * tampered chunk JSON, etc.) — those are real vinext-internal regressions.
+ *
+ * Safe regex usage: safeJsonStringify (used by createRscEmbedTransform) escapes
+ * all '<' and '>' in the embedded JSON, preventing false </script> matches.
+ */
+declare function extractRscPayloadFromPrerenderedHtml(html: string): Uint8Array | null;
 /**
  * Determine the HTML output file path for a URL.
  * Respects trailingSlash config.
@@ -189,5 +205,5 @@ declare function writePrerenderIndex(routes: PrerenderRouteResult[], outDir: str
   trailingSlash?: boolean;
 }): void;
 //#endregion
-export { PrerenderResult, PrerenderRouteResult, StaticParamsMap, getOutputPath, getRscOutputPath, prerenderApp, prerenderPages, readPrerenderSecret, resolveParentParams, writePrerenderIndex };
+export { PrerenderResult, PrerenderRouteResult, StaticParamsMap, extractRscPayloadFromPrerenderedHtml, getOutputPath, getRscOutputPath, prerenderApp, prerenderPages, readPrerenderSecret, resolveParentParams, writePrerenderIndex };
 //# sourceMappingURL=prerender.d.ts.map

package/dist/build/prerender.js

@@ -1,7 +1,10 @@
 import { createValidFileMatcher, findFileWithExtensions } from "../routing/file-matcher.js";
+import { VINEXT_PRERENDER_SECRET_HEADER } from "../server/headers.js";
+import { normalizeStaticPathsEntry } from "../routing/route-pattern.js";
 import { headersContextFromRequest, runWithHeadersContext } from "../shims/headers.js";
 import { NoOpCacheHandler, _consumeRequestScopedCacheLife, getCacheHandler, setCacheHandler } from "../shims/cache.js";
 import { classifyAppRoute, classifyPagesRoute, getAppRouteRenderEntryPath } from "./report.js";
+import { concatUint8Arrays, decodeRscEmbeddedChunk } from "../server/app-rsc-embedded-chunks.js";
 import { readPrerenderSecret } from "./server-manifest.js";
 import { startProdServer } from "../server/prod-server.js";
 import fs from "node:fs";
@@ -31,6 +34,62 @@ function getErrorMessageWithStack(err) {
 /** Sentinel path used to trigger 404 rendering without a real route match. */
 const NOT_FOUND_SENTINEL_PATH = "/__vinext_nonexistent_for_404__";
 const DEFAULT_CONCURRENCY = Math.min(os.availableParallelism(), 8);
+const RSC_CHUNK_SCRIPT_PREFIX = "self.__VINEXT_RSC_CHUNKS__=self.__VINEXT_RSC_CHUNKS__||[];";
+const RSC_DONE_MARKER = "__VINEXT_RSC_DONE__=true";
+const RSC_CHUNK_FULL_PREFIX = `${RSC_CHUNK_SCRIPT_PREFIX}self.__VINEXT_RSC_CHUNKS__.push(`;
+/**
+* Reconstruct the RSC payload from a prerender HTML response by parsing the
+* inline bootstrap chunk scripts emitted by createRscEmbedTransform.
+*
+* Returns null when the HTML contains no chunk scripts at all — the caller
+* should fall back to a second handler invocation. This is reachable when
+* middleware short-circuits the App Router pipeline with a custom 200 HTML
+* response that never went through createRscEmbedTransform.
+*
+* Throws on partial or malformed embeds (chunks present but no done marker,
+* tampered chunk JSON, etc.) — those are real vinext-internal regressions.
+*
+* Safe regex usage: safeJsonStringify (used by createRscEmbedTransform) escapes
+* all '<' and '>' in the embedded JSON, preventing false <\/script> matches.
+*/
+function extractRscPayloadFromPrerenderedHtml(html) {
+	const scriptPattern = /<script(?:\s[^>]*)?>([\s\S]*?)<\/script>/gi;
+	const chunks = [];
+	let sawDone = false;
+	let match;
+	while ((match = scriptPattern.exec(html)) !== null) {
+		const script = (match[1] ?? "").trim().replace(/;$/, "");
+		if (script === `self.${RSC_DONE_MARKER}`) {
+			sawDone = true;
+			continue;
+		}
+		if (script.startsWith(RSC_CHUNK_SCRIPT_PREFIX)) chunks.push(decodeRscEmbeddedChunk(parseRscChunkPushArgument(script)));
+	}
+	if (chunks.length === 0 && !sawDone) return null;
+	if (chunks.length === 0) throw new Error("[vinext] Malformed prerender RSC embed: done marker present without chunk scripts");
+	if (!sawDone) throw new Error("[vinext] Malformed prerender RSC embed: missing __VINEXT_RSC_DONE__ marker");
+	return concatUint8Arrays(chunks);
+}
+/**
+* Parse the JSON argument of a single chunk-push script. The script
+* shape is exactly `<prefix>(<safeJsonStringify(chunk)>)` because the writer
+* concatenates those literals — so the body always starts with the full
+* prefix and ends with `)`. JSON.parse on the slice catches any tampering or
+* trailing code.
+*/
+function parseRscChunkPushArgument(script) {
+	if (!script.startsWith(RSC_CHUNK_FULL_PREFIX) || !script.endsWith(")")) throw new Error("[vinext] Malformed prerender RSC embed: unexpected chunk script shape");
+	const jsonSource = script.slice(RSC_CHUNK_FULL_PREFIX.length, -1);
+	let parsed;
+	try {
+		parsed = JSON.parse(jsonSource);
+	} catch {
+		throw new Error("[vinext] Malformed prerender RSC embed: invalid chunk JSON");
+	}
+	if (typeof parsed === "string") return parsed;
+	if (Array.isArray(parsed) && parsed.length === 2 && parsed[0] === 3 && typeof parsed[1] === "string") return [parsed[0], parsed[1]];
+	throw new Error("[vinext] Malformed prerender RSC embed: unsupported chunk payload");
+}
 /**
 * Run an array of async tasks with bounded concurrency.
 * Results are returned in the same order as `items`.
@@ -53,8 +112,14 @@ async function runWithConcurrency(items, concurrency, fn) {
 * Build a URL path from a route pattern and params.
 * "/posts/:id" + { id: "42" } → "/posts/42"
 * "/docs/:slug+" + { slug: ["a", "b"] } → "/docs/a/b"
+*
+* Throws a descriptive error rather than a cryptic `Cannot read properties of
+* undefined` if `params` itself is missing or required keys are absent — the
+* caller (prerenderPages / prerenderApp) catches this and surfaces it as a
+* per-route error result.
 */
 function buildUrlFromParams(pattern, params) {
+	if (params === void 0 || params === null) throw new Error(`[vinext] buildUrlFromParams: params is ${params === null ? "null" : "undefined"} for pattern "${pattern}". Check that getStaticPaths / generateStaticParams returned an object with a "params" key, or pass a string path (see https://nextjs.org/docs/pages/api-reference/functions/get-static-paths).`);
 	const parts = pattern.split("/").filter(Boolean);
 	const result = [];
 	for (const part of parts) if (part.endsWith("+") || part.endsWith("*")) {
@@ -167,7 +232,7 @@ async function prerenderPages({ routes, apiRoutes, pagesDir, outDir, config, mod
 			ownedProdServerHandle = srv;
 			return srv;
 		})()).port}`;
-		const secretHeaders = prerenderSecret ? { "x-vinext-prerender-secret": prerenderSecret } : {};
+		const secretHeaders = prerenderSecret ? { [VINEXT_PRERENDER_SECRET_HEADER]: prerenderSecret } : {};
 		const renderPage = (urlPath) => fetch(`${baseUrl}${urlPath}`, {
 			headers: secretHeaders,
 			redirect: "manual"
@@ -244,14 +309,34 @@ async function prerenderPages({ routes, apiRoutes, pagesDir, outDir, config, mod
 					continue;
 				}
 				const paths = pathsResult?.paths ?? [];
-				for (const { params } of paths) {
-					const urlPath = buildUrlFromParams(route.pattern, params);
-					pagesToRender.push({
-						route,
-						urlPath,
-						params,
-						revalidate
+				let entryError = null;
+				for (const item of paths) {
+					const normalized = normalizeStaticPathsEntry(item, route.pattern);
+					if ("error" in normalized) {
+						entryError = normalized.error;
+						break;
+					}
+					const { params } = normalized;
+					try {
+						const urlPath = buildUrlFromParams(route.pattern, params);
+						pagesToRender.push({
+							route,
+							urlPath,
+							params,
+							revalidate
+						});
+					} catch (e) {
+						entryError = e.message;
+						break;
+					}
+				}
+				if (entryError) {
+					results.push({
+						route: route.pattern,
+						status: "error",
+						error: entryError
 					});
+					continue;
 				}
 			} else pagesToRender.push({
 				route,
@@ -379,7 +464,7 @@ async function prerenderApp({ routes, outDir, config, mode, rscBundlePath, ...op
 			ownedProdServerHandle = srv;
 			return srv;
 		})()).port}`;
-		const secretHeaders = prerenderSecret ? { "x-vinext-prerender-secret": prerenderSecret } : {};
+		const secretHeaders = prerenderSecret ? { [VINEXT_PRERENDER_SECRET_HEADER]: prerenderSecret } : {};
 		rscHandler = (req) => {
 			const parsed = new URL(req.url);
 			const url = `${baseUrl}${parsed.pathname}${parsed.search}`;
@@ -509,6 +594,7 @@ async function prerenderApp({ routes, outDir, config, mode, rscBundlePath, ...op
 					continue;
 				}
 				for (const params of paramSets) {
+					if (params === null || params === void 0) throw new Error(`generateStaticParams() for ${route.pattern} returned an entry with no params object.`);
 					const urlPath = buildUrlFromParams(route.pattern, params);
 					urlsToRender.push({
 						urlPath,
@@ -595,25 +681,30 @@ async function prerenderApp({ routes, outDir, config, mode, rscBundlePath, ...op
 					error: "RSC handler returned no prerender HTML"
 				};
 				const html = htmlRender.html;
-				const rscRequest = new Request(`http://localhost${urlPath}`, { headers: {
-					Accept: "text/x-component",
-					RSC: "1"
-				} });
-				const rscRes = await runWithHeadersContext(headersContextFromRequest(rscRequest), () => rscHandler(rscRequest));
-				const rscData = rscRes.ok ? await rscRes.text() : null;
+				let rscData = extractRscPayloadFromPrerenderedHtml(html);
+				if (rscData === null) {
+					const rscRequest = new Request(`http://localhost${urlPath}`, { headers: {
+						Accept: "text/x-component",
+						RSC: "1"
+					} });
+					const rscRes = await runWithHeadersContext(headersContextFromRequest(rscRequest), () => rscHandler(rscRequest));
+					if (!rscRes.ok) {
+						await rscRes.body?.cancel();
+						throw new Error(`[vinext] prerenderApp: RSC fallback returned ${rscRes.status} for ${urlPath}`);
+					}
+					rscData = new Uint8Array(await rscRes.arrayBuffer());
+				}
 				const outputFiles = [];
 				const htmlOutputPath = getOutputPath(urlPath, config.trailingSlash);
 				const htmlFullPath = path.join(outDir, htmlOutputPath);
 				fs.mkdirSync(path.dirname(htmlFullPath), { recursive: true });
 				fs.writeFileSync(htmlFullPath, html, "utf-8");
 				outputFiles.push(htmlOutputPath);
-				if (rscData !== null) {
-					const rscOutputPath = getRscOutputPath(urlPath);
-					const rscFullPath = path.join(outDir, rscOutputPath);
-					fs.mkdirSync(path.dirname(rscFullPath), { recursive: true });
-					fs.writeFileSync(rscFullPath, rscData, "utf-8");
-					outputFiles.push(rscOutputPath);
-				}
+				const rscOutputPath = getRscOutputPath(urlPath);
+				const rscFullPath = path.join(outDir, rscOutputPath);
+				fs.mkdirSync(path.dirname(rscFullPath), { recursive: true });
+				fs.writeFileSync(rscFullPath, rscData);
+				outputFiles.push(rscOutputPath);
 				const renderedCacheControl = resolveRenderedCacheControl(htmlRender.requestCacheLife ?? {}, htmlCacheControl, config.expireTime);
 				const renderedRevalidate = typeof revalidate === "number" ? renderedCacheControl.revalidate === void 0 ? revalidate : Math.min(revalidate, renderedCacheControl.revalidate) : renderedCacheControl.revalidate ?? revalidate;
 				return {
@@ -755,6 +846,6 @@ function writePrerenderIndex(routes, outDir, options) {
 	fs.writeFileSync(path.join(outDir, "vinext-prerender.json"), JSON.stringify(index, null, 2), "utf-8");
 }
 //#endregion
-export { getOutputPath, getRscOutputPath, prerenderApp, prerenderPages, readPrerenderSecret, resolveParentParams, writePrerenderIndex };
+export { extractRscPayloadFromPrerenderedHtml, getOutputPath, getRscOutputPath, prerenderApp, prerenderPages, readPrerenderSecret, resolveParentParams, writePrerenderIndex };
 
 //# sourceMappingURL=prerender.js.map