@void/md 1.4.0 → 1.6.0

package/dist/{compile-B0tLGZa4.mjs → compile-5IQ1Trxe.mjs}

@@ -1,5 +1,4 @@
-import { t as extractHeadings } from "./metadata-TdHmXD-i.mjs";
-import matter from "gray-matter";
+import { r as parseFrontmatter, t as extractHeadings } from "./metadata-DDtNQG1v.mjs";
 import MarkdownExit from "markdown-exit";
 import anchor from "markdown-it-anchor";
 import footnote from "markdown-it-footnote";
@@ -9,7 +8,7 @@ import attrs from "markdown-it-attrs";
 import { full } from "markdown-it-emoji";
 import { bundledLanguages, createHighlighter, isSpecialLang } from "shiki";
 import container from "markdown-it-container";
-//#region src/plugins/containers.ts
+// src/plugins/containers.ts
 function createContainer(md, klass, defaultTitle) {
 	return [
 		container,
@@ -36,8 +35,7 @@ function createContainer(md, klass, defaultTitle) {
 function containerPlugin(md) {
 	md.use(...createContainer(md, "tip", "TIP")).use(...createContainer(md, "info", "INFO")).use(...createContainer(md, "warning", "WARNING")).use(...createContainer(md, "danger", "DANGER")).use(...createContainer(md, "details", "Details"));
 }
-//#endregion
-//#region src/plugins/github-alerts.ts
+// src/plugins/github-alerts.ts
 const markerRE = /^\[!(TIP|NOTE|INFO|IMPORTANT|WARNING|CAUTION|DANGER)\]([^\n\r]*)/i;
 const titleMark = {
 	tip: "TIP",
@@ -85,8 +83,7 @@ function gitHubAlertsPlugin(md) {
 		return `<div class="${type} custom-block github-alert"><p class="custom-block-title">${title}</p>\n`;
 	};
 }
-//#endregion
-//#region src/plugins/image.ts
+// src/plugins/image.ts
 const EXTERNAL_URL_RE$1 = /^[a-z]+:/i;
 /**
 * Normalizes relative image paths and optionally adds loading="lazy".
@@ -105,8 +102,7 @@ function imagePlugin(md, options) {
 		return imageRule(tokens, idx, mdOptions, env, self);
 	};
 }
-//#endregion
-//#region src/plugins/line-numbers.ts
+// src/plugins/line-numbers.ts
 /**
 * Adds a line number gutter to code blocks that opt in with `:line-numbers`.
 * `{=N}` sets the start line.
@@ -127,8 +123,7 @@ function lineNumberPlugin(md) {
 		return rawCode.replace(/<\/div>$/, `${lineNumbersWrapper}</div>`).replace(/"(language-[^"]*?)"/, "\"$1 line-numbers-mode\"");
 	};
 }
-//#endregion
-//#region src/plugins/link.ts
+// src/plugins/link.ts
 const EXTERNAL_URL_RE = /^[a-z]+:/i;
 const EXTERNAL_ATTRS = {
 	target: "_blank",
@@ -156,8 +151,7 @@ function linkPlugin(md) {
 		return self.renderToken(tokens, idx, mdOptions);
 	};
 }
-//#endregion
-//#region src/plugins/pre-wrapper.ts
+// src/plugins/pre-wrapper.ts
 function extractLang(info) {
 	return /^[a-zA-Z0-9-_]+/.exec(info)?.[0].replace(/-vue$/, "").replace(/^vue-html$/, "template").replace(/^ansi$/, "") || "";
 }
@@ -189,8 +183,7 @@ function preWrapperPlugin(md) {
 		return `<div class="language-${lang}${active}"><button title="Copy Code" class="copy"></button><span class="lang">${lang}</span>` + highlighted + `</div>`;
 	};
 }
-//#endregion
-//#region src/plugins/toc.ts
+// src/plugins/toc.ts
 const TOC_RE = /^\[\[toc\]\]$/i;
 const TOC_LEVELS = [2, 3];
 function renderHeaders(headers) {
@@ -229,8 +222,7 @@ function tocPlugin(md) {
 		return renderHeaders(extractHeadings(tokens).filter((heading) => TOC_LEVELS.includes(heading.depth)));
 	};
 }
-//#endregion
-//#region src/compile.ts
+// src/compile.ts
 let compilerPromise = null;
 async function getCompiler(options) {
 	if (compilerPromise) return compilerPromise;
@@ -296,7 +288,7 @@ async function createCompiler(options) {
 	return markdown;
 }
 async function compile(source, options) {
-	const { data: frontmatter, content } = matter(source);
+	const { frontmatter, content } = parseFrontmatter(source);
 	const compiler = await getCompiler(options);
 	const env = {};
 	const tokens = compiler.parse(content, env);
@@ -311,5 +303,4 @@ async function compile(source, options) {
 		title
 	};
 }
-//#endregion
 export { compile };

package/dist/index.d.mts

@@ -1,3 +1,3 @@
 import { FrontmatterContext, setFrontmatter, useFrontmatter } from "./runtime/index.mjs";
-import { n as MdPage } from "./plugin-ieYHo6qp.mjs";
+import { n as MdPage } from "./plugin-CZ4JTnkJ.mjs";
 export { FrontmatterContext, type MdPage, setFrontmatter, useFrontmatter };

package/dist/{metadata-TdHmXD-i.mjs → metadata-DDtNQG1v.mjs}

@@ -2,7 +2,7 @@ import matter from "gray-matter";
 import MarkdownExit from "markdown-exit";
 import anchor from "markdown-it-anchor";
 import footnote from "markdown-it-footnote";
-//#region src/metadata.ts
+// src/metadata.ts
 let metadataCompiler = null;
 function getMetadataCompiler() {
 	if (metadataCompiler) return metadataCompiler;
@@ -32,8 +32,20 @@ function extractHeadings(tokens) {
 	}
 	return headings;
 }
+function parseFrontmatter(source) {
+	try {
+		const { data: frontmatter, content } = matter(source, {});
+		return {
+			frontmatter,
+			content
+		};
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		throw new Error(`Invalid frontmatter: ${message}`, { cause: error });
+	}
+}
 function extractMetadata(source) {
-	const { data: frontmatter, content } = matter(source);
+	const { frontmatter, content } = parseFrontmatter(source);
 	const headings = extractHeadings(getMetadataCompiler().parse(content, {}));
 	return {
 		frontmatter,
@@ -41,5 +53,4 @@ function extractMetadata(source) {
 		title: frontmatter.title ?? headings.find((heading) => heading.depth === 1)?.text ?? ""
 	};
 }
-//#endregion
-export { extractMetadata as n, extractHeadings as t };
+export { extractMetadata as n, parseFrontmatter as r, extractHeadings as t };

package/dist/{plugin-ieYHo6qp.d.mts → plugin-CZ4JTnkJ.d.mts}

@@ -1,5 +1,4 @@
 import { Plugin } from "vite";
-//#region src/compile.d.ts
 type Heading = Readonly<{
   depth: number;
   slug: string;
@@ -25,8 +24,6 @@ type CompileOptions = Readonly<{
     langs?: ReadonlyArray<string>;
   };
 }>;
-//#endregion
-//#region src/extract-script.d.ts
 type IslandImport = {
   name: string;
   specifier: string;
@@ -40,8 +37,6 @@ type ScriptExtraction = Readonly<{
   islandImports: Array<IslandImport>;
   clientCode: string | null;
 }>;
-//#endregion
-//#region src/plugin.d.ts
 type MdPage = Readonly<{
   path: string;
   title: string;
@@ -56,5 +51,4 @@ type MarkdownOptions = Readonly<{
   shiki?: CompileOptions["shiki"];
 }>;
 declare function voidMarkdown(options?: MarkdownOptions): Array<Plugin>;
-//#endregion
 export { ScriptExtraction as a, IslandImport as i, MdPage as n, CompileOptions as o, voidMarkdown as r, CompileResult as s, MarkdownOptions as t };

package/dist/plugin.d.mts

@@ -1,2 +1,2 @@
-import { a as ScriptExtraction, i as IslandImport, n as MdPage, o as CompileOptions, r as voidMarkdown, s as CompileResult, t as MarkdownOptions } from "./plugin-ieYHo6qp.mjs";
+import { a as ScriptExtraction, i as IslandImport, n as MdPage, o as CompileOptions, r as voidMarkdown, s as CompileResult, t as MarkdownOptions } from "./plugin-CZ4JTnkJ.mjs";
 export { type CompileOptions, type CompileResult, type IslandImport, MarkdownOptions, MdPage, type ScriptExtraction, voidMarkdown };

package/dist/plugin.mjs

@@ -1,12 +1,12 @@
-import { n as extractMetadata } from "./metadata-TdHmXD-i.mjs";
+import { n as extractMetadata } from "./metadata-DDtNQG1v.mjs";
 import { createHash } from "node:crypto";
-import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { dirname, join, relative, resolve } from "pathslash";
 import { glob } from "tinyglobby";
 import { normalizePath } from "vite";
 import { pageFileEnvironment, resolvePagesDir } from "void/pages";
 import { editIslandSource, findIslandImports } from "void/pages-islands-plugin";
-//#region src/emit-shared.ts
+// src/emit-shared.ts
 const ISLAND_TAG_RE = /<([A-Z]\w*)\s*((?:[^>/"']|"[^"]*"|'[^']*')*)\/\s*>|<([A-Z]\w*)\s*((?:[^>/"']|"[^"]*"|'[^']*')*)>([\s\S]*?)<\/\3\s*>/g;
 function findIslandTags(html, names) {
 	const matches = [];
@@ -64,8 +64,7 @@ function buildRenderChunks(html, islandImports) {
 	}
 	return chunks;
 }
-//#endregion
-//#region src/emit-react.ts
+// src/emit-react.ts
 function emitReactComponent(result, islandImports) {
 	const chunks = buildRenderChunks(result.html, islandImports);
 	let code = `import React from "react";\n`;
@@ -116,8 +115,7 @@ export default function MarkdownPage() {
 `;
 	return code;
 }
-//#endregion
-//#region src/emit-solid.ts
+// src/emit-solid.ts
 function emitSolidComponent(result, islandImports) {
 	const chunks = buildRenderChunks(result.html, islandImports);
 	const importAliasByName = /* @__PURE__ */ new Map();
@@ -165,8 +163,7 @@ export default function MarkdownPage() {
 `;
 	return code;
 }
-//#endregion
-//#region src/emit-svelte.ts
+// src/emit-svelte.ts
 function toSvelteLiteral(value) {
 	return JSON.stringify(value).replace(/<\//g, "<\\/");
 }
@@ -213,8 +210,7 @@ ${body.join("\n")}
 `;
 	return source;
 }
-//#endregion
-//#region src/emit-vue.ts
+// src/emit-vue.ts
 function emitVueComponent(result, islandImports) {
 	const chunks = buildRenderChunks(result.html, islandImports);
 	let code = `import { defineComponent, h, createStaticVNode, provide } from "vue";\n`;
@@ -256,8 +252,7 @@ export default defineComponent({
 `;
 	return code;
 }
-//#endregion
-//#region src/extract-script.ts
+// src/extract-script.ts
 const SCRIPT_RE = /^<script\b[^>]*>([\s\S]*?)<\/script>\s*\n?/;
 function extractScript(source) {
 	const match = source.match(SCRIPT_RE);
@@ -285,8 +280,7 @@ function extractScript(source) {
 		}))).code.trim() : script) || null
 	};
 }
-//#endregion
-//#region src/plugin.ts
+// src/plugin.ts
 const MD_CLIENT_ENTRY_ID = "virtual:void-md-client";
 const ADAPTER_PLUGIN_NAMES = {
 	"void-vue:pages": "vue",
@@ -305,26 +299,16 @@ function mdRouteName(file, env) {
 	if (name === "index") return "";
 	return name.endsWith("/index") ? name.slice(0, -6) : name;
 }
-function hasMdFilesWithScript(dir) {
-	try {
-		for (const entry of readdirSync(dir, {
-			withFileTypes: true,
-			recursive: true
-		})) if (entry.isFile() && entry.name.endsWith(".md")) {
-			const fullPath = join(entry.parentPath, entry.name);
-			const content = readFileSync(fullPath, "utf-8");
-			if (/^<script\b/m.test(content)) return true;
-		}
-	} catch {}
-	return false;
+/** The Markdown files that `environment` keeps, relative to `pagesDir`. */
+async function listMdFiles(pagesDir, environment) {
+	return (await glob("**/*.md", { cwd: pagesDir })).filter((file) => {
+		const fileEnv = pageFileEnvironment(file);
+		return !fileEnv || fileEnv === environment;
+	});
 }
-function hasIslandFiles(dir) {
-	try {
-		for (const entry of readdirSync(dir, {
-			withFileTypes: true,
-			recursive: true
-		})) if (entry.isFile() && /\.island\./.test(entry.name)) return true;
-	} catch {}
+/** Whether any page has client code. Without it, pages would load an empty client entry. */
+async function hasMdClientCode(pagesDir, environment) {
+	for (const file of await listMdFiles(pagesDir, environment)) if (extractScript(readFileSync(join(pagesDir, file), "utf-8")).clientCode) return true;
 	return false;
 }
 function voidMarkdown(options) {
@@ -332,31 +316,51 @@ function voidMarkdown(options) {
 	let mdPages = [];
 	let root = "";
 	let pagesDir = "";
+	let logger;
 	let mdEnvironment = "prod";
 	const svelteModules = /* @__PURE__ */ new Map();
 	const solidModules = /* @__PURE__ */ new Map();
 	const clientScripts = /* @__PURE__ */ new Map();
+	const loggedPageErrors = /* @__PURE__ */ new Map();
 	function createVirtualModuleId(prefix, importerId, source, extension) {
 		return `${prefix}${Buffer.from(importerId).toString("base64url")}.${createHash("sha1").update(source).digest("hex").slice(0, 8)}.${extension}`;
 	}
+	function createPageError(file, error) {
+		const message = error instanceof Error ? error.message : String(error);
+		return new Error(`void-md: ${relative(root, file)}: ${message}`, { cause: error });
+	}
 	async function scanMdPages() {
 		if (!existsSync(pagesDir)) return [];
-		const liveFiles = (await glob("**/*.md", { cwd: pagesDir })).filter((file) => {
-			const fileEnv = pageFileEnvironment(file);
-			return !fileEnv || fileEnv === mdEnvironment;
-		});
+		const liveFiles = await listMdFiles(pagesDir, mdEnvironment);
 		return (await Promise.all(liveFiles.map(async (file) => {
-			const { body, clientCode } = extractScript(readFileSync(join(pagesDir, file), "utf-8"));
-			const result = extractMetadata(body);
-			const componentId = stripPageSuffix(file) || "index";
-			if (clientCode) clientScripts.set(componentId, clientCode);
-			return {
-				path: "/" + mdRouteName(file, pageFileEnvironment(file)),
-				title: result.title,
-				frontmatter: result.frontmatter,
-				headings: result.headings
-			};
-		}))).sort((leftPage, rightPage) => leftPage.path.localeCompare(rightPage.path));
+			const path = "/" + mdRouteName(file, pageFileEnvironment(file));
+			const filePath = join(pagesDir, file);
+			try {
+				const { body, clientCode } = extractScript(readFileSync(filePath, "utf-8"));
+				const result = extractMetadata(body);
+				const componentId = stripPageSuffix(file) || "index";
+				if (clientCode) clientScripts.set(componentId, clientCode);
+				loggedPageErrors.delete(file);
+				return {
+					path,
+					title: result.title,
+					frontmatter: result.frontmatter,
+					headings: result.headings
+				};
+			} catch (error) {
+				const pageError = createPageError(filePath, error);
+				if (mdEnvironment === "prod") throw pageError;
+				if (error.code === "ENOENT") return;
+				if (loggedPageErrors.get(file) !== pageError.message) {
+					loggedPageErrors.set(file, pageError.message);
+					logger?.error(pageError.message, {
+						error: pageError,
+						timestamp: true
+					});
+				}
+				return mdPages.find((page) => page.path === path);
+			}
+		}))).filter((page) => page !== void 0).sort((leftPage, rightPage) => leftPage.path.localeCompare(rightPage.path));
 	}
 	return [{
 		name: "void-md",
@@ -367,16 +371,17 @@ function voidMarkdown(options) {
 				return clientScripts;
 			}
 		},
-		config(config, env) {
+		async config(config, env) {
 			mdEnvironment = env.command === "serve" && !env.isPreview ? "dev" : "prod";
 			if (env.command === "serve") return;
 			const configRoot = config.root || process.cwd();
 			const pagesDir = resolvePagesDir(configRoot);
 			if (!existsSync(pagesDir)) return;
-			if (hasMdFilesWithScript(pagesDir) && hasIslandFiles(pagesDir)) return { environments: { client: { build: { rollupOptions: { input: { "md-client": MD_CLIENT_ENTRY_ID } } } } } };
+			if (await hasMdClientCode(pagesDir, mdEnvironment)) return { environments: { client: { build: { rollupOptions: { input: { "md-client": MD_CLIENT_ENTRY_ID } } } } } };
 		},
 		configResolved(config) {
 			root = config.root;
+			logger = config.logger;
 			pagesDir = resolvePagesDir(root);
 			for (const plugin of config.plugins) {
 				const match = ADAPTER_PLUGIN_NAMES[plugin.name];
@@ -398,7 +403,15 @@ function voidMarkdown(options) {
 			const isInPagesDir = (file) => file === normalizedPagesDir || file.startsWith(normalizedPagesDir + "/");
 			const handleMdChange = async (file) => {
 				if (!file.endsWith(".md") || !isInPagesDir(normalizePath(file))) return;
-				mdPages = await scanMdPages();
+				try {
+					mdPages = await scanMdPages();
+				} catch (error) {
+					server.config.logger.error(error instanceof Error ? error.message : String(error), {
+						error: error instanceof Error ? error : void 0,
+						timestamp: true
+					});
+					return;
+				}
 				const mod = server.moduleGraph.getModuleById("\0void-md-pages");
 				if (mod) server.moduleGraph.invalidateModule(mod);
 				for (const [compId] of clientScripts) {
@@ -487,8 +500,10 @@ export function useFrontmatter() { return useContext(FrontmatterContext) ?? {};
 						islandId
 					};
 				});
-				const { compile } = await import("./compile-B0tLGZa4.mjs");
-				const result = await compile(body, { shiki: options?.shiki });
+				const { compile } = await import("./compile-5IQ1Trxe.mjs");
+				const result = await compile(body, { shiki: options?.shiki }).catch((error) => {
+					throw createPageError(_id, error);
+				});
 				if (adapter === "vue") return {
 					code: emitVueComponent(result, islands),
 					map: null
@@ -528,5 +543,4 @@ function generateMdClientEntry(scripts) {
 	lines.push(`if (mdScriptId && mdScripts[mdScriptId]) mdScripts[mdScriptId]();`);
 	return lines.join("\n");
 }
-//#endregion
 export { voidMarkdown };

package/dist/runtime/index.d.mts

@@ -1,4 +1,3 @@
-//#region src/runtime/index.d.ts
 export declare function useFrontmatter(): Record<string, unknown>;
 /**
  * @deprecated Internal to generated Markdown components and not available with
@@ -11,5 +10,4 @@ export declare const FrontmatterContext: Record<string, unknown> | null;
  * every framework adapter. Use `useFrontmatter()`. Removed in the next major
  * version.
  */
-export declare function setFrontmatter(_frontmatter: Record<string, unknown>): void;
-//#endregion
+export declare function setFrontmatter(_frontmatter: Record<string, unknown>): void;

package/dist/runtime/index.mjs

@@ -1,4 +1,4 @@
-//#region src/runtime/index.ts
+// src/runtime/index.ts
 function useFrontmatter() {
 	return {};
 }
@@ -14,5 +14,4 @@ const FrontmatterContext = null;
 * version.
 */
 function setFrontmatter(_frontmatter) {}
-//#endregion
 export { FrontmatterContext, setFrontmatter, useFrontmatter };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@void/md",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "Markdown pages with layouts and interactive islands for Void.",
   "homepage": "https://void.cloud",
   "bugs": {
@@ -51,14 +51,14 @@
     "tinyglobby": "^0.2.17"
   },
   "devDependencies": {
-    "@types/node": "^26.6.5",
-    "vite": "npm:@voidzero-dev/vite-plus-core@1.3.0",
-    "vite-plus": "1.3.0",
-    "void": "1.4.0"
+    "@types/node": "^26.6.6",
+    "vite": "npm:@voidzero-dev/vite-plus-core@1.4.0",
+    "vite-plus": "1.4.0",
+    "void": "1.6.0"
   },
   "peerDependencies": {
     "vite": "^8.0.0",
-    "void": "1.4.0"
+    "void": "1.6.0"
   },
   "scripts": {
     "build": "vp pack",