vinext 0.1.7 → 0.2.0

package/dist/utils/react-version.js

@@ -0,0 +1,44 @@
+import { createRequire } from "node:module";
+import fs from "node:fs";
+import path from "node:path";
+//#region src/utils/react-version.ts
+function getDependencyUpgradeDeps(root, recommendations) {
+	const req = createRequire(path.join(root, "package.json"));
+	for (const [dependency, recommendation] of Object.entries(recommendations)) try {
+		const version = findPackageVersion(req.resolve(dependency), dependency);
+		if (version && isVersionBelow(version, recommendation.minimumVersion)) return recommendation.upgrades;
+	} catch {
+		continue;
+	}
+	return [];
+}
+function getReactUpgradeDeps(root) {
+	return getDependencyUpgradeDeps(root, { react: {
+		minimumVersion: [
+			19,
+			2,
+			6
+		],
+		upgrades: ["react@latest", "react-dom@latest"]
+	} });
+}
+function isVersionBelow(version, minimum) {
+	const current = version.split(".").map((part) => parseInt(part, 10));
+	for (let index = 0; index < minimum.length; index++) if ((current[index] ?? 0) !== minimum[index]) return (current[index] ?? 0) < minimum[index];
+	return false;
+}
+/** Walk up from a resolved module entry to find its package version. */
+function findPackageVersion(resolvedEntry, packageName) {
+	let dir = path.dirname(resolvedEntry);
+	while (dir !== path.dirname(dir)) {
+		const candidate = path.join(dir, "package.json");
+		try {
+			const pkg = JSON.parse(fs.readFileSync(candidate, "utf-8"));
+			if (pkg.name === packageName) return pkg.version ?? null;
+		} catch {}
+		dir = path.dirname(dir);
+	}
+	return null;
+}
+//#endregion
+export { getReactUpgradeDeps };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vinext",
-  "version": "0.1.7",
+  "version": "0.2.0",
   "description": "Run Next.js apps on Vite. Drop-in replacement for the next CLI.",
   "license": "MIT",
   "repository": {
@@ -53,10 +53,50 @@
       "types": "./dist/server/pages-request-pipeline.d.ts",
       "import": "./dist/server/pages-request-pipeline.js"
     },
+    "./server/pages-client-assets": {
+      "types": "./dist/server/pages-client-assets.d.ts",
+      "import": "./dist/server/pages-client-assets.js"
+    },
+    "./server/fetch-handler": {
+      "types": "./dist/server/fetch-handler.d.ts",
+      "import": "./dist/server/fetch-handler.js"
+    },
     "./server/app-router-entry": {
       "types": "./dist/server/app-router-entry.d.ts",
       "import": "./dist/server/app-router-entry.js"
     },
