fumadocs-mdx 11.10.1 → 12.0.1

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-XXSKWWMB.js";
+} from "../chunk-ZX7TM4AR.js";
 import "../chunk-6Y5JDZHD.js";
+import "../chunk-LGYVNESJ.js";
 import {
   toVite
-} from "../chunk-CNKI574E.js";
+} from "../chunk-VXEBLM4X.js";
 import {
-  createMdxLoader,
-  resolvedConfig
-} from "../chunk-QJCCVMBJ.js";
-import "../chunk-QQWCBFFE.js";
-import "../chunk-SVTXMVLQ.js";
+  createMdxLoader
+} from "../chunk-SP7CHRTS.js";
 import {
   ValidationError,
   validate
 } from "../chunk-IQAEAI4P.js";
-import "../chunk-766EAFX6.js";
+import {
+  resolvedConfig
+} from "../chunk-XMFLD5J6.js";
 import {
   buildConfig
-} from "../chunk-QVZ7JH4H.js";
+} from "../chunk-U4MQ44TS.js";
+import "../chunk-QAUWMR5D.js";
+import "../chunk-LMG6UWCL.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,6 +1,6 @@
 {
   "name": "fumadocs-mdx",
-  "version": "11.10.1",
+  "version": "12.0.1",
   "description": "The built-in source for Fumadocs",
   "keywords": [
     "NextJs",
@@ -18,11 +18,6 @@
       "types": "./dist/config/index.d.ts",
       "require": "./dist/config/index.cjs"
     },
-    "./config/zod-3": {
-      "import": "./dist/config/zod-3.js",
-      "types": "./dist/config/zod-3.d.ts",
-      "require": "./dist/config/zod-3.cjs"
-    },
     "./next": {
       "import": "./dist/next/index.js",
       "types": "./dist/next/index.d.ts",
@@ -66,10 +61,11 @@
     "@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",
     "remark-parse": "^11.0.0",
@@ -77,25 +73,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.22",
     "@types/js-yaml": "^4.0.9",
     "@types/mdast": "^4.0.3",
     "@types/mdx": "^2.0.13",
-    "@types/node": "^24.3.3",
+    "@types/node": "^24.5.2",
     "@types/react": "^19.1.13",
+    "mdast-util-directive": "^3.1.0",
     "mdast-util-mdx-jsx": "^3.2.0",
-    "next": "^15.5.3",
+    "next": "^15.5.4",
     "react": "^19.1.1",
-    "rollup": "^4.50.1",
+    "remark": "^15.0.1",
+    "remark-directive": "^4.0.0",
+    "remark-stringify": "^11.0.0",
+    "rollup": "^4.52.2",
     "vfile": "^6.0.3",
-    "vite": "^7.1.5",
+    "vite": "^7.1.7",
     "webpack": "^5.101.3",
-    "@fumadocs/mdx-remote": "1.4.0",
     "eslint-config-custom": "0.0.0",
-    "fumadocs-core": "15.7.13",
+    "@fumadocs/mdx-remote": "1.4.0",
+    "fumadocs-core": "15.8.0",
     "tsconfig": "0.0.0"
   },
   "peerDependencies": {

package/dist/build-mdx-DnC1jKvn.d.cts

@@ -1,46 +0,0 @@
-import { createProcessor } from '@mdx-js/mdx';
-import { StructuredData } from 'fumadocs-core/mdx-plugins';
-import { TableOfContents } from 'fumadocs-core/server';
-import { FC } from 'react';
-import { MDXProps } from 'mdx/types';
-
-declare module 'vfile' {
-    interface DataMap {
-        extractedReferences: ExtractedReference[];
-    }
-}
-interface ExtractedReference {
-    href: string;
-}
-
-type Processor = ReturnType<typeof createProcessor>;
-interface CompilerOptions {
-    addDependency: (file: string) => void;
-}
-interface CompiledMDXProperties<Frontmatter = Record<string, unknown>> {
-    frontmatter: Frontmatter;
-    structuredData: StructuredData;
-    toc: TableOfContents;
-    default: FC<MDXProps>;
-    /**
-     * Only available when `lastModifiedTime` is enabled on MDX loader
-     */
-    lastModified?: Date;
-    extractedReferences?: ExtractedReference[];
-}
-
-declare module 'vfile' {
-    interface DataMap {
-        /**
-         * [Fumadocs MDX] raw frontmatter, you can modify it
-         */
-        frontmatter?: Record<string, unknown>;
-        /**
-         * [Fumadocs MDX] The compiler object from loader
-         */
-        _compiler?: CompilerOptions;
-        _getProcessor?: (format: 'md' | 'mdx') => Processor;
-    }
-}
-
-export type { CompiledMDXProperties as C };

package/dist/build-mdx-DnC1jKvn.d.ts

@@ -1,46 +0,0 @@
-import { createProcessor } from '@mdx-js/mdx';
-import { StructuredData } from 'fumadocs-core/mdx-plugins';
-import { TableOfContents } from 'fumadocs-core/server';
-import { FC } from 'react';
-import { MDXProps } from 'mdx/types';
-
-declare module 'vfile' {
-    interface DataMap {
-        extractedReferences: ExtractedReference[];
-    }
-}
-interface ExtractedReference {
-    href: string;
-}
-
-type Processor = ReturnType<typeof createProcessor>;
-interface CompilerOptions {
-    addDependency: (file: string) => void;
-}
-interface CompiledMDXProperties<Frontmatter = Record<string, unknown>> {
-    frontmatter: Frontmatter;
-    structuredData: StructuredData;
-    toc: TableOfContents;
-    default: FC<MDXProps>;
-    /**
-     * Only available when `lastModifiedTime` is enabled on MDX loader
-     */
-    lastModified?: Date;
-    extractedReferences?: ExtractedReference[];
-}
-
-declare module 'vfile' {
-    interface DataMap {
-        /**
-         * [Fumadocs MDX] raw frontmatter, you can modify it
-         */
-        frontmatter?: Record<string, unknown>;
-        /**
-         * [Fumadocs MDX] The compiler object from loader
-         */
-        _compiler?: CompilerOptions;
-        _getProcessor?: (format: 'md' | 'mdx') => Processor;
-    }
-}
-
-export type { CompiledMDXProperties as C };

package/dist/chunk-GBMFGEC7.js

@@ -1,57 +0,0 @@
-// 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-QQWCBFFE.js

@@ -1,40 +0,0 @@
-import {
-  remarkInclude
-} from "./chunk-SVTXMVLQ.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,
-      _getProcessor: getProcessor
-    }
-  });
-}
-
-export {
-  buildMDX
-};

