@pagesmith/core 0.2.0 → 0.4.0

package/dist/vite/index.mjs

@@ -1,9 +1,9 @@
-import "../markdown-Cj5X26FL.mjs";
-import { s as toSlug, t as createContentLayer } from "../content-layer-DWdgdBeI.mjs";
-import { n as resolveLoader } from "../loaders-Bla48ZN9.mjs";
-import { n as copyPublicFiles } from "../assets-bX08zEJm.mjs";
-import { basename, dirname, extname, join, relative, resolve } from "path";
+import "../markdown-BmDJgYeB.mjs";
+import { l as toSlug, t as createContentLayer } from "../content-layer-B5enqWeJ.mjs";
+import { r as resolveLoader } from "../loaders-Cf-BXf2L.mjs";
+import { i as copyPublicFiles, n as collectContentAssets, t as CONTENT_ASSET_EXTS } from "../assets-CAPOqQ_P.mjs";
 import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "fs";
+import { basename, dirname, extname, join, relative, resolve } from "path";
 import { fileURLToPath, pathToFileURL } from "url";
 import { uneval } from "devalue";
 //#region src/vite/ssg.ts
@@ -105,27 +105,16 @@ function sharedAssetsPlugin() {
 	};
 }
 //#endregion
-//#region src/vite/ssg-plugin.ts
+//#region src/vite/ssg-render.ts
 /**
-* Vite plugin for static site generation with @pagesmith/core.
-*
-* Handles both development (on-the-fly SSR via middleware) and
-* production (post-build SSG + pagefind indexing).
-*
-* The SSR entry module must export:
-* - `getRoutes(config)` — returns route paths to pre-render
-* - `render(url, config)` — renders a route to an HTML string
+* Route collection, pre-rendering, and content asset handling for the SSG plugin.
 *
-* @example
-* ```ts
-* // vite.config.ts
-* import { pagesmithSsg } from '@pagesmith/core/vite'
-*
-* export default defineConfig({
-*   base: '/my-site/',
-*   plugins: [pagesmithSsg({ entry: './src/entry-server.tsx' })],
-* })
-* ```
+* Provides:
+* - Content companion asset discovery and copying
+* - HTML asset reference rewriting
+* - SSR bundle building via child process
+* - Route pre-rendering to static HTML files
+* - Font and public file copying
 */
 const MIME = {
 	".html": "text/html; charset=utf-8",
@@ -146,16 +135,6 @@ const MIME = {
 	".txt": "text/plain; charset=utf-8",
 	".xml": "application/xml; charset=utf-8"
 };
-const CONTENT_ASSET_EXTS = new Set([
-	".svg",
-	".png",
-	".jpg",
-	".jpeg",
-	".gif",
-	".webp",
-	".avif",
-	".ico"
-]);
 function resolveContentDirs(projectRoot, contentDirs = []) {
 	return contentDirs.map((dir) => resolve(projectRoot, dir));
 }
@@ -166,39 +145,259 @@ function isAssetReference(ref) {
 }
 function rewriteContentAssetRefs(html, base) {
 	const basePrefix = base.replace(/\/+$/u, "");
-	return html.replace(/(src|href|srcset)="([^"]+)"/g, (match, attr, ref) => {
+	return html.replace(/(src|href|srcset)=(?:"([^"]+)"|'([^']+)')/g, (match, attr, doubleRef, singleRef) => {
+		const ref = doubleRef ?? singleRef ?? "";
 		if (!isAssetReference(ref)) return match;
 		const pathname = ref.split(/[?#]/u, 1)[0] ?? ref;
 		const suffix = ref.slice(pathname.length);
-		return `${attr}="${basePrefix}/assets/${pathname.split("/").pop() ?? pathname}${suffix}"`;
+		const quote = doubleRef !== void 0 ? "\"" : "'";
+		return `${attr}=${quote}${basePrefix}/assets/${pathname.split("/").pop() ?? pathname}${suffix}${quote}`;
 	});
 }
