fumadocs-mdx 11.8.0 → 11.8.2

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)) return;
-      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: {
@@ -161,6 +188,7 @@ function getDefaultMDXOptions({
 }) {
   const mdxExports = [
     "structuredData",
+    "extractedReferences",
     "frontmatter",
     "lastModified",
     ...valueToExport
@@ -192,7 +220,10 @@ function getDefaultMDXOptions({
         plugins.remarkStructure,
         remarkStructureOptions
       ],
-      [remarkMdxExport, { values: mdxExports }]
+      [
+        remarkPostprocess,
+        { injectExports: mdxExports }
+      ]
     ],
     mdxOptions.remarkPlugins
   );
@@ -213,7 +244,8 @@ function getDefaultMDXOptions({
 }
 
 // src/mdx-plugins/remark-include.ts
-var import_unist_util_visit = require("unist-util-visit");
+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);
 
@@ -234,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 "";
 }
@@ -249,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_visit.visit)(
+    (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
             );
           })
         );
@@ -338,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 { 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 { 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-GYWPPGFD.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/index.d.cts

@@ -1,14 +1,15 @@
 import { PageData, MetaData, Source, VirtualFile } from 'fumadocs-core/source';
-import { R as Runtime, B as BaseCollectionEntry } from './types-BukvTPdG.cjs';
+import { R as Runtime, B as BaseCollectionEntry } from './types-BmVgoqsr.cjs';
 import '@standard-schema/spec';
 import './define-DnJzAZrj.cjs';
 import 'fumadocs-core/mdx-plugins';
 import '@mdx-js/mdx';
 import 'unified';
 import 'zod';
+import './build-mdx-DnC1jKvn.cjs';
+import 'fumadocs-core/server';
 import 'react';
 import 'mdx/types';
-import 'fumadocs-core/server';
 
 declare const _runtime: Runtime;
 declare function createMDXSource<Doc extends PageData & BaseCollectionEntry, Meta extends MetaData & BaseCollectionEntry>(docs: Doc[], meta?: Meta[]): Source<{

package/dist/index.d.ts

@@ -1,14 +1,15 @@
 import { PageData, MetaData, Source, VirtualFile } from 'fumadocs-core/source';
-import { R as Runtime, B as BaseCollectionEntry } from './types-B2ozVm_9.js';
+import { R as Runtime, B as BaseCollectionEntry } from './types-WSHJKA8L.js';
 import '@standard-schema/spec';
 import './define-DnJzAZrj.js';
 import 'fumadocs-core/mdx-plugins';
 import '@mdx-js/mdx';
 import 'unified';
 import 'zod';
+import './build-mdx-DnC1jKvn.js';
+import 'fumadocs-core/server';
 import 'react';
 import 'mdx/types';
-import 'fumadocs-core/server';
 
 declare const _runtime: Runtime;
 declare function createMDXSource<Doc extends PageData & BaseCollectionEntry, Meta extends MetaData & BaseCollectionEntry>(docs: Doc[], meta?: Meta[]): Source<{

package/dist/loader-mdx.cjs

@@ -30,15 +30,40 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/mdx-plugins/remark-exports.ts
-function remarkMdxExport({ values }) {
-  return (tree, vfile) => {
-    for (const name of values) {
-      if (!(name in vfile.data)) return;
-      tree.children.unshift(getMdastExport(name, vfile.data[name]));
+// src/mdx-plugins/remark-postprocess.ts
+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",
@@ -50,6 +75,7 @@ function getMdastExport(name, value) {
         body: [
           {
             type: "ExportNamedDeclaration",
+            attributes: [],
             specifiers: [],
             source: null,
             declaration: {
@@ -72,10 +98,11 @@ function getMdastExport(name, value) {
     }
   };
 }
-var import_estree_util_value_to_estree;
-var init_remark_exports = __esm({
-  "src/mdx-plugins/remark-exports.ts"() {
+var import_unist_util_visit, import_estree_util_value_to_estree;
+var init_remark_postprocess = __esm({
+  "src/mdx-plugins/remark-postprocess.ts"() {
     "use strict";
+    import_unist_util_visit = require("unist-util-visit");
     import_estree_util_value_to_estree = require("estree-util-value-to-estree");
   }
 });
@@ -107,6 +134,7 @@ function getDefaultMDXOptions({
 }) {
   const mdxExports = [
     "structuredData",
+    "extractedReferences",
     "frontmatter",
     "lastModified",
     ...valueToExport
@@ -138,7 +166,10 @@ function getDefaultMDXOptions({
         plugins.remarkStructure,
         remarkStructureOptions
       ],
-      [remarkMdxExport, { values: mdxExports }]
+      [
+        remarkPostprocess,
+        { injectExports: mdxExports }
+      ]
     ],
     mdxOptions.remarkPlugins
   );
@@ -162,7 +193,7 @@ var init_mdx_options = __esm({
   "src/utils/mdx-options.ts"() {
     "use strict";
     plugins = __toESM(require("fumadocs-core/mdx-plugins"), 1);
-    init_remark_exports();
+    init_remark_postprocess();
   }
 });
 
@@ -309,7 +340,8 @@ async function getConfigHash(configPath) {
 var import_mdx = require("@mdx-js/mdx");
 
 // src/mdx-plugins/remark-include.ts
-var import_unist_util_visit = require("unist-util-visit");
+var import_unified = require("unified");
+var import_unist_util_visit2 = require("unist-util-visit");
 var path2 = __toESM(require("path"), 1);
 var fs2 = __toESM(require("fs/promises"), 1);
 
@@ -330,9 +362,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 "";
 }
@@ -345,86 +381,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 fs2.readFile(file)).toString();
+    } catch (e) {
+      throw new Error(
+        `failed to read file ${file}
+${e instanceof Error ? e.message : String(e)}`,
+        { cause: e }
+      );
+    }
+    const ext = path2.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, path2.dirname(file), data);
+    return parsed;
+  }
   async function update(tree, directory, data) {
     const queue = [];
-    (0, import_unist_util_visit.visit)(
+    (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 = path2.resolve(
+        const { file: relativePath, section } = parseSpecifier(specifier);
+        const file = path2.resolve(
           "cwd" in params ? process.cwd() : directory,
-          file
+          relativePath
         );
-        const asCode = params.lang || !file.endsWith(".md") && !file.endsWith(".mdx");
         queue.push(
-          fs2.readFile(targetPath).then((buffer) => buffer.toString()).then(async (content) => {
-            data._compiler?.addDependency(targetPath);
-            if (asCode) {
-              const lang = params.lang ?? path2.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,
-              path2.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
             );
           })
         );
@@ -434,9 +480,14 @@ ${e instanceof Error ? e.message : String(e)}`,
     await Promise.all(queue);
   }
   return async (tree, file) => {
-    await update.call(this, tree, path2.dirname(file.path), file.data);
+    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/utils/build-mdx.ts
 var cache2 = /* @__PURE__ */ new Map();
@@ -465,9 +516,7 @@ async function buildMDX(cacheKey, source, options) {
       ...data,
       frontmatter,
       _compiler,
-      _processor: {
-        getProcessor
-      }
+      _getProcessor: getProcessor
     }
   });
 }
@@ -559,13 +608,13 @@ async function loader(source, callback) {
   if (collection && collection.type !== "doc") {
     collection = void 0;
   }
-  let data = matter.data;
+  let frontmatter = matter.data;
   const mdxOptions = collection?.mdxOptions ?? await config.getDefaultMDXOptions();
   if (collection?.schema) {
     try {
-      data = await validate(
+      frontmatter = await validate(
         collection.schema,
-        matter.data,
+        frontmatter,
         {
           source,
           path: filePath
@@ -594,7 +643,7 @@ async function loader(source, callback) {
         development: this.mode === "development",
         ...mdxOptions,
         filePath,
-        frontmatter: data,
+        frontmatter,
         data: {
           lastModified: timestamp
         },