fumadocs-mdx 11.1.2 → 11.2.1

package/dist/{types-BOXkLY5B.d.ts → build-mdx-SZwWfZMp.d.ts}

@@ -74,4 +74,32 @@ type GetOutput<C extends {
     };
 }> = CollectionEntry<C>[];
 
-export { type BaseCollectionEntry as B, type CollectionEntry as C, type DefaultMDXOptions as D, type FileInfo as F, type GlobalConfig as G, type InferSchema as I, type MarkdownProps as M, type InferSchemaType as a, type GetOutput as b, getDefaultMDXOptions as g };
+interface MDXOptions extends ProcessorOptions {
+    /**
+     * Name of collection
+     */
+    collection?: string;
+    /**
+     * Specify a file path for source
+     */
+    filePath?: string;
+    frontmatter?: Record<string, unknown>;
+    /**
+     * Custom Vfile data
+     */
+    data?: Record<string, unknown>;
+    _compiler?: CompilerOptions;
+}
+interface CompilerOptions {
+    addDependency: (file: string) => void;
+}
+declare module 'vfile' {
+    interface DataMap {
+        /**
+         * The compiler object from loader
+         */
+        _compiler?: CompilerOptions;
+    }
+}
+
+export { type BaseCollectionEntry as B, type CollectionEntry as C, type DefaultMDXOptions as D, type FileInfo as F, type GlobalConfig as G, type InferSchema as I, type MarkdownProps as M, type MDXOptions as a, type InferSchemaType as b, type GetOutput as c, getDefaultMDXOptions as g };

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

@@ -1,44 +1,15 @@
+import {
+  getDefaultMDXOptions
+} from "./chunk-MKWJLEE7.js";
+
 // src/config/cached.ts
 import { createHash } from "node:crypto";
-import fs from "node:fs";
+import * as fs from "node:fs";
 
 // src/config/load.ts
 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();
@@ -92,8 +98,8 @@ async function getConfigHash(configPath) {
 }
 
 // src/map/manifest.ts
-import fs2 from "node:fs";
-import path2 from "node:path";
+import * as fs2 from "node:fs";
+import * as path2 from "node:path";
 
 // src/utils/get-type-from-path.ts
 import { extname } from "node:path";

package/dist/chunk-GUHWD47S.js

@@ -0,0 +1,41 @@
+// src/mdx-plugins/remark-include.ts
+import { visit } from "unist-util-visit";
+import * as path from "node:path";
+import * as fs from "node:fs/promises";
+import matter from "gray-matter";
+function remarkInclude() {
+  return async (tree, file) => {
+    const queue = [];
+    visit(tree, ["mdxJsxFlowElement", "paragraph"], (node) => {
+      let specifier;
+      if (node.type === "paragraph" && node.children.length === 3) {
+        const [open, content, closure] = node.children;
+        if (open.type === "html" && open.value === "<include>" && content.type === "text" && closure.type === "html" && closure.value === "</include>") {
+          specifier = content.value.trim();
+        }
+      }
+      if (node.type === "mdxJsxFlowElement" && node.name === "include") {
+        const child = node.children.at(0);
+        if (!child || child.type !== "text") return;
+        specifier = child.value;
+      }
+      if (!specifier) return "skip";
+      const targetPath = path.resolve(path.dirname(file.path), specifier);
+      queue.push(
+        fs.readFile(targetPath).then((content) => {
+          const parsed = this.parse(matter(content).content);
+          if (file.data._compiler) {
+            file.data._compiler.addDependency(targetPath);
+          }
+          Object.assign(node, parsed);
+        })
+      );
+      return "skip";
+    });
+    await Promise.all(queue);
+  };
+}
+
+export {
+  remarkInclude
+};

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

@@ -1,27 +1,12 @@
-import { F as FileInfo, G as GlobalConfig, M as MarkdownProps, B as BaseCollectionEntry } from '../types-BOXkLY5B.js';
-export { C as CollectionEntry, D as DefaultMDXOptions, b as GetOutput, I as InferSchema, a as InferSchemaType, g as getDefaultMDXOptions } from '../types-BOXkLY5B.js';
+import { F as FileInfo, G as GlobalConfig, M as MarkdownProps, a as MDXOptions, B as BaseCollectionEntry } from '../build-mdx-SZwWfZMp.js';
+export { C as CollectionEntry, D as DefaultMDXOptions, c as GetOutput, I as InferSchema, b as InferSchemaType, g as getDefaultMDXOptions } from '../build-mdx-SZwWfZMp.js';
 import { z, ZodTypeAny } from 'zod';
 import { ProcessorOptions } from '@mdx-js/mdx';
+import { Processor, Transformer } from 'unified';
+import { Root } from 'mdast';
 import 'mdx/types';
 import 'fumadocs-core/mdx-plugins';
 import 'fumadocs-core/server';
-import 'unified';
-
-interface MDXOptions extends ProcessorOptions {
-    /**
-     * Name of collection
-     */
-    collection?: string;
-    /**
-     * Specify a file path for source
-     */
-    filePath?: string;
-    frontmatter?: Record<string, unknown>;
-    /**
-     * Custom Vfile data
-     */
-    data?: Record<string, unknown>;
-}
 
 declare const metaSchema: z.ZodObject<{
     title: z.ZodOptional<z.ZodString>;
@@ -144,4 +129,6 @@ declare function defineDocs<DocData extends ZodTypeAny = typeof frontmatterSchem
 };
 declare function defineConfig(config?: GlobalConfig): GlobalConfig;
 
