vinext 1.0.0-beta.4 → 1.0.0-beta.6

package/dist/server/static-file-cache.js

@@ -1,5 +1,6 @@
 import path, { toSlash } from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 import { ASSET_PREFIX_URL_DIR } from "../utils/asset-prefix.js";
+import { isPrecompressedVariantBeneficial } from "../utils/precompressed-variant.js";
 import fsp from "node:fs/promises";
 //#region src/server/static-file-cache.ts
 /**
@@ -17,27 +18,43 @@ import fsp from "node:fs/promises";
 */
 /** Content-type lookup for static assets. Shared with prod-server.ts. */
 const CONTENT_TYPES = {
-	".js": "application/javascript",
-	".mjs": "application/javascript",
-	".css": "text/css",
+	".avif": "image/avif",
+	".bmp": "image/bmp",
+	".csv": "text/csv; charset=utf-8",
+	".eot": "application/vnd.ms-fontobject",
+	".gif": "image/gif",
+	".heic": "image/heic",
+	".js": "application/javascript; charset=utf-8",
+	".mjs": "application/javascript; charset=utf-8",
+	".css": "text/css; charset=utf-8",
 	".html": "text/html; charset=utf-8",
-	".json": "application/json",
-	".txt": "text/plain; charset=utf-8",
-	".png": "image/png",
-	".jpg": "image/jpeg",
+	".ico": "image/x-icon",
 	".jpeg": "image/jpeg",
-	".gif": "image/gif",
+	".jpg": "image/jpeg",
+	".json": "application/json; charset=utf-8",
+	".map": "application/json; charset=utf-8",
+	".mp3": "audio/mpeg",
+	".mp4": "video/mp4",
+	".ogg": "audio/ogg",
+	".ogv": "video/ogg",
+	".pdf": "application/pdf",
+	".png": "image/png",
+	".rsc": "text/x-component",
 	".svg": "image/svg+xml",
-	".ico": "image/x-icon",
-	".woff": "font/woff",
-	".woff2": "font/woff2",
 	".ttf": "font/ttf",
-	".eot": "application/vnd.ms-fontobject",
+	".txt": "text/plain; charset=utf-8",
+	".wasm": "application/wasm",
+	".webm": "video/webm",
+	".webmanifest": "application/manifest+json",
 	".webp": "image/webp",
-	".avif": "image/avif",
-	".map": "application/json",
-	".rsc": "text/x-component"
+	".woff": "font/woff",
+	".woff2": "font/woff2",
+	".xml": "application/xml"
 };
+/** Resolve a path's MIME type with case-insensitive extension matching. */
+function contentTypeForPath(filePath) {
+	return CONTENT_TYPES[path.extname(filePath).toLowerCase()] ?? "application/octet-stream";
+}
 /**
 * Files below this size are buffered in memory at startup for zero-syscall
 * serving via res.end(buffer). Above this, files stream via createReadStream.
@@ -45,6 +62,8 @@ const CONTENT_TYPES = {
 * to ~50KB with brotli q5).
 */
 const BUFFER_THRESHOLD = 64 * 1024;
