vinext 0.0.55 → 0.1.0

package/dist/build/nitro-route-rules.d.ts

@@ -46,5 +46,4 @@ declare function mergeNitroRouteRules(existingRouteRules: Record<string, NitroRo
   skippedRoutes: string[];
 };
 //#endregion
-export { NitroRouteRuleConfig, collectNitroRouteRules, convertToNitroPattern, generateNitroRouteRules, mergeNitroRouteRules };
-//# sourceMappingURL=nitro-route-rules.d.ts.map
+export { NitroRouteRuleConfig, collectNitroRouteRules, convertToNitroPattern, generateNitroRouteRules, mergeNitroRouteRules };

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

@@ -77,5 +77,3 @@ function hasUserDefinedCacheRule(rule) {
 }
 //#endregion
 export { collectNitroRouteRules, convertToNitroPattern, generateNitroRouteRules, mergeNitroRouteRules };
-
-//# sourceMappingURL=nitro-route-rules.js.map

package/dist/build/precompress.d.ts

@@ -24,5 +24,4 @@ declare function precompressAssets(clientDir: string, options?: {
   onProgress?: (completed: number, total: number, file: string) => void;
 }): Promise<PrecompressResult>;
 //#endregion
-export { precompressAssets };
-//# sourceMappingURL=precompress.d.ts.map
+export { precompressAssets };

package/dist/build/precompress.js

@@ -108,5 +108,3 @@ async function precompressAssets(clientDir, options = {}) {
 }
 //#endregion
 export { precompressAssets };
-
-//# sourceMappingURL=precompress.js.map

package/dist/build/prerender.d.ts

@@ -1,6 +1,6 @@
+import { ResolvedNextConfig } from "../config/next-config.js";
 import { Route } from "../routing/pages-router.js";
 import { AppRoute } from "../routing/app-route-graph.js";
-import { ResolvedNextConfig } from "../config/next-config.js";
 import { MetadataFileRoute } from "../server/metadata-routes.js";
 import { readPrerenderSecret } from "./server-manifest.js";
 import { Server } from "node:http";
@@ -198,5 +198,4 @@ declare function writePrerenderIndex(routes: PrerenderRouteResult[], outDir: str
   trailingSlash?: boolean;
 }): void;
 //#endregion
-export { PrerenderResult, PrerenderRouteResult, StaticParamsMap, extractRscPayloadFromPrerenderedHtml, prerenderApp, prerenderPages, readPrerenderSecret, resolveParentParams, writePrerenderIndex };
-//# sourceMappingURL=prerender.d.ts.map
+export { PrerenderResult, PrerenderRouteResult, StaticParamsMap, extractRscPayloadFromPrerenderedHtml, prerenderApp, prerenderPages, readPrerenderSecret, resolveParentParams, writePrerenderIndex };

package/dist/build/prerender.js

@@ -11,6 +11,7 @@ import { encodePrerenderRouteParams, serializePrerenderRouteParamsHeader } from
 import { readPrerenderSecret } from "./server-manifest.js";
 import { getOutputPath, getRscOutputPath } from "../utils/prerender-output-paths.js";
 import { startProdServer } from "../server/prod-server.js";
+import { createAppPprFallbackShells } from "../server/app-ppr-fallback-shell.js";
 import fs from "node:fs";
 import path from "node:path";
 import os from "node:os";
@@ -629,9 +630,11 @@ async function prerenderApp({ routes, metadataRoutes = [], outDir, config, mode,
 					});
 					continue;
 				}
+				const queuedRouteUrls = /* @__PURE__ */ new Set();
 				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);
