fumadocs-mdx 12.0.3 → 13.0.1

package/dist/next/index.cjs

@@ -193,67 +193,22 @@ 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)(path2.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 path2, 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);
+    path2 = __toESM(require("path"), 1);
     import_node_url = require("url");
     init_build();
-    cache = null;
-  }
-});
-
-// src/next/map/watcher.ts
-var watcher_exports = {};
-__export(watcher_exports, {
-  watcher: () => watcher
-});
-function watcher(configPath, config, ignored) {
-  const watcher2 = new import_chokidar.FSWatcher({
-    ignoreInitial: true,
-    persistent: true,
-    ignored
-  });
-  watcher2.add(configPath);
-  for (const collection of config.collections.values()) {
-    if (collection.type === "docs") {
-      watcher2.add(collection.docs.dir);
-      watcher2.add(collection.meta.dir);
-    } else {
-      watcher2.add(collection.dir);
-    }
-  }
-  return watcher2;
-}
-var import_chokidar;
-var init_watcher = __esm({
-  "src/next/map/watcher.ts"() {
-    "use strict";
-    import_chokidar = require("chokidar");
   }
 });
 
@@ -261,18 +216,45 @@ var init_watcher = __esm({
 var next_exports = {};
 __export(next_exports, {
   createMDX: () => createMDX,
-  postInstall: () => postInstall,
-  start: () => start
+  postInstall: () => postInstall
 });
 module.exports = __toCommonJS(next_exports);
+
+// 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/next/index.ts
+var path9 = __toESM(require("path"), 1);
 init_load();
-var import_node_path5 = __toESM(require("path"), 1);
-var import_promises2 = __toESM(require("fs/promises"), 1);
 
-// src/next/map/generate.ts
-var path5 = __toESM(require("path"), 1);
-var import_node_crypto = require("crypto");
-var import_tinyglobby = require("tinyglobby");
+// src/next/file-cache.ts
+var import_lru_cache = require("lru-cache");
+var import_promises2 = __toESM(require("fs/promises"), 1);
+var import_node_path2 = __toESM(require("path"), 1);
+var map = new import_lru_cache.LRUCache({
+  max: 100
+});
+function toFullPath(file) {
+  if (import_node_path2.default.isAbsolute(file)) {
+    return import_node_path2.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_promises2.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 +294,28 @@ 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_js_yaml2 = require("js-yaml");
 
 // src/utils/git-timestamp.ts
-var import_node_path2 = __toESM(require("path"), 1);
+var import_node_path3 = __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_path3.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 +339,7 @@ function fumaMatter(input) {
 }
 
 // src/utils/import-formatter.ts
-var import_node_path3 = __toESM(require("path"), 1);
+var import_node_path4 = __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 +354,7 @@ function getImportCode(info) {
   return `import ${specifier}`;
 }
 function toImportPath(file, config) {
-  const ext = import_node_path3.default.extname(file);
+  const ext = import_node_path4.default.extname(file);
   let filename;
   if (ext === ".ts" && config.jsExtension) {
     filename = file.substring(0, file.length - ext.length) + ".js";
@@ -406,36 +365,92 @@ 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_path4.default.relative(config.relativeTo, filename);
+    if (!import_node_path4.default.isAbsolute(importPath) && !importPath.startsWith(".")) {
       importPath = `./${importPath}`;
     }
   } else {
-    importPath = import_node_path3.default.resolve(filename);
+    importPath = import_node_path4.default.resolve(filename);
   }
-  return importPath.replaceAll(import_node_path3.default.sep, "/");
+  return importPath.replaceAll(import_node_path4.default.sep, "/");
 }
 
 // src/utils/collections.ts
-function getSupportedFormats(collection) {
-  return {
-    doc: ["mdx", "md"],
-    meta: ["json", "yaml"]
-  }[collection.type];
-}
+var import_picomatch = __toESM(require("picomatch"), 1);
+var import_tinyglobby = require("tinyglobby");
+var import_node_path5 = __toESM(require("path"), 1);
+var SupportedFormats = {
+  doc: ["mdx", "md"],
+  meta: ["json", "yaml"]
+};
 function getGlobPatterns(collection) {
   if (collection.files) return collection.files;
-  return [`**/*.{${getSupportedFormats(collection).join(",")}}`];
+  return [`**/*.{${SupportedFormats[collection.type].join(",")}}`];
 }
 function isFileSupported(filePath, collection) {
-  for (const format of getSupportedFormats(collection)) {
-    if (filePath.endsWith(`.${format}`)) return true;
-  }
-  return false;
+  return SupportedFormats[collection.type].some(
+    (format) => filePath.endsWith(`.${format}`)
+  );
+}
+async function getCollectionFiles(collection) {
+  const files = /* @__PURE__ */ new Map();
+  const dirs = Array.isArray(collection.dir) ? collection.dir : [collection.dir];
+  const patterns = getGlobPatterns(collection);
+  await Promise.all(
+    dirs.map(async (dir) => {
+      const result = await (0, import_tinyglobby.glob)(patterns, {
+        cwd: import_node_path5.default.resolve(dir)
+      });
+      for (const item of result) {
+        if (!isFileSupported(item, collection)) continue;
+        const fullPath = import_node_path5.default.join(dir, item);
+        files.set(fullPath, {
+          path: item,
+          fullPath
+        });
+      }
+    })
+  );
+  return Array.from(files.values());
 }
 
-// src/next/map/generate.ts
-async function generateJS(configPath, config, importPath, configHash = false) {
+// src/plugins/next.ts
+function next() {
+  let config;
+  let shouldEmitOnChange = false;
+  return {
+    name: "next",
+    config(v) {
+      config = v;
+      shouldEmitOnChange = false;
+      for (const collection of config.collections.values()) {
+        if (collection.type === "doc" && collection.async || collection.type === "docs" && collection.docs.async) {
+          shouldEmitOnChange = true;
+        }
+      }
+    },
+    configureServer(server) {
+      if (!server.watcher) return;
+      server.watcher.on("all", async () => {
+        if (!shouldEmitOnChange) return;
+        await this.core.emitAndWrite({
+          filterPlugin: (plugin) => plugin.name === "next"
+        });
+      });
+    },
+    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({
@@ -564,29 +579,8 @@ async function generateJS(configPath, config, importPath, configHash = false) {
     ...resolvedDeclares
   ].join("\n");
 }
-async function getCollectionFiles(collection) {
-  const files = /* @__PURE__ */ new Map();
-  const dirs = Array.isArray(collection.dir) ? collection.dir : [collection.dir];
-  const patterns = getGlobPatterns(collection);
-  await Promise.all(
-    dirs.map(async (dir) => {
-      const result = await (0, import_tinyglobby.glob)(patterns, {
-        cwd: path5.resolve(dir)
-      });
-      for (const item of result) {
-        if (!isFileSupported(item, collection)) continue;
-        const fullPath = path5.join(dir, item);
-        files.set(fullPath, {
-          path: item,
-          fullPath
-        });
-      }
-    })
-  );
-  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 +592,96 @@ 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);
+// src/core.ts
+var import_node_path6 = __toESM(require("path"), 1);
+var import_promises3 = __toESM(require("fs/promises"), 1);
+function createCore(options, defaultPlugins = []) {
+  let config;
+  let plugins2;
+  return {
+    _options: options,
+    getPluginContext() {
+      return {
+        core: this,
+        ...options
+      };
+    },
+    /**
+     * Convenient cache store, reset when config changes
+     */
+    cache: /* @__PURE__ */ new Map(),
+    async init({ config: newConfig }) {
+      config = await newConfig;
+      this.cache.clear();
+      plugins2 = [];
+      for await (const option of [
+        ...defaultPlugins,
+        ...config.global.plugins ?? []
+      ]) {
+        if (!option) continue;
+        if (Array.isArray(option)) plugins2.push(...option);
+        else plugins2.push(option);
       }
-    }
-    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);
+      for (const plugin of plugins2) {
+        const out = await plugin.config?.call(this.getPluginContext(), config);
+        if (out) config = out;
+      }
+      return this;
+    },
+    getConfig() {
+      return config;
+    },
+    creatConfigLoader() {
+      return {
+        getConfig() {
+          return config;
         }
-        if (event === "change") removeFileCache(absolutePath);
-        await updateMapFile();
       };
-      void onUpdate();
-    });
-    process.on("exit", () => {
-      console.log("[MDX] closing dev server");
-      void instance.close();
-    });
-  }
+    },
+    async initServer(server) {
+      for (const plugin of plugins2) {
+        await plugin.configureServer?.call(this.getPluginContext(), server);
+      }
+    },
+    async emitAndWrite({
+      filterPlugin = () => true
+    } = {}) {
+      const start = performance.now();
+      const out = await Promise.all(
+        plugins2.map((plugin) => {
+          if (!filterPlugin(plugin) || !plugin.emit) return [];
+          return plugin.emit.call(this.getPluginContext());
+        })
+      );
+      await Promise.all(
+        out.flat().map(async (entry) => {
+          const file = import_node_path6.default.join(options.outDir, entry.path);
+          await import_promises3.default.mkdir(import_node_path6.default.dirname(file), { recursive: true });
+          await import_promises3.default.writeFile(file, entry.content);
+        })
+      );
+      console.log(`[MDX] generated files in ${performance.now() - start}ms`);
+    }
+  };
 }
 
-// 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 +694,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 +713,105 @@ 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 core = createNextCore(options);
+  async function initOrReload() {
+    await core.init({
+      config: loadConfig(options.configPath, options.outDir, true)
+    });
+    await core.emitAndWrite();
+  }
+  async function devServer() {
+    const { FSWatcher } = await import("chokidar");
+    const watcher = new FSWatcher({
+      ignoreInitial: true,
+      persistent: true,
+      ignored: [options.outDir]
+    });
+    watcher.add(options.configPath);
+    for (const collection of core.getConfig().collections.values()) {
+      if (collection.type === "docs") {
+        watcher.add(collection.docs.dir);
+        watcher.add(collection.meta.dir);
+      } else {
+        watcher.add(collection.dir);
+      }
+    }
+    watcher.on("ready", () => {
+      console.log("[MDX] started dev server");
+    });
+    watcher.on("all", async (event, file) => {
+      const absolutePath = path9.resolve(file);
+      if (event === "change") removeFileCache(absolutePath);
+      if (absolutePath === path9.resolve(options.configPath)) {
+        watcher.removeAllListeners();
+        await watcher.close();
+        await initOrReload();
+        console.log("[MDX] restarting dev server");
+        await devServer();
+      }
+    });
+    process.on("exit", () => {
+      if (watcher.closed) return;
+      console.log("[MDX] closing dev server");
+      void watcher.close();
+    });
+    await core.initServer({ watcher });
+  }
+  await initOrReload();
+  if (dev) {
+    await 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 core = await createNextCore({
+    outDir,
+    configPath
+  }).init({
+    config: loadConfig(configPath, outDir, true)
+  });
+  await core.emitAndWrite();
+}
+function applyDefaults(options) {
+  return {
+    outDir: options.outDir ?? ".source",
+    configPath: options.configPath ?? findConfigFile()
+  };
+}
+function createNextCore({
+  outDir,
+  configPath
+}) {
+  const core = createCore(
+    {
+      environment: "next",
+      outDir,
+      configPath
+    },
+    [next()]
   );
-  console.log("[MDX] types generated");
+  return {
+    ...core,
+    async emitAndWrite(...args) {
+      try {
+        await core.emitAndWrite(...args);
+      } catch (err) {
+        if (err instanceof ValidationError) {
+          console.error(err.toStringFormatted());
+        } else {
+          console.error(err);
+        }
+      }
+    }
+  };
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createMDX,
-  postInstall,
-  start
+  postInstall
 });