+/** Temp files left by an interrupted atomic precompression write. */
+const PRECOMPRESSION_TEMP_FILE_RE = /\.(?:br|gz|zst)\.\d+\.[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}\.tmp$/i;
 /**
 * In-memory cache of static file metadata, populated once at server startup.
 *
@@ -74,15 +93,18 @@ var StaticFileCache = class StaticFileCache {
 		for (const [relativePath, fileInfo] of allFiles) {
 			if (relativePath.endsWith(".br") || relativePath.endsWith(".gz") || relativePath.endsWith(".zst")) continue;
 			if (relativePath.startsWith(".vite/") || relativePath === ".vite") continue;
-			const ext = path.extname(relativePath);
-			const contentType = CONTENT_TYPES[ext] ?? "application/octet-stream";
 			const isHashed = relativePath.startsWith(`_next/static/`) || relativePath.includes(`/_next/static/`);
+			if (isHashed && PRECOMPRESSION_TEMP_FILE_RE.test(relativePath)) continue;
+			const ext = path.extname(relativePath);
+			const contentType = contentTypeForPath(relativePath);
 			const cacheControl = isHashed ? "public, max-age=31536000, immutable" : "public, max-age=3600";
 			const etag = isHashed && etagFromFilenameHash(relativePath, ext) || `W/"${fileInfo.size}-${Math.floor(fileInfo.mtimeMs / 1e3)}"`;
+			const lastModified = new Date(fileInfo.mtimeMs).toUTCString();
 			const baseHeaders = {
 				"Content-Type": contentType,
 				"Cache-Control": cacheControl,
-				ETag: etag
+				ETag: etag,
+				"Last-Modified": lastModified
 			};
 			const original = {
 				path: fileInfo.fullPath,
@@ -94,18 +116,20 @@ var StaticFileCache = class StaticFileCache {
 			};
 			const entry = {
 				etag,
+				mtimeMs: fileInfo.mtimeMs,
 				notModifiedHeaders: {
 					ETag: etag,
-					"Cache-Control": cacheControl
+					"Cache-Control": cacheControl,
+					"Last-Modified": lastModified
 				},
 				original
 			};
 			const brInfo = allFiles.get(relativePath + ".br");
-			if (brInfo) entry.br = buildVariant(brInfo, baseHeaders, "br");
+			if (brInfo && isPrecompressedVariantBeneficial(brInfo.size, fileInfo.size, "br")) entry.br = buildVariant(brInfo, baseHeaders, "br");
 			const gzInfo = allFiles.get(relativePath + ".gz");
-			if (gzInfo) entry.gz = buildVariant(gzInfo, baseHeaders, "gzip");
+			if (gzInfo && isPrecompressedVariantBeneficial(gzInfo.size, fileInfo.size, "gzip")) entry.gz = buildVariant(gzInfo, baseHeaders, "gzip");
 			const zstInfo = allFiles.get(relativePath + ".zst");
-			if (zstInfo) entry.zst = buildVariant(zstInfo, baseHeaders, "zstd");
+			if (zstInfo && isPrecompressedVariantBeneficial(zstInfo.size, fileInfo.size, "zstd")) entry.zst = buildVariant(zstInfo, baseHeaders, "zstd");
 			if (entry.br || entry.gz || entry.zst) {
 				original.headers["Vary"] = "Accept-Encoding";
 				entry.notModifiedHeaders["Vary"] = "Accept-Encoding";
@@ -227,4 +251,4 @@ async function* walkFilesWithStats(dir, base = dir) {
 	}
 }
 //#endregion
-export { CONTENT_TYPES, StaticFileCache, etagFromFilenameHash };
+export { CONTENT_TYPES, StaticFileCache, contentTypeForPath, etagFromFilenameHash };

package/dist/server/static-layout-client-reuse-proof.d.ts

@@ -1,5 +1,4 @@
 import { ArtifactCompatibilityEnvelope } from "./artifact-compatibility.js";
-
 //#region src/server/static-layout-client-reuse-proof.d.ts
 type StaticLayoutClientReuseProofInput = Readonly<{
   artifactCompatibility: ArtifactCompatibilityEnvelope;

package/dist/server/worker-revalidation-context.d.ts

@@ -1,5 +1,4 @@
 import { ExecutionContextLike } from "../shims/request-context.js";
-
 //#region src/server/worker-revalidation-context.d.ts
 type PlatformExecutionContext = Partial<ExecutionContextLike>;
 /**

package/dist/server/worker-utils.d.ts

@@ -4,5 +4,7 @@ declare function mergeHeaders(response: Response, extraHeaders: Record<string, s
 declare function resolveStaticAssetSignal(signalResponse: Response, options: {
   fetchAsset(path: string): Promise<Response>;
 }): Promise<Response | null>;
+/** Retarget a Worker asset request without dropping its conditional/range fields. */
+declare function createStaticAssetRequest(assetPath: string, sourceRequest: Request): Request;
 //#endregion
