fumadocs-mdx 12.0.2 → 13.0.0

package/dist/next/index.cjs

@@ -193,41 +193,26 @@ async function compileConfig(configPath, outDir) {
     throw new Error("failed to compile configuration file");
   }
 }
-async function loadConfig(configPath, outDir, hash, build = false) {
-  if (cache && cache.hash === hash) {
-    return await cache.config;
-  }
+async function loadConfig(configPath, outDir, build = false) {
   if (build) await compileConfig(configPath, outDir);
-  const url = (0, import_node_url.pathToFileURL)(path.resolve(outDir, "source.config.mjs"));
-  const config = import(`${url.href}?hash=${hash}`).then((loaded) => {
-    return buildConfig(
-      // every call to `loadConfig` will cause the previous cache to be ignored
-      loaded
-    );
-  });
-  if (hash) cache = { config, hash };
+  const url = (0, import_node_url.pathToFileURL)(path3.resolve(outDir, "source.config.mjs"));
+  url.searchParams.set("hash", Date.now().toString());
+  const config = import(url.href).then(
+    (loaded) => buildConfig(loaded)
+  );
   return await config;
 }
-async function getConfigHash(configPath) {
-  const stats = await fs.stat(configPath).catch(() => void 0);
-  if (stats) {
-    return stats.mtime.getTime().toString();
-  }
-  throw new Error("Cannot find config file");
-}
-var fs, path, import_node_url, cache;
+var path3, import_node_url;
 var init_load = __esm({
   "src/loaders/config/load.ts"() {
     "use strict";
-    fs = __toESM(require("fs/promises"), 1);
-    path = __toESM(require("path"), 1);
+    path3 = __toESM(require("path"), 1);
     import_node_url = require("url");
     init_build();
-    cache = null;
   }
 });
 
-// src/next/map/watcher.ts
+// src/next/watcher.ts
 var watcher_exports = {};
 __export(watcher_exports, {
   watcher: () => watcher
@@ -251,7 +236,7 @@ function watcher(configPath, config, ignored) {
 }
 var import_chokidar;
 var init_watcher = __esm({
-  "src/next/map/watcher.ts"() {
+  "src/next/watcher.ts"() {
     "use strict";
     import_chokidar = require("chokidar");
   }
@@ -261,18 +246,86 @@ var init_watcher = __esm({
 var next_exports = {};
 __export(next_exports, {
   createMDX: () => createMDX,
-  postInstall: () => postInstall,
-  start: () => start
+  postInstall: () => postInstall
 });
 module.exports = __toCommonJS(next_exports);
-init_load();
-var import_node_path5 = __toESM(require("path"), 1);
+
+// src/loaders/config/index.ts
+var import_node_path = __toESM(require("path"), 1);
+var import_promises = __toESM(require("fs/promises"), 1);
+function findConfigFile() {
+  return import_node_path.default.resolve("source.config.ts");
+}
+
+// src/plugins/index.ts
+var import_node_path2 = __toESM(require("path"), 1);
 var import_promises2 = __toESM(require("fs/promises"), 1);
+function createPluginHandler(context, defaultPlugins = []) {
+  const plugins2 = [];
+  async function write(entry) {
+    const file = import_node_path2.default.join(context.outDir, entry.path);
+    await import_promises2.default.mkdir(import_node_path2.default.dirname(file), { recursive: true });
+    await import_promises2.default.writeFile(file, entry.content);
+  }
+  return {
+    async init(config) {
+      if (config.global.plugins) {
+        defaultPlugins.push(...config.global.plugins);
+      }
+      for await (const option of defaultPlugins) {
+        if (!option) continue;
+        if (Array.isArray(option)) plugins2.push(...option);
+        else plugins2.push(option);
+      }
+      for (const plugin of plugins2) {
+        const out = await plugin.config?.call(context, config);
+        if (out) config = out;
+      }
+      return config;
+    },
+    async emit() {
+      const out = await Promise.all(
+        plugins2.map((plugin) => {
+          return plugin.emit?.call(context) ?? [];
+        })
+      );
+      return out.flat();
+    },
+    async emitAndWrite() {
+      const entries = await this.emit();
+      await Promise.all(entries.map(write));
+    }
+  };
+}
 
-// src/next/map/generate.ts
-var path5 = __toESM(require("path"), 1);
-var import_node_crypto = require("crypto");
-var import_tinyglobby = require("tinyglobby");
+// src/next/index.ts
+var path8 = __toESM(require("path"), 1);
+init_load();
+
+// src/next/file-cache.ts
+var import_lru_cache = require("lru-cache");
+var import_promises3 = __toESM(require("fs/promises"), 1);
+var import_node_path3 = __toESM(require("path"), 1);
+var map = new import_lru_cache.LRUCache({
+  max: 100
+});
+function toFullPath(file) {
+  if (import_node_path3.default.isAbsolute(file)) {
+    return import_node_path3.default.relative(process.cwd(), file);
+  }
+  return file;
+}
+async function readFileWithCache(file) {
+  const fullPath = toFullPath(file);
+  const cached = map.get(fullPath);
+  if (cached) return cached;
+  const read = import_promises3.default.readFile(fullPath).then((s) => s.toString());
+  map.set(fullPath, read);
+  return read;
+}
+function removeFileCache(file) {
+  map.delete(toFullPath(file));
+}
 
 // src/utils/validation.ts
 var import_picocolors = __toESM(require("picocolors"), 1);
@@ -312,51 +365,29 @@ async function validate(schema, data, context, errorMessage) {
   return data;
 }
 
-// src/next/map/file-cache.ts
-var import_lru_cache = require("lru-cache");
-var import_promises = __toESM(require("fs/promises"), 1);
-var import_node_path = __toESM(require("path"), 1);
-var map = new import_lru_cache.LRUCache({
-  max: 100
-});
-function toFullPath(file) {
-  if (import_node_path.default.isAbsolute(file)) {
-    return import_node_path.default.relative(process.cwd(), file);
-  }
-  return file;
-}
-async function readFileWithCache(file) {
-  const fullPath = toFullPath(file);
-  const cached = map.get(fullPath);
-  if (cached) return cached;
-  const read = import_promises.default.readFile(fullPath).then((s) => s.toString());
-  map.set(fullPath, read);
-  return read;
-}
-function removeFileCache(file) {
-  map.delete(toFullPath(file));
-}
-
-// src/next/map/generate.ts
+// src/plugins/next.ts
+var path7 = __toESM(require("path"), 1);
+var import_node_crypto = require("crypto");
+var import_tinyglobby = require("tinyglobby");
 var import_js_yaml2 = require("js-yaml");
 
 // src/utils/git-timestamp.ts
-var import_node_path2 = __toESM(require("path"), 1);
+var import_node_path4 = __toESM(require("path"), 1);
 var import_tinyexec = require("tinyexec");
-var cache2 = /* @__PURE__ */ new Map();
+var cache = /* @__PURE__ */ new Map();
 async function getGitTimestamp(file) {
-  const cached = cache2.get(file);
+  const cached = cache.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)],
+      ["log", "-1", '--pretty="%ai"', import_node_path4.default.relative(process.cwd(), file)],
       {
         throwOnError: true
       }
     );
     const time = new Date(out.stdout);
-    cache2.set(file, time);
+    cache.set(file, time);
     return time;
   } catch {
     return;
@@ -380,7 +411,7 @@ function fumaMatter(input) {
 }
 
 // src/utils/import-formatter.ts
-var import_node_path3 = __toESM(require("path"), 1);
+var import_node_path5 = __toESM(require("path"), 1);
 function getImportCode(info) {
   const specifier = JSON.stringify(info.specifier);
   if (info.type === "default") return `import ${info.name} from ${specifier}`;
@@ -395,7 +426,7 @@ function getImportCode(info) {
   return `import ${specifier}`;
 }
 function toImportPath(file, config) {
-  const ext = import_node_path3.default.extname(file);
+  const ext = import_node_path5.default.extname(file);
   let filename;
   if (ext === ".ts" && config.jsExtension) {
     filename = file.substring(0, file.length - ext.length) + ".js";
@@ -406,14 +437,14 @@ function toImportPath(file, config) {
   }
   let importPath;
   if ("relativeTo" in config) {
-    importPath = import_node_path3.default.relative(config.relativeTo, filename);
-    if (!import_node_path3.default.isAbsolute(importPath) && !importPath.startsWith(".")) {
+    importPath = import_node_path5.default.relative(config.relativeTo, filename);
+    if (!import_node_path5.default.isAbsolute(importPath) && !importPath.startsWith(".")) {
       importPath = `./${importPath}`;
     }
   } else {
-    importPath = import_node_path3.default.resolve(filename);
+    importPath = import_node_path5.default.resolve(filename);
   }
-  return importPath.replaceAll(import_node_path3.default.sep, "/");
+  return importPath.replaceAll(import_node_path5.default.sep, "/");
 }
 
 // src/utils/collections.ts
@@ -434,8 +465,26 @@ function isFileSupported(filePath, collection) {
   return false;
 }
 
-// src/next/map/generate.ts
-async function generateJS(configPath, config, importPath, configHash = false) {
+// src/plugins/next.ts
+function next() {
+  let config;
+  return {
+    config(v) {
+      config = v;
+    },
+    async emit() {
+      return [
+        {
+          path: "index.ts",
+          content: await indexFile(this.configPath, config, {
+            relativeTo: this.outDir
+          })
+        }
+      ];
+    }
+  };
+}
+async function indexFile(configPath, config, importPath, configHash = false) {
   let asyncInit = false;
   const lines = [
     getImportCode({
@@ -571,11 +620,11 @@ async function getCollectionFiles(collection) {
   await Promise.all(
     dirs.map(async (dir) => {
       const result = await (0, import_tinyglobby.glob)(patterns, {
-        cwd: path5.resolve(dir)
+        cwd: path7.resolve(dir)
       });
       for (const item of result) {
         if (!isFileSupported(item, collection)) continue;
-        const fullPath = path5.join(dir, item);
+        const fullPath = path7.join(dir, item);
         files.set(fullPath, {
           path: item,
           fullPath
@@ -586,7 +635,7 @@ async function getCollectionFiles(collection) {
   return Array.from(files.values());
 }
 function parseMetaEntry(file, content) {
-  const extname2 = path5.extname(file);
+  const extname2 = path7.extname(file);
   try {
     if (extname2 === ".json") return JSON.parse(content);
     if (extname2 === ".yaml") return (0, import_js_yaml2.load)(content);
@@ -598,98 +647,23 @@ function parseMetaEntry(file, content) {
   throw new Error(`Unknown meta file format: ${extname2}, in ${file}.`);
 }
 
-// src/loaders/config/index.ts
-var import_node_path4 = __toESM(require("path"), 1);
-function findConfigFile() {
-  return import_node_path4.default.resolve("source.config.ts");
-}
-
-// src/next/map/index.ts
-var path7 = __toESM(require("path"), 1);
-var fs3 = __toESM(require("fs/promises"), 1);
-init_load();
-async function start(dev, configPath, outDir) {
-  let configHash = await getConfigHash(configPath);
-  let config = await loadConfig(configPath, outDir, configHash, true);
-  const outPath = path7.resolve(outDir, `index.ts`);
-  async function updateMapFile() {
-    const start2 = performance.now();
-    try {
-      await fs3.writeFile(
-        outPath,
-        await generateJS(
-          configPath,
-          config,
-          { relativeTo: outDir },
-          configHash
-        )
-      );
-    } catch (err) {
-      if (err instanceof ValidationError) {
-        console.error(err.toStringFormatted());
-      } else {
-        console.error(err);
-      }
-    }
-    console.log(`[MDX] updated map file in ${performance.now() - start2}ms`);
-  }
-  await updateMapFile();
-  if (dev) {
-    const { watcher: watcher2 } = await Promise.resolve().then(() => (init_watcher(), watcher_exports));
-    const instance = watcher2(configPath, config, [outPath]);
-    instance.on("ready", () => {
-      console.log("[MDX] started dev server");
-    });
-    instance.on("all", (event, file) => {
-      if (typeof file !== "string") return;
-      const absolutePath = path7.resolve(file);
-      const onUpdate = async () => {
-        const isConfigFile = absolutePath === configPath;
-        if (isConfigFile) {
-          configHash = await getConfigHash(configPath);
-          config = await loadConfig(configPath, outDir, configHash, true);
-        }
-        if (event === "change") removeFileCache(absolutePath);
-        await updateMapFile();
-      };
-      void onUpdate();
-    });
-    process.on("exit", () => {
-      console.log("[MDX] closing dev server");
-      void instance.close();
-    });
-  }
-}
-
-// src/next/create.ts
-var import_node_fs = require("fs");
+// src/next/index.ts
 var defaultPageExtensions = ["mdx", "md", "jsx", "js", "tsx", "ts"];
-var isTurboExperimental;
-try {
-  const content = (0, import_node_fs.readFileSync)("./node_modules/next/package.json").toString();
-  const version = JSON.parse(content).version;
-  isTurboExperimental = version.startsWith("15.0.") || version.startsWith("15.1.") || version.startsWith("15.2.");
-} catch {
-  isTurboExperimental = false;
-}
-function createMDX({
-  configPath = findConfigFile(),
-  outDir = ".source"
-} = {}) {
+function createMDX(createOptions = {}) {
+  const options = applyDefaults(createOptions);
+  const isDev = process.env.NODE_ENV === "development";
   if (process.env._FUMADOCS_MDX !== "1") {
     process.env._FUMADOCS_MDX = "1";
-    void start(process.env.NODE_ENV === "development", configPath, outDir);
+    void init(isDev, options);
   }
   return (nextConfig = {}) => {
     const mdxLoaderOptions = {
-      configPath,
-      outDir
+      ...options,
+      isDev
     };
-    const turbo = {
-      ...nextConfig.experimental?.turbo,
+    const turbopack = {
       ...nextConfig.turbopack,
       rules: {
-        ...nextConfig.experimental?.turbo?.rules,
         ...nextConfig.turbopack?.rules,
         "*.{md,mdx}": {
           loaders: [
@@ -702,17 +676,18 @@ function createMDX({
         }
       }
     };
-    const updated = {
+    return {
       ...nextConfig,
+      turbopack,
       pageExtensions: nextConfig.pageExtensions ?? defaultPageExtensions,
-      webpack: (config, options) => {
+      webpack: (config, options2) => {
         config.resolve ||= {};
         config.module ||= {};
         config.module.rules ||= [];
         config.module.rules.push({
           test: /\.mdx?$/,
           use: [
-            options.defaultLoaders.babel,
+            options2.defaultLoaders.babel,
             {
               loader: "fumadocs-mdx/loader-mdx",
               options: mdxLoaderOptions
@@ -720,34 +695,91 @@ function createMDX({
           ]
         });
         config.plugins ||= [];
-        return nextConfig.webpack?.(config, options) ?? config;
+        return nextConfig.webpack?.(config, options2) ?? config;
       }
     };
-    if (isTurboExperimental) {
-      updated.experimental = { ...updated.experimental, turbo };
-    } else {
-      updated.turbopack = turbo;
-    }
-    return updated;
   };
 }
-
-// src/next/index.ts
+async function init(dev, options) {
+  const pluginHandler = createNextPluginHandler(options);
+  let config;
+  async function updateConfig() {
+    config = await pluginHandler.init(
+      await loadConfig(options.configPath, options.outDir, true)
+    );
+  }
+  async function emitFiles() {
+    const start = performance.now();
+    try {
+      await pluginHandler.emitAndWrite();
+    } catch (err) {
+      if (err instanceof ValidationError) {
+        console.error(err.toStringFormatted());
+      } else {
+        console.error(err);
+      }
+    }
+    console.log(`[MDX] updated map file in ${performance.now() - start}ms`);
+  }
+  async function devServer() {
+    const { watcher: watcher2 } = await Promise.resolve().then(() => (init_watcher(), watcher_exports));
+    const instance = watcher2(options.configPath, config, [options.outDir]);
+    async function onUpdate(event, file) {
+      const absolutePath = path8.resolve(file);
+      if (event === "change") removeFileCache(absolutePath);
+      if (absolutePath === path8.resolve(options.configPath)) {
+        await updateConfig();
+        console.log("[MDX] restarting dev server");
+        await instance.close();
+        void devServer();
+      }
+      await emitFiles();
+    }
+    instance.on("ready", () => {
+      console.log("[MDX] started dev server");
+    });
+    instance.on("all", (event, file) => {
+      void onUpdate(event, file);
+    });
+    process.on("exit", () => {
+      console.log("[MDX] closing dev server");
+      void instance.close();
+    });
+  }
+  await updateConfig();
+  await emitFiles();
+  if (dev) void devServer();
+}
 async function postInstall(configPath = findConfigFile(), outDir = ".source") {
-  const config = await loadConfig(configPath, outDir, void 0, true);
-  const outPath = import_node_path5.default.join(outDir, "index.ts");
-  await import_promises2.default.rm(outDir, { recursive: true });
-  await import_promises2.default.mkdir(outDir, { recursive: true });
-  const hash = await getConfigHash(configPath);
-  await import_promises2.default.writeFile(
-    outPath,
-    await generateJS(configPath, config, { relativeTo: outDir }, hash)
-  );
+  const pluginHandler = createNextPluginHandler({
+    outDir,
+    configPath
+  });
+  await pluginHandler.init(await loadConfig(configPath, outDir, true));
+  await pluginHandler.emitAndWrite();
   console.log("[MDX] types generated");
 }
+function applyDefaults(options) {
+  return {
+    outDir: options.outDir ?? ".source",
+    configPath: options.configPath ?? findConfigFile()
+  };
+}
+function createNextPluginHandler({
+  outDir,
+  configPath
+}) {
+  return createPluginHandler(
+    {
+      environment: "next",
+      outDir,
+      configPath
+    },
+    [next()]
+  );
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createMDX,
-  postInstall,
-  start
+  postInstall
 });

package/dist/next/index.d.cts

@@ -1,12 +1,5 @@
 import { NextConfig } from 'next';
 
-/**
- * Start a MDX server that builds index and manifest files.
- *
- * In development mode, it starts a file watcher to auto-update output as your input changes.
- */
-declare function start(dev: boolean, configPath: string, outDir: string): Promise<void>;
-
 interface CreateMDXOptions {
     /**
      * Path to source configuration file
@@ -19,9 +12,7 @@ interface CreateMDXOptions {
      */
     outDir?: string;
 }
-
-declare function createMDX({ configPath, outDir, }?: CreateMDXOptions): (nextConfig?: NextConfig) => NextConfig;
-
+declare function createMDX(createOptions?: CreateMDXOptions): (nextConfig?: NextConfig) => NextConfig;
 declare function postInstall(configPath?: string, outDir?: string): Promise<void>;
 
-export { type CreateMDXOptions, createMDX, postInstall, start };
+export { type CreateMDXOptions, createMDX, postInstall };

package/dist/next/index.d.ts

@@ -1,12 +1,5 @@
 import { NextConfig } from 'next';
 
-/**
- * Start a MDX server that builds index and manifest files.
- *
- * In development mode, it starts a file watcher to auto-update output as your input changes.
- */
-declare function start(dev: boolean, configPath: string, outDir: string): Promise<void>;
-
 interface CreateMDXOptions {
     /**
      * Path to source configuration file
@@ -19,9 +12,7 @@ interface CreateMDXOptions {
      */
     outDir?: string;
 }
-
-declare function createMDX({ configPath, outDir, }?: CreateMDXOptions): (nextConfig?: NextConfig) => NextConfig;
-
+declare function createMDX(createOptions?: CreateMDXOptions): (nextConfig?: NextConfig) => NextConfig;
 declare function postInstall(configPath?: string, outDir?: string): Promise<void>;
 
-export { type CreateMDXOptions, createMDX, postInstall, start };
+export { type CreateMDXOptions, createMDX, postInstall };