vinext 0.0.37 → 0.0.39

package/dist/shims/unified-request-context.d.ts

@@ -15,10 +15,10 @@ import { NavigationState } from "./navigation-state.js";
  *
  * Each field group is documented with its source shim module.
  */
-interface UnifiedRequestContext extends VinextHeadersShimState, I18nState, NavigationState, CacheState, PrivateCacheState, FetchCacheState, RouterState, HeadState {
-  /** Cloudflare Workers ExecutionContext, or null on Node.js dev. */
-  executionContext: ExecutionContextLike | null;
-}
+type UnifiedRequestContext = {
+  /** Cloudflare Workers ExecutionContext, or null on Node.js dev. */executionContext: ExecutionContextLike | null; /** Per-request cache for cacheForRequest(). Keyed by factory function reference. */
+  requestCache: WeakMap<(...args: any[]) => any, unknown>;
+} & VinextHeadersShimState & I18nState & NavigationState & CacheState & PrivateCacheState & FetchCacheState & RouterState & HeadState;
 /**
  * Create a fresh `UnifiedRequestContext` with defaults for all fields.
  * Pass partial overrides for the fields you need to pre-populate.

package/dist/shims/unified-request-context.js

@@ -38,6 +38,7 @@ function createRequestContext(opts) {
 		_privateCache: null,
 		currentRequestTags: [],
 		executionContext: _getInheritedExecutionContext(),
+		requestCache: /* @__PURE__ */ new WeakMap(),
 		ssrContext: null,
 		ssrHeadChildren: [],
 		...opts

