fumadocs-mdx 11.7.4 → 11.8.0

package/dist/vite/index.cjs

@@ -102,6 +102,7 @@ function getDefaultMDXOptions({
   remarkStructureOptions,
   remarkCodeTabOptions,
   remarkNpmOptions,
+  _withoutBundler = false,
   ...mdxOptions
 }) {
   const mdxExports = [
@@ -120,7 +121,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
@@ -145,6 +152,7 @@ function getDefaultMDXOptions({
   );
   return {
     ...mdxOptions,
+    outputFormat: _withoutBundler ? "function-body" : mdxOptions.outputFormat,
     remarkPlugins,
     rehypePlugins
   };
@@ -191,20 +199,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: getDefaultMDXOptions2 } = await Promise.resolve().then(() => (init_mdx_options(), mdx_options_exports));
         if (options?.preset === "minimal") return options;
-        return getDefaultMDXOptions2(options ?? {});
+        return getDefaultMDXOptions2({
+          ...options,
+          _withoutBundler: mode === "remote"
+        });
       }
-      return cachedMdxOptions = uncached();
+      const result = uncached();
+      mdxOptionsCache.set(mode, result);
+      return result;
     }
   };
 }
@@ -226,9 +240,9 @@ function fumaMatter(input) {
   if (!match) {
     return output;
   }
-  output.matter = match[1];
+  output.matter = match[0];
   output.content = input.slice(match[0].length);
-  const loaded = (0, import_js_yaml.load)(output.matter);
+  const loaded = (0, import_js_yaml.load)(match[1]);
   output.data = loaded ?? {};
   return output;
 }
