vinext 0.1.8 → 0.2.1

package/dist/server/default-global-not-found-module.d.ts

@@ -0,0 +1,14 @@
+import React from "react";
+
+//#region src/server/default-global-not-found-module.d.ts
+declare function DefaultGlobalNotFound(): React.ReactElement;
+/**
+ * Module-shaped wrapper around Next.js's built-in global not-found document.
+ * Unlike the regular default not-found boundary, this component owns the
+ * document shell because global not-found responses skip the root layout.
+ */
+declare const DEFAULT_GLOBAL_NOT_FOUND_MODULE: {
+  readonly default: typeof DefaultGlobalNotFound;
+};
+//#endregion
+export { DEFAULT_GLOBAL_NOT_FOUND_MODULE };

package/dist/server/default-global-not-found-module.js

@@ -0,0 +1,14 @@
+import DefaultNotFound from "../shims/default-not-found.js";
+import React from "react";
+//#region src/server/default-global-not-found-module.ts
+function DefaultGlobalNotFound() {
+	return React.createElement("html", null, React.createElement("body", null, React.createElement(DefaultNotFound)));
+}
+/**
+* Module-shaped wrapper around Next.js's built-in global not-found document.
+* Unlike the regular default not-found boundary, this component owns the
+* document shell because global not-found responses skip the root layout.
+*/
+const DEFAULT_GLOBAL_NOT_FOUND_MODULE = { default: DefaultGlobalNotFound };
+//#endregion
+export { DEFAULT_GLOBAL_NOT_FOUND_MODULE };

package/dist/server/dev-route-files.js