package/dist/shims/unified-request-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"unified-request-context.js","names":[],"sources":["../../src/shims/unified-request-context.ts"],"sourcesContent":["/**\n * Unified per-request context backed by a single AsyncLocalStorage.\n *\n * Consolidates the 5–6 nested ALS scopes that previously wrapped every\n * App Router request (headers, navigation, cache-state, private-cache,\n * fetch-cache, execution-context) into one flat store.\n *\n * Each shim module checks `isInsideUnifiedScope()` and reads its sub-fields\n * from the unified store, falling back to its own standalone ALS when\n * outside (SSR environment, Pages Router, tests).\n */\n\nimport { AsyncLocalStorage } from \"node:async_hooks\";\nimport type {\n  CacheState,\n  ExecutionContextLike,\n  FetchCacheState,\n  HeadState,\n  I18nState,\n  NavigationState,\n  PrivateCacheState,\n  RouterState,\n  VinextHeadersShimState,\n} from \"./request-state-types.js\";\n\n// ---------------------------------------------------------------------------\n// Unified context shape\n// ---------------------------------------------------------------------------\n\n/**\n * Flat union of all per-request state previously spread across\n * VinextHeadersShimState, NavigationState, CacheState, PrivateCacheState,\n * FetchCacheState, and ExecutionContextLike.\n *\n * Each field group is documented with its source shim module.\n */\nexport interface UnifiedRequestContext\n  extends\n    VinextHeadersShimState,\n    I18nState,\n    NavigationState,\n    CacheState,\n    PrivateCacheState,\n    FetchCacheState,\n    RouterState,\n    HeadState {\n  // ── request-context.ts ─────────────────────────────────────────────\n  /** Cloudflare Workers ExecutionContext, or null on Node.js dev. */\n  executionContext: ExecutionContextLike | null;\n}\n\n// ---------------------------------------------------------------------------\n// ALS setup — stored on globalThis via Symbol.for so all Vite environments\n// (RSC/SSR/client) share the same instance.\n// ---------------------------------------------------------------------------\n\nconst _ALS_KEY = Symbol.for(\"vinext.unifiedRequestContext.als\");\nconst _REQUEST_CONTEXT_ALS_KEY = Symbol.for(\"vinext.requestContext.als\");\nconst _g = globalThis as unknown as Record<PropertyKey, unknown>;\nconst _als = (_g[_ALS_KEY] ??=\n  new AsyncLocalStorage<UnifiedRequestContext>()) as AsyncLocalStorage<UnifiedRequestContext>;\n\nfunction _getInheritedExecutionContext(): ExecutionContextLike | null {\n  const unifiedStore = _als.getStore();\n  if (unifiedStore) return unifiedStore.executionContext;\n\n  const executionContextAls = _g[_REQUEST_CONTEXT_ALS_KEY] as\n    | AsyncLocalStorage<ExecutionContextLike | null>\n    | undefined;\n  return executionContextAls?.getStore() ?? null;\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Create a fresh `UnifiedRequestContext` with defaults for all fields.\n * Pass partial overrides for the fields you need to pre-populate.\n */\nexport function createRequestContext(opts?: Partial<UnifiedRequestContext>): UnifiedRequestContext {\n  return {\n    headersContext: null,\n    dynamicUsageDetected: false,\n    pendingSetCookies: [],\n    draftModeCookieHeader: null,\n    phase: \"render\",\n    i18nContext: null,\n    serverContext: null,\n    serverInsertedHTMLCallbacks: [],\n    requestScopedCacheLife: null,\n    _privateCache: null,\n    currentRequestTags: [],\n    executionContext: _getInheritedExecutionContext(), // inherits from standalone ALS if present\n    ssrContext: null,\n    ssrHeadChildren: [],\n    ...opts,\n  };\n}\n\n/**\n * Run `fn` within a unified request context scope.\n * All shim modules will read/write their state from `ctx` for the\n * duration of the call, including async continuations.\n */\nexport function runWithRequestContext<T>(\n  ctx: UnifiedRequestContext,\n  fn: () => T | Promise<T>,\n): T | Promise<T> {\n  return _als.run(ctx, fn);\n}\n\n/**\n * Run `fn` in a nested unified scope derived from the current request context.\n * Used by legacy runWith* wrappers to reset or override one sub-state while\n * preserving proper async isolation for continuations created inside `fn`.\n * The child scope is a shallow clone of the parent store, so untouched fields\n * keep sharing their existing references while overridden slices can be reset.\n *\n * @internal\n */\nexport function runWithUnifiedStateMutation<T>(\n  mutate: (ctx: UnifiedRequestContext) => void,\n  fn: () => T | Promise<T>,\n): T | Promise<T> {\n  const parentCtx = _als.getStore();\n  if (!parentCtx) return fn();\n\n  const childCtx = { ...parentCtx };\n  // NOTE: This is a shallow clone. Array fields (pendingSetCookies,\n  // serverInsertedHTMLCallbacks, currentRequestTags, ssrHeadChildren), the\n  // _privateCache Map, and object fields (headersContext, i18nContext,\n  // serverContext, ssrContext, executionContext, requestScopedCacheLife)\n  // still share references with the parent until replaced. The mutate\n  // callback must replace those reference-typed slices (for example\n  // `ctx.currentRequestTags = []`) rather than mutating them in-place (for\n  // example `ctx.currentRequestTags.push(...)`) or the parent scope will\n  // observe those changes too. Keep this enumeration in sync with\n  // UnifiedRequestContext: when adding a new reference-typed field, add it\n  // here too and verify callers still follow the replace-not-mutate rule.\n  mutate(childCtx);\n  return _als.run(childCtx, fn);\n}\n\n/**\n * Get the current unified request context.\n * Returns the ALS store when inside a `runWithRequestContext()` scope,\n * or a fresh detached context otherwise. Unlike the legacy per-shim fallback\n * singletons, this detached value is ephemeral — mutations do not persist\n * across calls. This is intentional to prevent state leakage outside request\n * scopes.\n *\n * Only direct callers observe this detached fallback. Shim `_getState()`\n * helpers should continue to gate on `isInsideUnifiedScope()` and fall back\n * to their standalone ALS/fallback singletons outside the unified scope.\n * If called inside a standalone `runWithExecutionContext()` scope, the\n * detached context still reflects that inherited `executionContext`.\n */\nexport function getRequestContext(): UnifiedRequestContext {\n  return _als.getStore() ?? createRequestContext();\n}\n\n/**\n * Check whether the current execution is inside a `runWithRequestContext()` scope.\n * Shim modules use this to decide whether to read from the unified store\n * or fall back to their own standalone ALS.\n */\nexport function isInsideUnifiedScope(): boolean {\n  return _als.getStore() != null;\n}\n"],"mappings":";;;;;;;;;;;;;AAwDA,MAAM,WAAW,OAAO,IAAI,mCAAmC;AAC/D,MAAM,2BAA2B,OAAO,IAAI,4BAA4B;AACxE,MAAM,KAAK;AACX,MAAM,OAAQ,GAAG,cACf,IAAI,mBAA0C;AAEhD,SAAS,gCAA6D;CACpE,MAAM,eAAe,KAAK,UAAU;AACpC,KAAI,aAAc,QAAO,aAAa;AAKtC,QAH4B,GAAG,2BAGH,UAAU,IAAI;;;;;;AAW5C,SAAgB,qBAAqB,MAA8D;AACjG,QAAO;EACL,gBAAgB;EAChB,sBAAsB;EACtB,mBAAmB,EAAE;EACrB,uBAAuB;EACvB,OAAO;EACP,aAAa;EACb,eAAe;EACf,6BAA6B,EAAE;EAC/B,wBAAwB;EACxB,eAAe;EACf,oBAAoB,EAAE;EACtB,kBAAkB,+BAA+B;EACjD,YAAY;EACZ,iBAAiB,EAAE;EACnB,GAAG;EACJ;;;;;;;AAQH,SAAgB,sBACd,KACA,IACgB;AAChB,QAAO,KAAK,IAAI,KAAK,GAAG;;;;;;;;;;;AAY1B,SAAgB,4BACd,QACA,IACgB;CAChB,MAAM,YAAY,KAAK,UAAU;AACjC,KAAI,CAAC,UAAW,QAAO,IAAI;CAE3B,MAAM,WAAW,EAAE,GAAG,WAAW;AAYjC,QAAO,SAAS;AAChB,QAAO,KAAK,IAAI,UAAU,GAAG;;;;;;;;;;;;;;;;AAiB/B,SAAgB,oBAA2C;AACzD,QAAO,KAAK,UAAU,IAAI,sBAAsB;;;;;;;AAQlD,SAAgB,uBAAgC;AAC9C,QAAO,KAAK,UAAU,IAAI"}
+{"version":3,"file":"unified-request-context.js","names":[],"sources":["../../src/shims/unified-request-context.ts"],"sourcesContent":["/**\n * Unified per-request context backed by a single AsyncLocalStorage.\n *\n * Consolidates the 5–6 nested ALS scopes that previously wrapped every\n * App Router request (headers, navigation, cache-state, private-cache,\n * fetch-cache, execution-context) into one flat store.\n *\n * Each shim module checks `isInsideUnifiedScope()` and reads its sub-fields\n * from the unified store, falling back to its own standalone ALS when\n * outside (SSR environment, Pages Router, tests).\n */\n\nimport { AsyncLocalStorage } from \"node:async_hooks\";\nimport type {\n  CacheState,\n  ExecutionContextLike,\n  FetchCacheState,\n  HeadState,\n  I18nState,\n  NavigationState,\n  PrivateCacheState,\n  RouterState,\n  VinextHeadersShimState,\n} from \"./request-state-types.js\";\n\n// ---------------------------------------------------------------------------\n// Unified context shape\n// ---------------------------------------------------------------------------\n\n/**\n * Flat union of all per-request state previously spread across\n * VinextHeadersShimState, NavigationState, CacheState, PrivateCacheState,\n * FetchCacheState, and ExecutionContextLike.\n *\n * Each field group is documented with its source shim module.\n */\nexport type UnifiedRequestContext = {\n  // ── request-context.ts ─────────────────────────────────────────────\n  /** Cloudflare Workers ExecutionContext, or null on Node.js dev. */\n  executionContext: ExecutionContextLike | null;\n\n  // ── cache-for-request.ts ──────────────────────────────────────────\n  /** Per-request cache for cacheForRequest(). Keyed by factory function reference. */\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  requestCache: WeakMap<(...args: any[]) => any, unknown>;\n} & VinextHeadersShimState &\n  I18nState &\n  NavigationState &\n  CacheState &\n  PrivateCacheState &\n  FetchCacheState &\n  RouterState &\n  HeadState;\n\n// ---------------------------------------------------------------------------\n// ALS setup — stored on globalThis via Symbol.for so all Vite environments\n// (RSC/SSR/client) share the same instance.\n// ---------------------------------------------------------------------------\n\nconst _ALS_KEY = Symbol.for(\"vinext.unifiedRequestContext.als\");\nconst _REQUEST_CONTEXT_ALS_KEY = Symbol.for(\"vinext.requestContext.als\");\nconst _g = globalThis as unknown as Record<PropertyKey, unknown>;\nconst _als = (_g[_ALS_KEY] ??=\n  new AsyncLocalStorage<UnifiedRequestContext>()) as AsyncLocalStorage<UnifiedRequestContext>;\n\nfunction _getInheritedExecutionContext(): ExecutionContextLike | null {\n  const unifiedStore = _als.getStore();\n  if (unifiedStore) return unifiedStore.executionContext;\n\n  const executionContextAls = _g[_REQUEST_CONTEXT_ALS_KEY] as\n    | AsyncLocalStorage<ExecutionContextLike | null>\n    | undefined;\n  return executionContextAls?.getStore() ?? null;\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Create a fresh `UnifiedRequestContext` with defaults for all fields.\n * Pass partial overrides for the fields you need to pre-populate.\n */\nexport function createRequestContext(opts?: Partial<UnifiedRequestContext>): UnifiedRequestContext {\n  return {\n    headersContext: null,\n    dynamicUsageDetected: false,\n    pendingSetCookies: [],\n    draftModeCookieHeader: null,\n    phase: \"render\",\n    i18nContext: null,\n    serverContext: null,\n    serverInsertedHTMLCallbacks: [],\n    requestScopedCacheLife: null,\n    _privateCache: null,\n    currentRequestTags: [],\n    executionContext: _getInheritedExecutionContext(), // inherits from standalone ALS if present\n    requestCache: new WeakMap(),\n    ssrContext: null,\n    ssrHeadChildren: [],\n    ...opts,\n  };\n}\n\n/**\n * Run `fn` within a unified request context scope.\n * All shim modules will read/write their state from `ctx` for the\n * duration of the call, including async continuations.\n */\nexport function runWithRequestContext<T>(\n  ctx: UnifiedRequestContext,\n  fn: () => T | Promise<T>,\n): T | Promise<T> {\n  return _als.run(ctx, fn);\n}\n\n/**\n * Run `fn` in a nested unified scope derived from the current request context.\n * Used by legacy runWith* wrappers to reset or override one sub-state while\n * preserving proper async isolation for continuations created inside `fn`.\n * The child scope is a shallow clone of the parent store, so untouched fields\n * keep sharing their existing references while overridden slices can be reset.\n *\n * @internal\n */\nexport function runWithUnifiedStateMutation<T>(\n  mutate: (ctx: UnifiedRequestContext) => void,\n  fn: () => T | Promise<T>,\n): T | Promise<T> {\n  const parentCtx = _als.getStore();\n  if (!parentCtx) return fn();\n\n  const childCtx = { ...parentCtx };\n  // NOTE: This is a shallow clone. Array fields (pendingSetCookies,\n  // serverInsertedHTMLCallbacks, currentRequestTags, ssrHeadChildren), the\n  // _privateCache Map, requestCache WeakMap, and object fields (headersContext,\n  // i18nContext, serverContext, ssrContext, executionContext,\n  // requestScopedCacheLife) still share references with the parent until\n  // replaced. requestCache is intentionally shared — nested scopes within\n  // the same request should see the same cached values. The mutate\n  // callback must replace those reference-typed slices (for example\n  // `ctx.currentRequestTags = []`) rather than mutating them in-place (for\n  // example `ctx.currentRequestTags.push(...)`) or the parent scope will\n  // observe those changes too. Keep this enumeration in sync with\n  // UnifiedRequestContext: when adding a new reference-typed field, add it\n  // here too and verify callers still follow the replace-not-mutate rule.\n  mutate(childCtx);\n  return _als.run(childCtx, fn);\n}\n\n/**\n * Get the current unified request context.\n * Returns the ALS store when inside a `runWithRequestContext()` scope,\n * or a fresh detached context otherwise. Unlike the legacy per-shim fallback\n * singletons, this detached value is ephemeral — mutations do not persist\n * across calls. This is intentional to prevent state leakage outside request\n * scopes.\n *\n * Only direct callers observe this detached fallback. Shim `_getState()`\n * helpers should continue to gate on `isInsideUnifiedScope()` and fall back\n * to their standalone ALS/fallback singletons outside the unified scope.\n * If called inside a standalone `runWithExecutionContext()` scope, the\n * detached context still reflects that inherited `executionContext`.\n */\nexport function getRequestContext(): UnifiedRequestContext {\n  return _als.getStore() ?? createRequestContext();\n}\n\n/**\n * Check whether the current execution is inside a `runWithRequestContext()` scope.\n * Shim modules use this to decide whether to read from the unified store\n * or fall back to their own standalone ALS.\n */\nexport function isInsideUnifiedScope(): boolean {\n  return _als.getStore() != null;\n}\n"],"mappings":";;;;;;;;;;;;;AA2DA,MAAM,WAAW,OAAO,IAAI,mCAAmC;AAC/D,MAAM,2BAA2B,OAAO,IAAI,4BAA4B;AACxE,MAAM,KAAK;AACX,MAAM,OAAQ,GAAG,cACf,IAAI,mBAA0C;AAEhD,SAAS,gCAA6D;CACpE,MAAM,eAAe,KAAK,UAAU;AACpC,KAAI,aAAc,QAAO,aAAa;AAKtC,QAH4B,GAAG,2BAGH,UAAU,IAAI;;;;;;AAW5C,SAAgB,qBAAqB,MAA8D;AACjG,QAAO;EACL,gBAAgB;EAChB,sBAAsB;EACtB,mBAAmB,EAAE;EACrB,uBAAuB;EACvB,OAAO;EACP,aAAa;EACb,eAAe;EACf,6BAA6B,EAAE;EAC/B,wBAAwB;EACxB,eAAe;EACf,oBAAoB,EAAE;EACtB,kBAAkB,+BAA+B;EACjD,8BAAc,IAAI,SAAS;EAC3B,YAAY;EACZ,iBAAiB,EAAE;EACnB,GAAG;EACJ;;;;;;;AAQH,SAAgB,sBACd,KACA,IACgB;AAChB,QAAO,KAAK,IAAI,KAAK,GAAG;;;;;;;;;;;AAY1B,SAAgB,4BACd,QACA,IACgB;CAChB,MAAM,YAAY,KAAK,UAAU;AACjC,KAAI,CAAC,UAAW,QAAO,IAAI;CAE3B,MAAM,WAAW,EAAE,GAAG,WAAW;AAcjC,QAAO,SAAS;AAChB,QAAO,KAAK,IAAI,UAAU,GAAG;;;;;;;;;;;;;;;;AAiB/B,SAAgB,oBAA2C;AACzD,QAAO,KAAK,UAAU,IAAI,sBAAsB;;;;;;;AAQlD,SAAgB,uBAAgC;AAC9C,QAAO,KAAK,UAAU,IAAI"}

