fumadocs-mdx 11.8.1 → 11.8.3

package/dist/config/zod-3.cjs

@@ -94,16 +94,42 @@ function defineConfig(config = {}) {
 // src/utils/mdx-options.ts
 var plugins = __toESM(require("fumadocs-core/mdx-plugins"), 1);
 
-// src/mdx-plugins/remark-exports.ts
+// src/mdx-plugins/remark-postprocess.ts
+var import_unist_util_visit = require("unist-util-visit");
 var import_estree_util_value_to_estree = require("estree-util-value-to-estree");
-function remarkMdxExport({ values }) {
-  return (tree, vfile) => {
-    for (const name of values) {
-      if (!(name in vfile.data)) continue;
-      tree.children.unshift(getMdastExport(name, vfile.data[name]));
+function remarkPostprocess({
+  injectExports
+}) {
+  return (tree, file) => {
+    let title;
+    const urls = [];
+    (0, import_unist_util_visit.visit)(tree, ["heading", "link"], (node) => {
+      if (node.type === "heading" && node.depth === 1) {
+        title = flattenNode(node);
+      }
+      if (node.type !== "link") return;
+      urls.push({
+        href: node.url
+      });
+      return "skip";
+    });
+    if (title) {
+      file.data.frontmatter ??= {};
+      if (!file.data.frontmatter.title) file.data.frontmatter.title = title;
+    }
+    file.data.extractedReferences = urls;
+    for (const name of injectExports) {
+      if (!(name in file.data)) continue;
+      tree.children.unshift(getMdastExport(name, file.data[name]));
     }
   };
 }
+function flattenNode(node) {
+  if ("children" in node)
+    return node.children.map((child) => flattenNode(child)).join("");
+  if ("value" in node) return node.value;
+  return "";
+}
 function getMdastExport(name, value) {
   return {
     type: "mdxjsEsm",
@@ -115,6 +141,7 @@ function getMdastExport(name, value) {
         body: [
           {
             type: "ExportNamedDeclaration",
+            attributes: [],
             specifiers: [],
             source: null,
             declaration: {
@@ -138,21 +165,6 @@ function getMdastExport(name, value) {
   };
 }
 
-// src/mdx-plugins/remark-extract.ts
-var import_unist_util_visit = require("unist-util-visit");
-function remarkExtract() {
-  return (tree, file) => {
-    const urls = [];
-    (0, import_unist_util_visit.visit)(tree, "link", (node) => {
-      urls.push({
-        href: node.url
-      });
-      return "skip";
-    });
-    file.data.extractedReferences = urls;
-  };
-}
-
 // src/utils/mdx-options.ts
 function pluginOption(def, options = []) {
   const list = def(Array.isArray(options) ? options : []).filter(
@@ -204,12 +216,14 @@ function getDefaultMDXOptions({
       ],
       "remarkNpm" in plugins && remarkNpmOptions !== false && [plugins.remarkNpm, remarkNpmOptions],
       ...v,
-      remarkExtract,
       remarkStructureOptions !== false && [
         plugins.remarkStructure,
         remarkStructureOptions
       ],
-      [remarkMdxExport, { values: mdxExports }]
+      [
+        remarkPostprocess,
+        { injectExports: mdxExports }
+      ]
     ],
     mdxOptions.remarkPlugins
   );
@@ -230,6 +244,7 @@ function getDefaultMDXOptions({
 }
 
 // src/mdx-plugins/remark-include.ts
+var import_unified = require("unified");
 var import_unist_util_visit2 = require("unist-util-visit");
 var path = __toESM(require("path"), 1);
 var fs = __toESM(require("fs/promises"), 1);
@@ -251,9 +266,13 @@ function fumaMatter(input) {
 }
 
 // src/mdx-plugins/remark-include.ts
-function flattenNode(node) {
+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);
+function flattenNode2(node) {
   if ("children" in node)
-    return node.children.map((child) => flattenNode(child)).join("");
+    return node.children.map((child) => flattenNode2(child)).join("");
   if ("value" in node) return node.value;
   return "";
 }
@@ -266,86 +285,96 @@ 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
     )) {
-      return {
-        type: "root",
-        children: node.children
-      };
+      nodes = node.children;
+      break;
+    }
+    if (node.type === "heading" && node.data?.hProperties?.id === section) {
+      nodes = [node];
+      continue;
     }
+    if (!nodes) continue;
+    if (node.type === "heading") break;
+    nodes.push(node);
   }
+  if (nodes)
+    return {
+      type: "root",
+      children: nodes
+    };
 }
 function remarkInclude() {
   const TagName = "include";
+  async function embedContent(file, heading, params, data) {
+    let content;
+    try {
+      content = (await fs.readFile(file)).toString();
+    } catch (e) {
+      throw new Error(
+        `failed to read file ${file}
+${e instanceof Error ? e.message : String(e)}`,
+        { cause: e }
+      );
+    }
+    const ext = path.extname(file);
+    data._compiler?.addDependency(file);
+    if (params.lang || ext !== ".md" && ext !== ".mdx") {
+      const lang = params.lang ?? ext.slice(1);
+      return {
+        type: "code",
+        lang,
+        meta: params.meta,
+        value: content,
+        data: {}
+      };
+    }
+    const processor = (data._getProcessor ?? getDefaultProcessor)(
+      ext === ".mdx" ? "mdx" : "md"
+    );
+    let parsed = await baseProcessor.run(
+      processor.parse(fumaMatter(content).content)
+    );
+    if (heading) {
+      const extracted = extractSection(parsed, 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.`
+        );
+      parsed = extracted;
+    }
+    await update(parsed, path.dirname(file), data);
+    return parsed;
+  }
   async function update(tree, directory, data) {
     const queue = [];
     (0, import_unist_util_visit2.visit)(
       tree,
       ["mdxJsxFlowElement", "mdxJsxTextElement"],
-      (node, _, parent) => {
-        let specifier;
+      (_node, _, parent) => {
+        const node = _node;
+        if (node.name !== TagName) return;
         const params = {};
-        if ((node.type === "mdxJsxFlowElement" || node.type === "mdxJsxTextElement") && node.name === TagName) {
-          const value = flattenNode(node);
-          if (value.length > 0) {
-            for (const attr of node.attributes) {
-              if (attr.type === "mdxJsxAttribute" && (typeof attr.value === "string" || attr.value === null)) {
-                params[attr.name] = attr.value;
-              }
-            }
-            specifier = value;
+        const specifier = flattenNode2(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;
           }
         }
-        if (!specifier) return;
-        const { file, section } = parseSpecifier(specifier);
-        const targetPath = path.resolve(
+        const { file: relativePath, section } = parseSpecifier(specifier);
+        const file = path.resolve(
           "cwd" in params ? process.cwd() : directory,
-          file
+          relativePath
         );
-        const asCode = params.lang || !file.endsWith(".md") && !file.endsWith(".mdx");
         queue.push(
-          fs.readFile(targetPath).then((buffer) => buffer.toString()).then(async (content) => {
-            data._compiler?.addDependency(targetPath);
-            if (asCode) {
-              const lang = params.lang ?? path.extname(file).slice(1);
-              Object.assign(node, {
-                type: "code",
-                lang,
-                meta: params.meta,
-                value: content,
-                data: {}
-              });
-              return;
-            }
-            const processor = data._processor ? data._processor.getProcessor(
-              targetPath.endsWith(".md") ? "md" : "mdx"
-            ) : this;
-            let parsed = processor.parse(fumaMatter(content).content);
-            if (section) {
-              const extracted = extractSection(parsed, section);
-              if (!extracted)
-                throw new Error(
-                  `Cannot find section ${section} in ${file}, make sure you have encapsulated the section in a <section id="${section}"> tag`
-                );
-              parsed = extracted;
-            }
-            await update.call(
-              processor,
-              parsed,
-              path.dirname(targetPath),
-              data
-            );
+          embedContent(file, section, params, data).then((replace) => {
             Object.assign(
               parent && parent.type === "paragraph" ? parent : node,
-              parsed
-            );
-          }).catch((e) => {
-            throw new Error(
-              `failed to read file ${targetPath}
-${e instanceof Error ? e.message : String(e)}`,
-              { cause: e }
+              replace
             );
           })
         );
@@ -355,9 +384,14 @@ ${e instanceof Error ? e.message : String(e)}`,
     await Promise.all(queue);
   }
   return async (tree, file) => {
-    await update.call(this, tree, path.dirname(file.path), file.data);
+    await update(tree, path.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/config/zod-3.ts
 var metaSchema2 = import_v3.z.object({

package/dist/config/zod-3.d.cts

@@ -1,6 +1,6 @@
 import { z } from 'zod/v3';
-export { A as AnyCollection, B as BaseCollection, C as CollectionSchema, D as DefaultMDXOptions, a as DocCollection, b as DocsCollection, G as GlobalConfig, M as MetaCollection, d as defineCollections, e as defineConfig, c as defineDocs, g as getDefaultMDXOptions } from '../define-DnJzAZrj.cjs';
-export { remarkInclude } from './index.cjs';
+export { A as AnyCollection, B as BaseCollection, C as CollectionSchema, b as DefaultMDXOptions, D as DocCollection, a as DocsCollection, G as GlobalConfig, M as MetaCollection, d as defineCollections, e as defineConfig, c as defineDocs, g as getDefaultMDXOptions } from '../define-DAZmbu3U.cjs';
+export { Params, remarkInclude } from './index.cjs';
 import '@standard-schema/spec';
 import 'fumadocs-core/mdx-plugins';
 import '@mdx-js/mdx';

package/dist/config/zod-3.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod/v3';
-export { A as AnyCollection, B as BaseCollection, C as CollectionSchema, D as DefaultMDXOptions, a as DocCollection, b as DocsCollection, G as GlobalConfig, M as MetaCollection, d as defineCollections, e as defineConfig, c as defineDocs, g as getDefaultMDXOptions } from '../define-DnJzAZrj.js';
-export { remarkInclude } from './index.js';
+export { A as AnyCollection, B as BaseCollection, C as CollectionSchema, b as DefaultMDXOptions, D as DocCollection, a as DocsCollection, G as GlobalConfig, M as MetaCollection, d as defineCollections, e as defineConfig, c as defineDocs, g as getDefaultMDXOptions } from '../define-DAZmbu3U.js';
+export { Params, remarkInclude } from './index.js';
 import '@standard-schema/spec';
 import 'fumadocs-core/mdx-plugins';
 import '@mdx-js/mdx';

package/dist/config/zod-3.js

@@ -5,10 +5,10 @@ import {
 } from "../chunk-GBMFGEC7.js";
 import {
   getDefaultMDXOptions
-} from "../chunk-DJNS22RO.js";
+} from "../chunk-SMSNZ6N5.js";
 import {
   remarkInclude
-} from "../chunk-IGXZS2W6.js";
+} from "../chunk-SVTXMVLQ.js";
 import "../chunk-VWJKRQZR.js";
 
 // src/config/zod-3.ts

package/dist/{define-DnJzAZrj.d.ts → define-DAZmbu3U.d.cts}

@@ -107,4 +107,4 @@ declare function defineDocs<DocSchema extends StandardSchemaV1 = typeof frontmat
 }): DocsCollection<DocSchema, MetaSchema, Async>;
 declare function defineConfig(config?: GlobalConfig): GlobalConfig;
 
-export { type AnyCollection as A, type BaseCollection as B, type CollectionSchema as C, type DefaultMDXOptions as D, type GlobalConfig as G, type MetaCollection as M, type DocCollection as a, type DocsCollection as b, defineDocs as c, defineCollections as d, defineConfig as e, frontmatterSchema as f, getDefaultMDXOptions as g, metaSchema as m };
+export { type AnyCollection as A, type BaseCollection as B, type CollectionSchema as C, type DocCollection as D, type GlobalConfig as G, type MetaCollection as M, type DocsCollection as a, type DefaultMDXOptions as b, defineDocs as c, defineCollections as d, defineConfig as e, frontmatterSchema as f, getDefaultMDXOptions as g, metaSchema as m };

package/dist/{define-DnJzAZrj.d.cts → define-DAZmbu3U.d.ts}

@@ -107,4 +107,4 @@ declare function defineDocs<DocSchema extends StandardSchemaV1 = typeof frontmat
 }): DocsCollection<DocSchema, MetaSchema, Async>;
 declare function defineConfig(config?: GlobalConfig): GlobalConfig;
 
-export { type AnyCollection as A, type BaseCollection as B, type CollectionSchema as C, type DefaultMDXOptions as D, type GlobalConfig as G, type MetaCollection as M, type DocCollection as a, type DocsCollection as b, defineDocs as c, defineCollections as d, defineConfig as e, frontmatterSchema as f, getDefaultMDXOptions as g, metaSchema as m };
+export { type AnyCollection as A, type BaseCollection as B, type CollectionSchema as C, type DocCollection as D, type GlobalConfig as G, type MetaCollection as M, type DocsCollection as a, type DefaultMDXOptions as b, defineDocs as c, defineCollections as d, defineConfig as e, frontmatterSchema as f, getDefaultMDXOptions as g, metaSchema as m };

package/dist/index.d.cts

@@ -1,12 +1,12 @@
 import { PageData, MetaData, Source, VirtualFile } from 'fumadocs-core/source';
-import { R as Runtime, B as BaseCollectionEntry } from './types-DvnkeVI3.cjs';
+import { R as Runtime, B as BaseCollectionEntry } from './types-B2kQsHs7.cjs';
 import '@standard-schema/spec';
-import './define-DnJzAZrj.cjs';
+import './define-DAZmbu3U.cjs';
 import 'fumadocs-core/mdx-plugins';
 import '@mdx-js/mdx';
 import 'unified';
 import 'zod';
-import './build-mdx-DMe0r3s_.cjs';
+import './build-mdx-DnC1jKvn.cjs';
 import 'fumadocs-core/server';
 import 'react';
 import 'mdx/types';

package/dist/index.d.ts

@@ -1,12 +1,12 @@
 import { PageData, MetaData, Source, VirtualFile } from 'fumadocs-core/source';
-import { R as Runtime, B as BaseCollectionEntry } from './types-zBRxlyaM.js';
+import { R as Runtime, B as BaseCollectionEntry } from './types-CkmezNbX.js';
 import '@standard-schema/spec';
-import './define-DnJzAZrj.js';
+import './define-DAZmbu3U.js';
 import 'fumadocs-core/mdx-plugins';
 import '@mdx-js/mdx';
 import 'unified';
 import 'zod';
-import './build-mdx-DMe0r3s_.js';
+import './build-mdx-DnC1jKvn.js';
 import 'fumadocs-core/server';
 import 'react';
 import 'mdx/types';