-export { finalizeMissingStaticAssetResponse, mergeHeaders, resolveStaticAssetSignal };
+export { createStaticAssetRequest, finalizeMissingStaticAssetResponse, mergeHeaders, resolveStaticAssetSignal };

package/dist/server/worker-utils.js

@@ -33,7 +33,7 @@ function cancelResponseBody(response) {
 function finalizeMissingStaticAssetResponse(response, missingBuildAsset) {
 	if (!missingBuildAsset || response.status !== 404) return response;
 	cancelResponseBody(response);
-	return notFoundStaticAssetResponse();
+	return notFoundStaticAssetResponse(response.headers);
 }
 function buildHeaderRecord(response, omitNames = []) {
 	const omitted = new Set(omitNames.map((name) => name.toLowerCase()));
@@ -99,7 +99,16 @@ async function resolveStaticAssetSignal(signalResponse, options) {
 	]);
 	cancelResponseBody(signalResponse);
 	const assetResponse = await options.fetchAsset(assetPath);
-	return mergeHeaders(assetResponse, extraHeaders, assetResponse.ok && signalResponse.status !== 200 ? signalResponse.status : void 0);
+	return mergeHeaders(assetResponse, extraHeaders, assetResponse.ok && assetResponse.status !== 206 && signalResponse.status !== 200 ? signalResponse.status : void 0);
+}
+/** Retarget a Worker asset request without dropping its conditional/range fields. */
+function createStaticAssetRequest(assetPath, sourceRequest) {
+	const assetUrl = new URL(assetPath, sourceRequest.url);
+	if (sourceRequest.method === "GET" || sourceRequest.method === "HEAD") return new Request(assetUrl, sourceRequest);
+	return new Request(assetUrl, {
+		method: sourceRequest.method,
+		headers: sourceRequest.headers
+	});
 }
 //#endregion
-export { finalizeMissingStaticAssetResponse, mergeHeaders, resolveStaticAssetSignal };
+export { createStaticAssetRequest, finalizeMissingStaticAssetResponse, mergeHeaders, resolveStaticAssetSignal };

package/dist/shims/app-router-scroll.d.ts

@@ -1,5 +1,4 @@
 import * as React$1 from "react";