package/dist/shims/web-vitals.d.ts

@@ -6,14 +6,14 @@
  * In real Next.js, this sends Core Web Vitals to an analytics endpoint.
  * Apps can use the web-vitals library directly instead.
  */
-interface WebVitalsMetric {
+type WebVitalsMetric = {
   id: string;
   name: string;
   value: number;
   rating?: "good" | "needs-improvement" | "poor";
   delta: number;
   navigationType?: "navigate" | "reload" | "back-forward" | "prerender";
-}
+};
 type ReportWebVitalsCallback = (metric: WebVitalsMetric) => void;
 /**
  * Register a callback to receive Core Web Vitals metrics.

package/dist/shims/web-vitals.js.map

@@ -1 +1 @@
-{"version":3,"file":"web-vitals.js","names":[],"sources":["../../src/shims/web-vitals.ts"],"sourcesContent":["/**\n * next/web-vitals shim\n *\n * Provides useReportWebVitals() — a no-op hook for compatibility.\n * In real Next.js, this sends Core Web Vitals to an analytics endpoint.\n * Apps can use the web-vitals library directly instead.\n */\n\ninterface WebVitalsMetric {\n  id: string;\n  name: string;\n  value: number;\n  rating?: \"good\" | \"needs-improvement\" | \"poor\";\n  delta: number;\n  navigationType?: \"navigate\" | \"reload\" | \"back-forward\" | \"prerender\";\n}\n\ntype ReportWebVitalsCallback = (metric: WebVitalsMetric) => void;\n\n/**\n * Register a callback to receive Core Web Vitals metrics.\n * No-op in our implementation — use the `web-vitals` library directly\n * for production metrics collection.\n */\nexport function useReportWebVitals(_callback: ReportWebVitalsCallback): void {\n  // No-op — apps should use the web-vitals library directly\n  // or their own analytics integration.\n}\n\nexport type { WebVitalsMetric, ReportWebVitalsCallback };\n"],"mappings":";;;;;;AAwBA,SAAgB,mBAAmB,WAA0C"}
+{"version":3,"file":"web-vitals.js","names":[],"sources":["../../src/shims/web-vitals.ts"],"sourcesContent":["/**\n * next/web-vitals shim\n *\n * Provides useReportWebVitals() — a no-op hook for compatibility.\n * In real Next.js, this sends Core Web Vitals to an analytics endpoint.\n * Apps can use the web-vitals library directly instead.\n */\n\ntype WebVitalsMetric = {\n  id: string;\n  name: string;\n  value: number;\n  rating?: \"good\" | \"needs-improvement\" | \"poor\";\n  delta: number;\n  navigationType?: \"navigate\" | \"reload\" | \"back-forward\" | \"prerender\";\n};\n\ntype ReportWebVitalsCallback = (metric: WebVitalsMetric) => void;\n\n/**\n * Register a callback to receive Core Web Vitals metrics.\n * No-op in our implementation — use the `web-vitals` library directly\n * for production metrics collection.\n */\nexport function useReportWebVitals(_callback: ReportWebVitalsCallback): void {\n  // No-op — apps should use the web-vitals library directly\n  // or their own analytics integration.\n}\n\nexport type { WebVitalsMetric, ReportWebVitalsCallback };\n"],"mappings":";;;;;;AAwBA,SAAgB,mBAAmB,WAA0C"}

