vinext 0.1.7 → 0.2.0

package/dist/check.d.ts

@@ -59,22 +59,40 @@ type CheckResult = {
 declare function hasFreeCjsGlobal(content: string): boolean;
 /**
  * Scan source files for `import ... from 'next/...'` statements.
+ *
+ * `root` must be forward-slash: it is passed to `findSourceFiles` (which
+ * requires it) and used as the base of `path.posix.relative`, which only yields
+ * a canonical relative path when both operands are forward-slash.
  */
 declare function scanImports(root: string): CheckItem[];
 /**
  * Analyze next.config.js/mjs/ts for supported and unsupported options.
+ *
+ * `root` must be forward-slash — joined with `path.posix.join`. Only called
+ * from `runCheck`, which normalizes it.
  */
 declare function analyzeConfig(root: string): CheckItem[];
 /**
  * Check package.json dependencies for known libraries.
+ *
+ * `root` must be forward-slash — joined with `path.posix.join`. Only called
+ * from `runCheck`, which normalizes it.
  */
 declare function checkLibraries(root: string): CheckItem[];
 /**
  * Check file conventions (pages, app directory, middleware, etc.)
+ *
+ * `root` must be forward-slash — joined with `path.posix.join`, passed to
+ * `findDir`, and used as the base of `path.posix.relative`. Only called from
+ * `runCheck`, which normalizes it.
  */
 declare function checkConventions(root: string): CheckItem[];
 /**
  * Run the full compatibility check.
+ *
+ * `root` must be forward-slash — callers normalize it at the CLI entry, and it
+ * is forwarded to `scanImports` / `checkConventions` / `findDir`, which build
+ * paths with `path.posix.*`.
  */
 declare function runCheck(root: string): CheckResult;
 /**

package/dist/check.js

@@ -1,5 +1,4 @@
 import { detectPackageManager, findDir } from "./utils/project.js";
-import { normalizePathSeparators } from "./utils/path.js";
 import fs from "node:fs";
 import path from "node:path";
 import { parseAst } from "vite";
@@ -193,7 +192,7 @@ const CONFIG_SUPPORT = {
 	env: { status: "supported" },
 	images: {
 		status: "partial",
-		detail: "remotePatterns validated, no local optimization"
+		detail: "remotePatterns validated; on-the-fly optimization via images.optimizer (Cloudflare Images), passthrough otherwise"
 	},
 	allowedDevOrigins: {
 		status: "supported",
@@ -259,6 +258,42 @@ const CONFIG_SUPPORT = {
 		status: "partial",
 		detail: "config recognized; vinext does not implement navigation result caching"
 	},
+	"experimental.middlewarePrefetch": {
+		status: "unsupported",
+		detail: "not recognized; use of this option is ignored"
+	},
+	"experimental.proxyPrefetch": {
+		status: "unsupported",
+		detail: "not recognized; use of this option is ignored"
+	},
+	"experimental.middlewareClientMaxBodySize": {
+		status: "unsupported",
+		detail: "not recognized; use of this option is ignored"
+	},
+	"experimental.proxyClientMaxBodySize": {
+		status: "unsupported",
+		detail: "not recognized; use of this option is ignored"
+	},
+	"experimental.externalMiddlewareRewritesResolve": {
+		status: "unsupported",
+		detail: "not recognized; use of this option is 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"
+	},
+	skipMiddlewareUrlNormalize: {
+		status: "unsupported",
+		detail: "not recognized; use of this option is ignored"
+	},
+	skipProxyUrlNormalize: {
+		status: "unsupported",
+		detail: "not recognized; use of this option is ignored"
+	},
 	"i18n.domains": {
 		status: "partial",
 		detail: "supported for Pages Router; App Router unchanged"
@@ -331,6 +366,11 @@ const LIBRARY_SUPPORT = {
 };
 /**
 * Recursively find all source files in a directory.
+*
+* `dir` must be forward-slash, and the returned paths are forward-slash too:
+* each entry is joined with `path.posix.join`, which only stays canonical when
+* the base already is. This keeps downstream substring checks (e.g.
+* `f.includes("/api/")`) and reported paths consistent across platforms.
 */
 function findSourceFiles(dir, extensions = [
 	".ts",
@@ -343,7 +383,7 @@ function findSourceFiles(dir, extensions = [
 	if (!fs.existsSync(dir)) return results;
 	const entries = fs.readdirSync(dir, { withFileTypes: true });
 	for (const entry of entries) {
-		const fullPath = normalizePathSeparators(path.join(dir, entry.name));
+		const fullPath = path.posix.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));
@@ -547,6 +587,10 @@ function hasFreeCjsGlobal(content) {
 }
 /**
 * Scan source files for `import ... from 'next/...'` statements.
+*
+* `root` must be forward-slash: it is passed to `findSourceFiles` (which
+* requires it) and used as the base of `path.posix.relative`, which only yields
+* a canonical relative path when both operands are forward-slash.
 */
 function scanImports(root) {
 	const files = findSourceFiles(root);
@@ -564,7 +608,7 @@ function scanImports(root) {
 			if (mod.startsWith("next/") || mod === "next" || mod === "server-only" || mod === "client-only") {
 				const normalized = mod === "next" ? "next" : mod;
 				if (!importUsage.has(normalized)) importUsage.set(normalized, []);
-				const relFile = normalizePathSeparators(path.relative(root, file));
+				const relFile = path.posix.relative(root, file);
 				const usedInFiles = importUsage.get(normalized) ?? [];
 				if (!usedInFiles.includes(relFile)) usedInFiles.push(relFile);
 			}
@@ -691,6 +735,9 @@ function collectConfigKeys(source) {
 }
 /**
 * Analyze next.config.js/mjs/ts for supported and unsupported options.
+*
+* `root` must be forward-slash — joined with `path.posix.join`. Only called
+* from `runCheck`, which normalizes it.
 */
 function analyzeConfig(root) {
 	const configFiles = [
@@ -702,7 +749,7 @@ function analyzeConfig(root) {
 	];
 	let configPath = null;
 	for (const f of configFiles) {
-		const p = path.join(root, f);
+		const p = path.posix.join(root, f);
 		if (fs.existsSync(p)) {
 			configPath = p;
 			break;
@@ -729,7 +776,9 @@ function analyzeConfig(root) {
 		"transpilePackages",
 		"webpack",
 		"reactStrictMode",
-		"poweredByHeader"
+		"poweredByHeader",
+		"skipMiddlewareUrlNormalize",
+		"skipProxyUrlNormalize"
 	]) {
 		if (!present.top.has(opt)) continue;
 		const support = CONFIG_SUPPORT[opt];
@@ -757,9 +806,12 @@ function analyzeConfig(root) {
 }
 /**
 * Check package.json dependencies for known libraries.
+*
+* `root` must be forward-slash — joined with `path.posix.join`. Only called
+* from `runCheck`, which normalizes it.
 */
 function checkLibraries(root) {
-	const pkgPath = path.join(root, "package.json");
+	const pkgPath = path.posix.join(root, "package.json");
 	if (!fs.existsSync(pkgPath)) return [];
 	const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
 	const allDeps = {
@@ -777,17 +829,19 @@ function checkLibraries(root) {
 }
 /**
 * Check file conventions (pages, app directory, middleware, etc.)
+*
+* `root` must be forward-slash — joined with `path.posix.join`, passed to
+* `findDir`, and used as the base of `path.posix.relative`. Only called from
+* `runCheck`, which normalizes it.
 */
 function checkConventions(root) {
 	const items = [];
-	const pagesDir = findDir(root, "pages", path.join("src", "pages"));
-	const appDirPath = findDir(root, "app", path.join("src", "app"));
-	const hasPages = pagesDir !== null;
-	const hasApp = appDirPath !== null;
-	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 pagesDir = findDir(root, "pages", "src/pages");
+	const appDirPath = findDir(root, "app", "src/app");
+	const hasProxy = fs.existsSync(path.posix.join(root, "proxy.ts")) || fs.existsSync(path.posix.join(root, "proxy.js"));
+	const hasMiddleware = fs.existsSync(path.posix.join(root, "middleware.ts")) || fs.existsSync(path.posix.join(root, "middleware.js"));
 	if (pagesDir !== null) {
-		const isSrc = pagesDir.includes(path.join("src", "pages"));
+		const isSrc = pagesDir.includes("src/pages");
 		items.push({
 			name: isSrc ? "Pages Router (src/pages/)" : "Pages Router (pages/)",
 			status: "supported"
@@ -813,7 +867,7 @@ function checkConventions(root) {
 		});
 	}
 	if (appDirPath !== null) {
-		const isSrc = appDirPath.includes(path.join("src", "app"));
+		const isSrc = appDirPath.includes("src/app");
 		items.push({
 			name: isSrc ? "App Router (src/app/)" : "App Router (app/)",
 			status: "supported"
@@ -858,12 +912,12 @@ function checkConventions(root) {
 		name: "middleware.ts (deprecated in Next.js 16)",
 		status: "supported"
 	});
-	if (!hasPages && !hasApp) items.push({
+	if (pagesDir === null && appDirPath === null) items.push({
 		name: "No pages/ or app/ directory found",
 		status: "unsupported",
 		detail: "vinext requires a pages/ or app/ directory"
 	});
-	const pkgPath = path.join(root, "package.json");
+	const pkgPath = path.posix.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",
@@ -877,7 +931,7 @@ function checkConventions(root) {
 	const cjsGlobalFiles = [];
 	for (const file of allSourceFiles) {
 		const content = fs.readFileSync(file, "utf-8");
-		const rel = normalizePathSeparators(path.relative(root, file));
+		const rel = path.posix.relative(root, file);
 		if (viewTransitionRegex.test(content)) viewTransitionFiles.push(rel);
 		if (hasFreeCjsGlobal(content)) cjsGlobalFiles.push(rel);
 	}
@@ -892,7 +946,7 @@ function checkConventions(root) {
 		"postcss.config.js",
 		"postcss.config.cjs"
 	]) {
-		const configPath = path.join(root, configFile);
+		const configPath = path.posix.join(root, configFile);
 		if (fs.existsSync(configPath)) {
 			const content = fs.readFileSync(configPath, "utf-8");
 			if (/plugins\s*:\s*\[\s*['"]/.test(content)) items.push({
@@ -913,6 +967,10 @@ function checkConventions(root) {
 }
 /**
 * Run the full compatibility check.
+*
+* `root` must be forward-slash — callers normalize it at the CLI entry, and it
+* is forwarded to `scanImports` / `checkConventions` / `findDir`, which build
+* paths with `path.posix.*`.
 */
 function runCheck(root) {
 	const imports = scanImports(root);

package/dist/cli-args.d.ts

@@ -18,7 +18,6 @@ type ParsedArgs = {
   precompress?: boolean;
   positionals?: string[];
 };
-declare function parsePositiveIntegerArg(raw: string, flag: string): number;
 /**
  * Parse CLI arguments into a structured object.
  *
@@ -30,4 +29,4 @@ declare function parsePositiveIntegerArg(raw: string, flag: string): number;
  */
 declare function parseArgs(args: string[]): ParsedArgs;
 //#endregion
-export { parseArgs, parsePositiveIntegerArg };
+export { parseArgs };

package/dist/cli-args.js

@@ -121,4 +121,4 @@ function parseArgs(args) {
 	return result;
 }
 //#endregion
-export { parseArgs, parsePositiveIntegerArg };
+export { parseArgs };

package/dist/cli-dev-config.d.ts

@@ -0,0 +1,12 @@
+import { Plugin, ServerOptions } from "vite";
+
+//#region src/cli-dev-config.d.ts
+type DevServerCliOptions = {
+  port?: number;
+  hostname?: string;
+};
+declare function applyDevServerDefaults(server: ServerOptions, options: DevServerCliOptions): void;
+declare function createDevServerConfigPlugin(options: DevServerCliOptions): Plugin;
+declare function normalizeDevServerHostname(host: string | boolean | undefined): string;
+//#endregion
+export { DevServerCliOptions, applyDevServerDefaults, createDevServerConfigPlugin, normalizeDevServerHostname };

package/dist/cli-dev-config.js

@@ -0,0 +1,23 @@
+//#region src/cli-dev-config.ts
+function applyDevServerDefaults(server, options) {
+	server.port = options.port ?? server.port ?? 3e3;
+	server.host = options.hostname ?? server.host ?? "localhost";
+}
+function createDevServerConfigPlugin(options) {
+	return {
+		name: "vinext:dev-server-config",
+		enforce: "post",
+		config: {
+			order: "post",
+			handler(config) {
+				applyDevServerDefaults(config.server ??= {}, options);
+			}
+		}
+	};
+}
+function normalizeDevServerHostname(host) {
+	if (typeof host === "string") return host;
+	return host === true ? "0.0.0.0" : "localhost";
+}
+//#endregion
+export { applyDevServerDefaults, createDevServerConfigPlugin, normalizeDevServerHostname };