vinext 0.0.50 → 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/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;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;;;;;;;;;;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;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"}
+{"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

@@ -122,7 +122,7 @@ type PrerenderAppOptionsInternal = PrerenderAppOptions & {
  * Safe regex usage: safeJsonStringify (used by createRscEmbedTransform) escapes
  * all '<' and '>' in the embedded JSON, preventing false </script> matches.
  */
-declare function extractRscPayloadFromPrerenderedHtml(html: string): string | null;
+declare function extractRscPayloadFromPrerenderedHtml(html: string): Uint8Array | null;
 /**
  * Determine the HTML output file path for a URL.
  * Respects trailingSlash config.

package/dist/build/prerender.js

@@ -1,8 +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";
@@ -61,15 +63,15 @@ function extractRscPayloadFromPrerenderedHtml(html) {
 			sawDone = true;
 			continue;
 		}
-		if (script.startsWith(RSC_CHUNK_SCRIPT_PREFIX)) chunks.push(parseRscChunkPushArgument(script));
+		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 chunks.join("");
+	return concatUint8Arrays(chunks);
 }
 /**
-* Parse the JSON-string argument of a single chunk-push script. The script
+* 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
@@ -84,8 +86,9 @@ function parseRscChunkPushArgument(script) {
 	} catch {
 		throw new Error("[vinext] Malformed prerender RSC embed: invalid chunk JSON");
 	}
-	if (typeof parsed !== "string") throw new Error("[vinext] Malformed prerender RSC embed: chunk payload is not a string");
-	return parsed;
+	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.
@@ -109,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("*")) {
@@ -300,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,
@@ -565,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,
@@ -662,7 +692,7 @@ async function prerenderApp({ routes, outDir, config, mode, rscBundlePath, ...op
 						await rscRes.body?.cancel();
 						throw new Error(`[vinext] prerenderApp: RSC fallback returned ${rscRes.status} for ${urlPath}`);
 					}
-					rscData = await rscRes.text();
+					rscData = new Uint8Array(await rscRes.arrayBuffer());
 				}
 				const outputFiles = [];
 				const htmlOutputPath = getOutputPath(urlPath, config.trailingSlash);
@@ -673,7 +703,7 @@ async function prerenderApp({ routes, outDir, config, mode, rscBundlePath, ...op
 				const rscOutputPath = getRscOutputPath(urlPath);
 				const rscFullPath = path.join(outDir, rscOutputPath);
 				fs.mkdirSync(path.dirname(rscFullPath), { recursive: true });
-				fs.writeFileSync(rscFullPath, rscData, "utf-8");
+				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;