@lovable.dev/vite-tanstack-config 2.21.0 → 2.23.0

package/README.md

@@ -12,3 +12,11 @@ Vite config wrapper for Lovable TanStack Start projects.
 ## Customization
 
 Apps can pass through Vite options and adjust the React, TanStack Start, Nitro, HMR gate, and error-logging behavior when they need to.
+
+## Build exit watchdog
+
+Inside a Lovable build with prerender enabled, the build process is forced to exit if it is still alive 60 seconds after the last build hook has returned, and a `[lovable-build-exit-report]` block naming the open handle types is written to stderr. Adjust it with `defineConfig({ buildExitWatchdog: { graceMs, enabled } })`; the grace is clamped to 5 s–10 min. The `LOVABLE_PRERENDER_EXIT_GRACE_MS` and `LOVABLE_PRERENDER_EXIT_WATCHDOG=off` environment variables override the config.
+
+## Route manifest
+
+Inside a Lovable build, the route surface of the app is written to `dist/.lovable/routes.json` after the build: `{ version, generator, basepath?, serverEntry, requestMiddleware?, routes }`, where `routes` is the generated route tree's `fullPaths` union in TanStack path syntax (`/posts/$postId`, `/files/$`, `/docs/{-$version}`). Lovable's serving layer uses it to answer requests no route can match without starting the app. The file is enumerated with `@tanstack/router-generator` through an in-memory overlay, so the build never rewrites `routeTree.gen.ts`, and it is skipped — with a warning naming the reason — whenever the app can answer paths outside its route tree: `tanstackStart.spa`, `router.virtualRouteConfig`, `nitro.routeRules`/`handlers`, a project `nitro.config.*` / `.config/nitro.*` / `.nitrorc` file (Nitro loads it on its own, so the wrapper cannot see what it adds), a `rewrite` in the router file, a `basepath` there that `tanstackStart.router.basepath` does not declare (a computed or shorthand one included), or a router file (`router.entry`, resolved the way TanStack Start resolves it) that cannot be read to check either.

package/dist/index.cjs

@@ -153,7 +153,7 @@ function bundledDevCssUrlShim() {
 //#endregion
 //#region package.json
 var name = "@lovable.dev/vite-tanstack-config";
-var version = "2.21.0";
+var version = "2.23.0";
 //#endregion
 //#region src/logging.ts
 const PACKAGE_NAME = "@lovable.dev/vite-tanstack-config";
@@ -168,7 +168,7 @@ const CLIENT_OUTPUT_DIR = `${PUBLISH_OUTPUT_DIR}/client`;
 //#endregion
 //#region src/documents.ts
 const DOCUMENT_SET_VERSION = 1;
-const GENERATOR = `${name}@${version}`;
+const GENERATOR$1 = `${name}@${version}`;
 const DOCUMENT_SET_DIR = ".lovable";
 const DOCUMENT_SET_FILE = "output.json";
 const DOCUMENT_SET_PLUGIN_NAME = "lovable:document-set";
@@ -341,7 +341,7 @@ function createDocumentSet(routerBasePath) {
 					}
 					logWarning(`Not publishing prerendered route ${entry.route}: it produced no ${entry.file}.`);
 				}
-				const payload = serializeDocumentSet(present, GENERATOR);
+				const payload = serializeDocumentSet(present, GENERATOR$1);
 				if (payload === void 0) return;
 				try {
 					await mkdir(nodePath.dirname(artifact), { recursive: true });
@@ -367,6 +367,301 @@ function createDocumentSet(routerBasePath) {
 	};
 }
 //#endregion