@@ -48,6 +48,10 @@ function isRootGlobalError(parts, matcher) {
 function isMetadataRouteFile(parts) {
 	const fileName = parts[parts.length - 1];
 	if (!fileName) return false;
+	if (fileName.endsWith(".alt.txt")) {
+		const imageBaseName = fileName.slice(0, -8);
+		return matchMetadataFileBaseName("opengraph-image", imageBaseName) !== null || matchMetadataFileBaseName("twitter-image", imageBaseName) !== null;
+	}
 	const { baseName, extension } = stripLastExtension(fileName);
 	if (!extension) return false;
 	const routePrefix = visibleRoutePrefix(parts);

package/dist/server/dev-server.d.ts

@@ -43,7 +43,17 @@ declare function createSSRHandler(server: ViteDevServer, runner: ModuleImporter,
  * `next.config`. When undefined or empty, no meta tags are emitted.
  */
 
-clientTraceMetadata?: readonly string[], htmlLimitedBots?: string): (req: IncomingMessage, res: ServerResponse, url: string, /** Status code override — propagated from middleware rewrite status. */
+clientTraceMetadata?: readonly string[], htmlLimitedBots?: string,
+/**
+ * Whether `reactStrictMode: true` is set in next.config. When true, the dev
+ * hydration script sets `window.__VINEXT_REACT_STRICT_MODE__` so
+ * `wrapWithRouterContext` wraps the tree in `<React.StrictMode>` on the
+ * initial hydration and every navigation. Pages Router default is OFF
+ * (Next.js: `reactStrictMode === null ? false`), so callers pass
+ * `nextConfig?.reactStrictMode === true`.
+ */
+
+reactStrictMode?: boolean): (req: IncomingMessage, res: ServerResponse, url: string, /** Status code override — propagated from middleware rewrite status. */
 
 statusCode?: number,
 /**

package/dist/server/dev-server.js

@@ -1,9 +1,8 @@
 import { createRequestContext, runWithRequestContext } from "../shims/unified-request-context.js";
-import { createValidFileMatcher, findFileWithExtensions } from "../routing/file-matcher.js";
+import { createValidFileMatcher, findFileWithExtensions, findFileWithExts } from "../routing/file-matcher.js";
 import { patternToNextFormat } from "../routing/route-validation.js";
 import { matchRoute } from "../routing/pages-router.js";
 import { NEXTJS_DEPLOYMENT_ID_HEADER } from "./headers.js";
-import { normalizeStaticPathname } from "../routing/route-pattern.js";
 import { importModule, reportRequestError } from "./instrumentation.js";
 import { buildCacheStateHeaders } from "./cache-headers.js";
 import { isUnknownRecord } from "../utils/record.js";
@@ -18,7 +17,7 @@ import "../shims/router-state.js";
 import { runWithHeadState } from "../shims/head-state.js";
 import { runWithServerInsertedHTMLState } from "../shims/navigation-state.js";
 import { withScriptNonce } from "../shims/script-nonce-context.js";
-import { createInlineScriptTag, createNonceAttribute, safeJsonStringify } from "./html.js";
+import { createInlineScriptTag, createNonceAttribute, escapeHtmlAttr, safeJsonStringify } from "./html.js";
 import { getClientTraceMetadataHTML } from "./client-trace-metadata.js";
 import { getScriptNonceFromNodeHeaderSources } from "./csp.js";
 import { logRequest, now } from "./request-log.js";
@@ -26,12 +25,15 @@ import { detectLocaleFromAcceptLanguage, extractLocaleFromUrl as extractLocaleFr
 import { buildDefaultPagesNotFoundResponse } from "./pages-default-404.js";
 import { buildPagesReadinessNextData } from "./pages-readiness.js";
 import { resolvePagesPageMethodResponse } from "./pages-page-method.js";
-import { createPagesDevModuleUrl } from "./pages-dev-module-url.js";
-import { isSerializableProps } from "./pages-serializable-props.js";
 import { loadUserDocumentInitialProps, runDocumentRenderPage } from "./pages-document-initial-props.js";
 import { callDocumentGetInitialProps } from "./document-initial-head.js";
 import { hasPagesGetInitialProps, loadDevAppInitialProps, loadPagesGetInitialProps } from "./pages-get-initial-props.js";
+import { isSerializableProps } from "./pages-serializable-props.js";
 import { isBotUserAgent } from "../utils/html-limited-bots.js";
+import { getPagesRouteParams, matchesPagesStaticPath } from "./pages-page-data.js";
+import { createPagesDevAssetUrl, createPagesDevModuleUrl } from "./pages-dev-module-url.js";
+import { getManifestFilesForModule } from "./pages-asset-tags.js";
+import { attachPagesRequestCookies, getPagesPreviewDataFromCookieHeader } from "./pages-node-compat.js";
 import path from "node:path";
 import React from "react";
 import { renderToReadableStream } from "react-dom/server.edge";
@@ -51,6 +53,35 @@ async function renderToStringAsync(element) {
 async function renderIsrPassToStringAsync(element) {
 	return await runWithServerInsertedHTMLState(() => runWithHeadState(() => _runWithCacheState(() => runWithPrivateCache(() => runWithFetchCache(async () => renderToStringAsync(element))))));
 }
+const DEV_STYLESHEET_ASSET_RE = /\.(?:css|scss|sass)$/i;
+function createDevInitialStylesheetHeadHTML(options) {
+	const { ssrManifest, moduleIds, nonceAttr } = options;
+	if (!ssrManifest || moduleIds.length === 0) return "";
+	const seen = /* @__PURE__ */ new Set();
+	let html = "";
+	for (const moduleId of moduleIds) {
+		const files = getManifestFilesForModule(ssrManifest, moduleId);
+		if (!files) continue;
+		for (const file of files) {
+			if (!DEV_STYLESHEET_ASSET_RE.test(file) || seen.has(file)) continue;
+			seen.add(file);
+			const href = createPagesDevAssetUrl(file);
+			html += `<link rel="stylesheet"${nonceAttr} href="${escapeHtmlAttr(href)}" />\n  `;
+		}
+	}
+	return html;
+}
+async function collectDevInitialStylesheetHeadHTML(runner, moduleIds, nonceAttr) {
+	try {
+		return createDevInitialStylesheetHeadHTML({
+			ssrManifest: (await runner.import("virtual:vinext-pages-client-assets")).default?.ssrManifest,
+			moduleIds,
+			nonceAttr
+		});
+	} catch {
+		return "";
+	}
+}
 /**
 * Emit a `getServerSideProps` / `getStaticProps` `{ redirect }` result.
 *
@@ -101,7 +132,7 @@ const STREAM_BODY_MARKER = "<!--VINEXT_STREAM_BODY-->";
 * shell sooner).
 */
 async function streamPageToResponse(res, element, options) {
-	const { url, server, fontHeadHTML, scripts, DocumentComponent, statusCode = 200, extraHeaders, getHeadHTML, enhancePageElement, scriptNonce, documentContext, setDocumentInitialHead, bufferBodyBeforeHeaders = false } = options;
+	const { url, server, fontHeadHTML, assetHeadHTML = "", scripts, DocumentComponent, statusCode, extraHeaders, getHeadHTML, enhancePageElement, scriptNonce, documentContext, setDocumentInitialHead, bufferBodyBeforeHeaders = false } = options;
 	const documentRenderPage = await runDocumentRenderPage({
 		DocumentComponent,
 		enhancePageElement,
@@ -110,6 +141,7 @@ async function streamPageToResponse(res, element, options) {
 		scriptNonce,
 		context: documentContext
 	});
+	if (res.headersSent || res.writableEnded) return;
 	let bodyStream;
 	if (documentRenderPage.status === "rendered") {
 		const synthesised = documentRenderPage.bodyHtml;
@@ -127,7 +159,7 @@ async function streamPageToResponse(res, element, options) {
 		const docProps = documentRenderPage.status === "skipped" ? await loadUserDocumentInitialProps(DocumentComponent) : documentRenderPage.docProps;
 		let docHtml = await renderToStringAsync(docProps ? React.createElement(DocumentComponent, docProps) : React.createElement(DocumentComponent));
 		docHtml = docHtml.replace("__NEXT_MAIN__", STREAM_BODY_MARKER);
-		if (headHTML || fontHeadHTML) docHtml = docHtml.replace("</head>", `  ${fontHeadHTML}${headHTML}\n</head>`);
+		if (headHTML || fontHeadHTML || assetHeadHTML) docHtml = docHtml.replace("</head>", `  ${fontHeadHTML}${headHTML}\n  ${assetHeadHTML}\n</head>`);
 		docHtml = docHtml.replace("<!-- __NEXT_SCRIPTS__ -->", scripts);
 		if (!docHtml.includes("__NEXT_DATA__")) docHtml = docHtml.replace("</body>", `  ${scripts}\n</body>`);
 		shellTemplate = docHtml;
@@ -135,6 +167,7 @@ async function streamPageToResponse(res, element, options) {
 <html>
 <head>
   ${fontHeadHTML}${headHTML}
+  ${assetHeadHTML}
 </head>
 <body>
   <div id="__next">${STREAM_BODY_MARKER}</div>
@@ -152,7 +185,7 @@ async function streamPageToResponse(res, element, options) {
 	};
 	if (extraHeaders) for (const [key, val] of Object.entries(extraHeaders)) if (Array.isArray(val)) res.setHeader(key, val);
 	else headers[key] = val;
-	res.writeHead(statusCode, headers);
+	res.writeHead(statusCode ?? res.statusCode, headers);
 	res.write(prefix);
 	if (bufferedBody !== null) {
 		res.end(bufferedBody + suffix);
@@ -202,7 +235,7 @@ function parseCookieLocale(req, i18nConfig) {
 * 4. Render the component to HTML
 * 5. Wrap in _document shell and send response
 */
-function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatcher, basePath = "", trailingSlash = false, hasMiddleware = false, hasRewrites = false, clientTraceMetadata, htmlLimitedBots) {
+function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatcher, basePath = "", trailingSlash = false, hasMiddleware = false, hasRewrites = false, clientTraceMetadata, htmlLimitedBots, reactStrictMode = false) {
 	const matcher = fileMatcher ?? createValidFileMatcher();
 	const pagePatterns = routes.map((r) => patternToNextFormat(r.pattern));
 	const _alsRegistration = Promise.all([runner.import("vinext/head-state"), runner.import("vinext/router-state")]);
@@ -211,6 +244,7 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 		const _reqStart = now();
 		let _compileEnd;
 		let _renderEnd;
+		attachPagesRequestCookies(req);
 		res.on("finish", () => {
 			const totalMs = now() - _reqStart;
 			const compileMs = _compileEnd !== void 0 ? Math.round(_compileEnd - _reqStart) : void 0;
@@ -248,8 +282,9 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 			if (isDataReq) {
 				const deploymentId = process.env.__VINEXT_DEPLOYMENT_ID || process.env.NEXT_DEPLOYMENT_ID;
 				const notFoundHeaders = { "Content-Type": "application/json" };
+				if (hasMiddleware) notFoundHeaders["x-nextjs-matched-path"] = `${locale ? `/${locale}` : ""}${localeStrippedUrl}`;
 				if (deploymentId) notFoundHeaders[NEXTJS_DEPLOYMENT_ID_HEADER] = deploymentId;
-				res.writeHead(404, notFoundHeaders);
+				res.writeHead(hasMiddleware ? 200 : 404, notFoundHeaders);
 				res.end("{}");
 				return;
 			}
@@ -333,6 +368,7 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 				let isrRevalidateSeconds = null;
 				let isFallbackRender = false;
 				let shouldPersistFallbackData = false;
+				let staticPropsPreviewData = false;
 				if (typeof pageModule.getStaticPaths === "function" && route.isDynamic) {
 					const pathsResult = await pageModule.getStaticPaths({
 						locales: i18nConfig?.locales ?? [],
@@ -340,17 +376,8 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 					});
 					const fallback = pathsResult?.fallback ?? false;
 					const paths = pathsResult?.paths ?? [];
-					const currentPathname = normalizeStaticPathname(url);
-					const isValidPath = paths.some((p) => {
-						if (typeof p === "string") return normalizeStaticPathname(p) === currentPathname;
-						const entryParams = p.params;
-						if (entryParams === void 0 || entryParams === null) return false;
-						return Object.entries(entryParams).every(([key, val]) => {
-							const actual = params[key];
-							if (Array.isArray(val)) return Array.isArray(actual) && val.join("/") === actual.join("/");
-							return String(val) === String(actual);
-						});
-					});
+					const routeParams = getPagesRouteParams(patternToNextFormat(route.pattern));
+					const isValidPath = paths.some((pathEntry) => matchesPagesStaticPath(pathEntry, params, routeParams, url));
 					if (fallback === false && !isValidPath) {
 						if (isDataReq) {
 							const deploymentId = process.env.__VINEXT_DEPLOYMENT_ID || process.env.NEXT_DEPLOYMENT_ID;
@@ -421,6 +448,12 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 						__N_SSP: true
 					};
 					const headersBeforeGSSP = new Set(Object.keys(res.getHeaders()));
+					const previewData = getPagesPreviewDataFromCookieHeader(req.headers.cookie);
+					const previewContext = previewData === false ? {} : {
+						draftMode: true,
+						preview: true,
+						previewData
+					};
 					const context = {
 						params: userFacingParams,
 						req,
@@ -429,7 +462,8 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 						resolvedUrl: gsspResolvedUrl,
 						locale: locale ?? currentDefaultLocale,
 						locales: i18nConfig?.locales,
-						defaultLocale: currentDefaultLocale
+						defaultLocale: currentDefaultLocale,
+						...previewContext
 					};
 					const result = await pageModule.getServerSideProps(context);
 					if (res.writableEnded) return;
@@ -485,7 +519,14 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 					const cacheKey = pagesIsrCacheKey(url.split("?")[0]);
 					const cached = await isrGet(cacheKey);
 					const isOnDemandRevalidate = isOnDemandRevalidateRequest(req.headers[PRERENDER_REVALIDATE_HEADER]);
-					if (!isOnDemandRevalidate && cached && !cached.isStale && cached.value.value?.kind === "PAGES" && !cached.value.value.generatedFromDataRequest && !scriptNonce && !isDataReq) {
+					const previewData = getPagesPreviewDataFromCookieHeader(req.headers.cookie, { isOnDemandRevalidate });
+					staticPropsPreviewData = previewData;
+					const previewContext = previewData === false ? {} : {
+						draftMode: true,
+						preview: true,
+						previewData
+					};
+					if (!isOnDemandRevalidate && cached && !cached.isStale && cached.value.value?.kind === "PAGES" && !cached.value.value.generatedFromDataRequest && !scriptNonce && !isDataReq && previewData === false) {
 						const cachedHtml = cached.value.value.html;
 						const transformedHtml = await server.transformIndexHtml(url, cachedHtml);
 						const { cacheControl: hitCacheControl } = decideIsr({
@@ -503,7 +544,7 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 						res.end(transformedHtml);
 						return;
 					}
-					if (!isOnDemandRevalidate && cached && cached.isStale && cached.value.value?.kind === "PAGES" && !cached.value.value.generatedFromDataRequest && !scriptNonce && !isDataReq) {
+					if (!isOnDemandRevalidate && cached && cached.isStale && cached.value.value?.kind === "PAGES" && !cached.value.value.generatedFromDataRequest && !scriptNonce && !isDataReq && previewData === false) {
 						const cachedHtml = cached.value.value.html;
 						const transformedHtml = await server.transformIndexHtml(url, cachedHtml);
 						triggerBackgroundRegeneration(cacheKey, async () => {
@@ -682,9 +723,10 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 						locale: locale ?? currentDefaultLocale,
 						locales: i18nConfig?.locales,
 						defaultLocale: currentDefaultLocale,
-						revalidateReason: isOnDemandRevalidate ? "on-demand" : "stale"
+						revalidateReason: isOnDemandRevalidate ? "on-demand" : "stale",
+						...previewContext
 					};
-					const generatedPageData = !isOnDemandRevalidate && cached?.isStale === false && cached?.value.value?.kind === "PAGES" && cached.value.value.generatedFromDataRequest && isUnknownRecord(cached.value.value.pageData) ? cached.value.value.pageData : null;
+					const generatedPageData = !isOnDemandRevalidate && previewData === false && cached?.isStale === false && cached?.value.value?.kind === "PAGES" && cached.value.value.generatedFromDataRequest && isUnknownRecord(cached.value.value.pageData) ? cached.value.value.pageData : null;
 					if (!generatedPageData && await loadAppInitialProps()) return;
 					const result = generatedPageData ? null : await pageModule.getStaticProps(context);
 					if (generatedPageData) {
@@ -718,8 +760,8 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 						return;
 					}
 					if (result && "props" in result) isSerializableProps(patternToNextFormat(route.pattern), "getStaticProps", pageProps);
-					if (typeof result?.revalidate === "number" && result.revalidate > 0) isrRevalidateSeconds = result.revalidate;
-					else if (cached?.value.value?.kind === "PAGES" && cached.value.value.generatedFromDataRequest) isrRevalidateSeconds = cached.value.cacheControl?.revalidate ?? 31536e3;
+					if (previewData === false && typeof result?.revalidate === "number" && result.revalidate > 0) isrRevalidateSeconds = result.revalidate;
+					else if (previewData === false && cached?.value.value?.kind === "PAGES" && cached.value.value.generatedFromDataRequest) isrRevalidateSeconds = cached.value.cacheControl?.revalidate ?? 31536e3;
 				}
 				if (typeof pageModule.getServerSideProps !== "function" && typeof pageModule.getStaticProps !== "function" && hasAppGetInitialProps) {
 					if (await loadAppInitialProps()) return;
@@ -748,7 +790,7 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 					}
 				}
 				if (isDataReq) {
-					if (shouldPersistFallbackData) {
+					if (shouldPersistFallbackData && staticPropsPreviewData === false) {
 						const cacheKey = pagesIsrCacheKey(url.split("?")[0]);
 						const revalidateSeconds = isrRevalidateSeconds ?? 31536e3;
 						await isrSet(cacheKey, {
@@ -762,6 +804,7 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 						setRevalidateDuration(cacheKey, revalidateSeconds);
 					}
 					const dataHeaders = { "Content-Type": "application/json" };
+					if ((statusCode ?? 200) === 200) dataHeaders["x-nextjs-matched-path"] = `${locale ? `/${locale}` : ""}${patternToNextFormat(route.pattern)}`;
 					if (gsspExtraHeaders) for (const [k, v] of Object.entries(gsspExtraHeaders)) dataHeaders[k] = v;
 					const dataRoutePattern = patternToNextFormat(route.pattern);
 					if (dataRoutePattern !== "/_error" && dataRoutePattern !== "/500") {
@@ -790,6 +833,7 @@ function createSSRHandler(server, runner, routes, pagesDir, i18nConfig, fileMatc
 				if (typeof dynamicShim.flushPreloads === "function") await dynamicShim.flushPreloads();
 				const nonceAttr = createNonceAttribute(scriptNonce);
 				let fontHeadHTML = "";
+				const assetHeadHTML = await collectDevInitialStylesheetHeadHTML(runner, [AppComponent ? findFileWithExts(pagesDir, "_app", matcher) : null, route.filePath], nonceAttr);
 				const allFontStyles = [];
 				const allFontPreloads = [];
 				try {
@@ -851,6 +895,9 @@ const rawPageProps = props.pageProps;
 const pageProps = rawPageProps && typeof rawPageProps === "object" ? rawPageProps : {};
 window.__VINEXT_PAGE_LOADERS__ = { [nextData.page]: () => import("${pageModuleSource}") };
 window.__VINEXT_APP_LOADER__ = ${appModuleSource ? `() => import("${appModuleSource}")` : "undefined"};
+// reactStrictMode flag — read by wrapWithRouterContext so the <React.StrictMode>
+// wrap is applied on initial hydration and every navigation (matches Next.js).
+window.__VINEXT_REACT_STRICT_MODE__ = ${JSON.stringify(reactStrictMode === true)};
 
 async function hydrate() {
   let hydrateRootOptions;
@@ -927,6 +974,7 @@ hydrate();
 					url,
 					server,
 					fontHeadHTML,
+					assetHeadHTML,
 					scripts: allScripts,
 					DocumentComponent,
 					statusCode,
@@ -935,7 +983,11 @@ hydrate();
 					documentContext: {
 						pathname: patternToNextFormat(route.pattern),
 						query,
-						asPath: requestAsPath
+						asPath: requestAsPath,
+						...pagesNextData.autoExport === true ? {} : {
+							req,
+							res
+						}
 					},
 					enhancePageElement: (renderPageOpts) => {
 						let FinalApp = AppComponent;
@@ -969,7 +1021,7 @@ hydrate();
 						pageProps
 					}) : createElement(pageModule.default, pageProps);
 					if (wrapWithRouterContext) isrElement = wrapWithRouterContext(isrElement);
-					const isrHtml = `<!DOCTYPE html><html><head></head><body><div id="__next">${await renderIsrPassToStringAsync(withScriptNonce(isrElement, scriptNonce))}</div>${allScripts}</body></html>`;
+					const isrHtml = `<!DOCTYPE html><html><head>${assetHeadHTML}</head><body><div id="__next">${await renderIsrPassToStringAsync(withScriptNonce(isrElement, scriptNonce))}</div>${allScripts}</body></html>`;
 					const cacheKey = pagesIsrCacheKey(url.split("?")[0]);
 					await isrSet(cacheKey, buildPagesCacheValue(isrHtml, pageProps), isrRevalidateSeconds);
 					setRevalidateDuration(cacheKey, isrRevalidateSeconds);
@@ -1004,17 +1056,19 @@ hydrate();
 * - other: pages/_error.tsx -> default
 */
 async function renderErrorPage(server, runner, req, res, url, pagesDir, statusCode, wrapWithRouterContext, fileMatcher, err) {
+	attachPagesRequestCookies(req);
 	const matcher = fileMatcher ?? createValidFileMatcher();
 	const candidates = statusCode === 404 ? ["404", "_error"] : statusCode === 500 ? ["500", "_error"] : ["_error"];
 	for (const candidate of candidates) try {
-		const candidatePath = path.join(pagesDir, candidate);
-		if (!findFileWithExtensions(candidatePath, matcher)) continue;
-		const ErrorComponent = (await importModule(runner, candidatePath)).default;
+		const errorAssetPath = findFileWithExts(pagesDir, candidate, matcher);
+		if (!errorAssetPath) continue;
+		const ErrorComponent = (await importModule(runner, errorAssetPath)).default;
 		if (!ErrorComponent) continue;
 		let AppComponent = null;
 		const appPathErr = path.join(pagesDir, "_app");
+		const appAssetPath = findFileWithExts(pagesDir, "_app", matcher);
 		if (findFileWithExtensions(appPathErr, matcher)) try {
-			AppComponent = (await importModule(runner, appPathErr)).default ?? null;
+			AppComponent = (await importModule(runner, appAssetPath ?? appPathErr)).default ?? null;
 		} catch {}
 		const createElement = React.createElement;
 		const initialErrorProps = await loadPagesGetInitialProps(ErrorComponent, {
@@ -1050,12 +1104,16 @@ async function renderErrorPage(server, runner, req, res, url, pagesDir, statusCo
 		const element = createErrorElement(AppComponent, ErrorComponent);
 		const headShim = await importModule(runner, "next/head");
 		if (typeof headShim.resetSSRHead === "function") headShim.resetSSRHead();
+		const responseHeaders = typeof res.getHeaders === "function" ? res.getHeaders() : void 0;
+		const nonceAttr = createNonceAttribute(getScriptNonceFromNodeHeaderSources(req.headers, responseHeaders));
+		const assetHeadHTML = await collectDevInitialStylesheetHeadHTML(runner, [appAssetPath, errorAssetPath], nonceAttr);
 		if (DocumentComponent) {
 			const errorPathname = candidate === "_error" ? "/_error" : `/${candidate}`;
 			await streamPageToResponse(res, element, {
 				url,
 				server,
 				fontHeadHTML: "",
+				assetHeadHTML,
 				scripts: "",
 				DocumentComponent,
 				statusCode,
@@ -1083,6 +1141,7 @@ async function renderErrorPage(server, runner, req, res, url, pagesDir, statusCo
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1" />
+  ${assetHeadHTML}
 </head>
 <body>
   <div id="__next">${await renderToStringAsync(element)}</div>

package/dist/server/dev-stack-sourcemap.d.ts

@@ -1,4 +1,4 @@
-import { VINEXT_ORIGINAL_STACK_TRACE_ENDPOINT } from "./dev-stack-sourcemap-endpoint.js";
+import { VINEXT_ORIGINAL_STACK_TRACE_ENDPOINT } from "../utils/dev-stack-sourcemap-endpoint.js";
 import { ViteDevServer } from "vite";
 
 //#region src/server/dev-stack-sourcemap.d.ts

package/dist/server/dev-stack-sourcemap.js

@@ -1,4 +1,4 @@
-import { VINEXT_ORIGINAL_STACK_TRACE_ENDPOINT } from "./dev-stack-sourcemap-endpoint.js";
+import { VINEXT_ORIGINAL_STACK_TRACE_ENDPOINT } from "../utils/dev-stack-sourcemap-endpoint.js";
 import { readFile } from "node:fs/promises";
 import { fileURLToPath, pathToFileURL } from "node:url";
 //#region src/server/dev-stack-sourcemap.ts

package/dist/server/fetch-handler.d.ts

@@ -0,0 +1,2 @@
+import handler from "virtual:vinext-worker-entry";
+export { handler as default };

package/dist/server/fetch-handler.js

@@ -0,0 +1,18 @@
+import handler from "virtual:vinext-worker-entry";
+//#region src/server/fetch-handler.ts
+/**
+* Default Cloudflare fetch handler for vinext.
+*
+* Use this directly in wrangler.jsonc:
+*   "main": "vinext/server/fetch-handler"
+*
+* Or import and delegate to it from a custom worker:
+*   import handler from "vinext/server/fetch-handler";
+*   return handler.fetch(request, env, ctx);
+*
+* The vinext plugin resolves this to the App Router or Pages Router handler
+* for the current project at build time.
+*/
+var fetch_handler_default = handler;
+//#endregion
+export { fetch_handler_default as default };

package/dist/server/headers.d.ts

@@ -1,3 +1,5 @@
+import { MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_SET_COOKIE_HEADER, MIDDLEWARE_SKIP_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER, VINEXT_PRERENDER_SPECULATIVE_HEADER } from "../utils/protocol-headers.js";
+
 //#region src/server/headers.d.ts
 /**
  * Internal HTTP header name constants used throughout vinext.
@@ -15,14 +17,8 @@ declare const VINEXT_CACHE_HEADER = "X-Vinext-Cache";
 declare const NEXTJS_CACHE_HEADER = "x-nextjs-cache";
 /** Static file signal — value is URL-encoded pathname. */
 declare const VINEXT_STATIC_FILE_HEADER = "x-vinext-static-file";
-/** Serialized middleware context (JSON) forwarded from dev server to RSC entry. */
-declare const VINEXT_MW_CTX_HEADER = "x-vinext-mw-ctx";
 /** Timing metrics: `handlerStart,compileMs,renderMs`. */
 declare const VINEXT_TIMING_HEADER = "x-vinext-timing";
-/** Build-time prerender authentication secret. */
-declare const VINEXT_PRERENDER_SECRET_HEADER = "x-vinext-prerender-secret";
-/** URL-encoded JSON route params for build-time prerender renders. */
-declare const VINEXT_PRERENDER_ROUTE_PARAMS_HEADER = "x-vinext-prerender-route-params";
 /** Internal endpoint used to evaluate App Router generateStaticParams exports. */
 declare const VINEXT_PRERENDER_STATIC_PARAMS_PATH = "/__vinext/prerender/static-params";
 /** Internal endpoint used to evaluate Pages Router getStaticPaths exports. */
@@ -37,6 +33,10 @@ declare const VINEXT_PARAMS_HEADER = "X-Vinext-Params";
 declare const VINEXT_MOUNTED_SLOTS_HEADER = "X-Vinext-Mounted-Slots";
 /** Per-page dynamic stale time in seconds for App Router RSC responses. */
 declare const VINEXT_DYNAMIC_STALE_TIME_HEADER = "X-Vinext-Dynamic-Stale-Time";
+/** URL-encoded rendered path and search after middleware/config rewrites. */
+declare const VINEXT_RENDERED_PATH_AND_SEARCH_HEADER = "X-Vinext-Rendered-Path-And-Search";
+/** Prerender-only JSON side channel carrying request cacheLife metadata. */
+declare const VINEXT_PRERENDER_CACHE_LIFE_HEADER = "x-vinext-prerender-cache-life";
 /** Route interception context for parallel/intercepting routes. */
 declare const VINEXT_INTERCEPTION_CONTEXT_HEADER = "X-Vinext-Interception-Context";
 /** RSC render mode (e.g. "navigation", "prefetch"). */
@@ -81,18 +81,10 @@ declare const ACTION_REDIRECT_HEADER = "x-action-redirect";
 declare const ACTION_REDIRECT_TYPE_HEADER = "x-action-redirect-type";
 /** HTTP status for a Server Action redirect (e.g. "308"). */
 declare const ACTION_REDIRECT_STATUS_HEADER = "x-action-redirect-status";
-/** Prefix for forwarded request headers (e.g. `x-middleware-request-cookie`). */
-declare const MIDDLEWARE_REQUEST_HEADER_PREFIX = "x-middleware-request-";
-/** Comma-separated list of header names that middleware wants to override. */
-declare const MIDDLEWARE_OVERRIDE_HEADERS = "x-middleware-override-headers";
-/** Carries cookies set by middleware for same-render reads. */
-declare const MIDDLEWARE_SET_COOKIE_HEADER = "x-middleware-set-cookie";
 /** Signal from `NextResponse.next()` — value "1" means "continue to next handler". */
 declare const MIDDLEWARE_NEXT_HEADER = "x-middleware-next";
 /** Rewrite destination URL set by `NextResponse.rewrite()`. */
 declare const MIDDLEWARE_REWRITE_HEADER = "x-middleware-rewrite";
-/** Generic prefix for all middleware internal headers. */
-declare const MIDDLEWARE_HEADER_PREFIX = "x-middleware-";
 declare const NEXT_ROUTER_STATE_TREE_HEADER = "Next-Router-State-Tree";
 declare const NEXT_ROUTER_PREFETCH_HEADER = "Next-Router-Prefetch";
 declare const NEXT_ROUTER_SEGMENT_PREFETCH_HEADER = "Next-Router-Segment-Prefetch";
@@ -113,4 +105,4 @@ declare const INTERNAL_HEADERS: string[];
 /** Vinext-only internal headers stripped alongside Next.js protocol internals. */
 declare const VINEXT_INTERNAL_HEADERS: string[];
 //#endregion
-export { ACTION_FORWARDED_HEADER, ACTION_REDIRECT_HEADER, ACTION_REDIRECT_STATUS_HEADER, ACTION_REDIRECT_TYPE_HEADER, ACTION_REVALIDATED_HEADER, FLIGHT_HEADERS, INTERNAL_HEADERS, MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_NEXT_HEADER, MIDDLEWARE_OVERRIDE_HEADERS, MIDDLEWARE_REQUEST_HEADER_PREFIX, MIDDLEWARE_REWRITE_HEADER, MIDDLEWARE_SET_COOKIE_HEADER, NEXTJS_ACTION_NOT_FOUND_HEADER, NEXTJS_CACHE_HEADER, NEXTJS_DEPLOYMENT_ID_HEADER, NEXT_ACTION_HEADER, NEXT_HTML_REQUEST_ID_HEADER, NEXT_REQUEST_ID_HEADER, NEXT_ROUTER_PREFETCH_HEADER, NEXT_ROUTER_SEGMENT_PREFETCH_HEADER, NEXT_ROUTER_STATE_TREE_HEADER, NEXT_URL_HEADER, RSC_ACTION_HEADER, RSC_HEADER, VINEXT_CACHE_HEADER, VINEXT_CLIENT_REUSE_MANIFEST_HEADER, VINEXT_DYNAMIC_STALE_TIME_HEADER, VINEXT_INTERCEPTION_CONTEXT_HEADER, VINEXT_INTERNAL_HEADERS, VINEXT_MOUNTED_SLOTS_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PARAMS_HEADER, VINEXT_PRERENDER_PAGES_STATIC_PATHS_PATH, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER, VINEXT_PRERENDER_STATIC_PARAMS_PATH, VINEXT_REVALIDATE_HEADER, VINEXT_RSC_MARKER_HEADER, VINEXT_RSC_REDIRECT_HEADER, VINEXT_RSC_RENDER_MODE_HEADER, VINEXT_STATIC_FILE_HEADER, VINEXT_TIMING_HEADER };
+export { ACTION_FORWARDED_HEADER, ACTION_REDIRECT_HEADER, ACTION_REDIRECT_STATUS_HEADER, ACTION_REDIRECT_TYPE_HEADER, ACTION_REVALIDATED_HEADER, FLIGHT_HEADERS, INTERNAL_HEADERS, MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_NEXT_HEADER, MIDDLEWARE_REWRITE_HEADER, MIDDLEWARE_SET_COOKIE_HEADER, MIDDLEWARE_SKIP_HEADER, NEXTJS_ACTION_NOT_FOUND_HEADER, NEXTJS_CACHE_HEADER, NEXTJS_DEPLOYMENT_ID_HEADER, NEXT_ACTION_HEADER, NEXT_HTML_REQUEST_ID_HEADER, NEXT_REQUEST_ID_HEADER, NEXT_ROUTER_PREFETCH_HEADER, NEXT_ROUTER_SEGMENT_PREFETCH_HEADER, NEXT_ROUTER_STATE_TREE_HEADER, NEXT_URL_HEADER, RSC_ACTION_HEADER, RSC_HEADER, VINEXT_CACHE_HEADER, VINEXT_CLIENT_REUSE_MANIFEST_HEADER, VINEXT_DYNAMIC_STALE_TIME_HEADER, VINEXT_INTERCEPTION_CONTEXT_HEADER, VINEXT_INTERNAL_HEADERS, VINEXT_MOUNTED_SLOTS_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PARAMS_HEADER, VINEXT_PRERENDER_CACHE_LIFE_HEADER, VINEXT_PRERENDER_PAGES_STATIC_PATHS_PATH, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER, VINEXT_PRERENDER_SPECULATIVE_HEADER, VINEXT_PRERENDER_STATIC_PARAMS_PATH, VINEXT_RENDERED_PATH_AND_SEARCH_HEADER, VINEXT_REVALIDATE_HEADER, VINEXT_RSC_MARKER_HEADER, VINEXT_RSC_REDIRECT_HEADER, VINEXT_RSC_RENDER_MODE_HEADER, VINEXT_STATIC_FILE_HEADER, VINEXT_TIMING_HEADER };

package/dist/server/headers.js

@@ -1,3 +1,4 @@
+import { MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_OVERRIDE_HEADERS, MIDDLEWARE_SET_COOKIE_HEADER, MIDDLEWARE_SKIP_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER, VINEXT_PRERENDER_SPECULATIVE_HEADER } from "../utils/protocol-headers.js";
 //#region src/server/headers.ts
 /**
 * Internal HTTP header name constants used throughout vinext.
@@ -15,14 +16,8 @@ const VINEXT_CACHE_HEADER = "X-Vinext-Cache";
 const NEXTJS_CACHE_HEADER = "x-nextjs-cache";
 /** Static file signal — value is URL-encoded pathname. */
 const VINEXT_STATIC_FILE_HEADER = "x-vinext-static-file";
-/** Serialized middleware context (JSON) forwarded from dev server to RSC entry. */
-const VINEXT_MW_CTX_HEADER = "x-vinext-mw-ctx";
 /** Timing metrics: `handlerStart,compileMs,renderMs`. */
 const VINEXT_TIMING_HEADER = "x-vinext-timing";
-/** Build-time prerender authentication secret. */
-const VINEXT_PRERENDER_SECRET_HEADER = "x-vinext-prerender-secret";
-/** URL-encoded JSON route params for build-time prerender renders. */
-const VINEXT_PRERENDER_ROUTE_PARAMS_HEADER = "x-vinext-prerender-route-params";
 /** Internal endpoint used to evaluate App Router generateStaticParams exports. */
 const VINEXT_PRERENDER_STATIC_PARAMS_PATH = "/__vinext/prerender/static-params";
 /** Internal endpoint used to evaluate Pages Router getStaticPaths exports. */
@@ -37,6 +32,10 @@ const VINEXT_PARAMS_HEADER = "X-Vinext-Params";
 const VINEXT_MOUNTED_SLOTS_HEADER = "X-Vinext-Mounted-Slots";
 /** Per-page dynamic stale time in seconds for App Router RSC responses. */
 const VINEXT_DYNAMIC_STALE_TIME_HEADER = "X-Vinext-Dynamic-Stale-Time";
+/** URL-encoded rendered path and search after middleware/config rewrites. */
+const VINEXT_RENDERED_PATH_AND_SEARCH_HEADER = "X-Vinext-Rendered-Path-And-Search";
+/** Prerender-only JSON side channel carrying request cacheLife metadata. */
+const VINEXT_PRERENDER_CACHE_LIFE_HEADER = "x-vinext-prerender-cache-life";
 /** Route interception context for parallel/intercepting routes. */
 const VINEXT_INTERCEPTION_CONTEXT_HEADER = "X-Vinext-Interception-Context";
 /** RSC render mode (e.g. "navigation", "prefetch"). */
@@ -81,22 +80,12 @@ const ACTION_REDIRECT_HEADER = "x-action-redirect";
 const ACTION_REDIRECT_TYPE_HEADER = "x-action-redirect-type";
 /** HTTP status for a Server Action redirect (e.g. "308"). */
 const ACTION_REDIRECT_STATUS_HEADER = "x-action-redirect-status";
-/** Prefix for forwarded request headers (e.g. `x-middleware-request-cookie`). */
-const MIDDLEWARE_REQUEST_HEADER_PREFIX = "x-middleware-request-";
-/** Comma-separated list of header names that middleware wants to override. */
-const MIDDLEWARE_OVERRIDE_HEADERS = "x-middleware-override-headers";
-/** Carries cookies set by middleware for same-render reads. */
-const MIDDLEWARE_SET_COOKIE_HEADER = "x-middleware-set-cookie";
 /** Signal from `NextResponse.next()` — value "1" means "continue to next handler". */
 const MIDDLEWARE_NEXT_HEADER = "x-middleware-next";
 /** Rewrite destination URL set by `NextResponse.rewrite()`. */
 const MIDDLEWARE_REWRITE_HEADER = "x-middleware-rewrite";
 /** Redirect URL set by middleware. */
 const MIDDLEWARE_REDIRECT_HEADER = "x-middleware-redirect";
-/** Skip-middleware signal. */
-const MIDDLEWARE_SKIP_HEADER = "x-middleware-skip";
-/** Generic prefix for all middleware internal headers. */
-const MIDDLEWARE_HEADER_PREFIX = "x-middleware-";
 const NEXT_ROUTER_STATE_TREE_HEADER = "Next-Router-State-Tree";
 const NEXT_ROUTER_PREFETCH_HEADER = "Next-Router-Prefetch";
 const NEXT_ROUTER_SEGMENT_PREFETCH_HEADER = "Next-Router-Segment-Prefetch";
@@ -133,6 +122,10 @@ const INTERNAL_HEADERS = [
 	ACTION_FORWARDED_HEADER
 ];
 /** Vinext-only internal headers stripped alongside Next.js protocol internals. */
-const VINEXT_INTERNAL_HEADERS = [VINEXT_PRERENDER_ROUTE_PARAMS_HEADER];
+const VINEXT_INTERNAL_HEADERS = [
+	VINEXT_PRERENDER_ROUTE_PARAMS_HEADER,
+	VINEXT_PRERENDER_SPECULATIVE_HEADER,
+	VINEXT_PRERENDER_CACHE_LIFE_HEADER
+];
 //#endregion
-export { ACTION_FORWARDED_HEADER, ACTION_REDIRECT_HEADER, ACTION_REDIRECT_STATUS_HEADER, ACTION_REDIRECT_TYPE_HEADER, ACTION_REVALIDATED_HEADER, FLIGHT_HEADERS, INTERNAL_HEADERS, MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_NEXT_HEADER, MIDDLEWARE_OVERRIDE_HEADERS, MIDDLEWARE_REQUEST_HEADER_PREFIX, MIDDLEWARE_REWRITE_HEADER, MIDDLEWARE_SET_COOKIE_HEADER, NEXTJS_ACTION_NOT_FOUND_HEADER, NEXTJS_CACHE_HEADER, NEXTJS_DEPLOYMENT_ID_HEADER, NEXT_ACTION_HEADER, NEXT_HTML_REQUEST_ID_HEADER, NEXT_REQUEST_ID_HEADER, NEXT_ROUTER_PREFETCH_HEADER, NEXT_ROUTER_SEGMENT_PREFETCH_HEADER, NEXT_ROUTER_STATE_TREE_HEADER, NEXT_URL_HEADER, RSC_ACTION_HEADER, RSC_HEADER, VINEXT_CACHE_HEADER, VINEXT_CLIENT_REUSE_MANIFEST_HEADER, VINEXT_DYNAMIC_STALE_TIME_HEADER, VINEXT_INTERCEPTION_CONTEXT_HEADER, VINEXT_INTERNAL_HEADERS, VINEXT_MOUNTED_SLOTS_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PARAMS_HEADER, VINEXT_PRERENDER_PAGES_STATIC_PATHS_PATH, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER, VINEXT_PRERENDER_STATIC_PARAMS_PATH, VINEXT_REVALIDATE_HEADER, VINEXT_RSC_MARKER_HEADER, VINEXT_RSC_REDIRECT_HEADER, VINEXT_RSC_RENDER_MODE_HEADER, VINEXT_STATIC_FILE_HEADER, VINEXT_TIMING_HEADER };
+export { ACTION_FORWARDED_HEADER, ACTION_REDIRECT_HEADER, ACTION_REDIRECT_STATUS_HEADER, ACTION_REDIRECT_TYPE_HEADER, ACTION_REVALIDATED_HEADER, FLIGHT_HEADERS, INTERNAL_HEADERS, MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_NEXT_HEADER, MIDDLEWARE_REWRITE_HEADER, MIDDLEWARE_SET_COOKIE_HEADER, MIDDLEWARE_SKIP_HEADER, NEXTJS_ACTION_NOT_FOUND_HEADER, NEXTJS_CACHE_HEADER, NEXTJS_DEPLOYMENT_ID_HEADER, NEXT_ACTION_HEADER, NEXT_HTML_REQUEST_ID_HEADER, NEXT_REQUEST_ID_HEADER, NEXT_ROUTER_PREFETCH_HEADER, NEXT_ROUTER_SEGMENT_PREFETCH_HEADER, NEXT_ROUTER_STATE_TREE_HEADER, NEXT_URL_HEADER, RSC_ACTION_HEADER, RSC_HEADER, VINEXT_CACHE_HEADER, VINEXT_CLIENT_REUSE_MANIFEST_HEADER, VINEXT_DYNAMIC_STALE_TIME_HEADER, VINEXT_INTERCEPTION_CONTEXT_HEADER, VINEXT_INTERNAL_HEADERS, VINEXT_MOUNTED_SLOTS_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PARAMS_HEADER, VINEXT_PRERENDER_CACHE_LIFE_HEADER, VINEXT_PRERENDER_PAGES_STATIC_PATHS_PATH, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER, VINEXT_PRERENDER_SPECULATIVE_HEADER, VINEXT_PRERENDER_STATIC_PARAMS_PATH, VINEXT_RENDERED_PATH_AND_SEARCH_HEADER, VINEXT_REVALIDATE_HEADER, VINEXT_RSC_MARKER_HEADER, VINEXT_RSC_REDIRECT_HEADER, VINEXT_RSC_RENDER_MODE_HEADER, VINEXT_STATIC_FILE_HEADER, VINEXT_TIMING_HEADER };

package/dist/server/image-optimization.d.ts

@@ -121,5 +121,55 @@ type ImageHandlers = {
  * cache headers.
  */
 declare function handleImageOptimization(request: Request, handlers: ImageHandlers, allowedWidths?: number[], imageConfig?: ImageConfig): Promise<Response>;
+/**
+ * A server-side image optimizer: the transform backend that resizes/transcodes
+ * a source image. Produced by an adapter factory (e.g. `imagesOptimizer()` from
+ * `@vinext/cloudflare/images/images-optimizer`) and registered via
+ * {@link setImageOptimizer}.
+ */
+type ImageOptimizer = {
+  /** Transform the source image (resize, format, quality). */transformImage: (body: ReadableStream, options: {
+    width: number;
+    format: string;
+    quality: number;
+  }) => Promise<Response>;
+};
+/**
+ * Register the active image optimizer (transform backend). An explicit
+ * registration always wins; passing `null` clears it (falling back to
+ * unoptimized passthrough).
+ *
+ * Configure this declaratively via the `images.optimizer` option on the
+ * `vinext()` plugin in your `vite.config.ts` rather than calling it directly.
+ * On Cloudflare Workers:
+ *
+ * ```ts
+ * import { vinext } from "vinext";
+ * import { imagesOptimizer } from "@vinext/cloudflare/images/images-optimizer";
+ *
+ * export default defineConfig({
+ *   plugins: [vinext({ images: { optimizer: imagesOptimizer() } })],
+ * });
+ * ```
+ *
+ * The plugin registers the optimizer across every runtime/router entry, so you
+ * don't have to wire `env.IMAGES` into a custom worker entry. This setter
+ * remains the internal registration target.
+ */
+declare function setImageOptimizer(optimizer: ImageOptimizer | null): void;
+/** Get the active image optimizer, or `null` when none is configured. */
+declare function getImageOptimizer(): ImageOptimizer | null;
+/**
+ * Handle an image optimization request using the configured optimizer (if any).
+ *
+ * This is the single entry point every runtime/router seam (App Router worker,
+ * Pages worker, Node prod server) should call: it reads the registered
+ * {@link ImageOptimizer} and wires its `transformImage` into
+ * {@link handleImageOptimization}, with the caller supplying the runtime's
+ * `fetchAsset` (e.g. the Cloudflare `ASSETS` binding, or filesystem reads on
+ * Node). When no optimizer is registered, the request is served unoptimized
+ * (passthrough) with the same security/cache headers.
+ */
+declare function handleConfiguredImageOptimization(request: Request, fetchAsset: (path: string, request: Request) => Promise<Response>, allowedWidths?: number[], imageConfig?: ImageConfig): Promise<Response>;
 //#endregion
-export { DEFAULT_DEVICE_SIZES, DEFAULT_IMAGE_SIZES, IMAGE_CACHE_CONTROL, IMAGE_CONTENT_SECURITY_POLICY, IMAGE_OPTIMIZATION_PATH, ImageConfig, ImageHandlers, ParseImageParamsOptions, VINEXT_IMAGE_OPTIMIZATION_PATH, handleImageOptimization, isImageOptimizationPath, isSafeImageContentType, negotiateImageFormat, parseImageParams, resolveDevImageRedirect };
+export { DEFAULT_DEVICE_SIZES, DEFAULT_IMAGE_SIZES, IMAGE_CACHE_CONTROL, IMAGE_CONTENT_SECURITY_POLICY, IMAGE_OPTIMIZATION_PATH, ImageConfig, ImageHandlers, ImageOptimizer, ParseImageParamsOptions, VINEXT_IMAGE_OPTIMIZATION_PATH, getImageOptimizer, handleConfiguredImageOptimization, handleImageOptimization, isImageOptimizationPath, isSafeImageContentType, negotiateImageFormat, parseImageParams, resolveDevImageRedirect, setImageOptimizer };