fumadocs-mdx 12.0.0 → 12.0.2

package/dist/vite/index.cjs

@@ -30,7 +30,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/mdx/preset.ts
+// src/loaders/mdx/preset.ts
 var preset_exports = {};
 __export(preset_exports, {
   getDefaultMDXOptions: () => getDefaultMDXOptions
@@ -111,21 +111,12 @@ function getDefaultMDXOptions({
 }
 var plugins;
 var init_preset = __esm({
-  "src/mdx/preset.ts"() {
+  "src/loaders/mdx/preset.ts"() {
     "use strict";
     plugins = __toESM(require("fumadocs-core/mdx-plugins"), 1);
   }
 });
 
-// src/vite/index.ts
-var vite_exports = {};
-__export(vite_exports, {
-  default: () => mdx,
-  postInstall: () => postInstall
-});
-module.exports = __toCommonJS(vite_exports);
-var import_vite = require("vite");
-
 // src/config/build.ts
 function buildConfig(config) {
   const collections = /* @__PURE__ */ new Map();
@@ -175,8 +166,69 @@ function buildConfig(config) {
     }
   };
 }
+var init_build = __esm({
+  "src/config/build.ts"() {
+    "use strict";
+  }
+});
+
+// src/loaders/config/load.ts
+async function compileConfig(configPath, outDir) {
+  const { build } = await import("esbuild");
+  const transformed = await build({
+    entryPoints: [{ in: configPath, out: "source.config" }],
+    bundle: true,
+    outdir: outDir,
+    target: "node20",
+    write: true,
+    platform: "node",
+    format: "esm",
+    packages: "external",
+    outExtension: {
+      ".js": ".mjs"
+    },
+    allowOverwrite: true
+  });
+  if (transformed.errors.length > 0) {
+    throw new Error("failed to compile configuration file");
+  }
+}
+async function loadConfig(configPath, outDir, hash, build = false) {
+  if (cache3 && cache3.hash === hash) {
+    return await cache3.config;
+  }
+  if (build) await compileConfig(configPath, outDir);
+  const url = (0, import_node_url2.pathToFileURL)(path7.resolve(outDir, "source.config.mjs"));
+  const config = import(`${url.href}?hash=${hash}`).then((loaded) => {
+    return buildConfig(
+      // every call to `loadConfig` will cause the previous cache to be ignored
+      loaded
+    );
+  });
+  if (hash) cache3 = { config, hash };
+  return await config;
+}
+var fs4, path7, import_node_url2, cache3;
+var init_load = __esm({
+  "src/loaders/config/load.ts"() {
+    "use strict";
+    fs4 = __toESM(require("fs/promises"), 1);
+    path7 = __toESM(require("path"), 1);
+    import_node_url2 = require("url");
+    init_build();
+    cache3 = null;
+  }
+});
 
 // src/vite/index.ts
+var vite_exports = {};
+__export(vite_exports, {
+  default: () => mdx,
+  postInstall: () => postInstall
+});
+module.exports = __toCommonJS(vite_exports);
+var import_vite = require("vite");
+init_build();
 var import_node_querystring2 = require("querystring");
 
 // src/utils/validation.ts
@@ -219,7 +271,7 @@ async function validate(schema, data, context, errorMessage) {
 
 // src/vite/index.ts
 var fs6 = __toESM(require("fs/promises"), 1);
-var path8 = __toESM(require("path"), 1);
+var path9 = __toESM(require("path"), 1);
 var import_js_yaml2 = require("js-yaml");
 
 // src/utils/import-formatter.ts
@@ -393,19 +445,10 @@ async function getGitTimestamp(file) {
   }
 }
 
-// src/utils/count-lines.ts
-function countLines(s) {
-  let num = 0;
-  for (const c of s) {
-    if (c === "\n") num++;
-  }
-  return num;
-}
-
-// src/mdx/build-mdx.ts
+// src/loaders/mdx/build-mdx.ts
 var import_mdx = require("@mdx-js/mdx");
 
-// src/mdx/remark-include.ts
+// src/loaders/mdx/remark-include.ts
 var import_unified = require("unified");
 var import_unist_util_visit = require("unist-util-visit");
 var path3 = __toESM(require("path"), 1);
@@ -413,7 +456,28 @@ 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");
-var baseProcessor = (0, import_unified.unified)().use(import_mdx_plugins.remarkHeading);
+var ElementLikeTypes = [
+  "mdxJsxFlowElement",
+  "mdxJsxTextElement",
+  "containerDirective",
+  "textDirective",
+  "leafDirective"
+];
+function isElementLike(node) {
+  return ElementLikeTypes.includes(node.type);
+}
+function parseElementAttributes(element) {
+  if (Array.isArray(element.attributes)) {
+    const attributes = {};
+    for (const attr of element.attributes) {
+      if (attr.type === "mdxJsxAttribute" && (typeof attr.value === "string" || attr.value === null)) {
+        attributes[attr.name] = attr.value;
+      }
+    }
+    return attributes;
+  }
+  return element.attributes ?? {};
+}
 function flattenNode(node) {
   if ("children" in node)
     return node.children.map((child) => flattenNode(child)).join("");
@@ -430,21 +494,31 @@ function parseSpecifier(specifier) {
 }
 function extractSection(root, section) {
   let nodes;
-  for (const node of root.children) {
-    if (node.type === "mdxJsxFlowElement" && node.name === "section" && node.attributes.some(
-      (attr) => attr.type === "mdxJsxAttribute" && attr.name === "id" && attr.value === section
-    )) {
-      nodes = node.children;
-      break;
-    }
-    if (node.type === "heading" && node.data?.hProperties?.id === section) {
-      nodes = [node];
-      continue;
+  let capturingHeadingContent = false;
+  (0, import_unist_util_visit.visit)(root, (node) => {
+    if (node.type === "heading") {
+      if (capturingHeadingContent) {
+        return false;
+      }
+      if (node.data?.hProperties?.id === section) {
+        capturingHeadingContent = true;
+        nodes = [node];
+        return "skip";
+      }
+      return;
     }
-    if (!nodes) continue;
-    if (node.type === "heading") break;
-    nodes.push(node);
-  }
+    if (capturingHeadingContent) {
+      nodes?.push(node);
+      return "skip";
+    }
+    if (isElementLike(node) && node.name === "section") {
+      const attributes = parseElementAttributes(node);
+      if (attributes.id === section) {
+        nodes = node.children;
+        return false;
+      }
+    }
+  });
   if (nodes)
     return {
       type: "root",
@@ -476,55 +550,52 @@ ${e instanceof Error ? e.message : String(e)}`,
         data: {}
       };
     }
-    const processor = (data._getProcessor ?? getDefaultProcessor)(
+    const parser = (data._getProcessor ?? getDefaultProcessor)(
       ext === ".mdx" ? "mdx" : "md"
     );
-    let parsed = await baseProcessor.run(
-      processor.parse(fumaMatter(content).content)
-    );
+    const parsed = fumaMatter(content);
+    let mdast = parser.parse({
+      path: file,
+      value: parsed.content,
+      data: { frontmatter: parsed.data }
+    });
     if (heading) {
-      const extracted = extractSection(parsed, heading);
+      const extracted = extractSection(
+        await (0, import_unified.unified)().use(import_mdx_plugins.remarkHeading).run(mdast),
+        heading
+      );
       if (!extracted)
         throw new Error(
-          `Cannot find section ${heading} in ${file}, make sure you have encapsulated the section in a <section id="${heading}"> tag.`
+          `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.`
         );
-      parsed = extracted;
+      mdast = extracted;
     }
-    await update(parsed, path3.dirname(file), data);
-    return parsed;
+    await update(mdast, path3.dirname(file), data);
+    return mdast;
   }
   async function update(tree, directory, data) {
     const queue = [];
-    (0, import_unist_util_visit.visit)(
-      tree,
-      ["mdxJsxFlowElement", "mdxJsxTextElement"],
-      (_node, _, parent) => {
-        const node = _node;
-        if (node.name !== TagName) return;
-        const params = {};
-        const specifier = flattenNode(node);
-        if (specifier.length === 0) return "skip";
-        for (const attr of node.attributes) {
-          if (attr.type === "mdxJsxAttribute" && (typeof attr.value === "string" || attr.value === null)) {
-            params[attr.name] = attr.value;
-          }
-        }
-        const { file: relativePath, section } = parseSpecifier(specifier);
-        const file = path3.resolve(
-          "cwd" in params ? process.cwd() : directory,
-          relativePath
-        );
-        queue.push(
-          embedContent(file, section, params, data).then((replace) => {
-            Object.assign(
-              parent && parent.type === "paragraph" ? parent : node,
-              replace
-            );
-          })
-        );
-        return "skip";
-      }
-    );
+    (0, import_unist_util_visit.visit)(tree, ElementLikeTypes, (_node, _, parent) => {
+      const node = _node;
+      if (node.name !== TagName) return;
+      const specifier = flattenNode(node);
+      if (specifier.length === 0) return "skip";
+      const attributes = parseElementAttributes(node);
+      const { file: relativePath, section } = parseSpecifier(specifier);
+      const file = path3.resolve(
+        "cwd" in attributes ? process.cwd() : directory,
+        relativePath
+      );
+      queue.push(
+        embedContent(file, section, attributes, data).then((replace) => {
+          Object.assign(
+            parent && parent.type === "paragraph" ? parent : node,
+            replace
+          );
+        })
+      );
+      return "skip";
+    });
     await Promise.all(queue);
   }
   return async (tree, file) => {
@@ -537,7 +608,7 @@ function getDefaultProcessor(format) {
   return mdProcessor.use(import_remark_mdx.default);
 }
 
-// src/mdx/remark-postprocess.ts
+// src/loaders/mdx/remark-postprocess.ts
 var import_unist_util_visit2 = 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");
@@ -566,7 +637,7 @@ function remarkPostprocess({
     if (includeProcessedMarkdown) {
       file.data._markdown = (0, import_mdast_util_to_markdown.toMarkdown)(tree, {
         ...this.data("settings"),
-        // @ts-expect-error - from https://github.com/remarkjs/remark/blob/main/packages/remark-stringify/lib/index.js
+        // from https://github.com/remarkjs/remark/blob/main/packages/remark-stringify/lib/index.js
         extensions: this.data("toMarkdownExtensions") || []
       });
     }
@@ -620,7 +691,7 @@ function flattenNode2(node) {
   return "";
 }
 
-// src/mdx/build-mdx.ts
+// src/loaders/mdx/build-mdx.ts
 var cache2 = /* @__PURE__ */ new Map();
 async function buildMDX(cacheKey, source, options) {
   const { filePath, frontmatter, data, _compiler, ...rest } = options;
@@ -656,7 +727,7 @@ async function buildMDX(cacheKey, source, options) {
     return processor;
   }
   return getProcessor(
-    options.format ?? filePath.endsWith(".mdx") ? "mdx" : "md"
+    options.format ?? (filePath.endsWith(".mdx") ? "mdx" : "md")
   ).process({
     value: source,
     path: filePath,
@@ -669,7 +740,7 @@ async function buildMDX(cacheKey, source, options) {
   });
 }
 
-// src/loaders/mdx.ts
+// src/loaders/mdx/index.ts
 var import_zod = require("zod");
 var import_promises = __toESM(require("fs/promises"), 1);
 var import_node_path3 = __toESM(require("path"), 1);
@@ -768,52 +839,19 @@ function createMdxLoader(configLoader) {
 function generateCacheHash(input) {
   return (0, import_node_crypto.createHash)("md5").update(input).digest("hex");
 }
-
-// src/utils/config.ts
-var fs3 = __toESM(require("fs/promises"), 1);
-var path5 = __toESM(require("path"), 1);
-var import_node_url = require("url");
-function findConfigFile() {
-  return path5.resolve("source.config.ts");
-}
-var cache3 = null;
-async function compileConfig(configPath, outDir) {
-  const { build } = await import("esbuild");
-  const transformed = await build({
-    entryPoints: [{ in: configPath, out: "source.config" }],
-    bundle: true,
-    outdir: outDir,
-    target: "node20",
-    write: true,
-    platform: "node",
-    format: "esm",
-    packages: "external",
-    outExtension: {
-      ".js": ".mjs"
-    },
-    allowOverwrite: true
-  });
-  if (transformed.errors.length > 0) {
-    throw new Error("failed to compile configuration file");
-  }
-}
-async function loadConfig(configPath, outDir, hash, build = false) {
-  if (cache3 && cache3.hash === hash) {
-    return await cache3.config;
+function countLines(s) {
+  let num = 0;
+  for (const c of s) {
+    if (c === "\n") num++;
   }
-  if (build) await compileConfig(configPath, outDir);
-  const url = (0, import_node_url.pathToFileURL)(path5.resolve(outDir, "source.config.mjs"));
-  const config = import(`${url.href}?hash=${hash}`).then((loaded) => {
-    return buildConfig(
-      // every call to `loadConfig` will cause the previous cache to be ignored
-      loaded
-    );
-  });
-  if (hash) cache3 = { config, hash };
-  return await config;
+  return num;
 }
 
-// src/loaders/config-loader.ts
+// src/loaders/config/index.ts
+var import_node_path4 = __toESM(require("path"), 1);
+function findConfigFile() {
+  return import_node_path4.default.resolve("source.config.ts");
+}
 function resolvedConfig(loaded) {
   return {
     getConfig() {
@@ -823,10 +861,10 @@ function resolvedConfig(loaded) {
 }
 
 // src/loaders/adapter.ts
-var import_node_url2 = require("url");
+var import_node_url = require("url");
 var import_promises2 = __toESM(require("fs/promises"), 1);
 var import_node_querystring = require("querystring");
-var import_node_path4 = __toESM(require("path"), 1);
+var import_node_path5 = __toESM(require("path"), 1);
 function toVite(loader) {
   return async function(file, query, value) {
     const result = await loader({
@@ -848,8 +886,9 @@ function toVite(loader) {
 }
 
 // src/vite/postinstall.ts
+init_load();
 var import_promises3 = __toESM(require("fs/promises"), 1);
-var import_node_path5 = __toESM(require("path"), 1);
+var import_node_path6 = __toESM(require("path"), 1);
 async function postInstall(configPath = findConfigFile(), outDir, addJsExtension = false) {
   const config = await loadConfig(configPath, "node_modules", void 0, true);
   const outFile = "source.generated.ts";
@@ -857,7 +896,7 @@ async function postInstall(configPath = findConfigFile(), outDir, addJsExtension
     await import_promises3.default.mkdir(outDir, { recursive: true });
   }
   await import_promises3.default.writeFile(
-    outDir ? import_node_path5.default.join(outDir, outFile) : outFile,
+    outDir ? import_node_path6.default.join(outDir, outFile) : outFile,
     entry(configPath, config, outDir ?? process.cwd(), addJsExtension)
   );
   console.log("[MDX] types generated");
@@ -869,8 +908,8 @@ function mdx(config, options = {}) {
   const { generateIndexFile = true, configPath = "source.config.ts" } = options;
   const loaded = buildConfig(config);
   const mdxLoader = toVite(createMdxLoader(resolvedConfig(loaded)));
-  async function transformMeta(path9, query, value) {
-    const isJson = path9.endsWith(".json");
+  async function transformMeta(path10, query, value) {
+    const isJson = path10.endsWith(".json");
     const parsed = (0, import_node_querystring2.parse)(query);
     const collection = parsed.collection ? loaded.collections.get(parsed.collection) : void 0;
     if (!collection) return null;
@@ -893,8 +932,8 @@ function mdx(config, options = {}) {
     const out = await validate(
       schema,
       data,
-      { path: path9, source: value },
-      `invalid data in ${path9}`
+      { path: path10, source: value },
+      `invalid data in ${path10}`
     );
     return {
       code: isJson ? JSON.stringify(out) : `export default ${JSON.stringify(out)}`,
@@ -918,22 +957,15 @@ function mdx(config, options = {}) {
     },
     async buildStart() {
       if (!generateIndexFile) return;
+      const { out = "source.generated.ts", addJsExtension } = typeof generateIndexFile === "object" ? generateIndexFile : {};
       console.log("[Fumadocs MDX] Generating index files");
-      const outDir = process.cwd();
-      const outFile = "source.generated.ts";
-      await fs6.writeFile(
-        path8.join(outDir, outFile),
-        entry(
-          configPath,
-          loaded,
-          outDir,
-          typeof generateIndexFile === "object" ? generateIndexFile.addJsExtension : void 0
-        )
-      );
+      const dir = path9.dirname(out);
+      await fs6.mkdir(dir, { recursive: true });
+      await fs6.writeFile(out, entry(configPath, loaded, dir, addJsExtension));
     },
     async transform(value, id) {
       const [file, query = ""] = id.split("?");
-      const ext = path8.extname(file);
+      const ext = path9.extname(file);
       try {
         if ([".yaml", ".json"].includes(ext))
           return await transformMeta(file, query, value);

package/dist/vite/index.d.cts

@@ -9,6 +9,7 @@ interface PluginOptions {
      * @defaultValue true
      */
     generateIndexFile?: boolean | {
+        out?: string;
         /**
          * add `.js` extensions to imports, needed for ESM without bundler resolution
          */

package/dist/vite/index.d.ts

@@ -9,6 +9,7 @@ interface PluginOptions {
      * @defaultValue true
      */
     generateIndexFile?: boolean | {
+        out?: string;
         /**
          * add `.js` extensions to imports, needed for ESM without bundler resolution
          */

package/dist/vite/index.js

@@ -1,25 +1,27 @@
 import {
   entry,
   postInstall
-} from "../chunk-TLD6JMT6.js";
+} from "../chunk-ZX7TM4AR.js";
 import "../chunk-6Y5JDZHD.js";
+import "../chunk-LGYVNESJ.js";
+import {
+  buildConfig
+} from "../chunk-U4MQ44TS.js";
 import {
   toVite
 } from "../chunk-VXEBLM4X.js";
 import {
-  createMdxLoader,
-  resolvedConfig
-} from "../chunk-KGUBBRL6.js";
+  createMdxLoader
+} from "../chunk-RMDXSZYE.js";
+import "../chunk-QAUWMR5D.js";
+import "../chunk-LMG6UWCL.js";
 import {
   ValidationError,
   validate
 } from "../chunk-IQAEAI4P.js";
-import "../chunk-POXTQZ4D.js";
-import "../chunk-SWNOXPYJ.js";
-import "../chunk-KTDVTBMH.js";
 import {
-  buildConfig
-} from "../chunk-YC25YEBF.js";
+  resolvedConfig
+} from "../chunk-XMFLD5J6.js";
 import "../chunk-VWJKRQZR.js";
 
 // src/vite/index.ts
@@ -84,18 +86,11 @@ function mdx(config, options = {}) {
     },
     async buildStart() {
       if (!generateIndexFile) return;
+      const { out = "source.generated.ts", addJsExtension } = typeof generateIndexFile === "object" ? generateIndexFile : {};
       console.log("[Fumadocs MDX] Generating index files");
-      const outDir = process.cwd();
-      const outFile = "source.generated.ts";
-      await fs.writeFile(
-        path.join(outDir, outFile),
-        entry(
-          configPath,
-          loaded,
-          outDir,
-          typeof generateIndexFile === "object" ? generateIndexFile.addJsExtension : void 0
-        )
-      );
+      const dir = path.dirname(out);
+      await fs.mkdir(dir, { recursive: true });
+      await fs.writeFile(out, entry(configPath, loaded, dir, addJsExtension));
     },
     async transform(value, id) {
       const [file, query = ""] = id.split("?");

package/dist/{watcher-4NDMOH4R.js → watcher-HGOH3APP.js}

@@ -1,4 +1,4 @@
-// src/map/watcher.ts
+// src/next/map/watcher.ts
 import { FSWatcher } from "chokidar";
 function watcher(configPath, config, ignored) {
   const watcher2 = new FSWatcher({

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "fumadocs-mdx",
-  "version": "12.0.0",
+  "version": "12.0.2",
   "description": "The built-in source for Fumadocs",
   "keywords": [
     "NextJs",
     "Docs"
   ],
-  "homepage": "https://fumadocs.vercel.app",
+  "homepage": "https://fumadocs.dev",
   "repository": "github:fuma-nama/fumadocs",
   "license": "MIT",
   "author": "Fuma Nama",
@@ -29,6 +29,10 @@
       "require": "./dist/vite/index.cjs"
     },
     ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./runtime/next": {
       "import": "./dist/runtime/next/index.js",
       "types": "./dist/runtime/next/index.d.ts"
     },
@@ -61,10 +65,10 @@
     "@mdx-js/mdx": "^3.1.1",
     "@standard-schema/spec": "^1.0.0",
     "chokidar": "^4.0.3",
-    "esbuild": "^0.25.9",
+    "esbuild": "^0.25.10",
     "estree-util-value-to-estree": "^3.4.0",
     "js-yaml": "^4.1.0",
-    "lru-cache": "^11.2.1",
+    "lru-cache": "^11.2.2",
     "mdast-util-to-markdown": "^2.1.2",
     "picocolors": "^1.1.1",
     "remark-mdx": "^3.1.1",
@@ -73,25 +77,29 @@
     "tinyglobby": "^0.2.15",
     "unified": "^11.0.5",
     "unist-util-visit": "^5.0.0",
-    "zod": "^4.1.8"
+    "zod": "^4.1.11"
   },
   "devDependencies": {
-    "@types/bun": "^1.2.21",
+    "@types/bun": "^1.2.23",
     "@types/js-yaml": "^4.0.9",
     "@types/mdast": "^4.0.3",
     "@types/mdx": "^2.0.13",
-    "@types/node": "^24.3.3",
-    "@types/react": "^19.1.13",
+    "@types/node": "^24.6.2",
+    "@types/react": "^19.2.0",
+    "mdast-util-directive": "^3.1.0",
     "mdast-util-mdx-jsx": "^3.2.0",
-    "next": "^15.5.3",
-    "react": "^19.1.1",
-    "rollup": "^4.50.1",
+    "next": "^15.5.4",
+    "react": "^19.2.0",
+    "remark": "^15.0.1",
+    "remark-directive": "^4.0.0",
+    "remark-stringify": "^11.0.0",
+    "rollup": "^4.52.3",
     "vfile": "^6.0.3",
-    "vite": "^7.1.5",
-    "webpack": "^5.101.3",
-    "@fumadocs/mdx-remote": "1.4.0",
+    "vite": "^7.1.8",
+    "webpack": "^5.102.0",
+    "@fumadocs/mdx-remote": "1.4.1",
     "eslint-config-custom": "0.0.0",
-    "fumadocs-core": "15.7.13",
+    "fumadocs-core": "15.8.3",
     "tsconfig": "0.0.0"
   },
   "peerDependencies": {