fumadocs-mdx 12.0.2 → 13.0.0

package/dist/vite/index.d.cts

@@ -1,6 +1,19 @@
 import { Plugin } from 'vite';
 
-declare function postInstall(configPath?: string, outDir?: string, addJsExtension?: boolean): Promise<void>;
+interface IndexFileOptions {
+    /**
+     * Runtime compat fallbacks for Vite specific APIs
+     *
+     * - `bun`: use Bun-specific APIs.
+     * - `node`: use Node.js APIs.
+     * - `false` (default): no fallback.
+     */
+    runtime?: 'bun' | 'node' | false;
+    /**
+     * add `.js` extensions to imports, needed for ESM without bundler resolution
+     */
+    addJsExtension?: boolean;
+}
 
 interface PluginOptions {
     /**
@@ -8,19 +21,25 @@ interface PluginOptions {
      *
      * @defaultValue true
      */
-    generateIndexFile?: boolean | {
-        out?: string;
-        /**
-         * add `.js` extensions to imports, needed for ESM without bundler resolution
-         */
-        addJsExtension?: boolean;
-    };
+    generateIndexFile?: boolean | IndexFileOptions;
     /**
      * @defaultValue source.config.ts
      */
     configPath?: string;
+    /**
+     * Update Vite config to fix module resolution of Fumadocs
+     *
+     * @defaultValue true
+     */
+    updateViteConfig?: boolean;
+    /**
+     * Output directory of generated files
+     *
+     * @defaultValue '.source'
+     */
+    outDir?: string;
 }
-
-declare function mdx(config: Record<string, unknown>, options?: PluginOptions): Plugin;
+declare function mdx(config: Record<string, unknown>, pluginOptions?: PluginOptions): Promise<Plugin>;
+declare function postInstall(configPath?: string, pluginOptions?: PluginOptions): Promise<void>;
 
 export { type PluginOptions, mdx as default, postInstall };

package/dist/vite/index.d.ts

@@ -1,6 +1,19 @@
 import { Plugin } from 'vite';
 
-declare function postInstall(configPath?: string, outDir?: string, addJsExtension?: boolean): Promise<void>;
+interface IndexFileOptions {
+    /**
+     * Runtime compat fallbacks for Vite specific APIs
+     *
+     * - `bun`: use Bun-specific APIs.
+     * - `node`: use Node.js APIs.
+     * - `false` (default): no fallback.
+     */
+    runtime?: 'bun' | 'node' | false;
+    /**
+     * add `.js` extensions to imports, needed for ESM without bundler resolution
+     */
+    addJsExtension?: boolean;
+}
 
 interface PluginOptions {
     /**
@@ -8,19 +21,25 @@ interface PluginOptions {
      *
      * @defaultValue true
      */
-    generateIndexFile?: boolean | {
-        out?: string;
-        /**
-         * add `.js` extensions to imports, needed for ESM without bundler resolution
-         */
-        addJsExtension?: boolean;
-    };
+    generateIndexFile?: boolean | IndexFileOptions;
     /**
      * @defaultValue source.config.ts
      */
     configPath?: string;
+    /**
+     * Update Vite config to fix module resolution of Fumadocs
+     *
+     * @defaultValue true
+     */
+    updateViteConfig?: boolean;
+    /**
+     * Output directory of generated files
+     *
+     * @defaultValue '.source'
+     */
+    outDir?: string;
 }
-
-declare function mdx(config: Record<string, unknown>, options?: PluginOptions): Plugin;
+declare function mdx(config: Record<string, unknown>, pluginOptions?: PluginOptions): Promise<Plugin>;
+declare function postInstall(configPath?: string, pluginOptions?: PluginOptions): Promise<void>;
 
 export { type PluginOptions, mdx as default, postInstall };

package/dist/vite/index.js

