@lovable.dev/vite-tanstack-config 2.17.0 → 2.18.0

package/dist/hmr-gate.cjs

@@ -8,6 +8,24 @@ function requestPathname(req) {
 	const queryStart = url.indexOf("?");
 	return queryStart === -1 ? url : url.slice(0, queryStart);
 }
+const nonNavigationPrefixes = [
+	"/@vite/",
+	"/@fs/",
+	"/@id/",
+	"/@react-refresh",
+	"/api/",
+	"/go-api/",
+	"/assets/",
+	"/src/",
+	"/_",
+	"/favicon"
+];
+function isHtmlNavigationRequest(req) {
+	if (req.method !== "GET") return false;
+	const url = req.url;
+	if (!url || nonNavigationPrefixes.some((prefix) => url.startsWith(prefix))) return false;
+	return (req.headers.accept ?? "").includes("text/html");
+}
 function gateStatusHeaders(req) {
 	const origin = req.headers.origin;
 	const headers = {
@@ -233,6 +251,7 @@ function hmrGatePlugin(options = {}) {
 		lastUpdateKey = "";
 	}
 	let classicFailOpenTimer = null;
+	let errorServedSinceFlush = false;
 	let transportMode = false;
 	let swallowedUpdates = 0;
 	let heldReload = false;
@@ -420,6 +439,12 @@ function hmrGatePlugin(options = {}) {
 				});
 				srv.middlewares.use((req, res, next) => {
 					if (req.method !== "POST" || requestPathname(req) !== "/__hmr_flush") return next();
+					const flushOrigin = req.headers.origin;
+					if (typeof flushOrigin === "string" && !statusCorsOriginRe.test(flushOrigin)) {
+						res.writeHead(403, { "Content-Type": "application/json" });
+						res.end(JSON.stringify({ error: "origin not allowed" }));
+						return;
+					}
 					const priorDrainUntil = drainUntil;
 					const released = releaseParked();
 					drainUntil = Date.now() + drainMs;
@@ -494,6 +519,23 @@ function hmrGatePlugin(options = {}) {
 				});
 				return;
 			}
+			srv.middlewares.use((req, res, next) => {
+				const originalEnd = res.end.bind(res);
+				res.end = ((...args) => {
+					if (res.statusCode >= 500 && isHtmlNavigationRequest(req)) {
+						errorServedSinceFlush = true;
+						if (classicFailOpenTimer === null) {
+							classicFailOpenTimer = setTimeout(() => {
+								classicFailOpenTimer = null;
+								flushPending();
+							}, maxHoldMs);
+							classicFailOpenTimer.unref?.();
+						}
+					}
+					return originalEnd(...args);
+				});
+				next();
+			});
 			const _emit = srv.watcher.emit.bind(srv.watcher);
 			originalEmit = _emit;
 			const flushPending = () => {
@@ -502,6 +544,9 @@ function hmrGatePlugin(options = {}) {
 					classicFailOpenTimer = null;
 				}
 				if (pending.size > 0) noteUpdateFlush();
+				const errorServed = errorServedSinceFlush;
+				errorServedSinceFlush = false;
+				if (errorServed) srv.moduleGraph.invalidateAll();
 				const entries = Array.from(pending.entries());
 				pending.clear();
 				for (const [f] of entries) srv.moduleGraph.onFileChange(f);
@@ -514,7 +559,11 @@ function hmrGatePlugin(options = {}) {
 					}
 					if (fullReload) srv.ws.send({ type: "full-reload" });
 				}
-				return entries;
+				if (errorServed && (entries.length === 0 || !fullReload)) srv.ws.send({ type: "full-reload" });
+				return {
+					entries,
+					errorRecovery: errorServed
+				};
 			};
 			srv.watcher.emit = ((event, ...args) => {
 				if (typeof event === "string" && gatedEvents.has(event) && !isPassthrough(args[0])) {
@@ -523,7 +572,7 @@ function hmrGatePlugin(options = {}) {
 						const hash = fileContentHash(filePath);
 						if (hash !== null && hash === lastFlushedHashes.get(filePath)) {
 							pending.delete(filePath);
-							if (pending.size === 0 && classicFailOpenTimer !== null) {
+							if (pending.size === 0 && !errorServedSinceFlush && classicFailOpenTimer !== null) {
 								clearTimeout(classicFailOpenTimer);
 								classicFailOpenTimer = null;
 							}
@@ -550,11 +599,18 @@ function hmrGatePlugin(options = {}) {
 			});
 			srv.middlewares.use((req, res, next) => {
 				if (req.method !== "POST" || requestPathname(req) !== "/__hmr_flush") return next();
-				const entries = flushPending();
+				const origin = req.headers.origin;
+				if (typeof origin === "string" && !statusCorsOriginRe.test(origin)) {
+					res.writeHead(403, { "Content-Type": "application/json" });
+					res.end(JSON.stringify({ error: "origin not allowed" }));
+					return;
+				}
+				const { entries, errorRecovery } = flushPending();
 				const files = entries.map(([f]) => f);
 				const body = JSON.stringify({
 					flushed: files,
 					count: entries.length,
+					errorRecovery,
 					mode: fullReload ? "full-reload" : "granular"
 				});
 				res.writeHead(200, { "Content-Type": "application/json" });
@@ -567,7 +623,8 @@ function hmrGatePlugin(options = {}) {
 				const body = JSON.stringify({
 					enabled: true,
 					pending: serialized,
-					count: pending.size,
+					count: pending.size + (errorServedSinceFlush ? 1 : 0),
+					errorRecovery: errorServedSinceFlush,
 					mode: fullReload ? "full-reload" : "granular"
 				});
 				res.writeHead(200, gateStatusHeaders(req));
@@ -609,6 +666,7 @@ function hmrGatePlugin(options = {}) {
 			drainUntil = 0;
 			pending.clear();
 			lastFlushedHashes.clear();
+			errorServedSinceFlush = false;
 			server = null;
 			originalEmit = null;
 		}

package/dist/hmr-gate.js

@@ -7,6 +7,24 @@ function requestPathname(req) {
 	const queryStart = url.indexOf("?");
 	return queryStart === -1 ? url : url.slice(0, queryStart);
 }
+const nonNavigationPrefixes = [
+	"/@vite/",
+	"/@fs/",
+	"/@id/",
+	"/@react-refresh",
+	"/api/",
+	"/go-api/",
+	"/assets/",
+	"/src/",
+	"/_",
+	"/favicon"
+];
+function isHtmlNavigationRequest(req) {
+	if (req.method !== "GET") return false;
+	const url = req.url;
+	if (!url || nonNavigationPrefixes.some((prefix) => url.startsWith(prefix))) return false;
+	return (req.headers.accept ?? "").includes("text/html");
+}
 function gateStatusHeaders(req) {
 	const origin = req.headers.origin;
 	const headers = {
@@ -232,6 +250,7 @@ function hmrGatePlugin(options = {}) {
 		lastUpdateKey = "";
 	}
 	let classicFailOpenTimer = null;
+	let errorServedSinceFlush = false;
 	let transportMode = false;
 	let swallowedUpdates = 0;
 	let heldReload = false;
@@ -419,6 +438,12 @@ function hmrGatePlugin(options = {}) {
 				});
 				srv.middlewares.use((req, res, next) => {
 					if (req.method !== "POST" || requestPathname(req) !== "/__hmr_flush") return next();
+					const flushOrigin = req.headers.origin;
+					if (typeof flushOrigin === "string" && !statusCorsOriginRe.test(flushOrigin)) {
+						res.writeHead(403, { "Content-Type": "application/json" });
+						res.end(JSON.stringify({ error: "origin not allowed" }));
+						return;
+					}
 					const priorDrainUntil = drainUntil;
 					const released = releaseParked();
 					drainUntil = Date.now() + drainMs;
@@ -493,6 +518,23 @@ function hmrGatePlugin(options = {}) {
 				});
 				return;
 			}
+			srv.middlewares.use((req, res, next) => {
+				const originalEnd = res.end.bind(res);
+				res.end = ((...args) => {
+					if (res.statusCode >= 500 && isHtmlNavigationRequest(req)) {
+						errorServedSinceFlush = true;
+						if (classicFailOpenTimer === null) {
+							classicFailOpenTimer = setTimeout(() => {
+								classicFailOpenTimer = null;
+								flushPending();
+							}, maxHoldMs);
+							classicFailOpenTimer.unref?.();
+						}
+					}
+					return originalEnd(...args);
+				});
+				next();
+			});
 			const _emit = srv.watcher.emit.bind(srv.watcher);
 			originalEmit = _emit;
 			const flushPending = () => {
@@ -501,6 +543,9 @@ function hmrGatePlugin(options = {}) {
 					classicFailOpenTimer = null;
 				}
 				if (pending.size > 0) noteUpdateFlush();
+				const errorServed = errorServedSinceFlush;
+				errorServedSinceFlush = false;
+				if (errorServed) srv.moduleGraph.invalidateAll();
 				const entries = Array.from(pending.entries());
 				pending.clear();
 				for (const [f] of entries) srv.moduleGraph.onFileChange(f);
@@ -513,7 +558,11 @@ function hmrGatePlugin(options = {}) {
 					}
 					if (fullReload) srv.ws.send({ type: "full-reload" });
 				}
-				return entries;
+				if (errorServed && (entries.length === 0 || !fullReload)) srv.ws.send({ type: "full-reload" });
+				return {
+					entries,
+					errorRecovery: errorServed
+				};
 			};
 			srv.watcher.emit = ((event, ...args) => {
 				if (typeof event === "string" && gatedEvents.has(event) && !isPassthrough(args[0])) {
@@ -522,7 +571,7 @@ function hmrGatePlugin(options = {}) {
 						const hash = fileContentHash(filePath);
 						if (hash !== null && hash === lastFlushedHashes.get(filePath)) {
 							pending.delete(filePath);
-							if (pending.size === 0 && classicFailOpenTimer !== null) {
+							if (pending.size === 0 && !errorServedSinceFlush && classicFailOpenTimer !== null) {
 								clearTimeout(classicFailOpenTimer);
 								classicFailOpenTimer = null;
 							}
@@ -549,11 +598,18 @@ function hmrGatePlugin(options = {}) {
 			});
 			srv.middlewares.use((req, res, next) => {
 				if (req.method !== "POST" || requestPathname(req) !== "/__hmr_flush") return next();
-				const entries = flushPending();
+				const origin = req.headers.origin;
+				if (typeof origin === "string" && !statusCorsOriginRe.test(origin)) {
+					res.writeHead(403, { "Content-Type": "application/json" });
+					res.end(JSON.stringify({ error: "origin not allowed" }));
+					return;
+				}
+				const { entries, errorRecovery } = flushPending();
 				const files = entries.map(([f]) => f);
 				const body = JSON.stringify({
 					flushed: files,
 					count: entries.length,
+					errorRecovery,
 					mode: fullReload ? "full-reload" : "granular"
 				});
 				res.writeHead(200, { "Content-Type": "application/json" });
@@ -566,7 +622,8 @@ function hmrGatePlugin(options = {}) {
 				const body = JSON.stringify({
 					enabled: true,
 					pending: serialized,
-					count: pending.size,
+					count: pending.size + (errorServedSinceFlush ? 1 : 0),
+					errorRecovery: errorServedSinceFlush,
 					mode: fullReload ? "full-reload" : "granular"
 				});
 				res.writeHead(200, gateStatusHeaders(req));
@@ -608,6 +665,7 @@ function hmrGatePlugin(options = {}) {
 			drainUntil = 0;
 			pending.clear();
 			lastFlushedHashes.clear();
+			errorServedSinceFlush = false;
 			server = null;
 			originalEmit = null;
 		}

package/dist/index.cjs

@@ -150,6 +150,186 @@ function bundledDevCssUrlShim() {
 	};
 }
 //#endregion
+//#region package.json
+var name = "@lovable.dev/vite-tanstack-config";
+var version = "2.18.0";
+//#endregion
+//#region src/logging.ts
+const PACKAGE_NAME = "@lovable.dev/vite-tanstack-config";
+function logWarning(message) {
+	console.warn(`[${PACKAGE_NAME}] ${message}`);
+}
+//#endregion
+//#region src/outputPaths.ts
+const PUBLISH_OUTPUT_DIR = "dist";
+const SERVER_OUTPUT_DIR = `${PUBLISH_OUTPUT_DIR}/server`;
+const CLIENT_OUTPUT_DIR = `${PUBLISH_OUTPUT_DIR}/client`;
+//#endregion
+//#region src/documents.ts
+const DOCUMENT_SET_VERSION = 1;
+const GENERATOR = `${name}@${version}`;
+const DOCUMENT_SET_DIR = ".lovable";
+const DOCUMENT_SET_FILE = "output.json";
+const DOCUMENT_SET_MAX_ENTRIES = 1e4;
+const DOCUMENT_SET_MAX_BYTES = 4e6;
+const DOCUMENT_SET_PLUGIN_NAME = "lovable:document-set";
+const TANSTACK_POST_BUILD_PLUGIN = "tanstack-start-core:post-build";
+const DOT_SEGMENT = /(^|\/)\.(\/|$)/;
+function hasControlChars(value) {
+	for (let i = 0; i < value.length; i++) {
+		const code = value.charCodeAt(i);
+		if (code < 32 || code === 127) return true;
+	}
+	return false;
+}
+function normalizeRoute(raw) {
+	if (typeof raw !== "string") return void 0;
+	const pathname = raw.split(/[?#]/)[0] ?? "";
+	if (!pathname.startsWith("/")) return void 0;
+	const route = pathname.replace(/\/+$/, "") || "/";
+	if (route.includes("//") || route.includes("..") || route.includes("\\") || DOT_SEGMENT.test(route) || hasControlChars(route)) return;
+	return route;
+}
+/** Upstream's `joinURL("/", router.basepath)`: leading slash, no trailing slash, "" when unset. */
+function normalizeBasePath(raw) {
+	if (typeof raw !== "string") return "";
+	const trimmed = raw.trim().replace(/\/+$/, "");
+	if (trimmed === "") return "";
+	return trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
+}
+function withoutBasePath(route, basePath) {
+	if (route === basePath) return "/";
+	if (basePath === "") return route;
+	return route.startsWith(`${basePath}/`) ? route.slice(basePath.length) : route;
+}
+function documentEntryForPage(page, basePath = "") {
+	if (typeof page.prerender?.outputPath === "string") return void 0;
+	const pagePath = normalizeRoute(page.path);
+	if (pagePath === void 0) return void 0;
+	const inner = withoutBasePath(pagePath, basePath);
+	const route = normalizeRoute(`${basePath}${inner}`);
+	if (route === void 0) return void 0;
+	const file = inner === "/" ? "index.html" : `${inner.slice(1)}/index.html`;
+	if (file !== file.trim()) return void 0;
+	return {
+		route,
+		file
+	};
+}
+function compareRoutes(a, b) {
+	if (a.route < b.route) return -1;
+	if (a.route > b.route) return 1;
+	return 0;
+}
+/** The artifact bytes, or undefined when there is nothing to publish. */
+function serializeDocumentSet(entries, generator) {
+	const sorted = [...entries].sort(compareRoutes);
+	const selected = [];
+	let cappedBy;
+	let length = JSON.stringify({
+		version: DOCUMENT_SET_VERSION,
+		generator,
+		documents: []
+	}).length;
+	for (const entry of sorted) {
+		if (selected.length === DOCUMENT_SET_MAX_ENTRIES) {
+			cappedBy = "entry limit";
+			break;
+		}
+		const added = JSON.stringify(entry).length + 1;
+		if (length + added > DOCUMENT_SET_MAX_BYTES) {
+			cappedBy = "byte limit";
+			break;
+		}
+		length += added;
+		selected.push(entry);
+	}
+	if (cappedBy !== void 0) logWarning(`Publishing only ${selected.length} of ${sorted.length} publishable routes; the document set hit its ${cappedBy}.`);
+	if (selected.length === 0) return void 0;
+	return JSON.stringify({
+		version: DOCUMENT_SET_VERSION,
+		generator,
+		documents: selected
+	});
+}
+const EXISTENCE_BATCH_SIZE = 64;
+async function whichExist(paths, access) {
+	const exists = [];
+	for (let i = 0; i < paths.length; i += EXISTENCE_BATCH_SIZE) {
+		const batch = paths.slice(i, i + EXISTENCE_BATCH_SIZE).map((path) => access(path).then(() => true, () => false));
+		exists.push(...await Promise.all(batch));
+	}
+	return exists;
+}
+function createDocumentSet(routerBasePath) {
+	const basePath = normalizeBasePath(routerBasePath);
+	const basePathServable = basePath === "" || normalizeRoute(basePath) === basePath;
+	if (!basePathServable) logWarning(`Not publishing any prerendered documents: router.basepath "${basePath}" is not a servable route.`);
+	const documents = /* @__PURE__ */ new Map();
+	let root = process.cwd();
+	let clientOutputDir = CLIENT_OUTPUT_DIR;
+	const plugin = {
+		name: DOCUMENT_SET_PLUGIN_NAME,
+		apply: "build",
+		enforce: "post",
+		configResolved(config) {
+			root = config.root;
+			const names = config.plugins?.map((candidate) => candidate.name) ?? [];
+			const theirs = names.indexOf(TANSTACK_POST_BUILD_PLUGIN);
+			const ours = names.indexOf(DOCUMENT_SET_PLUGIN_NAME);
+			if (theirs !== -1 && ours !== -1 && ours < theirs) logWarning(`Prerendered routes will fall back to SSR: ${DOCUMENT_SET_PLUGIN_NAME} is registered before ${TANSTACK_POST_BUILD_PLUGIN}, so the document set is written before the prerender pass runs.`);
+			clientOutputDir = config.environments?.client?.build?.outDir ?? CLIENT_OUTPUT_DIR;
+		},
+		buildApp: {
+			order: "post",
+			async handler() {
+				const { access, mkdir, rm, writeFile } = await import("node:fs/promises");
+				const nodePath = await import("node:path");
+				const artifact = nodePath.join(root, PUBLISH_OUTPUT_DIR, DOCUMENT_SET_DIR, DOCUMENT_SET_FILE);
+				await rm(artifact, { force: true }).catch((error) => {
+					logWarning(`Could not remove a previous build's document set: ${String(error)}`);
+				});
+				if (documents.size === 0) return;
+				const clientDir = nodePath.resolve(root, clientOutputDir);
+				const entries = [...documents].map(([route, file]) => ({
+					route,
+					file
+				}));
+				const exists = await whichExist(entries.map(({ file }) => nodePath.resolve(clientDir, file)), access);
+				const present = [];
+				for (const [index, entry] of entries.entries()) {
+					if (exists[index]) {
+						present.push(entry);
+						continue;
+					}
+					logWarning(`Not publishing prerendered route ${entry.route}: it produced no ${entry.file}.`);
+				}
+				const payload = serializeDocumentSet(present, GENERATOR);
+				if (payload === void 0) return;
+				try {
+					await mkdir(nodePath.dirname(artifact), { recursive: true });
+					await writeFile(artifact, payload);
+				} catch (error) {
+					logWarning(`Could not write the document set; prerendered routes fall back to SSR: ${String(error)}`);
+				}
+			}
+		}
+	};
+	const record = (page) => {
+		if (!basePathServable) return;
+		const entry = documentEntryForPage(page, basePath);
+		if (entry === void 0) {
+			if (typeof page.prerender?.outputPath !== "string") logWarning(`Not publishing prerendered route ${String(page.path)}: its path cannot be a document key (dot segments, "//", "..", backslashes, control characters, and leading/trailing whitespace are rejected).`);
+			return;
+		}
+		documents.set(entry.route, entry.file);
+	};
+	return {
+		record,
+		plugin
+	};
+}
+//#endregion
 //#region src/index.ts
 const SANDBOX_ENV_VAR = "DEV_SERVER__PROJECT_PATH";
 const LOVABLE_SANDBOX_ENV_VAR = "LOVABLE_SANDBOX";
@@ -163,9 +343,6 @@ const TOOL_MANAGED_WATCH_IGNORES = [
 	"**/.lovable/**",
 	"**/.tanstack/tmp/**"
 ];
-function logWarning(message) {
-	console.warn(`[@lovable.dev/vite-tanstack-config] ${message}`);
-}
 const NITRO_DEFAULT_PRESET_MIN = [
 	3,
 	0,
@@ -214,6 +391,7 @@ function pinPrerenderOptions(source, pins, label) {
 function pinPrerenderForLovableBuild(userOptions) {
 	const attempted = /* @__PURE__ */ new Set();
 	const rendered = /* @__PURE__ */ new Set();
+	const collector = createDocumentSet(userOptions.router?.basepath);
 	const userPrerender = userOptions.prerender;
 	const prerender = pinPrerenderOptions(userPrerender, ROOT_PRERENDER_PINS, "prerender");
 	const userFilter = userPrerender?.filter;
@@ -224,6 +402,7 @@ function pinPrerenderForLovableBuild(userOptions) {
 	};
 	const withRenderTracking = (userOnSuccess) => (ctx) => {
 		rendered.add(ctx.page.path);
+		collector.record(ctx.page);
 		return typeof userOnSuccess === "function" ? userOnSuccess(ctx) : void 0;
 	};
 	prerender.onSuccess = withRenderTracking(userPrerender?.onSuccess);
@@ -256,7 +435,8 @@ function pinPrerenderForLovableBuild(userOptions) {
 					logWarning(`Prerender skipped ${skipped.length} route(s) that failed to render; they fall back to SSR: ${skipped.join(", ")}`);
 				}
 			}
-		}
+		},
+		documentSet: collector.plugin
 	};
 }
 function lovableFetchBundlePreset() {
@@ -266,7 +446,7 @@ function lovableFetchBundlePreset() {
 		noExternals: true,
 		inlineDynamicImports: true,
 		output: {
-			dir: "dist",
+			dir: PUBLISH_OUTPUT_DIR,
 			serverDir: "{{ output.dir }}/server",
 			publicDir: "{{ output.dir }}/client"
 		}
@@ -516,7 +696,7 @@ function lovableBuildErrorDiagnostics() {
 	};
 }
 const NODEJS_COMPAT_DEFAULT_ON_DATE = "2026-08-04";
-const SANDBOX_WRANGLER_CONFIG_PATH = "dist/server/wrangler.json";
+const SANDBOX_WRANGLER_CONFIG_PATH = `${SERVER_OUTPUT_DIR}/wrangler.json`;
 function stripRedundantNodejsCompatFlag() {
 	let root = process.cwd();
 	return {
@@ -553,7 +733,6 @@ function stripRedundantNodejsCompatFlag() {
 }
 const NITRO_SERVER_ENTRY = "index.mjs";
 const NITRO_WRANGLER_CONFIG = "wrangler.json";
-const DEFAULT_SERVER_OUTPUT_DIR = "dist/server";
 const DEFAULT_SERVER_ENTRY_NAME = "server";
 const PRERENDER_PREVIEW_HOST = "127.0.0.1";
 const TSS_PRERENDERING_ENV = "TSS_PRERENDERING";
@@ -577,7 +756,7 @@ export default {
 }
 function prerenderPreviewShim(state) {
 	let root = process.cwd();
-	let serverOutDir = DEFAULT_SERVER_OUTPUT_DIR;
+	let serverOutDir = SERVER_OUTPUT_DIR;
 	let serverEntryName = DEFAULT_SERVER_ENTRY_NAME;
 	return {
 		name: "lovable-prerender-preview-shim",
@@ -608,7 +787,7 @@ function prerenderPreviewShim(state) {
 				if (!await exists(nodePath.join(outDir, NITRO_SERVER_ENTRY))) return;
 				const basename = nodePath.basename(serverEntryName, nodePath.extname(serverEntryName));
 				if (!basename || basename === "index") {
-					logWarning(`Cannot prerender: the server entry "${serverEntryName}" would need a shim at ${DEFAULT_SERVER_OUTPUT_DIR}/index.js, which outranks nitro's own entry when publishing. Rename the entry to anything but \`index\`.`);
+					logWarning(`Cannot prerender: the server entry "${serverEntryName}" would need a shim at ${SERVER_OUTPUT_DIR}/index.js, which outranks nitro's own entry when publishing. Rename the entry to anything but \`index\`.`);
 					return;
 				}
 				const target = nodePath.join(outDir, `${basename}.js`);
@@ -833,8 +1012,8 @@ function defineConfig(configOrOptions = {}) {
 		} }, options.tanstackStart ?? {});
 		const prerenderEnabled = prerenderIsEnabled(tanstackStartOptions);
 		if (command === "build" && isSandbox) {
-			const { startOptions, skipReporter } = pinPrerenderForLovableBuild(tanstackStartOptions);
-			internalPlugins.push(tanstackStart(startOptions), skipReporter);
+			const { startOptions, skipReporter, documentSet } = pinPrerenderForLovableBuild(tanstackStartOptions);
+			internalPlugins.push(tanstackStart(startOptions), skipReporter, documentSet);
 		} else internalPlugins.push(tanstackStart(tanstackStartOptions));
 		const explicitNitro = options.nitro === true || typeof options.nitro === "object" && options.nitro !== null;
 		if (options.nitro !== false && command === "build") {
@@ -872,9 +1051,9 @@ function defineConfig(configOrOptions = {}) {
 						delete nitroOpts.defaultPreset;
 						nitroOpts.preset = "cloudflare-module";
 						nitroOpts.output = {
-							dir: "dist",
-							serverDir: "dist/server",
-							publicDir: "dist/client"
+							dir: PUBLISH_OUTPUT_DIR,
+							serverDir: SERVER_OUTPUT_DIR,
+							publicDir: CLIENT_OUTPUT_DIR
 						};
 						nitroOpts.cloudflare = {
 							nodeCompat: true,

package/dist/index.d.cts

@@ -11,11 +11,13 @@ import { ConfigEnv, Plugin, PluginOption, UserConfig, UserConfigFn, UserConfigFn
  */
 declare function lovableAssetsProxyPlugin(): Plugin;
 //#endregion
-//#region src/index.d.ts
+//#region src/documents.d.ts
 type PrerenderPage = {
   path: string;
   prerender?: Record<string, unknown>;
 };
+//#endregion
+//#region src/index.d.ts
 declare function stripRedundantNodejsCompatFlag(): Plugin;
 interface LovableViteTanstackOptions {
   plugins?: PluginOption[];
@@ -72,4 +74,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, PrerenderPage, defineConfig, lovableAssetsProxyPlugin, stripRedundantNodejsCompatFlag };
+export { LovableViteTanstackOptions, type PrerenderPage, defineConfig, lovableAssetsProxyPlugin, stripRedundantNodejsCompatFlag };

package/dist/index.d.ts

@@ -11,11 +11,13 @@ import { ConfigEnv, Plugin, PluginOption, UserConfig, UserConfigFn, UserConfigFn
  */
 declare function lovableAssetsProxyPlugin(): Plugin;
 //#endregion
-//#region src/index.d.ts
+//#region src/documents.d.ts
 type PrerenderPage = {
   path: string;
   prerender?: Record<string, unknown>;
 };
+//#endregion
+//#region src/index.d.ts
 declare function stripRedundantNodejsCompatFlag(): Plugin;
 interface LovableViteTanstackOptions {
   plugins?: PluginOption[];
@@ -72,4 +74,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, PrerenderPage, defineConfig, lovableAssetsProxyPlugin, stripRedundantNodejsCompatFlag };
+export { LovableViteTanstackOptions, type PrerenderPage, defineConfig, lovableAssetsProxyPlugin, stripRedundantNodejsCompatFlag };

package/dist/index.js

@@ -126,6 +126,186 @@ function bundledDevCssUrlShim() {
 	};
 }
 //#endregion
+//#region package.json
+var name = "@lovable.dev/vite-tanstack-config";
+var version = "2.18.0";
+//#endregion
+//#region src/logging.ts
+const PACKAGE_NAME = "@lovable.dev/vite-tanstack-config";
+function logWarning(message) {
+	console.warn(`[${PACKAGE_NAME}] ${message}`);
+}
+//#endregion
+//#region src/outputPaths.ts
+const PUBLISH_OUTPUT_DIR = "dist";
+const SERVER_OUTPUT_DIR = `${PUBLISH_OUTPUT_DIR}/server`;
+const CLIENT_OUTPUT_DIR = `${PUBLISH_OUTPUT_DIR}/client`;
+//#endregion
+//#region src/documents.ts
+const DOCUMENT_SET_VERSION = 1;
+const GENERATOR = `${name}@${version}`;
+const DOCUMENT_SET_DIR = ".lovable";
+const DOCUMENT_SET_FILE = "output.json";
+const DOCUMENT_SET_MAX_ENTRIES = 1e4;
+const DOCUMENT_SET_MAX_BYTES = 4e6;
+const DOCUMENT_SET_PLUGIN_NAME = "lovable:document-set";
+const TANSTACK_POST_BUILD_PLUGIN = "tanstack-start-core:post-build";
+const DOT_SEGMENT = /(^|\/)\.(\/|$)/;
+function hasControlChars(value) {
+	for (let i = 0; i < value.length; i++) {
+		const code = value.charCodeAt(i);
+		if (code < 32 || code === 127) return true;
+	}
+	return false;
+}
+function normalizeRoute(raw) {
+	if (typeof raw !== "string") return void 0;
+	const pathname = raw.split(/[?#]/)[0] ?? "";
+	if (!pathname.startsWith("/")) return void 0;
+	const route = pathname.replace(/\/+$/, "") || "/";
+	if (route.includes("//") || route.includes("..") || route.includes("\\") || DOT_SEGMENT.test(route) || hasControlChars(route)) return;
+	return route;
+}
+/** Upstream's `joinURL("/", router.basepath)`: leading slash, no trailing slash, "" when unset. */
+function normalizeBasePath(raw) {
+	if (typeof raw !== "string") return "";
+	const trimmed = raw.trim().replace(/\/+$/, "");
+	if (trimmed === "") return "";
+	return trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
+}
+function withoutBasePath(route, basePath) {
+	if (route === basePath) return "/";
+	if (basePath === "") return route;
+	return route.startsWith(`${basePath}/`) ? route.slice(basePath.length) : route;
+}
+function documentEntryForPage(page, basePath = "") {
+	if (typeof page.prerender?.outputPath === "string") return void 0;
+	const pagePath = normalizeRoute(page.path);
+	if (pagePath === void 0) return void 0;
+	const inner = withoutBasePath(pagePath, basePath);
+	const route = normalizeRoute(`${basePath}${inner}`);
+	if (route === void 0) return void 0;
+	const file = inner === "/" ? "index.html" : `${inner.slice(1)}/index.html`;
+	if (file !== file.trim()) return void 0;
+	return {
+		route,
+		file
+	};
+}
+function compareRoutes(a, b) {
+	if (a.route < b.route) return -1;
+	if (a.route > b.route) return 1;
+	return 0;
+}
+/** The artifact bytes, or undefined when there is nothing to publish. */
+function serializeDocumentSet(entries, generator) {
+	const sorted = [...entries].sort(compareRoutes);
+	const selected = [];
+	let cappedBy;
+	let length = JSON.stringify({
+		version: DOCUMENT_SET_VERSION,
+		generator,
+		documents: []
+	}).length;
+	for (const entry of sorted) {
+		if (selected.length === DOCUMENT_SET_MAX_ENTRIES) {
+			cappedBy = "entry limit";
+			break;
+		}
+		const added = JSON.stringify(entry).length + 1;
+		if (length + added > DOCUMENT_SET_MAX_BYTES) {
+			cappedBy = "byte limit";
+			break;
+		}
+		length += added;
+		selected.push(entry);
+	}
+	if (cappedBy !== void 0) logWarning(`Publishing only ${selected.length} of ${sorted.length} publishable routes; the document set hit its ${cappedBy}.`);
+	if (selected.length === 0) return void 0;
+	return JSON.stringify({
+		version: DOCUMENT_SET_VERSION,
+		generator,
+		documents: selected
+	});
+}
+const EXISTENCE_BATCH_SIZE = 64;
+async function whichExist(paths, access) {
+	const exists = [];
+	for (let i = 0; i < paths.length; i += EXISTENCE_BATCH_SIZE) {
+		const batch = paths.slice(i, i + EXISTENCE_BATCH_SIZE).map((path) => access(path).then(() => true, () => false));
+		exists.push(...await Promise.all(batch));
+	}
+	return exists;
+}
+function createDocumentSet(routerBasePath) {
+	const basePath = normalizeBasePath(routerBasePath);
+	const basePathServable = basePath === "" || normalizeRoute(basePath) === basePath;
+	if (!basePathServable) logWarning(`Not publishing any prerendered documents: router.basepath "${basePath}" is not a servable route.`);
+	const documents = /* @__PURE__ */ new Map();
+	let root = process.cwd();
+	let clientOutputDir = CLIENT_OUTPUT_DIR;
+	const plugin = {
+		name: DOCUMENT_SET_PLUGIN_NAME,
+		apply: "build",
+		enforce: "post",
+		configResolved(config) {
+			root = config.root;
+			const names = config.plugins?.map((candidate) => candidate.name) ?? [];
+			const theirs = names.indexOf(TANSTACK_POST_BUILD_PLUGIN);
+			const ours = names.indexOf(DOCUMENT_SET_PLUGIN_NAME);
+			if (theirs !== -1 && ours !== -1 && ours < theirs) logWarning(`Prerendered routes will fall back to SSR: ${DOCUMENT_SET_PLUGIN_NAME} is registered before ${TANSTACK_POST_BUILD_PLUGIN}, so the document set is written before the prerender pass runs.`);
+			clientOutputDir = config.environments?.client?.build?.outDir ?? CLIENT_OUTPUT_DIR;
+		},
+		buildApp: {
+			order: "post",
+			async handler() {
+				const { access, mkdir, rm, writeFile } = await import("node:fs/promises");
+				const nodePath = await import("node:path");
+				const artifact = nodePath.join(root, PUBLISH_OUTPUT_DIR, DOCUMENT_SET_DIR, DOCUMENT_SET_FILE);
+				await rm(artifact, { force: true }).catch((error) => {
+					logWarning(`Could not remove a previous build's document set: ${String(error)}`);
+				});
+				if (documents.size === 0) return;
+				const clientDir = nodePath.resolve(root, clientOutputDir);
+				const entries = [...documents].map(([route, file]) => ({
+					route,
+					file
+				}));
+				const exists = await whichExist(entries.map(({ file }) => nodePath.resolve(clientDir, file)), access);
+				const present = [];
+				for (const [index, entry] of entries.entries()) {
+					if (exists[index]) {
+						present.push(entry);
+						continue;
+					}
+					logWarning(`Not publishing prerendered route ${entry.route}: it produced no ${entry.file}.`);
+				}
+				const payload = serializeDocumentSet(present, GENERATOR);
+				if (payload === void 0) return;
+				try {
+					await mkdir(nodePath.dirname(artifact), { recursive: true });
+					await writeFile(artifact, payload);
+				} catch (error) {
+					logWarning(`Could not write the document set; prerendered routes fall back to SSR: ${String(error)}`);
+				}
+			}
+		}
+	};
+	const record = (page) => {
+		if (!basePathServable) return;
+		const entry = documentEntryForPage(page, basePath);
+		if (entry === void 0) {
+			if (typeof page.prerender?.outputPath !== "string") logWarning(`Not publishing prerendered route ${String(page.path)}: its path cannot be a document key (dot segments, "//", "..", backslashes, control characters, and leading/trailing whitespace are rejected).`);
+			return;
+		}
+		documents.set(entry.route, entry.file);
+	};
+	return {
+		record,
+		plugin
+	};
+}
+//#endregion
 //#region src/index.ts
 const SANDBOX_ENV_VAR = "DEV_SERVER__PROJECT_PATH";
 const LOVABLE_SANDBOX_ENV_VAR = "LOVABLE_SANDBOX";
@@ -139,9 +319,6 @@ const TOOL_MANAGED_WATCH_IGNORES = [
 	"**/.lovable/**",
 	"**/.tanstack/tmp/**"
 ];
-function logWarning(message) {
-	console.warn(`[@lovable.dev/vite-tanstack-config] ${message}`);
-}
 const NITRO_DEFAULT_PRESET_MIN = [
 	3,
 	0,
@@ -190,6 +367,7 @@ function pinPrerenderOptions(source, pins, label) {
 function pinPrerenderForLovableBuild(userOptions) {
 	const attempted = /* @__PURE__ */ new Set();
 	const rendered = /* @__PURE__ */ new Set();
+	const collector = createDocumentSet(userOptions.router?.basepath);
 	const userPrerender = userOptions.prerender;
 	const prerender = pinPrerenderOptions(userPrerender, ROOT_PRERENDER_PINS, "prerender");
 	const userFilter = userPrerender?.filter;
@@ -200,6 +378,7 @@ function pinPrerenderForLovableBuild(userOptions) {
 	};
 	const withRenderTracking = (userOnSuccess) => (ctx) => {
 		rendered.add(ctx.page.path);
+		collector.record(ctx.page);
 		return typeof userOnSuccess === "function" ? userOnSuccess(ctx) : void 0;
 	};
 	prerender.onSuccess = withRenderTracking(userPrerender?.onSuccess);
@@ -232,7 +411,8 @@ function pinPrerenderForLovableBuild(userOptions) {
 					logWarning(`Prerender skipped ${skipped.length} route(s) that failed to render; they fall back to SSR: ${skipped.join(", ")}`);
 				}
 			}
-		}
+		},
+		documentSet: collector.plugin
 	};
 }
 function lovableFetchBundlePreset() {
@@ -242,7 +422,7 @@ function lovableFetchBundlePreset() {
 		noExternals: true,
 		inlineDynamicImports: true,
 		output: {
-			dir: "dist",
+			dir: PUBLISH_OUTPUT_DIR,
 			serverDir: "{{ output.dir }}/server",
 			publicDir: "{{ output.dir }}/client"
 		}
@@ -492,7 +672,7 @@ function lovableBuildErrorDiagnostics() {
 	};
 }
 const NODEJS_COMPAT_DEFAULT_ON_DATE = "2026-08-04";
-const SANDBOX_WRANGLER_CONFIG_PATH = "dist/server/wrangler.json";
+const SANDBOX_WRANGLER_CONFIG_PATH = `${SERVER_OUTPUT_DIR}/wrangler.json`;
 function stripRedundantNodejsCompatFlag() {
 	let root = process.cwd();
 	return {
@@ -529,7 +709,6 @@ function stripRedundantNodejsCompatFlag() {
 }
 const NITRO_SERVER_ENTRY = "index.mjs";
 const NITRO_WRANGLER_CONFIG = "wrangler.json";
-const DEFAULT_SERVER_OUTPUT_DIR = "dist/server";
 const DEFAULT_SERVER_ENTRY_NAME = "server";
 const PRERENDER_PREVIEW_HOST = "127.0.0.1";
 const TSS_PRERENDERING_ENV = "TSS_PRERENDERING";
@@ -553,7 +732,7 @@ export default {
 }
 function prerenderPreviewShim(state) {
 	let root = process.cwd();
-	let serverOutDir = DEFAULT_SERVER_OUTPUT_DIR;
+	let serverOutDir = SERVER_OUTPUT_DIR;
 	let serverEntryName = DEFAULT_SERVER_ENTRY_NAME;
 	return {
 		name: "lovable-prerender-preview-shim",
@@ -584,7 +763,7 @@ function prerenderPreviewShim(state) {
 				if (!await exists(nodePath.join(outDir, NITRO_SERVER_ENTRY))) return;
 				const basename = nodePath.basename(serverEntryName, nodePath.extname(serverEntryName));
 				if (!basename || basename === "index") {
-					logWarning(`Cannot prerender: the server entry "${serverEntryName}" would need a shim at ${DEFAULT_SERVER_OUTPUT_DIR}/index.js, which outranks nitro's own entry when publishing. Rename the entry to anything but \`index\`.`);
+					logWarning(`Cannot prerender: the server entry "${serverEntryName}" would need a shim at ${SERVER_OUTPUT_DIR}/index.js, which outranks nitro's own entry when publishing. Rename the entry to anything but \`index\`.`);
 					return;
 				}
 				const target = nodePath.join(outDir, `${basename}.js`);
@@ -809,8 +988,8 @@ function defineConfig(configOrOptions = {}) {
 		} }, options.tanstackStart ?? {});
 		const prerenderEnabled = prerenderIsEnabled(tanstackStartOptions);
 		if (command === "build" && isSandbox) {
-			const { startOptions, skipReporter } = pinPrerenderForLovableBuild(tanstackStartOptions);
-			internalPlugins.push(tanstackStart(startOptions), skipReporter);
+			const { startOptions, skipReporter, documentSet } = pinPrerenderForLovableBuild(tanstackStartOptions);
+			internalPlugins.push(tanstackStart(startOptions), skipReporter, documentSet);
 		} else internalPlugins.push(tanstackStart(tanstackStartOptions));
 		const explicitNitro = options.nitro === true || typeof options.nitro === "object" && options.nitro !== null;
 		if (options.nitro !== false && command === "build") {
@@ -848,9 +1027,9 @@ function defineConfig(configOrOptions = {}) {
 						delete nitroOpts.defaultPreset;
 						nitroOpts.preset = "cloudflare-module";
 						nitroOpts.output = {
-							dir: "dist",
-							serverDir: "dist/server",
-							publicDir: "dist/client"
+							dir: PUBLISH_OUTPUT_DIR,
+							serverDir: SERVER_OUTPUT_DIR,
+							publicDir: CLIENT_OUTPUT_DIR
 						};
 						nitroOpts.cloudflare = {
 							nodeCompat: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lovable.dev/vite-tanstack-config",
-  "version": "2.17.0",
+  "version": "2.18.0",
   "description": "Vite config wrapper for Lovable TanStack Start projects",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",