+    "./server/pages-router-entry": {
+      "types": "./dist/server/pages-router-entry.d.ts",
+      "import": "./dist/server/pages-router-entry.js"
+    },
+    "./internal/server/headers": {
+      "types": "./dist/server/headers.d.ts",
+      "import": "./dist/server/headers.js"
+    },
+    "./internal/server/isr-cache": {
+      "types": "./dist/server/isr-cache.d.ts",
+      "import": "./dist/server/isr-cache.js"
+    },
+    "./internal/server/app-page-cache": {
+      "types": "./dist/server/app-page-cache.d.ts",
+      "import": "./dist/server/app-page-cache.js"
+    },
+    "./internal/build/run-prerender": {
+      "types": "./dist/build/run-prerender.d.ts",
+      "import": "./dist/build/run-prerender.js"
+    },
+    "./internal/config/dotenv": {
+      "types": "./dist/config/dotenv.d.ts",
+      "import": "./dist/config/dotenv.js"
+    },
+    "./internal/config/next-config": {
+      "types": "./dist/config/next-config.d.ts",
+      "import": "./dist/config/next-config.js"
+    },
+    "./internal/config/prerender": {
+      "types": "./dist/config/prerender.d.ts",
+      "import": "./dist/config/prerender.js"
+    },
     "./server/app-rsc-handler": {
       "types": "./dist/server/app-rsc-handler.d.ts",
       "import": "./dist/server/app-rsc-handler.js"
@@ -84,6 +124,10 @@
     "./utils/query": {
       "types": "./dist/utils/query.d.ts",
       "import": "./dist/utils/query.js"
+    },
+    "./internal/utils/project": {
+      "types": "./dist/utils/project.d.ts",
+      "import": "./dist/utils/project.js"
     }
   },
   "dependencies": {
@@ -93,7 +137,6 @@
     "ipaddr.js": "^2.1.0",
     "magic-string": "^0.30.21",
     "vite-plugin-commonjs": "^0.10.4",
-    "vite-tsconfig-paths": "^6.1.1",
     "web-vitals": "^4.2.4"
   },
   "devDependencies": {
@@ -102,10 +145,12 @@
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^6.0.1",
     "@vitejs/plugin-rsc": "^0.5.27",
+    "am-i-vibing": "^0.5.0",
     "react-server-dom-webpack": "^19.2.7",
     "vite": "npm:@voidzero-dev/vite-plus-core@0.2.1",
     "vite-plus": "0.2.1",
-    "@vinext/cloudflare": "0.1.2"
+    "vite-tsconfig-paths": "^6.1.1",
+    "@vinext/cloudflare": "0.2.0"
   },
   "peerDependencies": {
     "@mdx-js/rollup": "^3.0.0",
@@ -114,7 +159,8 @@
     "react": "^19.2.6",
     "react-dom": "^19.2.6",
     "react-server-dom-webpack": "^19.2.6",
-    "vite": "^7.0.0 || ^8.0.0"
+    "vite": "^7.0.0 || ^8.0.0",
+    "vite-tsconfig-paths": "^6.1.1"
   },
   "peerDependenciesMeta": {
     "@mdx-js/rollup": {
@@ -125,6 +171,9 @@
     },
     "react-server-dom-webpack": {
       "optional": true
+    },
+    "vite-tsconfig-paths": {
+      "optional": true
     }
   },
   "engines": {

package/dist/deploy.d.ts

@@ -1,190 +0,0 @@
-import { ensureESModule as ensureESModule$1, renameCJSConfigs as renameCJSConfigs$1 } from "./utils/project.js";
-import { execFileSync } from "node:child_process";
-
-//#region src/deploy.d.ts
-type DeployOptions = {
-  /** Project root directory */root: string; /** Deploy to preview environment (default: production) */
-  preview?: boolean; /** Wrangler environment name from wrangler.jsonc env.<name> */
-  env?: string; /** Custom project name for the Worker */
-  name?: string; /** Skip the build step (assume already built) */
-  skipBuild?: boolean; /** Dry run — generate config files but don't build or deploy */
-  dryRun?: boolean; /** Pre-render all discovered routes into the dist output after building */
-  prerenderAll?: boolean; /** Maximum number of routes to prerender in parallel */
-  prerenderConcurrency?: number; /** Enable experimental TPR (Traffic-aware Pre-Rendering) */
-  experimentalTPR?: boolean; /** TPR: traffic coverage percentage target (0–100, default: 90) */
-  tprCoverage?: number; /** TPR: hard cap on number of pages to pre-render (default: 1000) */
-  tprLimit?: number; /** TPR: analytics lookback window in hours (default: 24) */
-  tprWindow?: number;
-};
-declare function parseDeployArgs(args: string[]): {
-  help: boolean;
-  preview: boolean;
-  env: string | undefined;
-  name: string | undefined;
-  skipBuild: boolean;
-  dryRun: boolean;
-  prerenderAll: boolean;
-  prerenderConcurrency: number | undefined;
-  experimentalTPR: boolean;
-  tprCoverage: number | undefined;
-  tprLimit: number | undefined;
-  tprWindow: number | undefined;
-};
-type ProjectInfo = {
-  root: string;
-  isAppRouter: boolean;
-  isPagesRouter: boolean;
-  hasViteConfig: boolean;
-  hasWranglerConfig: boolean;
-  hasWorkerEntry: boolean;
-  hasCloudflarePlugin: boolean;
-  hasRscPlugin: boolean;
-  hasWrangler: boolean;
-  projectName: string; /** Pages that use `revalidate` (ISR) */
-  hasISR: boolean; /** package.json has "type": "module" */
-  hasTypeModule: boolean; /** .mdx files detected in app/ or pages/ */
-  hasMDX: boolean; /** CodeHike is a dependency */
-  hasCodeHike: boolean; /** Native Node modules that need stubbing for Workers */
-  nativeModulesToStub: string[];
-};
-/** Check whether a wrangler config file exists in the given directory. */
-declare function hasWranglerConfig(root: string): boolean;
-/**
- * Build the error message thrown when cloudflare() is missing from the Vite config.
- * Shared between the build-time guard (index.ts configResolved) and the
- * deploy-time guard (deploy.ts deploy()).
- */
-declare function formatMissingCloudflarePluginError(options: {
-  isAppRouter: boolean;
-  configFile?: string;
-}): string;
-declare function detectProject(root: string): ProjectInfo;
-/** @see {@link _ensureESModule} */
-declare const ensureESModule: typeof ensureESModule$1;
-/** @see {@link _renameCJSConfigs} */
-declare const renameCJSConfigs: typeof renameCJSConfigs$1;
-/** Generate wrangler.jsonc content */
-declare function generateWranglerConfig(info: ProjectInfo): string;
-/** Generate worker/index.ts for App Router */
-declare function generateAppRouterWorkerEntry(): string;
-/** Generate worker/index.ts for Pages Router */
-declare function generatePagesRouterWorkerEntry(): string;
-/** Generate vite.config.ts for App Router */
-declare function generateAppRouterViteConfig(info?: ProjectInfo): string;
-/** Generate vite.config.ts for Pages Router */
-declare function generatePagesRouterViteConfig(info?: ProjectInfo): string;
-type MissingDep = {
-  name: string;
-  version: string;
-};
-/**
- * Check if a package is resolvable from a given root directory using
- * Node's module resolution (createRequire). Handles hoisting, pnpm
- * symlinks, monorepos, and Yarn PnP correctly.
- */
-declare function isPackageResolvable(root: string, packageName: string): boolean;
-declare function getMissingDeps(info: ProjectInfo, /** Override for testing — defaults to `isPackageResolvable` */
-
-_isResolvable?: (root: string, pkg: string) => boolean): MissingDep[];
-type GeneratedFile = {
-  path: string;
-  content: string;
-  description: string;
-};
-/**
- * Check whether an existing vite.config file already imports and uses the
- * Cloudflare Vite plugin. This is a heuristic text scan — it doesn't execute
- * the config — so it may produce false negatives for unusual configurations.
- *
- * Returns true if `@cloudflare/vite-plugin` appears to be configured, false
- * if it is missing (meaning the build will fail with "could not resolve
- * virtual:vinext-rsc-entry").
- */
-declare function viteConfigHasCloudflarePlugin(root: string): boolean;
-/**
- * Detect whether the Vite config assigns a CDN or data cache adapter — i.e. the
- * `cdn` or `data` field of the `vinext({ cache })` option is given a value.
- * This is a source-level check on those exact object fields, not a fuzzy scan
- * for adapter names. Mirrors {@link viteConfigHasCloudflarePlugin}'s leniency:
- * an unreadable or absent config is treated as configured so a deploy is never
- * blocked on a false negative.
- */
-declare function viteConfigHasCacheAdapter(root: string): boolean;
-/**
- * Detect whether an existing user-authored Worker entry wires up a cache
- * backend imperatively via one of the `setCacheHandler` / `setDataCacheHandler`
- * / `setCdnCacheAdapter` setters. These setters are deprecated in favour of the
- * declarative `vinext({ cache })` option, but older apps that scaffolded a KV
- * cache handler into their Worker entry must keep working — so a deploy should
- * not be blocked when the Worker entry already configures a backend.
- *
- * This is a heuristic text scan (it doesn't execute the entry), mirroring
- * {@link viteConfigHasCacheAdapter}'s leniency: an unreadable Worker entry is
- * treated as configured so a deploy is never blocked on a false negative. A
- * missing Worker entry returns false (nothing to inspect — defer to other
- * checks).
- */
-declare function workerEntryHasCacheHandler(root: string): boolean;
-/**
- * Build the error thrown when an ISR/cached app is deployed without a cache
- * adapter configured in the Vite config. Production deployments need a
- * persistent cache backend; vinext no longer scaffolds one into the Worker
- * entry, so it must be declared via `vinext({ cache })`.
- */
-declare function formatMissingCacheAdapterError(options: {
-  configFile?: string;
-}): string;
-declare function getFilesToGenerate(info: ProjectInfo): GeneratedFile[];
-/**
- * Run a function with `process.env.CLOUDFLARE_ENV` set to the given value,
- * restoring the previous state (whether set or absent) after the function
- * resolves or throws.
- *
- * The `@cloudflare/vite-plugin` reads `CLOUDFLARE_ENV` from `process.env` to
- * drive the multi-environment merge applied to the emitted `wrangler.json`.
- * Without this propagation the `--env <name>` CLI flag is silently ignored at
- * build time and the top-level config is emitted regardless. See issue #1210.
- *
- * Passing `undefined` is a no-op; the callback runs with `process.env` untouched.
- */
-declare function withCloudflareEnv<T>(env: string | undefined, fn: () => Promise<T>): Promise<T>;
-type WranglerDeployArgs = {
-  args: string[];
-  env: string | undefined;
-};
-declare function validateWranglerEnvName(env: string): string;
-declare function buildWranglerDeployArgs(options: Pick<DeployOptions, "preview" | "env">): WranglerDeployArgs;
-/**
- * Resolve Wrangler's JavaScript CLI entrypoint in node_modules.
- *
- * Invoking the JavaScript file through `process.execPath` avoids the `.cmd`
- * shim and command shell that package managers create on Windows.
- */
-declare function resolveWranglerBin(root: string, resolvePackageJson?: (root: string) => string | null): string;
-declare function buildNodeCliInvocation(scriptPath: string, args: string[], nodeExecutable?: string): {
-  file: string;
-  args: string[];
-};
-declare function buildWranglerInvocation(root: string, options: Pick<DeployOptions, "preview" | "env">, nodeExecutable?: string): {
-  file: string;
-  args: string[];
-  env: string | undefined;
-};
-declare function runWranglerDeploy(root: string, options: Pick<DeployOptions, "preview" | "env">, execute?: typeof execFileSync): string;
-/**
- * Read the prerender manifest and inject pregenerated concrete paths into the
- * App Router Worker bundle so the PPR fallback-shell guard is populated at
- * module init time without calling `seedMemoryCacheFromPrerender`.
- *
- * The paths are injected as `globalThis.__VINEXT_PREGENERATED_CONCRETE_PATHS`
- * wrapped in replaceable marker comments, and consumed by
- * `initPregeneratedPathsFromGlobals` in the generated RSC entry.
- *
- * Idempotent: repeated calls strip the previous injection before writing the
- * new one. If the manifest is missing, corrupt, or empty, any prior injection
- * is stripped and nothing new is written — failing closed to empty.
- */
-declare function injectPregeneratedConcretePaths(root: string): void;
-declare function deploy(options: DeployOptions): Promise<void>;
-//#endregion
-export { buildNodeCliInvocation, buildWranglerDeployArgs, buildWranglerInvocation, deploy, detectProject, ensureESModule, formatMissingCacheAdapterError, formatMissingCloudflarePluginError, generateAppRouterViteConfig, generateAppRouterWorkerEntry, generatePagesRouterViteConfig, generatePagesRouterWorkerEntry, generateWranglerConfig, getFilesToGenerate, getMissingDeps, hasWranglerConfig, injectPregeneratedConcretePaths, isPackageResolvable, parseDeployArgs, renameCJSConfigs, resolveWranglerBin, runWranglerDeploy, validateWranglerEnvName, viteConfigHasCacheAdapter, viteConfigHasCloudflarePlugin, withCloudflareEnv, workerEntryHasCacheHandler };