@@ -1,44 +1,195 @@
-import {
-  entry,
-  postInstall
-} from "../chunk-ZX7TM4AR.js";
-import "../chunk-6Y5JDZHD.js";
-import "../chunk-LGYVNESJ.js";
-import {
-  buildConfig
-} from "../chunk-U4MQ44TS.js";
 import {
   toVite
-} from "../chunk-VXEBLM4X.js";
+} from "../chunk-XV5Z4BFL.js";
+import {
+  getGlobPatterns,
+  ident,
+  toImportPath
+} from "../chunk-6Y5JDZHD.js";
 import {
   createMdxLoader
-} from "../chunk-RMDXSZYE.js";
-import "../chunk-QAUWMR5D.js";
-import "../chunk-LMG6UWCL.js";
+} from "../chunk-CEA6MYJU.js";
+import "../chunk-3J3WL7WN.js";
+import "../chunk-K5ZLPEIQ.js";
+import {
+  buildConfig
+} from "../chunk-U4MQ44TS.js";
 import {
   ValidationError,
+  findConfigFile,
+  resolvedConfig,
   validate
-} from "../chunk-IQAEAI4P.js";
-import {
-  resolvedConfig
-} from "../chunk-XMFLD5J6.js";
+} from "../chunk-HI62EXSB.js";
 import "../chunk-VWJKRQZR.js";
+import {
+  createPluginHandler
+} from "../chunk-4MAYA5QX.js";
 
 // src/vite/index.ts
 import {
   mergeConfig
 } from "vite";
 import { parse } from "querystring";
-import * as fs from "fs/promises";
-import * as path from "path";
+import * as path3 from "path";
 import { load } from "js-yaml";
+
+// src/utils/glob-import.ts
+import { globSync } from "tinyglobby";
+import path from "path";
+import { pathToFileURL } from "url";
+function generateGlobImport(patterns, options) {
+  let code = "{";
+  const result = globSync(patterns, {
+    cwd: options.base
+  });
+  for (const item of result) {
+    const fullPath = path.join(options.base, item);
+    const url = pathToFileURL(fullPath);
+    for (const [k, v] of Object.entries(options.query ?? {})) {
+      url.searchParams.set(k, v);
+    }
+    let line = `${JSON.stringify(item)}: () => import(${JSON.stringify(url.href)})`;
+    if (options.import) {
+      line += `.then(mod => mod[${JSON.stringify(options.import)}])`;
+    }
+    code += `${line}, `;
+  }
+  code += "}";
+  return code;
+}
+
+// src/plugins/vite.ts
+import path2 from "path";
+function vite(options) {
+  let config;
+  return {
+    config(v) {
+      config = v;
+    },
+    emit() {
+      console.log("[Fumadocs MDX] Generating index files");
+      return [
+        {
+          path: "index.ts",
+          content: indexFile(this.configPath, this.outDir, config, options)
+        }
+      ];
+    }
+  };
+}
+function indexFile(configPath, outDir, config, options) {
+  const { addJsExtension = false, runtime } = options;
+  const lines = [
+    '/// <reference types="vite/client" />',
+    `import { fromConfig } from 'fumadocs-mdx/runtime/vite';`,
+    `import type * as Config from '${toImportPath(configPath, {
+      relativeTo: outDir,
+      jsExtension: addJsExtension
+    })}';`,
+    "",
+    `export const create = fromConfig<typeof Config>();`
+  ];
+  function docs(name, collection) {
+    const obj = [
+      ident(`doc: ${doc(name, collection.docs)}`),
+      ident(`meta: ${meta(name, collection.meta)}`)
+    ].join(",\n");
+    return `{
+${obj}
+}`;
+  }
+  function doc(name, collection) {
+    const patterns = getGlobPatterns(collection);
+    const base = getGlobBase(collection);
+    const docGlob = generateGlob(patterns, {
+      query: {
+        collection: name
+      },
+      base
+    });
+    if (collection.async) {
+      const headBlob = generateGlob(patterns, {
+        query: {
+          only: "frontmatter",
+          collection: name
+        },
+        import: "frontmatter",
+        base
+      });
+      return `create.docLazy("${name}", "${base}", ${headBlob}, ${docGlob})`;
+    }
+    return `create.doc("${name}", "${base}", ${docGlob})`;
+  }
+  function meta(name, collection) {
+    const patterns = getGlobPatterns(collection);
+    const base = getGlobBase(collection);
+    return `create.meta("${name}", "${base}", ${generateGlob(patterns, {
+      import: "default",
+      base,
+      query: {
+        collection: name
+      }
+    })})`;
+  }
+  function generateGlob(patterns, options2) {
+    patterns = mapGlobPatterns(patterns);
+    if (runtime === "node" || runtime === "bun") {
+      return generateGlobImport(patterns, options2);
+    } else {
+      return `import.meta.glob(${JSON.stringify(patterns)}, ${JSON.stringify(
+        {
+          ...options2,
+          base: path2.relative(outDir, options2.base)
+        },
+        null,
+        2
+      )})`;
+    }
+  }
+  for (const [name, collection] of config.collections.entries()) {
+    let body;
+    if (collection.type === "docs") {
+      body = docs(name, collection);
+    } else if (collection.type === "meta") {
+      body = meta(name, collection);
+    } else {
+      body = doc(name, collection);
+    }
+    lines.push("");
+    lines.push(`export const ${name} = ${body};`);
+  }
+  return lines.join("\n");
+}
+function mapGlobPatterns(patterns) {
+  return patterns.map(enforceRelative);
+}
+function enforceRelative(file) {
+  if (file.startsWith("./")) return file;
+  if (file.startsWith("/")) return `.${file}`;
+  return `./${file}`;
+}
+function getGlobBase(collection) {
+  let dir = collection.dir;
+  if (Array.isArray(dir)) {
+    if (dir.length !== 1)
+      throw new Error(
+        `[Fumadocs MDX] Vite Plugin doesn't support multiple \`dir\` for a collection at the moment.`
+      );
+    dir = dir[0];
+  }
+  return enforceRelative(dir);
+}
+
+// src/vite/index.ts
 var FumadocsDeps = ["fumadocs-core", "fumadocs-ui", "fumadocs-openapi"];