-function collectContentAssets(contentDirs) {
-	const assets = /* @__PURE__ */ new Map();
-	function walk(dir) {
-		if (!existsSync(dir)) return;
-		for (const entry of readdirSync(dir, { withFileTypes: true })) {
-			if (entry.name.startsWith(".")) continue;
-			const fullPath = join(dir, entry.name);
-			if (entry.isDirectory()) {
-				walk(fullPath);
-				continue;
-			}
-			const ext = extname(entry.name).toLowerCase();
-			if (!CONTENT_ASSET_EXTS.has(ext)) continue;
-			if (assets.has(entry.name) && assets.get(entry.name) !== fullPath) console.warn(`pagesmith:ssg duplicate companion asset basename "${entry.name}" detected; using ${fullPath}`);
-			assets.set(entry.name, fullPath);
-		}
-	}
-	for (const dir of contentDirs) walk(dir);
-	return assets;
-}
 function copyContentAssetsToOutDir(outDir, assets) {
 	if (assets.size === 0) return;
 	const assetsDir = join(outDir, "assets");
 	mkdirSync(assetsDir, { recursive: true });
 	for (const [fileName, sourcePath] of assets) copyFileSync(sourcePath, join(assetsDir, fileName));
 }
+/**
+* Run the full SSG build: SSR bundle, route pre-rendering, asset copying.
+*
+* Returns the number of pages rendered.
+*/
+async function renderStaticSite(context) {
+	const { config, projectRoot, base, outDir, contentDirs, entry } = context;
+	console.log("\nSSG: Starting static site generation...");
+	const contentAssets = collectContentAssets(contentDirs);
+	copyFontAssets(outDir);
+	copyPublicFiles(join(projectRoot, "public"), outDir);
+	const { cssPath, jsPath } = discoverBuiltAssets(outDir, base);
+	console.log("SSG: Building SSR bundle...");
+	await buildSsrBundle(config, projectRoot, outDir, entry);
+	const entryBaseName = basename(entry).replace(/\.(c|m)?[jt]sx?$/u, ".js");
+	const serverDir = join(outDir, ".server");
+	const ssrMod = await import(pathToFileURL(join(serverDir, entryBaseName)).href);
+	const renderConfig = {
+		base,
+		root: projectRoot,
+		cssPath,
+		jsPath,
+		searchEnabled: true,
+		isDev: false
+	};
+	const routes = await ssrMod.getRoutes(renderConfig);
+	console.log(`SSG: Rendering ${routes.length} pages...`);
+	const concurrency = Math.min(routes.length, 8);
+	let routeIndex = 0;
+	async function renderWorker() {
+		while (routeIndex < routes.length) {
+			const route = routes[routeIndex++];
+			const html = rewriteContentAssetRefs(await ssrMod.render(route, renderConfig), base);
+			const outputPath = join(outDir, route === "/" ? "" : route.replace(/^\//, ""), "index.html");
+			mkdirSync(dirname(outputPath), { recursive: true });
+			writeFileSync(outputPath, `<!DOCTYPE html>\n${html}`);
+			if (route === "/404") writeFileSync(join(outDir, "404.html"), `<!DOCTYPE html>\n${html}`);
+		}
+	}
+	const workers = Array.from({ length: concurrency }, () => renderWorker());
+	await Promise.all(workers);
+	copyContentAssetsToOutDir(outDir, contentAssets);
+	rmSync(serverDir, {
+		recursive: true,
+		force: true
+	});
+	return routes.length;
+}
+function copyFontAssets(outDir) {
+	const corePkgDir = dirname(fileURLToPath(import.meta.resolve("@pagesmith/core/package.json")));
+	const coreFontsDir = join(corePkgDir, "assets", "fonts");
+	const outFontsDir = join(outDir, "assets", "fonts");
+	mkdirSync(outFontsDir, { recursive: true });
+	for (const file of readdirSync(coreFontsDir)) if (file.endsWith(".woff2")) copyFileSync(join(coreFontsDir, file), join(outFontsDir, file));
+	copyFileSync(join(corePkgDir, "assets", "fonts.css"), join(outDir, "assets", "fonts.css"));
+}
+function discoverBuiltAssets(outDir, base) {
+	const builtIndex = join(outDir, "index.html");
+	let cssPath = `${base}/assets/style.css`;
+	let jsPath;
+	if (existsSync(builtIndex)) {
+		const html = readFileSync(builtIndex, "utf-8");
+		const cssMatch = html.match(/href="([^"]*\.css)"/);
+		const jsMatch = html.match(/src="([^"]*\.js)"/);
+		if (cssMatch) cssPath = cssMatch[1];
+		if (jsMatch) jsPath = jsMatch[1];
+	}
+	return {
+		cssPath,
+		jsPath
+	};
+}
+async function buildSsrBundle(config, projectRoot, outDir, entry) {
+	const { execFileSync } = await import("child_process");
+	const serverDir = join(outDir, ".server");
+	const ssrEntry = resolve(projectRoot, entry);
+	const buildScript = `
+    import { build } from 'vite';
+    await build({
+      root: ${JSON.stringify(projectRoot)},
+      logLevel: 'warn',
+      mode: ${JSON.stringify(config.mode)},
+      build: {
+        ssr: ${JSON.stringify(ssrEntry)},
+        outDir: ${JSON.stringify(serverDir)},
+        emptyOutDir: true,
+      },
+    });
+  `;
+	execFileSync(process.execPath, [
+		"--input-type=module",
+		"-e",
+		buildScript
+	], {
+		stdio: "inherit",
+		cwd: projectRoot
+	});
+}
+//#endregion
+//#region src/vite/ssg-hmr.ts
+/**
+* Dev-server middleware for the SSG plugin.
+*
+* Handles on-the-fly SSR rendering during development, including:
+* - Content companion asset serving from content directories
+* - HTML navigation request handling via server-side rendering
+* - Vite HMR client injection for live reload
+*/
+/**
+* Configure the Vite dev server with SSR middleware for on-the-fly rendering.
+*
+* Sets up:
+* - File watcher for content companion assets
+* - Middleware for serving companion assets from `/assets/` paths
+* - Middleware for SSR-rendering HTML navigation requests
+*/
+function configureSsgDevServer(server, context) {
+	const { projectRoot, base, contentDirs, entry } = context;
+	let contentAssets = /* @__PURE__ */ new Map();
+	async function refreshContentArtifacts() {
+		contentAssets = collectContentAssets(contentDirs);
+	}
+	refreshContentArtifacts().catch((error) => {
+		console.warn(`pagesmith:ssg failed to prepare companion assets: ${error instanceof Error ? error.message : String(error)}`);
+	});
+	if (contentDirs.length > 0) {
+		server.watcher.add(contentDirs);
+		const refresh = () => {
+			refreshContentArtifacts().catch((error) => {
+				console.warn(`pagesmith:ssg failed to refresh companion assets: ${error instanceof Error ? error.message : String(error)}`);
+			});
+		};
+		server.watcher.on("add", refresh);
+		server.watcher.on("change", refresh);
+		server.watcher.on("unlink", refresh);
+	}
+	server.middlewares.use(async (req, res, next) => {
+		const url = req.url ?? "/";
+		const pathname = url.split(/[?#]/u, 1)[0] ?? url;
+		if (pathname.includes("/assets/")) {
+			const assetName = pathname.split("/assets/").pop();
+			const assetPath = assetName ? contentAssets.get(assetName) : void 0;
+			if (assetPath) {
+				const ext = extname(assetPath).toLowerCase();
+				res.writeHead(200, {
+					"Content-Type": MIME[ext] ?? "application/octet-stream",
+					"Cache-Control": "no-cache"
+				});
+				res.end(readFileSync(assetPath));
+				return;
+			}
+		}
+		const accept = req.headers.accept ?? "";
+		const pathExt = extname(pathname);
+		if (pathExt && pathExt !== ".html") return next();
+		if (!pathExt && !accept.includes("text/html")) return next();
+		if (base && (url === "/" || url === "")) {
+			res.writeHead(302, { Location: `${base}/` });
+			res.end();
+			return;
+		}
+		if (base && !url.startsWith(base)) return next();
+		try {
+			const renderFn = (await server.ssrLoadModule(resolve(projectRoot, entry))).render;
+			if (typeof renderFn !== "function") return next();
+			let html = await renderFn(url, {
+				base,
+				root: projectRoot,
+				cssPath: `${base}/src/theme.css`,
+				jsPath: void 0,
+				searchEnabled: false,
+				isDev: true
+			});
+			html = rewriteContentAssetRefs(html, base);
+			html = html.replace("</head>", `<script type="module" src="/@vite/client"><\/script>\n<link rel="stylesheet" href="${base}/src/theme.css">\n</head>`);
+			html = await server.transformIndexHtml(url, html);
+			const status = html.includes("doc-not-found") ? 404 : 200;
+			res.writeHead(status, { "Content-Type": "text/html; charset=utf-8" });
+			res.end(html);
+		} catch (err) {
+			server.ssrFixStacktrace(err);
+			console.error(`SSR error for ${url}:`, err instanceof Error ? err.message : String(err));
+			next(err);
+		}
+	});
+}
+//#endregion
+//#region src/vite/ssg-pagefind.ts
+/**
+* Pagefind search indexing for the SSG plugin.
+*
+* Runs the Pagefind CLI to index the generated static site output,
+* producing the search index used by the docs theme.
+*/
+/**
+* Run Pagefind indexing on the built site output directory.
+*
+* Resolves the Pagefind binary from the installed package and invokes it
+* via a child process. Logs a warning and continues if Pagefind is not
+* installed.
+*/
+async function runPagefindIndexing(outDir) {
+	console.log("SSG: Indexing with Pagefind...");
+	try {
+		const pagefindBin = join(dirname(fileURLToPath(import.meta.resolve("pagefind"))), "..", "lib", "runner", "bin.cjs");
+		const { execFileSync } = await import("child_process");
+		execFileSync(process.execPath, [
+			pagefindBin,
+			"--site",
+			outDir
+		], { stdio: "inherit" });
+	} catch {
+		console.warn("SSG: Pagefind not found, skipping search indexing");
+	}
+}
+//#endregion
+//#region src/vite/ssg-plugin.ts
+/**
+* Vite plugin for static site generation with @pagesmith/core.
+*
+* Handles both development (on-the-fly SSR via middleware) and
+* production (post-build SSG + pagefind indexing).
+*
+* The SSR entry module must export:
+* - `getRoutes(config)` — returns route paths to pre-render
+* - `render(url, config)` — renders a route to an HTML string
+*
+* @example
+* ```ts
+* // vite.config.ts
+* import { pagesmithSsg } from '@pagesmith/core/vite'
+*
+* export default defineConfig({
+*   base: '/my-site/',
+*   plugins: [pagesmithSsg({ entry: './src/entry-server.tsx' })],
+* })
+* ```
+*/
 function pagesmithSsg(options) {
 	const enablePagefind = options.pagefind !== false;
 	let config;
@@ -206,7 +405,6 @@ function pagesmithSsg(options) {
 	let base;
 	let outDir;
 	let contentDirs = [];
-	let contentAssets = /* @__PURE__ */ new Map();
 	return [{
 		name: "pagesmith:ssg-dev",
 		apply: "serve",
@@ -221,68 +419,11 @@ function pagesmithSsg(options) {
 			contentDirs = resolveContentDirs(projectRoot, options.contentDirs);
 		},
 		configureServer(server) {
-			async function refreshContentArtifacts() {
-				contentAssets = collectContentAssets(contentDirs);
-			}
-			refreshContentArtifacts().catch((error) => {
-				console.warn(`pagesmith:ssg failed to prepare companion assets: ${error instanceof Error ? error.message : String(error)}`);
-			});
-			if (contentDirs.length > 0) {
-				server.watcher.add(contentDirs);
-				const refresh = () => {
-					refreshContentArtifacts().catch((error) => {
-						console.warn(`pagesmith:ssg failed to refresh companion assets: ${error instanceof Error ? error.message : String(error)}`);
-					});
-				};
-				server.watcher.on("add", refresh);
-				server.watcher.on("change", refresh);
-				server.watcher.on("unlink", refresh);
-			}
-			server.middlewares.use(async (req, res, next) => {
-				const url = req.url ?? "/";
-				const pathname = url.split(/[?#]/u, 1)[0] ?? url;
-				if (pathname.includes("/assets/")) {
-					const assetName = pathname.split("/assets/").pop();
-					const assetPath = assetName ? contentAssets.get(assetName) : void 0;
-					if (assetPath) {
-						const ext = extname(assetPath).toLowerCase();
-						res.writeHead(200, {
-							"Content-Type": MIME[ext] ?? "application/octet-stream",
-							"Cache-Control": "no-cache"
-						});
-						res.end(readFileSync(assetPath));
-						return;
-					}
-				}
-				if (!(req.headers.accept ?? "").includes("text/html")) return next();
-				if (base && (url === "/" || url === "")) {
-					res.writeHead(302, { Location: `${base}/` });
-					res.end();
-					return;
-				}
-				if (base && !url.startsWith(base)) return next();
-				try {
-					const renderFn = (await server.ssrLoadModule(resolve(projectRoot, options.entry))).render;
-					if (typeof renderFn !== "function") return next();
-					let html = await renderFn(url, {
-						base,
-						root: projectRoot,
-						cssPath: `${base}/src/theme.css`,
-						jsPath: void 0,
-						searchEnabled: false,
-						isDev: true
-					});
-					html = rewriteContentAssetRefs(html, base);
-					html = html.replace("</head>", `<script type="module" src="/@vite/client"><\/script>\n<link rel="stylesheet" href="${base}/src/theme.css">\n</head>`);
-					html = await server.transformIndexHtml(url, html);
-					const status = html.includes("doc-not-found") ? 404 : 200;
-					res.writeHead(status, { "Content-Type": "text/html; charset=utf-8" });
-					res.end(html);
-				} catch (err) {
-					server.ssrFixStacktrace(err);
-					console.error(`SSR error for ${url}:`, err.message);
-					next(err);
-				}
+			configureSsgDevServer(server, {
+				projectRoot,
+				base,
+				contentDirs,
+				entry: options.entry
 			});
 		}
 	}, {
@@ -297,123 +438,27 @@ function pagesmithSsg(options) {
 		},
 		async closeBundle() {
 			if (config.build.ssr) return;
-			console.log("\nSSG: Starting static site generation...");
-			contentAssets = collectContentAssets(contentDirs);
-			const corePkgDir = dirname(fileURLToPath(import.meta.resolve("@pagesmith/core/package.json")));
-			const coreFontsDir = join(corePkgDir, "assets", "fonts");
-			const outFontsDir = join(outDir, "assets", "fonts");
-			mkdirSync(outFontsDir, { recursive: true });
-			for (const file of readdirSync(coreFontsDir)) if (file.endsWith(".woff2")) copyFileSync(join(coreFontsDir, file), join(outFontsDir, file));
-			copyFileSync(join(corePkgDir, "assets", "fonts.css"), join(outDir, "assets", "fonts.css"));
-			copyPublicFiles(join(projectRoot, "public"), outDir);
-			const builtIndex = join(outDir, "index.html");
-			let cssPath = `${base}/assets/style.css`;
-			let jsPath;
-			if (existsSync(builtIndex)) {
-				const html = readFileSync(builtIndex, "utf-8");
-				const cssMatch = html.match(/href="([^"]*\.css)"/);
-				const jsMatch = html.match(/src="([^"]*\.js)"/);
-				if (cssMatch) cssPath = cssMatch[1];
-				if (jsMatch) jsPath = jsMatch[1];
-			}
-			console.log("SSG: Building SSR bundle...");
-			const { execFileSync } = await import("child_process");
-			const serverDir = join(outDir, ".server");
-			const ssrEntry = resolve(projectRoot, options.entry);
-			const buildScript = `
-        import { build } from 'vite-plus';
-        await build({
-          root: ${JSON.stringify(projectRoot)},
-          logLevel: 'warn',
-          mode: ${JSON.stringify(config.mode)},
-          build: {
-            ssr: ${JSON.stringify(ssrEntry)},
-            outDir: ${JSON.stringify(serverDir)},
-            emptyOutDir: true,
-          },
-        });
-      `;
-			execFileSync(process.execPath, [
-				"--input-type=module",
-				"-e",
-				buildScript
-			], {
-				stdio: "inherit",
-				cwd: projectRoot
-			});
-			const ssrMod = await import(pathToFileURL(join(serverDir, basename(options.entry).replace(/\.(c|m)?[jt]sx?$/u, ".js"))).href);
-			const renderConfig = {
+			const pageCount = await renderStaticSite({
+				config,
+				projectRoot,
 				base,
-				root: projectRoot,
-				cssPath,
-				jsPath,
-				searchEnabled: true,
-				isDev: false
-			};
-			const routes = await ssrMod.getRoutes(renderConfig);
-			console.log(`SSG: Rendering ${routes.length} pages...`);
-			for (const route of routes) {
-				const html = rewriteContentAssetRefs(await ssrMod.render(route, renderConfig), base);
-				const routePath = route === "/" ? "" : route.replace(/^\//, "");
-				const outputPath = join(outDir, routePath, "index.html");
-				mkdirSync(dirname(outputPath), { recursive: true });
-				writeFileSync(outputPath, `<!DOCTYPE html>\n${html}`);
-				if (route === "/404") writeFileSync(join(outDir, "404.html"), `<!DOCTYPE html>\n${html}`);
-			}
-			copyContentAssetsToOutDir(outDir, contentAssets);
-			rmSync(serverDir, {
-				recursive: true,
-				force: true
+				outDir,
+				contentDirs,
+				entry: options.entry
 			});
-			if (enablePagefind) {
-				console.log("SSG: Indexing with Pagefind...");
-				try {
-					const pagefindBin = join(dirname(fileURLToPath(import.meta.resolve("pagefind"))), "..", "lib", "runner", "bin.cjs");
-					const { execFileSync } = await import("child_process");
-					execFileSync(process.execPath, [
-						pagefindBin,
-						"--site",
-						outDir
-					], { stdio: "inherit" });
-				} catch {
-					console.warn("SSG: Pagefind not found, skipping search indexing");
-				}
-			}
-			console.log(`SSG: Done — ${routes.length} pages generated`);
+			if (enablePagefind) await runPagefindIndexing(outDir);
+			console.log(`SSG: Done — ${pageCount} pages generated`);
 		}
 	}];
 }
 //#endregion
-//#region src/vite/index.ts
-const DEFAULT_MODULE_ID = "virtual:content";
+//#region src/vite/dts.ts
 function stripExtension(filePath) {
 	return filePath.replace(/\.(c|m)?[jt]sx?$/u, "");
 }
-function normalizePath(value) {
+function normalizePath$1(value) {
 	return value.replace(/\\/g, "/");
 }
-function isPathWithin(parent, candidate) {
-	const rel = normalizePath(relative(parent, candidate));
-	return rel === "" || !rel.startsWith("..") && !rel.startsWith("/");
-}
-function commonDirectory(paths) {
-	const normalized = paths.map((path) => normalizePath(resolve(path)));
-	if (normalized.length === 0) return process.cwd();
-	if (normalized.length === 1) return normalized[0];
-	const segments = normalized.map((path) => path.split("/").filter(Boolean));
-	const shared = [];
-	const first = segments[0];
-	for (let index = 0; index < first.length; index += 1) {
-		const segment = first[index];
-		if (segments.every((parts) => parts[index] === segment)) {
-			shared.push(segment);
-			continue;
-		}
-		break;
-	}
-	if (shared.length === 0) return resolve("/");
-	return resolve(`/${shared.join("/")}`);
-}
 function resolveDtsPath(projectRoot, dts) {
 	if (dts === false) return "";
 	if (typeof dts === "string") return resolve(projectRoot, dts);
@@ -424,7 +469,7 @@ function resolveDtsPath(projectRoot, dts) {
 }
 function createDtsSource(moduleId, collectionNames, dtsPath, configPath) {
 	return `// Generated by @pagesmith/core/vite. Do not edit manually.
-type __PagesmithCollections = typeof import('${normalizePath(stripExtension(relative(dirname(dtsPath), configPath)).replace(/^[^.]/u, "./$&"))}').default
+type __PagesmithCollections = typeof import('${normalizePath$1(stripExtension(relative(dirname(dtsPath), configPath)).replace(/^[^.]/u, "./$&"))}').default
 
 declare module '${moduleId}' {
   const content: import('@pagesmith/core/vite').ContentModuleMap<__PagesmithCollections>
@@ -439,6 +484,34 @@ ${collectionNames.map((name) => `declare module '${moduleId}/${name}' {
 }`).join("\n\n")}
 `;
 }
+//#endregion
+//#region src/vite/content-plugin.ts
+const DEFAULT_MODULE_ID = "virtual:content";
+function normalizePath(value) {
+	return value.replace(/\\/g, "/");
+}
+function isPathWithin(parent, candidate) {
+	const rel = normalizePath(relative(parent, candidate));
+	return rel === "" || !rel.startsWith("..") && !rel.startsWith("/");
+}
+function commonDirectory(paths) {
+	const normalized = paths.map((path) => normalizePath(resolve(path)));
+	if (normalized.length === 0) return process.cwd();
+	if (normalized.length === 1) return normalized[0];
+	const segments = normalized.map((path) => path.split("/").filter(Boolean));
+	const shared = [];
+	const first = segments[0];
+	for (let index = 0; index < first.length; index += 1) {
+		const segment = first[index];
+		if (segments.every((parts) => parts[index] === segment)) {
+			shared.push(segment);
+			continue;
+		}
+		break;
+	}
+	if (shared.length === 0) return resolve("/");
+	return resolve(`/${shared.join("/")}`);
+}
 async function serializeCollection(layer, collectionName, collectionDef, contentRoot) {
 	const entries = await layer.getCollection(collectionName);
 	const loader = resolveLoader(collectionDef.loader);
@@ -539,7 +612,9 @@ function pagesmithContent(collectionsOrOptions, maybeOptions = {}) {
 			if (touchesContent) for (const name of affectedCollections) {
 				const moduleNode = server.moduleGraph.getModuleById(`${resolvedPrefix}${name}`);
 				if (moduleNode) server.moduleGraph.invalidateModule(moduleNode);
-				getLayer().invalidateCollection(name);
+				getLayer().invalidateCollection(name).catch((err) => {
+					console.warn(`[pagesmith] Failed to invalidate collection "${name}":`, err);
+				});
 			}
 			else {
 				for (const name of collectionNames) {