fumadocs-mdx 11.7.3 → 11.7.5

package/dist/{chunk-AVMO2SRO.js → chunk-3XN4P23K.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, data) {
     const queue = [];
     visit(
       tree,
@@ -34,27 +54,44 @@ 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);
+            data._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);
+            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
+            );
             Object.assign(
               parent && parent.type === "paragraph" ? parent : node,
               parsed
@@ -62,7 +99,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 +110,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.call(this, tree, path.dirname(file.path), file.data);
   };
 }
 

package/dist/chunk-GBMFGEC7.js

@@ -0,0 +1,57 @@
+// src/config/zod-4.ts
+import { z } from "zod";
+var metaSchema = z.object({
+  title: z.string().optional(),
+  pages: z.array(z.string()).optional(),
+  description: z.string().optional(),
+  root: z.boolean().optional(),
+  defaultOpen: z.boolean().optional(),
+  icon: z.string().optional()
+});
+var frontmatterSchema = z.object({
+  title: z.string(),
+  description: z.string().optional(),
+  icon: z.string().optional(),
+  full: z.boolean().optional(),
+  // Fumadocs OpenAPI generated
+  _openapi: z.looseObject({}).optional()
+});
+
+// src/config/define.ts
+function defineCollections(options) {
+  return options;
+}
+function defineDocs(options) {
+  if (!options)
+    console.warn(
+      "[`source.config.ts`] Deprecated: please pass options to `defineDocs()` and specify a `dir`."
+    );
+  const dir = options?.dir ?? "content/docs";
+  return {
+    type: "docs",
+    dir,
+    docs: defineCollections({
+      type: "doc",
+      dir,
+      schema: frontmatterSchema,
+      ...options?.docs
+    }),
+    meta: defineCollections({
+      type: "meta",
+      dir,
+      schema: metaSchema,
+      ...options?.meta
+    })
+  };
+}
+function defineConfig(config = {}) {
+  return config;
+}
+
+export {
+  metaSchema,
+  frontmatterSchema,
+  defineCollections,
+  defineDocs,
+  defineConfig
+};

package/dist/{chunk-ZOWJF3OH.js → chunk-GX3THK2Q.js}

@@ -1,22 +1,28 @@
-// src/utils/schema.ts
-import { z } from "zod";
+// src/utils/git-timestamp.ts
+import path from "path";
+import { x } from "tinyexec";
+var cache = /* @__PURE__ */ new Map();
+async function getGitTimestamp(file) {
+  const cached = cache.get(file);
+  if (cached) return cached;
+  try {
+    const out = await x(
+      "git",
+      ["log", "-1", '--pretty="%ai"', path.relative(process.cwd(), file)],
+      {
+        throwOnError: true
+      }
+    );
+    const time = new Date(out.stdout);
+    cache.set(file, time);
+    return time;
+  } catch {
+    return;
+  }
+}
+
+// src/utils/validation.ts
 import picocolors from "picocolors";
