fumadocs-mdx 11.7.3 → 11.7.4

package/dist/{chunk-C5INPAZJ.js → chunk-2K55VKP6.js}

@@ -1,6 +1,6 @@
 import {
   remarkInclude
-} from "./chunk-AVMO2SRO.js";
+} from "./chunk-PQCNPAD3.js";
 
 // src/utils/build-mdx.ts
 import { createProcessor } from "@mdx-js/mdx";

package/dist/{chunk-AVMO2SRO.js → chunk-PQCNPAD3.js}

@@ -12,9 +12,29 @@ function flattenNode(node) {
   if ("value" in node) return node.value;
   return "";
 }
+function parseSpecifier(specifier) {
+  const idx = specifier.lastIndexOf("#");
+  if (idx === -1) return { file: specifier };
+  return {
+    file: specifier.slice(0, idx),
+    section: specifier.slice(idx + 1)
+  };
+}
+function extractSection(root, section) {
+  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
+      };
+    }
+  }
+}
 function remarkInclude() {
   const TagName = "include";
-  async function update(tree, file, processor, compiler) {
+  async function update(tree, directory, processor, compiler) {
     const queue = [];
     visit(
       tree,
@@ -34,27 +54,41 @@ function remarkInclude() {
           }
         }
         if (!specifier) return;
+        const { file, section } = parseSpecifier(specifier);
         const targetPath = path.resolve(
-          "cwd" in params ? process.cwd() : path.dirname(file),
-          specifier
+          "cwd" in params ? process.cwd() : directory,
+          file
         );
-        const asCode = params.lang || !specifier.endsWith(".md") && !specifier.endsWith(".mdx");
+        const asCode = params.lang || !file.endsWith(".md") && !file.endsWith(".mdx");
         queue.push(
           fs.readFile(targetPath).then((buffer) => buffer.toString()).then(async (content) => {
             compiler?.addDependency(targetPath);
             if (asCode) {
-              const lang = params.lang ?? path.extname(specifier).slice(1);
+              const lang = params.lang ?? path.extname(file).slice(1);
               Object.assign(node, {
                 type: "code",
                 lang,
                 meta: params.meta,
-                value: content.toString(),
+                value: content,
                 data: {}
               });
               return;
             }
-            const parsed = processor.parse(fumaMatter(content).content);
-            await update(parsed, targetPath, processor, compiler);
+            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(
+              parsed,
+              path.dirname(targetPath),
+              processor,
+              compiler
+            );
             Object.assign(
               parent && parent.type === "paragraph" ? parent : node,
               parsed
@@ -62,7 +96,8 @@ function remarkInclude() {
           }).catch((e) => {
             throw new Error(
               `failed to read file ${targetPath}
-${e instanceof Error ? e.message : String(e)}`
+${e instanceof Error ? e.message : String(e)}`,
+              { cause: e }
             );
           })
         );
@@ -72,7 +107,7 @@ ${e instanceof Error ? e.message : String(e)}`
     await Promise.all(queue);
   }
   return async (tree, file) => {
-    await update(tree, file.path, this, file.data._compiler);
+    await update(tree, path.dirname(file.path), this, file.data._compiler);
   };
 }
 

package/dist/config/index.cjs

@@ -232,9 +232,29 @@ function flattenNode(node) {
   if ("value" in node) return node.value;
   return "";
 }
+function parseSpecifier(specifier) {
+  const idx = specifier.lastIndexOf("#");
+  if (idx === -1) return { file: specifier };
+  return {
+    file: specifier.slice(0, idx),
+    section: specifier.slice(idx + 1)
+  };
+}
+function extractSection(root, section) {
+  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
+      };
+    }
+  }
+}
 function remarkInclude() {
   const TagName = "include";
-  async function update(tree, file, processor, compiler) {
+  async function update(tree, directory, processor, compiler) {
     const queue = [];
     (0, import_unist_util_visit.visit)(
       tree,
@@ -254,27 +274,41 @@ function remarkInclude() {
           }
         }
         if (!specifier) return;
+        const { file, section } = parseSpecifier(specifier);
         const targetPath = path.resolve(
-          "cwd" in params ? process.cwd() : path.dirname(file),
-          specifier
+          "cwd" in params ? process.cwd() : directory,
+          file
         );
-        const asCode = params.lang || !specifier.endsWith(".md") && !specifier.endsWith(".mdx");
+        const asCode = params.lang || !file.endsWith(".md") && !file.endsWith(".mdx");
         queue.push(
           fs.readFile(targetPath).then((buffer) => buffer.toString()).then(async (content) => {
             compiler?.addDependency(targetPath);
             if (asCode) {
-              const lang = params.lang ?? path.extname(specifier).slice(1);
+              const lang = params.lang ?? path.extname(file).slice(1);
               Object.assign(node, {
                 type: "code",
                 lang,
                 meta: params.meta,
-                value: content.toString(),
+                value: content,
                 data: {}
               });
               return;
             }
-            const parsed = processor.parse(fumaMatter(content).content);
-            await update(parsed, targetPath, processor, compiler);
+            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(
+              parsed,
+              path.dirname(targetPath),
+              processor,
+              compiler
+            );
             Object.assign(
               parent && parent.type === "paragraph" ? parent : node,
               parsed
@@ -282,7 +316,8 @@ function remarkInclude() {
           }).catch((e) => {
             throw new Error(
               `failed to read file ${targetPath}
-${e instanceof Error ? e.message : String(e)}`
+${e instanceof Error ? e.message : String(e)}`,
+              { cause: e }
             );
           })
         );
@@ -292,7 +327,7 @@ ${e instanceof Error ? e.message : String(e)}`
     await Promise.all(queue);
   }
   return async (tree, file) => {
-    await update(tree, file.path, this, file.data._compiler);
+    await update(tree, path.dirname(file.path), this, file.data._compiler);
   };
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/config/index.js

@@ -4,7 +4,7 @@ import {
 } from "../chunk-ZOWJF3OH.js";
 import {
   remarkInclude
-} from "../chunk-AVMO2SRO.js";
+} from "../chunk-PQCNPAD3.js";
 import "../chunk-KVWX6THC.js";
 import {
   getDefaultMDXOptions

package/dist/loader-mdx.cjs

@@ -292,9 +292,29 @@ function flattenNode(node) {
   if ("value" in node) return node.value;
   return "";
 }
+function parseSpecifier(specifier) {
+  const idx = specifier.lastIndexOf("#");
+  if (idx === -1) return { file: specifier };
+  return {
+    file: specifier.slice(0, idx),
+    section: specifier.slice(idx + 1)
+  };
+}
+function extractSection(root, section) {
+  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
+      };
+    }
+  }
+}
 function remarkInclude() {
   const TagName = "include";
-  async function update(tree, file, processor, compiler) {
+  async function update(tree, directory, processor, compiler) {
     const queue = [];
     (0, import_unist_util_visit.visit)(
       tree,
@@ -314,27 +334,41 @@ function remarkInclude() {
           }
         }
         if (!specifier) return;
+        const { file, section } = parseSpecifier(specifier);
         const targetPath = path2.resolve(
-          "cwd" in params ? process.cwd() : path2.dirname(file),
-          specifier
+          "cwd" in params ? process.cwd() : directory,
+          file
         );
-        const asCode = params.lang || !specifier.endsWith(".md") && !specifier.endsWith(".mdx");
+        const asCode = params.lang || !file.endsWith(".md") && !file.endsWith(".mdx");
         queue.push(
           fs2.readFile(targetPath).then((buffer) => buffer.toString()).then(async (content) => {
             compiler?.addDependency(targetPath);
             if (asCode) {
-              const lang = params.lang ?? path2.extname(specifier).slice(1);
+              const lang = params.lang ?? path2.extname(file).slice(1);
               Object.assign(node, {
                 type: "code",
                 lang,
                 meta: params.meta,
-                value: content.toString(),
+                value: content,
                 data: {}
               });
               return;
             }
-            const parsed = processor.parse(fumaMatter(content).content);
-            await update(parsed, targetPath, processor, compiler);
+            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(
+              parsed,
+              path2.dirname(targetPath),
+              processor,
+              compiler
+            );
             Object.assign(
               parent && parent.type === "paragraph" ? parent : node,
               parsed
@@ -342,7 +376,8 @@ function remarkInclude() {
           }).catch((e) => {
             throw new Error(
               `failed to read file ${targetPath}
-${e instanceof Error ? e.message : String(e)}`
+${e instanceof Error ? e.message : String(e)}`,
+              { cause: e }
             );
           })
         );
@@ -352,7 +387,7 @@ ${e instanceof Error ? e.message : String(e)}`
     await Promise.all(queue);
   }
   return async (tree, file) => {
-    await update(tree, file.path, this, file.data._compiler);
+    await update(tree, path2.dirname(file.path), this, file.data._compiler);
   };
 }
 

package/dist/loader-mdx.js

@@ -5,7 +5,7 @@ import {
 import {
   buildMDX,
   countLines
-} from "./chunk-C5INPAZJ.js";
+} from "./chunk-2K55VKP6.js";
 import {
   getGitTimestamp
 } from "./chunk-VUEZTR2H.js";
@@ -13,7 +13,7 @@ import {
   ValidationError,
   validate
 } from "./chunk-ZOWJF3OH.js";
-import "./chunk-AVMO2SRO.js";
+import "./chunk-PQCNPAD3.js";
 import "./chunk-JFNBRKRV.js";
 import {
   fumaMatter

package/dist/runtime/async.cjs

@@ -195,9 +195,29 @@ function flattenNode(node) {
   if ("value" in node) return node.value;
   return "";
 }
+function parseSpecifier(specifier) {
+  const idx = specifier.lastIndexOf("#");
+  if (idx === -1) return { file: specifier };
+  return {
+    file: specifier.slice(0, idx),
+    section: specifier.slice(idx + 1)
+  };
+}
+function extractSection(root, section) {
+  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
+      };
+    }
+  }
+}
 function remarkInclude() {
   const TagName = "include";
-  async function update(tree, file, processor, compiler) {
+  async function update(tree, directory, processor, compiler) {
     const queue = [];
     (0, import_unist_util_visit.visit)(
       tree,
@@ -217,27 +237,41 @@ function remarkInclude() {
           }
         }
         if (!specifier) return;
+        const { file, section } = parseSpecifier(specifier);
         const targetPath = path.resolve(
-          "cwd" in params ? process.cwd() : path.dirname(file),
-          specifier
+          "cwd" in params ? process.cwd() : directory,
+          file
         );
-        const asCode = params.lang || !specifier.endsWith(".md") && !specifier.endsWith(".mdx");
+        const asCode = params.lang || !file.endsWith(".md") && !file.endsWith(".mdx");
         queue.push(
           fs.readFile(targetPath).then((buffer) => buffer.toString()).then(async (content) => {
             compiler?.addDependency(targetPath);
             if (asCode) {
-              const lang = params.lang ?? path.extname(specifier).slice(1);
+              const lang = params.lang ?? path.extname(file).slice(1);
               Object.assign(node, {
                 type: "code",
                 lang,
                 meta: params.meta,
-                value: content.toString(),
+                value: content,
                 data: {}
               });
               return;
             }
-            const parsed = processor.parse(fumaMatter(content).content);
-            await update(parsed, targetPath, processor, compiler);
+            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(
+              parsed,
+              path.dirname(targetPath),
+              processor,
+              compiler
+            );
             Object.assign(
               parent && parent.type === "paragraph" ? parent : node,
               parsed
@@ -245,7 +279,8 @@ function remarkInclude() {
           }).catch((e) => {
             throw new Error(
               `failed to read file ${targetPath}
-${e instanceof Error ? e.message : String(e)}`
+${e instanceof Error ? e.message : String(e)}`,
+              { cause: e }
             );
           })
         );
@@ -255,7 +290,7 @@ ${e instanceof Error ? e.message : String(e)}`
     await Promise.all(queue);
   }
   return async (tree, file) => {
-    await update(tree, file.path, this, file.data._compiler);
+    await update(tree, path.dirname(file.path), this, file.data._compiler);
   };
 }
 

package/dist/runtime/async.js

@@ -4,7 +4,7 @@ import {
 } from "../chunk-NUDEC6C5.js";
 import {
   remarkInclude
-} from "../chunk-AVMO2SRO.js";
+} from "../chunk-PQCNPAD3.js";
 import {
   buildConfig
 } from "../chunk-JFNBRKRV.js";

package/dist/vite/index.cjs

@@ -240,9 +240,29 @@ function flattenNode(node) {
   if ("value" in node) return node.value;
   return "";
 }
+function parseSpecifier(specifier) {
+  const idx = specifier.lastIndexOf("#");
+  if (idx === -1) return { file: specifier };
+  return {
+    file: specifier.slice(0, idx),
+    section: specifier.slice(idx + 1)
+  };
+}
+function extractSection(root, section) {
+  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
+      };
+    }
+  }
+}
 function remarkInclude() {
   const TagName = "include";
-  async function update(tree, file, processor, compiler) {
+  async function update(tree, directory, processor, compiler) {
     const queue = [];
     (0, import_unist_util_visit.visit)(
       tree,
@@ -262,27 +282,41 @@ function remarkInclude() {
           }
         }
         if (!specifier) return;
+        const { file, section } = parseSpecifier(specifier);
         const targetPath = path.resolve(
-          "cwd" in params ? process.cwd() : path.dirname(file),
-          specifier
+          "cwd" in params ? process.cwd() : directory,
+          file
         );
-        const asCode = params.lang || !specifier.endsWith(".md") && !specifier.endsWith(".mdx");
+        const asCode = params.lang || !file.endsWith(".md") && !file.endsWith(".mdx");
         queue.push(
           fs.readFile(targetPath).then((buffer) => buffer.toString()).then(async (content) => {
             compiler?.addDependency(targetPath);
             if (asCode) {
-              const lang = params.lang ?? path.extname(specifier).slice(1);
+              const lang = params.lang ?? path.extname(file).slice(1);
               Object.assign(node, {
                 type: "code",
                 lang,
                 meta: params.meta,
-                value: content.toString(),
+                value: content,
                 data: {}
               });
               return;
             }
-            const parsed = processor.parse(fumaMatter(content).content);
-            await update(parsed, targetPath, processor, compiler);
+            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(
+              parsed,
+              path.dirname(targetPath),
+              processor,
+              compiler
+            );
             Object.assign(
               parent && parent.type === "paragraph" ? parent : node,
               parsed
@@ -290,7 +324,8 @@ function remarkInclude() {
           }).catch((e) => {
             throw new Error(
               `failed to read file ${targetPath}
-${e instanceof Error ? e.message : String(e)}`
+${e instanceof Error ? e.message : String(e)}`,
+              { cause: e }
             );
           })
         );
@@ -300,7 +335,7 @@ ${e instanceof Error ? e.message : String(e)}`
     await Promise.all(queue);
   }
   return async (tree, file) => {
-    await update(tree, file.path, this, file.data._compiler);
+    await update(tree, path.dirname(file.path), this, file.data._compiler);
   };
 }
 

package/dist/vite/index.js

@@ -1,7 +1,7 @@
 import {
   buildMDX,
   countLines
-} from "../chunk-C5INPAZJ.js";
+} from "../chunk-2K55VKP6.js";
 import {
   getGlobPatterns,
   ident,
@@ -14,7 +14,7 @@ import {
   ValidationError,
   validate
 } from "../chunk-ZOWJF3OH.js";
-import "../chunk-AVMO2SRO.js";
+import "../chunk-PQCNPAD3.js";
 import {
   buildConfig
 } from "../chunk-JFNBRKRV.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-mdx",
-  "version": "11.7.3",
+  "version": "11.7.4",
   "description": "The built-in source for Fumadocs",
   "keywords": [
     "NextJs",
@@ -62,26 +62,26 @@
     "tinyexec": "^1.0.1",
     "tinyglobby": "^0.2.14",
     "unist-util-visit": "^5.0.0",
-    "zod": "^4.0.14"
+    "zod": "^4.0.15"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
     "@types/mdast": "^4.0.3",
     "@types/mdx": "^2.0.13",
-    "@types/node": "^24.1.0",
+    "@types/node": "^24.2.0",
     "@types/react": "^19.1.9",
     "mdast-util-mdx-jsx": "^3.2.0",
-    "next": "^15.4.5",
+    "next": "^15.4.6",
     "react": "^19.1.1",
     "rollup": "^4.46.2",
     "unified": "^11.0.5",
     "vfile": "^6.0.3",
-    "vite": "^7.0.5",
+    "vite": "^7.1.0",
     "webpack": "^5.101.0",
-    "@fumadocs/mdx-remote": "1.4.0",
+    "fumadocs-core": "15.6.9",
     "eslint-config-custom": "0.0.0",
-    "fumadocs-core": "15.6.7",
-    "tsconfig": "0.0.0"
+    "tsconfig": "0.0.0",
+    "@fumadocs/mdx-remote": "1.4.0"
   },
   "peerDependencies": {
     "@fumadocs/mdx-remote": "^1.4.0",