package/dist/utils/lazy-chunks.d.ts

@@ -0,0 +1,34 @@
+//#region src/utils/lazy-chunks.d.ts
+/**
+ * Build-manifest chunk metadata used to compute lazy chunks.
+ */
+type BuildManifestChunk = {
+  file: string;
+  isEntry?: boolean;
+  isDynamicEntry?: boolean;
+  imports?: string[];
+  dynamicImports?: string[];
+  css?: string[];
+  assets?: string[];
+};
+/**
+ * Compute the set of chunk filenames that are ONLY reachable through dynamic
+ * imports (i.e. behind React.lazy(), next/dynamic, or manual import()).
+ *
+ * These chunks should NOT be modulepreloaded in the HTML — they will be
+ * fetched on demand when the dynamic import executes.
+ *
+ * Algorithm: Starting from all entry chunks in the build manifest, walk the
+ * static `imports` tree (breadth-first). Any chunk file NOT reached by this
+ * walk is only reachable through `dynamicImports` and is therefore "lazy".
+ *
+ * @param buildManifest - Vite's build manifest (manifest.json), which is a
+ *   Record<string, ManifestChunk> where each chunk has `file`, `imports`,
+ *   `dynamicImports`, `isEntry`, and `isDynamicEntry` fields.
+ * @returns Array of chunk filenames (e.g. "assets/mermaid-NOHMQCX5.js") that
+ *   should be excluded from modulepreload hints.
+ */
+declare function computeLazyChunks(buildManifest: Record<string, BuildManifestChunk>): string[];
+//#endregion
+export { BuildManifestChunk, computeLazyChunks };
+//# sourceMappingURL=lazy-chunks.d.ts.map