-
 //#region src/shims/app-router-scroll.d.ts
 declare class AppRouterScrollTargetInner extends React$1.Component<{
   children: React$1.ReactNode;
@@ -13,16 +12,11 @@ declare class AppRouterScrollTargetInner extends React$1.Component<{
   componentWillUnmount(): void;
   render(): React$1.ReactNode;
 }
-declare function AppRouterScrollCommitProvider({
-  children,
-  commitId
-}: {
+declare function AppRouterScrollCommitProvider({ children, commitId }: {
   children?: React$1.ReactNode;
   commitId: number | null;
 }): React$1.JSX.Element;
-declare function AppRouterScrollTarget({
-  children
-}: {
+declare function AppRouterScrollTarget({ children }: {
   children: React$1.ReactNode;
 }): React$1.JSX.Element;
 //#endregion

package/dist/shims/app.d.ts

@@ -1,5 +1,4 @@
 import React, { ComponentType } from "react";
-
 //#region src/shims/app.d.ts
 type AppProps<P = any> = {
   Component: ComponentType<P> & {
@@ -29,10 +28,7 @@ type AppContext = {
 type AppInitialProps<PageProps = any> = {
   pageProps: PageProps;
 };
-declare function appGetInitialProps({
-  Component,
-  ctx
-}: AppContext): Promise<AppInitialProps>;
+declare function appGetInitialProps({ Component, ctx }: AppContext): Promise<AppInitialProps>;
 declare class App<P = any, CP = any, S = any> extends React.Component<P & AppProps<CP>, S> {
   static origGetInitialProps: typeof appGetInitialProps;
   static getInitialProps: typeof appGetInitialProps;

package/dist/shims/before-interactive-context.d.ts

@@ -1,5 +1,4 @@
 import React from "react";
-
 //#region src/shims/before-interactive-context.d.ts
 /**
  * A `<Script strategy="beforeInteractive">` captured during SSR.
@@ -17,13 +16,16 @@ import React from "react";
  * scripts and `innerHTML` set for inline scripts (never both).
  */
 type BeforeInteractiveInlineScript = {
-  /** Optional id attribute. */id?: string; /** External script URL. Set for src beforeInteractive scripts. */
+  /** Optional id attribute. */
+  id?: string;
+  /** External script URL. Set for src beforeInteractive scripts. */
   src?: string;
   /**
    * Pre-escaped inline content (already passed through `escapeInlineContent`).
    * Set for inline beforeInteractive scripts; omitted for src scripts.
    */
-  innerHTML?: string; /** Nonce to emit on the `<script>` tag, when CSP is enabled. */
+  innerHTML?: string;
+  /** Nonce to emit on the `<script>` tag, when CSP is enabled. */
   nonce?: string;
   /**
    * Additional HTML attributes to emit on the tag. Booleans render as the

package/dist/shims/cache-callable-runtime.d.ts

@@ -0,0 +1,11 @@
+import { RegisterCachedFunctionOptions } from "./cache-runtime.js";
+//#region src/shims/cache-callable-runtime.d.ts
+declare const CACHE_CAPTURE_TYPE = "use-cache-captures";
+type CacheCaptureEnvelope = {
+  type: typeof CACHE_CAPTURE_TYPE;
+  encrypted: string | PromiseLike<string>;
+};
+declare function encryptCacheCaptures(captures: unknown[]): CacheCaptureEnvelope;
+declare function registerCachedFunction<TArgs extends unknown[], TResult>(fn: (...args: TArgs) => Promise<TResult>, id: string, variant: string, options: RegisterCachedFunctionOptions): (...args: TArgs) => Promise<TResult>;
+//#endregion
+export { encryptCacheCaptures, registerCachedFunction };

package/dist/shims/cache-callable-runtime.js

@@ -0,0 +1,30 @@
+import { registerCachedFunction as registerCachedFunction$1 } from "./cache-runtime.js";
+import { decryptActionBoundArgs, encryptActionBoundArgs } from "@vitejs/plugin-rsc/utils/encryption-runtime";
+//#region src/shims/cache-callable-runtime.ts
+const CACHE_CAPTURE_TYPE = "use-cache-captures";
+function encryptCacheCaptures(captures) {
+	return {
+		type: CACHE_CAPTURE_TYPE,
+		encrypted: encryptActionBoundArgs(captures)
+	};
+}
+async function decryptCacheCaptures(value) {
+	if (!isCacheCaptureEnvelope(value)) return;
+	const captures = await decryptActionBoundArgs(Promise.resolve(value.encrypted));
+	if (!Array.isArray(captures)) throw new Error("Invalid cache capture payload");
+	return captures;
+}
+function isCacheCaptureEnvelope(value) {
+	if (typeof value !== "object" || value === null) return false;
+	if (!("type" in value) || value.type !== CACHE_CAPTURE_TYPE || !("encrypted" in value)) return false;
+	const encrypted = value.encrypted;
+	return typeof encrypted === "string" || typeof encrypted === "object" && encrypted !== null && "then" in encrypted && typeof encrypted.then === "function";
+}
+function registerCachedFunction(fn, id, variant, options) {
+	return registerCachedFunction$1(fn, id, variant, {
+		...options,
+		decryptCaptures: decryptCacheCaptures
+	});
+}
+//#endregion
+export { encryptCacheCaptures, registerCachedFunction };

package/dist/shims/cache-handler.d.ts

@@ -1,5 +1,4 @@
 import { RenderObservation } from "../server/cache-proof.js";
-
 //#region src/shims/cache-handler.d.ts
 type CacheHandlerValue = {
   lastModified: number;
@@ -11,6 +10,12 @@ type CacheHandlerValue = {
 type CacheControlMetadata = {
   revalidate: number | false;
   expire?: number;
+  /**
+   * Client-router reuse bound from the render's resolved `cacheLife`,
+   * persisted so warm hits replay the producing render's claim. Independent
+   * of `revalidate`/`expire`; absent means no claim was made.
+   */
+  stale?: number;
 };
 type IncrementalCacheValue = CachedFetchValue | CachedAppPageValue | CachedPagesValue | CachedRouteValue | CachedRedirectValue | CachedImageValue;
 type CachedFetchValue = {

package/dist/shims/cache-handler.js

@@ -117,15 +117,17 @@ var MemoryCacheHandler = class {
 		const tags = [...tagSet];
 		let effectiveRevalidate = readCacheControlRevalidateField(ctx);
 		const effectiveExpire = readCacheControlNumberField(ctx, "expire");
+		const effectiveStale = readCacheControlNumberField(ctx, "stale");
 		if (data && "revalidate" in data && typeof data.revalidate === "number") effectiveRevalidate = data.revalidate;
 		else if (data && "revalidate" in data && data.revalidate === false) effectiveRevalidate ??= false;
 		if (effectiveRevalidate === 0) return;
 		const now = Date.now();
 		const revalidateAt = typeof effectiveRevalidate === "number" && effectiveRevalidate > 0 ? now + effectiveRevalidate * 1e3 : null;
 		const expireAt = typeof effectiveExpire === "number" && effectiveExpire > 0 ? now + effectiveExpire * 1e3 : null;
-		const cacheControl = typeof effectiveRevalidate === "number" || effectiveRevalidate === false ? effectiveExpire === void 0 ? { revalidate: effectiveRevalidate } : {
+		const cacheControl = typeof effectiveRevalidate === "number" || effectiveRevalidate === false ? {
 			revalidate: effectiveRevalidate,
-			expire: effectiveExpire
+			...effectiveExpire === void 0 ? {} : { expire: effectiveExpire },
+			...effectiveStale === void 0 ? {} : { stale: effectiveStale }
 		} : void 0;
 		if (this.maxMemoryCacheSize === 0) return;
 		const entry = {

package/dist/shims/cache-request-state.d.ts

@@ -9,12 +9,15 @@ type CacheContextLike = {
   tags: string[];
   lifeConfigs: CacheLifeConfig[];
   variant: string;
+  readRootParamNames?: Set<string>;
   hasExplicitRevalidate: boolean;
   hasExplicitExpire: boolean;
   dynamicNestedCacheError: Error | undefined;
 };
 declare function _registerCacheContextAccessor(fn: () => CacheContextLike | null): void;
 declare function getRegisteredCacheContext(): CacheContextLike | null;
+/** Record a root-param dependency on the active public `"use cache"` scope. */
+declare function _recordUseCacheRootParamRead(name: string): void;
 type UnstableCacheRevalidationMode = "foreground" | "background";
 type ActionRevalidationKind = 0 | 1 | 2;
 type UnstableCacheObservation = Readonly<{
@@ -66,8 +69,19 @@ declare function _drainPendingRevalidations(): Promise<void>;
 declare function _setRequestScopedCacheLife(config: CacheLifeConfig): void;
 declare function _peekRequestScopedCacheLife(): CacheLifeConfig | null;
 declare function _consumeRequestScopedCacheLife(): CacheLifeConfig | null;
+/**
+ * Capture access to the current request's cache-life slot for work that may
+ * finish after the AsyncLocalStorage request scope has returned. RSC response
+ * bodies are consumed by the server runtime later, so resolving the active
+ * store from a stream-finalization callback can otherwise read a detached
+ * context and lose cacheLife claims made while rendering the body.
+ */
+declare function _captureRequestScopedCacheLifeAccessors(): {
+  consume: () => CacheLifeConfig | null;
+  peek: () => CacheLifeConfig | null;
+};
 declare function recordUnstableCacheObservation(observation: UnstableCacheObservation): void;
 declare function _peekUnstableCacheObservations(): UnstableCacheObservation[];
 declare function shouldServeStaleUnstableCacheEntry(): boolean;
 //#endregion
-export { ACTION_DID_REVALIDATE_DYNAMIC_ONLY, ACTION_DID_REVALIDATE_STATIC_AND_DYNAMIC, ActionRevalidationKind, CacheLifeConfig, CacheState, UnstableCacheObservation, UnstableCacheRevalidationMode, _consumeRequestScopedCacheLife, _drainPendingRevalidations, _hasPendingRevalidatedTag, _initRequestScopedCacheState, _markPendingRevalidatedTag, _peekRequestScopedCacheLife, _peekUnstableCacheObservations, _queuePendingRevalidation, _registerCacheContextAccessor, _runWithCacheState, _setRequestScopedCacheLife, cacheLifeProfiles, getAndClearActionRevalidationKind, getRegisteredCacheContext, markActionRevalidation, recordUnstableCacheObservation, shouldServeStaleUnstableCacheEntry };
+export { ACTION_DID_REVALIDATE_DYNAMIC_ONLY, ACTION_DID_REVALIDATE_STATIC_AND_DYNAMIC, ActionRevalidationKind, CacheLifeConfig, CacheState, UnstableCacheObservation, UnstableCacheRevalidationMode, _captureRequestScopedCacheLifeAccessors, _consumeRequestScopedCacheLife, _drainPendingRevalidations, _hasPendingRevalidatedTag, _initRequestScopedCacheState, _markPendingRevalidatedTag, _peekRequestScopedCacheLife, _peekUnstableCacheObservations, _queuePendingRevalidation, _recordUseCacheRootParamRead, _registerCacheContextAccessor, _runWithCacheState, _setRequestScopedCacheLife, cacheLifeProfiles, getAndClearActionRevalidationKind, getRegisteredCacheContext, markActionRevalidation, recordUnstableCacheObservation, shouldServeStaleUnstableCacheEntry };

package/dist/shims/cache-request-state.js

@@ -45,6 +45,11 @@ function _registerCacheContextAccessor(fn) {
 function getRegisteredCacheContext() {
 	return getCacheContext?.() ?? null;
 }
+/** Record a root-param dependency on the active public `"use cache"` scope. */
+function _recordUseCacheRootParamRead(name) {
+	const context = getRegisteredCacheContext();
+	if (context && context.variant !== "private") context.readRootParamNames?.add(name);
+}
 const FALLBACK_KEY = Symbol.for("vinext.cache.fallback");
 const globalState = globalThis;
 const cacheAls = getOrCreateAls("vinext.cache.als");
@@ -172,6 +177,27 @@ function _consumeRequestScopedCacheLife() {
 	state.requestScopedCacheLife = null;
 	return config;
 }
+/**
+* Capture access to the current request's cache-life slot for work that may
+* finish after the AsyncLocalStorage request scope has returned. RSC response
+* bodies are consumed by the server runtime later, so resolving the active
+* store from a stream-finalization callback can otherwise read a detached
+* context and lose cacheLife claims made while rendering the body.
+*/
+function _captureRequestScopedCacheLifeAccessors() {
+	const state = getCacheState();
+	return {
+		consume() {
+			const config = state.requestScopedCacheLife;
+			state.requestScopedCacheLife = null;
+			return config;
+		},
+		peek() {
+			const config = state.requestScopedCacheLife;
+			return config === null ? null : { ...config };
+		}
+	};
+}
 function recordUnstableCacheObservation(observation) {
 	getCacheState().unstableCacheObservations.set(observation.keyHash, observation);
 }
@@ -182,4 +208,4 @@ function shouldServeStaleUnstableCacheEntry() {
 	return getCacheState().unstableCacheRevalidation === "background";
 }
 //#endregion
-export { ACTION_DID_REVALIDATE_DYNAMIC_ONLY, ACTION_DID_REVALIDATE_STATIC_AND_DYNAMIC, _consumeRequestScopedCacheLife, _drainPendingRevalidations, _hasPendingRevalidatedTag, _initRequestScopedCacheState, _markPendingRevalidatedTag, _peekRequestScopedCacheLife, _peekUnstableCacheObservations, _queuePendingRevalidation, _registerCacheContextAccessor, _runWithCacheState, _setRequestScopedCacheLife, cacheLifeProfiles, getAndClearActionRevalidationKind, getRegisteredCacheContext, markActionRevalidation, recordUnstableCacheObservation, shouldServeStaleUnstableCacheEntry };
+export { ACTION_DID_REVALIDATE_DYNAMIC_ONLY, ACTION_DID_REVALIDATE_STATIC_AND_DYNAMIC, _captureRequestScopedCacheLifeAccessors, _consumeRequestScopedCacheLife, _drainPendingRevalidations, _hasPendingRevalidatedTag, _initRequestScopedCacheState, _markPendingRevalidatedTag, _peekRequestScopedCacheLife, _peekUnstableCacheObservations, _queuePendingRevalidation, _recordUseCacheRootParamRead, _registerCacheContextAccessor, _runWithCacheState, _setRequestScopedCacheLife, cacheLifeProfiles, getAndClearActionRevalidationKind, getRegisteredCacheContext, markActionRevalidation, recordUnstableCacheObservation, shouldServeStaleUnstableCacheEntry };

package/dist/shims/cache-runtime.d.ts

@@ -1,6 +1,5 @@
 import { CacheLifeConfig } from "./cache-request-state.js";
 import { markAppPagePropsForUseCache } from "./internal/app-page-props-cache-key.js";
-
 //#region src/shims/cache-runtime.d.ts
 /**
  * Used purely as `cause` for the nested-dynamic cache error: its captured stack
@@ -12,10 +11,17 @@ declare class NestedDynamicUseCacheError extends Error {
   constructor();
 }
 type CacheContext = {
-  /** Tags collected via cacheTag() during execution */tags: string[]; /** Cache life configs collected via cacheLife() — minimum-wins rule applies */
-  lifeConfigs: CacheLifeConfig[]; /** Cache variant: "default" | "remote" | "private" */
-  variant: string; /** Whether cacheLife() was called with an explicit revalidate value */
-  hasExplicitRevalidate: boolean; /** Whether cacheLife() was called with an explicit expire value */
+  /** Tags collected via cacheTag() during execution */
+  tags: string[];
+  /** Cache life configs collected via cacheLife() — minimum-wins rule applies */
+  lifeConfigs: CacheLifeConfig[];
+  /** Cache variant: "default" | "remote" | "private" */
+  variant: string;
+  /** Root params observed while producing this public cache entry. */
+  readRootParamNames?: Set<string>;
+  /** Whether cacheLife() was called with an explicit revalidate value */
+  hasExplicitRevalidate: boolean;
+  /** Whether cacheLife() was called with an explicit expire value */
   hasExplicitExpire: boolean;
   /**
    * The first nested public "use cache" invocation with a dynamic cache life
@@ -85,6 +91,9 @@ type RegisterCachedFunctionOptions = {
    * rather than on the intermediate createElement config object.
    */
   appPageDefaultExport?: boolean;
+  /** Number of declared arguments supplied by the directive transform. */
+  argumentCount?: number;
+  decryptCaptures?: (value: unknown) => Promise<unknown[] | undefined>;
 };
 /**
  * Register a function as a cached function. This is called by the Vite
@@ -97,4 +106,4 @@ type RegisterCachedFunctionOptions = {
  */
 declare function registerCachedFunction<TArgs extends unknown[], TResult>(fn: (...args: TArgs) => Promise<TResult>, id: string, variant?: string, options?: RegisterCachedFunctionOptions): (...args: TArgs) => Promise<TResult>;
 //#endregion
-export { CacheContext, NestedDynamicUseCacheError, PrivateCacheState, buildUseCacheKey, cacheContextStorage, clearPrivateCache, getCacheContext, markAppPagePropsForUseCache, registerCachedFunction, replyToCacheKey, runWithPrivateCache };
+export { CacheContext, NestedDynamicUseCacheError, PrivateCacheState, RegisterCachedFunctionOptions, buildUseCacheKey, cacheContextStorage, clearPrivateCache, getCacheContext, markAppPagePropsForUseCache, registerCachedFunction, replyToCacheKey, runWithPrivateCache };