fumadocs-mdx 12.0.3 → 13.0.1

package/dist/bin.js

@@ -3,14 +3,14 @@
 // src/bin.ts
 import { existsSync } from "fs";
 async function start() {
-  const args = process.argv.slice(2);
+  const [configPath] = process.argv.slice(2);
   const isNext = existsSync("next.config.js") || existsSync("next.config.mjs") || existsSync("next.config.ts");
   if (isNext) {
     const { postInstall } = await import("./next/index.js");
-    await postInstall(...args);
+    await postInstall(configPath);
   } else {
-    const { postInstall } = await import("./postinstall-SCSXM4IM.js");
-    await postInstall(...args);
+    const { postInstall } = await import("./vite/index.js");
+    await postInstall(configPath);
   }
 }
 void start();

package/dist/build-mdx-CCNr86q6.d.ts

@@ -0,0 +1,53 @@
+import { createProcessor } from '@mdx-js/mdx';
+import { StructuredData } from 'fumadocs-core/mdx-plugins';
+import { TOCItemType } from 'fumadocs-core/toc';
+import { FC } from 'react';
+import { MDXProps } from 'mdx/types';
+import { E as ExtractedReference } from './core-B6j6Fxse.js';
+
+type Processor = ReturnType<typeof createProcessor>;
+interface CompilerOptions {
+    addDependency: (file: string) => void;
+}
+interface CompiledMDXProperties<Frontmatter = Record<string, unknown>> {
+    frontmatter: Frontmatter;
+    structuredData: StructuredData;
+    toc: TOCItemType[];
+    default: FC<MDXProps>;
+    /**
+     * Only available when `lastModifiedTime` is enabled on MDX loader
+     */
+    lastModified?: Date;
+    extractedReferences?: ExtractedReference[];
+    _markdown?: string;
+    _mdast?: string;
+}
+interface FumadocsDataMap {
+    /**
+     * [Fumadocs MDX] raw frontmatter, you can modify it
+     */
+    frontmatter?: Record<string, unknown>;
+    /**
+     * [Fumadocs MDX] additional ESM exports to write
+     */
+    'mdx-export'?: {
+        name: string;
+        value: unknown;
+    }[];
+    extractedReferences: ExtractedReference[];
+    /**
+     * [Fumadocs MDX] The compiler object from loader
+     */
+    _compiler?: CompilerOptions;
+    _getProcessor?: (format: 'md' | 'mdx') => Processor;
+    /**
+     * [Fumadocs MDX] Processed Markdown content before `remark-rehype`.
+     */
+    _markdown?: string;
+}
+declare module 'vfile' {
+    interface DataMap extends FumadocsDataMap {
+    }
+}
+
+export type { CompiledMDXProperties as C };

package/dist/build-mdx-D-r3_eQL.d.cts

@@ -0,0 +1,53 @@
+import { createProcessor } from '@mdx-js/mdx';
+import { StructuredData } from 'fumadocs-core/mdx-plugins';
+import { TOCItemType } from 'fumadocs-core/toc';
+import { FC } from 'react';
+import { MDXProps } from 'mdx/types';
+import { E as ExtractedReference } from './core-B6j6Fxse.cjs';
+
+type Processor = ReturnType<typeof createProcessor>;
+interface CompilerOptions {
+    addDependency: (file: string) => void;
+}
+interface CompiledMDXProperties<Frontmatter = Record<string, unknown>> {
+    frontmatter: Frontmatter;
+    structuredData: StructuredData;
+    toc: TOCItemType[];
+    default: FC<MDXProps>;
+    /**
+     * Only available when `lastModifiedTime` is enabled on MDX loader
+     */
+    lastModified?: Date;
+    extractedReferences?: ExtractedReference[];
+    _markdown?: string;
+    _mdast?: string;
+}
+interface FumadocsDataMap {
+    /**
+     * [Fumadocs MDX] raw frontmatter, you can modify it
+     */
+    frontmatter?: Record<string, unknown>;
+    /**
+     * [Fumadocs MDX] additional ESM exports to write
+     */
+    'mdx-export'?: {
+        name: string;
+        value: unknown;
+    }[];
+    extractedReferences: ExtractedReference[];
+    /**
+     * [Fumadocs MDX] The compiler object from loader
+     */
+    _compiler?: CompilerOptions;
+    _getProcessor?: (format: 'md' | 'mdx') => Processor;
+    /**
+     * [Fumadocs MDX] Processed Markdown content before `remark-rehype`.
+     */
+    _markdown?: string;
+}
+declare module 'vfile' {
+    interface DataMap extends FumadocsDataMap {
+    }
+}
+
+export type { CompiledMDXProperties as C };