+					queuedRouteUrls.add(urlPath);
 					urlsToRender.push({
 						urlPath,
 						routePattern: route.pattern,
@@ -639,6 +642,17 @@ async function prerenderApp({ routes, metadataRoutes = [], outDir, config, mode,
 						revalidate,
 						isSpeculative: false
 					});
+					if (config.cacheComponents === true) for (const fallbackShell of createAppPprFallbackShells(route, params)) {
+						if (queuedRouteUrls.has(fallbackShell.pathname)) continue;
+						queuedRouteUrls.add(fallbackShell.pathname);
+						urlsToRender.push({
+							urlPath: fallbackShell.pathname,
+							routePattern: route.pattern,
+							prerenderRouteParams: encodePrerenderRouteParams(route.pattern, fallbackShell.params, fallbackShell.fallbackParamNames),
+							revalidate,
+							isSpeculative: false
+						});
+					}
 				}
 			} catch (e) {
 				const err = e;
@@ -886,5 +900,3 @@ function writePrerenderIndex(routes, outDir, options) {
 }
 //#endregion
 export { extractRscPayloadFromPrerenderedHtml, prerenderApp, prerenderPages, readPrerenderSecret, resolveParentParams, writePrerenderIndex };
-
-//# sourceMappingURL=prerender.js.map

package/dist/build/report.d.ts

@@ -130,5 +130,4 @@ declare function printBuildReport(options: {
   prerenderResult?: PrerenderResult;
 }): Promise<void>;
 //#endregion
-export { RouteRow, RouteType, buildReportRows, classifyAppRoute, classifyLayoutSegmentConfig, classifyPagesRoute, extractExportConstNumber, extractExportConstString, extractGetStaticPropsRevalidate, findDir, formatBuildReport, getAppRouteRenderEntryPath, hasNamedExport, printBuildReport };
-//# sourceMappingURL=report.d.ts.map
+export { RouteRow, RouteType, buildReportRows, classifyAppRoute, classifyLayoutSegmentConfig, classifyPagesRoute, extractExportConstNumber, extractExportConstString, extractGetStaticPropsRevalidate, findDir, formatBuildReport, getAppRouteRenderEntryPath, hasNamedExport, printBuildReport };

package/dist/build/report.js

@@ -511,5 +511,3 @@ async function printBuildReport(options) {
 }
 //#endregion
 export { buildReportRows, classifyAppRoute, classifyLayoutSegmentConfig, classifyPagesRoute, extractExportConstNumber, extractExportConstString, extractGetStaticPropsRevalidate, findDir, formatBuildReport, getAppRouteRenderEntryPath, hasNamedExport, printBuildReport };
-
-//# sourceMappingURL=report.js.map

package/dist/build/route-classification-injector.d.ts

@@ -31,5 +31,4 @@ type PlanRouteClassificationInjectionOptions = {
 };
 declare function planRouteClassificationInjection(options: PlanRouteClassificationInjectionOptions): RouteClassificationInjectionPlan;
 //#endregion
-export { RouteClassificationChunk, planRouteClassificationInjection };
-//# sourceMappingURL=route-classification-injector.d.ts.map
+export { planRouteClassificationInjection };

package/dist/build/route-classification-injector.js

@@ -1,4 +1,4 @@
-import { buildGenerateBundleReplacement, buildReasonsReplacement } from "./route-classification-manifest.js";
+import { buildClassificationReplacement, buildReasonsReplacement } from "./route-classification-manifest.js";
 import { classifyLayoutByModuleGraph, isStaticModuleGraphResult, moduleGraphReason } from "./layout-classification.js";
 //#region src/build/route-classification-injector.ts
 const CLASS_STUB_RE = /function __VINEXT_CLASS\(routeIdx\)\s*\{\s*return null;?\s*\}/;
@@ -11,7 +11,7 @@ function findClassificationChunk(chunks) {
 	const chunksWithStubBody = chunksMentioningStub.filter((chunk) => CLASS_STUB_RE.test(chunk.code));
 	const chunkWithStubBody = chunksWithStubBody[0];
 	if (chunksMentioningStub.length === 0) return null;
-	if (chunkWithStubBody === void 0) throw new Error(`vinext: build-time classification — __VINEXT_CLASS is referenced in ${chunksMentioningStub.map((chunk) => chunk.fileName).join(", ")} but no chunk contains the stub body. The generator and generateBundle have drifted.`);
+	if (chunkWithStubBody === void 0) throw new Error(`vinext: build-time classification — __VINEXT_CLASS is referenced in ${chunksMentioningStub.map((chunk) => chunk.fileName).join(", ")} but no chunk contains the stub body. The generator and the classification injector have drifted.`);
 	if (chunksWithStubBody.length > 1) throw new Error(`vinext: build-time classification — expected __VINEXT_CLASS stub in exactly one RSC chunk, found ${chunksWithStubBody.length}`);
 	return chunkWithStubBody;
 }
@@ -40,9 +40,9 @@ function buildLayer2Classifications(options) {
 function planRouteClassificationInjection(options) {
 	const target = findClassificationChunk(options.chunks);
 	if (!target) return { kind: "skip" };
-	if (options.enableDebugReasons && !REASONS_STUB_RE.test(target.code)) throw new Error("vinext: build-time classification — __VINEXT_CLASS_REASONS stub is missing alongside __VINEXT_CLASS. The generator and generateBundle have drifted.");
+	if (options.enableDebugReasons && !REASONS_STUB_RE.test(target.code)) throw new Error("vinext: build-time classification — __VINEXT_CLASS_REASONS stub is missing alongside __VINEXT_CLASS. The generator and the classification injector have drifted.");
 	const layer2PerRoute = buildLayer2Classifications(options);
-	const patchedBody = `function __VINEXT_CLASS(routeIdx) { return (${buildGenerateBundleReplacement(options.manifest, layer2PerRoute)})(routeIdx); }`;
+	const patchedBody = `function __VINEXT_CLASS(routeIdx) { return (${buildClassificationReplacement(options.manifest, layer2PerRoute)})(routeIdx); }`;
 	let code = target.code.replace(CLASS_STUB_RE, patchedBody);
 	if (options.enableDebugReasons) {
 		const patchedReasonsBody = `function __VINEXT_CLASS_REASONS(routeIdx) { return (${buildReasonsReplacement(options.manifest, layer2PerRoute)})(routeIdx); }`;
@@ -57,5 +57,3 @@ function planRouteClassificationInjection(options) {
 }
 //#endregion
 export { planRouteClassificationInjection };
-
-//# sourceMappingURL=route-classification-injector.js.map

package/dist/build/route-classification-manifest.d.ts

@@ -28,26 +28,25 @@ declare function collectRouteClassificationManifest(routes: readonly AppRoute[])
  * Builds a JavaScript arrow-function expression that dispatches route index
  * to a pre-computed `Map<layoutIndex, "static" | "dynamic">` of build-time
  * classifications. The returned string is suitable for embedding into the
- * generated RSC entry via `generateBundle`.
+ * generated RSC entry via the `renderChunk` hook.
  *
  * `layer2PerRoute` is typed to only carry `"static"` entries — the
  * module-graph classifier can only prove static, so "needs-probe" results
  * are omitted by the caller before this map is constructed.
  */
-declare function buildGenerateBundleReplacement(manifest: RouteClassificationManifest, layer2PerRoute: ReadonlyMap<number, ReadonlyMap<number, ModuleGraphStaticReason>>): string;
+declare function buildClassificationReplacement(manifest: RouteClassificationManifest, layer2PerRoute: ReadonlyMap<number, ReadonlyMap<number, ModuleGraphStaticReason>>): string;
 /**
- * Sibling of `buildGenerateBundleReplacement`: emits a dispatch function
+ * Sibling of `buildClassificationReplacement`: emits a dispatch function
  * that returns `Map<layoutIndex, ClassificationReason>` per route.
  *
  * The runtime consults this map only when `VINEXT_DEBUG_CLASSIFICATION` is
  * set, and the plugin only patches this dispatcher into the built bundle when
  * that env var is present at build time.
  *
- * Layer 1 priority applies the same way as in `buildGenerateBundleReplacement`:
+ * Layer 1 priority applies the same way as in `buildClassificationReplacement`:
  * a segment-config reason must override a module-graph reason for the same
  * layout index.
  */
 declare function buildReasonsReplacement(manifest: RouteClassificationManifest, layer2PerRoute: ReadonlyMap<number, ReadonlyMap<number, ModuleGraphStaticReason>>): string;
 //#endregion
-export { Layer1Class, RouteClassificationManifest, RouteManifestEntry, buildGenerateBundleReplacement, buildReasonsReplacement, collectRouteClassificationManifest };
-//# sourceMappingURL=route-classification-manifest.d.ts.map
+export { RouteClassificationManifest, buildClassificationReplacement, buildReasonsReplacement, collectRouteClassificationManifest };

package/dist/build/route-classification-manifest.js

@@ -115,24 +115,24 @@ function buildRouteDispatchReplacement(manifest, layer2PerRoute, serializeEntry)
 * Builds a JavaScript arrow-function expression that dispatches route index
 * to a pre-computed `Map<layoutIndex, "static" | "dynamic">` of build-time
 * classifications. The returned string is suitable for embedding into the
-* generated RSC entry via `generateBundle`.
+* generated RSC entry via the `renderChunk` hook.
 *
 * `layer2PerRoute` is typed to only carry `"static"` entries — the
 * module-graph classifier can only prove static, so "needs-probe" results
 * are omitted by the caller before this map is constructed.
 */
-function buildGenerateBundleReplacement(manifest, layer2PerRoute) {
+function buildClassificationReplacement(manifest, layer2PerRoute) {
 	return buildRouteDispatchReplacement(manifest, layer2PerRoute, (value) => JSON.stringify(value.kind));
 }
 /**
-* Sibling of `buildGenerateBundleReplacement`: emits a dispatch function
+* Sibling of `buildClassificationReplacement`: emits a dispatch function
 * that returns `Map<layoutIndex, ClassificationReason>` per route.
 *
 * The runtime consults this map only when `VINEXT_DEBUG_CLASSIFICATION` is
 * set, and the plugin only patches this dispatcher into the built bundle when
 * that env var is present at build time.
 *
-* Layer 1 priority applies the same way as in `buildGenerateBundleReplacement`:
+* Layer 1 priority applies the same way as in `buildClassificationReplacement`:
 * a segment-config reason must override a module-graph reason for the same
 * layout index.
 */
@@ -140,6 +140,4 @@ function buildReasonsReplacement(manifest, layer2PerRoute) {
 	return buildRouteDispatchReplacement(manifest, layer2PerRoute, (value) => serializeReasonExpression(value.reason));
 }
 //#endregion
-export { buildGenerateBundleReplacement, buildReasonsReplacement, collectRouteClassificationManifest };
-
-//# sourceMappingURL=route-classification-manifest.js.map
+export { buildClassificationReplacement, buildReasonsReplacement, collectRouteClassificationManifest };

package/dist/build/run-prerender.d.ts

@@ -50,5 +50,4 @@ type RunPrerenderOptions = {
  */
 declare function runPrerender(options: RunPrerenderOptions): Promise<PrerenderResult | null>;
 //#endregion
-export { runPrerender };
-//# sourceMappingURL=run-prerender.d.ts.map
+export { runPrerender };

package/dist/build/run-prerender.js

@@ -41,8 +41,7 @@ var PrerenderProgress = class {
 		if (!this.isTTY) return;
 		const pct = total > 0 ? Math.floor(completed / total * 100) : 0;
 		const bar = `[${"█".repeat(Math.floor(pct / 5))}${" ".repeat(20 - Math.floor(pct / 5))}]`;
-		const maxRoute = 40;
-		const routeLabel = route.length > maxRoute ? "…" + route.slice(-(maxRoute - 1)) : route;
+		const routeLabel = route.length > 40 ? "…" + route.slice(-39) : route;
 		const line = `Prerendering routes... ${bar} ${String(completed).padStart(String(total).length)}/${total} ${routeLabel}`;
 		const padded = line.padEnd(this.lastLineLen);
 		this.lastLineLen = line.length;
@@ -54,6 +53,15 @@ var PrerenderProgress = class {
 		console.log(`  Prerendered ${rendered} routes (${skipped} skipped${errorPart}).`);
 	}
 };
+function readBuiltBuildId(serverDir) {
+	try {
+		const buildId = fs.readFileSync(path.join(serverDir, "BUILD_ID"), "utf-8").trim();
+		return buildId.length > 0 ? buildId : null;
+	} catch (error) {
+		if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") return null;
+		throw error;
+	}
+}
 /**
 * Run the prerender phase using pre-built production bundles.
 *
@@ -82,11 +90,15 @@ async function runPrerender(options) {
 	const previousPrerenderFlag = process.env.VINEXT_PRERENDER;
 	process.env.VINEXT_PRERENDER = "1";
 	const manifestDir = path.join(root, "dist", "server");
+	const rscBundlePath = options.rscBundlePath ?? path.join(root, "dist", "server", "index.js");
+	const serverDir = path.dirname(rscBundlePath);
 	const loadedConfig = await resolveNextConfig(await loadNextConfig(root), root);
 	const config = options.nextConfigOverride ? {
 		...loadedConfig,
 		...options.nextConfigOverride
-	} : loadedConfig;
+	} : { ...loadedConfig };
+	const builtBuildId = readBuiltBuildId(serverDir);
+	if (builtBuildId) config.buildId = builtBuildId;
 	const mode = config.output === "export" ? "export" : "default";
 	const allRoutes = [];
 	const allOutputFiles = [];
@@ -94,8 +106,6 @@ async function runPrerender(options) {
 	let completedUrls = 0;
 	const progress = new PrerenderProgress();
 	const outDir = mode === "export" ? path.join(root, "dist", "client") : path.join(root, "dist", "server", "prerendered-routes");
-	const rscBundlePath = options.rscBundlePath ?? path.join(root, "dist", "server", "index.js");
-	const serverDir = path.dirname(rscBundlePath);
 	let sharedProdServer = null;
 	let sharedPrerenderSecret;
 	try {
@@ -198,5 +208,3 @@ async function runPrerender(options) {
 }
 //#endregion
 export { runPrerender };
-
-//# sourceMappingURL=run-prerender.js.map

package/dist/build/server-manifest.d.ts

@@ -15,5 +15,4 @@
  */
 declare function readPrerenderSecret(serverDir: string): string | undefined;
 //#endregion
-export { readPrerenderSecret };
-//# sourceMappingURL=server-manifest.d.ts.map
+export { readPrerenderSecret };

package/dist/build/server-manifest.js

@@ -20,5 +20,3 @@ function readPrerenderSecret(serverDir) {
 }
 //#endregion
 export { readPrerenderSecret };
-
-//# sourceMappingURL=server-manifest.js.map

package/dist/build/ssr-manifest.d.ts

@@ -15,5 +15,4 @@ declare function augmentSsrManifestFromBundle(ssrManifest: Record<string, string
   type: string;
 }>, root: string, base?: string): Record<string, string[]>;
 //#endregion
-export { BundleBackfillChunk, augmentSsrManifestFromBundle, relativeWithinRoot, tryRealpathSync };
-//# sourceMappingURL=ssr-manifest.d.ts.map
+export { BundleBackfillChunk, augmentSsrManifestFromBundle, relativeWithinRoot, tryRealpathSync };

package/dist/build/ssr-manifest.js

@@ -1,4 +1,4 @@
-import { manifestFileWithBase, normalizeManifestFile } from "../utils/manifest-paths.js";
+import { collapseDuplicateBase, manifestFileWithBase } from "../utils/manifest-paths.js";
 import fs from "node:fs";
 import path from "node:path";
 //#region src/build/ssr-manifest.ts
@@ -45,7 +45,7 @@ function augmentSsrManifestFromBundle(ssrManifest, bundle, root, base = "/") {
 	for (const [key, files] of Object.entries(ssrManifest)) {
 		const normalizedKey = normalizeManifestModuleId(key, root);
 		if (!nextManifest[normalizedKey]) nextManifest[normalizedKey] = /* @__PURE__ */ new Set();
-		for (const file of files) nextManifest[normalizedKey].add(normalizeManifestFile(file));
+		for (const file of files) nextManifest[normalizedKey].add(collapseDuplicateBase(file, base));
 	}
 	for (const item of Object.values(bundle)) {
 		if (item.type !== "chunk") continue;
@@ -67,5 +67,3 @@ function augmentSsrManifestFromBundle(ssrManifest, bundle, root, base = "/") {
 }
 //#endregion
 export { augmentSsrManifestFromBundle, relativeWithinRoot, tryRealpathSync };
-
-//# sourceMappingURL=ssr-manifest.js.map

package/dist/build/standalone.d.ts

@@ -28,5 +28,4 @@ type StandaloneBuildResult = {
  */
 declare function emitStandaloneOutput(options: StandaloneBuildOptions): StandaloneBuildResult;
 //#endregion
-export { emitStandaloneOutput };
-//# sourceMappingURL=standalone.d.ts.map
+export { emitStandaloneOutput };

package/dist/build/standalone.js

@@ -201,5 +201,3 @@ function emitStandaloneOutput(options) {
 }
 //#endregion
 export { emitStandaloneOutput };
-
-//# sourceMappingURL=standalone.js.map

package/dist/build/static-export.d.ts

@@ -1,6 +1,6 @@
+import { ResolvedNextConfig } from "../config/next-config.js";
 import { Route } from "../routing/pages-router.js";
 import { AppRoute } from "../routing/app-route-graph.js";
-import { ResolvedNextConfig } from "../config/next-config.js";
 
 //#region src/build/static-export.d.ts
 type StaticExportOptions = {
@@ -52,5 +52,4 @@ type AppStaticExportOptions = {
  */
 declare function staticExportApp(options: AppStaticExportOptions): Promise<StaticExportResult>;
 //#endregion
-export { AppStaticExportOptions, StaticExportOptions, StaticExportResult, staticExportApp, staticExportPages };
-//# sourceMappingURL=static-export.d.ts.map
+export { AppStaticExportOptions, StaticExportOptions, StaticExportResult, staticExportApp, staticExportPages };

package/dist/build/static-export.js

@@ -58,5 +58,3 @@ async function staticExportApp(options) {
 }
 //#endregion
 export { staticExportApp, staticExportPages };
-
-//# sourceMappingURL=static-export.js.map

package/dist/cache/cache-adapters-virtual.d.ts

@@ -0,0 +1,50 @@
+//#region src/cache/cache-adapters-virtual.d.ts
+/**
+ * Code generation for the `virtual:vinext-cache-adapters` module, resolved by
+ * the vinext vite plugin from the user's `cache` config ({@link VinextCacheConfig}).
+ *
+ * The generated module exports `registerConfiguredCacheAdapters(env)`, which the
+ * server entries call on each request. It self-guards (adapters instantiate once
+ * per isolate) and is a no-op when nothing is configured. Registration is
+ * resilient: a factory that throws (e.g. a KV adapter on the Node.js server,
+ * where the binding can't exist) is logged and skipped rather than failing every
+ * request, so the same config can be registered from every runtime/router entry.
+ *
+ * Descriptor `options` are inlined into the generated module and forwarded to the
+ * factory at runtime, so a config-time builder like `kvDataAdapter({ binding })`
+ * never touches the Workers runtime — instantiation is deferred to the first
+ * request.
+ */
+/**
+ * A serializable pointer to a cache adapter module — the shape of each `cache`
+ * slot in the vinext() plugin config. Produced by an adapter builder (e.g.
+ * `kvDataAdapter(...)` from `@vinext/cloudflare/cache/kv-data-adapter`) or written
+ * by hand. `options` must be JSON-serializable: it is inlined into the generated
+ * registration module and forwarded to the adapter factory at runtime.
+ */
+type CacheAdapterDescriptor<O extends Record<string, unknown> = Record<string, unknown>> = {
+  /**
+   * Module specifier (or absolute path, e.g. from `require.resolve(...)`) whose
+   * default export is a cache adapter factory.
+   */
+  adapter: string; /** JSON-serializable options forwarded to the factory at runtime. */
+  options?: O;
+};
+/**
+ * The `cache` option of the vinext() plugin: declaratively register cache
+ * handlers instead of calling `setDataCacheHandler()` / `setCdnCacheAdapter()`
+ * from a worker entry.
+ */
+type VinextCacheConfig = {
+  /** Page-level ISR serving strategy (CDN cache adapter). */cdn?: CacheAdapterDescriptor; /** Data cache (fetch / `"use cache"` / `unstable_cache`) handler. */
+  data?: CacheAdapterDescriptor;
+};
+/** Public virtual module id imported by the server entries. */
+declare const VIRTUAL_CACHE_ADAPTERS = "virtual:vinext-cache-adapters";
+/**
+ * Generate the source of the `virtual:vinext-cache-adapters` module for the
+ * given config. Always exports `registerConfiguredCacheAdapters(env)`.
+ */
+declare function generateCacheAdaptersModule(cache?: VinextCacheConfig): string;
+//#endregion
+export { VIRTUAL_CACHE_ADAPTERS, VinextCacheConfig, generateCacheAdaptersModule };

package/dist/cache/cache-adapters-virtual.js

@@ -0,0 +1,45 @@
+//#region src/cache/cache-adapters-virtual.ts
+/** Public virtual module id imported by the server entries. */
+const VIRTUAL_CACHE_ADAPTERS = "virtual:vinext-cache-adapters";
+/**
+* Serialize descriptor options into a JS expression for inlining. Plain JSON is
+* a valid JS literal; `undefined` when there are no options. Throws a clear
+* config-time error (not a runtime one) if options are not serializable.
+*/
+function inlineOptions(adapter, options) {
+	if (options === void 0) return "undefined";
+	try {
+		return JSON.stringify(options);
+	} catch (cause) {
+		throw new Error(`[vinext] cache adapter "${adapter}" options must be JSON-serializable.`, { cause });
+	}
+}
+/**
+* Generate the source of the `virtual:vinext-cache-adapters` module for the
+* given config. Always exports `registerConfiguredCacheAdapters(env)`.
+*/
+function generateCacheAdaptersModule(cache) {
+	const data = cache?.data;
+	const cdn = cache?.cdn;
+	if (!data?.adapter && !cdn?.adapter) return [
+		"// vinext: no cache.cdn/cache.data adapter configured — registration is a no-op.",
+		"export function registerConfiguredCacheAdapters() {}",
+		""
+	].join("\n");
+	const lines = ["// vinext: generated from the `cache` option in your vinext() plugin config."];
+	if (data?.adapter) {
+		lines.push(`import __vinextDataAdapterFactory from ${JSON.stringify(data.adapter)};`);
+		lines.push(`import { setDataCacheHandler } from "vinext/shims/cache";`);
+	}
+	if (cdn?.adapter) {
+		lines.push(`import __vinextCdnAdapterFactory from ${JSON.stringify(cdn.adapter)};`);
+		lines.push(`import { setCdnCacheAdapter } from "vinext/shims/cdn-cache";`);
+	}
+	lines.push("", "// A factory that throws (e.g. a missing binding on an incompatible runtime)", "// is logged and skipped so the default handler stays in place.", "let __vinextCacheAdaptersRegistered = false;", "", "export function registerConfiguredCacheAdapters(env) {", "  if (__vinextCacheAdaptersRegistered) return;", "  __vinextCacheAdaptersRegistered = true;");
+	if (data?.adapter) lines.push("  try {", `    setDataCacheHandler(__vinextDataAdapterFactory({ env, options: ${inlineOptions(data.adapter, data.options)} }));`, "  } catch (error) {", "    console.warn(\"[vinext] failed to initialize the configured data cache adapter; using the default handler.\", error);", "  }");
+	if (cdn?.adapter) lines.push("  try {", `    setCdnCacheAdapter(__vinextCdnAdapterFactory({ env, options: ${inlineOptions(cdn.adapter, cdn.options)} }));`, "  } catch (error) {", "    console.warn(\"[vinext] failed to initialize the configured CDN cache adapter; using the default adapter.\", error);", "  }");
+	lines.push("}", "");
+	return lines.join("\n");
+}
+//#endregion
+export { VIRTUAL_CACHE_ADAPTERS, generateCacheAdaptersModule };

package/dist/check.d.ts

@@ -25,6 +25,38 @@ type CheckResult = {
     score: number;
   };
 };
+/**
+ * Report whether `content` makes a free use of the CommonJS globals `__dirname` or
+ * `__filename` in real code — i.e. not inside a string literal, comment, regex
+ * literal, or plain template literal. Identifiers inside a template expression
+ * (`` `${__dirname}` ``) DO count, since that is real code.
+ *
+ * This is a hand-written single-pass scanner rather than a regex on purpose. The
+ * previous implementation used an alternation regex whose string-body sub-pattern
+ * `(?:[^"\\]|\\.)*` is a star over an alternation group; V8 cannot compile that into
+ * a tight loop, so it pushes one backtrack frame per character and overflows the
+ * regex stack ("Maximum call stack size exceeded") on very large files — e.g. a
+ * multi-megabyte minified bundle or a long/unterminated string literal. This scanner
+ * runs in O(n) time and O(template-nesting) stack, so it cannot blow up on large input.
+ *
+ * It is a lexer-grade scanner, not a parser: it tracks just enough state (string /
+ * template / comment / regex contexts, and whether a `/` is in expression position)
+ * to avoid mistaking quotes inside one context for the start of another. Where the
+ * division-vs-regex distinction is ambiguous it biases toward division, because a
+ * misread division is usually harmless (it never consumes a following identifier)
+ * whereas a misread regex would swallow the rest of the line and could hide a later
+ * __dirname.
+ *
+ * Known limitation: telling a value-position regex literal apart from division after
+ * a `}` needs real parser context (was the `}` a block or an object?). We bias to
+ * division, so a regex used in value position — e.g. a statement-start regex after a
+ * block `}`, like `function f(){} /'/.test(x)` — is read as division; if its body
+ * contains an unpaired quote/backtick, that quote opens a string that can mask a
+ * __dirname *on the same line*. This is rare in hand-written source, the multi-line
+ * case is unaffected (string scanning stops at the newline), and the check is only
+ * advisory — so we accept it rather than pull in a full parser.
+ */
+declare function hasFreeCjsGlobal(content: string): boolean;
 /**
  * Scan source files for `import ... from 'next/...'` statements.
  */
@@ -52,5 +84,4 @@ declare function formatReport(result: CheckResult, opts?: {
   calledFromInit?: boolean;
 }): string;
 //#endregion
-export { CheckResult, analyzeConfig, checkConventions, checkLibraries, formatReport, runCheck, scanImports };
-//# sourceMappingURL=check.d.ts.map
+export { CheckResult, analyzeConfig, checkConventions, checkLibraries, formatReport, hasFreeCjsGlobal, runCheck, scanImports };