package/dist/utils/lazy-chunks.js

@@ -0,0 +1,50 @@
+//#region src/utils/lazy-chunks.ts
+/**
+* Compute the set of chunk filenames that are ONLY reachable through dynamic
+* imports (i.e. behind React.lazy(), next/dynamic, or manual import()).
+*
+* These chunks should NOT be modulepreloaded in the HTML — they will be
+* fetched on demand when the dynamic import executes.
+*
+* Algorithm: Starting from all entry chunks in the build manifest, walk the
+* static `imports` tree (breadth-first). Any chunk file NOT reached by this
+* walk is only reachable through `dynamicImports` and is therefore "lazy".
+*
+* @param buildManifest - Vite's build manifest (manifest.json), which is a
+*   Record<string, ManifestChunk> where each chunk has `file`, `imports`,
+*   `dynamicImports`, `isEntry`, and `isDynamicEntry` fields.
+* @returns Array of chunk filenames (e.g. "assets/mermaid-NOHMQCX5.js") that
+*   should be excluded from modulepreload hints.
+*/
+function computeLazyChunks(buildManifest) {
+	const eagerFiles = /* @__PURE__ */ new Set();
+	const visited = /* @__PURE__ */ new Set();
+	const queue = [];
+	for (const key of Object.keys(buildManifest)) if (buildManifest[key].isEntry) queue.push(key);
+	while (queue.length > 0) {
+		const key = queue.shift();
+		if (!key || visited.has(key)) continue;
+		visited.add(key);
+		const chunk = buildManifest[key];
+		if (!chunk) continue;
+		eagerFiles.add(chunk.file);
+		if (chunk.css) for (const cssFile of chunk.css) eagerFiles.add(cssFile);
+		if (chunk.imports) {
+			for (const imp of chunk.imports) if (!visited.has(imp)) queue.push(imp);
+		}
+	}
+	const lazyChunks = [];
+	const allFiles = /* @__PURE__ */ new Set();
+	for (const key of Object.keys(buildManifest)) {
+		const chunk = buildManifest[key];
+		if (chunk.file && !allFiles.has(chunk.file)) {
+			allFiles.add(chunk.file);
+			if (!eagerFiles.has(chunk.file) && chunk.file.endsWith(".js")) lazyChunks.push(chunk.file);
+		}
+	}
+	return lazyChunks;
+}
+//#endregion
+export { computeLazyChunks };
+
+//# sourceMappingURL=lazy-chunks.js.map