package/dist/bun/index.cjs

@@ -261,12 +261,56 @@ var import_mdx = require("@mdx-js/mdx");
 
 // src/loaders/mdx/remark-include.ts
 var import_unified = require("unified");
-var import_unist_util_visit = require("unist-util-visit");
+var import_unist_util_visit2 = require("unist-util-visit");
 var path2 = __toESM(require("path"), 1);
 var fs = __toESM(require("fs/promises"), 1);
-var import_remark_parse = __toESM(require("remark-parse"), 1);
-var import_remark_mdx = __toESM(require("remark-mdx"), 1);
 var import_mdx_plugins = require("fumadocs-core/mdx-plugins");
+
+// src/loaders/mdx/remark-unravel.ts
+var import_unist_util_visit = require("unist-util-visit");
+function remarkMarkAndUnravel() {
+  return (tree) => {
+    (0, import_unist_util_visit.visit)(tree, function(node, index, parent) {
+      let offset = -1;
+      let all = true;
+      let oneOrMore = false;
+      if (parent && typeof index === "number" && node.type === "paragraph") {
+        const children = node.children;
+        while (++offset < children.length) {
+          const child = children[offset];
+          if (child.type === "mdxJsxTextElement" || child.type === "mdxTextExpression") {
+            oneOrMore = true;
+          } else if (child.type === "text" && child.value.trim().length === 0) {
+          } else {
+            all = false;
+            break;
+          }
+        }
+        if (all && oneOrMore) {
+          offset = -1;
+          const newChildren = [];
+          while (++offset < children.length) {
+            const child = children[offset];
+            if (child.type === "mdxJsxTextElement") {
+              child.type = "mdxJsxFlowElement";
+            }
+            if (child.type === "mdxTextExpression") {
+              child.type = "mdxFlowExpression";
+            }
+            if (child.type === "text" && /^[\t\r\n ]+$/.test(String(child.value))) {
+            } else {
+              newChildren.push(child);
+            }
+          }
+          parent.children.splice(index, 1, ...newChildren);
+          return index;
+        }
+      }
+    });
+  };
+}
+
+// src/loaders/mdx/remark-include.ts
 var ElementLikeTypes = [
   "mdxJsxFlowElement",
   "mdxJsxTextElement",
@@ -306,7 +350,7 @@ function parseSpecifier(specifier) {
 function extractSection(root, section) {
   let nodes;
   let capturingHeadingContent = false;
-  (0, import_unist_util_visit.visit)(root, (node) => {
+  (0, import_unist_util_visit2.visit)(root, (node) => {
     if (node.type === "heading") {
       if (capturingHeadingContent) {
         return false;
@@ -338,7 +382,7 @@ function extractSection(root, section) {
 }
 function remarkInclude() {
   const TagName = "include";
-  async function embedContent(file, heading, params, data) {
+  const embedContent = async (file, heading, params, data) => {
     let content;
     try {
       content = (await fs.readFile(file)).toString();
@@ -361,18 +405,17 @@ ${e instanceof Error ? e.message : String(e)}`,
         data: {}
       };
     }
-    const parser = (data._getProcessor ?? getDefaultProcessor)(
-      ext === ".mdx" ? "mdx" : "md"
-    );
+    const parser = data._getProcessor ? data._getProcessor(ext === ".mdx" ? "mdx" : "md") : this;
     const parsed = fumaMatter(content);
     let mdast = parser.parse({
       path: file,
       value: parsed.content,
       data: { frontmatter: parsed.data }
     });
+    const baseProcessor = (0, import_unified.unified)().use(remarkMarkAndUnravel);
     if (heading) {
       const extracted = extractSection(
-        await (0, import_unified.unified)().use(import_mdx_plugins.remarkHeading).run(mdast),
+        await baseProcessor.use(import_mdx_plugins.remarkHeading).run(mdast),
         heading
       );
       if (!extracted)
@@ -380,13 +423,15 @@ ${e instanceof Error ? e.message : String(e)}`,
           `Cannot find section ${heading} in ${file}, make sure you have encapsulated the section in a <section id="${heading}"> tag, or a :::section directive with remark-directive configured.`
         );
       mdast = extracted;
+    } else {
+      mdast = await baseProcessor.run(mdast);
     }
     await update(mdast, path2.dirname(file), data);
     return mdast;
-  }
+  };
   async function update(tree, directory, data) {
     const queue = [];
-    (0, import_unist_util_visit.visit)(tree, ElementLikeTypes, (_node, _, parent) => {
+    (0, import_unist_util_visit2.visit)(tree, ElementLikeTypes, (_node, _, parent) => {
       const node = _node;
       if (node.name !== TagName) return;
       const specifier = flattenNode(node);
@@ -413,24 +458,28 @@ ${e instanceof Error ? e.message : String(e)}`,
     await update(tree, path2.dirname(file.path), file.data);
   };
 }
-function getDefaultProcessor(format) {
-  const mdProcessor = (0, import_unified.unified)().use(import_remark_parse.default);
-  if (format === "md") return mdProcessor;
-  return mdProcessor.use(import_remark_mdx.default);
-}
 
 // src/loaders/mdx/remark-postprocess.ts
-var import_unist_util_visit2 = require("unist-util-visit");
+var import_unist_util_visit3 = require("unist-util-visit");
 var import_mdast_util_to_markdown = require("mdast-util-to-markdown");
 var import_estree_util_value_to_estree = require("estree-util-value-to-estree");
+var import_unist_util_remove_position = require("unist-util-remove-position");
+var import_remark_mdx = __toESM(require("remark-mdx"), 1);
 function remarkPostprocess({
+  _format,
   includeProcessedMarkdown = false,
+  includeMDAST = false,
   valueToExport = []
-} = {}) {
+}) {
+  let _stringifyProcessor;
+  const getStringifyProcessor = () => {
+    if (_format === "mdx") return this;
+    return _stringifyProcessor ??= this().use(import_remark_mdx.default).freeze();
+  };
   return (tree, file) => {
     let title;
     const urls = [];
-    (0, import_unist_util_visit2.visit)(tree, ["heading", "link"], (node) => {
+    (0, import_unist_util_visit3.visit)(tree, ["heading", "link"], (node) => {
       if (node.type === "heading" && node.depth === 1) {
         title = flattenNode2(node);
       }
@@ -446,12 +495,19 @@ function remarkPostprocess({
     }
     file.data.extractedReferences = urls;
     if (includeProcessedMarkdown) {
+      const processor = getStringifyProcessor();
       file.data._markdown = (0, import_mdast_util_to_markdown.toMarkdown)(tree, {
-        ...this.data("settings"),
+        ...processor.data("settings"),
         // from https://github.com/remarkjs/remark/blob/main/packages/remark-stringify/lib/index.js
-        extensions: this.data("toMarkdownExtensions") || []
+        extensions: processor.data("toMarkdownExtensions") || []
       });
     }
+    if (includeMDAST) {
+      const options = includeMDAST === true ? {} : includeMDAST;
+      file.data._mdast = JSON.stringify(
+        options.removePosition ? (0, import_unist_util_remove_position.removePosition)(structuredClone(tree)) : tree
+      );
+    }
     for (const { name, value } of file.data["mdx-export"] ?? []) {
       tree.children.unshift(getMdastExport(name, value));
     }
@@ -519,6 +575,7 @@ async function buildMDX(cacheKey, source, options) {
           [
             remarkPostprocess,
             {
+              _format: format,
               ...options.postprocess,
               valueToExport: [
                 ...options.postprocess?.valueToExport ?? [],
@@ -526,7 +583,8 @@ async function buildMDX(cacheKey, source, options) {
                 "extractedReferences",
                 "frontmatter",
                 "lastModified",
-                "_markdown"
+                "_markdown",
+                "_mdast"
               ]
             }
           ]
@@ -558,10 +616,7 @@ var import_node_path2 = __toESM(require("path"), 1);
 var import_node_crypto = require("crypto");
 var querySchema = import_zod.z.object({
   only: import_zod.z.literal(["frontmatter", "all"]).default("all"),
-  collection: import_zod.z.string().optional(),
-  hash: import_zod.z.string().describe(
-    "the hash of config, used for revalidation on Turbopack/Webpack."
-  ).optional()
+  collection: import_zod.z.string().optional()
 }).loose();
 var cacheEntry = import_zod.z.object({
   code: import_zod.z.string(),
@@ -578,14 +633,25 @@ function createMdxLoader(configLoader) {
   }) => {
     const matter = fumaMatter(value);
     const parsed = querySchema.parse(query);
-    const loaded = await configLoader.getConfig(parsed.hash);
-    const cacheDir = isDevelopment ? void 0 : loaded.global.experimentalBuildCache;
-    const cacheKey = `${parsed.hash}_${parsed.collection ?? "global"}_${generateCacheHash(filePath)}`;
-    if (cacheDir) {
+    const config = await configLoader.getConfig();
+    let after;
+    if (!isDevelopment && config.global.experimentalBuildCache) {
+      const cacheDir = config.global.experimentalBuildCache;
+      const cacheKey = `${parsed.hash}_${parsed.collection ?? "global"}_${generateCacheHash(filePath)}`;
       const cached = await import_promises.default.readFile(import_node_path2.default.join(cacheDir, cacheKey)).then((content) => cacheEntry.parse(JSON.parse(content.toString()))).catch(() => null);
       if (cached && cached.hash === generateCacheHash(value)) return cached;
+      after = async () => {
+        await import_promises.default.mkdir(cacheDir, { recursive: true });
+        await import_promises.default.writeFile(
+          import_node_path2.default.join(cacheDir, cacheKey),
+          JSON.stringify({
+            ...out,
+            hash: generateCacheHash(value)
+          })
+        );
+      };
     }
-    const collection = parsed.collection ? loaded.collections.get(parsed.collection) : void 0;
+    const collection = parsed.collection ? config.collections.get(parsed.collection) : void 0;
     let docCollection;
     switch (collection?.type) {
       case "doc":
@@ -613,16 +679,16 @@ function createMdxLoader(configLoader) {
       };
     }
     const data = {};
-    if (loaded.global.lastModifiedTime === "git") {
+    if (config.global.lastModifiedTime === "git") {
       data.lastModified = (await getGitTimestamp(filePath))?.getTime();
     }
     const lineOffset = isDevelopment ? countLines(matter.matter) : 0;
     const compiled = await buildMDX(
-      `${parsed.hash ?? ""}:${parsed.collection ?? "global"}`,
+      `${getConfigHash(config)}:${parsed.collection ?? "global"}`,
       "\n".repeat(lineOffset) + matter.content,
       {
         development: isDevelopment,
-        ...docCollection?.mdxOptions ?? await loaded.getDefaultMDXOptions(),
+        ...docCollection?.mdxOptions ?? await config.getDefaultMDXOptions(),
         postprocess: docCollection?.postprocess,
         data,
         filePath,
@@ -634,19 +700,18 @@ function createMdxLoader(configLoader) {
       code: String(compiled.value),
       map: compiled.map
     };
-    if (cacheDir) {
-      await import_promises.default.mkdir(cacheDir, { recursive: true });
-      await import_promises.default.writeFile(
-        import_node_path2.default.join(cacheDir, cacheKey),
-        JSON.stringify({
-          ...out,
-          hash: generateCacheHash(value)
-        })
-      );
-    }
+    await after?.();
     return out;
   };
 }
+var hashes = /* @__PURE__ */ new WeakMap();
+function getConfigHash(config) {
+  let hash = hashes.get(config);
+  if (hash) return hash;
+  hash = Date.now().toString();
+  hashes.set(config, hash);
+  return hash;
+}
 function generateCacheHash(input) {
   return (0, import_node_crypto.createHash)("md5").update(input).digest("hex");
 }
@@ -660,27 +725,106 @@ function countLines(s) {
 
 // src/loaders/config/index.ts
 var import_node_path3 = __toESM(require("path"), 1);
+var import_promises2 = __toESM(require("fs/promises"), 1);
 function findConfigFile() {
   return import_node_path3.default.resolve("source.config.ts");
 }
-function resolvedConfig(loaded) {
+
+// src/bun/index.ts
+init_build();
+var import_node_querystring = require("querystring");
+var import_node_url = require("url");
+
+// src/core.ts
+var import_node_path4 = __toESM(require("path"), 1);
+var import_promises3 = __toESM(require("fs/promises"), 1);
+function createCore(options, defaultPlugins = []) {
+  let config;
+  let plugins2;
   return {
+    _options: options,
+    getPluginContext() {
+      return {
+        core: this,
+        ...options
+      };
+    },
+    /**
+     * Convenient cache store, reset when config changes
+     */
+    cache: /* @__PURE__ */ new Map(),
+    async init({ config: newConfig }) {
+      config = await newConfig;
+      this.cache.clear();
+      plugins2 = [];
+      for await (const option of [
+        ...defaultPlugins,
+        ...config.global.plugins ?? []
+      ]) {
+        if (!option) continue;
+        if (Array.isArray(option)) plugins2.push(...option);
+        else plugins2.push(option);
+      }
+      for (const plugin of plugins2) {
+        const out = await plugin.config?.call(this.getPluginContext(), config);
+        if (out) config = out;
+      }
+      return this;
+    },
     getConfig() {
-      return loaded;
+      return config;
+    },
+    creatConfigLoader() {
+      return {
+        getConfig() {
+          return config;
+        }
+      };
+    },
+    async initServer(server) {
+      for (const plugin of plugins2) {
+        await plugin.configureServer?.call(this.getPluginContext(), server);
+      }
+    },
+    async emitAndWrite({
+      filterPlugin = () => true
+    } = {}) {
+      const start = performance.now();
+      const out = await Promise.all(
+        plugins2.map((plugin) => {
+          if (!filterPlugin(plugin) || !plugin.emit) return [];
+          return plugin.emit.call(this.getPluginContext());
+        })
+      );
+      await Promise.all(
+        out.flat().map(async (entry) => {
+          const file = import_node_path4.default.join(options.outDir, entry.path);
+          await import_promises3.default.mkdir(import_node_path4.default.dirname(file), { recursive: true });
+          await import_promises3.default.writeFile(file, entry.content);
+        })
+      );
+      console.log(`[MDX] generated files in ${performance.now() - start}ms`);
     }
   };
 }
 
 // src/bun/index.ts
-init_build();
-var import_node_querystring = require("querystring");
-var import_node_url = require("url");
 function createMdxPlugin(options = {}) {
-  const { configPath = findConfigFile() } = options;
+  const {
+    environment = "bun",
+    outDir = ".source",
+    configPath = findConfigFile()
+  } = options;
   async function getMdxLoader() {
     const importPath = (0, import_node_url.pathToFileURL)(configPath).href;
-    const out = buildConfig(await import(importPath));
-    return createMdxLoader(resolvedConfig(out));
+    const core = await createCore({
+      environment,
+      outDir,
+      configPath
+    }).init({
+      config: buildConfig(await import(importPath))
+    });
+    return createMdxLoader(core.creatConfigLoader());
   }
   return {
     name: "bun-plugin-fumadocs-mdx",

package/dist/bun/index.d.cts

@@ -1,8 +1,13 @@
 import { BunPlugin } from 'bun';
+import { C as CoreOptions } from '../core-B6j6Fxse.cjs';
+import '@standard-schema/spec';
+import 'fumadocs-core/mdx-plugins';
+import '@mdx-js/mdx';
+import 'unified';
+import 'zod';
+import 'chokidar';
 
-interface MdxPluginOptions {
-    configPath?: string;
-}
+type MdxPluginOptions = Partial<CoreOptions>;
 declare function createMdxPlugin(options?: MdxPluginOptions): BunPlugin;
 
 export { type MdxPluginOptions, createMdxPlugin };

package/dist/bun/index.d.ts

@@ -1,8 +1,13 @@
 import { BunPlugin } from 'bun';
+import { C as CoreOptions } from '../core-B6j6Fxse.js';
+import '@standard-schema/spec';
+import 'fumadocs-core/mdx-plugins';
+import '@mdx-js/mdx';
+import 'unified';
+import 'zod';
+import 'chokidar';
 
-interface MdxPluginOptions {
-    configPath?: string;
-}
+type MdxPluginOptions = Partial<CoreOptions>;
 declare function createMdxPlugin(options?: MdxPluginOptions): BunPlugin;
 
 export { type MdxPluginOptions, createMdxPlugin };

package/dist/bun/index.js

@@ -3,25 +3,34 @@ import {
 } from "../chunk-U4MQ44TS.js";
 import {
   createMdxLoader
-} from "../chunk-RMDXSZYE.js";
-import "../chunk-QAUWMR5D.js";
-import "../chunk-LMG6UWCL.js";
-import "../chunk-IQAEAI4P.js";
+} from "../chunk-XQ5O7IPO.js";
+import "../chunk-3J3WL7WN.js";
+import "../chunk-K5ZLPEIQ.js";
 import {
-  findConfigFile,
-  resolvedConfig
-} from "../chunk-XMFLD5J6.js";
+  createCore,
+  findConfigFile
+} from "../chunk-EELYB2XC.js";
 import "../chunk-VWJKRQZR.js";
 
 // src/bun/index.ts
 import { parse } from "querystring";
 import { pathToFileURL } from "url";
 function createMdxPlugin(options = {}) {
-  const { configPath = findConfigFile() } = options;
+  const {
+    environment = "bun",
+    outDir = ".source",
+    configPath = findConfigFile()
+  } = options;
   async function getMdxLoader() {
     const importPath = pathToFileURL(configPath).href;
-    const out = buildConfig(await import(importPath));
-    return createMdxLoader(resolvedConfig(out));
+    const core = await createCore({
+      environment,
+      outDir,
+      configPath
+    }).init({
+      config: buildConfig(await import(importPath))
+    });
+    return createMdxLoader(core.creatConfigLoader());
   }
   return {
     name: "bun-plugin-fumadocs-mdx",

package/dist/{chunk-QAUWMR5D.js → chunk-3J3WL7WN.js}

@@ -1,6 +1,6 @@
 import {
   remarkInclude
-} from "./chunk-LMG6UWCL.js";
+} from "./chunk-K5ZLPEIQ.js";
 
 // src/loaders/mdx/build-mdx.ts
 import { createProcessor } from "@mdx-js/mdx";
@@ -9,10 +9,19 @@ import { createProcessor } from "@mdx-js/mdx";
 import { visit } from "unist-util-visit";
 import { toMarkdown } from "mdast-util-to-markdown";
 import { valueToEstree } from "estree-util-value-to-estree";
+import { removePosition } from "unist-util-remove-position";
+import remarkMdx from "remark-mdx";
 function remarkPostprocess({
+  _format,
   includeProcessedMarkdown = false,
+  includeMDAST = false,
   valueToExport = []
-} = {}) {
+}) {
+  let _stringifyProcessor;
+  const getStringifyProcessor = () => {
+    if (_format === "mdx") return this;
+    return _stringifyProcessor ??= this().use(remarkMdx).freeze();
+  };
   return (tree, file) => {
     let title;
     const urls = [];
@@ -32,12 +41,19 @@ function remarkPostprocess({
     }
     file.data.extractedReferences = urls;
     if (includeProcessedMarkdown) {
+      const processor = getStringifyProcessor();
       file.data._markdown = toMarkdown(tree, {
-        ...this.data("settings"),
+        ...processor.data("settings"),
         // from https://github.com/remarkjs/remark/blob/main/packages/remark-stringify/lib/index.js
-        extensions: this.data("toMarkdownExtensions") || []
+        extensions: processor.data("toMarkdownExtensions") || []
       });
     }
+    if (includeMDAST) {
+      const options = includeMDAST === true ? {} : includeMDAST;
+      file.data._mdast = JSON.stringify(
+        options.removePosition ? removePosition(structuredClone(tree)) : tree
+      );
+    }
     for (const { name, value } of file.data["mdx-export"] ?? []) {
       tree.children.unshift(getMdastExport(name, value));
     }
@@ -105,6 +121,7 @@ async function buildMDX(cacheKey, source, options) {
           [
             remarkPostprocess,
             {
+              _format: format,
               ...options.postprocess,
               valueToExport: [
                 ...options.postprocess?.valueToExport ?? [],
@@ -112,7 +129,8 @@ async function buildMDX(cacheKey, source, options) {
                 "extractedReferences",
                 "frontmatter",
                 "lastModified",
-                "_markdown"
+                "_markdown",
+                "_mdast"
               ]
             }
           ]