fumadocs-mdx 13.0.0 → 13.0.2

package/dist/vite/index.cjs

@@ -199,18 +199,18 @@ async function compileConfig(configPath, outDir) {
 }
 async function loadConfig(configPath, outDir, build = false) {
   if (build) await compileConfig(configPath, outDir);
-  const url = (0, import_node_url3.pathToFileURL)(path10.resolve(outDir, "source.config.mjs"));
+  const url = (0, import_node_url3.pathToFileURL)(path11.resolve(outDir, "source.config.mjs"));
   url.searchParams.set("hash", Date.now().toString());
   const config = import(url.href).then(
     (loaded) => buildConfig(loaded)
   );
   return await config;
 }
-var path10, import_node_url3;
+var path11, import_node_url3;
 var init_load = __esm({
   "src/loaders/config/load.ts"() {
     "use strict";
-    path10 = __toESM(require("path"), 1);
+    path11 = __toESM(require("path"), 1);
     import_node_url3 = require("url");
     init_build();
   }
@@ -266,7 +266,7 @@ async function validate(schema, data, context, errorMessage) {
 }
 
 // src/vite/index.ts
-var path11 = __toESM(require("path"), 1);
+var path12 = __toESM(require("path"), 1);
 var import_js_yaml2 = require("js-yaml");
 
 // src/utils/fuma-matter.ts
@@ -675,14 +675,6 @@ var cacheEntry = import_zod.z.object({
   map: import_zod.z.any().optional(),
   hash: import_zod.z.string().optional()
 });
-var hashes = /* @__PURE__ */ new WeakMap();
-function getConfigHash(config) {
-  let hash = hashes.get(config);
-  if (hash) return hash;
-  hash = Date.now().toString();
-  hashes.set(config, hash);
-  return hash;
-}
 function createMdxLoader(configLoader) {
   return async ({
     source: value,
@@ -693,14 +685,25 @@ function createMdxLoader(configLoader) {
   }) => {
     const matter = fumaMatter(value);
     const parsed = querySchema.parse(query);
-    const loaded = await configLoader.getConfig();
-    const cacheDir = isDevelopment ? void 0 : loaded.global.experimentalBuildCache;
-    const cacheKey = `${parsed.hash}_${parsed.collection ?? "global"}_${generateCacheHash(filePath)}`;
-    if (cacheDir) {
+    const config = await configLoader.getConfig();
+    let after;
+    if (!isDevelopment && config.global.experimentalBuildCache) {
+      const cacheDir = config.global.experimentalBuildCache;
+      const cacheKey = `${parsed.hash}_${parsed.collection ?? "global"}_${generateCacheHash(filePath)}`;
       const cached = await import_promises.default.readFile(import_node_path2.default.join(cacheDir, cacheKey)).then((content) => cacheEntry.parse(JSON.parse(content.toString()))).catch(() => null);
       if (cached && cached.hash === generateCacheHash(value)) return cached;
+      after = async () => {
+        await import_promises.default.mkdir(cacheDir, { recursive: true });
+        await import_promises.default.writeFile(
+          import_node_path2.default.join(cacheDir, cacheKey),
+          JSON.stringify({
+            ...out,
+            hash: generateCacheHash(value)
+          })
+        );
+      };
     }
-    const collection = parsed.collection ? loaded.collections.get(parsed.collection) : void 0;
+    const collection = parsed.collection ? config.collections.get(parsed.collection) : void 0;
     let docCollection;
     switch (collection?.type) {
       case "doc":
@@ -728,16 +731,16 @@ function createMdxLoader(configLoader) {
       };
     }
     const data = {};
-    if (loaded.global.lastModifiedTime === "git") {
+    if (config.global.lastModifiedTime === "git") {
       data.lastModified = (await getGitTimestamp(filePath))?.getTime();
     }
     const lineOffset = isDevelopment ? countLines(matter.matter) : 0;
     const compiled = await buildMDX(
-      `${getConfigHash(loaded)}:${parsed.collection ?? "global"}`,
+      `${getConfigHash(config)}:${parsed.collection ?? "global"}`,
       "\n".repeat(lineOffset) + matter.content,
       {
         development: isDevelopment,
-        ...docCollection?.mdxOptions ?? await loaded.getDefaultMDXOptions(),
+        ...docCollection?.mdxOptions ?? await config.getDefaultMDXOptions(),
         postprocess: docCollection?.postprocess,
         data,
         filePath,
@@ -749,19 +752,18 @@ function createMdxLoader(configLoader) {
       code: String(compiled.value),
       map: compiled.map
     };
-    if (cacheDir) {
-      await import_promises.default.mkdir(cacheDir, { recursive: true });
-      await import_promises.default.writeFile(
-        import_node_path2.default.join(cacheDir, cacheKey),
-        JSON.stringify({
-          ...out,
-          hash: generateCacheHash(value)
-        })
-      );
-    }
+    await after?.();
     return out;
   };
 }
+var hashes = /* @__PURE__ */ new WeakMap();
+function getConfigHash(config) {
+  let hash = hashes.get(config);
+  if (hash) return hash;
+  hash = Date.now().toString();
+  hashes.set(config, hash);
+  return hash;
+}
 function generateCacheHash(input) {
   return (0, import_node_crypto.createHash)("md5").update(input).digest("hex");
 }
@@ -779,13 +781,6 @@ var import_promises2 = __toESM(require("fs/promises"), 1);
 function findConfigFile() {
   return import_node_path3.default.resolve("source.config.ts");
 }
-function resolvedConfig(loaded) {
-  return {
-    getConfig() {
-      return loaded;
-    }
-  };
-}
 
 // src/loaders/adapter.ts
 var import_node_url = require("url");
@@ -840,28 +835,29 @@ function ident(code, tab = 1) {
 }
 
 // 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_path6 = __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(",")}}`];
 }
 
 // src/utils/glob-import.ts
-var import_tinyglobby = require("tinyglobby");
-var import_node_path6 = __toESM(require("path"), 1);
+var import_tinyglobby2 = require("tinyglobby");
+var import_node_path7 = __toESM(require("path"), 1);
 var import_node_url2 = require("url");
 function generateGlobImport(patterns, options) {
   let code = "{";
-  const result = (0, import_tinyglobby.globSync)(patterns, {
+  const result = (0, import_tinyglobby2.globSync)(patterns, {
     cwd: options.base
   });
   for (const item of result) {
-    const fullPath = import_node_path6.default.join(options.base, item);
+    const fullPath = import_node_path7.default.join(options.base, item);
     const url = (0, import_node_url2.pathToFileURL)(fullPath);
     for (const [k, v] of Object.entries(options.query ?? {})) {
       url.searchParams.set(k, v);
@@ -877,7 +873,7 @@ function generateGlobImport(patterns, options) {
 }
 
 // src/plugins/vite.ts
-var import_node_path7 = __toESM(require("path"), 1);
+var import_node_path8 = __toESM(require("path"), 1);
 function vite(options) {
   let config;
   return {
@@ -885,7 +881,6 @@ function vite(options) {
       config = v;
     },
     emit() {
-      console.log("[Fumadocs MDX] Generating index files");
       return [
         {
           path: "index.ts",
@@ -918,12 +913,12 @@ ${obj}
   }
   function doc(name, collection) {
     const patterns = getGlobPatterns(collection);
-    const base = getGlobBase(collection);
+    const dir = getCollectionDir(collection);
     const docGlob = generateGlob(patterns, {
       query: {
         collection: name
       },
-      base
+      base: dir
     });
     if (collection.async) {
       const headBlob = generateGlob(patterns, {
@@ -932,32 +927,32 @@ ${obj}
           collection: name
         },
         import: "frontmatter",
-        base
+        base: dir
       });
-      return `create.docLazy("${name}", "${base}", ${headBlob}, ${docGlob})`;
+      return `create.docLazy("${name}", "${dir}", ${headBlob}, ${docGlob})`;
     }
-    return `create.doc("${name}", "${base}", ${docGlob})`;
+    return `create.doc("${name}", "${dir}", ${docGlob})`;
   }
   function meta(name, collection) {
     const patterns = getGlobPatterns(collection);
-    const base = getGlobBase(collection);
-    return `create.meta("${name}", "${base}", ${generateGlob(patterns, {
+    const dir = getCollectionDir(collection);
+    return `create.meta("${name}", "${dir}", ${generateGlob(patterns, {
       import: "default",
-      base,
+      base: dir,
       query: {
         collection: name
       }
     })})`;
   }
   function generateGlob(patterns, options2) {
-    patterns = mapGlobPatterns(patterns);
+    patterns = patterns.map(normalizeGlobPath);
     if (runtime === "node" || runtime === "bun") {
       return generateGlobImport(patterns, options2);
     } else {
       return `import.meta.glob(${JSON.stringify(patterns)}, ${JSON.stringify(
         {
           ...options2,
-          base: import_node_path7.default.relative(outDir, options2.base)
+          base: normalizeGlobPath(import_node_path8.default.relative(outDir, options2.base))
         },
         null,
         2
@@ -978,63 +973,100 @@ ${obj}
   }
   return lines.join("\n");
 }
-function mapGlobPatterns(patterns) {
-  return patterns.map(enforceRelative);
-}
-function enforceRelative(file) {
+function normalizeGlobPath(file) {
+  file = slash(file);
   if (file.startsWith("./")) return file;
   if (file.startsWith("/")) return `.${file}`;
   return `./${file}`;
 }
-function getGlobBase(collection) {
-  let dir = collection.dir;
+function getCollectionDir(collection) {
+  const dir = collection.dir;
   if (Array.isArray(dir)) {
     if (dir.length !== 1)
       throw new Error(
         `[Fumadocs MDX] Vite Plugin doesn't support multiple \`dir\` for a collection at the moment.`
       );
-    dir = dir[0];
+    return dir[0];
+  }
+  return dir;
+}
+function slash(path13) {
+  const isExtendedLengthPath = path13.startsWith("\\\\?\\");
+  if (isExtendedLengthPath) {
+    return path13;
   }
-  return enforceRelative(dir);
+  return path13.replaceAll("\\", "/");
 }
 
-// src/plugins/index.ts
-var import_node_path8 = __toESM(require("path"), 1);
+// src/core.ts
+var import_node_path9 = __toESM(require("path"), 1);
 var import_promises4 = __toESM(require("fs/promises"), 1);
-function createPluginHandler(context, defaultPlugins = []) {
-  const plugins2 = [];
-  async function write(entry) {
-    const file = import_node_path8.default.join(context.outDir, entry.path);
-    await import_promises4.default.mkdir(import_node_path8.default.dirname(file), { recursive: true });
-    await import_promises4.default.writeFile(file, entry.content);
-  }
+function createCore(options, defaultPlugins = []) {
+  let config;
+  let plugins2;
   return {
-    async init(config) {
-      if (config.global.plugins) {
-        defaultPlugins.push(...config.global.plugins);
-      }
-      for await (const option of defaultPlugins) {
+    _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);
       }
       for (const plugin of plugins2) {
-        const out = await plugin.config?.call(context, config);
+        const out = await plugin.config?.call(this.getPluginContext(), config);
         if (out) config = out;
       }
+      return this;
+    },
+    getConfig() {
       return config;
     },
-    async emit() {
+    creatConfigLoader() {
+      return {
+        getConfig() {
+          return config;
+        }
+      };
+    },
+    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) => {
-          return plugin.emit?.call(context) ?? [];
+          if (!filterPlugin(plugin) || !plugin.emit) return [];
+          return plugin.emit.call(this.getPluginContext());
         })
       );
-      return out.flat();
-    },
-    async emitAndWrite() {
-      const entries = await this.emit();
-      await Promise.all(entries.map(write));
+      await Promise.all(
+        out.flat().map(async (entry) => {
+          const file = import_node_path9.default.join(options.outDir, entry.path);
+          await import_promises4.default.mkdir(import_node_path9.default.dirname(file), { recursive: true });
+          await import_promises4.default.writeFile(file, entry.content);
+        })
+      );
+      console.log(`[MDX] generated files in ${performance.now() - start}ms`);
     }
   };
 }
@@ -1043,14 +1075,14 @@ function createPluginHandler(context, defaultPlugins = []) {
 var FumadocsDeps = ["fumadocs-core", "fumadocs-ui", "fumadocs-openapi"];
 async function mdx(config, pluginOptions = {}) {
   const options = applyDefaults(pluginOptions);
-  const { updateViteConfig } = options;
-  const pluginHandler = createVitePluginHandler(options);
-  const loaded = await pluginHandler.init(buildConfig(config));
-  const mdxLoader = toVite(createMdxLoader(resolvedConfig(loaded)));
-  async function transformMeta(path12, query, value) {
-    const isJson = path12.endsWith(".json");
+  const core = await createViteCore(options).init({
+    config: buildConfig(config)
+  });
+  const mdxLoader = toVite(createMdxLoader(core.creatConfigLoader()));
+  async function transformMeta(path13, query, value) {
+    const isJson = path13.endsWith(".json");
     const parsed = (0, import_node_querystring2.parse)(query);
-    const collection = parsed.collection ? loaded.collections.get(parsed.collection) : void 0;
+    const collection = parsed.collection ? core.getConfig().collections.get(parsed.collection) : void 0;
     if (!collection) return null;
     let schema;
     switch (collection.type) {
@@ -1071,8 +1103,8 @@ async function mdx(config, pluginOptions = {}) {
     const out = await validate(
       schema,
       data,
-      { path: path12, source: value },
-      `invalid data in ${path12}`
+      { path: path13, source: value },
+      `invalid data in ${path13}`
     );
     return {
       code: isJson ? JSON.stringify(out) : `export default ${JSON.stringify(out)}`,
@@ -1084,7 +1116,7 @@ async function mdx(config, pluginOptions = {}) {
     // needed, otherwise other plugins will be executed before our `transform`.
     enforce: "pre",
     config(config2) {
-      if (!updateViteConfig) return config2;
+      if (!options.updateViteConfig) return config2;
       return (0, import_vite.mergeConfig)(config2, {
         optimizeDeps: {
           exclude: FumadocsDeps
@@ -1096,11 +1128,16 @@ async function mdx(config, pluginOptions = {}) {
       });
     },
     async buildStart() {
-      await pluginHandler.emitAndWrite();
+      await core.emitAndWrite();
+    },
+    async configureServer(server) {
+      await core.initServer({
+        watcher: server.watcher
+      });
     },
     async transform(value, id) {
       const [file, query = ""] = id.split("?");
-      const ext = path11.extname(file);
+      const ext = path12.extname(file);
       try {
         if ([".yaml", ".json"].includes(ext))
           return await transformMeta(file, query, value);
@@ -1118,17 +1155,17 @@ async function mdx(config, pluginOptions = {}) {
 async function postInstall(configPath = findConfigFile(), pluginOptions = {}) {
   const { loadConfig: loadConfig2 } = await Promise.resolve().then(() => (init_load(), load_exports));
   const options = applyDefaults(pluginOptions);
-  const pluginHandler = createVitePluginHandler(options);
-  await pluginHandler.init(await loadConfig2(configPath, options.outDir, true));
-  await pluginHandler.emitAndWrite();
-  console.log("[MDX] types generated");
+  const core = await createViteCore(options).init({
+    config: loadConfig2(configPath, options.outDir, true)
+  });
+  await core.emitAndWrite();
 }
-function createVitePluginHandler({
+function createViteCore({
   configPath,
   outDir,
   generateIndexFile
 }) {
-  return createPluginHandler(
+  return createCore(
     {
       environment: "vite",
       configPath,

package/dist/vite/index.js

@@ -1,29 +1,28 @@
 import {
-  toVite
-} from "../chunk-XV5Z4BFL.js";
-import {
-  getGlobPatterns,
   ident,
   toImportPath
-} from "../chunk-6Y5JDZHD.js";
+} from "../chunk-CXA4JO4Z.js";
+import {
+  buildConfig
+} from "../chunk-U4MQ44TS.js";
+import {
+  toVite
+} from "../chunk-YVCR6FUH.js";
 import {
   createMdxLoader
-} from "../chunk-CEA6MYJU.js";
+} from "../chunk-XQ5O7IPO.js";
 import "../chunk-3J3WL7WN.js";
 import "../chunk-K5ZLPEIQ.js";
-import {
-  buildConfig
-} from "../chunk-U4MQ44TS.js";
 import {
   ValidationError,
+  createCore,
   findConfigFile,
-  resolvedConfig,
   validate
-} from "../chunk-HI62EXSB.js";
+} from "../chunk-EELYB2XC.js";
 import "../chunk-VWJKRQZR.js";
 import {
-  createPluginHandler
-} from "../chunk-4MAYA5QX.js";
+  getGlobPatterns
+} from "../chunk-XZY2AWJI.js";
 
 // src/vite/index.ts
 import {
@@ -67,7 +66,6 @@ function vite(options) {
       config = v;
     },
     emit() {
-      console.log("[Fumadocs MDX] Generating index files");
       return [
         {
           path: "index.ts",
@@ -100,12 +98,12 @@ ${obj}
   }
   function doc(name, collection) {
     const patterns = getGlobPatterns(collection);
-    const base = getGlobBase(collection);
+    const dir = getCollectionDir(collection);
     const docGlob = generateGlob(patterns, {
       query: {
         collection: name
       },
-      base
+      base: dir
     });
     if (collection.async) {
       const headBlob = generateGlob(patterns, {
@@ -114,32 +112,32 @@ ${obj}
           collection: name
         },
         import: "frontmatter",
-        base
+        base: dir
       });
-      return `create.docLazy("${name}", "${base}", ${headBlob}, ${docGlob})`;
+      return `create.docLazy("${name}", "${dir}", ${headBlob}, ${docGlob})`;
     }
-    return `create.doc("${name}", "${base}", ${docGlob})`;
+    return `create.doc("${name}", "${dir}", ${docGlob})`;
   }
   function meta(name, collection) {
     const patterns = getGlobPatterns(collection);
-    const base = getGlobBase(collection);
-    return `create.meta("${name}", "${base}", ${generateGlob(patterns, {
+    const dir = getCollectionDir(collection);
+    return `create.meta("${name}", "${dir}", ${generateGlob(patterns, {
       import: "default",
-      base,
+      base: dir,
       query: {
         collection: name
       }
     })})`;
   }
   function generateGlob(patterns, options2) {
-    patterns = mapGlobPatterns(patterns);
+    patterns = patterns.map(normalizeGlobPath);
     if (runtime === "node" || runtime === "bun") {
       return generateGlobImport(patterns, options2);
     } else {
       return `import.meta.glob(${JSON.stringify(patterns)}, ${JSON.stringify(
         {
           ...options2,
-          base: path2.relative(outDir, options2.base)
+          base: normalizeGlobPath(path2.relative(outDir, options2.base))
         },
         null,
         2
@@ -160,38 +158,43 @@ ${obj}
   }
   return lines.join("\n");
 }
-function mapGlobPatterns(patterns) {
-  return patterns.map(enforceRelative);
-}
-function enforceRelative(file) {
+function normalizeGlobPath(file) {
+  file = slash(file);
   if (file.startsWith("./")) return file;
   if (file.startsWith("/")) return `.${file}`;
   return `./${file}`;
 }
-function getGlobBase(collection) {
-  let dir = collection.dir;
+function getCollectionDir(collection) {
+  const dir = collection.dir;
   if (Array.isArray(dir)) {
     if (dir.length !== 1)
       throw new Error(
         `[Fumadocs MDX] Vite Plugin doesn't support multiple \`dir\` for a collection at the moment.`
       );
-    dir = dir[0];
+    return dir[0];
+  }
+  return dir;
+}
+function slash(path4) {
+  const isExtendedLengthPath = path4.startsWith("\\\\?\\");
+  if (isExtendedLengthPath) {
+    return path4;
   }
-  return enforceRelative(dir);
+  return path4.replaceAll("\\", "/");
 }
 
 // src/vite/index.ts
 var FumadocsDeps = ["fumadocs-core", "fumadocs-ui", "fumadocs-openapi"];
 async function mdx(config, pluginOptions = {}) {
   const options = applyDefaults(pluginOptions);
-  const { updateViteConfig } = options;
-  const pluginHandler = createVitePluginHandler(options);
-  const loaded = await pluginHandler.init(buildConfig(config));
-  const mdxLoader = toVite(createMdxLoader(resolvedConfig(loaded)));
+  const core = await createViteCore(options).init({
+    config: buildConfig(config)
+  });
+  const mdxLoader = toVite(createMdxLoader(core.creatConfigLoader()));
   async function transformMeta(path4, query, value) {
     const isJson = path4.endsWith(".json");
     const parsed = parse(query);
-    const collection = parsed.collection ? loaded.collections.get(parsed.collection) : void 0;
+    const collection = parsed.collection ? core.getConfig().collections.get(parsed.collection) : void 0;
     if (!collection) return null;
     let schema;
     switch (collection.type) {
@@ -225,7 +228,7 @@ async function mdx(config, pluginOptions = {}) {
     // needed, otherwise other plugins will be executed before our `transform`.
     enforce: "pre",
     config(config2) {
-      if (!updateViteConfig) return config2;
+      if (!options.updateViteConfig) return config2;
       return mergeConfig(config2, {
         optimizeDeps: {
           exclude: FumadocsDeps
@@ -237,7 +240,12 @@ async function mdx(config, pluginOptions = {}) {
       });
     },
     async buildStart() {
-      await pluginHandler.emitAndWrite();
+      await core.emitAndWrite();
+    },
+    async configureServer(server) {
+      await core.initServer({
+        watcher: server.watcher
+      });
     },
     async transform(value, id) {
       const [file, query = ""] = id.split("?");
@@ -259,17 +267,17 @@ async function mdx(config, pluginOptions = {}) {
 async function postInstall(configPath = findConfigFile(), pluginOptions = {}) {
   const { loadConfig } = await import("../load-MNG3CLET.js");
   const options = applyDefaults(pluginOptions);
-  const pluginHandler = createVitePluginHandler(options);
-  await pluginHandler.init(await loadConfig(configPath, options.outDir, true));
-  await pluginHandler.emitAndWrite();
-  console.log("[MDX] types generated");
+  const core = await createViteCore(options).init({
+    config: loadConfig(configPath, options.outDir, true)
+  });
+  await core.emitAndWrite();
 }
-function createVitePluginHandler({
+function createViteCore({
   configPath,
   outDir,
   generateIndexFile
 }) {
-  return createPluginHandler(
+  return createCore(
     {
       environment: "vite",
       configPath,