@lovable.dev/vite-tanstack-config 2.17.1 → 2.19.0

package/dist/index.cjs

@@ -150,6 +150,209 @@ function bundledDevCssUrlShim() {
 	};
 }
 //#endregion
+//#region package.json
+var name = "@lovable.dev/vite-tanstack-config";
+var version = "2.19.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 (basePath === "") return route;
+	if (route === basePath) return "/";
+	if (route.startsWith(`${basePath}/`)) return route.slice(basePath.length);
+	return route.startsWith(basePath) ? void 0 : 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);
+	if (inner === void 0) return void 0;
+	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;
+}
+/** How the error names the public dir, which vite lets a project point anywhere. */
+function publicDirLabel(root, publicDir, nodePath) {
+	const relative = nodePath.relative(root, publicDir);
+	return relative !== "" && !relative.startsWith("..") ? relative.split(nodePath.sep).join("/") : publicDir;
+}
+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;
+	let publicDir = "";
+	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;
+			publicDir = (config.environments?.client?.build?.copyPublicDir ?? config.build?.copyPublicDir) !== false && typeof config.publicDir === "string" ? config.publicDir : "";
+		},
+		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 collisions = [];
+				if (publicDir !== "") {
+					const candidates = [...documents].map(([route, file]) => ({
+						route,
+						file
+					}));
+					const committed = await whichExist(candidates.map(({ file }) => nodePath.join(publicDir, file)), access);
+					for (const [index, candidate] of candidates.entries()) if (committed[index]) collisions.push(candidate);
+				}
+				if (collisions.length > 0) {
+					const label = publicDirLabel(root, publicDir, nodePath);
+					const pairs = collisions.sort(compareRoutes).map(({ route, file }) => `  ${route} overwrites ${label}/${file}`);
+					throw new Error(`[${PACKAGE_NAME}] Prerendering would overwrite ${collisions.length} committed file(s) under ${label}/:\n${pairs.join("\n")}\nEach route's prerendered HTML is written into the client build after vite copies ${label}/, so every committed file above is replaced by its rendered route and never ships.\nFix each line above in one of two ways: delete or rename the ${label}/ file, or stop prerendering the route (drop it from \`pages\` in vite.config, or return false for it from \`prerender.filter\`).`);
+				}
+				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 +366,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 +414,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 +425,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 +458,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 +469,7 @@ function lovableFetchBundlePreset() {
 		noExternals: true,
 		inlineDynamicImports: true,
 		output: {
-			dir: "dist",
+			dir: PUBLISH_OUTPUT_DIR,
 			serverDir: "{{ output.dir }}/server",
 			publicDir: "{{ output.dir }}/client"
 		}
@@ -516,7 +719,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 +756,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 +779,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 +810,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 +1035,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 +1074,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,209 @@ function bundledDevCssUrlShim() {
 	};
 }
 //#endregion
+//#region package.json
+var name = "@lovable.dev/vite-tanstack-config";
+var version = "2.19.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 (basePath === "") return route;
+	if (route === basePath) return "/";
+	if (route.startsWith(`${basePath}/`)) return route.slice(basePath.length);
+	return route.startsWith(basePath) ? void 0 : 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);
+	if (inner === void 0) return void 0;
+	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;
+}
+/** How the error names the public dir, which vite lets a project point anywhere. */
+function publicDirLabel(root, publicDir, nodePath) {
+	const relative = nodePath.relative(root, publicDir);
+	return relative !== "" && !relative.startsWith("..") ? relative.split(nodePath.sep).join("/") : publicDir;
+}
+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;
+	let publicDir = "";
+	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;
+			publicDir = (config.environments?.client?.build?.copyPublicDir ?? config.build?.copyPublicDir) !== false && typeof config.publicDir === "string" ? config.publicDir : "";
+		},
+		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 collisions = [];
+				if (publicDir !== "") {
+					const candidates = [...documents].map(([route, file]) => ({
+						route,
+						file
+					}));
+					const committed = await whichExist(candidates.map(({ file }) => nodePath.join(publicDir, file)), access);
+					for (const [index, candidate] of candidates.entries()) if (committed[index]) collisions.push(candidate);
+				}
+				if (collisions.length > 0) {
+					const label = publicDirLabel(root, publicDir, nodePath);
+					const pairs = collisions.sort(compareRoutes).map(({ route, file }) => `  ${route} overwrites ${label}/${file}`);
+					throw new Error(`[${PACKAGE_NAME}] Prerendering would overwrite ${collisions.length} committed file(s) under ${label}/:\n${pairs.join("\n")}\nEach route's prerendered HTML is written into the client build after vite copies ${label}/, so every committed file above is replaced by its rendered route and never ships.\nFix each line above in one of two ways: delete or rename the ${label}/ file, or stop prerendering the route (drop it from \`pages\` in vite.config, or return false for it from \`prerender.filter\`).`);
+				}
+				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 +342,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 +390,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 +401,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 +434,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 +445,7 @@ function lovableFetchBundlePreset() {
 		noExternals: true,
 		inlineDynamicImports: true,
 		output: {
-			dir: "dist",
+			dir: PUBLISH_OUTPUT_DIR,
 			serverDir: "{{ output.dir }}/server",
 			publicDir: "{{ output.dir }}/client"
 		}
@@ -492,7 +695,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 +732,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 +755,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 +786,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 +1011,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 +1050,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.1",
+  "version": "2.19.0",
   "description": "Vite config wrapper for Lovable TanStack Start projects",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",