fumadocs-mdx 15.1.1 → 15.2.0

package/dist/{adapter-DPEpBHhE.js → adapter-DvWJNDHu.js}

@@ -1,23 +1,26 @@
-import { r as ValidationError } from "./core-Cq6V99iz.js";
-import { t as loadConfig } from "./load-from-file-CVTAyohB.js";
+import { i as buildConfig, n as ValidationError } from "./core-BPlsDtvN.js";
+import { t as loadConfig } from "./load-from-file-DNDIyOo3.js";
 import { readFileSync } from "node:fs";
 import fs from "node:fs/promises";
 import { fileURLToPath } from "node:url";
 import { parse } from "node:querystring";
 //#region src/loaders/config.ts
-function createStandaloneConfigLoader({ core, buildConfig, mode }) {
+function createStandaloneConfigLoader({ core, buildConfig: buildConfig$1, mode }) {
 	let prev;
 	async function getConfigHash() {
 		if (mode === "production") return "static";
-		return (await fs.stat(core.getOptions().configPath).catch(() => {
-			throw new Error("Cannot find config file");
-		})).mtime.getTime().toString();
+		const stats = await fs.stat(core.configPath).catch(() => void 0);
+		return stats ? stats.mtime.getTime() : "missing";
+	}
+	async function load(hash) {
+		if (hash === "missing") return buildConfig({}, process.cwd());
+		return await loadConfig(core, buildConfig$1);
 	}
 	return { async getCore() {
 		const hash = await getConfigHash();
 		if (!prev || hash !== prev.hash) prev = {
 			hash,
-			init: core.init({ config: loadConfig(core, buildConfig) })
+			init: core.init({ config: load(hash) })
 		};
 		await prev.init;
 		return core;

package/dist/{build-BnKCFeb6.js → build-CMzB9h0Y.js}

@@ -3,10 +3,10 @@ import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 var build_exports = /* @__PURE__ */ __exportAll({ buildMDX: () => buildMDX });
 async function buildMDX(core, collection, options) {
 	if ((collection ? collection.compiler : core.getConfig().global.compiler) === "satteri") {
-		const { buildSatteriMDX } = await import("./build-satteri-Mk7OLtzu.js");
+		const { buildSatteriMDX } = await import("./build-satteri-oMFzrKGl.js");
 		return buildSatteriMDX(core, collection, options);
 	}
-	const { buildJSMDX } = await import("./build-default-DCQTM_P7.js");
+	const { buildJSMDX } = await import("./build-default-C77dbnhG.js");
 	return buildJSMDX(core, collection, options);
 }
 //#endregion

package/dist/{build-default-DCQTM_P7.js → build-default-C77dbnhG.js}

@@ -1,4 +1,5 @@
 import { n as flattenNode, r as applyMdxPreset, t as remarkInclude } from "./remark-include-B6rmf4sh.js";
+import { t as resolveLastModified } from "./last-modified-SdvMEHGm.js";
 import { visit } from "unist-util-visit";
 import { VFile } from "vfile";
 import { createProcessor } from "@mdx-js/mdx";
@@ -127,6 +128,14 @@ async function buildJSMDX(core, collection, { filePath, frontmatter, source, _co
 		filePath,
 		source
 	}, vfile);
+	const lastModified = await resolveLastModified(collection, filePath);
+	if (lastModified) {
+		vfile.data["mdx-export"] ??= [];
+		vfile.data["mdx-export"].push({
+			name: "lastModified",
+			value: lastModified
+		});
+	}
 	const out = await getProcessor(filePath.endsWith(".mdx") ? "mdx" : "md").process(vfile);
 	return {
 		code: String(out.value),

package/dist/{build-satteri-Mk7OLtzu.js → build-satteri-oMFzrKGl.js}

@@ -1,3 +1,4 @@
+import { t as resolveLastModified } from "./last-modified-SdvMEHGm.js";
 import { pathToFileURL } from "node:url";
 //#region src/loaders/mdx/build-satteri.ts
 async function buildSatteriMDX(core, collection, { filePath, frontmatter, source, _compiler, environment, isDevelopment }) {
@@ -29,7 +30,7 @@ async function buildSatteriMDX(core, collection, { filePath, frontmatter, source
 	const mdastPlugins = [remarkInclude({ cwd: collection?.cwd })];
 	if (satteriOptions.mdastPlugins) mdastPlugins.push(...satteriOptions.mdastPlugins);
 	if (postprocess.includeProcessedMarkdown) mdastPlugins.push(remarkLlms(typeof postprocess.includeProcessedMarkdown === "object" ? postprocess.includeProcessedMarkdown : void 0));
-	mdastPlugins.push(postprocessPlugin(postprocess));
+	mdastPlugins.push(postprocessPlugin(postprocess, await resolveLastModified(collection, filePath)));
 	return { code: (await compileMdx({
 		source,
 		filePath,
@@ -44,7 +45,7 @@ async function buildSatteriMDX(core, collection, { filePath, frontmatter, source
 		}
 	})).code };
 }
-function postprocessPlugin({ extractLinkReferences = false }) {
+function postprocessPlugin({ extractLinkReferences = false }, lastModified) {
 	return {
 		name: "remark-postprocess",
 		heading(node, ctx) {
@@ -59,6 +60,7 @@ function postprocessPlugin({ extractLinkReferences = false }) {
 				result.data.extractedReferences ??= [];
 				result.code += `\nexport const extractedReferences = ${JSON.stringify(result.data.extractedReferences)};`;
 			}
+			if (lastModified) result.code += `\nexport const lastModified = new Date(${lastModified.getTime()});`;
 		}
 	};
 }

package/dist/bun/index.d.ts

@@ -1,12 +1,21 @@
-import { r as CoreOptions } from "../core-Br7DNGl3.js";
+import { r as CoreOptions } from "../core-BmvJhZxm.js";
+import { n as ResolvedMacroOptions, t as MacroPluginOption } from "../options-aB6xV-d7.js";
 import { BunPlugin } from "bun";
 //#region src/bun/index.d.ts
-interface MdxPluginOptions extends Partial<CoreOptions> {
+interface MdxPluginOptions extends Pick<CoreOptions, 'configPath' | 'outDir' | 'plugins'> {
+  /**
+   * Configure the macro API (`fumadocs-mdx/macro`), or `false` to disable it.
+   */
+  macro?: MacroPluginOption;
   /**
    * Skip meta file transformation step
    */
   disableMetaFile?: boolean;
 }
+/**
+ * @internal
+ */
+declare function macroFilter(root: string, { include, exclude }: ResolvedMacroOptions): RegExp;
 declare function createMdxPlugin(options?: MdxPluginOptions): BunPlugin;
 //#endregion
-export { MdxPluginOptions, createMdxPlugin };
+export { MdxPluginOptions, createMdxPlugin, macroFilter };

package/dist/bun/index.js

@@ -1,27 +1,98 @@
-import { t as createMdxLoader } from "../mdx-wSuDwc6c.js";
-import { i as buildConfig, n as createCore, t as _Defaults } from "../core-Cq6V99iz.js";
-import { a as createIntegratedConfigLoader, t as toBun } from "../adapter-DPEpBHhE.js";
-import { t as createMetaLoader } from "../meta-BDiR5cQC.js";
-import { r as metaLoaderGlob, t as mdxLoaderGlob } from "../loaders-CUuRGbiE.js";
+import { t as createMdxLoader } from "../mdx-Bcb4tkWn.js";
+import { i as buildConfig, t as createCore } from "../core-BPlsDtvN.js";
+import { r as slash } from "../codegen-ESdi9CDJ.js";
+import { a as createIntegratedConfigLoader, t as toBun } from "../adapter-DvWJNDHu.js";
+import { t as createMetaLoader } from "../meta-DWvKGgBH.js";
+import { r as metaLoaderGlob, t as mdxLoaderGlob } from "../loaders-DWC_Uwqq.js";
+import { r as resolveMacroOptions } from "../options-BNnYUjkM.js";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import picomatch from "picomatch";
 import { pathToFileURL } from "node:url";
 //#region src/bun/index.ts
+const EvalQueryKey = "fd-macro-eval";
+/**
+* @internal
+*/
+function macroFilter(root, { include, exclude }) {
+	const toSource = (pattern) => picomatch.makeRe(slash(path.resolve(root, pattern)), { dot: true }).source;
+	const included = include.map((pattern) => `(?:${toSource(pattern).replace(/\$$/, String.raw`(?:\?.*)?$`)})`).join("|");
+	const excluded = exclude.map((pattern) => `(?:${toSource(pattern)})`).join("|");
+	return new RegExp(`^(?!${excluded})(?:${included})`);
+}
+function bunLoader(file) {
+	if (file.endsWith(".tsx")) return "tsx";
+	if (file.endsWith(".jsx")) return "jsx";
+	if (/\.[cm]?ts$/.test(file)) return "ts";
+	return "js";
+}
 function createMdxPlugin(options = {}) {
-	const { environment = "bun", outDir = _Defaults.outDir, configPath = _Defaults.configPath, disableMetaFile = false } = options;
+	const { disableMetaFile = false } = options;
+	const macroOptions = resolveMacroOptions(options.macro);
 	return {
 		name: "bun-plugin-fumadocs-mdx",
 		async setup(build) {
-			const importPath = pathToFileURL(configPath).href;
 			const core = createCore({
-				environment,
-				outDir,
-				configPath
+				environment: "bun",
+				outDir: options.outDir,
+				configPath: options.configPath,
+				plugins: options.plugins
 			});
-			await core.init({ config: buildConfig(await import(importPath), process.cwd()) });
+			const importPath = pathToFileURL(core.configPath).href;
+			const configExports = await fs.access(core.configPath).then(() => true, () => false) ? await import(importPath) : {};
+			await core.init({ config: buildConfig(configExports, process.cwd()) });
+			if (macroOptions) {
+				const root = process.cwd();
+				const { MacroCollector } = await import("../eval-z3HV4VJp.js").then((n) => n.r);
+				const pendingEvals = /* @__PURE__ */ new Map();
+				core.macro = new MacroCollector({
+					root,
+					outDir: core.outDir,
+					isDev: false,
+					async evaluator({ entry, transform }) {
+						const token = randomUUID();
+						pendingEvals.set(token, transform);
+						try {
+							await import(`${entry}?${EvalQueryKey}=${token}`);
+						} finally {
+							pendingEvals.delete(token);
+						}
+						return { inputs: [entry] };
+					}
+				});
+				const filter = macroFilter(root, macroOptions);
+				build.onLoad({ filter }, async (args) => {
+					const [file, query = ""] = args.path.split("?", 2);
+					const loader = bunLoader(file);
+					const source = await Bun.file(file).text();
+					if (!source.includes("fumadocs-mdx/macro")) return {
+						contents: source,
+						loader
+					};
+					const token = new URLSearchParams(query).get(EvalQueryKey);
+					const transform = token ? pendingEvals.get(token) : void 0;
+					if (transform) return {
+						contents: await transform(source, file) ?? source,
+						loader
+					};
+					const { transformMacroModule } = await import("../transform-BFobDsdE.js").then((n) => n.i);
+					return {
+						contents: (await transformMacroModule({
+							code: source,
+							file,
+							root,
+							target: "import"
+						}))?.code ?? source,
+						loader
+					};
+				});
+			}
 			const configLoader = createIntegratedConfigLoader(core);
 			toBun(mdxLoaderGlob, createMdxLoader(configLoader))(build);
-			if (!disableMetaFile) toBun(metaLoaderGlob, createMetaLoader(configLoader))(build);
+			if (!disableMetaFile) toBun(metaLoaderGlob, createMetaLoader(configLoader, {}))(build);
 		}
 	};
 }
 //#endregion
-export { createMdxPlugin };
+export { createMdxPlugin, macroFilter };

package/dist/config/index.d.ts

@@ -1,2 +1,3 @@
-import { A as DocCollection, B as defineCollections, D as AnyCollection, E as remarkInclude, F as DocsCollection, H as defineDocs, I as GlobalConfig, J as DefaultMDXOptions, L as MetaCollection, M as DocCollectionMdx, N as DocCollectionSatteri, O as BaseCollection, P as DocCollectionSatteriTyped, R as SatteriGlobalConfig, T as metaSchema, U as defineSatteriCollections, V as defineConfig, W as defineSatteriConfig, X as applyMdxPreset, Y as MDXPresetOptions, j as DocCollectionBase, k as CollectionSchema, q as PostprocessOptions, w as frontmatterSchema, z as SatteriPresetOptions } from "../core-Br7DNGl3.js";
-export { AnyCollection, BaseCollection, CollectionSchema, DefaultMDXOptions, DocCollection, DocCollectionBase, DocCollectionMdx, DocCollectionSatteri, DocCollectionSatteriTyped, DocsCollection, GlobalConfig, MDXPresetOptions, MetaCollection, type PostprocessOptions, SatteriGlobalConfig, type SatteriPresetOptions, applyMdxPreset, defineCollections, defineConfig, defineDocs, defineSatteriCollections, defineSatteriConfig, frontmatterSchema, metaSchema, remarkInclude };
+import { C as DocsCollection, D as defineCollections, E as SatteriPresetOptions, F as DefaultMDXOptions, I as MDXPresetOptions, L as applyMdxPreset, O as defineConfig, P as PostprocessOptions, S as DocCollectionSatteri, T as MetaCollection, _ as BaseCollection, b as DocCollectionBase, g as AnyCollection, k as defineDocs, v as CollectionSchema, w as GlobalConfig, x as DocCollectionMdx, y as DocCollection } from "../core-BmvJhZxm.js";
+import { n as metaSchema, r as remarkInclude, t as frontmatterSchema } from "../index-BN7EkING.js";
+export { AnyCollection, BaseCollection, CollectionSchema, DefaultMDXOptions, DocCollection, DocCollectionBase, DocCollectionMdx, DocCollectionSatteri, DocsCollection, GlobalConfig, MDXPresetOptions, MetaCollection, type PostprocessOptions, type SatteriPresetOptions, applyMdxPreset, defineCollections, defineConfig, defineDocs, frontmatterSchema, metaSchema, remarkInclude };

package/dist/config/index.js

@@ -1,42 +1,10 @@
+import { n as defineConfig, r as defineDocs, t as defineCollections } from "../define-BW5lveuc.js";
 import { r as applyMdxPreset, t as remarkInclude } from "../remark-include-B6rmf4sh.js";
 import { metaSchema as metaSchema$1, pageSchema } from "fumadocs-core/source/schema";
-//#region src/config/define.ts
-function defineCollections(options) {
-	return options;
-}
-function defineDocs(options) {
-	const dir = options.dir ?? "content/docs";
-	return {
-		type: "docs",
-		dir,
-		docs: defineCollections({
-			type: "doc",
-			dir,
-			schema: pageSchema,
-			...options?.docs
-		}),
-		meta: defineCollections({
-			type: "meta",
-			dir,
-			schema: metaSchema$1,
-			...options?.meta
-		})
-	};
-}
-function defineConfig(config = {}) {
-	return config;
-}
-function defineSatteriConfig(config = {}) {
-	return config;
-}
-function defineSatteriCollections(options) {
-	return options;
-}
-//#endregion
 //#region src/config/index.ts
 /** @deprecated import `pageSchema` from `fumadocs-core/source/schema` instead (since 16.2.3) */
 const frontmatterSchema = pageSchema;
 /** @deprecated import from `fumadocs-core/source/schema` instead (since 16.2.3) */
 const metaSchema = metaSchema$1;
 //#endregion
-export { applyMdxPreset, defineCollections, defineConfig, defineDocs, defineSatteriCollections, defineSatteriConfig, frontmatterSchema, metaSchema, remarkInclude };
+export { applyMdxPreset, defineCollections, defineConfig, defineDocs, frontmatterSchema, metaSchema, remarkInclude };

package/dist/{core-Cq6V99iz.js → core-BPlsDtvN.js}

@@ -103,10 +103,6 @@ async function validate(schema, data, context, errorMessage) {
 }
 //#endregion
 //#region src/core.ts
-const _Defaults = {
-	configPath: "source.config.ts",
-	outDir: ".source"
-};
 async function getPlugins(pluginOptions) {
 	const plugins = [];
 	for await (const option of pluginOptions) {
@@ -117,6 +113,9 @@ async function getPlugins(pluginOptions) {
 	return plugins;
 }
 function createCore(options) {
+	const root = options.root ? path.resolve(options.root) : process.cwd();
+	const outDir = path.resolve(root, options.outDir ?? ".source");
+	const configPath = path.resolve(root, options.configPath ?? "source.config.ts");
 	let config;
 	let plugins;
 	const workspaces = /* @__PURE__ */ new Map();
@@ -132,6 +131,31 @@ function createCore(options) {
 		* Convenient cache store, reset when config changes
 		*/
 		cache: /* @__PURE__ */ new Map(),
+		/**
+		* Collects the collections declared with `fumadocs-mdx/macro`.
+		*
+		* Assigned by the bundler adapter when the macro API is enabled, so that every loader of a
+		* build shares one collector (and hence one evaluation of each macro module).
+		*/
+		macro: void 0,
+		/** absolute path */
+		get outDir() {
+			return outDir;
+		},
+		/** absolute path */
+		get root() {
+			return root;
+		},
+		/** absolute path */
+		get configPath() {
+			return configPath;
+		},
+		get workspace() {
+			return options.workspace;
+		},
+		get environment() {
+			return options.environment;
+		},
 		async init({ config: newConfig }) {
 			config = await newConfig;
 			this.cache.clear();
@@ -148,7 +172,7 @@ function createCore(options) {
 			if (!options.workspace) await Promise.all(Object.entries(config.workspaces).map(async ([name, workspace]) => {
 				const core = createCore({
 					...options,
-					outDir: path.join(options.outDir, name),
+					outDir: path.join(outDir, name),
 					workspace: {
 						name,
 						parent: this,
@@ -162,9 +186,6 @@ function createCore(options) {
 		getWorkspaces() {
 			return workspaces;
 		},
-		getOptions() {
-			return options;
-		},
 		getConfig() {
 			return config;
 		},
@@ -172,7 +193,7 @@ function createCore(options) {
 		* The file path of compiled config file, the file may not exist (e.g. on Vite, or still compiling)
 		*/
 		getCompiledConfigPath() {
-			return path.join(options.outDir, "source.config.mjs");
+			return path.join(outDir, "source.config.mjs");
 		},
 		getPlugins() {
 			return plugins;
@@ -213,7 +234,7 @@ function createCore(options) {
 			}
 			if (write) {
 				await Promise.all(out.entries.map(async (entry) => {
-					const file = path.join(options.outDir, entry.path);
+					const file = path.join(outDir, entry.path);
 					await fs.mkdir(path.dirname(file), { recursive: true });
 					await fs.writeFile(file, entry.content);
 				}));
@@ -253,6 +274,15 @@ function createCore(options) {
 		}
 	};
 }
+/**
+* @returns the doc collection of a `doc`/`docs` collection, `undefined` for `meta`
+*/
+function docCollectionOf(collection) {
+	switch (collection.type) {
+		case "doc": return collection;
+		case "docs": return collection.docs;
+	}
+}
 function postprocessPlugin() {
 	const LinkReferenceTypes = `{
   /**
@@ -260,33 +290,29 @@ function postprocessPlugin() {
    */
   extractedReferences: import("fumadocs-mdx").ExtractedReference[];
 }`;
-	return { "index-file": {
-		generateTypeConfig() {
-			const lines = [];
-			lines.push("{");
-			lines.push("  DocData: {");
-			for (const collection of this.core.getCollections()) {
-				let postprocessOptions;
-				switch (collection.type) {
-					case "doc":
-						postprocessOptions = collection.postprocess;
-						break;
-					case "docs":
-						postprocessOptions = collection.docs.postprocess;
-						break;
-				}
-				if (postprocessOptions?.extractLinkReferences) lines.push(ident(`${collection.name}: ${LinkReferenceTypes},`, 2));
-			}
-			lines.push("  }");
-			lines.push("}");
-			return lines.join("\n");
-		},
-		serverOptions(options) {
-			options.doc ??= {};
-			options.doc.passthroughs ??= [];
-			options.doc.passthroughs.push("extractedReferences");
+	const LastModifiedTypes = `{
+  /**
+   * Last modified date of document file, obtained from version control.
+   */
+  lastModified?: Date;
+}`;
+	return { "index-file": { generateTypeConfig() {
+		const lines = [];
+		lines.push("{");
+		lines.push("  DocData: {");
+		for (const collection of this.core.getCollections()) {
+			const docs = docCollectionOf(collection);
+			if (!docs) continue;
+			const extras = [];
+			if (docs.postprocess?.extractLinkReferences) extras.push(LinkReferenceTypes);
+			if (docs.lastModified) extras.push(LastModifiedTypes);
+			if (extras.length === 0) continue;
+			lines.push(ident(`${collection.name}: ${extras.join(" & ")},`, 2));
 		}
-	} };
+		lines.push("  }");
+		lines.push("}");
+		return lines.join("\n");
+	} } };
 }
 //#endregion
-export { buildConfig as i, createCore as n, ValidationError as r, _Defaults as t };
+export { buildConfig as i, ValidationError as n, buildCollection as r, createCore as t };