vinext 1.0.0-beta.9 → 1.0.0

package/dist/check.js

@@ -1,5 +1,10 @@
+import { __toESM } from "./_virtual/_rolldown/runtime.js";
 import path from "./deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
-import { detectPackageManager, findDir } from "./utils/project.js";
+import { detectPackageManager, findDir, findViteConfigPath } from "./utils/project.js";
+import { normalizePageExtensions } from "./routing/file-matcher.js";
+import { POSTCSS_CONFIG_FILES } from "./plugins/postcss.js";
+import { unwrapExpression } from "./plugins/ast-utils.js";
+import { require_ignore } from "./deps/.pnpm/ignore@5.3.2/deps/ignore/index.js";
 import fs from "node:fs";
 import { parseAst } from "vite";
 //#region src/check.ts
@@ -9,6 +14,7 @@ import { parseAst } from "vite";
 * Scans an existing Next.js app and produces a compatibility report
 * showing what will work, what needs changes, and an overall score.
 */
+var import_ignore = /* @__PURE__ */ __toESM(require_ignore(), 1);
 /** Sort order for statuses: unsupported first, then partial, then supported. */
 const STATUS_ORDER = {
 	unsupported: 0,
@@ -20,31 +26,20 @@ function compareByStatus(a, b) {
 	return STATUS_ORDER[a.status] - STATUS_ORDER[b.status];
 }
 /**
-* App Router file conventions. Each convention lists the extensions that the
-* Next.js docs recognise for that file type — note that the boundary files
-* (loading/error/not-found) only exist as React components, so they don't
-* accept `.ts`/`.js`.
+* True if `relFile` (relative to the app directory) is an App Router file of
+* the given convention. Files inside private `_folder` segments are not routes.
+* `exts` are the dotted `pageExtensions` that vinext resolves conventions with.
 */
-const APP_ROUTER_EXTENSIONS = {
-	page: [
-		".tsx",
-		".jsx",
-		".ts",
-		".js"
-	],
-	layout: [
-		".tsx",
-		".jsx",
-		".ts",
-		".js"
-	],
-	loading: [".tsx", ".jsx"],
-	error: [".tsx", ".jsx"],
-	"not-found": [".tsx", ".jsx"]
-};
-/** True if `file` is an App Router file of the given convention. */
-function isAppRouterFile(file, type) {
-	return APP_ROUTER_EXTENSIONS[type].some((ext) => file.endsWith(`${type}${ext}`));
+function isAppRouterFile(relFile, type, exts) {
+	const segments = relFile.split("/");
+	const basename = segments.pop() ?? "";
+	if (segments.some((segment) => segment.startsWith("_"))) return false;
+	return exts.some((ext) => basename === `${type}${ext}`);
+}
+/** The first `<name><ext>` file found in `dir` for the given page extensions. */
+function findConventionFile(dir, name, exts) {
+	for (const ext of exts) if (fs.existsSync(path.join(dir, `${name}${ext}`))) return `${name}${ext}`;
+	return null;
 }
 const IMPORT_SUPPORT = {
 	next: {
@@ -54,7 +49,7 @@ const IMPORT_SUPPORT = {
 	"next/link": { status: "supported" },
 	"next/image": {
 		status: "supported",
-		detail: "uses @unpic/react (no local optimization yet)"
+		detail: "local images served via /_next/image (resized when an images optimizer is configured); remote images with width and height via @unpic/react, other remote images (fill or dimensionless) as a plain <img>"
 	},
 	"next/legacy/image": {
 		status: "supported",
@@ -69,28 +64,31 @@ const IMPORT_SUPPORT = {
 	"next/headers": { status: "supported" },
 	"next/server": {
 		status: "supported",
-		detail: "NextRequest/NextResponse shimmed"
+		detail: "NextRequest, NextResponse, NextFetchEvent, userAgent, userAgentFromString, after, connection"
 	},
 	"next/cache": {
 		status: "supported",
-		detail: "revalidateTag, revalidatePath, unstable_cache, io, cacheLife, cacheTag"
+		detail: "revalidateTag, revalidatePath, updateTag, refresh, unstable_cache, unstable_noStore, io, cacheLife, cacheTag"
 	},
 	"next/dynamic": { status: "supported" },
 	"next/head": { status: "supported" },
 	"next/script": { status: "supported" },
 	"next/font/google": {
-		status: "partial",
-		detail: "fonts loaded from CDN, not self-hosted at build time"
+		status: "supported",
+		detail: "self-hosted with fallback metrics; falls back to the Google Fonts CDN when font options aren't statically analyzable or the network fetch fails"
 	},
 	"next/font/local": {
 		status: "supported",
-		detail: "className and variable modes both work; no build-time subsetting"
+		detail: "className and variable modes both work; @font-face is generated at runtime; no adjusted fallback metrics (adjustFontFallback is ignored)"
 	},
 	"next/og": {
 		status: "supported",
 		detail: "ImageResponse via @vercel/og"
 	},
-	"next/config": { status: "supported" },
+	"next/config": {
+		status: "partial",
+		detail: "getConfig() returns empty publicRuntimeConfig/serverRuntimeConfig; runtime config was removed in Next.js 16, use environment variables"
+	},
 	"next/amp": {
 		status: "unsupported",
 		detail: "AMP is not supported"
@@ -114,7 +112,7 @@ const IMPORT_SUPPORT = {
 	},
 	"next/web-vitals": {
 		status: "supported",
-		detail: "reportWebVitals helper"
+		detail: "useReportWebVitals hook"
 	},
 	"next/constants": {
 		status: "supported",
@@ -140,19 +138,19 @@ const IMPORT_SUPPORT = {
 	},
 	"next/dist/shared/lib/utils": {
 		status: "supported",
-		detail: "execOnce, getLocationOrigin and other shared utilities"
+		detail: "execOnce, getLocationOrigin and a subset of the other shared helpers"
 	},
 	"next/dist/server/api-utils": {
 		status: "supported",
-		detail: "NextApiRequestCookies and Pages Router API route utilities"
+		detail: "NextApiRequestCookies / NextApiRequestQuery types"
 	},
 	"next/dist/server/web/spec-extension/cookies": {
 		status: "supported",
-		detail: "RequestCookies / ResponseCookies — shimmed via @edge-runtime/cookies"
+		detail: "RequestCookies / ResponseCookies"
 	},
 	"next/dist/compiled/@edge-runtime/cookies": {
 		status: "supported",
-		detail: "RequestCookies / ResponseCookies — shimmed via @edge-runtime/cookies"
+		detail: "RequestCookies / ResponseCookies"
 	},
 	"next/dist/server/app-render/work-unit-async-storage.external": {
 		status: "supported",
@@ -174,6 +172,14 @@ const IMPORT_SUPPORT = {
 		status: "supported",
 		detail: "internal navigation module; re-exports next/navigation"
 	},
+	"next/root-params": {
+		status: "supported",
+		detail: "root param getters generated from the root layout's dynamic segments; TypeScript types come from the next package"
+	},
+	"next/dist/server/request/root-params": {
+		status: "supported",
+		detail: "getRootParam()"
+	},
 	"next/dist/server/config-shared": {
 		status: "supported",
 		detail: "shared config utilities; re-exports next/dist/shared/lib/utils"
@@ -192,7 +198,7 @@ const CONFIG_SUPPORT = {
 	env: { status: "supported" },
 	images: {
 		status: "partial",
-		detail: "remotePatterns validated; on-the-fly optimization via images.optimizer (Cloudflare Images), passthrough otherwise"
+		detail: "remotePatterns, deviceSizes/imageSizes, qualities and SVG/CSP options honoured; resizing needs an optimizer via vinext({ images: { optimizer } }), images are served as-is otherwise; loader/loaderFile are ignored"
 	},
 	allowedDevOrigins: {
 		status: "supported",
@@ -204,11 +210,110 @@ const CONFIG_SUPPORT = {
 	},
 	transpilePackages: {
 		status: "supported",
-		detail: "Vite handles this natively"
+		detail: "listed packages are bundled instead of externalized on the server"
 	},
+	serverExternalPackages: {
+		status: "supported",
+		detail: "externalized on the Node.js server; Cloudflare Workers and Nitro builds bundle them, since there are no node_modules at runtime"
+	},
+	pageExtensions: { status: "supported" },
+	assetPrefix: { status: "supported" },
+	sassOptions: { status: "supported" },
+	generateBuildId: { status: "supported" },
+	deploymentId: { status: "supported" },
+	crossOrigin: { status: "supported" },
+	expireTime: { status: "supported" },
+	htmlLimitedBots: { status: "supported" },
+	cacheMaxMemorySize: { status: "supported" },
+	reactMaxHeadersLength: { status: "supported" },
+	"typescript.tsconfigPath": { status: "supported" },
+	turbopack: {
+		status: "partial",
+		detail: "resolveAlias and resolveExtensions are honoured; rules (loaders) are ignored"
+	},
+	instrumentationClientInject: { status: "supported" },
 	webpack: {
+		status: "partial",
+		detail: "resolve.alias, resolve.extensions and MDX loader options are carried over; other webpack loaders and plugins are ignored — migrate them to Vite plugins"
+	},
+	cacheHandler: {
+		status: "unsupported",
+		detail: "ignored; configure cache adapters with vinext({ cache }) in vite.config"
+	},
+	cacheHandlers: {
+		status: "unsupported",
+		detail: "ignored; configure cache adapters with vinext({ cache }) in vite.config"
+	},
+	cacheLife: {
+		status: "unsupported",
+		detail: "custom cacheLife profiles are ignored; only the built-in profiles are available"
+	},
+	"experimental.cacheLife": {
+		status: "unsupported",
+		detail: "custom cacheLife profiles are ignored; only the built-in profiles are available"
+	},
+	skipTrailingSlashRedirect: {
+		status: "unsupported",
+		detail: "ignored; trailing-slash redirects are always applied"
+	},
+	reactCompiler: {
+		status: "partial",
+		detail: "ignored; enable the React Compiler with vinext({ react: { compiler: true } })"
+	},
+	"experimental.reactCompiler": {
+		status: "partial",
+		detail: "ignored; enable the React Compiler with vinext({ react: { compiler: true } })"
+	},
+	modularizeImports: {
+		status: "partial",
+		detail: "ignored, so imports resolve unoptimized; experimental.optimizePackageImports is supported"
+	},
+	typedRoutes: {
+		status: "partial",
+		detail: "typed Link hrefs are not generated; vinext typegen provides PageProps/LayoutProps"
+	},
+	"compiler.define": { status: "supported" },
+	"compiler.defineServer": { status: "supported" },
+	"experimental.serverComponentsExternalPackages": {
+		status: "supported",
+		detail: "legacy alias of serverExternalPackages"
+	},
+	"experimental.turbo": {
+		status: "partial",
+		detail: "legacy alias of turbopack; resolveAlias and resolveExtensions are honoured, rules (loaders) are ignored"
+	},
+	"experimental.staleTimes": { status: "supported" },
+	"experimental.scrollRestoration": { status: "supported" },
+	"experimental.globalNotFound": { status: "supported" },
+	"experimental.clientTraceMetadata": { status: "supported" },
+	"experimental.useLightningcss": { status: "supported" },
+	"experimental.lightningCssFeatures": { status: "supported" },
+	"experimental.disableOptimizedLoading": { status: "supported" },
+	"experimental.gestureTransition": { status: "supported" },
+	"experimental.appNavFailHandling": { status: "supported" },
+	"experimental.rootParams": {
+		status: "supported",
+		detail: "no longer needed; root params are always available"
+	},
+	"compiler.removeConsole": {
+		status: "supported",
+		detail: "console calls are stripped from client bundles only"
+	},
+	"compiler.styledComponents": {
+		status: "partial",
+		detail: "SWC transform not applied; styled-components still work at runtime, without displayName or css prop support"
+	},
+	"compiler.emotion": {
+		status: "partial",
+		detail: "SWC transform not applied; @emotion/react still works at runtime, but component selectors need the transform"
+	},
+	"compiler.relay": {
 		status: "unsupported",
-		detail: "Vite replaces webpack — custom webpack configs need migration"
+		detail: "Relay graphql tag transform is not applied"
+	},
+	"experimental.optimizePackageImports": {
+		status: "supported",
+		detail: "barrel imports rewritten to direct imports"
 	},
 	enablePrerenderSourceMaps: {
 		status: "supported",
@@ -220,15 +325,19 @@ const CONFIG_SUPPORT = {
 	},
 	"experimental.ppr": {
 		status: "unsupported",
-		detail: "partial prerendering not yet implemented"
+		detail: "removed in Next.js 16 and ignored; use cacheComponents"
 	},
-	"experimental.typedRoutes": {
+	"experimental.dynamicIO": {
 		status: "unsupported",
-		detail: "typed routes not implemented"
+		detail: "renamed to cacheComponents in Next.js 16 and ignored; use cacheComponents"
+	},
+	"experimental.typedRoutes": {
+		status: "partial",
+		detail: "typed Link hrefs are not generated; vinext typegen provides PageProps/LayoutProps"
 	},
 	"experimental.serverActions": {
 		status: "supported",
-		detail: "server actions via 'use server' directive"
+		detail: "bodySizeLimit and allowedOrigins are enforced"
 	},
 	"experimental.allowedRevalidateHeaderKeys": {
 		status: "supported",
@@ -268,7 +377,7 @@ const CONFIG_SUPPORT = {
 	},
 	"experimental.middlewarePrefetch": {
 		status: "unsupported",
-		detail: "not recognized; use of this option is ignored"
+		detail: "deprecated alias of experimental.proxyPrefetch; ignored"
 	},
 	"experimental.proxyPrefetch": {
 		status: "unsupported",
@@ -276,7 +385,7 @@ const CONFIG_SUPPORT = {
 	},
 	"experimental.middlewareClientMaxBodySize": {
 		status: "unsupported",
-		detail: "not recognized; use of this option is ignored"
+		detail: "deprecated alias of experimental.proxyClientMaxBodySize; ignored"
 	},
 	"experimental.proxyClientMaxBodySize": {
 		status: "unsupported",
@@ -284,15 +393,15 @@ const CONFIG_SUPPORT = {
 	},
 	"experimental.externalMiddlewareRewritesResolve": {
 		status: "unsupported",
-		detail: "not recognized; use of this option is ignored"
+		detail: "deprecated alias of experimental.externalProxyRewritesResolve; ignored"
 	},
 	"experimental.externalProxyRewritesResolve": {
 		status: "unsupported",
 		detail: "not recognized; use of this option is ignored"
 	},
 	"experimental.instrumentationHook": {
-		status: "unsupported",
-		detail: "not recognized; instrumentation files are enabled automatically"
+		status: "supported",
+		detail: "no longer needed; instrumentation.ts is loaded automatically"
 	},
 	skipMiddlewareUrlNormalize: {
 		status: "partial",
@@ -312,7 +421,7 @@ const CONFIG_SUPPORT = {
 	},
 	poweredByHeader: {
 		status: "supported",
-		detail: "not sent (matching Next.js default when disabled)"
+		detail: "vinext never sends an X-Powered-By header"
 	}
 };
 const LIBRARY_SUPPORT = {
@@ -321,15 +430,15 @@ const LIBRARY_SUPPORT = {
 	"next-view-transitions": { status: "supported" },
 	"@vercel/analytics": {
 		status: "supported",
-		detail: "analytics script injected client-side"
+		detail: "renders client-side; by default events are only collected when deployed on Vercel"
 	},
 	"next-intl": {
-		status: "supported",
-		detail: "auto-detected from i18n/request.{ts,tsx,js,jsx}; createNextIntlPlugin wrapper not needed"
+		status: "partial",
+		detail: "auto-detected from (src/)i18n/request.{ts,tsx,js,jsx}, so createNextIntlPlugin isn't needed; client components can fail with \"No intl context found\" (cloudflare/vinext#177)"
 	},
 	"@clerk/nextjs": {
-		status: "partial",
-		detail: "clerkMiddleware, auth.protect, ClerkProvider, client hooks work; auth() in Server Components requires next/headers shim (wip)"
+		status: "supported",
+		detail: "clerkMiddleware, auth()/auth.protect in Server Components, ClerkProvider and client hooks work"
 	},
 	"@auth/nextjs": {
 		status: "unsupported",
@@ -345,7 +454,7 @@ const LIBRARY_SUPPORT = {
 	},
 	"@sentry/nextjs": {
 		status: "partial",
-		detail: "client-side works, server integration needs manual setup"
+		detail: "standard instrumentation.ts + withSentryConfig setup works; webpack/Turbopack plugin build features (source map upload, auto-instrumentation, component annotation) don't run"
 	},
 	"@t3-oss/env-nextjs": { status: "supported" },
 	tailwindcss: { status: "supported" },
@@ -365,32 +474,76 @@ const LIBRARY_SUPPORT = {
 	"react-hook-form": { status: "supported" },
 	prisma: {
 		status: "supported",
-		detail: "works on Cloudflare Workers with Prisma Accelerate"
+		detail: "works on Cloudflare Workers with driver adapters (D1, Hyperdrive) or Prisma Accelerate"
 	},
 	drizzle: {
 		status: "supported",
 		detail: "works with D1 on Cloudflare Workers"
 	}
 };
-/**
-* Recursively find all source files in a directory.
-*/
-function findSourceFiles(dir, extensions = [
+const IGNORED_DIRECTORIES = /* @__PURE__ */ new Set([
+	"node_modules",
+	".next",
+	"dist",
+	".git"
+]);
+const SOURCE_EXTENSIONS = [
 	".ts",
 	".tsx",
 	".js",
 	".jsx",
 	".mjs"
-]) {
+];
+function readGitignoreRule(dir) {
+	const gitignore = path.join(dir, ".gitignore");
+	let stat;
+	try {
+		stat = fs.lstatSync(gitignore);
+	} catch {
+		return;
+	}
+	if (!stat.isFile()) return;
+	return {
+		dir,
+		matcher: (0, import_ignore.default)({ ignorecase: false }).add(fs.readFileSync(gitignore, "utf-8"))
+	};
+}
+function ancestorGitignoreRules(root, dir) {
+	const rules = [];
+	let current = root;
+	for (const segment of path.relative(root, dir).split("/")) {
+		const rule = readGitignoreRule(current);
+		if (rule) rules.push(rule);
+		current = path.join(current, segment);
+		if (isGitignored(current, true, rules)) break;
+	}
+	return rules;
+}
+function isGitignored(fullPath, isDirectory, rules) {
+	let ignored = false;
+	for (const rule of rules) {
+		const relative = path.relative(rule.dir, fullPath) + (isDirectory ? "/" : "");
+		const result = rule.matcher.test(relative);
+		if (result.ignored) ignored = true;
+		else if (result.unignored) ignored = false;
+	}
+	return ignored;
+}
+/**
+* Recursively find all source files in a directory.
+*/
+function findSourceFiles(dir, extensions = SOURCE_EXTENSIONS, inherited = []) {
 	const results = [];
 	if (!fs.existsSync(dir)) return results;
+	const localRule = readGitignoreRule(dir);
+	const rules = localRule ? [...inherited, localRule] : inherited;
 	const entries = fs.readdirSync(dir, { withFileTypes: true });
 	for (const entry of entries) {
 		const fullPath = path.join(dir, entry.name);
-		if (entry.isDirectory()) {
-			if (entry.name === "node_modules" || entry.name === ".next" || entry.name === "dist" || entry.name === ".git") continue;
-			results.push(...findSourceFiles(fullPath, extensions));
-		} else if (extensions.some((ext) => entry.name.endsWith(ext))) results.push(fullPath);
+		if (entry.isDirectory() && IGNORED_DIRECTORIES.has(entry.name)) continue;
+		if (isGitignored(fullPath, entry.isDirectory(), rules)) continue;
+		if (entry.isDirectory()) results.push(...findSourceFiles(fullPath, extensions, rules));
+		else if (extensions.some((ext) => entry.name.endsWith(ext))) results.push(fullPath);
 	}
 	return results;
 }
@@ -400,12 +553,13 @@ function findSourceFiles(dir, extensions = [
 * rather than bundled into the vinext application, so reporting their imports
 * or CJS globals as migration blockers produces false positives.
 */
+function isRuntimeSourceFile(file) {
+	const basename = path.basename(file);
+	const isTestRunnerConfig = /^(?:jest|playwright|vitest)\.config\.[cm]?[jt]sx?$/.test(basename);
+	return !/\.(?:test|spec)\.[cm]?[jt]sx?$/.test(basename) && !isTestRunnerConfig;
+}
 function findRuntimeSourceFiles(root) {
-	return findSourceFiles(root).filter((file) => {
-		const basename = path.basename(file);
-		const isTestRunnerConfig = /^(?:jest|playwright|vitest)\.config\.[cm]?[jt]sx?$/.test(basename);
-		return !/\.(?:test|spec)\.[cm]?[jt]sx?$/.test(basename) && !isTestRunnerConfig;
-	});
+	return findSourceFiles(root).filter(isRuntimeSourceFile);
 }
 function isIdentStart(c) {
 	return c >= "a" && c <= "z" || c >= "A" && c <= "Z" || c === "_" || c === "$";
@@ -666,6 +820,7 @@ function propertyKeyName(prop) {
 function collectConfigKeys(source) {
 	const top = /* @__PURE__ */ new Set();
 	const nested = /* @__PURE__ */ new Map();
+	let pageExtensions;
 	let program;
 	try {
 		program = parseAst(source, { lang: "ts" });
@@ -718,6 +873,18 @@ function collectConfigKeys(source) {
 		if (node.type === "TSAsExpression" || node.type === "TSSatisfiesExpression" || node.type === "ParenthesizedExpression") return resolveObjects(node.expression, depth + 1);
 		return [];
 	}
+	function resolveStringArray(node, depth = 0) {
+		if (!node || depth > 10) return void 0;
+		if (node.type === "Identifier") return resolveStringArray(vars.get(node.name), depth + 1);
+		if (node.type === "TSAsExpression" || node.type === "TSSatisfiesExpression" || node.type === "ParenthesizedExpression") return resolveStringArray(node.expression, depth + 1);
+		if (node.type !== "ArrayExpression") return void 0;
+		const values = [];
+		for (const el of node.elements) {
+			if (el?.type !== "Literal" || typeof el.value !== "string") return void 0;
+			values.push(el.value);
+		}
+		return values;
+	}
 	let configObjs = [];
 	for (const node of program.body) {
 		if (node.type === "ExportDefaultDeclaration") configObjs = resolveObjects(node.declaration);
@@ -727,43 +894,143 @@ function collectConfigKeys(source) {
 		}
 		if (configObjs.length) break;
 	}
-	for (const configObj of configObjs) for (const prop of configObj.properties) {
-		const name = propertyKeyName(prop);
-		if (!name) continue;
-		top.add(name);
-		const childObjs = resolveObjects(prop.value);
-		if (!childObjs.length) continue;
-		const children = nested.get(name) ?? /* @__PURE__ */ new Set();
-		for (const childObj of childObjs) for (const childProp of childObj.properties) {
-			const childName = propertyKeyName(childProp);
-			if (childName) children.add(childName);
+	const branchExtensions = [];
+	const expandSpreads = (obj, depth = 0) => obj.properties.flatMap((prop) => {
+		if (prop.type !== "SpreadElement" || depth > 10) return [prop];
+		const spread = resolveObjects(prop.argument);
+		return spread.length === 1 ? expandSpreads(spread[0], depth + 1) : [prop];
+	});
+	let pageExtensionsUnresolved = false;
+	for (const configObj of configObjs) {
+		let branchExts;
+		let branchUnresolved = false;
+		const branchNested = /* @__PURE__ */ new Map();
+		for (const prop of expandSpreads(configObj)) {
+			if (prop.type === "SpreadElement") {
+				branchExts = void 0;
+				branchUnresolved = true;
+			}
+			const name = propertyKeyName(prop);
+			if (!name) continue;
+			top.add(name);
+			const value = prop.value;
+			if (name === "pageExtensions") {
+				branchExts = resolveStringArray(value);
+				branchUnresolved = branchExts === void 0;
+			}
+			branchNested.delete(name);
+			const childObjs = resolveObjects(value);
+			if (!childObjs.length) continue;
+			const children = /* @__PURE__ */ new Set();
+			for (const childObj of childObjs) for (const childProp of childObj.properties) {
+				const childName = propertyKeyName(childProp);
+				if (childName) children.add(childName);
+			}
+			branchNested.set(name, children);
 		}
-		nested.set(name, children);
+		for (const [name, children] of branchNested) nested.set(name, /* @__PURE__ */ new Set([...nested.get(name) ?? [], ...children]));
+		branchExtensions.push(branchExts);
+		if (branchUnresolved) pageExtensionsUnresolved = true;
+	}
+	if (!pageExtensionsUnresolved && branchExtensions.some(Boolean)) {
+		const sets = branchExtensions.map((e) => normalizePageExtensions(e));
+		if (new Set(sets.map((set) => set.join(","))).size === 1) pageExtensions = sets[0];
+		else pageExtensionsUnresolved = true;
 	}
 	return {
 		top,
-		nested
+		nested,
+		pageExtensions,
+		pageExtensionsUnresolved
 	};
 }
-/**
-* Analyze next.config.js/mjs/ts for supported and unsupported options.
-*/
-function analyzeConfig(root) {
-	const configFiles = [
+function findNextConfigPath(root) {
+	for (const f of [
 		"next.config.ts",
 		"next.config.mts",
 		"next.config.mjs",
 		"next.config.js",
 		"next.config.cjs"
-	];
-	let configPath = null;
-	for (const f of configFiles) {
+	]) {
 		const p = path.join(root, f);
-		if (fs.existsSync(p)) {
-			configPath = p;
-			break;
+		if (fs.existsSync(p)) return p;
+	}
+	return null;
+}
+function readViteConfigSource(root) {
+	const viteConfigPath = findViteConfigPath(root);
+	return viteConfigPath ? fs.readFileSync(viteConfigPath, "utf-8") : null;
+}
+/**
+* Whether `rel` is a next.config the loader provides `__dirname`/`__filename`
+* for: TypeScript configs get them injected, and `.cjs` or CommonJS `.js`
+* configs are loaded with `require`. An ESM `.js` config gets neither.
+*/
+function isNextConfigWithCjsGlobals(rel, content) {
+	if (/^next\.config\.(?:ts|mts|cjs)$/.test(rel)) return true;
+	if (rel !== "next.config.js") return false;
+	try {
+		return !parseAst(content).body.some((node) => node.type === "ImportDeclaration" || node.type.startsWith("Export"));
+	} catch {
+		return false;
+	}
+}
+/**
+* Whether a PostCSS config exports an object literal with only a `plugins` key,
+* directly or via a variable — the shape vinext's string-plugin resolver keeps
+* intact (it replaces the config with `{ plugins }`).
+*/
+function exportsPostcssPluginsOnlyObject(content) {
+	let program;
+	try {
+		program = parseAst(content, { lang: "ts" });
+	} catch {
+		return false;
+	}
+	const vars = /* @__PURE__ */ new Map();
+	const mutated = /* @__PURE__ */ new Set();
+	let exported;
+	for (const node of program.body) {
+		if (node.type === "ExpressionStatement") {
+			const expr = node.expression;
+			if (expr.type === "AssignmentExpression" && expr.left.type === "MemberExpression" && expr.left.object.type === "Identifier") mutated.add(expr.left.object.name);
+			else if (expr.type === "CallExpression" && expr.callee.type === "MemberExpression" && expr.callee.object.type === "Identifier" && expr.callee.object.name === "Object" && expr.callee.property.type === "Identifier" && [
+				"assign",
+				"defineProperty",
+				"defineProperties"
+			].includes(expr.callee.property.name) && expr.arguments[0]?.type === "Identifier") mutated.add(expr.arguments[0].name);
 		}
+		if (node.type === "VariableDeclaration") {
+			for (const decl of node.declarations) if (decl.id.type === "Identifier" && decl.init) vars.set(decl.id.name, decl.init);
+		} else if (node.type === "ExportDefaultDeclaration") {
+			if (!node.declaration.type.endsWith("Declaration")) exported = node.declaration;
+		} else if (node.type === "ExpressionStatement" && node.expression.type === "AssignmentExpression" && node.expression.left.type === "MemberExpression" && node.expression.left.object.type === "Identifier" && node.expression.left.object.name === "module" && node.expression.left.property.type === "Identifier" && node.expression.left.property.name === "exports") exported = node.expression.right;
 	}
+	if (exported === void 0) return false;
+	let value = unwrapExpression(exported);
+	if (value?.type === "Identifier") {
+		if (mutated.has(value.name)) return false;
+		value = unwrapExpression(vars.get(value.name));
+	}
+	return value?.type === "ObjectExpression" && value.properties.every((prop) => propertyKeyName(prop) === "plugins");
+}
+/**
+* The dotted `pageExtensions` vinext resolves route conventions with, and
+* whether the configured value is unresolved (then vinext's defaults are used).
+*/
+function readPageExtensions(root) {
+	const configPath = findNextConfigPath(root);
+	const keys = configPath ? collectConfigKeys(fs.readFileSync(configPath, "utf-8")) : void 0;
+	return {
+		exts: normalizePageExtensions(keys?.pageExtensions).map((ext) => `.${ext}`),
+		unresolved: keys?.pageExtensionsUnresolved ?? false
+	};
+}
+/**
+* Analyze next.config.js/mjs/ts for supported and unsupported options.
+*/
+function analyzeConfig(root) {
+	const configPath = findNextConfigPath(root);
 	if (!configPath) return [{
 		name: "next.config",
 		status: "supported",
@@ -771,38 +1038,10 @@ function analyzeConfig(root) {
 	}];
 	const present = collectConfigKeys(fs.readFileSync(configPath, "utf-8"));
 	const items = [];
-	for (const opt of [
-		"basePath",
-		"trailingSlash",
-		"redirects",
-		"rewrites",
-		"headers",
-		"i18n",
-		"env",
-		"images",
-		"allowedDevOrigins",
-		"output",
-		"transpilePackages",
-		"webpack",
-		"cacheComponents",
-		"reactStrictMode",
-		"poweredByHeader",
-		"skipMiddlewareUrlNormalize",
-		"skipProxyUrlNormalize"
-	]) {
-		if (!present.top.has(opt)) continue;
-		const support = CONFIG_SUPPORT[opt];
-		if (support) items.push({
-			name: opt,
-			status: support.status,
-			detail: support.detail
-		});
-		else items.push({
-			name: opt,
-			status: "unsupported",
-			detail: "not recognized"
-		});
-	}
+	for (const [key, support] of Object.entries(CONFIG_SUPPORT)) if (!key.includes(".") && present.top.has(key)) items.push({
+		name: key,
+		...support
+	});
 	for (const key of Object.keys(CONFIG_SUPPORT)) {
 		if (!key.includes(".")) continue;
 		const dot = key.indexOf(".");
@@ -839,19 +1078,69 @@ function checkLibraries(root) {
 */
 function checkConventions(root) {
 	const items = [];
-	const pagesDir = findDir(root, "pages", "src/pages");
-	const appDirPath = findDir(root, "app", "src/app");
-	const hasProxy = fs.existsSync(path.join(root, "proxy.ts")) || fs.existsSync(path.join(root, "proxy.js"));
-	const hasMiddleware = fs.existsSync(path.join(root, "middleware.ts")) || fs.existsSync(path.join(root, "middleware.js"));
+	const viteConfigSource = readViteConfigSource(root);
+	const setsInlineNextConfig = viteConfigSource !== null && /\bnextConfig\b/.test(viteConfigSource);
+	const pageExtensionsRead = readPageExtensions(root);
+	const pageExts = setsInlineNextConfig ? normalizePageExtensions(void 0).map((ext) => `.${ext}`) : pageExtensionsRead.exts;
+	const pageExtensionsUnresolved = !setsInlineNextConfig && pageExtensionsRead.unresolved;
+	const pageExtensionsUncertain = setsInlineNextConfig || pageExtensionsUnresolved;
+	const scanExts = [.../* @__PURE__ */ new Set([...SOURCE_EXTENSIONS, ...pageExts])];
+	const sourceFiles = findSourceFiles(root, scanExts);
+	const realRoot = fs.realpathSync(root);
+	const isThroughSymlink = (dir) => fs.realpathSync(dir) !== path.join(realRoot, path.relative(root, dir));
+	const routeFiles = (dir) => {
+		const files = sourceFiles.filter((file) => file.startsWith(`${dir}/`));
+		if (files.length || !isThroughSymlink(dir)) return files;
+		const rules = ancestorGitignoreRules(root, dir);
+		if (isGitignored(dir, true, rules)) return [];
+		return findSourceFiles(dir, scanExts, rules);
+	};
+	const isPageFile = (file) => pageExts.some((ext) => file.endsWith(ext));
+	const srcDir = path.join(root, "src");
+	const usesSrcDir = findDir(root, "app", "pages") === null && findDir(root, "src/app", "src/pages") !== null;
+	const baseDir = usesSrcDir ? srcDir : root;
+	const pagesDir = findDir(baseDir, "pages");
+	const appDirPath = findDir(baseDir, "app");
+	const conventionPrefix = usesSrcDir ? "src/" : "";
+	const conventionDir = usesSrcDir ? srcDir : root;
+	const proxyFile = findConventionFile(conventionDir, "proxy", pageExts);
+	const middlewareFile = findConventionFile(conventionDir, "middleware", pageExts);
+	const routingNotes = [];
+	const customizesRouting = viteConfigSource !== null && /\b(?:appDir|disableAppRouter|nextConfig)\b/.test(viteConfigSource);
+	if (customizesRouting) routingNotes.push("vite.config passes vinext() routing options (appDir / disableAppRouter / nextConfig), which this check doesn't evaluate — detected with vinext's defaults");
+	if (pageExtensionsUnresolved) routingNotes.push("pageExtensions in next.config can't be read statically or differs between phases — files counted with vinext's default extensions");
+	const routingDetail = routingNotes.length ? routingNotes.join("; ") : void 0;
+	if (!customizesRouting && !usesSrcDir) {
+		for (const dir of ["app", "pages"]) if (findDir(root, dir) === null && findDir(root, `src/${dir}`) !== null) items.push({
+			name: `src/${dir}/ is ignored`,
+			status: "unsupported",
+			detail: `vinext looks for app/ and pages/ in one directory (the project root here) — move src/${dir}/ to ${dir}/`
+		});
+	}
 	if (pagesDir !== null) {
-		const isSrc = pagesDir.includes("src/pages");
 		items.push({
-			name: isSrc ? "Pages Router (src/pages/)" : "Pages Router (pages/)",
-			status: "supported"
+			name: `Pages Router (${path.relative(root, pagesDir)}/)`,
+			status: "supported",
+			...routingDetail && { detail: routingDetail }
+		});
+		const reserved = /* @__PURE__ */ new Set([
+			"_app",
+			"_document",
+			"_error"
+		]);
+		const pageFiles = routeFiles(pagesDir).filter(isPageFile).map((f) => path.relative(pagesDir, f));
+		const stripPageExt = (file) => {
+			const ext = pageExts.filter((e) => file.endsWith(e)).reduce((a, b) => b.length > a.length ? b : a, "");
+			return file.slice(0, file.length - ext.length);
+		};
+		const isCustom = (name) => pageFiles.some((f) => stripPageExt(f) === name);
+		const apiRoutes = pageFiles.filter((f) => f.startsWith("api/"));
+		const pages = pageFiles.filter((f) => {
+			const segments = f.split("/");
+			const basename = segments.pop() ?? "";
+			if (segments.some((dir) => dir === "api" || reserved.has(dir))) return false;
+			return segments.length > 0 || !reserved.has(stripPageExt(basename));
 		});
-		const pageFiles = findSourceFiles(pagesDir);
-		const pages = pageFiles.filter((f) => !f.includes("/api/") && !f.includes("_app") && !f.includes("_document") && !f.includes("_error"));
-		const apiRoutes = pageFiles.filter((f) => f.includes("/api/"));
 		items.push({
 			name: `${pages.length} page(s)`,
 			status: "supported"
@@ -860,28 +1149,28 @@ function checkConventions(root) {
 			name: `${apiRoutes.length} API route(s)`,
 			status: "supported"
 		});
-		if (pageFiles.some((f) => f.includes("_app"))) items.push({
+		if (isCustom("_app")) items.push({
 			name: "Custom _app",
 			status: "supported"
 		});
-		if (pageFiles.some((f) => f.includes("_document"))) items.push({
+		if (isCustom("_document")) items.push({
 			name: "Custom _document",
 			status: "supported"
 		});
 	}
 	if (appDirPath !== null) {
-		const isSrc = appDirPath.includes("src/app");
 		items.push({
-			name: isSrc ? "App Router (src/app/)" : "App Router (app/)",
-			status: "supported"
+			name: `App Router (${path.relative(root, appDirPath)}/)`,
+			status: "supported",
+			...routingDetail && { detail: routingDetail }
 		});
-		const appFiles = findSourceFiles(appDirPath);
-		const pages = appFiles.filter((f) => isAppRouterFile(f, "page"));
-		const layouts = appFiles.filter((f) => isAppRouterFile(f, "layout"));
-		const routes = appFiles.filter((f) => f.endsWith("route.tsx") || f.endsWith("route.ts") || f.endsWith("route.js"));
-		const loadings = appFiles.filter((f) => isAppRouterFile(f, "loading"));
-		const errors = appFiles.filter((f) => isAppRouterFile(f, "error"));
-		const notFounds = appFiles.filter((f) => isAppRouterFile(f, "not-found"));
+		const appFiles = routeFiles(appDirPath).map((f) => path.relative(appDirPath, f));
+		const pages = appFiles.filter((f) => isAppRouterFile(f, "page", pageExts));
+		const layouts = appFiles.filter((f) => isAppRouterFile(f, "layout", pageExts));
+		const routes = appFiles.filter((f) => isAppRouterFile(f, "route", pageExts));
+		const loadings = appFiles.filter((f) => isAppRouterFile(f, "loading", pageExts));
+		const errors = appFiles.filter((f) => isAppRouterFile(f, "error", pageExts));
+		const notFounds = appFiles.filter((f) => isAppRouterFile(f, "not-found", pageExts));
 		items.push({
 			name: `${pages.length} page(s)`,
 			status: "supported"
@@ -907,36 +1196,33 @@ function checkConventions(root) {
 			status: "supported"
 		});
 	}
-	if (hasProxy) items.push({
-		name: "proxy.ts (Next.js 16)",
+	if (proxyFile && middlewareFile && !pageExtensionsUncertain) items.push({
+		name: `Both ${conventionPrefix}${middlewareFile} and ${conventionPrefix}${proxyFile}`,
+		status: "unsupported",
+		detail: `only one is allowed — keep ${conventionPrefix}${proxyFile} and remove ${conventionPrefix}${middlewareFile}`
+	});
+	else if (proxyFile) items.push({
+		name: `${conventionPrefix}${proxyFile} (Next.js 16)`,
 		status: "supported"
 	});
-	else if (hasMiddleware) items.push({
-		name: "middleware.ts (deprecated in Next.js 16)",
+	else if (middlewareFile) items.push({
+		name: `${conventionPrefix}${middlewareFile} (deprecated in Next.js 16)`,
 		status: "supported"
 	});
 	if (pagesDir === null && appDirPath === null) items.push({
 		name: "No pages/ or app/ directory found",
 		status: "unsupported",
-		detail: "vinext requires a pages/ or app/ directory"
+		detail: ["vinext requires a pages/ or app/ directory", ...routingNotes].join("; ")
 	});
-	const pkgPath = path.join(root, "package.json");
-	if (fs.existsSync(pkgPath)) {
-		if (JSON.parse(fs.readFileSync(pkgPath, "utf-8")).type !== "module") items.push({
-			name: "Missing \"type\": \"module\" in package.json",
-			status: "unsupported",
-			detail: "required for Vite — vinext init will add it automatically"
-		});
-	}
-	const allSourceFiles = findRuntimeSourceFiles(root);
+	const runtimeSourceFiles = sourceFiles.filter((file) => isRuntimeSourceFile(file) && SOURCE_EXTENSIONS.some((ext) => file.endsWith(ext)));
 	const viewTransitionRegex = /import\s+\{[^}]*\bViewTransition\b[^}]*\}\s+from\s+['"]react['"]/;
 	const viewTransitionFiles = [];
 	const cjsGlobalFiles = [];
-	for (const file of allSourceFiles) {
+	for (const file of runtimeSourceFiles) {
 		const content = fs.readFileSync(file, "utf-8");
 		const rel = path.relative(root, file);
 		if (viewTransitionRegex.test(content)) viewTransitionFiles.push(rel);
-		if (hasFreeCjsGlobal(content)) cjsGlobalFiles.push(rel);
+		if (hasFreeCjsGlobal(content) && !isNextConfigWithCjsGlobals(rel, content)) cjsGlobalFiles.push(rel);
 	}
 	if (viewTransitionFiles.length > 0) items.push({
 		name: "ViewTransition (React canary API)",
@@ -944,18 +1230,18 @@ function checkConventions(root) {
 		detail: "vinext auto-shims with a passthrough fallback, view transitions won't animate",
 		files: viewTransitionFiles
 	});
-	for (const configFile of [
-		"postcss.config.mjs",
-		"postcss.config.js",
-		"postcss.config.cjs"
-	]) {
+	for (const configFile of POSTCSS_CONFIG_FILES) {
 		const configPath = path.join(root, configFile);
 		if (fs.existsSync(configPath)) {
 			const content = fs.readFileSync(configPath, "utf-8");
-			if (/plugins\s*:\s*\[\s*['"]/.test(content)) items.push({
+			if (/plugins\s*:\s*\[\s*['"]/.test(content)) items.push(!exportsPostcssPluginsOnlyObject(content) ? {
 				name: `PostCSS string-form plugins (${configFile})`,
 				status: "partial",
-				detail: "string-form PostCSS plugins need resolution — vinext handles this automatically"
+				detail: "vinext resolves string-form plugins only in a config that exports a plain { plugins } object — function exports aren't resolved and other options are dropped"
+			} : {
+				name: `PostCSS string-form plugins (${configFile})`,
+				status: "supported",
+				detail: "string-form PostCSS plugins are resolved automatically by vinext"
 			});
 			break;
 		}
@@ -963,7 +1249,7 @@ function checkConventions(root) {
 	if (cjsGlobalFiles.length > 0) items.push({
 		name: "__dirname / __filename (CommonJS globals)",
 		status: "unsupported",
-		detail: "CJS globals unavailable in ESM — use fileURLToPath(import.meta.url) / dirname(...), or import.meta.dirname / import.meta.filename (Node 22+)",
+		detail: "vinext only defines them in server code, where they point at the built output rather than your source tree; they are undefined in client bundles and ESM next.config files — use import.meta.dirname / import.meta.filename or fileURLToPath(import.meta.url)",
 		files: cjsGlobalFiles
 	});
 	return items;
@@ -986,17 +1272,19 @@ function runCheck(root) {
 	const partial = allItems.filter((i) => i.status === "partial").length;
 	const unsupported = allItems.filter((i) => i.status === "unsupported").length;
 	const total = allItems.length;
+	const score = total > 0 ? Math.round((supported + partial * .5) / total * 100) : 100;
 	return {
 		imports,
 		config,
 		libraries,
 		conventions,
+		hasAppDir: findDir(root, "app", "src/app") !== null,
 		summary: {
 			supported,
 			partial,
 			unsupported,
 			total,
-			score: total > 0 ? Math.round((supported + partial * .5) / total * 100) : 100
+			score
 		}
 	};
 }
@@ -1005,7 +1293,7 @@ function runCheck(root) {
 */
 function formatReport(result, opts) {
 	const lines = [];
-	const hasAppRouter = result.conventions.some((item) => item.name === "App Router (app/)" || item.name === "App Router (src/app/)");
+	const hasAppRouter = result.hasAppDir === true;
 	const statusIcon = (s) => s === "supported" ? "\x1B[32m✓\x1B[0m" : s === "partial" ? "\x1B[33m~\x1B[0m" : "\x1B[31m✗\x1B[0m";
 	lines.push("");
 	lines.push("  \x1B[1mvinext compatibility report\x1B[0m");
@@ -1074,7 +1362,10 @@ function formatReport(result, opts) {
 			...result.libraries,
 			...result.conventions
 		];
-		for (const item of allItems) if (item.status === "partial") lines.push(`    \x1b[33m~\x1b[0m  ${item.name}${item.detail ? ` — ${item.detail}` : ""}`);
+		for (const item of allItems) if (item.status === "partial") {
+			lines.push(`    \x1b[33m~\x1b[0m  ${item.name}${item.detail ? ` — ${item.detail}` : ""}`);
+			for (const f of item.files ?? []) lines.push(`       \x1b[90m${f}\x1b[0m`);
+		}
 	}
 	if (!opts?.calledFromInit) {
 		lines.push("");
@@ -1084,7 +1375,7 @@ function formatReport(result, opts) {
 		lines.push("  Or manually:");
 		lines.push(`    1. Add \x1b[36m"type": "module"\x1b[0m to package.json`);
 		lines.push(`    2. Install: \x1b[36m${detectPackageManager(process.cwd())} vinext vite @vitejs/plugin-react${hasAppRouter ? " @vitejs/plugin-rsc react-server-dom-webpack" : ""}\x1b[0m`);
-		lines.push(`    3. Create vite.config.ts (see docs)`);
+		lines.push(`    3. Create vite.config.ts with \x1b[36mplugins: [vinext()]\x1b[0m`);
 		lines.push(`    4. Run: \x1b[36mnpx vite dev\x1b[0m`);
 	}
 	lines.push("");