+//#region src/routes.ts
+const ROUTE_MANIFEST_VERSION = 1;
+const GENERATOR = `${name}@${version}`;
+const ROUTE_MANIFEST_DIR = ".lovable";
+const ROUTE_MANIFEST_FILE = "routes.json";
+const ROUTE_MANIFEST_MAX_ROUTES = 1e3;
+const ROUTE_MANIFEST_MAX_BYTES = 512 * 1024;
+const ROUTE_MANIFEST_PLUGIN_NAME = "lovable:route-manifest";
+const ROUTER_GENERATOR_PACKAGE = "@tanstack/router-generator";
+const ENTRY_EXTENSIONS = [
+	"",
+	".ts",
+	".js",
+	".mts",
+	".mjs",
+	".tsx",
+	".jsx"
+];
+const NITRO_CONFIG_EXTENSIONS = [
+	".js",
+	".ts",
+	".mjs",
+	".cjs",
+	".mts",
+	".cts",
+	".json",
+	".jsonc",
+	".json5",
+	".yaml",
+	".yml",
+	".toml"
+];
+const NITRO_CONFIG_FILES = [
+	...NITRO_CONFIG_EXTENSIONS.map((extension) => `nitro.config${extension}`),
+	...NITRO_CONFIG_EXTENSIONS.flatMap((extension) => [`.config/nitro${extension}`, `.config/nitro.config${extension}`]),
+	".nitrorc"
+];
+function subOptions(options, key) {
+	const value = options[key];
+	return typeof value === "object" && value !== null ? value : {};
+}
+function stringOption(options, key, fallback) {
+	const value = options[key];
+	return typeof value === "string" ? value : fallback;
+}
+/** Why no manifest is emitted: the app can answer paths outside its route tree. */
+function routeManifestOptOut(inputs) {
+	const { tanstackStart } = inputs;
+	if (tanstackStart.spa != null && subOptions(tanstackStart, "spa").enabled !== false) return "tanstackStart.spa serves the shell for every path";
+	if (subOptions(tanstackStart, "router").virtualRouteConfig !== void 0) return "tanstackStart.router.virtualRouteConfig is set";
+	if (typeof inputs.nitro === "object" && inputs.nitro !== null) {
+		for (const key of [
+			"routeRules",
+			"handlers",
+			"devHandlers"
+		]) if (key in inputs.nitro) return `nitro.${key} is set`;
+	}
+}
+function routeFullPaths(routeNodes, inferFullPath) {
+	const paths = /* @__PURE__ */ new Set();
+	for (const node of routeNodes) {
+		if (node.routePath === void 0 || node.isNonPath) continue;
+		paths.add(inferFullPath(node));
+	}
+	return [...paths].sort();
+}
+const COMMENTS = String.raw`(?:(?://[^\n]*\n|/\*[\s\S]*?\*/)\s*)*`;
+const BASEPATH_PROPERTY = new RegExp(String.raw`(?<=[{,]\s*${COMMENTS})\bbasepath\b\s*(?::\s*(?:(['"\x60])([^'"\x60]*)\1)?|(?=${COMMENTS}[,}]))`, "g");
+/**
+* Whether an object-literal `basepath` property in the router file names anything but
+* the declared basepath; a computed value or a shorthand cannot be checked and disagrees.
+*/
+function routerBasepathDisagrees(routerSource, declared) {
+	for (const property of routerSource.matchAll(BASEPATH_PROPERTY)) {
+		const literal = property[2];
+		if (literal === void 0 || normalizeBasePath(literal) !== declared) return true;
+	}
+	return false;
+}
+/** The artifact bytes, or undefined when the manifest would exceed the worker's caps. */
+function serializeRouteManifest(manifest) {
+	if (manifest.routes.length > 1e3) {
+		logWarning(`Not publishing the route manifest: ${manifest.routes.length} routes exceed the ${ROUTE_MANIFEST_MAX_ROUTES}-route limit.`);
+		return;
+	}
+	const payload = JSON.stringify(manifest);
+	const bytes = Buffer.byteLength(payload, "utf8");
+	if (bytes > 524288) {
+		logWarning(`Not publishing the route manifest: ${bytes} bytes exceed the ${ROUTE_MANIFEST_MAX_BYTES}-byte limit.`);
+		return;
+	}
+	return payload;
+}
+function createOverlayFs(fsp) {
+	const overlay = /* @__PURE__ */ new Map();
+	const memStat = () => ({
+		mtimeMs: BigInt(Date.now()) * 1000000n,
+		mode: 420,
+		uid: 0,
+		gid: 0
+	});
+	return {
+		async stat(filePath) {
+			if (overlay.has(filePath)) return memStat();
+			const stat = await fsp.stat(filePath, { bigint: true });
+			return {
+				mtimeMs: stat.mtimeMs,
+				mode: Number(stat.mode),
+				uid: Number(stat.uid),
+				gid: Number(stat.gid)
+			};
+		},
+		async readFile(filePath) {
+			const overlaid = overlay.get(filePath);
+			if (overlaid !== void 0) return {
+				stat: memStat(),
+				fileContent: overlaid
+			};
+			try {
+				const [stat, fileContent] = await Promise.all([fsp.stat(filePath, { bigint: true }), fsp.readFile(filePath, "utf8")]);
+				return {
+					stat: { mtimeMs: stat.mtimeMs },
+					fileContent
+				};
+			} catch (error) {
+				if (error.code === "ENOENT") return "file-not-existing";
+				throw error;
+			}
+		},
+		async writeFile(filePath, content) {
+			overlay.set(filePath, content);
+		},
+		async rename(oldPath, newPath) {
+			const content = overlay.get(oldPath);
+			if (content === void 0) return;
+			overlay.set(newPath, content);
+			overlay.delete(oldPath);
+		},
+		async chmod() {},
+		async chown() {}
+	};
+}
+async function loadRouterGenerator(root) {
+	const { createRequire } = await import("node:module");
+	const { pathToFileURL } = await import("node:url");
+	const nodePath = await import("node:path");
+	const { readFile } = await import("node:fs/promises");
+	let lastError;
+	for (const base of [nodePath.join(root, "package.json"), require("url").pathToFileURL(__filename).href]) try {
+		const packageJsonPath = createRequire(base).resolve(`${ROUTER_GENERATOR_PACKAGE}/package.json`);
+		const packageJson = JSON.parse(await readFile(packageJsonPath, "utf8"));
+		const entry = packageJson.exports?.["."]?.import?.default ?? packageJson.module ?? packageJson.main;
+		if (entry === void 0) throw new Error(`${ROUTER_GENERATOR_PACKAGE} declares no entry point`);
+		return await import(pathToFileURL(nodePath.join(nodePath.dirname(packageJsonPath), entry)).href);
+	} catch (error) {
+		lastError = error;
+	}
+	throw lastError;
+}
+/** The first of `names` (relative to `dir`) that exists, as given. */
+async function findExisting(dir, names) {
+	const { access } = await import("node:fs/promises");
+	const nodePath = await import("node:path");
+	for (const name of names) if (await access(nodePath.join(dir, name)).then(() => true, () => false)) return name;
+}
+async function resolveEntryFile(srcDirectory, entry) {
+	const { stat } = await import("node:fs/promises");
+	const base = (await import("node:path")).resolve(srcDirectory, entry.startsWith("./") ? entry : `./${entry}`);
+	for (const extension of ENTRY_EXTENSIONS) {
+		const file = `${base}${extension}`;
+		if (await stat(file).then((stats) => stats.isFile(), () => false)) return file;
+	}
+}
+async function readSource(file) {
+	if (file === void 0) return void 0;
+	const { readFile } = await import("node:fs/promises");
+	return readFile(file, "utf8").catch(() => void 0);
+}
+async function enumerateRoutes(options) {
+	const fsp = await import("node:fs/promises");
+	const nodePath = await import("node:path");
+	const os = await import("node:os");
+	const generator = await loadRouterGenerator(options.root);
+	const { root, srcDirectory } = options;
+	const routesDirectory = nodePath.resolve(root, srcDirectory, stringOption(options.router, "routesDirectory", "routes"));
+	const generatedRouteTree = nodePath.resolve(root, srcDirectory, stringOption(options.router, "generatedRouteTree", "routeTree.gen.ts"));
+	const tmpDir = await fsp.mkdtemp(nodePath.join(os.tmpdir(), "lovable-route-manifest-"));
+	try {
+		const config = generator.getConfig({
+			...options.router,
+			routesDirectory,
+			generatedRouteTree,
+			tmpDir,
+			disableLogging: true,
+			enableRouteTreeFormatting: false
+		}, root);
+		const crawler = new generator.Generator({
+			config,
+			root,
+			fs: createOverlayFs(fsp)
+		});
+		await crawler.run();
+		const crawl = await crawler.getCrawlingResult();
+		if (crawl === void 0) throw new Error("the route generator produced no crawling result");
+		return routeFullPaths(crawl.acc.routeNodes, generator.inferFullPath);
+	} finally {
+		await fsp.rm(tmpDir, {
+			recursive: true,
+			force: true
+		}).catch(() => {});
+	}
+}
+function createRouteManifestPlugin(inputs) {
+	let root = process.cwd();
+	return {
+		name: ROUTE_MANIFEST_PLUGIN_NAME,
+		apply: "build",
+		enforce: "post",
+		configResolved(config) {
+			root = config.root;
+		},
+		buildApp: {
+			order: "post",
+			async handler() {
+				const { mkdir, rm, writeFile } = await import("node:fs/promises");
+				const nodePath = await import("node:path");
+				const artifact = nodePath.join(root, PUBLISH_OUTPUT_DIR, ROUTE_MANIFEST_DIR, ROUTE_MANIFEST_FILE);
+				await rm(artifact, { force: true }).catch((error) => {
+					logWarning(`Could not remove a previous build's route manifest: ${String(error)}`);
+				});
+				const optOut = routeManifestOptOut(inputs);
+				if (optOut !== void 0) {
+					logWarning(`Not publishing a route manifest: ${optOut}.`);
+					return;
+				}
+				const nitroConfig = await findExisting(root, NITRO_CONFIG_FILES);
+				if (nitroConfig !== void 0) {
+					logWarning(`Not publishing a route manifest: nitro loads ${nitroConfig} on its own, and it may add routes.`);
+					return;
+				}
+				const { tanstackStart } = inputs;
+				const srcDirectory = stringOption(tanstackStart, "srcDirectory", "src");
+				const router = subOptions(tanstackStart, "router");
+				const sourceDir = nodePath.resolve(root, srcDirectory);
+				const routerEntry = stringOption(router, "entry", "router");
+				const routerSource = await readSource(await resolveEntryFile(sourceDir, routerEntry));
+				if (routerSource === void 0) {
+					logWarning(`Not publishing a route manifest: could not read the router file (${routerEntry} under ${srcDirectory}) to check its settings.`);
+					return;
+				}
+				if (/\brewrite\s*:/.test(routerSource)) {
+					logWarning("Not publishing a route manifest: the router file sets `rewrite`.");
+					return;
+				}
+				const basepath = normalizeBasePath(router.basepath);
+				if (routerBasepathDisagrees(routerSource, basepath)) {
+					logWarning("Not publishing a route manifest: the router file sets a `basepath` that tanstackStart.router.basepath does not declare.");
+					return;
+				}
+				let routes;
+				try {
+					routes = await enumerateRoutes({
+						root,
+						srcDirectory,
+						router
+					});
+				} catch (error) {
+					logWarning(`Not publishing a route manifest; could not enumerate the route tree: ${String(error)}`);
+					return;
+				}
+				if (routes.length === 0) {
+					logWarning("Not publishing a route manifest: the route tree has no routes.");
+					return;
+				}
+				const startSource = await readSource(await resolveEntryFile(sourceDir, stringOption(subOptions(tanstackStart, "start"), "entry", "start")));
+				const payload = serializeRouteManifest({
+					version: ROUTE_MANIFEST_VERSION,
+					generator: GENERATOR,
+					...basepath === "" ? {} : { basepath },
+					serverEntry: typeof subOptions(tanstackStart, "server").entry === "string" ? "custom" : "default",
+					...startSource === void 0 ? {} : { requestMiddleware: /\brequestMiddleware\b/.test(startSource) },
+					routes
+				});
+				if (payload === void 0) return;
+				try {
+					await mkdir(nodePath.dirname(artifact), { recursive: true });
+					await writeFile(artifact, payload);
+				} catch (error) {
+					logWarning(`Could not write the route manifest; unknown paths fall back to SSR: ${String(error)}`);
+				}
+			}
+		}
+	};
+}
+//#endregion
 //#region src/index.ts
 const SANDBOX_ENV_VAR = "DEV_SERVER__PROJECT_PATH";
 const LOVABLE_SANDBOX_ENV_VAR = "LOVABLE_SANDBOX";