package/dist/chunk-SMSNZ6N5.js

@@ -1,155 +0,0 @@
-// src/utils/mdx-options.ts
-import * as plugins from "fumadocs-core/mdx-plugins";
-
-// src/mdx-plugins/remark-postprocess.ts
-import { visit } from "unist-util-visit";
-import { valueToEstree } from "estree-util-value-to-estree";
-function remarkPostprocess({
-  injectExports
-}) {
-  return (tree, file) => {
-    let title;
-    const urls = [];
-    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",
-    value: "",
-    data: {
-      estree: {
-        type: "Program",
-        sourceType: "module",
-        body: [
-          {
-            type: "ExportNamedDeclaration",
-            attributes: [],
-            specifiers: [],
-            source: null,
-            declaration: {
-              type: "VariableDeclaration",
-              kind: "let",
-              declarations: [
-                {
-                  type: "VariableDeclarator",
-                  id: {
-                    type: "Identifier",
-                    name
-                  },
-                  init: valueToEstree(value)
-                }
-              ]
-            }
-          }
-        ]
-      }
-    }
-  };
-}
-
-// src/utils/mdx-options.ts
-function pluginOption(def, options = []) {
-  const list = def(Array.isArray(options) ? options : []).filter(
-    Boolean
-  );
-  if (typeof options === "function") {
-    return options(list);
-  }
-  return list;
-}
-function getDefaultMDXOptions({
-  valueToExport = [],
-  rehypeCodeOptions,
-  remarkImageOptions,
-  remarkHeadingOptions,
-  remarkStructureOptions,
-  remarkCodeTabOptions,
-  remarkNpmOptions,
-  _withoutBundler = false,
-  ...mdxOptions
-}) {
-  const mdxExports = [
-    "structuredData",
-    "extractedReferences",
-    "frontmatter",
-    "lastModified",
-    ...valueToExport
-  ];
-  const remarkPlugins = pluginOption(
-    (v) => [
-      plugins.remarkGfm,
-      [
-        plugins.remarkHeading,
-        {
-          generateToc: false,
-          ...remarkHeadingOptions
-        }
-      ],
-      remarkImageOptions !== false && [
-        plugins.remarkImage,
-        {
-          ...remarkImageOptions,
-          useImport: _withoutBundler ? false : remarkImageOptions?.useImport
-        }
-      ],
-      "remarkCodeTab" in plugins && remarkCodeTabOptions !== false && [
-        plugins.remarkCodeTab,
-        remarkCodeTabOptions
-      ],
-      "remarkNpm" in plugins && remarkNpmOptions !== false && [plugins.remarkNpm, remarkNpmOptions],
-      ...v,
-      remarkStructureOptions !== false && [
-        plugins.remarkStructure,
-        remarkStructureOptions
-      ],
-      [
-        remarkPostprocess,
-        { injectExports: mdxExports }
-      ]
-    ],
-    mdxOptions.remarkPlugins
-  );
-  const rehypePlugins = pluginOption(
-    (v) => [
-      rehypeCodeOptions !== false && [plugins.rehypeCode, rehypeCodeOptions],
-      ...v,
-      plugins.rehypeToc
-    ],
-    mdxOptions.rehypePlugins
-  );
-  return {
-    ...mdxOptions,
-    outputFormat: _withoutBundler ? "function-body" : mdxOptions.outputFormat,
-    remarkPlugins,
-    rehypePlugins
-  };
-}
-
-export {
-  getDefaultMDXOptions
-};

package/dist/chunk-SVTXMVLQ.js

@@ -1,139 +0,0 @@
-import {
-  fumaMatter
-} from "./chunk-VWJKRQZR.js";
-
-// src/mdx-plugins/remark-include.ts
-import { unified } from "unified";
-import { visit } from "unist-util-visit";
-import * as path from "path";
-import * as fs from "fs/promises";
-import remarkParse from "remark-parse";
-import remarkMdx from "remark-mdx";
-import { remarkHeading } from "fumadocs-core/mdx-plugins";
-var baseProcessor = unified().use(remarkHeading);
-function flattenNode(node) {
-  if ("children" in node)
-    return node.children.map((child) => flattenNode(child)).join("");
-  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) {
-  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;
-    }
-    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 = [];
-    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 = path.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";
-      }
-    );
-    await Promise.all(queue);
-  }
-  return async (tree, file) => {
-    await update(tree, path.dirname(file.path), file.data);
-  };
-}
-function getDefaultProcessor(format) {
-  const mdProcessor = unified().use(remarkParse);
-  if (format === "md") return mdProcessor;
-  return mdProcessor.use(remarkMdx);
-}
-
-export {
-  remarkInclude
-};