fumadocs-mdx 11.1.2 → 11.2.0

package/dist/{chunk-QYUB4AKH.js → chunk-BP4S5VOB.js}

@@ -1,3 +1,7 @@
+import {
+  getDefaultMDXOptions
+} from "./chunk-MKWJLEE7.js";
+
 // src/config/cached.ts
 import { createHash } from "node:crypto";
 import fs from "node:fs";
@@ -6,39 +10,6 @@ import fs from "node:fs";
 import * as path from "node:path";
 import { pathToFileURL } from "node:url";
 import { build } from "esbuild";
-
-// src/config/validate.ts
-function validateConfig(config) {
-  const out = {
-    collections: /* @__PURE__ */ new Map(),
-    _runtime: {
-      files: /* @__PURE__ */ new Map()
-    }
-  };
-  for (const [k, v] of Object.entries(config)) {
-    if (!v) {
-      continue;
-    }
-    if (typeof v === "object" && "_doc" in v && v._doc === "collections") {
-      out.collections.set(
-        k,
-        v
-      );
-      continue;
-    }
-    if (k === "default") {
-      out.global = v;
-      continue;
-    }
-    return [
-      `Unknown export "${k}", you can only export collections from source configuration file.`,
-      null
-    ];
-  }
-  return [null, out];
-}
-
-// src/config/load.ts
 function findConfigFile() {
   return path.resolve("source.config.ts");
 }
@@ -63,13 +34,48 @@ async function loadConfig(configPath) {
     throw new Error("failed to compile configuration file");
   }
   const url = pathToFileURL(outputPath);
-  const [err, config] = validateConfig(
+  const [err, config] = buildConfig(
     // every call to `loadConfig` will cause the previous cache to be ignored
     await import(`${url.toString()}?hash=${Date.now().toString()}`)
   );
   if (err !== null) throw new Error(err);
   return config;
 }
+function buildConfig(config) {
+  const collections = /* @__PURE__ */ new Map();
+  let globalConfig;
+  for (const [k, v] of Object.entries(config)) {
+    if (!v) {
+      continue;
+    }
+    if (typeof v === "object" && "_doc" in v && v._doc === "collections") {
+      collections.set(
+        k,
+        v
+      );
+      continue;
+    }
+    if (k === "default") {
+      globalConfig = v;
+      continue;
+    }
+    return [
+      `Unknown export "${k}", you can only export collections from source configuration file.`,
+      null
+    ];
+  }
+  return [
+    null,
+    {
+      global: globalConfig,
+      collections,
+      defaultMdxOptions: getDefaultMDXOptions(globalConfig?.mdxOptions ?? {}),
+      _runtime: {
+        files: /* @__PURE__ */ new Map()
+      }
+    }
+  ];
+}
 
 // src/config/cached.ts
 var cache = /* @__PURE__ */ new Map();

package/dist/{chunk-YA4EPE5U.js → chunk-MKWJLEE7.js}