@@ -950,6 +1245,86 @@ function prerenderPreviewShimCleanup(state) {
 		}
 	};
 }
+const BUILD_EXIT_REPORT_MARKER_OPEN = "[lovable-build-exit-report]";
+const BUILD_EXIT_REPORT_MARKER_CLOSE = "[/lovable-build-exit-report]";
+const EXIT_WATCHDOG_ENV_VAR = "LOVABLE_PRERENDER_EXIT_WATCHDOG";
+const EXIT_GRACE_ENV_VAR = "LOVABLE_PRERENDER_EXIT_GRACE_MS";
+const DEFAULT_EXIT_GRACE_MS = 6e4;
+const MIN_EXIT_GRACE_MS = 5e3;
+const MAX_EXIT_GRACE_MS = 6e5;
+const MAX_REPORTED_HANDLE_TYPES = 20;
+const MAX_REPORTED_HANDLE_TYPE_BYTES = 64;
+const IGNORED_HANDLE_TYPES = /* @__PURE__ */ new Set(["PipeWrap"]);
+function clampGraceMs(value) {
+	return Math.min(MAX_EXIT_GRACE_MS, Math.max(MIN_EXIT_GRACE_MS, Math.floor(value)));
+}
+function resolveExitWatchdog(config) {
+	const enabled = process.env[EXIT_WATCHDOG_ENV_VAR] === "off" ? false : config?.enabled !== false;
+	let graceMs = DEFAULT_EXIT_GRACE_MS;
+	if (config?.graceMs !== void 0) if (typeof config.graceMs === "number" && Number.isFinite(config.graceMs) && config.graceMs > 0) graceMs = clampGraceMs(config.graceMs);
+	else logWarning(`Ignoring buildExitWatchdog.graceMs=${String(config.graceMs)}: expected a positive number of ms.`);
+	const envGrace = process.env[EXIT_GRACE_ENV_VAR];
+	if (envGrace) if (/^\d+$/.test(envGrace) && Number(envGrace) > 0) graceMs = clampGraceMs(Number(envGrace));
+	else logWarning(`Ignoring ${EXIT_GRACE_ENV_VAR}=${envGrace}: expected a positive integer of ms.`);
+	return {
+		enabled,
+		graceMs
+	};
+}
+function cutUtf8(value, maxBytes) {
+	let out = "";
+	let bytes = 0;
+	for (const char of value) {
+		bytes += Buffer.byteLength(char);
+		if (bytes > maxBytes) break;
+		out += char;
+	}
+	return out;
+}
+function collectOpenHandles() {
+	const counts = /* @__PURE__ */ new Map();
+	let resources = [];
+	try {
+		resources = process.getActiveResourcesInfo();
+	} catch {}
+	for (const resource of resources) {
+		if (IGNORED_HANDLE_TYPES.has(resource)) continue;
+		const type = cutUtf8(resource, MAX_REPORTED_HANDLE_TYPE_BYTES);
+		counts.set(type, (counts.get(type) ?? 0) + 1);
+	}
+	const ranked = [...counts.entries()].sort((a, b) => b[1] - a[1]).slice(0, MAX_REPORTED_HANDLE_TYPES);
+	return Object.fromEntries(ranked);
+}
+function emitBuildExitReport(graceMs, exitCode, openHandles) {
+	const payload = JSON.stringify({
+		grace_ms: graceMs,
+		exit_code: exitCode,
+		open_handles: openHandles
+	});
+	try {
+		process.stderr.write(`\n${BUILD_EXIT_REPORT_MARKER_OPEN}\n${payload}\n${BUILD_EXIT_REPORT_MARKER_CLOSE}\n`);
+	} catch {}
+}
+function prerenderExitWatchdog(graceMs) {
+	return {
+		name: "lovable-prerender-exit-watchdog",
+		apply: "build",
+		enforce: "post",
+		buildApp: {
+			order: "post",
+			handler: async () => {
+				setTimeout(() => {
+					const exitCode = Number(process.exitCode ?? 0) || 0;
+					const openHandles = collectOpenHandles();
+					emitBuildExitReport(graceMs, exitCode, openHandles);
+					const types = Object.entries(openHandles).map(([type, count]) => `${type} x${count}`);
+					logWarning(`Build output is complete but the process was still alive ${graceMs}ms after prerender (open handles: ${types.length > 0 ? types.join(", ") : "none reported"}); exiting with code ${exitCode}. Usual causes: TanStack Query gcTime timers armed during SSR, or module-scope timers and connection pools in server code.`);
+					process.exit(exitCode);
+				}, graceMs).unref();
+			}
+		}
+	};
+}
 function prerenderIsEnabled(startOptions) {
 	const spa = startOptions.spa;
 	if (spa && (spa.enabled ?? true)) return true;
@@ -1108,9 +1483,10 @@ function defineConfig(configOrOptions = {}) {
 				optionObject.nitro = false;
 				logWarning("`cloudflare: false` is deprecated in v2 — migrated to `nitro: false`. Update your config to drop the warning.");
 			} else logWarning("The `cloudflare` option was removed in v2. Use `nitro: false` to disable the deploy plugin, or `nitro: { preset: '...' }` to configure it. The `cloudflare` setting is being ignored.");
-			options = "vite" in optionObject || "serverFnErrorLogger" in optionObject || "ssrErrorLogger" in optionObject || "nitro" in optionObject || "tanstackStart" in optionObject || "react" in optionObject || "envDefine" in optionObject || "hmrGate" in optionObject ? optionObject : { vite: optionObject };
+			options = "vite" in optionObject || "serverFnErrorLogger" in optionObject || "ssrErrorLogger" in optionObject || "nitro" in optionObject || "tanstackStart" in optionObject || "react" in optionObject || "envDefine" in optionObject || "hmrGate" in optionObject || "buildExitWatchdog" in optionObject ? optionObject : { vite: optionObject };
 		}
 		const internalPlugins = [];
