vinext 0.0.47 → 0.0.48

package/dist/plugins/og-assets.js

@@ -30,17 +30,22 @@ function createOgInlineFetchAssetsPlugin() {
 			const moduleDir = path.dirname(id);
 			let newCode = code;
 			let didReplace = false;
+			const readAsBase64 = async (absPath) => {
+				const cached = useCache ? cache.get(absPath) : void 0;
+				if (cached !== void 0) return cached;
+				try {
+					const b64 = (await fs.promises.readFile(absPath)).toString("base64");
+					if (useCache) cache.set(absPath, b64);
+					return b64;
+				} catch {
+					return null;
+				}
+			};
 			if (code.includes("fetch(")) for (const match of code.matchAll(/fetch\(\s*new URL\(\s*(["'])(\.\/[^"']+)\1\s*,\s*import\.meta\.url\s*\)\s*\)(?:\.then\(\s*(?:function\s*\([^)]*\)|\([^)]*\)\s*=>)\s*\{?\s*return\s+[^.]+\.arrayBuffer\(\)\s*\}?\s*\)|\.then\(\s*\([^)]*\)\s*=>\s*[^.]+\.arrayBuffer\(\)\s*\))/g)) {
 				const fullMatch = match[0];
 				const relPath = match[2];
-				const absPath = path.resolve(moduleDir, relPath);
-				let fileBase64 = useCache ? cache.get(absPath) : void 0;
-				if (fileBase64 === void 0) try {
-					fileBase64 = (await fs.promises.readFile(absPath)).toString("base64");
-					if (useCache) cache.set(absPath, fileBase64);
-				} catch {
-					continue;
-				}
+				const fileBase64 = await readAsBase64(path.resolve(moduleDir, relPath));
+				if (fileBase64 === null) continue;
 				const inlined = [
 					`(function(){`,
 					`var b=${JSON.stringify(fileBase64)};`,
@@ -56,14 +61,8 @@ function createOgInlineFetchAssetsPlugin() {
 			if (code.includes("readFileSync(")) for (const match of newCode.matchAll(/[a-zA-Z_$][a-zA-Z0-9_$]*\.readFileSync\(\s*(?:[a-zA-Z_$][a-zA-Z0-9_$]*\.)?fileURLToPath\(\s*new URL\(\s*(["'])(\.\/[^"']+)\1\s*,\s*import\.meta\.url\s*\)\s*\)\s*\)/g)) {
 				const fullMatch = match[0];
 				const relPath = match[2];
-				const absPath = path.resolve(moduleDir, relPath);
-				let fileBase64 = useCache ? cache.get(absPath) : void 0;
-				if (fileBase64 === void 0) try {
-					fileBase64 = (await fs.promises.readFile(absPath)).toString("base64");
-					if (useCache) cache.set(absPath, fileBase64);
-				} catch {
-					continue;
-				}
+				const fileBase64 = await readAsBase64(path.resolve(moduleDir, relPath));
+				if (fileBase64 === null) continue;
 				const inlined = `Buffer.from(${JSON.stringify(fileBase64)},"base64")`;
 				newCode = newCode.replaceAll(fullMatch, inlined);
 				didReplace = true;

package/dist/plugins/og-assets.js.map

@@ -1 +1 @@
-{"version":3,"file":"og-assets.js","names":[],"sources":["../../src/plugins/og-assets.ts"],"sourcesContent":["/**\n * vinext OG image asset plugins\n *\n * Exports two Vite plugins:\n *\n * `createOgInlineFetchAssetsPlugin` — vinext:og-inline-fetch-assets\n *   Some bundled libraries (notably @vercel/og) load assets at module init\n *   time with the pattern:\n *\n *     fetch(new URL(\"./some-font.ttf\", import.meta.url)).then(res => res.arrayBuffer())\n *\n *   This works in browser and standard Node.js because import.meta.url is a\n *   real file:// URL. In Cloudflare Workers (both wrangler dev and production),\n *   however, import.meta.url is the string \"worker\" — not a URL — so\n *   new URL(...) throws \"TypeError: Invalid URL string\" and the Worker fails to\n *   start.\n *\n *   Fix: at Vite transform time, find every such pattern, resolve the referenced\n *   file relative to the module's actual path on disk (available as `id`), read\n *   it, and replace the entire fetch(new URL(...)) expression with an inline\n *   base64 IIFE that resolves synchronously. This eliminates the runtime fetch\n *   entirely and works in all environments (workerd, Node.js, browser).\n *\n *   Note: WASM files imported via `import ... from \"./foo.wasm?module\"` are\n *   handled by the bundler/Vite directly and do not need this treatment. Only\n *   assets that are runtime-fetched (not statically imported) need inlining.\n *\n * `ogAssetsPlugin` — vinext:og-assets\n *   Copies @vercel/og binary assets (e.g. resvg.wasm) to the RSC output\n *   directory for production builds. The edge build inlines fonts as base64 via\n *   og-inline-fetch-assets; this plugin is a safety net to ensure resvg.wasm is\n *   present for the Node.js disk-read fallback.\n */\n\nimport type { Plugin } from \"vite\";\nimport path from \"node:path\";\nimport fs from \"node:fs\";\nimport { createRequire } from \"node:module\";\n\n// ── Plugin factories ──────────────────────────────────────────────────────────\n\n/**\n * Create the `vinext:og-inline-fetch-assets` Vite plugin.\n *\n * Inlines binary assets that are runtime-fetched via\n * `fetch(new URL(\"./asset\", import.meta.url))` or read via\n * `readFileSync(fileURLToPath(new URL(\"./asset\", import.meta.url)))`.\n * Both patterns are rewritten to inline base64 literals so the code works\n * correctly inside Cloudflare Workers where `import.meta.url` is not a\n * valid file URL.\n */\nexport function createOgInlineFetchAssetsPlugin(): Plugin {\n  // Build-only cache to avoid repeated file reads during a single production\n  // build. Dev mode skips the cache so asset edits are picked up without\n  // restarting the Vite server.\n  const cache = new Map<string, string>(); // absPath -> base64\n  let isBuild = false;\n\n  return {\n    name: \"vinext:og-inline-fetch-assets\",\n    enforce: \"pre\",\n\n    configResolved(config) {\n      isBuild = config.command === \"build\";\n    },\n\n    buildStart() {\n      if (isBuild) {\n        cache.clear();\n      }\n    },\n\n    async transform(code, id) {\n      // Quick bail-out: only process modules that use new URL(..., import.meta.url)\n      if (!code.includes(\"import.meta.url\")) {\n        return null;\n      }\n\n      const useCache = isBuild;\n      const moduleDir = path.dirname(id);\n      let newCode = code;\n      let didReplace = false;\n\n      // Pattern 1 — edge build: fetch(new URL(\"./file\", import.meta.url)).then((res) => res.arrayBuffer())\n      // Replace with an inline IIFE that decodes the asset as base64 and returns Promise<ArrayBuffer>.\n      if (code.includes(\"fetch(\")) {\n        const fetchPattern =\n          /fetch\\(\\s*new URL\\(\\s*([\"'])(\\.\\/[^\"']+)\\1\\s*,\\s*import\\.meta\\.url\\s*\\)\\s*\\)(?:\\.then\\(\\s*(?:function\\s*\\([^)]*\\)|\\([^)]*\\)\\s*=>)\\s*\\{?\\s*return\\s+[^.]+\\.arrayBuffer\\(\\)\\s*\\}?\\s*\\)|\\.then\\(\\s*\\([^)]*\\)\\s*=>\\s*[^.]+\\.arrayBuffer\\(\\)\\s*\\))/g;\n\n        for (const match of code.matchAll(fetchPattern)) {\n          const fullMatch = match[0];\n          const relPath = match[2]; // e.g. \"./noto-sans-v27-latin-regular.ttf\"\n          const absPath = path.resolve(moduleDir, relPath);\n\n          let fileBase64 = useCache ? cache.get(absPath) : undefined;\n          if (fileBase64 === undefined) {\n            try {\n              const buf = await fs.promises.readFile(absPath);\n              fileBase64 = buf.toString(\"base64\");\n              if (useCache) {\n                cache.set(absPath, fileBase64);\n              }\n            } catch {\n              // File not found on disk — skip (may be a runtime-only asset)\n              continue;\n            }\n          }\n\n          // Replace fetch(...).then(...) with an inline IIFE that returns Promise<ArrayBuffer>.\n          const inlined = [\n            `(function(){`,\n            `var b=${JSON.stringify(fileBase64)};`,\n            `var r=atob(b);`,\n            `var a=new Uint8Array(r.length);`,\n            `for(var i=0;i<r.length;i++)a[i]=r.charCodeAt(i);`,\n            `return Promise.resolve(a.buffer);`,\n            `})()`,\n          ].join(\"\");\n\n          newCode = newCode.replaceAll(fullMatch, inlined);\n          didReplace = true;\n        }\n      }\n\n      // Pattern 2 — node build: readFileSync(fileURLToPath(new URL(\"./file\", import.meta.url)))\n      // Replace with Buffer.from(\"<base64>\", \"base64\"), which returns a Buffer (compatible with\n      // both font data passed to satori and WASM bytes passed to initWasm).\n      if (code.includes(\"readFileSync(\")) {\n        const readFilePattern =\n          /[a-zA-Z_$][a-zA-Z0-9_$]*\\.readFileSync\\(\\s*(?:[a-zA-Z_$][a-zA-Z0-9_$]*\\.)?fileURLToPath\\(\\s*new URL\\(\\s*([\"'])(\\.\\/[^\"']+)\\1\\s*,\\s*import\\.meta\\.url\\s*\\)\\s*\\)\\s*\\)/g;\n\n        for (const match of newCode.matchAll(readFilePattern)) {\n          const fullMatch = match[0];\n          const relPath = match[2]; // e.g. \"./noto-sans-v27-latin-regular.ttf\"\n          const absPath = path.resolve(moduleDir, relPath);\n\n          let fileBase64 = useCache ? cache.get(absPath) : undefined;\n          if (fileBase64 === undefined) {\n            try {\n              const buf = await fs.promises.readFile(absPath);\n              fileBase64 = buf.toString(\"base64\");\n              if (useCache) {\n                cache.set(absPath, fileBase64);\n              }\n            } catch {\n              // File not found on disk — skip\n              continue;\n            }\n          }\n\n          // Replace readFileSync(...) with Buffer.from(\"<base64>\", \"base64\").\n          // Buffer is always available in Node.js and in the vinext SSR/RSC environments.\n          const inlined = `Buffer.from(${JSON.stringify(fileBase64)},\"base64\")`;\n\n          newCode = newCode.replaceAll(fullMatch, inlined);\n          didReplace = true;\n        }\n      }\n\n      if (!didReplace) return null;\n      return { code: newCode, map: null };\n    },\n  } satisfies Plugin;\n}\n\n/**\n * The `vinext:og-assets` Vite plugin.\n *\n * Copies @vercel/og binary assets (e.g. resvg.wasm) to the RSC output\n * directory for production builds. The edge build inlines fonts as base64 via\n * `vinext:og-inline-fetch-assets`; this plugin is a safety net to ensure\n * resvg.wasm exists in the output directory for the Node.js disk-read fallback.\n */\nexport const ogAssetsPlugin: Plugin = {\n  name: \"vinext:og-assets\",\n  apply: \"build\",\n  enforce: \"post\",\n  writeBundle: {\n    sequential: true,\n    order: \"post\",\n    async handler(options) {\n      const envName = this.environment?.name;\n      if (envName !== \"rsc\") return;\n\n      const outDir = options.dir;\n      if (!outDir) return;\n\n      // Check if the bundle references @vercel/og assets\n      const indexPath = path.join(outDir, \"index.js\");\n      if (!fs.existsSync(indexPath)) return;\n\n      const content = fs.readFileSync(indexPath, \"utf-8\");\n      // The font is inlined as base64 by vinext:og-inline-fetch-assets, so only\n      // the WASM needs to be present as a file alongside the bundle.\n      const ogAssets = [\"resvg.wasm\"];\n\n      // Only copy if the bundle actually references these files\n      const referencedAssets = ogAssets.filter((asset) => content.includes(asset));\n      if (referencedAssets.length === 0) return;\n\n      // Find @vercel/og in node_modules\n      try {\n        const require = createRequire(import.meta.url);\n        const ogPkgPath = require.resolve(\"@vercel/og/package.json\");\n        const ogDistDir = path.join(path.dirname(ogPkgPath), \"dist\");\n\n        for (const asset of referencedAssets) {\n          const src = path.join(ogDistDir, asset);\n          const dest = path.join(outDir, asset);\n          if (fs.existsSync(src) && !fs.existsSync(dest)) {\n            fs.copyFileSync(src, dest);\n          }\n        }\n      } catch {\n        // @vercel/og not installed — nothing to copy\n      }\n    },\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;AAmDA,SAAgB,kCAA0C;CAIxD,MAAM,wBAAQ,IAAI,KAAqB;CACvC,IAAI,UAAU;AAEd,QAAO;EACL,MAAM;EACN,SAAS;EAET,eAAe,QAAQ;AACrB,aAAU,OAAO,YAAY;;EAG/B,aAAa;AACX,OAAI,QACF,OAAM,OAAO;;EAIjB,MAAM,UAAU,MAAM,IAAI;AAExB,OAAI,CAAC,KAAK,SAAS,kBAAkB,CACnC,QAAO;GAGT,MAAM,WAAW;GACjB,MAAM,YAAY,KAAK,QAAQ,GAAG;GAClC,IAAI,UAAU;GACd,IAAI,aAAa;AAIjB,OAAI,KAAK,SAAS,SAAS,CAIzB,MAAK,MAAM,SAAS,KAAK,SAFvB,iPAE6C,EAAE;IAC/C,MAAM,YAAY,MAAM;IACxB,MAAM,UAAU,MAAM;IACtB,MAAM,UAAU,KAAK,QAAQ,WAAW,QAAQ;IAEhD,IAAI,aAAa,WAAW,MAAM,IAAI,QAAQ,GAAG,KAAA;AACjD,QAAI,eAAe,KAAA,EACjB,KAAI;AAEF,mBADY,MAAM,GAAG,SAAS,SAAS,QAAQ,EAC9B,SAAS,SAAS;AACnC,SAAI,SACF,OAAM,IAAI,SAAS,WAAW;YAE1B;AAEN;;IAKJ,MAAM,UAAU;KACd;KACA,SAAS,KAAK,UAAU,WAAW,CAAC;KACpC;KACA;KACA;KACA;KACA;KACD,CAAC,KAAK,GAAG;AAEV,cAAU,QAAQ,WAAW,WAAW,QAAQ;AAChD,iBAAa;;AAOjB,OAAI,KAAK,SAAS,gBAAgB,CAIhC,MAAK,MAAM,SAAS,QAAQ,SAF1B,uKAEmD,EAAE;IACrD,MAAM,YAAY,MAAM;IACxB,MAAM,UAAU,MAAM;IACtB,MAAM,UAAU,KAAK,QAAQ,WAAW,QAAQ;IAEhD,IAAI,aAAa,WAAW,MAAM,IAAI,QAAQ,GAAG,KAAA;AACjD,QAAI,eAAe,KAAA,EACjB,KAAI;AAEF,mBADY,MAAM,GAAG,SAAS,SAAS,QAAQ,EAC9B,SAAS,SAAS;AACnC,SAAI,SACF,OAAM,IAAI,SAAS,WAAW;YAE1B;AAEN;;IAMJ,MAAM,UAAU,eAAe,KAAK,UAAU,WAAW,CAAC;AAE1D,cAAU,QAAQ,WAAW,WAAW,QAAQ;AAChD,iBAAa;;AAIjB,OAAI,CAAC,WAAY,QAAO;AACxB,UAAO;IAAE,MAAM;IAAS,KAAK;IAAM;;EAEtC;;;;;;;;;;AAWH,MAAa,iBAAyB;CACpC,MAAM;CACN,OAAO;CACP,SAAS;CACT,aAAa;EACX,YAAY;EACZ,OAAO;EACP,MAAM,QAAQ,SAAS;AAErB,OADgB,KAAK,aAAa,SAClB,MAAO;GAEvB,MAAM,SAAS,QAAQ;AACvB,OAAI,CAAC,OAAQ;GAGb,MAAM,YAAY,KAAK,KAAK,QAAQ,WAAW;AAC/C,OAAI,CAAC,GAAG,WAAW,UAAU,CAAE;GAE/B,MAAM,UAAU,GAAG,aAAa,WAAW,QAAQ;GAMnD,MAAM,mBAHW,CAAC,aAAa,CAGG,QAAQ,UAAU,QAAQ,SAAS,MAAM,CAAC;AAC5E,OAAI,iBAAiB,WAAW,EAAG;AAGnC,OAAI;IAEF,MAAM,YADU,cAAc,OAAO,KAAK,IAAI,CACpB,QAAQ,0BAA0B;IAC5D,MAAM,YAAY,KAAK,KAAK,KAAK,QAAQ,UAAU,EAAE,OAAO;AAE5D,SAAK,MAAM,SAAS,kBAAkB;KACpC,MAAM,MAAM,KAAK,KAAK,WAAW,MAAM;KACvC,MAAM,OAAO,KAAK,KAAK,QAAQ,MAAM;AACrC,SAAI,GAAG,WAAW,IAAI,IAAI,CAAC,GAAG,WAAW,KAAK,CAC5C,IAAG,aAAa,KAAK,KAAK;;WAGxB;;EAIX;CACF"}
+{"version":3,"file":"og-assets.js","names":[],"sources":["../../src/plugins/og-assets.ts"],"sourcesContent":["/**\n * vinext OG image asset plugins\n *\n * Exports two Vite plugins:\n *\n * `createOgInlineFetchAssetsPlugin` — vinext:og-inline-fetch-assets\n *   Some bundled libraries (notably @vercel/og) load assets at module init\n *   time with the pattern:\n *\n *     fetch(new URL(\"./some-font.ttf\", import.meta.url)).then(res => res.arrayBuffer())\n *\n *   This works in browser and standard Node.js because import.meta.url is a\n *   real file:// URL. In Cloudflare Workers (both wrangler dev and production),\n *   however, import.meta.url is the string \"worker\" — not a URL — so\n *   new URL(...) throws \"TypeError: Invalid URL string\" and the Worker fails to\n *   start.\n *\n *   Fix: at Vite transform time, find every such pattern, resolve the referenced\n *   file relative to the module's actual path on disk (available as `id`), read\n *   it, and replace the entire fetch(new URL(...)) expression with an inline\n *   base64 IIFE that resolves synchronously. This eliminates the runtime fetch\n *   entirely and works in all environments (workerd, Node.js, browser).\n *\n *   Note: WASM files imported via `import ... from \"./foo.wasm?module\"` are\n *   handled by the bundler/Vite directly and do not need this treatment. Only\n *   assets that are runtime-fetched (not statically imported) need inlining.\n *\n * `ogAssetsPlugin` — vinext:og-assets\n *   Copies @vercel/og binary assets (e.g. resvg.wasm) to the RSC output\n *   directory for production builds. The edge build inlines fonts as base64 via\n *   og-inline-fetch-assets; this plugin is a safety net to ensure resvg.wasm is\n *   present for the Node.js disk-read fallback.\n */\n\nimport type { Plugin } from \"vite\";\nimport path from \"node:path\";\nimport fs from \"node:fs\";\nimport { createRequire } from \"node:module\";\n\n// ── Plugin factories ──────────────────────────────────────────────────────────\n\n/**\n * Create the `vinext:og-inline-fetch-assets` Vite plugin.\n *\n * Inlines binary assets that are runtime-fetched via\n * `fetch(new URL(\"./asset\", import.meta.url))` or read via\n * `readFileSync(fileURLToPath(new URL(\"./asset\", import.meta.url)))`.\n * Both patterns are rewritten to inline base64 literals so the code works\n * correctly inside Cloudflare Workers where `import.meta.url` is not a\n * valid file URL.\n */\nexport function createOgInlineFetchAssetsPlugin(): Plugin {\n  // Build-only cache to avoid repeated file reads during a single production\n  // build. Dev mode skips the cache so asset edits are picked up without\n  // restarting the Vite server.\n  const cache = new Map<string, string>(); // absPath -> base64\n  let isBuild = false;\n\n  return {\n    name: \"vinext:og-inline-fetch-assets\",\n    enforce: \"pre\",\n\n    configResolved(config) {\n      isBuild = config.command === \"build\";\n    },\n\n    buildStart() {\n      if (isBuild) {\n        cache.clear();\n      }\n    },\n\n    async transform(code, id) {\n      // Quick bail-out: only process modules that use new URL(..., import.meta.url)\n      if (!code.includes(\"import.meta.url\")) {\n        return null;\n      }\n\n      const useCache = isBuild;\n      const moduleDir = path.dirname(id);\n      let newCode = code;\n      let didReplace = false;\n\n      // Read a file from disk and return its base64 encoding, using the build\n      // cache when enabled. Returns null on any read error so callers can skip\n      // the match (e.g. file not present on disk for the active environment).\n      const readAsBase64 = async (absPath: string): Promise<string | null> => {\n        const cached = useCache ? cache.get(absPath) : undefined;\n        if (cached !== undefined) return cached;\n        try {\n          const buf = await fs.promises.readFile(absPath);\n          const b64 = buf.toString(\"base64\");\n          if (useCache) cache.set(absPath, b64);\n          return b64;\n        } catch {\n          return null;\n        }\n      };\n\n      // Pattern 1 — edge build: fetch(new URL(\"./file\", import.meta.url)).then((res) => res.arrayBuffer())\n      // Replace with an inline IIFE that decodes the asset as base64 and returns Promise<ArrayBuffer>.\n      if (code.includes(\"fetch(\")) {\n        const fetchPattern =\n          /fetch\\(\\s*new URL\\(\\s*([\"'])(\\.\\/[^\"']+)\\1\\s*,\\s*import\\.meta\\.url\\s*\\)\\s*\\)(?:\\.then\\(\\s*(?:function\\s*\\([^)]*\\)|\\([^)]*\\)\\s*=>)\\s*\\{?\\s*return\\s+[^.]+\\.arrayBuffer\\(\\)\\s*\\}?\\s*\\)|\\.then\\(\\s*\\([^)]*\\)\\s*=>\\s*[^.]+\\.arrayBuffer\\(\\)\\s*\\))/g;\n\n        for (const match of code.matchAll(fetchPattern)) {\n          const fullMatch = match[0];\n          const relPath = match[2]; // e.g. \"./noto-sans-v27-latin-regular.ttf\"\n          const absPath = path.resolve(moduleDir, relPath);\n\n          const fileBase64 = await readAsBase64(absPath);\n          if (fileBase64 === null) continue; // may be a runtime-only asset\n\n          // Replace fetch(...).then(...) with an inline IIFE that returns Promise<ArrayBuffer>.\n          const inlined = [\n            `(function(){`,\n            `var b=${JSON.stringify(fileBase64)};`,\n            `var r=atob(b);`,\n            `var a=new Uint8Array(r.length);`,\n            `for(var i=0;i<r.length;i++)a[i]=r.charCodeAt(i);`,\n            `return Promise.resolve(a.buffer);`,\n            `})()`,\n          ].join(\"\");\n\n          newCode = newCode.replaceAll(fullMatch, inlined);\n          didReplace = true;\n        }\n      }\n\n      // Pattern 2 — node build: readFileSync(fileURLToPath(new URL(\"./file\", import.meta.url)))\n      // Replace with Buffer.from(\"<base64>\", \"base64\"), which returns a Buffer (compatible with\n      // both font data passed to satori and WASM bytes passed to initWasm).\n      if (code.includes(\"readFileSync(\")) {\n        const readFilePattern =\n          /[a-zA-Z_$][a-zA-Z0-9_$]*\\.readFileSync\\(\\s*(?:[a-zA-Z_$][a-zA-Z0-9_$]*\\.)?fileURLToPath\\(\\s*new URL\\(\\s*([\"'])(\\.\\/[^\"']+)\\1\\s*,\\s*import\\.meta\\.url\\s*\\)\\s*\\)\\s*\\)/g;\n\n        for (const match of newCode.matchAll(readFilePattern)) {\n          const fullMatch = match[0];\n          const relPath = match[2]; // e.g. \"./noto-sans-v27-latin-regular.ttf\"\n          const absPath = path.resolve(moduleDir, relPath);\n\n          const fileBase64 = await readAsBase64(absPath);\n          if (fileBase64 === null) continue;\n\n          // Replace readFileSync(...) with Buffer.from(\"<base64>\", \"base64\").\n          // Buffer is always available in Node.js and in the vinext SSR/RSC environments.\n          const inlined = `Buffer.from(${JSON.stringify(fileBase64)},\"base64\")`;\n\n          newCode = newCode.replaceAll(fullMatch, inlined);\n          didReplace = true;\n        }\n      }\n\n      if (!didReplace) return null;\n      return { code: newCode, map: null };\n    },\n  } satisfies Plugin;\n}\n\n/**\n * The `vinext:og-assets` Vite plugin.\n *\n * Copies @vercel/og binary assets (e.g. resvg.wasm) to the RSC output\n * directory for production builds. The edge build inlines fonts as base64 via\n * `vinext:og-inline-fetch-assets`; this plugin is a safety net to ensure\n * resvg.wasm exists in the output directory for the Node.js disk-read fallback.\n */\nexport const ogAssetsPlugin: Plugin = {\n  name: \"vinext:og-assets\",\n  apply: \"build\",\n  enforce: \"post\",\n  writeBundle: {\n    sequential: true,\n    order: \"post\",\n    async handler(options) {\n      const envName = this.environment?.name;\n      if (envName !== \"rsc\") return;\n\n      const outDir = options.dir;\n      if (!outDir) return;\n\n      // Check if the bundle references @vercel/og assets\n      const indexPath = path.join(outDir, \"index.js\");\n      if (!fs.existsSync(indexPath)) return;\n\n      const content = fs.readFileSync(indexPath, \"utf-8\");\n      // The font is inlined as base64 by vinext:og-inline-fetch-assets, so only\n      // the WASM needs to be present as a file alongside the bundle.\n      const ogAssets = [\"resvg.wasm\"];\n\n      // Only copy if the bundle actually references these files\n      const referencedAssets = ogAssets.filter((asset) => content.includes(asset));\n      if (referencedAssets.length === 0) return;\n\n      // Find @vercel/og in node_modules\n      try {\n        const require = createRequire(import.meta.url);\n        const ogPkgPath = require.resolve(\"@vercel/og/package.json\");\n        const ogDistDir = path.join(path.dirname(ogPkgPath), \"dist\");\n\n        for (const asset of referencedAssets) {\n          const src = path.join(ogDistDir, asset);\n          const dest = path.join(outDir, asset);\n          if (fs.existsSync(src) && !fs.existsSync(dest)) {\n            fs.copyFileSync(src, dest);\n          }\n        }\n      } catch {\n        // @vercel/og not installed — nothing to copy\n      }\n    },\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;AAmDA,SAAgB,kCAA0C;CAIxD,MAAM,wBAAQ,IAAI,KAAqB;CACvC,IAAI,UAAU;AAEd,QAAO;EACL,MAAM;EACN,SAAS;EAET,eAAe,QAAQ;AACrB,aAAU,OAAO,YAAY;;EAG/B,aAAa;AACX,OAAI,QACF,OAAM,OAAO;;EAIjB,MAAM,UAAU,MAAM,IAAI;AAExB,OAAI,CAAC,KAAK,SAAS,kBAAkB,CACnC,QAAO;GAGT,MAAM,WAAW;GACjB,MAAM,YAAY,KAAK,QAAQ,GAAG;GAClC,IAAI,UAAU;GACd,IAAI,aAAa;GAKjB,MAAM,eAAe,OAAO,YAA4C;IACtE,MAAM,SAAS,WAAW,MAAM,IAAI,QAAQ,GAAG,KAAA;AAC/C,QAAI,WAAW,KAAA,EAAW,QAAO;AACjC,QAAI;KAEF,MAAM,OADM,MAAM,GAAG,SAAS,SAAS,QAAQ,EAC/B,SAAS,SAAS;AAClC,SAAI,SAAU,OAAM,IAAI,SAAS,IAAI;AACrC,YAAO;YACD;AACN,YAAO;;;AAMX,OAAI,KAAK,SAAS,SAAS,CAIzB,MAAK,MAAM,SAAS,KAAK,SAFvB,iPAE6C,EAAE;IAC/C,MAAM,YAAY,MAAM;IACxB,MAAM,UAAU,MAAM;IAGtB,MAAM,aAAa,MAAM,aAFT,KAAK,QAAQ,WAAW,QAAQ,CAEF;AAC9C,QAAI,eAAe,KAAM;IAGzB,MAAM,UAAU;KACd;KACA,SAAS,KAAK,UAAU,WAAW,CAAC;KACpC;KACA;KACA;KACA;KACA;KACD,CAAC,KAAK,GAAG;AAEV,cAAU,QAAQ,WAAW,WAAW,QAAQ;AAChD,iBAAa;;AAOjB,OAAI,KAAK,SAAS,gBAAgB,CAIhC,MAAK,MAAM,SAAS,QAAQ,SAF1B,uKAEmD,EAAE;IACrD,MAAM,YAAY,MAAM;IACxB,MAAM,UAAU,MAAM;IAGtB,MAAM,aAAa,MAAM,aAFT,KAAK,QAAQ,WAAW,QAAQ,CAEF;AAC9C,QAAI,eAAe,KAAM;IAIzB,MAAM,UAAU,eAAe,KAAK,UAAU,WAAW,CAAC;AAE1D,cAAU,QAAQ,WAAW,WAAW,QAAQ;AAChD,iBAAa;;AAIjB,OAAI,CAAC,WAAY,QAAO;AACxB,UAAO;IAAE,MAAM;IAAS,KAAK;IAAM;;EAEtC;;;;;;;;;;AAWH,MAAa,iBAAyB;CACpC,MAAM;CACN,OAAO;CACP,SAAS;CACT,aAAa;EACX,YAAY;EACZ,OAAO;EACP,MAAM,QAAQ,SAAS;AAErB,OADgB,KAAK,aAAa,SAClB,MAAO;GAEvB,MAAM,SAAS,QAAQ;AACvB,OAAI,CAAC,OAAQ;GAGb,MAAM,YAAY,KAAK,KAAK,QAAQ,WAAW;AAC/C,OAAI,CAAC,GAAG,WAAW,UAAU,CAAE;GAE/B,MAAM,UAAU,GAAG,aAAa,WAAW,QAAQ;GAMnD,MAAM,mBAHW,CAAC,aAAa,CAGG,QAAQ,UAAU,QAAQ,SAAS,MAAM,CAAC;AAC5E,OAAI,iBAAiB,WAAW,EAAG;AAGnC,OAAI;IAEF,MAAM,YADU,cAAc,OAAO,KAAK,IAAI,CACpB,QAAQ,0BAA0B;IAC5D,MAAM,YAAY,KAAK,KAAK,KAAK,QAAQ,UAAU,EAAE,OAAO;AAE5D,SAAK,MAAM,SAAS,kBAAkB;KACpC,MAAM,MAAM,KAAK,KAAK,WAAW,MAAM;KACvC,MAAM,OAAO,KAAK,KAAK,QAAQ,MAAM;AACrC,SAAI,GAAG,WAAW,IAAI,IAAI,CAAC,GAAG,WAAW,KAAK,CAC5C,IAAG,aAAa,KAAK,KAAK;;WAGxB;;EAIX;CACF"}

package/dist/plugins/rsc-client-shim-excludes.d.ts

@@ -1,6 +1,7 @@
 //#region src/plugins/rsc-client-shim-excludes.d.ts
 declare const VINEXT_OPTIMIZE_DEPS_EXCLUDE: readonly string[];
+declare const SSR_EXTERNAL_REACT_ENTRIES: readonly string[];
 declare function mergeOptimizeDepsExclude(...excludeGroups: readonly (readonly string[])[]): string[];
 //#endregion
-export { VINEXT_OPTIMIZE_DEPS_EXCLUDE, mergeOptimizeDepsExclude };
+export { SSR_EXTERNAL_REACT_ENTRIES, VINEXT_OPTIMIZE_DEPS_EXCLUDE, mergeOptimizeDepsExclude };
 //# sourceMappingURL=rsc-client-shim-excludes.d.ts.map

package/dist/plugins/rsc-client-shim-excludes.js

@@ -14,6 +14,15 @@ const VINEXT_OPTIMIZE_DEPS_EXCLUDE = Object.freeze([
 	"private-next-instrumentation-client",
 	...RSC_CLIENT_SHIM_OPTIMIZE_DEPS_EXCLUDE
 ]);
+const SSR_EXTERNAL_REACT_ENTRIES = Object.freeze([
+	"react",
+	"react-dom",
+	"react-dom/server.edge",
+	"react-dom/static.edge",
+	"react/jsx-runtime",
+	"react/jsx-dev-runtime",
+	"react-server-dom-webpack/client.edge"
+]);
 function mergeOptimizeDepsExclude(...excludeGroups) {
 	const seen = /* @__PURE__ */ new Set();
 	for (const group of excludeGroups) for (const entry of group) {
@@ -23,6 +32,6 @@ function mergeOptimizeDepsExclude(...excludeGroups) {
 	return [...seen];
 }
 //#endregion
-export { VINEXT_OPTIMIZE_DEPS_EXCLUDE, mergeOptimizeDepsExclude };
+export { SSR_EXTERNAL_REACT_ENTRIES, VINEXT_OPTIMIZE_DEPS_EXCLUDE, mergeOptimizeDepsExclude };
 
 //# sourceMappingURL=rsc-client-shim-excludes.js.map

package/dist/plugins/rsc-client-shim-excludes.js.map

@@ -1 +1 @@
-{"version":3,"file":"rsc-client-shim-excludes.js","names":[],"sources":["../../src/plugins/rsc-client-shim-excludes.ts"],"sourcesContent":["const RSC_CLIENT_SHIM_OPTIMIZE_DEPS_EXCLUDE = Object.freeze([\n  // @vitejs/plugin-rsc tracks package client references by the original\n  // bare source. If Vite pre-bundles these known client shims, the generated\n  // client-package proxy can lose the matching export metadata in dev.\n  \"vinext/shims/error-boundary\",\n  \"vinext/shims/form\",\n  \"vinext/shims/layout-segment-context\",\n  \"vinext/shims/link\",\n  \"vinext/shims/script\",\n  \"vinext/shims/slot\",\n  \"vinext/shims/offline\",\n]);\n\nexport const VINEXT_OPTIMIZE_DEPS_EXCLUDE = Object.freeze([\n  \"vinext\",\n  \"@vercel/og\",\n  // Aliased to the user's instrumentation-client source file (or an empty\n  // shim). Not a real npm dep, so pre-bundling it would break HMR and cause\n  // a \"new dependencies optimized\" reload on the first request.\n  \"private-next-instrumentation-client\",\n  ...RSC_CLIENT_SHIM_OPTIMIZE_DEPS_EXCLUDE,\n]);\n\nexport function mergeOptimizeDepsExclude(\n  ...excludeGroups: readonly (readonly string[])[]\n): string[] {\n  const seen = new Set<string>();\n\n  for (const group of excludeGroups) {\n    for (const entry of group) {\n      if (seen.has(entry)) continue;\n      seen.add(entry);\n    }\n  }\n\n  return [...seen];\n}\n"],"mappings":";AAAA,MAAM,wCAAwC,OAAO,OAAO;CAI1D;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,MAAa,+BAA+B,OAAO,OAAO;CACxD;CACA;CAIA;CACA,GAAG;CACJ,CAAC;AAEF,SAAgB,yBACd,GAAG,eACO;CACV,MAAM,uBAAO,IAAI,KAAa;AAE9B,MAAK,MAAM,SAAS,cAClB,MAAK,MAAM,SAAS,OAAO;AACzB,MAAI,KAAK,IAAI,MAAM,CAAE;AACrB,OAAK,IAAI,MAAM;;AAInB,QAAO,CAAC,GAAG,KAAK"}
+{"version":3,"file":"rsc-client-shim-excludes.js","names":[],"sources":["../../src/plugins/rsc-client-shim-excludes.ts"],"sourcesContent":["const RSC_CLIENT_SHIM_OPTIMIZE_DEPS_EXCLUDE = Object.freeze([\n  // @vitejs/plugin-rsc tracks package client references by the original\n  // bare source. If Vite pre-bundles these known client shims, the generated\n  // client-package proxy can lose the matching export metadata in dev.\n  \"vinext/shims/error-boundary\",\n  \"vinext/shims/form\",\n  \"vinext/shims/layout-segment-context\",\n  \"vinext/shims/link\",\n  \"vinext/shims/script\",\n  \"vinext/shims/slot\",\n  \"vinext/shims/offline\",\n]);\n\nexport const VINEXT_OPTIMIZE_DEPS_EXCLUDE = Object.freeze([\n  \"vinext\",\n  \"@vercel/og\",\n  // Aliased to the user's instrumentation-client source file (or an empty\n  // shim). Not a real npm dep, so pre-bundling it would break HMR and cause\n  // a \"new dependencies optimized\" reload on the first request.\n  \"private-next-instrumentation-client\",\n  ...RSC_CLIENT_SHIM_OPTIMIZE_DEPS_EXCLUDE,\n]);\n\n// React entries that @vitejs/plugin-rsc adds to environments.ssr.optimizeDeps.include\n// via crawlFrameworkPkgs. When the user sets ssr.external: true, the SSR env loads\n// everything via Node's resolver (including React from /node_modules/react). If Vite\n// also pre-bundles React into deps_ssr/, two distinct React module records coexist:\n// react-dom-server.edge sets the dispatcher on its bundled React, but externalized\n// callers (vinext's runtime, and 'use client' modules going through the SSR transform)\n// see a different React → React.H is null → useContext / useSyncExternalStore crash.\n// Adding these to optimizeDeps.exclude keeps deps_ssr/ React-free so the runtime and\n// the renderer share a single Node-loaded React copy.\nexport const SSR_EXTERNAL_REACT_ENTRIES = Object.freeze([\n  \"react\",\n  \"react-dom\",\n  \"react-dom/server.edge\",\n  \"react-dom/static.edge\",\n  \"react/jsx-runtime\",\n  \"react/jsx-dev-runtime\",\n  \"react-server-dom-webpack/client.edge\",\n]);\n\nexport function mergeOptimizeDepsExclude(\n  ...excludeGroups: readonly (readonly string[])[]\n): string[] {\n  const seen = new Set<string>();\n\n  for (const group of excludeGroups) {\n    for (const entry of group) {\n      if (seen.has(entry)) continue;\n      seen.add(entry);\n    }\n  }\n\n  return [...seen];\n}\n"],"mappings":";AAAA,MAAM,wCAAwC,OAAO,OAAO;CAI1D;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,MAAa,+BAA+B,OAAO,OAAO;CACxD;CACA;CAIA;CACA,GAAG;CACJ,CAAC;AAWF,MAAa,6BAA6B,OAAO,OAAO;CACtD;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,SAAgB,yBACd,GAAG,eACO;CACV,MAAM,uBAAO,IAAI,KAAa;AAE9B,MAAK,MAAM,SAAS,cAClB,MAAK,MAAM,SAAS,OAAO;AACzB,MAAI,KAAK,IAAI,MAAM,CAAE;AACrB,OAAK,IAAI,MAAM;;AAInB,QAAO,CAAC,GAAG,KAAK"}

package/dist/routing/app-route-graph.d.ts

@@ -9,7 +9,8 @@ type InterceptingRoute = {
   params: string[];
 };
 type ParallelSlot = {
-  /** Stable slot identity (name + owning directory), used for route serialization keys. */key: string; /** Slot name (e.g. "team" from @team) */
+  /** Graph-owned semantic slot identity. Required on AppRouteGraphParallelSlot. */id?: string; /** Stable slot identity (name + owning directory), used for route serialization keys. */
+  key: string; /** Slot name (e.g. "team" from @team) */
   name: string; /** Absolute path to the @slot directory that owns this slot. Internal routing metadata. */
   ownerDir: string; /** Absolute path to the slot's page component */
   pagePath: string | null; /** Absolute path to the slot's default.tsx fallback */
@@ -47,7 +48,8 @@ type ParallelSlot = {
   slotParamNames?: string[];
 };
 type AppRoute = {
-  /** URL pattern, e.g. "/" or "/about" or "/blog/:slug" */pattern: string; /** Absolute file path to the page component */
+  /** Graph-owned semantic identities. Required on AppRouteGraphRoute. */ids?: AppRouteSemanticIds; /** URL pattern, e.g. "/" or "/about" or "/blog/:slug" */
+  pattern: string; /** Absolute file path to the page component */
   pagePath: string | null; /** Absolute file path to the route handler (route.ts) */
   routePath: string | null; /** Ordered list of layout files from root to leaf */
   layouts: string[]; /** Ordered list of all discovered template files from root to leaf (not necessarily aligned 1:1 with layouts) */
@@ -100,10 +102,94 @@ type AppRoute = {
   rootParamNames?: string[]; /** Pre-split pattern segments (computed once at scan time, reused per request) */
   patternParts: string[];
 };
+type AppRouteSemanticIds = {
+  route: string;
+  page: string | null;
+  routeHandler: string | null;
+  rootBoundary: RootBoundaryId | null;
+  layouts: readonly string[];
+  templates: readonly string[];
+  /**
+   * Bridge map for the current route metadata shape: keyed by `slot.key`
+   * (`name@relative/path` infrastructure id), value is the graph-owned semantic slot id.
+   */
+  slots: Readonly<Record<string, string>>;
+};
+type AppRouteGraphParallelSlot = ParallelSlot & {
+  id: string;
+};
+type AppRouteGraphRoute = Omit<AppRoute, "ids" | "parallelSlots" | "rootParamNames"> & {
+  ids: AppRouteSemanticIds;
+  parallelSlots: AppRouteGraphParallelSlot[];
+  rootParamNames: string[];
+};
+type Flavor<T, Brand extends string> = T & {
+  readonly __flavor?: Brand;
+};
+type GraphVersion = Flavor<string, "GraphVersion">;
+type RootBoundaryId = Flavor<string, "RootBoundaryId">;
+type RouteManifestRoute = {
+  id: string;
+  pattern: string;
+  patternParts: readonly string[];
+  isDynamic: boolean;
+  paramNames: readonly string[];
+  rootParamNames: readonly string[];
+  rootBoundaryId: RootBoundaryId | null;
+  pageId: string | null;
+  routeHandlerId: string | null;
+  layoutIds: readonly string[];
+  templateIds: readonly string[];
+  slotIds: readonly string[];
+};
+type RouteManifestPage = {
+  id: string;
+  routeId: string;
+  pattern: string;
+};
+type RouteManifestRouteHandler = {
+  id: string;
+  routeId: string;
+  pattern: string;
+};
+type RouteManifestLayout = {
+  id: string;
+  treePath: string;
+  rootBoundaryId: RootBoundaryId | null;
+};
+type RouteManifestTemplate = {
+  id: string;
+  treePath: string;
+  rootBoundaryId: RootBoundaryId | null;
+};
+type RouteManifestSlot = {
+  id: string;
+  key: string;
+  name: string;
+};
+type RouteManifestRootBoundary = {
+  id: RootBoundaryId;
+  layoutId: string;
+  treePath: string;
+};
+type StaticSegmentGraph = {
+  routes: ReadonlyMap<string, RouteManifestRoute>;
+  pages: ReadonlyMap<string, RouteManifestPage>;
+  routeHandlers: ReadonlyMap<string, RouteManifestRouteHandler>;
+  layouts: ReadonlyMap<string, RouteManifestLayout>;
+  templates: ReadonlyMap<string, RouteManifestTemplate>;
+  slots: ReadonlyMap<string, RouteManifestSlot>;
+  rootBoundaries: ReadonlyMap<RootBoundaryId, RouteManifestRootBoundary>;
+};
+type RouteManifest = {
+  graphVersion: GraphVersion;
+  segmentGraph: StaticSegmentGraph;
+};
 declare function buildAppRouteGraph(appDir: string, matcher: ValidFileMatcher): Promise<{
-  routes: AppRoute[];
+  routes: AppRouteGraphRoute[];
+  routeManifest: RouteManifest;
 }>;
 declare function computeRootParamNames(routeSegments: readonly string[], layoutTreePositions: readonly number[]): string[];
 //#endregion
-export { AppRoute, InterceptingRoute, ParallelSlot, buildAppRouteGraph, computeRootParamNames };
+export { AppRoute, AppRouteGraphParallelSlot, AppRouteGraphRoute, AppRouteSemanticIds, GraphVersion, InterceptingRoute, ParallelSlot, RootBoundaryId, RouteManifest, RouteManifestLayout, RouteManifestPage, RouteManifestRootBoundary, RouteManifestRoute, RouteManifestRouteHandler, RouteManifestSlot, RouteManifestTemplate, StaticSegmentGraph, buildAppRouteGraph, computeRootParamNames };
 //# sourceMappingURL=app-route-graph.d.ts.map

package/dist/routing/app-route-graph.js

@@ -3,6 +3,7 @@ import { scanWithExtensions } from "./file-matcher.js";
 import { validateRoutePatterns } from "./route-validation.js";
 import fs from "node:fs";
 import path from "node:path";
+import { createHash } from "node:crypto";
 //#region src/routing/app-route-graph.ts
 /**
 * App Router route graph construction.
@@ -10,6 +11,139 @@ import path from "node:path";
 * Scans app/ directories and materializes route metadata before the request-time
 * matcher consumes it. Keep request matching and cache ownership in app-router.ts.
 */
+function createAppRouteGraphRouteId(pattern) {
+	return `route:${pattern}`;
+}
+function createAppRouteGraphPageId(pattern) {
+	return `page:${pattern}`;
+}
+function createAppRouteGraphRouteHandlerId(pattern) {
+	return `route-handler:${pattern}`;
+}
+function createAppRouteGraphLayoutId(treePath) {
+	return `layout:${treePath}`;
+}
+function createAppRouteGraphTemplateId(treePath) {
+	return `template:${treePath}`;
+}
+function createAppRouteGraphSlotId(slotName, ownerTreePath) {
+	return `slot:${slotName}:${ownerTreePath}`;
+}
+function createAppRouteGraphRootBoundaryId(treePath) {
+	return `root-boundary:${treePath}`;
+}
+function compareStableStrings(left, right) {
+	if (left < right) return -1;
+	if (left > right) return 1;
+	return 0;
+}
+function sortedMapValues(map) {
+	return Array.from(map.entries()).sort(([left], [right]) => compareStableStrings(left, right)).map(([, value]) => value);
+}
+function createRouteManifest(routes) {
+	const segmentGraph = createStaticSegmentGraph(routes);
+	return {
+		graphVersion: createRouteManifestGraphVersion(segmentGraph),
+		segmentGraph
+	};
+}
+function createStaticSegmentGraph(routes) {
+	const routeEntries = /* @__PURE__ */ new Map();
+	const pages = /* @__PURE__ */ new Map();
+	const routeHandlers = /* @__PURE__ */ new Map();
+	const layouts = /* @__PURE__ */ new Map();
+	const templates = /* @__PURE__ */ new Map();
+	const slots = /* @__PURE__ */ new Map();
+	const rootBoundaries = /* @__PURE__ */ new Map();
+	for (const route of routes) {
+		routeEntries.set(route.ids.route, {
+			id: route.ids.route,
+			pattern: route.pattern,
+			patternParts: [...route.patternParts],
+			isDynamic: route.isDynamic,
+			paramNames: [...route.params],
+			rootParamNames: [...route.rootParamNames],
+			rootBoundaryId: route.ids.rootBoundary,
+			pageId: route.ids.page,
+			routeHandlerId: route.ids.routeHandler,
+			layoutIds: [...route.ids.layouts],
+			templateIds: [...route.ids.templates],
+			slotIds: route.parallelSlots.map((slot) => slot.id).sort(compareStableStrings)
+		});
+		if (route.ids.page) pages.set(route.ids.page, {
+			id: route.ids.page,
+			routeId: route.ids.route,
+			pattern: route.pattern
+		});
+		if (route.ids.routeHandler) routeHandlers.set(route.ids.routeHandler, {
+			id: route.ids.routeHandler,
+			routeId: route.ids.route,
+			pattern: route.pattern
+		});
+		for (const [index, layoutId] of route.ids.layouts.entries()) {
+			const treePosition = route.layoutTreePositions[index];
+			assertRouteManifestTreePosition("layout", route, layoutId, treePosition);
+			const treePath = createAppRouteGraphTreePath(route.routeSegments, treePosition);
+			const existingLayout = layouts.get(layoutId);
+			if (existingLayout) assertRouteManifestRootBoundary("layout", route, layoutId, existingLayout.rootBoundaryId);
+			layouts.set(layoutId, {
+				id: layoutId,
+				treePath,
+				rootBoundaryId: route.ids.rootBoundary
+			});
+			if (index === 0 && route.ids.rootBoundary) rootBoundaries.set(route.ids.rootBoundary, {
+				id: route.ids.rootBoundary,
+				layoutId,
+				treePath
+			});
+		}
+		for (const [index, templateId] of route.ids.templates.entries()) {
+			const treePosition = route.templateTreePositions?.[index];
+			assertRouteManifestTreePosition("template", route, templateId, treePosition);
+			const existingTemplate = templates.get(templateId);
+			if (existingTemplate) assertRouteManifestRootBoundary("template", route, templateId, existingTemplate.rootBoundaryId);
+			templates.set(templateId, {
+				id: templateId,
+				treePath: createAppRouteGraphTreePath(route.routeSegments, treePosition),
+				rootBoundaryId: route.ids.rootBoundary
+			});
+		}
+		for (const slot of route.parallelSlots) slots.set(slot.id, {
+			id: slot.id,
+			key: slot.key,
+			name: slot.name
+		});
+	}
+	return {
+		routes: routeEntries,
+		pages,
+		routeHandlers,
+		layouts,
+		templates,
+		slots,
+		rootBoundaries
+	};
+}
+function assertRouteManifestTreePosition(kind, route, id, treePosition) {
+	if (treePosition !== void 0) return;
+	throw new Error(`[vinext] App route graph invariant violated: missing ${kind} tree position for ${id} on ${route.pattern}`);
+}
+function assertRouteManifestRootBoundary(kind, route, id, existingRootBoundaryId) {
+	if (existingRootBoundaryId === route.ids.rootBoundary) return;
+	throw new Error(`[vinext] App route graph invariant violated: ${kind} ${id} is shared across root boundaries (${existingRootBoundaryId ?? "none"} and ${route.ids.rootBoundary ?? "none"}) on ${route.pattern}`);
+}
+function createRouteManifestGraphVersion(segmentGraph) {
+	const stableShape = {
+		routes: sortedMapValues(segmentGraph.routes),
+		pages: sortedMapValues(segmentGraph.pages),
+		routeHandlers: sortedMapValues(segmentGraph.routeHandlers),
+		layouts: sortedMapValues(segmentGraph.layouts),
+		templates: sortedMapValues(segmentGraph.templates),
+		slots: sortedMapValues(segmentGraph.slots),
+		rootBoundaries: sortedMapValues(segmentGraph.rootBoundaries)
+	};
+	return `graph:${createHash("sha256").update(JSON.stringify(stableShape)).digest("hex")}`;
+}
 async function buildAppRouteGraph(appDir, matcher) {
 	const routes = [];
 	const excludeDir = (name) => name.startsWith("@") || name.startsWith("_");
@@ -38,7 +172,10 @@ async function buildAppRouteGraph(appDir, matcher) {
 	validateRoutePatterns(routes.map((route) => route.pattern));
 	validateRoutePatterns([...new Set(routes.flatMap((route) => route.parallelSlots.flatMap((slot) => slot.interceptingRoutes.map((intercept) => intercept.targetPattern))))]);
 	routes.sort(compareRoutes);
-	return { routes };
+	return {
+		routes,
+		routeManifest: createRouteManifest(routes)
+	};
 }
 function hasParallelSlotDirectory(dir) {
 	try {
@@ -99,8 +236,9 @@ function discoverSlotSubRoutes(routes, matcher) {
 	};
 	for (const parentRoute of routes) {
 		if (parentRoute.parallelSlots.length === 0) continue;
-		if (!parentRoute.pagePath) continue;
-		const parentPageDir = path.dirname(parentRoute.pagePath);
+		const isLayoutOnlyUiRoute = !parentRoute.pagePath && !parentRoute.routePath && parentRoute.layouts.length > 0;
+		if (!parentRoute.pagePath && !isLayoutOnlyUiRoute) continue;
+		const parentPageDir = parentRoute.pagePath ? path.dirname(parentRoute.pagePath) : path.dirname(parentRoute.layouts[parentRoute.layouts.length - 1]);
 		const subPathMap = /* @__PURE__ */ new Map();
 		for (const slot of parentRoute.parallelSlots) {
 			if (path.dirname(slot.ownerDir) !== parentPageDir) continue;
@@ -131,7 +269,7 @@ function discoverSlotSubRoutes(routes, matcher) {
 		}
 		if (subPathMap.size === 0) continue;
 		const childrenDefault = findFile(parentPageDir, "default", matcher);
-		if (!childrenDefault) continue;
+		if (parentRoute.pagePath && !childrenDefault) continue;
 		for (const { rawSegments, converted: convertedSubRoute, slotPages } of subPathMap.values()) {
 			const { urlSegments: urlParts, params: subParams, isDynamic: subIsDynamic } = convertedSubRoute;
 			const subUrlPath = urlParts.join("/");
@@ -142,6 +280,8 @@ function discoverSlotSubRoutes(routes, matcher) {
 				applySlotSubPages(existingRoute, slotPages, rawSegments);
 				continue;
 			}
+			const syntheticParts = [...parentRoute.patternParts, ...urlParts];
+			if (Array.from(routesByPattern.values()).some((r) => patternsStructurallyEquivalent(r.patternParts, syntheticParts))) continue;
 			const subSlots = parentRoute.parallelSlots.map((slot) => {
 				const subPage = slotPages.get(slot.key);
 				return {
@@ -151,6 +291,15 @@ function discoverSlotSubRoutes(routes, matcher) {
 				};
 			});
 			const newRoute = {
+				ids: createAppRouteSemanticIds({
+					pattern,
+					pagePath: childrenDefault,
+					routePath: null,
+					routeSegments: [...parentRoute.routeSegments, ...rawSegments],
+					layoutTreePositions: parentRoute.layoutTreePositions,
+					templateTreePositions: parentRoute.templateTreePositions,
+					slots: subSlots
+				}),
 				pattern,
 				pagePath: childrenDefault,
 				routePath: null,
@@ -245,6 +394,15 @@ function directoryToAppRoute(dir, appDir, matcher, pagePath, routePath) {
 	const unauthorizedPaths = discoverBoundaryFilePerLayout(layouts, "unauthorized", matcher);
 	const parallelSlots = discoverInheritedParallelSlots(segments, appDir, routeDir, matcher);
 	return {
+		ids: createAppRouteSemanticIds({
+			pattern: pattern === "/" ? "/" : pattern,
+			pagePath,
+			routePath,
+			routeSegments: segments,
+			layoutTreePositions,
+			templateTreePositions,
+			slots: parallelSlots
+		}),
 		pattern: pattern === "/" ? "/" : pattern,
 		pagePath,
 		routePath,
@@ -285,6 +443,29 @@ function computeRootParamNames(routeSegments, layoutTreePositions) {
 	}
 	return names;
 }
+function resolveRootBoundaryId(routeSegments, layoutTreePositions) {
+	const rootLayoutPosition = layoutTreePositions[0];
+	if (rootLayoutPosition === void 0) return null;
+	return createAppRouteGraphRootBoundaryId(createAppRouteGraphTreePath(routeSegments, rootLayoutPosition));
+}
+function createAppRouteSemanticIds(input) {
+	const slots = {};
+	for (const slot of input.slots) slots[slot.key] = slot.id;
+	return {
+		route: createAppRouteGraphRouteId(input.pattern),
+		page: input.pagePath ? createAppRouteGraphPageId(input.pattern) : null,
+		routeHandler: input.routePath ? createAppRouteGraphRouteHandlerId(input.pattern) : null,
+		rootBoundary: resolveRootBoundaryId(input.routeSegments, input.layoutTreePositions),
+		layouts: input.layoutTreePositions.map((treePosition) => createAppRouteGraphLayoutId(createAppRouteGraphTreePath(input.routeSegments, treePosition))),
+		templates: (input.templateTreePositions ?? []).map((treePosition) => createAppRouteGraphTemplateId(createAppRouteGraphTreePath(input.routeSegments, treePosition))),
+		slots
+	};
+}
+function createAppRouteGraphTreePath(routeSegments, treePosition) {
+	const treePathSegments = routeSegments.slice(0, treePosition);
+	if (treePathSegments.length === 0) return "/";
+	return `/${treePathSegments.join("/")}`;
+}
 /**
 * Compute the tree position (directory depth from app root) for each layout.
 * Root layout = 0, a layout at app/blog/ = 1, app/blog/(group)/ = 2.
@@ -545,6 +726,22 @@ function scoreSlotPattern(urlSegments) {
 	return score;
 }
 /**
+* Map a pattern segment to the tree-node type used by Next.js' route
+* validator. Two segments are structurally equivalent iff they share the
+* same tree-node type.
+*/
+function segmentTreeNodeType(seg) {
+	if (!seg.startsWith(":")) return `literal:${seg}`;
+	if (seg.endsWith("*")) return "optionalCatchAll";
+	if (seg.endsWith("+")) return "catchAll";
+	return "dynamic";
+}
+function patternsStructurallyEquivalent(a, b) {
+	if (a.length !== b.length) return false;
+	for (let i = 0; i < a.length; i++) if (segmentTreeNodeType(a[i]) !== segmentTreeNodeType(b[i])) return false;
+	return true;
+}
+/**
 * Discover parallel route slots (@team, @analytics, etc.) in a directory.
 * Returns a ParallelSlot for each @-prefixed subdirectory that has a page or default component.
 */
@@ -560,7 +757,10 @@ function discoverParallelSlots(dir, appDir, matcher) {
 		const defaultPath = findFile(slotDir, "default", matcher);
 		const interceptingRoutes = discoverInterceptingRoutes(slotDir, dir, appDir, matcher);
 		if (!pagePath && !defaultPath && interceptingRoutes.length === 0) continue;
+		const ownerSegments = path.relative(appDir, dir).split(path.sep).filter((segment) => segment.length > 0);
+		const ownerTreePath = createAppRouteGraphTreePath(ownerSegments, ownerSegments.length);
 		slots.push({
+			id: createAppRouteGraphSlotId(slotName, ownerTreePath),
 			key: `${slotName}@${path.relative(appDir, slotDir).replace(/\\/g, "/")}`,
 			name: slotName,
 			ownerDir: slotDir,
@@ -774,24 +974,27 @@ function convertSegmentsToRouteParts(segments) {
 	for (let i = 0; i < segments.length; i++) {
 		const segment = segments[i];
 		if (isInvisibleSegment(segment)) continue;
-		const catchAllMatch = segment.match(/^\[\.\.\.([\w-]+)\]$/);
+		const catchAllMatch = segment.match(/^\[\.\.\.([^\]]+)\]$/);
 		if (catchAllMatch) {
 			if (hasRemainingVisibleSegments(segments, i + 1)) return null;
+			if (catchAllMatch[1].endsWith("+") || catchAllMatch[1].endsWith("*")) return null;
 			isDynamic = true;
 			params.push(catchAllMatch[1]);
 			urlSegments.push(`:${catchAllMatch[1]}+`);
 			continue;
 		}
-		const optionalCatchAllMatch = segment.match(/^\[\[\.\.\.([\w-]+)\]\]$/);
+		const optionalCatchAllMatch = segment.match(/^\[\[\.\.\.([^\]]+)\]\]$/);
 		if (optionalCatchAllMatch) {
 			if (hasRemainingVisibleSegments(segments, i + 1)) return null;
+			if (optionalCatchAllMatch[1].endsWith("+") || optionalCatchAllMatch[1].endsWith("*")) return null;
 			isDynamic = true;
 			params.push(optionalCatchAllMatch[1]);
 			urlSegments.push(`:${optionalCatchAllMatch[1]}*`);
 			continue;
 		}
-		const dynamicMatch = segment.match(/^\[([\w-]+)\]$/);
+		const dynamicMatch = segment.match(/^\[([^\]]+)\]$/);
 		if (dynamicMatch) {
+			if (dynamicMatch[1].endsWith("+") || dynamicMatch[1].endsWith("*")) return null;
 			isDynamic = true;
 			params.push(dynamicMatch[1]);
 			urlSegments.push(`:${dynamicMatch[1]}`);