@@ -262,7 +276,7 @@ function extractSection(root, section) {
 }
 function remarkInclude() {
   const TagName = "include";
-  async function update(tree, directory, processor, compiler) {
+  async function update(tree, directory, data) {
     const queue = [];
     (0, import_unist_util_visit.visit)(
       tree,
@@ -290,7 +304,7 @@ function remarkInclude() {
         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(file).slice(1);
               Object.assign(node, {
@@ -302,6 +316,9 @@ function remarkInclude() {
               });
               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);
@@ -311,11 +328,11 @@ function remarkInclude() {
                 );
               parsed = extracted;
             }
-            await update(
+            await update.call(
+              processor,
               parsed,
               path.dirname(targetPath),
-              processor,
-              compiler
+              data
             );
             Object.assign(
               parent && parent.type === "paragraph" ? parent : node,
@@ -335,7 +352,7 @@ ${e instanceof Error ? e.message : String(e)}`,
     await Promise.all(queue);
   }
   return async (tree, file) => {
-    await update(tree, path.dirname(file.path), this, file.data._compiler);
+    await update.call(this, tree, path.dirname(file.path), file.data);
   };
 }
 
@@ -343,29 +360,32 @@ ${e instanceof Error ? e.message : String(e)}`,
 var cache = /* @__PURE__ */ new Map();
 async function buildMDX(cacheKey, source, options) {
   const { filePath, frontmatter, data, _compiler, ...rest } = options;
-  let format = options.format;
-  if (filePath) {
-    format ??= filePath.endsWith(".mdx") ? "mdx" : "md";
-  }
-  format ??= "mdx";
-  const key = `${cacheKey}:${format}`;
-  let cached = cache.get(key);
-  if (!cached) {
-    cached = (0, import_mdx.createProcessor)({
-      outputFormat: "program",
-      ...rest,
-      remarkPlugins: [remarkInclude, ...rest.remarkPlugins ?? []],
-      format
-    });
-    cache.set(key, cached);
+  function getProcessor(format) {
+    const key = `${cacheKey}:${format}`;
+    let processor = cache.get(key);
+    if (!processor) {
+      processor = (0, import_mdx.createProcessor)({
+        outputFormat: "program",
+        ...rest,
+        remarkPlugins: [remarkInclude, ...rest.remarkPlugins ?? []],
+        format
+      });
+      cache.set(key, processor);
+    }
+    return processor;
   }
-  return cached.process({
+  return getProcessor(
+    options.format ?? filePath.endsWith(".mdx") ? "mdx" : "md"
+  ).process({
     value: source,
     path: filePath,
     data: {
       ...data,
       frontmatter,
-      _compiler
+      _compiler,
+      _processor: {
+        getProcessor
+      }
     }
   });
 }
@@ -382,25 +402,8 @@ function countLines(s) {
   return num;
 }
 
-// src/utils/schema.ts
-var import_zod = require("zod");
+// src/utils/validation.ts
 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(),
-  description: import_zod.z.string().optional(),
-  root: import_zod.z.boolean().optional(),
-  defaultOpen: import_zod.z.boolean().optional(),
-  icon: import_zod.z.string().optional()
-});
-var frontmatterSchema = import_zod.z.object({
-  title: import_zod.z.string(),
-  description: import_zod.z.string().optional(),
-  icon: import_zod.z.string().optional(),
-  full: import_zod.z.boolean().optional(),
-  // Fumadocs OpenAPI generated
-  _openapi: import_zod.z.looseObject({}).optional()
-});
 var ValidationError = class extends Error {
   constructor(message, issues) {
     super(
@@ -438,13 +441,20 @@ async function validate(schema, data, context, errorMessage) {
 }
 
 // src/vite/index.ts
-var import_zod2 = require("zod");
+var import_zod = require("zod");
 
 // src/utils/import-formatter.ts
 var import_node_path = __toESM(require("path"), 1);
 function toImportPath(file, config) {
   const ext = import_node_path.default.extname(file);
-  const filename = ext === ".ts" ? file.substring(0, file.length - ext.length) : file;
+  let filename;
+  if (ext === ".ts" && config.jsExtension) {
+    filename = file.substring(0, file.length - ext.length) + ".js";
+  } else if (ext === ".ts") {
+    filename = file.substring(0, file.length - ext.length);
+  } else {
+    filename = file;
+  }
   let importPath;
   if ("relativeTo" in config) {
     importPath = import_node_path.default.relative(config.relativeTo, filename);
@@ -465,6 +475,29 @@ var fs2 = __toESM(require("fs/promises"), 1);
 var path4 = __toESM(require("path"), 1);
 var import_js_yaml2 = require("js-yaml");
 
+// src/utils/git-timestamp.ts
+var import_node_path2 = __toESM(require("path"), 1);
+var import_tinyexec = require("tinyexec");
+var cache2 = /* @__PURE__ */ new Map();
+async function getGitTimestamp(file) {
+  const cached = cache2.get(file);
+  if (cached) return cached;
+  try {
+    const out = await (0, import_tinyexec.x)(
+      "git",
+      ["log", "-1", '--pretty="%ai"', import_node_path2.default.relative(process.cwd(), file)],
+      {
+        throwOnError: true
+      }
+    );
+    const time = new Date(out.stdout);
+    cache2.set(file, time);
+    return time;
+  } catch {
+    return;
+  }
+}
+
 // src/utils/collections.ts
 function getSupportedFormats(collection) {
   return {
@@ -478,17 +511,16 @@ function getGlobPatterns(collection) {
 }
 
 // src/vite/generate-glob.ts
-function generateGlob(name, collection) {
+function generateGlob(name, collection, globOptions) {
   const patterns = mapGlobPatterns(getGlobPatterns(collection));
   const options = {
+    ...globOptions,
     query: {
+      ...globOptions?.query,
       collection: name
     },
     base: getGlobBase(collection)
   };
-  if (collection.type === "meta") {
-    options.import = "default";
-  }
   return `import.meta.glob(${JSON.stringify(patterns)}, ${JSON.stringify(options, null, 2)})`;
 }
 function mapGlobPatterns(patterns) {
@@ -513,31 +545,38 @@ function getGlobBase(collection) {
   return dir;
 }
 
-// src/utils/git-timestamp.ts
-var import_node_path2 = __toESM(require("path"), 1);
-var import_tinyexec = require("tinyexec");
-var cache2 = /* @__PURE__ */ new Map();
-async function getGitTimestamp(file) {
-  const cached = cache2.get(file);
-  if (cached) return cached;
-  try {
-    const out = await (0, import_tinyexec.x)(
-      "git",
-      ["log", "-1", '--pretty="%ai"', import_node_path2.default.relative(process.cwd(), file)],
-      {
-        throwOnError: true
-      }
-    );
-    const time = new Date(out.stdout);
-    cache2.set(file, time);
-    return time;
-  } catch {
-    return;
+// src/vite/generate.ts
+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) {
+  if (collection.async) {
+    return `create.docLazy("${name}", ${generateGlob(name, collection, {
+      query: {
+        only: "frontmatter"
+      },
+      import: "frontmatter"
+    })}, ${generateGlob(name, collection)})`;
   }
+  return `create.doc("${name}", ${generateGlob(name, collection)})`;
+}
+function meta(name, collection) {
+  return `create.meta("${name}", ${generateGlob(name, collection, {
+    import: "default"
+  })})`;
 }
 
 // src/vite/index.ts
-var onlySchema = import_zod2.z.literal(["frontmatter", "all"]);
+var querySchema = import_zod.z.object({
+  only: import_zod.z.literal(["frontmatter", "all"]).default("all"),
+  collection: import_zod.z.string().optional()
+}).loose();
 function mdx(config, options = {}) {
   const { generateIndexFile = true, configPath = "source.config.ts" } = options;
   const loaded = buildConfig(config);
@@ -576,9 +615,8 @@ function mdx(config, options = {}) {
   async function transformContent(file, query, value) {
     const matter = fumaMatter(value);
     const isDevelopment = this.environment.mode === "dev";
-    const parsed = (0, import_node_querystring.parse)(query);
+    const parsed = querySchema.parse((0, import_node_querystring.parse)(query));
     const collection = parsed.collection ? loaded.collections.get(parsed.collection) : void 0;
-    const only = parsed.only ? onlySchema.parse(parsed.only) : "all";
     let schema;
     let mdxOptions;
     switch (collection?.type) {
@@ -602,7 +640,7 @@ function mdx(config, options = {}) {
         `invalid frontmatter in ${file}`
       );
     }
-    if (only === "frontmatter") {
+    if (parsed.only === "frontmatter") {
       return {
         code: `export const frontmatter = ${JSON.stringify(matter.data)}`,
         map: null
@@ -648,35 +686,23 @@ function mdx(config, options = {}) {
         '/// <reference types="vite/client" />',
         `import { fromConfig } from 'fumadocs-mdx/runtime/vite';`,
         `import type * as Config from '${toImportPath(configPath, {
-          relativeTo: outdir
+          relativeTo: outdir,
+          jsExtension: typeof generateIndexFile === "object" ? generateIndexFile.addJsExtension : void 0
         })}';`,
         "",
         `export const create = fromConfig<typeof Config>();`
       ];
-      function docs(name, collection) {
-        const args = [
-          ident(`doc: ${generateGlob(name, collection.docs)}`),
-          ident(`meta: ${generateGlob(name, collection.meta)}`)
-        ].join(",\n");
-        return `export const ${name} = create.docs("${name}", {
-${args}
-});`;
-      }
-      function doc(name, collection) {
-        return `export const ${name} = create.doc("${name}", ${generateGlob(name, collection)});`;
-      }
-      function meta(name, collection) {
-        return `export const ${name} = create.meta("${name}", ${generateGlob(name, collection)});`;
-      }
       for (const [name, collection] of loaded.collections.entries()) {
-        lines.push("");
+        let body;
         if (collection.type === "docs") {
-          lines.push(docs(name, collection));
+          body = docs(name, collection);
         } else if (collection.type === "meta") {
-          lines.push(meta(name, collection));
+          body = meta(name, collection);
         } else {
-          lines.push(doc(name, collection));
+          body = doc(name, collection);
         }
+        lines.push("");
+        lines.push(`export const ${name} = ${body};`);
       }
       await fs2.writeFile(path4.join(outdir, outFile), lines.join("\n"));
     },

package/dist/vite/index.d.cts

@@ -6,7 +6,12 @@ interface PluginOptions {
      *
      * @defaultValue true
      */
-    generateIndexFile?: boolean;
+    generateIndexFile?: boolean | {
+        /**
+         * add `.js` extensions to imports, needed for ESM without bundler resolution
+         */
+        addJsExtension?: boolean;
+    };
     /**
      * @defaultValue source.config.ts
      */

package/dist/vite/index.d.ts

@@ -6,7 +6,12 @@ interface PluginOptions {
      *
      * @defaultValue true
      */
-    generateIndexFile?: boolean;
+    generateIndexFile?: boolean | {
+        /**
+         * add `.js` extensions to imports, needed for ESM without bundler resolution
+         */
+        addJsExtension?: boolean;
+    };
     /**
      * @defaultValue source.config.ts
      */

package/dist/vite/index.js

@@ -1,26 +1,26 @@
 import {
-  buildMDX,
   countLines
-} from "../chunk-2K55VKP6.js";
+} from "../chunk-UCY7OBZG.js";
 import {
   getGlobPatterns,
   ident,
   toImportPath
-} from "../chunk-OWZSTKKX.js";
-import {
-  getGitTimestamp
-} from "../chunk-VUEZTR2H.js";
+} from "../chunk-6Y5JDZHD.js";
 import {
   ValidationError,
+  getGitTimestamp,
   validate
-} from "../chunk-ZOWJF3OH.js";
-import "../chunk-PQCNPAD3.js";
+} from "../chunk-GX3THK2Q.js";
+import {
+  buildMDX
+} from "../chunk-7JFPDRW7.js";
+import "../chunk-IGXZS2W6.js";
 import {
   buildConfig
-} from "../chunk-JFNBRKRV.js";
+} from "../chunk-XVL4ZQFK.js";
 import {
   fumaMatter
-} from "../chunk-KVWX6THC.js";
+} from "../chunk-VWJKRQZR.js";
 
 // src/vite/index.ts
 import { parse } from "querystring";
@@ -30,17 +30,16 @@ import * as path from "path";
 import { load } from "js-yaml";
 
 // src/vite/generate-glob.ts
-function generateGlob(name, collection) {
+function generateGlob(name, collection, globOptions) {
   const patterns = mapGlobPatterns(getGlobPatterns(collection));
   const options = {
+    ...globOptions,
     query: {
+      ...globOptions?.query,
       collection: name
     },
     base: getGlobBase(collection)
   };
-  if (collection.type === "meta") {
-    options.import = "default";
-  }
   return `import.meta.glob(${JSON.stringify(patterns)}, ${JSON.stringify(options, null, 2)})`;
 }
 function mapGlobPatterns(patterns) {
@@ -65,8 +64,38 @@ function getGlobBase(collection) {
   return dir;
 }
 
+// src/vite/generate.ts
+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) {
+  if (collection.async) {
+    return `create.docLazy("${name}", ${generateGlob(name, collection, {
+      query: {
+        only: "frontmatter"
+      },
+      import: "frontmatter"
+    })}, ${generateGlob(name, collection)})`;
+  }
+  return `create.doc("${name}", ${generateGlob(name, collection)})`;
+}
+function meta(name, collection) {
+  return `create.meta("${name}", ${generateGlob(name, collection, {
+    import: "default"
+  })})`;
+}
+
 // src/vite/index.ts
-var onlySchema = z.literal(["frontmatter", "all"]);
+var querySchema = z.object({
+  only: z.literal(["frontmatter", "all"]).default("all"),
+  collection: z.string().optional()
+}).loose();
 function mdx(config, options = {}) {
   const { generateIndexFile = true, configPath = "source.config.ts" } = options;
   const loaded = buildConfig(config);
@@ -105,9 +134,8 @@ function mdx(config, options = {}) {
   async function transformContent(file, query, value) {
     const matter = fumaMatter(value);
     const isDevelopment = this.environment.mode === "dev";
-    const parsed = parse(query);
+    const parsed = querySchema.parse(parse(query));
     const collection = parsed.collection ? loaded.collections.get(parsed.collection) : void 0;
-    const only = parsed.only ? onlySchema.parse(parsed.only) : "all";
     let schema;
     let mdxOptions;
     switch (collection?.type) {
@@ -131,7 +159,7 @@ function mdx(config, options = {}) {
         `invalid frontmatter in ${file}`
       );
     }
-    if (only === "frontmatter") {
+    if (parsed.only === "frontmatter") {
       return {
         code: `export const frontmatter = ${JSON.stringify(matter.data)}`,
         map: null
@@ -177,35 +205,23 @@ function mdx(config, options = {}) {
         '/// <reference types="vite/client" />',
         `import { fromConfig } from 'fumadocs-mdx/runtime/vite';`,
         `import type * as Config from '${toImportPath(configPath, {
-          relativeTo: outdir
+          relativeTo: outdir,
+          jsExtension: typeof generateIndexFile === "object" ? generateIndexFile.addJsExtension : void 0
         })}';`,
         "",
         `export const create = fromConfig<typeof Config>();`
       ];
-      function docs(name, collection) {
-        const args = [
-          ident(`doc: ${generateGlob(name, collection.docs)}`),
-          ident(`meta: ${generateGlob(name, collection.meta)}`)
-        ].join(",\n");
-        return `export const ${name} = create.docs("${name}", {
-${args}
-});`;
-      }
-      function doc(name, collection) {
-        return `export const ${name} = create.doc("${name}", ${generateGlob(name, collection)});`;
-      }
-      function meta(name, collection) {
-        return `export const ${name} = create.meta("${name}", ${generateGlob(name, collection)});`;
-      }
       for (const [name, collection] of loaded.collections.entries()) {
-        lines.push("");
+        let body;
         if (collection.type === "docs") {
-          lines.push(docs(name, collection));
+          body = docs(name, collection);
         } else if (collection.type === "meta") {
-          lines.push(meta(name, collection));
+          body = meta(name, collection);
         } else {
-          lines.push(doc(name, collection));
+          body = doc(name, collection);
         }
+        lines.push("");
+        lines.push(`export const ${name} = ${body};`);
       }
       await fs.writeFile(path.join(outdir, outFile), lines.join("\n"));
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-mdx",
-  "version": "11.7.4",
+  "version": "11.8.0",
   "description": "The built-in source for Fumadocs",
   "keywords": [
     "NextJs",
@@ -18,6 +18,11 @@
       "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",
@@ -54,7 +59,7 @@
     "@mdx-js/mdx": "^3.1.0",
     "@standard-schema/spec": "^1.0.0",
     "chokidar": "^4.0.3",
-    "esbuild": "^0.25.8",
+    "esbuild": "^0.25.9",
     "estree-util-value-to-estree": "^3.4.0",
     "js-yaml": "^4.1.0",
     "lru-cache": "^11.1.0",
@@ -62,26 +67,26 @@
     "tinyexec": "^1.0.1",
     "tinyglobby": "^0.2.14",
     "unist-util-visit": "^5.0.0",
-    "zod": "^4.0.15"
+    "zod": "^4.0.17"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
     "@types/mdast": "^4.0.3",
     "@types/mdx": "^2.0.13",
-    "@types/node": "^24.2.0",
-    "@types/react": "^19.1.9",
+    "@types/node": "^24.3.0",
+    "@types/react": "^19.1.10",
     "mdast-util-mdx-jsx": "^3.2.0",
-    "next": "^15.4.6",
+    "next": "^15.5.0",
     "react": "^19.1.1",
-    "rollup": "^4.46.2",
+    "rollup": "^4.46.3",
     "unified": "^11.0.5",
     "vfile": "^6.0.3",
-    "vite": "^7.1.0",
-    "webpack": "^5.101.0",
-    "fumadocs-core": "15.6.9",
+    "vite": "^7.1.3",
+    "webpack": "^5.101.3",
+    "@fumadocs/mdx-remote": "1.4.0",
     "eslint-config-custom": "0.0.0",
-    "tsconfig": "0.0.0",
-    "@fumadocs/mdx-remote": "1.4.0"
+    "fumadocs-core": "15.7.0",
+    "tsconfig": "0.0.0"
   },
   "peerDependencies": {
     "@fumadocs/mdx-remote": "^1.4.0",