fumadocs-mdx 15.2.0 → 15.2.1

package/dist/bin.d.ts

@@ -1 +1 @@
-export { };
+export {}

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

@@ -3,7 +3,7 @@ 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-oMFzrKGl.js");
+		const { buildSatteriMDX } = await import("./build-satteri-k0DGJ1In.js");
 		return buildSatteriMDX(core, collection, options);
 	}
 	const { buildJSMDX } = await import("./build-default-C77dbnhG.js");

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

@@ -3,8 +3,9 @@ import { pathToFileURL } from "node:url";
 //#region src/loaders/mdx/build-satteri.ts
 async function buildSatteriMDX(core, collection, { filePath, frontmatter, source, _compiler, environment, isDevelopment }) {
 	const satteriOptions = await getSatteriOptions(core.getConfig(), collection, environment);
+	const format = filePath.endsWith(".mdx") ? "mdx" : "md";
 	const postprocess = {
-		_format: filePath.endsWith(".mdx") ? "mdx" : "md",
+		_format: format,
 		...collection?.postprocess
 	};
 	const [{ compileMdx }, { remarkLlms }, { remarkInclude }] = await Promise.all([
@@ -34,6 +35,7 @@ async function buildSatteriMDX(core, collection, { filePath, frontmatter, source
 	return { code: (await compileMdx({
 		source,
 		filePath,
+		format,
 		frontmatter,
 		isDevelopment,
 		environment,
@@ -55,12 +57,12 @@ function postprocessPlugin({ extractLinkReferences = false }, lastModified) {
 		link(node, ctx) {
 			if (extractLinkReferences) (ctx.data.extractedReferences ??= []).push({ href: node.url });
 		},
+		collectExports({ data, addExport }) {
+			if (extractLinkReferences) addExport("extractedReferences", JSON.stringify(data.extractedReferences ??= []));
+			if (lastModified) addExport("lastModified", `new Date(${lastModified.getTime()})`);
+		},
 		afterToJs({ result }) {
-			if (extractLinkReferences) {
-				result.data.extractedReferences ??= [];
-				result.code += `\nexport const extractedReferences = ${JSON.stringify(result.data.extractedReferences)};`;
-			}
-			if (lastModified) result.code += `\nexport const lastModified = new Date(${lastModified.getTime()});`;
+			if (extractLinkReferences) result.data.extractedReferences ??= [];
 		}
 	};
 }

package/dist/bun/index.js

@@ -1,4 +1,4 @@
-import { t as createMdxLoader } from "../mdx-Bcb4tkWn.js";
+import { t as createMdxLoader } from "../mdx-3XO-apdE.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";

package/dist/{dist-CQ17lmpt.js → dist-Dm0fXCC7.js}

@@ -19,10 +19,10 @@ async function readJson(pkgJsonPath) {
 var generated_default = {
 	optimizeDeps: {
 		"include": [
+			"@fumadocs/local-md > @fumadocs/local-content > picomatch",
 			"@fumadocs/local-md > estree-util-to-js > source-map",
 			"@fumadocs/local-md > hast-util-to-jsx-runtime > mdast-util-mdx-expression > mdast-util-from-markdown > micromark > debug",
 			"@fumadocs/local-md > hast-util-to-jsx-runtime > style-to-js",
-			"@fumadocs/local-md > picomatch",
 			"@fumadocs/local-md > remark > unified > extend",
 			"@fumadocs/mdx-remote > @mdx-js/mdx > hast-util-to-jsx-runtime > style-to-js",
 			"@fumadocs/mdx-remote > @mdx-js/mdx > remark-parse > mdast-util-from-markdown > micromark > debug",
@@ -48,6 +48,7 @@ var generated_default = {
 		],
 		"exclude": [
 			"@fumadocs/basehub",
+			"@fumadocs/local-content",
 			"@fumadocs/local-md",
 			"@fumadocs/mdx-remote",
 			"@fumadocs/sanity",
@@ -62,6 +63,7 @@ var generated_default = {
 	},
 	ssr: { "noExternal": [
 		"@fumadocs/basehub",
+		"@fumadocs/local-content",
 		"@fumadocs/local-md",
 		"@fumadocs/mdx-remote",
 		"@fumadocs/sanity",
@@ -74,6 +76,21 @@ var generated_default = {
 		"fumadocs-ui"
 	] }
 };
+/**
+* `use-sync-external-store` is a CommonJS package Base UI depends on for React 17, where
+* `useSyncExternalStore` wasn't built into React yet.
+*
+* When it is bundled for SSR, its `require('react')` stays a runtime require, so it ends up with a
+* different React instance than the bundled one the renderer installs its hook dispatcher on.
+* Calling a hook then reads a null dispatcher and every component using a Base UI store (dialogs,
+* navigation menu, scroll area) throws during SSR.
+*
+* We require React 19, where the shim only forwards to React's own `useSyncExternalStore`.
+*/
+const alias = [{
+	find: /^use-sync-external-store\/shim$/,
+	replacement: "react"
+}];
 async function getConfig(options) {
 	const pkgJsonPath = await findClosestPkgJsonPath(options.root);
 	if (!pkgJsonPath) return {
@@ -81,7 +98,8 @@ async function getConfig(options) {
 			include: [],
 			exclude: []
 		},
-		ssr: { noExternal: [] }
+		ssr: { noExternal: [] },
+		resolve: { alias }
 	};
 	const pkgJson = await readJson(pkgJsonPath).catch((e) => {
 		throw new Error(`Unable to read ${pkgJsonPath}`, { cause: e });
@@ -96,7 +114,10 @@ async function getConfig(options) {
 	});
 	out.optimizeDeps.exclude = out.optimizeDeps.exclude.filter((item) => deps.has(item));
 	out.ssr.noExternal = out.ssr.noExternal.filter((item) => deps.has(item));
-	return out;
+	return {
+		...out,
+		resolve: { alias }
+	};
 }
 //#endregion
 export { getConfig };

package/dist/macro/index.d.ts

@@ -1,9 +1,9 @@
 import { A as SatteriOptionsInput, N as ExtractedReference, P as PostprocessOptions, h as BuildEnvironment, v as CollectionSchema } from "../core-BmvJhZxm.js";
 import { MacroAsyncDocCollection, MacroAsyncDocsCollection, MacroDocCollection, MacroDocsCollection, MacroMetaCollection } from "../runtime/macro.js";
 import { metaSchema, pageSchema } from "fumadocs-core/source/schema";
+import { MetaData, PageData } from "fumadocs-core/source";
 import { ProcessorOptions } from "@mdx-js/mdx";
 import { StandardJSONSchemaV1, StandardSchemaV1 } from "@standard-schema/spec";
-import { MetaData, PageData } from "fumadocs-core/source";
 //#region src/macro/index.d.ts
 interface MacroSchemaContext {
   path: string;
@@ -121,4 +121,4 @@ declare function defineCollections<DocSchema extends StandardSchemaV1 = Standard
   lastModified: LastModified;
 }>>;
 //#endregion
-export { DefineDocCollectionsOptions, DefineDocsOptions, DefineMetaCollectionsOptions, DocMacroOptions, MacroSchemaContext, MetaMacroOptions, defineCollections, defineDocs };
+export { DefineDocCollectionsOptions, DefineDocsOptions, DefineMetaCollectionsOptions, DocMacroOptions, type ExtractedReference, MacroSchemaContext, MetaMacroOptions, defineCollections, defineDocs };

package/dist/{mdx-Bcb4tkWn.js → mdx-3XO-apdE.js}

@@ -65,7 +65,7 @@ function createMdxLoader({ getCore }) {
 			code: `export const frontmatter = ${JSON.stringify(matter.data)}`,
 			map: null
 		};
-		const { buildMDX } = await import("./build-CMzB9h0Y.js").then((n) => n.n);
+		const { buildMDX } = await import("./build-DINFMoNj.js").then((n) => n.n);
 		const compiled = await buildMDX(core, docCollection, {
 			isDevelopment,
 			source: "\n".repeat(countLines(matter.matter)) + matter.content,

package/dist/node/_loader.js

@@ -1,4 +1,4 @@
-import { t as createMdxLoader } from "../mdx-Bcb4tkWn.js";
+import { t as createMdxLoader } from "../mdx-3XO-apdE.js";
 import { t as createCore } from "../core-BPlsDtvN.js";
 import { r as slash } from "../codegen-ESdi9CDJ.js";
 import { n as toNode, o as createStandaloneConfigLoader } from "../adapter-DvWJNDHu.js";

package/dist/node/loader.js

@@ -1,4 +1,4 @@
-import { t as createMdxLoader } from "../mdx-Bcb4tkWn.js";
+import { t as createMdxLoader } from "../mdx-3XO-apdE.js";
 import { t as createCore } from "../core-BPlsDtvN.js";
 import { n as toNode, o as createStandaloneConfigLoader } from "../adapter-DvWJNDHu.js";
 import { t as createMetaLoader } from "../meta-DWvKGgBH.js";

package/dist/rolldown/index.js

@@ -1,4 +1,4 @@
-import { t as createMdxLoader } from "../mdx-Bcb4tkWn.js";
+import { t as createMdxLoader } from "../mdx-3XO-apdE.js";
 import { i as buildConfig, t as createCore } from "../core-BPlsDtvN.js";
 import { r as slash } from "../codegen-ESdi9CDJ.js";
 import { a as createIntegratedConfigLoader, r as toVite } from "../adapter-DvWJNDHu.js";

package/dist/runtime/dynamic.js

@@ -1,5 +1,5 @@
 import { i as buildConfig, t as createCore } from "../core-BPlsDtvN.js";
-import { t as buildMDX } from "../build-CMzB9h0Y.js";
+import { t as buildMDX } from "../build-DINFMoNj.js";
 import { server } from "./server.js";
 import { frontmatter } from "fumadocs-core/content/md/frontmatter";
 import fs from "node:fs/promises";

package/dist/runtime/macro.d.ts

@@ -1,12 +1,34 @@
 import { a as MetaMethods, n as DocMethods, t as DocData } from "../types-DWoea9Sq.js";
 import { MetaData, PageData, Source } from "fumadocs-core/source";
+import { MDXContent } from "mdx/types";
 import { StructuredData } from "fumadocs-core/mdx-plugins/remark-structure";
 //#region src/runtime/macro.d.ts
-type MacroDocEntry<Frontmatter = unknown, Extra = unknown> = DocData & DocMethods & Frontmatter & Extra;
+interface BrowserDocMethods {
+  /**
+   * Preload the content, so it can be rendered synchronously afterwards.
+   *
+   * In non-RSC apps, call it in your route loader such that `body` doesn't suspend on render.
+   *
+   * No-op on eagerly loaded (non-`async`) collections.
+   */
+  preload: () => Promise<void>;
+}
+type MacroDocEntry<Frontmatter = unknown, Extra = unknown> = DocData & DocMethods & BrowserDocMethods & Frontmatter & Extra;
 type MacroAsyncDocEntry<Frontmatter = unknown, Extra = unknown> = {
+  /**
+   * Load the compiled content.
+   *
+   * The promise is memoized, it's safe to call in render (e.g. `use(entry.load())`).
+   */
   load: () => Promise<DocData & Extra>;
   structuredData: () => Promise<StructuredData>;
-} & DocMethods & Frontmatter;
+  /**
+   * Component rendering the compiled content.
+   *
+   * It loads the content lazily and suspends (React `use()`) until available, call `preload()` beforehand to render synchronously.
+   */
+  body: MDXContent;
+} & DocMethods & BrowserDocMethods & Frontmatter;
 type MacroMetaEntry<Data = unknown> = MetaMethods & Data;
 interface MacroDocCollection<Frontmatter = unknown, Extra = unknown> {
   entries: MacroDocEntry<Frontmatter, Extra>[];
@@ -86,4 +108,4 @@ declare function docsAsync(args: BaseArgs & {
   meta: GlobEntries;
 }): Promise<MacroAsyncDocsCollection>;
 //#endregion
-export { MacroAsyncDocCollection, MacroAsyncDocEntry, MacroAsyncDocsCollection, MacroDocCollection, MacroDocEntry, MacroDocsCollection, MacroMetaCollection, MacroMetaEntry, doc, docAsync, docs, docsAsync, meta };
+export { BrowserDocMethods, MacroAsyncDocCollection, MacroAsyncDocEntry, MacroAsyncDocsCollection, MacroDocCollection, MacroDocEntry, MacroDocsCollection, MacroMetaCollection, MacroMetaEntry, doc, docAsync, docs, docsAsync, meta };

package/dist/runtime/macro.js

@@ -1,4 +1,5 @@
 import { server, toFumadocsSource } from "./server.js";
+import { createElement, use } from "react";
 //#region src/runtime/macro.ts
 function create() {
 	return server();
@@ -16,8 +17,48 @@ function accessor(entries) {
 		}
 	};
 }
+/**
+* annotate promise state in the convention understood by React `use()`, so settled promises are unwrapped without suspending.
+*/
+function track(promise) {
+	const tracked = promise;
+	tracked.status = "pending";
+	promise.then((value) => {
+		tracked.status = "fulfilled";
+		tracked.value = value;
+	}, (reason) => {
+		tracked.status = "rejected";
+		tracked.reason = reason;
+	});
+	return tracked;
+}
+const eagerPreload = async () => {};
+function withPreload(entries) {
+	return entries.map((entry) => ({
+		...entry,
+		preload: eagerPreload
+	}));
+}
+function asyncEntries(raw) {
+	return raw.map((entry) => {
+		let promise;
+		const load = () => promise ??= track(entry.load());
+		function Body(props) {
+			const loaded = load();
+			return createElement((loaded.status === "fulfilled" ? loaded.value : use(loaded)).body, props);
+		}
+		return {
+			...entry,
+			load,
+			async preload() {
+				await load();
+			},
+			body: Body
+		};
+	});
+}
 async function doc(args) {
-	const entries = await create().doc("doc", args.base, args.entries);
+	const entries = withPreload(await create().doc("doc", args.base, args.entries));
 	return {
 		...accessor(entries),
 		toFumadocsSource(options) {
@@ -26,7 +67,7 @@ async function doc(args) {
 	};
 }
 async function docAsync(args) {
-	const entries = await create().docLazy("doc", args.base, args.head, args.body);
+	const entries = asyncEntries(await create().docLazy("doc", args.base, args.head, args.body));
 	return {
 		...accessor(entries),
 		toFumadocsSource(options) {
@@ -39,7 +80,8 @@ async function meta(args) {
 }
 async function docs(args) {
 	const instance = create();
-	const [docEntries, metaEntries] = await Promise.all([instance.doc("doc", args.base, args.entries), instance.meta("meta", args.base, args.meta)]);
+	const [rawDocEntries, metaEntries] = await Promise.all([instance.doc("doc", args.base, args.entries), instance.meta("meta", args.base, args.meta)]);
+	const docEntries = withPreload(rawDocEntries);
 	const getDoc = accessor(docEntries);
 	const getMeta = accessor(metaEntries);
 	return {
@@ -54,7 +96,8 @@ async function docs(args) {
 }
 async function docsAsync(args) {
 	const instance = create();
-	const [docEntries, metaEntries] = await Promise.all([instance.docLazy("doc", args.base, args.head, args.body), instance.meta("meta", args.base, args.meta)]);
+	const [rawDocEntries, metaEntries] = await Promise.all([instance.docLazy("doc", args.base, args.head, args.body), instance.meta("meta", args.base, args.meta)]);
+	const docEntries = asyncEntries(rawDocEntries);
 	const getDoc = accessor(docEntries);
 	const getMeta = accessor(metaEntries);
 	return {

package/dist/runtime/server.d.ts

@@ -1,8 +1,8 @@
 import { C as DocsCollection, T as MetaCollection, y as DocCollection } from "../core-BmvJhZxm.js";
 import "../index-BN7EkING.js";
 import { a as MetaMethods, i as InternalTypeConfig, n as DocMethods, t as DocData } from "../types-DWoea9Sq.js";
-import { StandardSchemaV1 } from "@standard-schema/spec";
 import { MetaData, PageData, Source } from "fumadocs-core/source";
+import { StandardSchemaV1 } from "@standard-schema/spec";
 import { StructuredData } from "fumadocs-core/mdx-plugins/remark-structure";
 //#region src/runtime/server.d.ts
 type MetaCollectionEntry<Data> = Data & MetaMethods;

package/dist/runtime/server.js

@@ -1,11 +1,11 @@
-import * as path$1 from "node:path";
+import { PathUtils } from "fumadocs-core/source";
 //#region src/runtime/server.ts
 function server() {
 	function fileInfo(file, base) {
 		if (file.startsWith("./")) file = file.slice(2);
 		return {
 			path: file,
-			fullPath: path$1.join(base, file)
+			fullPath: PathUtils.joinPath(base, file)
 		};
 	}
 	function mapDocData(entry) {
@@ -79,13 +79,13 @@ function toFumadocsSource(pages, metas, options) {
 	const files = [];
 	for (const entry of pages) files.push({
 		type: "page",
-		path: baseDir ? path$1.join(baseDir, entry.info.path) : entry.info.path,
+		path: baseDir ? PathUtils.joinPath(baseDir, entry.info.path) : entry.info.path,
 		absolutePath: entry.info.fullPath,
 		data: entry
 	});
 	for (const entry of metas) files.push({
 		type: "meta",
-		path: baseDir ? path$1.join(baseDir, entry.info.path) : entry.info.path,
+		path: baseDir ? PathUtils.joinPath(baseDir, entry.info.path) : entry.info.path,
 		absolutePath: entry.info.fullPath,
 		data: entry
 	});

package/dist/vite/index.d.ts

@@ -1,5 +1,6 @@
-import { p as IndexFilePluginOptions, r as CoreOptions } from "../core-BmvJhZxm.js";
+import { p as IndexFilePluginOptions, r as CoreOptions, w as GlobalConfig } from "../core-BmvJhZxm.js";
 import { t as MacroPluginOption } from "../options-aB6xV-d7.js";
+import "../index-BN7EkING.js";
 import { Plugin } from "vite";
 //#region src/vite/index.d.ts
 interface PluginOptions extends Pick<CoreOptions, 'configPath' | 'outDir' | 'plugins'> {
@@ -22,8 +23,15 @@ interface PluginOptions extends Pick<CoreOptions, 'configPath' | 'outDir' | 'plu
    * @defaultValue true
    */
   updateViteConfig?: boolean;
+  /** extra global options, will be shallow-merged if another global config is specified in the main config file. */
+  globalOptions?: GlobalConfig;
 }
+interface FumadocsMdxOptions extends PluginOptions {
+  /** force a config module object instead of importing from config path. */
+  forcedConfig?: Record<string, unknown> | Promise<Record<string, unknown>>;
+}
+declare function fumadocsMdx(options?: FumadocsMdxOptions): Plugin<any>[];
 declare function mdx(forcedConfig?: Record<string, unknown> | Promise<Record<string, unknown>> | undefined, pluginOptions?: PluginOptions): Plugin[];
 declare function postInstall(pluginOptions?: PluginOptions): Promise<void>;
 //#endregion
-export { PluginOptions, mdx as default, postInstall };
+export { FumadocsMdxOptions, PluginOptions, mdx as default, fumadocsMdx, postInstall };

package/dist/vite/index.js

@@ -1,4 +1,4 @@
-import { t as createMdxLoader } from "../mdx-Bcb4tkWn.js";
+import { t as createMdxLoader } from "../mdx-3XO-apdE.js";
 import { i as buildConfig, t as createCore } from "../core-BPlsDtvN.js";
 import { a as createIntegratedConfigLoader, r as toVite } from "../adapter-DvWJNDHu.js";
 import { t as createMetaLoader } from "../meta-DWvKGgBH.js";
@@ -33,9 +33,12 @@ function createMacroEvaluator(root) {
 		return { inputs: Array.from(inputs) };
 	};
 }
+function fumadocsMdx(options) {
+	return mdx(options?.forcedConfig, options);
+}
 function mdx(forcedConfig, pluginOptions = {}) {
 	const { updateViteConfig = true } = pluginOptions;
-	let core;
+	let managed;
 	const metaPlugin = { name: "fumadocs-mdx:meta" };
 	const mdxPlugin = { name: "fumadocs-mdx:mdx" };
 	const macroPlugin = { name: "fumadocs-mdx:macro" };
@@ -43,7 +46,8 @@ function mdx(forcedConfig, pluginOptions = {}) {
 		{
 			name: "fumadocs-mdx",
 			async config(config, env) {
-				core = createViteCore(config.root ?? process.cwd(), pluginOptions);
+				managed = createManagedCore(config.root ?? process.cwd(), forcedConfig, pluginOptions);
+				const core = managed.core;
 				const macroOptions = resolveMacroOptions(pluginOptions.macro);
 				if (macroOptions) {
 					const { MacroCollector } = await import("../eval-z3HV4VJp.js").then((n) => n.r);
@@ -54,7 +58,7 @@ function mdx(forcedConfig, pluginOptions = {}) {
 						evaluator: createMacroEvaluator(core.root)
 					});
 				}
-				await core.init({ config: buildConfig(forcedConfig ? await forcedConfig : await importConfigFile(core.configPath), core.root) });
+				await managed.reload();
 				const configLoader = createIntegratedConfigLoader(core);
 				const mdxLoader = toVite(createMdxLoader(configLoader));
 				const metaLoader = toVite(createMetaLoader(configLoader, { json: "json" }));
@@ -63,7 +67,7 @@ function mdx(forcedConfig, pluginOptions = {}) {
 					order: "pre",
 					handler(code, id) {
 						if (id.includes("virtual:vite-rsc")) return null;
-						if (!forcedConfig) this.addWatchFile(core.configPath);
+						if (managed.watchConfig) this.addWatchFile(core.configPath);
 						return mdxLoader.transform.call(this, code, id);
 					}
 				};
@@ -71,7 +75,7 @@ function mdx(forcedConfig, pluginOptions = {}) {
 					filter: { id: metaLoaderGlob },
 					order: "pre",
 					handler(code, id) {
-						if (!forcedConfig) this.addWatchFile(core.configPath);
+						if (managed.watchConfig) this.addWatchFile(core.configPath);
 						return metaLoader.transform.call(this, code, id);
 					}
 				};
@@ -105,20 +109,23 @@ function mdx(forcedConfig, pluginOptions = {}) {
 				}
 				if ("_fumadocs_skipViteConfig" in config && config._fumadocs_skipViteConfig) return;
 				if (!updateViteConfig) return;
-				const { getConfig } = await import("../dist-CQ17lmpt.js");
+				const { getConfig } = await import("../dist-Dm0fXCC7.js");
 				return getConfig({ root: core.root });
 			},
 			async buildStart() {
-				await core.emit({ write: true });
+				await managed.core.emit({ write: true });
 			},
 			async configureServer(server) {
+				const core = managed.core;
 				await core.initServer({ watcher: server.watcher });
-				if (!forcedConfig) server.watcher.on("change", async (file) => {
-					if (path.resolve(file) === core.configPath) {
-						await core.init({ config: buildConfig(await importConfigFile(core.configPath), core.root) });
-						await core.emit({ write: true });
-					}
-				});
+				if (forcedConfig) return;
+				const onChange = async (file) => {
+					if (path.resolve(file) !== core.configPath) return;
+					await managed.reload();
+					await core.emit({ write: true });
+				};
+				server.watcher.on("change", onChange);
+				server.watcher.on("add", onChange);
 			}
 		},
 		macroPlugin,
@@ -126,14 +133,42 @@ function mdx(forcedConfig, pluginOptions = {}) {
 		metaPlugin
 	];
 }
-async function importConfigFile(configPath) {
-	if (!await fs.access(configPath).then(() => true, () => false)) return {};
-	return (await runnerImport(configPath)).module;
+function createManagedCore(root, forcedConfig, pluginOptions) {
+	const managed = {
+		core: createViteCore(root, pluginOptions),
+		watchConfig: false,
+		async reload() {
+			const { config, fromFile } = await loadCoreConfig(managed.core, forcedConfig, pluginOptions);
+			managed.watchConfig = fromFile;
+			await managed.core.init({ config });
+		}
+	};
+	return managed;
+}
+async function loadCoreConfig(core, forcedConfig, { globalOptions } = {}) {
+	let v;
+	let fromFile = false;
+	if (forcedConfig) v = await forcedConfig;
+	else {
+		const exists = await fs.access(core.configPath).then(() => true, () => false);
+		v = exists ? (await runnerImport(core.configPath)).module : {};
+		fromFile = exists;
+	}
+	return {
+		config: await buildConfig(globalOptions ? {
+			...v,
+			default: {
+				...typeof v.default === "object" ? v.default : void 0,
+				...globalOptions
+			}
+		} : v, core.root),
+		fromFile
+	};
 }
 async function postInstall(pluginOptions = {}) {
-	const core = createViteCore(process.cwd(), pluginOptions);
-	await core.init({ config: buildConfig(await importConfigFile(core.configPath), process.cwd()) });
-	await core.emit({ write: true });
+	const managed = createManagedCore(process.cwd(), void 0, pluginOptions);
+	await managed.reload();
+	await managed.core.emit({ write: true });
 }
 function createViteCore(root, { index = true, configPath, outDir }) {
 	if (index === true) index = {};
@@ -149,4 +184,4 @@ function createViteCore(root, { index = true, configPath, outDir }) {
 	});
 }
 //#endregion
-export { mdx as default, postInstall };
+export { mdx as default, fumadocsMdx, postInstall };

package/dist/webpack/mdx.js

@@ -1,4 +1,4 @@
-import { t as createMdxLoader } from "../mdx-Bcb4tkWn.js";
+import { t as createMdxLoader } from "../mdx-3XO-apdE.js";
 import { i as toWebpack, o as createStandaloneConfigLoader } from "../adapter-DvWJNDHu.js";
 import { t as getCore } from "../webpack-BSog6pml.js";
 //#region src/webpack/mdx.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-mdx",
-  "version": "15.2.0",
+  "version": "15.2.1",
   "description": "The built-in source for Fumadocs",
   "keywords": [
     "Docs",
@@ -59,7 +59,7 @@
     "esbuild": "^0.28.1",
     "estree-util-value-to-estree": "^3.5.0",
     "github-slugger": "^2.0.0",
-    "magic-string": "^0.30.21",
+    "magic-string": "^1.1.0",
     "mdast-util-mdx": "^3.0.0",
     "picocolors": "^1.1.1",
     "picomatch": "^4.0.5",
@@ -70,31 +70,31 @@
     "unist-util-visit": "^5.1.0",
     "vfile": "^6.0.3",
     "yaml": "^2.9.0",
-    "yuku-analyzer": "^0.6.3",
+    "yuku-analyzer": "^0.8.1",
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "@types/bun": "^1.3.14",
     "@types/mdast": "^4.0.4",
     "@types/mdx": "^2.0.14",
-    "@types/node": "^26.1.1",
+    "@types/node": "^26.1.2",
     "@types/picomatch": "^4.0.3",
     "@types/react": "^19.2.17",
     "mdast-util-directive": "^3.1.0",
-    "next": "^16.2.10",
-    "react": "^19.2.7",
+    "next": "^16.2.12",
+    "react": "^19.2.8",
     "remark": "^15.0.1",
     "remark-directive": "^4.0.0",
     "remark-mdx": "^3.1.1",
-    "rolldown": "^1.1.5",
+    "rolldown": "^1.2.0",
     "satteri": "^0.9.5",
-    "tsdown": "0.22.5",
-    "vite": "^8.1.4",
-    "webpack": "^5.108.4",
-    "@fumadocs/satteri": "0.2.2",
+    "tsdown": "0.22.14",
+    "vite": "^8.1.5",
+    "webpack": "^5.109.2",
     "@fumadocs/vite": "0.1.0",
-    "fumadocs-core": "16.11.5",
-    "tsconfig": "0.0.0"
+    "tsconfig": "0.0.0",
+    "fumadocs-core": "16.14.0",
+    "@fumadocs/satteri": "0.3.1"
   },
   "peerDependencies": {
     "@fumadocs/satteri": "0.x.x",