@@ -1,52 +1,3 @@
-// src/utils/schema.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.object({}).passthrough().optional()
-});
-
-// src/config/define.ts
-function defineCollections(options) {
-  return {
-    _doc: "collections",
-    // @ts-expect-error -- internal type inferring
-    _type: void 0,
-    ...options
-  };
-}
-function defineDocs(options) {
-  const dir = options?.dir ?? "content/docs";
-  return {
-    docs: defineCollections({
-      type: "doc",
-      dir,
-      schema: frontmatterSchema,
-      ...options?.docs
-    }),
-    meta: defineCollections({
-      type: "meta",
-      dir,
-      schema: metaSchema,
-      ...options?.meta
-    })
-  };
-}
-function defineConfig(config = {}) {
-  return config;
-}
-
 // src/utils/mdx-options.ts
 import {
   rehypeCode,
@@ -161,10 +112,5 @@ function getDefaultMDXOptions({
 }
 
 export {
-  metaSchema,
-  frontmatterSchema,
-  defineCollections,
-  defineDocs,
-  defineConfig,
   getDefaultMDXOptions
 };

package/dist/config/index.d.ts

@@ -21,6 +21,10 @@ interface MDXOptions extends ProcessorOptions {
      * Custom Vfile data
      */
     data?: Record<string, unknown>;
+    _compiler?: CompilerOptions;
+}
+interface CompilerOptions {
+    addDependency: (file: string) => void;
 }
 
 declare const metaSchema: z.ZodObject<{

package/dist/config/index.js

@@ -1,11 +1,55 @@
 import {
-  defineCollections,
-  defineConfig,
-  defineDocs,
-  frontmatterSchema,
-  getDefaultMDXOptions,
-  metaSchema
-} from "../chunk-YA4EPE5U.js";
+  getDefaultMDXOptions
+} from "../chunk-MKWJLEE7.js";
+
+// src/utils/schema.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.object({}).passthrough().optional()
+});
+
+// src/config/define.ts
+function defineCollections(options) {
+  return {
+    _doc: "collections",
+    // @ts-expect-error -- internal type inferring
+    _type: void 0,
+    ...options
+  };
+}
+function defineDocs(options) {
+  const dir = options?.dir ?? "content/docs";
+  return {
+    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,

package/dist/loader-mdx.js

@@ -1,24 +1,43 @@
-import {
-  getDefaultMDXOptions
-} from "./chunk-YA4EPE5U.js";
 import {
   getConfigHash,
   getManifestEntryPath,
   loadConfigCached
-} from "./chunk-QYUB4AKH.js";
+} from "./chunk-BP4S5VOB.js";
+import "./chunk-MKWJLEE7.js";
 
 // src/loader-mdx.ts
-import path2 from "node:path";
-import fs2 from "node:fs/promises";
+import * as path3 from "node:path";
+import * as fs2 from "node:fs/promises";
 import { parse } from "node:querystring";
 import grayMatter from "gray-matter";
 
 // src/utils/build-mdx.ts
 import { createProcessor } from "@mdx-js/mdx";
+import { visit } from "unist-util-visit";
+import { readFileSync } from "node:fs";
+import * as path from "node:path";
+import matter from "gray-matter";
 var cache = /* @__PURE__ */ new Map();
 function cacheKey(group, format) {
   return `${group}:${format}`;
 }
+function remarkInclude(options) {
+  return (tree, file) => {
+    visit(tree, "mdxJsxFlowElement", (node) => {
+      if (node.name === "include") {
+        const child = node.children.at(0);
+        if (!child || child.type !== "text") return;
+        const specifier = child.value;
+        const targetPath = path.resolve(path.dirname(file.path), specifier);
+        const content = readFileSync(targetPath);
+        const parsed = this.parse(matter(content).content);
+        options.addDependency(targetPath);
+        Object.assign(node, parsed);
+      }
+      return "skip";
+    });
+  };
+}
 function buildMDX(group, configHash, source, options = {}) {
   const { filePath, frontmatter, data, ...rest } = options;
   let format = options.format;
@@ -34,6 +53,10 @@ function buildMDX(group, configHash, source, options = {}) {
         outputFormat: "program",
         development: process.env.NODE_ENV === "development",
         ...rest,
+        remarkPlugins: [
+          options._compiler ? [remarkInclude, options._compiler] : null,
+          ...rest.remarkPlugins ?? []
+        ],
         format
       }),
       configHash
@@ -69,20 +92,20 @@ function formatError(file, error) {
 }
 
 // src/utils/git-timestamp.ts
-import path from "node:path";
+import path2 from "node:path";
 import fs from "node:fs";
 import { spawn } from "cross-spawn";
 var cache2 = /* @__PURE__ */ new Map();
 function getGitTimestamp(file) {
   const cachedTimestamp = cache2.get(file);
   if (cachedTimestamp) return Promise.resolve(cachedTimestamp);
-  return new Promise((resolve, reject) => {
-    const cwd = path.dirname(file);
+  return new Promise((resolve3, reject) => {
+    const cwd = path2.dirname(file);
     if (!fs.existsSync(cwd)) {
-      resolve(void 0);
+      resolve3(void 0);
       return;
     }
-    const fileName = path.basename(file);
+    const fileName = path2.basename(file);
     const child = spawn("git", ["log", "-1", '--pretty="%ai"', fileName], {
       cwd
     });
@@ -90,14 +113,14 @@ function getGitTimestamp(file) {
     child.stdout.on("data", (d) => output = new Date(String(d)));
     child.on("close", () => {
       if (output) cache2.set(file, output);
-      resolve(output);
+      resolve3(output);
     });
     child.on("error", reject);
   });
 }
 
 // src/loader-mdx.ts
-function getQuery(query) {
+function parseQuery(query) {
   let collection;
   let hash;
   const parsed = parse(query.slice(1));
@@ -111,34 +134,35 @@ async function loader(source, callback) {
   const context = this.context;
   const filePath = this.resourcePath;
   const { _ctx } = this.getOptions();
-  const matter = grayMatter(source);
-  const query = getQuery(this.resourceQuery);
-  const configHash = query.hash ?? await getConfigHash(_ctx.configPath);
+  const matter2 = grayMatter(source);
+  const {
+    hash: configHash = await getConfigHash(_ctx.configPath),
+    collection: collectionId
+  } = parseQuery(this.resourceQuery);
   const config = await loadConfigCached(_ctx.configPath, configHash);
-  const collectionId = query.collection;
   let collection = collectionId !== void 0 ? config.collections.get(collectionId) : void 0;
   if (collection && collection.type !== "doc") {
     collection = void 0;
   }
-  const mdxOptions = collection?.mdxOptions ?? getDefaultMDXOptions(config.global?.mdxOptions ?? {});
-  function getTransformContext() {
-    return {
-      buildMDX: async (v, options = mdxOptions) => {
-        const res = await buildMDX(
-          collectionId ?? "global",
-          configHash,
-          v,
-          options
-        );
-        return String(res.value);
-      },
-      source,
-      path: filePath
-    };
-  }
-  let frontmatter = matter.data;
+  const mdxOptions = collection?.mdxOptions ?? config.defaultMdxOptions;
+  let frontmatter = matter2.data;
   if (collection?.schema) {
-    const schema = typeof collection.schema === "function" ? collection.schema(getTransformContext()) : collection.schema;
+    let schema = collection.schema;
+    if (typeof schema === "function") {
+      schema = schema({
+        async buildMDX(v, options = mdxOptions) {
+          const res = await buildMDX(
+            collectionId ?? "global",
+            configHash,
+            v,
+            options
+          );
+          return String(res.value);
+        },
+        source,
+        path: filePath
+      });
+    }
     const result = await schema.safeParseAsync(frontmatter);
     if (result.error) {
       callback(new Error(formatError(filePath, result.error)));
@@ -146,11 +170,11 @@ async function loader(source, callback) {
     }
     frontmatter = result.data;
   }
-  const props = matter.data._mdx ?? {};
+  const props = matter2.data._mdx ?? {};
   if (props.mirror) {
-    const mirrorPath = path2.resolve(path2.dirname(filePath), props.mirror);
+    const mirrorPath = path3.resolve(path3.dirname(filePath), props.mirror);
     this.addDependency(mirrorPath);
-    matter.content = await fs2.readFile(mirrorPath).then((res) => grayMatter(res.toString()).content);
+    matter2.content = await fs2.readFile(mirrorPath).then((res) => grayMatter(res.toString()).content);
   }
   let timestamp;
   if (config.global?.lastModifiedTime === "git")
@@ -159,7 +183,7 @@ async function loader(source, callback) {
     const file = await buildMDX(
       collectionId ?? "global",
       configHash,
-      matter.content,
+      matter2.content,
       {
         development: this.mode === "development",
         ...mdxOptions,
@@ -167,7 +191,8 @@ async function loader(source, callback) {
         frontmatter,
         data: {
           lastModified: timestamp
-        }
+        },
+        _compiler: this
       }
     );
     callback(void 0, String(file.value), file.map ?? void 0);
@@ -183,7 +208,7 @@ async function loader(source, callback) {
     }
   } catch (error) {
     if (!(error instanceof Error)) throw error;
-    const fpath = path2.relative(context, filePath);
+    const fpath = path3.relative(context, filePath);
     error.message = `${fpath}:${error.name}: ${error.message}`;
     callback(error);
   }

package/dist/next/index.js

@@ -5,7 +5,8 @@ import {
   loadConfig,
   loadConfigCached,
   writeManifest
-} from "../chunk-QYUB4AKH.js";
+} from "../chunk-BP4S5VOB.js";
+import "../chunk-MKWJLEE7.js";
 
 // src/next/create.ts
 import path3 from "node:path";
@@ -19,7 +20,7 @@ import grayMatter from "gray-matter";
 // src/map/generate.ts
 import * as path from "node:path";
 import fg from "fast-glob";
-async function generateJS(configPath, config, outputPath, hash, getFrontmatter) {
+async function generateJS(configPath, config, outputPath, configHash, getFrontmatter) {
   const outDir2 = path.dirname(outputPath);
   const imports = [
     {
@@ -36,7 +37,7 @@ async function generateJS(configPath, config, outputPath, hash, getFrontmatter)
     const items = files.map(async (file, i) => {
       config._runtime.files.set(file.absolutePath, k);
       if (collection.type === "doc" && collection.async) {
-        const importPath = `${toImportPath(file.absolutePath, outDir2)}?hash=${hash}&collection=${k}`;
+        const importPath = `${toImportPath(file.absolutePath, outDir2)}?hash=${configHash}&collection=${k}`;
         const frontmatter = await getFrontmatter(file.absolutePath);
         return `toRuntimeAsync(${JSON.stringify(frontmatter)}, () => import(${JSON.stringify(importPath)}), ${JSON.stringify(file)})`;
       }
@@ -44,7 +45,7 @@ async function generateJS(configPath, config, outputPath, hash, getFrontmatter)
       imports.push({
         type: "namespace",
         name: importName,
-        specifier: `${toImportPath(file.absolutePath, outDir2)}?collection=${k}&hash=${hash}`
+        specifier: `${toImportPath(file.absolutePath, outDir2)}?collection=${k}&hash=${configHash}`
       });
       return `toRuntime("${collection.type}", ${importName}, ${JSON.stringify(file)})`;
     });
@@ -151,6 +152,7 @@ async function start(dev, configPath, outDir2) {
       console.log("[MDX] started dev server");
     });
     instance.on("all", (event, file) => {
+      if (typeof file !== "string") return;
       const onUpdate = async () => {
         const isConfigFile = path2.resolve(file) === configPath;
         if (isConfigFile) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-mdx",
-  "version": "11.1.2",
+  "version": "11.2.0",
   "description": "The built-in source for Fumadocs",
   "keywords": [
     "NextJs",
@@ -36,28 +36,30 @@
   ],
   "dependencies": {
     "@mdx-js/mdx": "^3.1.0",
-    "chokidar": "^4.0.1",
-    "cross-spawn": "^7.0.5",
-    "esbuild": "^0.24.0",
+    "chokidar": "^4.0.3",
+    "cross-spawn": "^7.0.6",
+    "esbuild": "^0.24.2",
     "estree-util-value-to-estree": "^3.2.1",
     "fast-glob": "^3.3.1",
     "gray-matter": "^4.0.3",
     "micromatch": "^4.0.8",
-    "zod": "^3.23.8"
+    "unist-util-visit": "^5.0.0",
+    "zod": "^3.24.1"
   },
   "devDependencies": {
     "@types/cross-spawn": "^6.0.6",
     "@types/mdast": "^4.0.3",
     "@types/mdx": "^2.0.13",
     "@types/micromatch": "^4.0.9",
-    "@types/react": "^18.3.12",
-    "next": "^15.0.3",
+    "@types/react": "^19.0.2",
+    "mdast-util-mdx-jsx": "^3.1.3",
+    "next": "^15.1.2",
     "unified": "^11.0.5",
     "vfile": "^6.0.3",
-    "webpack": "^5.96.1",
+    "webpack": "^5.97.1",
     "eslint-config-custom": "0.0.0",
-    "tsconfig": "0.0.0",
-    "fumadocs-core": "14.5.3"
+    "fumadocs-core": "14.6.3",
+    "tsconfig": "0.0.0"
   },
   "peerDependencies": {
     "fumadocs-core": "^14.0.0",