-function mdx(config, options = {}) {
-  const { generateIndexFile = true, configPath = "source.config.ts" } = options;
-  const loaded = buildConfig(config);
+async function mdx(config, pluginOptions = {}) {
+  const options = applyDefaults(pluginOptions);
+  const { updateViteConfig } = options;
+  const pluginHandler = createVitePluginHandler(options);
+  const loaded = await pluginHandler.init(buildConfig(config));
   const mdxLoader = toVite(createMdxLoader(resolvedConfig(loaded)));
-  async function transformMeta(path2, query, value) {
-    const isJson = path2.endsWith(".json");
+  async function transformMeta(path4, query, value) {
+    const isJson = path4.endsWith(".json");
     const parsed = parse(query);
     const collection = parsed.collection ? loaded.collections.get(parsed.collection) : void 0;
     if (!collection) return null;
@@ -61,8 +212,8 @@ function mdx(config, options = {}) {
     const out = await validate(
       schema,
       data,
-      { path: path2, source: value },
-      `invalid data in ${path2}`
+      { path: path4, source: value },
+      `invalid data in ${path4}`
     );
     return {
       code: isJson ? JSON.stringify(out) : `export default ${JSON.stringify(out)}`,
@@ -74,6 +225,7 @@ function mdx(config, options = {}) {
     // needed, otherwise other plugins will be executed before our `transform`.
     enforce: "pre",
     config(config2) {
+      if (!updateViteConfig) return config2;
       return mergeConfig(config2, {
         optimizeDeps: {
           exclude: FumadocsDeps
@@ -85,16 +237,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 dir = path.dirname(out);
-      await fs.mkdir(dir, { recursive: true });
-      await fs.writeFile(out, entry(configPath, loaded, dir, addJsExtension));
+      await pluginHandler.emitAndWrite();
     },
     async transform(value, id) {
       const [file, query = ""] = id.split("?");
-      const ext = path.extname(file);
+      const ext = path3.extname(file);
       try {
         if ([".yaml", ".json"].includes(ext))
           return await transformMeta(file, query, value);
@@ -109,6 +256,38 @@ function mdx(config, options = {}) {
     }
   };
 }
+async function postInstall(configPath = findConfigFile(), pluginOptions = {}) {
+  const { loadConfig } = await import("../load-MNG3CLET.js");
+  const options = applyDefaults(pluginOptions);
+  const pluginHandler = createVitePluginHandler(options);
+  await pluginHandler.init(await loadConfig(configPath, options.outDir, true));
+  await pluginHandler.emitAndWrite();
+  console.log("[MDX] types generated");
+}
+function createVitePluginHandler({
+  configPath,
+  outDir,
+  generateIndexFile
+}) {
+  return createPluginHandler(
+    {
+      environment: "vite",
+      configPath,
+      outDir
+    },
+    [
+      generateIndexFile !== false && vite(typeof generateIndexFile === "object" ? generateIndexFile : {})
+    ]
+  );
+}
+function applyDefaults(options) {
+  return {
+    updateViteConfig: options.updateViteConfig ?? true,
+    generateIndexFile: options.generateIndexFile ?? true,
+    configPath: options.configPath ?? "source.config.ts",
+    outDir: options.outDir ?? ".source"
+  };
+}
 export {
   mdx as default,
   postInstall

package/dist/{watcher-HGOH3APP.js → watcher-WXJDWRZY.js}

@@ -1,4 +1,4 @@
-// src/next/map/watcher.ts
+// src/next/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": "12.0.2",
+  "version": "13.0.0",
   "description": "The built-in source for Fumadocs",
   "keywords": [
     "NextJs",
@@ -45,6 +45,14 @@
       "import": "./dist/runtime/vite/server.js",
       "types": "./dist/runtime/vite/server.d.ts"
     },
+    "./runtime/vite.server": {
+      "import": "./dist/runtime/vite/server.js",
+      "types": "./dist/runtime/vite/server.d.ts"
+    },
+    "./runtime/vite.browser": {
+      "import": "./dist/runtime/vite/browser.js",
+      "types": "./dist/runtime/vite/browser.d.ts"
+    },
     "./node/loader": {
       "import": "./dist/node/loader.js",
       "types": "./dist/node/loader.d.ts"
@@ -52,6 +60,10 @@
     "./bun": {
       "import": "./dist/bun/index.js",
       "types": "./dist/bun/index.d.ts"
+    },
+    "./plugins/*": {
+      "import": "./dist/plugins/*.js",
+      "types": "./dist/plugins/*.d.ts"
     }
   },
   "main": "./dist/index.js",
@@ -65,8 +77,8 @@
     "@mdx-js/mdx": "^3.1.1",
     "@standard-schema/spec": "^1.0.0",
     "chokidar": "^4.0.3",
-    "esbuild": "^0.25.10",
-    "estree-util-value-to-estree": "^3.4.0",
+    "esbuild": "^0.25.11",
+    "estree-util-value-to-estree": "^3.4.1",
     "js-yaml": "^4.1.0",
     "lru-cache": "^11.2.2",
     "mdast-util-to-markdown": "^2.1.2",
@@ -76,36 +88,37 @@
     "tinyexec": "^1.0.1",
     "tinyglobby": "^0.2.15",
     "unified": "^11.0.5",
+    "unist-util-remove-position": "^5.0.0",
     "unist-util-visit": "^5.0.0",
-    "zod": "^4.1.11"
+    "zod": "^4.1.12"
   },
   "devDependencies": {
-    "@types/bun": "^1.2.23",
+    "@types/bun": "^1.3.0",
     "@types/js-yaml": "^4.0.9",
-    "@types/mdast": "^4.0.3",
+    "@types/mdast": "^4.0.4",
     "@types/mdx": "^2.0.13",
-    "@types/node": "^24.6.2",
-    "@types/react": "^19.2.0",
+    "@types/node": "^24.9.1",
+    "@types/react": "^19.2.2",
     "mdast-util-directive": "^3.1.0",
     "mdast-util-mdx-jsx": "^3.2.0",
-    "next": "^15.5.4",
+    "next": "16.0.0",
     "react": "^19.2.0",
     "remark": "^15.0.1",
     "remark-directive": "^4.0.0",
     "remark-stringify": "^11.0.0",
-    "rollup": "^4.52.3",
+    "rollup": "^4.52.5",
     "vfile": "^6.0.3",
-    "vite": "^7.1.8",
-    "webpack": "^5.102.0",
-    "@fumadocs/mdx-remote": "1.4.1",
+    "vite": "^7.1.11",
+    "webpack": "^5.102.1",
+    "@fumadocs/mdx-remote": "1.4.3",
     "eslint-config-custom": "0.0.0",
-    "fumadocs-core": "15.8.3",
+    "fumadocs-core": "16.0.0",
     "tsconfig": "0.0.0"
   },
   "peerDependencies": {
     "@fumadocs/mdx-remote": "^1.4.0",
-    "fumadocs-core": "^14.0.0 || ^15.0.0",
-    "next": "^15.3.0",
+    "fumadocs-core": "^15.0.0 || ^16.0.0",
+    "next": "^15.3.0 || ^16.0.0",
     "react": "*",
     "vite": "6.x.x || 7.x.x"
   },

package/dist/browser-BupUnhpC.d.ts

@@ -1,98 +0,0 @@
-import { createProcessor } from '@mdx-js/mdx';
-import { StructuredData } from 'fumadocs-core/mdx-plugins';
-import { TableOfContents } from 'fumadocs-core/server';
-import { FC, ReactNode } from 'react';
-import { MDXProps } from 'mdx/types';
-import { E as ExtractedReference, a as DocCollection, b as DocsCollection, M as MetaCollection } from './define-DJbJduHy.js';
-import { StandardSchemaV1 } from '@standard-schema/spec';
-
-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[];
-    _markdown?: string;
-}
-interface FumadocsDataMap {
-    /**
-     * [Fumadocs MDX] raw frontmatter, you can modify it
-     */
-    frontmatter?: Record<string, unknown>;
-    /**
-     * [Fumadocs MDX] additional ESM exports to write
-     */
-    'mdx-export'?: {
-        name: string;
-        value: unknown;
-    }[];
-    extractedReferences: ExtractedReference[];
-    /**
-     * [Fumadocs MDX] The compiler object from loader
-     */
-    _compiler?: CompilerOptions;
-    _getProcessor?: (format: 'md' | 'mdx') => Processor;
-    /**
-     * [Fumadocs MDX] Processed Markdown content before `remark-rehype`.
-     */
-    _markdown?: string;
-}
-declare module 'vfile' {
-    interface DataMap extends FumadocsDataMap {
-    }
-}
-
-type CompiledMDXFile<Frontmatter> = CompiledMDXProperties<Frontmatter> & Record<string, unknown>;
-type DocMap<Frontmatter> = Record<string, (() => Promise<CompiledMDXFile<Frontmatter>>) & {
-    base: string;
-}>;
-type MetaMap<Data> = Record<string, (() => Promise<Data>) & {
-    base: string;
-}>;
-interface LazyDocMap<Frontmatter> {
-    base: string;
-    head: Record<string, () => Promise<Frontmatter>>;
-    body: Record<string, () => Promise<CompiledMDXFile<Frontmatter>>>;
-}
-
-interface BaseCreate<Config> {
-    doc: <Name extends keyof Config>(name: Name, base: string, glob: Record<string, () => Promise<unknown>>) => Config[Name] extends DocCollection<infer Schema> | DocsCollection<infer Schema> ? DocMap<StandardSchemaV1.InferOutput<Schema>> : never;
-    docLazy: <Name extends keyof Config>(name: Name, base: string, headGlob: Record<string, () => Promise<unknown>>, bodyGlob: Record<string, () => Promise<unknown>>) => Config[Name] extends DocCollection<infer Schema> | DocsCollection<infer Schema> ? LazyDocMap<StandardSchemaV1.InferOutput<Schema>> : never;
-    meta: <Name extends keyof Config>(name: Name, base: string, glob: Record<string, () => Promise<unknown>>) => Config[Name] extends MetaCollection<infer Schema> | DocsCollection<StandardSchemaV1, infer Schema> ? MetaMap<StandardSchemaV1.InferOutput<Schema>> : never;
-}
-declare function fromConfigBase<Config>(): BaseCreate<Config>;
-
-interface ClientLoaderOptions<Frontmatter, Props> {
-    /**
-     * Loader ID (usually your collection name)
-     *
-     * The code splitting strategy of frameworks like Tanstack Start may duplicate `createClientLoader()` into different chunks.
-     *
-     * We use loader ID to share cache between multiple instances of client loader.
-     *
-     * @defaultValue ''
-     */
-    id?: string;
-    component: (loaded: CompiledMDXFile<Frontmatter>, props: Props) => ReactNode;
-}
-type ClientRenderer<Props> = Record<string, FC<Props>>;
-interface ClientLoader<Frontmatter, Props> {
-    preload: (path: string) => Promise<CompiledMDXFile<Frontmatter>>;
-    /**
-     * Get a component that renders content with `React.lazy`
-     */
-    getComponent: (path: string) => FC<Props>;
-    getRenderer: () => ClientRenderer<Props>;
-}
-declare function createClientLoader<Frontmatter, Props = object>(files: Record<string, () => Promise<CompiledMDXFile<Frontmatter>>>, options: ClientLoaderOptions<Frontmatter, Props>): ClientLoader<Frontmatter, Props>;
-declare function toClientRenderer<Frontmatter, Props = object>(files: Record<string, () => Promise<CompiledMDXFile<Frontmatter>>>, component: (loaded: CompiledMDXFile<Frontmatter>, props: Props) => ReactNode): ClientRenderer<Props>;
-
-export { type BaseCreate as B, type ClientLoader as C, type DocMap as D, type LazyDocMap as L, type MetaMap as M, type ClientLoaderOptions as a, type CompiledMDXFile as b, createClientLoader as c, fromConfigBase as f, toClientRenderer as t };