+		let exitWatchdog;
 		if (mode === "development") {
 			const { devtools } = await import("@tanstack/devtools-vite");
 			internalPlugins.push(devtools({
@@ -1141,6 +1517,10 @@ function defineConfig(configOrOptions = {}) {
 		if (command === "build" && isSandbox) {
 			const { startOptions, skipReporter, documentSet } = pinPrerenderForLovableBuild(tanstackStartOptions);
 			internalPlugins.push(tanstackStart(startOptions), skipReporter, documentSet);
+			internalPlugins.push(createRouteManifestPlugin({
+				tanstackStart: tanstackStartOptions,
+				nitro: options.nitro
+			}));
 		} else internalPlugins.push(tanstackStart(tanstackStartOptions));
 		const explicitNitro = options.nitro === true || typeof options.nitro === "object" && options.nitro !== null;
 		if (options.nitro !== false && command === "build") {
@@ -1195,6 +1575,10 @@ function defineConfig(configOrOptions = {}) {
 					const shimState = {};
 					internalPlugins.push(prerenderPreviewShim(shimState, nitroDirs), prerenderPreviewShimCleanup(shimState));
 				}
+				if (isSandbox && prerenderEnabled) {
+					const watchdog = resolveExitWatchdog(options.buildExitWatchdog);
+					if (watchdog.enabled) exitWatchdog = prerenderExitWatchdog(watchdog.graceMs);
+				}
 				if (isSandbox) internalPlugins.push(stripRedundantNodejsCompatFlag(nitroDirs));
 			}
 		}
@@ -1274,6 +1658,7 @@ function defineConfig(configOrOptions = {}) {
 			host: PRERENDER_PREVIEW_HOST,
 			port: 0
 		} }, config);
+		if (exitWatchdog) config = (0, vite.mergeConfig)(config, { plugins: [exitWatchdog] });
 		if (isSandbox) return config;
 		return applyWatchDebounceDefaults(config);
 	};

package/dist/index.d.cts

@@ -30,6 +30,12 @@ type PrerenderShimDirs = {
   /** Filled by nitro's `compiled` hook, which fires inside its own post-order `buildApp`. */
   nitroOutput: NitroOutput;
 };
+interface BuildExitWatchdogOptions {
+  /** Grace after the post-build hooks before the process is forced to exit. Clamped to 5s-10min. Default 60_000. */
+  graceMs?: number;
+  /** Set to false to let a build that keeps handles open run until the publish limit. Default true. */
+  enabled?: boolean;
+}
 interface LovableViteTanstackOptions {
   plugins?: PluginOption[];
   vite?: UserConfig;
@@ -77,6 +83,8 @@ interface LovableViteTanstackOptions {
   envDefine?: boolean;
   /** hmrGatePlugin() options. Default on in sandbox (false disables); true or an options object enables elsewhere. */
   hmrGate?: boolean | Record<string, unknown>;
+  /** Forced exit after a Lovable prerender build when the server bundle keeps handles open. Sandbox builds only. */
+  buildExitWatchdog?: BuildExitWatchdogOptions;
 }
 declare function defineConfig(config: UserConfig): (env: ConfigEnv) => Promise<UserConfig>;
 declare function defineConfig(config: Promise<UserConfig>): (env: ConfigEnv) => Promise<UserConfig>;
@@ -85,4 +93,4 @@ declare function defineConfig(config: UserConfigFnPromise): (env: ConfigEnv) =>
 declare function defineConfig(config: UserConfigFn): (env: ConfigEnv) => Promise<UserConfig>;
 declare function defineConfig(options?: LovableViteTanstackOptions): (env: ConfigEnv) => Promise<UserConfig>;
 //#endregion
-export { LovableViteTanstackOptions, type PrerenderPage, defineConfig, lovableAssetsProxyPlugin, stripRedundantNodejsCompatFlag };
+export { BuildExitWatchdogOptions, LovableViteTanstackOptions, type PrerenderPage, defineConfig, lovableAssetsProxyPlugin, stripRedundantNodejsCompatFlag };

package/dist/index.d.ts

@@ -30,6 +30,12 @@ type PrerenderShimDirs = {
   /** Filled by nitro's `compiled` hook, which fires inside its own post-order `buildApp`. */
   nitroOutput: NitroOutput;
 };
+interface BuildExitWatchdogOptions {
+  /** Grace after the post-build hooks before the process is forced to exit. Clamped to 5s-10min. Default 60_000. */
+  graceMs?: number;
+  /** Set to false to let a build that keeps handles open run until the publish limit. Default true. */
+  enabled?: boolean;
+}
 interface LovableViteTanstackOptions {
   plugins?: PluginOption[];
   vite?: UserConfig;
@@ -77,6 +83,8 @@ interface LovableViteTanstackOptions {
   envDefine?: boolean;
   /** hmrGatePlugin() options. Default on in sandbox (false disables); true or an options object enables elsewhere. */
   hmrGate?: boolean | Record<string, unknown>;
+  /** Forced exit after a Lovable prerender build when the server bundle keeps handles open. Sandbox builds only. */
+  buildExitWatchdog?: BuildExitWatchdogOptions;
 }
 declare function defineConfig(config: UserConfig): (env: ConfigEnv) => Promise<UserConfig>;
 declare function defineConfig(config: Promise<UserConfig>): (env: ConfigEnv) => Promise<UserConfig>;
@@ -85,4 +93,4 @@ declare function defineConfig(config: UserConfigFnPromise): (env: ConfigEnv) =>
 declare function defineConfig(config: UserConfigFn): (env: ConfigEnv) => Promise<UserConfig>;
 declare function defineConfig(options?: LovableViteTanstackOptions): (env: ConfigEnv) => Promise<UserConfig>;
 //#endregion
-export { LovableViteTanstackOptions, type PrerenderPage, defineConfig, lovableAssetsProxyPlugin, stripRedundantNodejsCompatFlag };
+export { BuildExitWatchdogOptions, LovableViteTanstackOptions, type PrerenderPage, defineConfig, lovableAssetsProxyPlugin, stripRedundantNodejsCompatFlag };

package/dist/index.js

@@ -129,7 +129,7 @@ function bundledDevCssUrlShim() {
 //#endregion
 //#region package.json
 var name = "@lovable.dev/vite-tanstack-config";
-var version = "2.21.0";
+var version = "2.23.0";
 //#endregion
 //#region src/logging.ts
 const PACKAGE_NAME = "@lovable.dev/vite-tanstack-config";
@@ -144,7 +144,7 @@ const CLIENT_OUTPUT_DIR = `${PUBLISH_OUTPUT_DIR}/client`;
 //#endregion
 //#region src/documents.ts
 const DOCUMENT_SET_VERSION = 1;
-const GENERATOR = `${name}@${version}`;
+const GENERATOR$1 = `${name}@${version}`;
 const DOCUMENT_SET_DIR = ".lovable";
 const DOCUMENT_SET_FILE = "output.json";
 const DOCUMENT_SET_PLUGIN_NAME = "lovable:document-set";
@@ -317,7 +317,7 @@ function createDocumentSet(routerBasePath) {
 					}
 					logWarning(`Not publishing prerendered route ${entry.route}: it produced no ${entry.file}.`);
 				}
-				const payload = serializeDocumentSet(present, GENERATOR);
+				const payload = serializeDocumentSet(present, GENERATOR$1);
 				if (payload === void 0) return;
 				try {
 					await mkdir(nodePath.dirname(artifact), { recursive: true });
@@ -343,6 +343,301 @@ function createDocumentSet(routerBasePath) {
 	};
 }
 //#endregion
+//#region src/routes.ts
+const ROUTE_MANIFEST_VERSION = 1;
+const GENERATOR = `${name}@${version}`;
+const ROUTE_MANIFEST_DIR = ".lovable";
+const ROUTE_MANIFEST_FILE = "routes.json";
+const ROUTE_MANIFEST_MAX_ROUTES = 1e3;
+const ROUTE_MANIFEST_MAX_BYTES = 512 * 1024;
+const ROUTE_MANIFEST_PLUGIN_NAME = "lovable:route-manifest";
+const ROUTER_GENERATOR_PACKAGE = "@tanstack/router-generator";
+const ENTRY_EXTENSIONS = [
+	"",
+	".ts",
+	".js",
+	".mts",
+	".mjs",
+	".tsx",
+	".jsx"
+];
+const NITRO_CONFIG_EXTENSIONS = [
+	".js",
+	".ts",
+	".mjs",
+	".cjs",
+	".mts",
+	".cts",
+	".json",
+	".jsonc",
+	".json5",
+	".yaml",
+	".yml",
+	".toml"
+];
+const NITRO_CONFIG_FILES = [
+	...NITRO_CONFIG_EXTENSIONS.map((extension) => `nitro.config${extension}`),
+	...NITRO_CONFIG_EXTENSIONS.flatMap((extension) => [`.config/nitro${extension}`, `.config/nitro.config${extension}`]),
+	".nitrorc"
+];
+function subOptions(options, key) {
+	const value = options[key];
+	return typeof value === "object" && value !== null ? value : {};
+}
+function stringOption(options, key, fallback) {
+	const value = options[key];
+	return typeof value === "string" ? value : fallback;
+}
+/** Why no manifest is emitted: the app can answer paths outside its route tree. */
+function routeManifestOptOut(inputs) {
+	const { tanstackStart } = inputs;
+	if (tanstackStart.spa != null && subOptions(tanstackStart, "spa").enabled !== false) return "tanstackStart.spa serves the shell for every path";
+	if (subOptions(tanstackStart, "router").virtualRouteConfig !== void 0) return "tanstackStart.router.virtualRouteConfig is set";
+	if (typeof inputs.nitro === "object" && inputs.nitro !== null) {
+		for (const key of [
+			"routeRules",
+			"handlers",
+			"devHandlers"
+		]) if (key in inputs.nitro) return `nitro.${key} is set`;
+	}
+}
+function routeFullPaths(routeNodes, inferFullPath) {
+	const paths = /* @__PURE__ */ new Set();
+	for (const node of routeNodes) {
+		if (node.routePath === void 0 || node.isNonPath) continue;
+		paths.add(inferFullPath(node));
+	}
+	return [...paths].sort();
+}
+const COMMENTS = String.raw`(?:(?://[^\n]*\n|/\*[\s\S]*?\*/)\s*)*`;
+const BASEPATH_PROPERTY = new RegExp(String.raw`(?<=[{,]\s*${COMMENTS})\bbasepath\b\s*(?::\s*(?:(['"\x60])([^'"\x60]*)\1)?|(?=${COMMENTS}[,}]))`, "g");
+/**
+* Whether an object-literal `basepath` property in the router file names anything but
+* the declared basepath; a computed value or a shorthand cannot be checked and disagrees.
+*/
+function routerBasepathDisagrees(routerSource, declared) {
+	for (const property of routerSource.matchAll(BASEPATH_PROPERTY)) {
+		const literal = property[2];
+		if (literal === void 0 || normalizeBasePath(literal) !== declared) return true;
+	}
+	return false;
+}
+/** The artifact bytes, or undefined when the manifest would exceed the worker's caps. */
+function serializeRouteManifest(manifest) {
+	if (manifest.routes.length > 1e3) {
+		logWarning(`Not publishing the route manifest: ${manifest.routes.length} routes exceed the ${ROUTE_MANIFEST_MAX_ROUTES}-route limit.`);
+		return;
+	}
+	const payload = JSON.stringify(manifest);
+	const bytes = Buffer.byteLength(payload, "utf8");
+	if (bytes > 524288) {
+		logWarning(`Not publishing the route manifest: ${bytes} bytes exceed the ${ROUTE_MANIFEST_MAX_BYTES}-byte limit.`);
+		return;
+	}
+	return payload;
+}
+function createOverlayFs(fsp) {
+	const overlay = /* @__PURE__ */ new Map();
+	const memStat = () => ({
+		mtimeMs: BigInt(Date.now()) * 1000000n,
+		mode: 420,
+		uid: 0,
+		gid: 0
+	});
+	return {
+		async stat(filePath) {
+			if (overlay.has(filePath)) return memStat();
+			const stat = await fsp.stat(filePath, { bigint: true });
+			return {
+				mtimeMs: stat.mtimeMs,
+				mode: Number(stat.mode),
+				uid: Number(stat.uid),
+				gid: Number(stat.gid)
+			};
+		},
+		async readFile(filePath) {
+			const overlaid = overlay.get(filePath);
+			if (overlaid !== void 0) return {
+				stat: memStat(),
+				fileContent: overlaid
+			};
+			try {
+				const [stat, fileContent] = await Promise.all([fsp.stat(filePath, { bigint: true }), fsp.readFile(filePath, "utf8")]);
+				return {
+					stat: { mtimeMs: stat.mtimeMs },
+					fileContent
+				};
+			} catch (error) {
+				if (error.code === "ENOENT") return "file-not-existing";
+				throw error;
+			}
+		},
+		async writeFile(filePath, content) {
+			overlay.set(filePath, content);
+		},
+		async rename(oldPath, newPath) {
+			const content = overlay.get(oldPath);
+			if (content === void 0) return;
+			overlay.set(newPath, content);
+			overlay.delete(oldPath);
+		},
+		async chmod() {},
+		async chown() {}
+	};
+}
+async function loadRouterGenerator(root) {
+	const { createRequire } = await import("node:module");
+	const { pathToFileURL } = await import("node:url");
+	const nodePath = await import("node:path");
+	const { readFile } = await import("node:fs/promises");
+	let lastError;
+	for (const base of [nodePath.join(root, "package.json"), import.meta.url]) try {
+		const packageJsonPath = createRequire(base).resolve(`${ROUTER_GENERATOR_PACKAGE}/package.json`);
+		const packageJson = JSON.parse(await readFile(packageJsonPath, "utf8"));
+		const entry = packageJson.exports?.["."]?.import?.default ?? packageJson.module ?? packageJson.main;
+		if (entry === void 0) throw new Error(`${ROUTER_GENERATOR_PACKAGE} declares no entry point`);
+		return await import(pathToFileURL(nodePath.join(nodePath.dirname(packageJsonPath), entry)).href);
+	} catch (error) {
+		lastError = error;
+	}
+	throw lastError;
+}
+/** The first of `names` (relative to `dir`) that exists, as given. */
+async function findExisting(dir, names) {
+	const { access } = await import("node:fs/promises");
+	const nodePath = await import("node:path");
+	for (const name of names) if (await access(nodePath.join(dir, name)).then(() => true, () => false)) return name;
+}
+async function resolveEntryFile(srcDirectory, entry) {
+	const { stat } = await import("node:fs/promises");
+	const base = (await import("node:path")).resolve(srcDirectory, entry.startsWith("./") ? entry : `./${entry}`);
+	for (const extension of ENTRY_EXTENSIONS) {
+		const file = `${base}${extension}`;
+		if (await stat(file).then((stats) => stats.isFile(), () => false)) return file;
+	}
+}
+async function readSource(file) {
+	if (file === void 0) return void 0;
+	const { readFile } = await import("node:fs/promises");
+	return readFile(file, "utf8").catch(() => void 0);
+}
+async function enumerateRoutes(options) {
+	const fsp = await import("node:fs/promises");
+	const nodePath = await import("node:path");
+	const os = await import("node:os");
+	const generator = await loadRouterGenerator(options.root);
+	const { root, srcDirectory } = options;
+	const routesDirectory = nodePath.resolve(root, srcDirectory, stringOption(options.router, "routesDirectory", "routes"));
+	const generatedRouteTree = nodePath.resolve(root, srcDirectory, stringOption(options.router, "generatedRouteTree", "routeTree.gen.ts"));
+	const tmpDir = await fsp.mkdtemp(nodePath.join(os.tmpdir(), "lovable-route-manifest-"));
+	try {
+		const config = generator.getConfig({
+			...options.router,
+			routesDirectory,
+			generatedRouteTree,
+			tmpDir,
+			disableLogging: true,
+			enableRouteTreeFormatting: false
+		}, root);
+		const crawler = new generator.Generator({
+			config,
+			root,
+			fs: createOverlayFs(fsp)
+		});
+		await crawler.run();
+		const crawl = await crawler.getCrawlingResult();
+		if (crawl === void 0) throw new Error("the route generator produced no crawling result");
+		return routeFullPaths(crawl.acc.routeNodes, generator.inferFullPath);
+	} finally {
+		await fsp.rm(tmpDir, {
+			recursive: true,
+			force: true
+		}).catch(() => {});
+	}
+}
+function createRouteManifestPlugin(inputs) {
+	let root = process.cwd();
+	return {
+		name: ROUTE_MANIFEST_PLUGIN_NAME,
+		apply: "build",
+		enforce: "post",
+		configResolved(config) {
+			root = config.root;
+		},
+		buildApp: {
+			order: "post",
+			async handler() {
+				const { mkdir, rm, writeFile } = await import("node:fs/promises");
+				const nodePath = await import("node:path");
+				const artifact = nodePath.join(root, PUBLISH_OUTPUT_DIR, ROUTE_MANIFEST_DIR, ROUTE_MANIFEST_FILE);
+				await rm(artifact, { force: true }).catch((error) => {
+					logWarning(`Could not remove a previous build's route manifest: ${String(error)}`);
+				});
+				const optOut = routeManifestOptOut(inputs);
+				if (optOut !== void 0) {
+					logWarning(`Not publishing a route manifest: ${optOut}.`);
+					return;
+				}
+				const nitroConfig = await findExisting(root, NITRO_CONFIG_FILES);
+				if (nitroConfig !== void 0) {
+					logWarning(`Not publishing a route manifest: nitro loads ${nitroConfig} on its own, and it may add routes.`);
+					return;
+				}
+				const { tanstackStart } = inputs;
+				const srcDirectory = stringOption(tanstackStart, "srcDirectory", "src");
+				const router = subOptions(tanstackStart, "router");
+				const sourceDir = nodePath.resolve(root, srcDirectory);
+				const routerEntry = stringOption(router, "entry", "router");
+				const routerSource = await readSource(await resolveEntryFile(sourceDir, routerEntry));
+				if (routerSource === void 0) {
+					logWarning(`Not publishing a route manifest: could not read the router file (${routerEntry} under ${srcDirectory}) to check its settings.`);
+					return;
+				}
+				if (/\brewrite\s*:/.test(routerSource)) {
+					logWarning("Not publishing a route manifest: the router file sets `rewrite`.");
+					return;
+				}
+				const basepath = normalizeBasePath(router.basepath);
+				if (routerBasepathDisagrees(routerSource, basepath)) {
+					logWarning("Not publishing a route manifest: the router file sets a `basepath` that tanstackStart.router.basepath does not declare.");
+					return;
+				}
+				let routes;
+				try {
+					routes = await enumerateRoutes({
+						root,
+						srcDirectory,
+						router
+					});
+				} catch (error) {
+					logWarning(`Not publishing a route manifest; could not enumerate the route tree: ${String(error)}`);
+					return;
+				}
+				if (routes.length === 0) {
+					logWarning("Not publishing a route manifest: the route tree has no routes.");
+					return;
+				}
+				const startSource = await readSource(await resolveEntryFile(sourceDir, stringOption(subOptions(tanstackStart, "start"), "entry", "start")));
+				const payload = serializeRouteManifest({
+					version: ROUTE_MANIFEST_VERSION,
+					generator: GENERATOR,
+					...basepath === "" ? {} : { basepath },
+					serverEntry: typeof subOptions(tanstackStart, "server").entry === "string" ? "custom" : "default",
+					...startSource === void 0 ? {} : { requestMiddleware: /\brequestMiddleware\b/.test(startSource) },
+					routes
+				});
+				if (payload === void 0) return;
+				try {
+					await mkdir(nodePath.dirname(artifact), { recursive: true });
+					await writeFile(artifact, payload);
+				} catch (error) {
+					logWarning(`Could not write the route manifest; unknown paths fall back to SSR: ${String(error)}`);
+				}
+			}
+		}
+	};
+}
+//#endregion
 //#region src/index.ts
 const SANDBOX_ENV_VAR = "DEV_SERVER__PROJECT_PATH";
 const LOVABLE_SANDBOX_ENV_VAR = "LOVABLE_SANDBOX";
@@ -926,6 +1221,86 @@ function prerenderPreviewShimCleanup(state) {
 		}
 	};
 }
+const BUILD_EXIT_REPORT_MARKER_OPEN = "[lovable-build-exit-report]";
+const BUILD_EXIT_REPORT_MARKER_CLOSE = "[/lovable-build-exit-report]";
+const EXIT_WATCHDOG_ENV_VAR = "LOVABLE_PRERENDER_EXIT_WATCHDOG";
+const EXIT_GRACE_ENV_VAR = "LOVABLE_PRERENDER_EXIT_GRACE_MS";
+const DEFAULT_EXIT_GRACE_MS = 6e4;
+const MIN_EXIT_GRACE_MS = 5e3;
+const MAX_EXIT_GRACE_MS = 6e5;
+const MAX_REPORTED_HANDLE_TYPES = 20;
+const MAX_REPORTED_HANDLE_TYPE_BYTES = 64;
+const IGNORED_HANDLE_TYPES = /* @__PURE__ */ new Set(["PipeWrap"]);
+function clampGraceMs(value) {
+	return Math.min(MAX_EXIT_GRACE_MS, Math.max(MIN_EXIT_GRACE_MS, Math.floor(value)));
+}
+function resolveExitWatchdog(config) {
+	const enabled = process.env[EXIT_WATCHDOG_ENV_VAR] === "off" ? false : config?.enabled !== false;
+	let graceMs = DEFAULT_EXIT_GRACE_MS;
+	if (config?.graceMs !== void 0) if (typeof config.graceMs === "number" && Number.isFinite(config.graceMs) && config.graceMs > 0) graceMs = clampGraceMs(config.graceMs);
+	else logWarning(`Ignoring buildExitWatchdog.graceMs=${String(config.graceMs)}: expected a positive number of ms.`);
+	const envGrace = process.env[EXIT_GRACE_ENV_VAR];
+	if (envGrace) if (/^\d+$/.test(envGrace) && Number(envGrace) > 0) graceMs = clampGraceMs(Number(envGrace));
+	else logWarning(`Ignoring ${EXIT_GRACE_ENV_VAR}=${envGrace}: expected a positive integer of ms.`);
+	return {
+		enabled,
+		graceMs
+	};
+}
+function cutUtf8(value, maxBytes) {
+	let out = "";
+	let bytes = 0;
+	for (const char of value) {
+		bytes += Buffer.byteLength(char);
+		if (bytes > maxBytes) break;
+		out += char;
+	}
+	return out;
+}
+function collectOpenHandles() {
+	const counts = /* @__PURE__ */ new Map();
+	let resources = [];
+	try {
+		resources = process.getActiveResourcesInfo();
+	} catch {}
+	for (const resource of resources) {
+		if (IGNORED_HANDLE_TYPES.has(resource)) continue;
+		const type = cutUtf8(resource, MAX_REPORTED_HANDLE_TYPE_BYTES);
+		counts.set(type, (counts.get(type) ?? 0) + 1);
+	}
+	const ranked = [...counts.entries()].sort((a, b) => b[1] - a[1]).slice(0, MAX_REPORTED_HANDLE_TYPES);
+	return Object.fromEntries(ranked);
+}
+function emitBuildExitReport(graceMs, exitCode, openHandles) {
+	const payload = JSON.stringify({
+		grace_ms: graceMs,
+		exit_code: exitCode,
+		open_handles: openHandles
+	});
+	try {
+		process.stderr.write(`\n${BUILD_EXIT_REPORT_MARKER_OPEN}\n${payload}\n${BUILD_EXIT_REPORT_MARKER_CLOSE}\n`);
+	} catch {}
+}
+function prerenderExitWatchdog(graceMs) {
+	return {
+		name: "lovable-prerender-exit-watchdog",
+		apply: "build",
+		enforce: "post",
+		buildApp: {
+			order: "post",
+			handler: async () => {
+				setTimeout(() => {
+					const exitCode = Number(process.exitCode ?? 0) || 0;
+					const openHandles = collectOpenHandles();
+					emitBuildExitReport(graceMs, exitCode, openHandles);
+					const types = Object.entries(openHandles).map(([type, count]) => `${type} x${count}`);
+					logWarning(`Build output is complete but the process was still alive ${graceMs}ms after prerender (open handles: ${types.length > 0 ? types.join(", ") : "none reported"}); exiting with code ${exitCode}. Usual causes: TanStack Query gcTime timers armed during SSR, or module-scope timers and connection pools in server code.`);
+					process.exit(exitCode);
+				}, graceMs).unref();
+			}
+		}
+	};
+}
 function prerenderIsEnabled(startOptions) {
 	const spa = startOptions.spa;
 	if (spa && (spa.enabled ?? true)) return true;
@@ -1084,9 +1459,10 @@ function defineConfig(configOrOptions = {}) {
 				optionObject.nitro = false;
 				logWarning("`cloudflare: false` is deprecated in v2 — migrated to `nitro: false`. Update your config to drop the warning.");
 			} else logWarning("The `cloudflare` option was removed in v2. Use `nitro: false` to disable the deploy plugin, or `nitro: { preset: '...' }` to configure it. The `cloudflare` setting is being ignored.");
-			options = "vite" in optionObject || "serverFnErrorLogger" in optionObject || "ssrErrorLogger" in optionObject || "nitro" in optionObject || "tanstackStart" in optionObject || "react" in optionObject || "envDefine" in optionObject || "hmrGate" in optionObject ? optionObject : { vite: optionObject };
+			options = "vite" in optionObject || "serverFnErrorLogger" in optionObject || "ssrErrorLogger" in optionObject || "nitro" in optionObject || "tanstackStart" in optionObject || "react" in optionObject || "envDefine" in optionObject || "hmrGate" in optionObject || "buildExitWatchdog" in optionObject ? optionObject : { vite: optionObject };
 		}
 		const internalPlugins = [];
+		let exitWatchdog;
 		if (mode === "development") {
 			const { devtools } = await import("@tanstack/devtools-vite");
 			internalPlugins.push(devtools({
@@ -1117,6 +1493,10 @@ function defineConfig(configOrOptions = {}) {
 		if (command === "build" && isSandbox) {
 			const { startOptions, skipReporter, documentSet } = pinPrerenderForLovableBuild(tanstackStartOptions);
 			internalPlugins.push(tanstackStart(startOptions), skipReporter, documentSet);
+			internalPlugins.push(createRouteManifestPlugin({
+				tanstackStart: tanstackStartOptions,
+				nitro: options.nitro
+			}));
 		} else internalPlugins.push(tanstackStart(tanstackStartOptions));
 		const explicitNitro = options.nitro === true || typeof options.nitro === "object" && options.nitro !== null;
 		if (options.nitro !== false && command === "build") {
@@ -1171,6 +1551,10 @@ function defineConfig(configOrOptions = {}) {
 					const shimState = {};
 					internalPlugins.push(prerenderPreviewShim(shimState, nitroDirs), prerenderPreviewShimCleanup(shimState));
 				}
+				if (isSandbox && prerenderEnabled) {
+					const watchdog = resolveExitWatchdog(options.buildExitWatchdog);
+					if (watchdog.enabled) exitWatchdog = prerenderExitWatchdog(watchdog.graceMs);
+				}
 				if (isSandbox) internalPlugins.push(stripRedundantNodejsCompatFlag(nitroDirs));
 			}
 		}
@@ -1250,6 +1634,7 @@ function defineConfig(configOrOptions = {}) {
 			host: PRERENDER_PREVIEW_HOST,
 			port: 0
 		} }, config);
+		if (exitWatchdog) config = mergeConfig(config, { plugins: [exitWatchdog] });
 		if (isSandbox) return config;
 		return applyWatchDebounceDefaults(config);
 	};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lovable.dev/vite-tanstack-config",
-  "version": "2.21.0",
+  "version": "2.23.0",
   "description": "Vite config wrapper for Lovable TanStack Start projects",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -69,19 +69,28 @@
     "vite-tsconfig-paths": ">=6.0.0",
     "nitro": ">=3.0.260603-beta",
     "@tanstack/react-start": ">=1.100.0",
+    "@tanstack/router-generator": ">=1.121.0 <1.166.45 || >=1.166.49",
     "@vitejs/plugin-react": ">=4.0.0"
   },
   "peerDependenciesMeta": {
     "nitro": {
       "optional": true
+    },
+    "@tanstack/router-generator": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@tailwindcss/vite": "^4.3.0",
+    "@tanstack/react-query": "^5.102.8",
+    "@tanstack/react-router": "1.170.30",
     "@tanstack/react-start": "^1.167.50",
+    "@tanstack/router-generator": "^1.167.31",
     "@types/node": "22.13.13",
     "@vitejs/plugin-react": "^5.2.0",
     "nitro": "3.0.260603-beta",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
     "rimraf": "^5.0.0",
     "tsdown": "^0.22.5",
     "typescript": "7.0.2",
@@ -100,7 +109,8 @@
     "typecheck": "tsgo --noEmit",
     "dev": "tsdown --watch",
     "test": "vitest run",
-    "test:watch": "vitest",
+    "test:unit": "vitest run --project unit",
+    "test:watch": "vitest --project unit",
     "clean": "rimraf dist",
     "coverage": "vitest run --coverage"
   }