package/dist/utils/lazy-chunks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-chunks.js","names":[],"sources":["../../src/utils/lazy-chunks.ts"],"sourcesContent":["/**\n * Build-manifest chunk metadata used to compute lazy chunks.\n */\nexport type BuildManifestChunk = {\n  file: string;\n  isEntry?: boolean;\n  isDynamicEntry?: boolean;\n  imports?: string[];\n  dynamicImports?: string[];\n  css?: string[];\n  assets?: string[];\n};\n\n/**\n * Compute the set of chunk filenames that are ONLY reachable through dynamic\n * imports (i.e. behind React.lazy(), next/dynamic, or manual import()).\n *\n * These chunks should NOT be modulepreloaded in the HTML — they will be\n * fetched on demand when the dynamic import executes.\n *\n * Algorithm: Starting from all entry chunks in the build manifest, walk the\n * static `imports` tree (breadth-first). Any chunk file NOT reached by this\n * walk is only reachable through `dynamicImports` and is therefore \"lazy\".\n *\n * @param buildManifest - Vite's build manifest (manifest.json), which is a\n *   Record<string, ManifestChunk> where each chunk has `file`, `imports`,\n *   `dynamicImports`, `isEntry`, and `isDynamicEntry` fields.\n * @returns Array of chunk filenames (e.g. \"assets/mermaid-NOHMQCX5.js\") that\n *   should be excluded from modulepreload hints.\n */\nexport function computeLazyChunks(buildManifest: Record<string, BuildManifestChunk>): string[] {\n  // Collect all chunk files that are statically reachable from entries\n  const eagerFiles = new Set<string>();\n  const visited = new Set<string>();\n  const queue: string[] = [];\n\n  // Start BFS from all entry chunks\n  for (const key of Object.keys(buildManifest)) {\n    const chunk = buildManifest[key];\n    if (chunk.isEntry) {\n      queue.push(key);\n    }\n  }\n\n  while (queue.length > 0) {\n    const key = queue.shift();\n    if (!key || visited.has(key)) continue;\n    visited.add(key);\n\n    const chunk = buildManifest[key];\n    if (!chunk) continue;\n\n    // Mark this chunk's file as eager\n    eagerFiles.add(chunk.file);\n\n    // Also mark its CSS as eager (CSS should always be preloaded to avoid FOUC)\n    if (chunk.css) {\n      for (const cssFile of chunk.css) {\n        eagerFiles.add(cssFile);\n      }\n    }\n\n    // Follow only static imports — NOT dynamicImports\n    if (chunk.imports) {\n      for (const imp of chunk.imports) {\n        if (!visited.has(imp)) {\n          queue.push(imp);\n        }\n      }\n    }\n  }\n\n  // Any JS file in the manifest that's NOT in eagerFiles is a lazy chunk\n  const lazyChunks: string[] = [];\n  const allFiles = new Set<string>();\n  for (const key of Object.keys(buildManifest)) {\n    const chunk = buildManifest[key];\n    if (chunk.file && !allFiles.has(chunk.file)) {\n      allFiles.add(chunk.file);\n      if (!eagerFiles.has(chunk.file) && chunk.file.endsWith(\".js\")) {\n        lazyChunks.push(chunk.file);\n      }\n    }\n  }\n\n  return lazyChunks;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AA8BA,SAAgB,kBAAkB,eAA6D;CAE7F,MAAM,6BAAa,IAAI,KAAa;CACpC,MAAM,0BAAU,IAAI,KAAa;CACjC,MAAM,QAAkB,EAAE;AAG1B,MAAK,MAAM,OAAO,OAAO,KAAK,cAAc,CAE1C,KADc,cAAc,KAClB,QACR,OAAM,KAAK,IAAI;AAInB,QAAO,MAAM,SAAS,GAAG;EACvB,MAAM,MAAM,MAAM,OAAO;AACzB,MAAI,CAAC,OAAO,QAAQ,IAAI,IAAI,CAAE;AAC9B,UAAQ,IAAI,IAAI;EAEhB,MAAM,QAAQ,cAAc;AAC5B,MAAI,CAAC,MAAO;AAGZ,aAAW,IAAI,MAAM,KAAK;AAG1B,MAAI,MAAM,IACR,MAAK,MAAM,WAAW,MAAM,IAC1B,YAAW,IAAI,QAAQ;AAK3B,MAAI,MAAM;QACH,MAAM,OAAO,MAAM,QACtB,KAAI,CAAC,QAAQ,IAAI,IAAI,CACnB,OAAM,KAAK,IAAI;;;CAOvB,MAAM,aAAuB,EAAE;CAC/B,MAAM,2BAAW,IAAI,KAAa;AAClC,MAAK,MAAM,OAAO,OAAO,KAAK,cAAc,EAAE;EAC5C,MAAM,QAAQ,cAAc;AAC5B,MAAI,MAAM,QAAQ,CAAC,SAAS,IAAI,MAAM,KAAK,EAAE;AAC3C,YAAS,IAAI,MAAM,KAAK;AACxB,OAAI,CAAC,WAAW,IAAI,MAAM,KAAK,IAAI,MAAM,KAAK,SAAS,MAAM,CAC3D,YAAW,KAAK,MAAM,KAAK;;;AAKjC,QAAO"}

package/dist/utils/vinext-root.d.ts

@@ -0,0 +1,24 @@
+//#region src/utils/vinext-root.d.ts
+/**
+ * Resolve the root directory of the vinext package at runtime.
+ *
+ * Both the CLI pre-flight check (`cli.ts`) and the standalone output emitter
+ * (`build/standalone.ts`) need to locate vinext's package root so they can
+ * verify that `dist/` exists and copy vinext's runtime files into standalone
+ * output.  Centralising the logic here ensures the two callers stay in sync.
+ *
+ * The resolution works for both the compiled output layout and for running
+ * directly from source:
+ *
+ *   - Compiled layout:  this file lives at `dist/utils/vinext-root.js`
+ *                       → two levels up (`../..`) is the package root.
+ *   - Source layout:    this file lives at `src/utils/vinext-root.ts`
+ *                       → two levels up (`../..`) is the package root.
+ *
+ * If an explicit root is provided (e.g. from a test fixture), it is returned
+ * as-is after resolving to an absolute path.
+ */
+declare function resolveVinextPackageRoot(explicitRoot?: string): string;
+//#endregion
+export { resolveVinextPackageRoot };
+//# sourceMappingURL=vinext-root.d.ts.map

package/dist/utils/vinext-root.js

@@ -0,0 +1,31 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+//#region src/utils/vinext-root.ts
+/**
+* Resolve the root directory of the vinext package at runtime.
+*
+* Both the CLI pre-flight check (`cli.ts`) and the standalone output emitter
+* (`build/standalone.ts`) need to locate vinext's package root so they can
+* verify that `dist/` exists and copy vinext's runtime files into standalone
+* output.  Centralising the logic here ensures the two callers stay in sync.
+*
+* The resolution works for both the compiled output layout and for running
+* directly from source:
+*
+*   - Compiled layout:  this file lives at `dist/utils/vinext-root.js`
+*                       → two levels up (`../..`) is the package root.
+*   - Source layout:    this file lives at `src/utils/vinext-root.ts`
+*                       → two levels up (`../..`) is the package root.
+*
+* If an explicit root is provided (e.g. from a test fixture), it is returned
+* as-is after resolving to an absolute path.
+*/
+function resolveVinextPackageRoot(explicitRoot) {
+	if (explicitRoot) return path.resolve(explicitRoot);
+	const currentDir = path.dirname(fileURLToPath(import.meta.url));
+	return path.resolve(currentDir, "..", "..");
+}
+//#endregion
+export { resolveVinextPackageRoot };
+
+//# sourceMappingURL=vinext-root.js.map

package/dist/utils/vinext-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vinext-root.js","names":[],"sources":["../../src/utils/vinext-root.ts"],"sourcesContent":["import path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\n/**\n * Resolve the root directory of the vinext package at runtime.\n *\n * Both the CLI pre-flight check (`cli.ts`) and the standalone output emitter\n * (`build/standalone.ts`) need to locate vinext's package root so they can\n * verify that `dist/` exists and copy vinext's runtime files into standalone\n * output.  Centralising the logic here ensures the two callers stay in sync.\n *\n * The resolution works for both the compiled output layout and for running\n * directly from source:\n *\n *   - Compiled layout:  this file lives at `dist/utils/vinext-root.js`\n *                       → two levels up (`../..`) is the package root.\n *   - Source layout:    this file lives at `src/utils/vinext-root.ts`\n *                       → two levels up (`../..`) is the package root.\n *\n * If an explicit root is provided (e.g. from a test fixture), it is returned\n * as-is after resolving to an absolute path.\n */\nexport function resolveVinextPackageRoot(explicitRoot?: string): string {\n  if (explicitRoot) {\n    return path.resolve(explicitRoot);\n  }\n  const currentDir = path.dirname(fileURLToPath(import.meta.url));\n  // src/utils/vinext-root.ts  → ../..  → package root\n  // dist/utils/vinext-root.js → ../..  → package root\n  return path.resolve(currentDir, \"..\", \"..\");\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,yBAAyB,cAA+B;AACtE,KAAI,aACF,QAAO,KAAK,QAAQ,aAAa;CAEnC,MAAM,aAAa,KAAK,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAG/D,QAAO,KAAK,QAAQ,YAAY,MAAM,KAAK"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vinext",
-  "version": "0.0.37",
+  "version": "0.0.39",
   "description": "Run Next.js apps on Vite. Drop-in replacement for the next CLI.",
   "license": "MIT",
   "repository": {
@@ -21,6 +21,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./cache": {
+      "types": "./dist/cache.d.ts",
+      "import": "./dist/cache.js"
+    },
     "./shims/*": {
       "types": "./dist/shims/*.d.ts",
       "import": "./dist/shims/*.js"
@@ -62,8 +66,8 @@
     "@types/node": "^25.2.3",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "@vitejs/plugin-react": "^5.1.4",
-    "@vitejs/plugin-rsc": "^0.5.19",
+    "@vitejs/plugin-react": "^6.0.1",
+    "@vitejs/plugin-rsc": "^0.5.21",
     "react-server-dom-webpack": "^19.2.4",
     "vite": "npm:@voidzero-dev/vite-plus-core@0.1.12",
     "vite-plus": "0.1.12"
@@ -71,7 +75,7 @@
   "peerDependencies": {
     "@mdx-js/rollup": "^3.0.0",
     "@vitejs/plugin-react": "^5.1.4 || ^6.0.0",
-    "@vitejs/plugin-rsc": "^0.5.19",
+    "@vitejs/plugin-rsc": "^0.5.21",
     "react": ">=19.2.0",
     "react-dom": ">=19.2.0",
     "react-server-dom-webpack": "^19.2.4",