-export { type BaseCollection, BaseCollectionEntry, type DocCollection, FileInfo, GlobalConfig, MarkdownProps, type MetaCollection, type TransformContext, defineCollections, defineConfig, defineDocs, frontmatterSchema, metaSchema };
+declare function remarkInclude(this: Processor): Transformer<Root, Root>;
+
+export { type BaseCollection, BaseCollectionEntry, type DocCollection, FileInfo, GlobalConfig, MarkdownProps, type MetaCollection, type TransformContext, defineCollections, defineConfig, defineDocs, frontmatterSchema, metaSchema, remarkInclude };

package/dist/config/index.js

@@ -1,16 +1,64 @@
 import {
-  defineCollections,
-  defineConfig,
-  defineDocs,
-  frontmatterSchema,
-  getDefaultMDXOptions,
-  metaSchema
-} from "../chunk-YA4EPE5U.js";
+  remarkInclude
+} from "../chunk-GUHWD47S.js";
+import {
+  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,
   defineDocs,
   frontmatterSchema,
   getDefaultMDXOptions,
-  metaSchema
+  metaSchema,
+  remarkInclude
 };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { PageData, MetaData, Source } from 'fumadocs-core/source';
-import { F as FileInfo, B as BaseCollectionEntry } from './types-BOXkLY5B.js';
+import { F as FileInfo, B as BaseCollectionEntry } from './build-mdx-SZwWfZMp.js';
 import { MetaFile } from './loader-mdx.js';
 import 'zod';
 import 'mdx/types';

package/dist/loader-mdx.js

@@ -1,15 +1,16 @@
 import {
-  getDefaultMDXOptions
-} from "./chunk-YA4EPE5U.js";
+  remarkInclude
+} from "./chunk-GUHWD47S.js";
 import {
   getConfigHash,
   getManifestEntryPath,
   loadConfigCached
-} from "./chunk-QYUB4AKH.js";
+} from "./chunk-EVNXCXU4.js";
+import "./chunk-MKWJLEE7.js";
 
 // src/loader-mdx.ts
-import path2 from "node:path";
-import fs2 from "node:fs/promises";
+import * as path2 from "node:path";
+import * as fs2 from "node:fs/promises";
 import { parse } from "node:querystring";
 import grayMatter from "gray-matter";
 
@@ -34,6 +35,7 @@ function buildMDX(group, configHash, source, options = {}) {
         outputFormat: "program",
         development: process.env.NODE_ENV === "development",
         ...rest,
+        remarkPlugins: [remarkInclude, ...rest.remarkPlugins ?? []],
         format
       }),
       configHash
@@ -45,7 +47,8 @@ function buildMDX(group, configHash, source, options = {}) {
     path: filePath,
     data: {
       ...data,
-      frontmatter
+      frontmatter,
+      _compiler: options._compiler
     }
   });
 }
@@ -97,7 +100,7 @@ function getGitTimestamp(file) {
 }
 
 // src/loader-mdx.ts
-function getQuery(query) {
+function parseQuery(query) {
   let collection;
   let hash;
   const parsed = parse(query.slice(1));
@@ -112,33 +115,34 @@ async function loader(source, callback) {
   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 {
+    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
-    };
-  }
+  const mdxOptions = collection?.mdxOptions ?? config.defaultMdxOptions;
   let frontmatter = matter.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,12 +150,6 @@ async function loader(source, callback) {
     }
     frontmatter = result.data;
   }
-  const props = matter.data._mdx ?? {};
-  if (props.mirror) {
-    const mirrorPath = path2.resolve(path2.dirname(filePath), props.mirror);
-    this.addDependency(mirrorPath);
-    matter.content = await fs2.readFile(mirrorPath).then((res) => grayMatter(res.toString()).content);
-  }
   let timestamp;
   if (config.global?.lastModifiedTime === "git")
     timestamp = (await getGitTimestamp(filePath))?.getTime();
@@ -167,7 +165,8 @@ async function loader(source, callback) {
         frontmatter,
         data: {
           lastModified: timestamp
-        }
+        },
+        _compiler: this
       }
     );
     callback(void 0, String(file.value), file.map ?? void 0);

package/dist/next/index.js

@@ -5,21 +5,22 @@ import {
   loadConfig,
   loadConfigCached,
   writeManifest
-} from "../chunk-QYUB4AKH.js";
+} from "../chunk-EVNXCXU4.js";
+import "../chunk-MKWJLEE7.js";
 
 // src/next/create.ts
 import path3 from "node:path";
 
 // src/map/index.ts
-import path2 from "node:path";
-import fs from "node:fs";
+import * as path2 from "node:path";
+import * as fs from "node:fs";
 import { readFile, writeFile } from "node:fs/promises";
 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)})`;
     });
@@ -74,13 +75,13 @@ async function getCollectionFiles(collection) {
         cwd: path.resolve(dir),
         absolute: true
       });
-      result.forEach((item) => {
-        if (getTypeFromPath(item) !== collection.type) return;
+      for (const item of result) {
+        if (getTypeFromPath(item) !== collection.type) continue;
         files.set(item, {
           path: path.relative(dir, item),
           absolutePath: item
         });
-      });
+      }
     })
   );
   return Array.from(files.values());
@@ -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) {
@@ -251,8 +253,8 @@ function createMDX({
 }
 
 // src/postinstall.ts
-import path4 from "node:path";
-import fs2 from "node:fs";
+import * as path4 from "node:path";
+import * as fs2 from "node:fs";
 async function postInstall(configPath = findConfigFile()) {
   const typeOut = path4.resolve(".source/index.d.ts");
   const config = await loadConfig(configPath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-mdx",
-  "version": "11.1.2",
+  "version": "11.2.1",
   "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.4",
+    "tsconfig": "0.0.0"
   },
   "peerDependencies": {
     "fumadocs-core": "^14.0.0",