-var metaSchema = z.object({
-  title: z.string().optional(),
-  pages: z.array(z.string()).optional(),
-  description: z.string().optional(),
-  root: z.boolean().optional(),
-  defaultOpen: z.boolean().optional(),
-  icon: z.string().optional()
-});
-var frontmatterSchema = z.object({
-  title: z.string(),
-  description: z.string().optional(),
-  icon: z.string().optional(),
-  full: z.boolean().optional(),
-  // Fumadocs OpenAPI generated
-  _openapi: z.looseObject({}).optional()
-});
 var ValidationError = class extends Error {
   constructor(message, issues) {
     super(
@@ -54,8 +60,7 @@ async function validate(schema, data, context, errorMessage) {
 }
 
 export {
-  metaSchema,
-  frontmatterSchema,
+  getGitTimestamp,
   ValidationError,
   validate
 };

package/dist/{chunk-2CSSQTP6.js → chunk-GYWPPGFD.js}

@@ -63,6 +63,7 @@ function getDefaultMDXOptions({
   remarkStructureOptions,
   remarkCodeTabOptions,
   remarkNpmOptions,
+  _withoutBundler = false,
   ...mdxOptions
 }) {
   const mdxExports = [
@@ -81,7 +82,13 @@ function getDefaultMDXOptions({
           ...remarkHeadingOptions
         }
       ],
-      remarkImageOptions !== false && [plugins.remarkImage, remarkImageOptions],
+      remarkImageOptions !== false && [
+        plugins.remarkImage,
+        {
+          ...remarkImageOptions,
+          useImport: _withoutBundler ? false : remarkImageOptions?.useImport
+        }
+      ],
       "remarkCodeTab" in plugins && remarkCodeTabOptions !== false && [
         plugins.remarkCodeTab,
         remarkCodeTabOptions
@@ -106,6 +113,7 @@ function getDefaultMDXOptions({
   );
   return {
     ...mdxOptions,
+    outputFormat: _withoutBundler ? "function-body" : mdxOptions.outputFormat,
     remarkPlugins,
     rehypePlugins
   };

package/dist/chunk-HWSF4OGZ.js

@@ -0,0 +1,42 @@
+import {
+  remarkInclude
+} from "./chunk-3XN4P23K.js";
+
+// src/utils/build-mdx.ts
+import { createProcessor } from "@mdx-js/mdx";
+var cache = /* @__PURE__ */ new Map();
+async function buildMDX(cacheKey, source, options) {
+  const { filePath, frontmatter, data, _compiler, ...rest } = options;
+  function getProcessor(format) {
+    const key = `${cacheKey}:${format}`;
+    let processor = cache.get(key);
+    if (!processor) {
+      processor = createProcessor({
+        outputFormat: "program",
+        ...rest,
+        remarkPlugins: [remarkInclude, ...rest.remarkPlugins ?? []],
+        format
+      });
+      cache.set(key, processor);
+    }
+    return processor;
+  }
+  return getProcessor(
+    options.format ?? filePath.endsWith(".mdx") ? "mdx" : "md"
+  ).process({
+    value: source,
+    path: filePath,
+    data: {
+      ...data,
+      frontmatter,
+      _compiler,
+      _processor: {
+        getProcessor
+      }
+    }
+  });
+}
+
+export {
+  buildMDX
+};

package/dist/chunk-UCY7OBZG.js

@@ -0,0 +1,12 @@
+// src/utils/count-lines.ts
+function countLines(s) {
+  let num = 0;
+  for (const c of s) {
+    if (c === "\n") num++;
+  }
+  return num;
+}
+
+export {
+  countLines
+};

package/dist/{chunk-JFNBRKRV.js → chunk-XVL4ZQFK.js}

@@ -24,20 +24,26 @@ function buildConfig(config) {
       `Unknown export "${k}", you can only export collections from source configuration file.`
     );
   }
-  let cachedMdxOptions;
+  const mdxOptionsCache = /* @__PURE__ */ new Map();
   return {
     global: globalConfig,
     collections,
-    async getDefaultMDXOptions() {
-      if (cachedMdxOptions) return cachedMdxOptions;
+    async getDefaultMDXOptions(mode = "default") {
+      const cached = mdxOptionsCache.get(mode);
+      if (cached) return cached;
       const input = this.global.mdxOptions;
       async function uncached() {
         const options = typeof input === "function" ? await input() : input;
-        const { getDefaultMDXOptions } = await import("./mdx-options-UDV5WEFU.js");
+        const { getDefaultMDXOptions } = await import("./mdx-options-3NB74EMB.js");
         if (options?.preset === "minimal") return options;
-        return getDefaultMDXOptions(options ?? {});
+        return getDefaultMDXOptions({
+          ...options,
+          _withoutBundler: mode === "remote"
+        });
       }
-      return cachedMdxOptions = uncached();
+      const result = uncached();
+      mdxOptionsCache.set(mode, result);
+      return result;
     }
   };
 }

package/dist/{chunk-4CGSOZUZ.js → chunk-XZR5QXVY.js}

@@ -1,6 +1,6 @@
 import {
   buildConfig
-} from "./chunk-JFNBRKRV.js";
+} from "./chunk-XVL4ZQFK.js";
 
 // src/utils/config.ts
 import * as fs from "fs/promises";
@@ -10,17 +10,47 @@ function findConfigFile() {
   return path.resolve("source.config.ts");
 }
 var cache = null;
+async function isZod3() {
+  try {
+    const content = JSON.parse(
+      (await fs.readFile("node_modules/zod/package.json")).toString()
+    );
+    const version = content.version;
+    return typeof version === "string" && version.startsWith("3.");
+  } catch {
+    return false;
+  }
+}
+function createCompatZodPlugin() {
+  return {
+    name: "replace-zod-import",
+    async setup(build) {
+      const usingZod3 = await isZod3();
+      if (!usingZod3) return;
+      console.warn(
+        "[Fumadocs MDX] Noticed Zod v3 in your node_modules, we recommend upgrading to Zod v4 for better compatibility."
+      );
+      build.onResolve({ filter: /^fumadocs-mdx\/config$/ }, () => {
+        return {
+          path: "fumadocs-mdx/config/zod-3",
+          external: true
+        };
+      });
+    }
+  };
+}
 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: "node18",
+    target: "node20",
     write: true,
     platform: "node",
     format: "esm",
     packages: "external",
+    plugins: [createCompatZodPlugin()],
     outExtension: {
       ".js": ".mjs"
     },

package/dist/config/index.cjs

@@ -40,9 +40,8 @@ __export(config_exports, {
 });
 module.exports = __toCommonJS(config_exports);
 
-// src/utils/schema.ts
+// src/config/zod-4.ts
 var import_zod = require("zod");
-var import_picocolors = __toESM(require("picocolors"), 1);
 var metaSchema = import_zod.z.object({
   title: import_zod.z.string().optional(),
   pages: import_zod.z.array(import_zod.z.string()).optional(),
@@ -156,6 +155,7 @@ function getDefaultMDXOptions({
   remarkStructureOptions,
   remarkCodeTabOptions,
   remarkNpmOptions,
+  _withoutBundler = false,
   ...mdxOptions
 }) {
   const mdxExports = [
@@ -174,7 +174,13 @@ function getDefaultMDXOptions({
           ...remarkHeadingOptions
         }
       ],
-      remarkImageOptions !== false && [plugins.remarkImage, remarkImageOptions],
+      remarkImageOptions !== false && [
+        plugins.remarkImage,
+        {
+          ...remarkImageOptions,
+          useImport: _withoutBundler ? false : remarkImageOptions?.useImport
+        }
+      ],
       "remarkCodeTab" in plugins && remarkCodeTabOptions !== false && [
         plugins.remarkCodeTab,
         remarkCodeTabOptions
@@ -199,6 +205,7 @@ function getDefaultMDXOptions({
   );
   return {
     ...mdxOptions,
+    outputFormat: _withoutBundler ? "function-body" : mdxOptions.outputFormat,
     remarkPlugins,
     rehypePlugins
   };
@@ -232,9 +239,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, data) {
     const queue = [];
     (0, import_unist_util_visit.visit)(
       tree,
@@ -254,27 +281,44 @@ 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);
+            data._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);
+            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
+            );
             Object.assign(
               parent && parent.type === "paragraph" ? parent : node,
               parsed
@@ -282,7 +326,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 +337,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.call(this, tree, path.dirname(file.path), file.data);
   };
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/config/index.d.cts

@@ -1,10 +1,10 @@
-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, f as frontmatterSchema, g as getDefaultMDXOptions, m as metaSchema } from '../define-E6TRBwBQ.cjs';
+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, f as frontmatterSchema, g as getDefaultMDXOptions, m as metaSchema } from '../define-DnJzAZrj.cjs';
 import { Processor, Transformer } from 'unified';
 import { Root } from 'mdast';
-import 'zod';
 import '@standard-schema/spec';
 import 'fumadocs-core/mdx-plugins';
 import '@mdx-js/mdx';
+import 'zod';
 
 declare function remarkInclude(this: Processor): Transformer<Root, Root>;
 

package/dist/config/index.d.ts

@@ -1,10 +1,10 @@
-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, f as frontmatterSchema, g as getDefaultMDXOptions, m as metaSchema } from '../define-E6TRBwBQ.js';
+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, f as frontmatterSchema, g as getDefaultMDXOptions, m as metaSchema } from '../define-DnJzAZrj.js';
 import { Processor, Transformer } from 'unified';
 import { Root } from 'mdast';
-import 'zod';
 import '@standard-schema/spec';
 import 'fumadocs-core/mdx-plugins';
 import '@mdx-js/mdx';
+import 'zod';
 
 declare function remarkInclude(this: Processor): Transformer<Root, Root>;
 

package/dist/config/index.js

@@ -1,45 +1,17 @@
 import {
+  defineCollections,
+  defineConfig,
+  defineDocs,
   frontmatterSchema,
   metaSchema
-} from "../chunk-ZOWJF3OH.js";
+} from "../chunk-GBMFGEC7.js";
+import {
+  getDefaultMDXOptions
+} from "../chunk-GYWPPGFD.js";
 import {
   remarkInclude
-} from "../chunk-AVMO2SRO.js";
+} from "../chunk-3XN4P23K.js";
 import "../chunk-KVWX6THC.js";
-import {
-  getDefaultMDXOptions
-} from "../chunk-2CSSQTP6.js";
-
-// src/config/define.ts
-function defineCollections(options) {
-  return options;
-}
-function defineDocs(options) {
-  if (!options)
-    console.warn(
-      "[`source.config.ts`] Deprecated: please pass options to `defineDocs()` and specify a `dir`."
-    );
-  const dir = options?.dir ?? "content/docs";
-  return {
-    type: "docs",
-    dir,
-    docs: defineCollections({
-      type: "doc",
-      dir,
-      schema: frontmatterSchema,
-      ...options?.docs
-    }),
-    meta: defineCollections({
-      type: "meta",
-      dir,
-      schema: metaSchema,
-      ...options?.meta
-    })
-  };
-}
-function defineConfig(config = {}) {
-  return config;
-}
 export {
   defineCollections,
   defineConfig,