@ox-content/vite-plugin 0.14.0 → 0.16.0

package/dist/index.cjs

@@ -7381,6 +7381,7 @@ export const ${exportName}: NavItem[] = ${JSON.stringify(navItems, null, 2)} as
 * await writeDocs(markdown, './docs/api', extracted, docsOptions);
 * ```
 */
+const DOCS_MANIFEST_FILE = ".ox-content-docs-manifest.json";
 /**
 * Regex pattern for matching JSDoc comment blocks.
 *
@@ -7897,6 +7898,19 @@ function buildSymbolMap(docs) {
 */
 async function writeDocs(docs, outDir, extractedDocs, options) {
 	await fs.promises.mkdir(outDir, { recursive: true });
+	const generatedFiles = new Set(Object.keys(docs));
+	if (extractedDocs && options?.generateNav && options.groupBy === "file") generatedFiles.add("nav.ts");
+	const manifestPath = path$1.join(outDir, DOCS_MANIFEST_FILE);
+	let previousFiles = [];
+	try {
+		previousFiles = JSON.parse(await fs.promises.readFile(manifestPath, "utf-8"));
+	} catch {
+		previousFiles = [];
+	}
+	for (const staleFile of previousFiles) {
+		if (generatedFiles.has(staleFile)) continue;
+		await fs.promises.rm(path$1.join(outDir, staleFile), { force: true });
+	}
 	for (const [fileName, content] of Object.entries(docs)) {
 		const filePath = path$1.join(outDir, fileName);
 		await fs.promises.writeFile(filePath, content, "utf-8");
@@ -7906,6 +7920,7 @@ async function writeDocs(docs, outDir, extractedDocs, options) {
 		const navFilePath = path$1.join(outDir, "nav.ts");
 		await fs.promises.writeFile(navFilePath, navCode, "utf-8");
 	}
+	await fs.promises.writeFile(manifestPath, JSON.stringify([...generatedFiles].sort(), null, 2), "utf-8");
 }
 /**
 * Resolves docs options with defaults.
@@ -10498,7 +10513,7 @@ async function resolveMarkdownFile(url, srcDir) {
 * Inject Vite HMR client script into the HTML.
 */
 function injectViteHmrClient(html) {
-	return html.replace("</head>", "<script type=\"module\" src=\"/@vite/client\"><\/script>\n<script type=\"module\">\nif (import.meta.hot) {\n  import.meta.hot.on('ox-content:update', () => {\n    location.reload();\n  });\n}\n<\/script>\n</head>");
+	return html.replace("</head>", "<script type=\"module\" src=\"/@vite/client\"><\/script>\n<script type=\"module\">\nif (import.meta.hot) {\n  const reexecuteBodyScripts = () => {\n    const scripts = Array.from(document.body.querySelectorAll('script'));\n    for (const script of scripts) {\n      const nextScript = document.createElement('script');\n      for (const attr of script.attributes) {\n        nextScript.setAttribute(attr.name, attr.value);\n      }\n      nextScript.textContent = script.textContent;\n      script.replaceWith(nextScript);\n    }\n  };\n\n  const applyHotUpdate = async () => {\n    const nextUrl = new URL(window.location.href);\n    nextUrl.searchParams.set('__ox_hmr', String(Date.now()));\n\n    const scrollX = window.scrollX;\n    const scrollY = window.scrollY;\n    const theme = document.documentElement.getAttribute('data-theme');\n\n    const response = await fetch(nextUrl.toString(), {\n      cache: 'no-store',\n      headers: {\n        'x-ox-content-hmr': '1',\n      },\n    });\n\n    if (!response.ok) {\n      throw new Error('Failed to fetch updated page');\n    }\n\n    const nextHtml = await response.text();\n    const nextDocument = new DOMParser().parseFromString(nextHtml, 'text/html');\n\n    if (!nextDocument.body) {\n      throw new Error('Updated page is missing a body');\n    }\n\n    document.title = nextDocument.title;\n    document.body.innerHTML = nextDocument.body.innerHTML;\n    reexecuteBodyScripts();\n\n    if (theme) {\n      document.documentElement.setAttribute('data-theme', theme);\n    }\n\n    window.scrollTo({ left: scrollX, top: scrollY });\n  };\n\n  let pendingUpdate = Promise.resolve();\n\n  import.meta.hot.on('ox-content:update', () => {\n    pendingUpdate = pendingUpdate\n      .then(() => applyHotUpdate())\n      .catch((error) => {\n        console.warn('[ox-content] HMR patch failed, falling back to reload.', error);\n        location.reload();\n      });\n  });\n}\n<\/script>\n</head>");
 }
 /**
 * Create a dev server cache instance.
@@ -11779,6 +11794,16 @@ init_page_context();
 function oxContent(options = {}) {
 	const resolvedOptions = resolveOptions(options);
 	let config;
+	async function regenerateDocs(root) {
+		const docsOptions = resolvedOptions.docs;
+		if (!docsOptions || !docsOptions.enabled) return 0;
+		const srcDirs = docsOptions.src.map((src) => path$1.resolve(root, src));
+		const outDir = path$1.resolve(root, docsOptions.out);
+		const extracted = await extractDocs(srcDirs, docsOptions);
+		const generated = generateMarkdown(extracted, docsOptions);
+		await writeDocs(generated, outDir, extracted, docsOptions);
+		return Object.keys(generated).length;
+	}
 	const mainPlugin = {
 		name: "ox-content",
 		configResolved(resolvedConfig) {
@@ -11831,15 +11856,9 @@ function oxContent(options = {}) {
 			const docsOptions = resolvedOptions.docs;
 			if (!docsOptions || !docsOptions.enabled) return;
 			const root = config?.root || process.cwd();
-			const srcDirs = docsOptions.src.map((src) => path$1.resolve(root, src));
-			const outDir = path$1.resolve(root, docsOptions.out);
 			try {
-				const extracted = await extractDocs(srcDirs, docsOptions);
-				if (extracted.length > 0) {
-					const generated = generateMarkdown(extracted, docsOptions);
-					await writeDocs(generated, outDir, extracted, docsOptions);
-					console.log(`[ox-content] Generated ${Object.keys(generated).length} documentation files to ${docsOptions.out}`);
-				}
+				const count = await regenerateDocs(root);
+				console.log(`[ox-content] Generated ${count} documentation files to ${docsOptions.out}`);
 			} catch (err) {
 				console.warn("[ox-content] Failed to generate documentation:", err);
 			}
@@ -11850,14 +11869,11 @@ function oxContent(options = {}) {
 			const root = config?.root || process.cwd();
 			const srcDirs = docsOptions.src.map((src) => path$1.resolve(root, src));
 			for (const srcDir of srcDirs) devServer.watcher.add(srcDir);
-			devServer.watcher.on("change", async (file) => {
-				if (srcDirs.some((srcDir) => file.startsWith(srcDir) && (file.endsWith(".ts") || file.endsWith(".tsx")))) {
-					const outDir = path$1.resolve(root, docsOptions.out);
-					try {
-						const extracted = await extractDocs(srcDirs, docsOptions);
-						if (extracted.length > 0) await writeDocs(generateMarkdown(extracted, docsOptions), outDir, extracted, docsOptions);
-					} catch {}
-				}
+			devServer.watcher.on("all", async (event, file) => {
+				if (event !== "add" && event !== "change" && event !== "unlink") return;
+				if (srcDirs.some((srcDir) => file.startsWith(srcDir) && (file.endsWith(".ts") || file.endsWith(".tsx")))) try {
+					await regenerateDocs(root);
+				} catch {}
 			});
 		}
 	};
@@ -11870,10 +11886,30 @@ function oxContent(options = {}) {
 			const srcDir = path$1.resolve(root, resolvedOptions.srcDir);
 			devServer.middlewares.use(createDevServerMiddleware(resolvedOptions, root, ssgDevCache));
 			devServer.watcher.on("add", (file) => {
-				if (file.startsWith(srcDir) && file.endsWith(".md")) invalidateNavCache(ssgDevCache);
+				if (file.startsWith(srcDir) && file.endsWith(".md")) {
+					invalidateNavCache(ssgDevCache);
+					devServer.ws.send({
+						type: "custom",
+						event: "ox-content:update",
+						data: {
+							file,
+							type: "add"
+						}
+					});
+				}
 			});
 			devServer.watcher.on("unlink", (file) => {
-				if (file.startsWith(srcDir) && file.endsWith(".md")) invalidateNavCache(ssgDevCache);
+				if (file.startsWith(srcDir) && file.endsWith(".md")) {
+					invalidateNavCache(ssgDevCache);
+					devServer.ws.send({
+						type: "custom",
+						event: "ox-content:update",
+						data: {
+							file,
+							type: "unlink"
+						}
+					});
+				}
 			});
 			devServer.watcher.on("change", (file) => {
 				if (file.startsWith(srcDir) && file.endsWith(".md")) invalidatePageCache(ssgDevCache, file);