fumadocs-mdx 14.0.0 → 14.0.2

package/dist/{build-mdx-6UAK5FF5.js → build-mdx-W3233QBZ.js}

@@ -1,6 +1,6 @@
 import {
   buildMDX
-} from "./chunk-SLY7WXTX.js";
+} from "./chunk-KOPLIEVQ.js";
 import "./chunk-FBLMK4RS.js";
 import "./chunk-VWJKRQZR.js";
 export {

package/dist/bun/index.d.ts

@@ -1,5 +1,5 @@
 import { BunPlugin } from 'bun';
-import { C as CoreOptions } from '../index-D7JdSMpp.js';
+import { C as CoreOptions } from '../core-C3QZSdEx.js';
 import '@mdx-js/mdx';
 import '@standard-schema/spec';
 import 'unified';
@@ -7,6 +7,12 @@ import 'fumadocs-core/mdx-plugins';
 import 'zod';
 import 'chokidar';
 import 'vfile';
+import 'fumadocs-core/source';
+import '../runtime/types.js';
+import 'fumadocs-core/mdx-plugins/remark-structure';
+import 'fumadocs-core/toc';
+import 'mdast';
+import 'mdx/types';
 
 interface MdxPluginOptions extends Partial<CoreOptions> {
     /**

package/dist/bun/index.js

@@ -1,23 +1,23 @@
 import {
   buildConfig
-} from "../chunk-ZY6UZ7NH.js";
-import "../chunk-E5DJTSIM.js";
+} from "../chunk-6RPNS75C.js";
+import "../chunk-S7KOJHHO.js";
 import {
   createMdxLoader
-} from "../chunk-6NISOLQ6.js";
+} from "../chunk-USWQVJWR.js";
 import {
   createMetaLoader
 } from "../chunk-TYJDYTKH.js";
 import {
   createIntegratedConfigLoader,
   toBun
-} from "../chunk-SRSRFOVI.js";
+} from "../chunk-OLL7FM7W.js";
 import "../chunk-4JSFLXXT.js";
 import {
   _Defaults,
   createCore
-} from "../chunk-7L2KNF6B.js";
-import "../chunk-PKI7ZDA5.js";
+} from "../chunk-GB4W3YCZ.js";
+import "../chunk-WBIHDYMN.js";
 import "../chunk-VWJKRQZR.js";
 
 // src/bun/index.ts
@@ -33,11 +33,12 @@ function createMdxPlugin(options = {}) {
     name: "bun-plugin-fumadocs-mdx",
     async setup(build) {
       const importPath = pathToFileURL(configPath).href;
-      const core = await createCore({
+      const core = createCore({
         environment,
         outDir,
         configPath
-      }).init({
+      });
+      await core.init({
         config: buildConfig(await import(importPath))
       });
       const configLoader = createIntegratedConfigLoader(core);

package/dist/{chunk-5YXP7JLN.js → chunk-5OBUOALK.js}

@@ -1,6 +1,7 @@
 // src/runtime/server.ts
 import * as path from "path";
-function fromConfig() {
+function server(options = {}) {
+  const { doc: { passthroughs: docPassthroughs = [] } = {} } = options;
   function fileInfo(file, base) {
     if (file.startsWith("./")) {
       file = file.slice(2);
@@ -11,14 +12,16 @@ function fromConfig() {
     };
   }
   function mapDocData(entry) {
-    return {
+    const data = {
       body: entry.default,
       toc: entry.toc,
-      extractedReferences: entry.extractedReferences,
       structuredData: entry.structuredData,
-      lastModified: entry.lastModified,
       _exports: entry
     };
+    for (const key of docPassthroughs) {
+      data[key] = entry[key];
+    }
+    return data;
   }
   return {
     async doc(_name, base, glob) {
@@ -133,6 +136,6 @@ function createDocMethods(info, load) {
 }
 
 export {
-  fromConfig,
+  server,
   toFumadocsSource
 };

package/dist/{chunk-ZY6UZ7NH.js → chunk-6RPNS75C.js}

@@ -1,6 +1,6 @@
 import {
   applyMdxPreset
-} from "./chunk-E5DJTSIM.js";
+} from "./chunk-S7KOJHHO.js";
 
 // src/config/build.ts
 import picomatch from "picomatch";

package/dist/{chunk-XHJCLBZ4.js → chunk-ED3ON275.js}

@@ -1,137 +1,41 @@
 import {
-  readFileWithCache
-} from "./chunk-PKI7ZDA5.js";
+  createCodegen,
+  ident
+} from "./chunk-WBIHDYMN.js";
 import {
   fumaMatter
 } from "./chunk-VWJKRQZR.js";
 
 // src/plugins/index-file.ts
 import path2 from "path";
+import { glob } from "tinyglobby";
 
-// src/utils/codegen/index.ts
+// src/utils/fs-cache.ts
+import { LRUCache } from "lru-cache";
+import fs from "fs/promises";
 import path from "path";
-import { glob } from "tinyglobby";
-function createCodegen({
-  target = "default",
-  outDir = "",
-  jsExtension = false,
-  globCache = /* @__PURE__ */ new Map()
-}) {
-  let eagerImportId = 0;
-  const banner = ["// @ts-nocheck"];
-  if (target === "vite") {
-    banner.push('/// <reference types="vite/client" />');
+var map = new LRUCache({
+  max: 100
+});
+function toFullPath(file) {
+  if (path.isAbsolute(file)) {
+    return path.relative(process.cwd(), file);
   }
-  return {
-    options: {
-      target,
-      outDir
-    },
-    lines: [],
-    addImport(statement) {
-      this.lines.unshift(statement);
-    },
-    async pushAsync(insert) {
-      for (const line of await Promise.all(insert)) {
-        if (line === void 0) continue;
-        this.lines.push(line);
-      }
-    },
-    async generateGlobImport(patterns, options) {
-      if (target === "vite") {
-        return this.generateViteGlobImport(patterns, options);
-      }
-      return this.generateNodeGlobImport(patterns, options);
-    },
-    generateViteGlobImport(patterns, { base, ...rest }) {
-      patterns = (typeof patterns === "string" ? [patterns] : patterns).map(
-        normalizeViteGlobPath
-      );
-      return `import.meta.glob(${JSON.stringify(patterns)}, ${JSON.stringify(
-        {
-          base: normalizeViteGlobPath(path.relative(outDir, base)),
-          ...rest
-        },
-        null,
-        2
-      )})`;
-    },
-    async generateNodeGlobImport(patterns, {
-      base,
-      eager = false,
-      query = {},
-      import: importName
-    }) {
-      const cacheKey = JSON.stringify({ patterns, base });
-      let files = globCache.get(cacheKey);
-      if (!files) {
-        files = glob(patterns, {
-          cwd: base
-        });
-        globCache.set(cacheKey, files);
-      }
-      let code = "{";
-      for (const item of await files) {
-        const fullPath = path.join(base, item);
-        const searchParams = new URLSearchParams();
-        for (const [k, v] of Object.entries(query)) {
-          searchParams.set(k, v);
-        }
-        const importPath = this.formatImportPath(fullPath) + "?" + searchParams.toString();
-        if (eager) {
-          const name = `__fd_glob_${eagerImportId++}`;
-          this.lines.unshift(
-            importName ? `import { ${importName} as ${name} } from ${JSON.stringify(importPath)}` : `import * as ${name} from ${JSON.stringify(importPath)}`
-          );
-          code += `${JSON.stringify(item)}: ${name}, `;
-        } else {
-          let line = `${JSON.stringify(item)}: () => import(${JSON.stringify(importPath)})`;
-          if (importName) {
-            line += `.then(mod => mod.${importName})`;
-          }
-          code += `${line}, `;
-        }
-      }
-      code += "}";
-      return code;
-    },
-    formatImportPath(file) {
-      const ext = path.extname(file);
-      let filename;
-      if (ext === ".ts" && jsExtension) {
-        filename = file.substring(0, file.length - ext.length) + ".js";
-      } else if (ext === ".ts") {
-        filename = file.substring(0, file.length - ext.length);
-      } else {
-        filename = file;
-      }
-      const importPath = slash(path.relative(outDir, filename));
-      return importPath.startsWith(".") ? importPath : `./${importPath}`;
-    },
-    toString() {
-      return [...banner, ...this.lines].join("\n");
-    }
-  };
+  return file;
 }
-function normalizeViteGlobPath(file) {
-  file = slash(file);
-  if (file.startsWith("./")) return file;
-  if (file.startsWith("/")) return `.${file}`;
-  return `./${file}`;
+function readFileWithCache(file) {
+  const fullPath = toFullPath(file);
+  const cached = map.get(fullPath);
+  if (cached) return cached;
+  const read = fs.readFile(fullPath).then((s) => s.toString());
+  map.set(fullPath, read);
+  return read;
 }
-function slash(path3) {
-  const isExtendedLengthPath = path3.startsWith("\\\\?\\");
-  if (isExtendedLengthPath) {
-    return path3;
-  }
-  return path3.replaceAll("\\", "/");
-}
-function ident(code, tab = 1) {
-  return code.split("\n").map((v) => "  ".repeat(tab) + v).join("\n");
+function removeFileCache(file) {
+  map.delete(toFullPath(file));
 }
 
 // src/plugins/index-file.ts
-import { glob as glob2 } from "tinyglobby";
 import { createHash } from "crypto";
 function indexFile(options = {}) {
   const {
@@ -145,6 +49,24 @@ function indexFile(options = {}) {
   function isDynamic(collection) {
     return collection.type === "docs" && collection.docs.dynamic || collection.type === "doc" && collection.dynamic;
   }
+  function generateConfigs(core) {
+    const serverOptions = {};
+    const typeConfigs = [
+      'import("fumadocs-mdx/runtime/types").InternalTypeConfig'
+    ];
+    const ctx = core.getPluginContext();
+    for (const plugin of core.getPlugins()) {
+      const indexFilePlugin = plugin["index-file"];
+      if (!indexFilePlugin) continue;
+      indexFilePlugin.serverOptions?.call(ctx, serverOptions);
+      const config2 = indexFilePlugin.generateTypeConfig?.call(ctx);
+      if (config2) typeConfigs.push(config2);
+    }
+    return {
+      serverOptions,
+      tc: typeConfigs.join(" & ")
+    };
+  }
   return {
     name: "index-file",
     config(v) {
@@ -154,6 +76,7 @@ function indexFile(options = {}) {
     configureServer(server) {
       if (!server.watcher) return;
       server.watcher.on("all", async (event, file) => {
+        removeFileCache(file);
         if (dynamicCollections.length === 0) {
           if (target === "vite") return;
           if (target === "default" && event === "change") return;
@@ -173,48 +96,47 @@ function indexFile(options = {}) {
     },
     async emit() {
       const globCache = /* @__PURE__ */ new Map();
-      const makeCodeGen = () => createCodegen({
-        target,
-        outDir: this.outDir,
-        jsExtension: addJsExtension,
-        globCache
-      });
-      async function toEmitEntry(path3, content) {
+      const { serverOptions, tc } = generateConfigs(this.core);
+      const toEmitEntry = async (path3, content) => {
+        const codegen = createCodegen({
+          target,
+          outDir: this.outDir,
+          jsExtension: addJsExtension,
+          globCache
+        });
+        await content({
+          core: this.core,
+          codegen,
+          serverOptions,
+          tc
+        });
         return {
           path: path3,
-          content: await content
+          content: codegen.toString()
         };
-      }
+      };
       const out = [
-        toEmitEntry(
-          "server.ts",
-          generateServerIndexFile(makeCodeGen(), config, this.configPath)
-        )
+        toEmitEntry("server.ts", generateServerIndexFile)
       ];
       if (dynamic)
-        out.push(
-          toEmitEntry(
-            "dynamic.ts",
-            generateDynamicIndexFile(this.core, makeCodeGen())
-          )
-        );
+        out.push(toEmitEntry("dynamic.ts", generateDynamicIndexFile));
       if (browser)
-        out.push(
-          toEmitEntry(
-            "browser.ts",
-            generateBrowserIndexFile(makeCodeGen(), config, this.configPath)
-          )
-        );
+        out.push(toEmitEntry("browser.ts", generateBrowserIndexFile));
       return await Promise.all(out);
     }
   };
 }
-async function generateServerIndexFile(codegen, config, configPath) {
+async function generateServerIndexFile({
+  core,
+  codegen,
+  serverOptions,
+  tc
+}) {
   codegen.lines.push(
-    `import { fromConfig } from 'fumadocs-mdx/runtime/server';`,
-    `import type * as Config from '${codegen.formatImportPath(configPath)}';`,
+    `import { server } from 'fumadocs-mdx/runtime/server';`,
+    `import type * as Config from '${codegen.formatImportPath(core.getOptions().configPath)}';`,
     "",
-    `const create = fromConfig<typeof Config>();`
+    `const create = server<typeof Config, ${tc}>(${JSON.stringify(serverOptions)});`
   );
   async function generateCollectionObject(collection) {
     switch (collection.type) {
@@ -261,22 +183,26 @@ async function generateServerIndexFile(codegen, config, configPath) {
     }
   }
   await codegen.pushAsync(
-    config.collectionList.map(async (collection) => {
+    core.getConfig().collectionList.map(async (collection) => {
       const obj = await generateCollectionObject(collection);
       if (!obj) return;
       return `
 export const ${collection.name} = ${obj};`;
     })
   );
-  return codegen.toString();
 }
-async function generateDynamicIndexFile(core, codegen) {
-  const { configPath } = core._options;
+async function generateDynamicIndexFile({
+  core,
+  codegen,
+  serverOptions,
+  tc
+}) {
+  const { configPath } = core.getOptions();
   codegen.lines.push(
-    `import { fromConfigDynamic } from 'fumadocs-mdx/runtime/dynamic';`,
+    `import { dynamic } from 'fumadocs-mdx/runtime/dynamic';`,
     `import * as Config from '${codegen.formatImportPath(configPath)}';`,
     "",
-    `const create = await fromConfigDynamic(Config);`
+    `const create = await dynamic<typeof Config, ${tc}>(Config, ${JSON.stringify(core.getOptions())}, ${JSON.stringify(serverOptions)});`
   );
   async function generateCollectionObjectEntry(collection, file) {
     const fullPath = path2.join(collection.dir, file);
@@ -312,7 +238,7 @@ async function generateDynamicIndexFile(core, codegen) {
     if (parent.type === "doc") collection = parent;
     else if (parent.type === "docs") collection = parent.docs;
     if (!collection || !collection.dynamic) return;
-    const files = await glob2(collection.patterns, {
+    const files = await glob(collection.patterns, {
       cwd: collection.dir
     });
     const entries = await Promise.all(
@@ -339,14 +265,13 @@ async function generateDynamicIndexFile(core, codegen) {
 export const ${collection.name} = ${obj};`;
     })
   );
-  return codegen.toString();
 }
-async function generateBrowserIndexFile(codegen, config, configPath) {
+async function generateBrowserIndexFile({ core, codegen, tc }) {
   codegen.lines.push(
-    `import { fromConfig } from 'fumadocs-mdx/runtime/browser';`,
-    `import type * as Config from '${codegen.formatImportPath(configPath)}';`,
+    `import { browser } from 'fumadocs-mdx/runtime/browser';`,
+    `import type * as Config from '${codegen.formatImportPath(core.getOptions().configPath)}';`,
     "",
-    `const create = fromConfig<typeof Config>();`
+    `const create = browser<typeof Config, ${tc}>();`
   );
   async function generateCollectionObject(collection) {
     switch (collection.type) {
@@ -361,14 +286,13 @@ async function generateBrowserIndexFile(codegen, config, configPath) {
   }
   codegen.lines.push("const browserCollections = {");
   await codegen.pushAsync(
-    config.collectionList.map(async (collection) => {
+    core.getConfig().collectionList.map(async (collection) => {
       const obj = await generateCollectionObject(collection);
       if (!obj) return;
       return ident(`${collection.name}: ${obj},`);
     })
   );
   codegen.lines.push("};", "export default browserCollections;");
-  return codegen.toString();
 }
 function generateDocCollectionFrontmatterGlob(codegen, collection, eager = false) {
   return codegen.generateGlobImport(collection.patterns, {

package/dist/{chunk-7L2KNF6B.js → chunk-GB4W3YCZ.js}

@@ -1,6 +1,6 @@
 import {
-  removeFileCache
-} from "./chunk-PKI7ZDA5.js";
+  ident
+} from "./chunk-WBIHDYMN.js";
 
 // src/utils/validation.ts
 var ValidationError = class extends Error {
@@ -75,7 +75,6 @@ function createCore(options, defaultPlugins = []) {
     return data;
   }
   const core = {
-    _options: options,
     /**
      * Convenient cache store, reset when config changes
      */
@@ -84,6 +83,7 @@ function createCore(options, defaultPlugins = []) {
       config = await newConfig;
       this.cache.clear();
       plugins = await getPlugins([
+        postprocessPlugin(),
         ...defaultPlugins,
         ...config.global.plugins ?? []
       ]);
@@ -91,7 +91,9 @@ function createCore(options, defaultPlugins = []) {
         const out = await plugin.config?.call(pluginContext, config);
         if (out) config = out;
       }
-      return this;
+    },
+    getOptions() {
+      return options;
     },
     getConfig() {
       return config;
@@ -102,10 +104,13 @@ function createCore(options, defaultPlugins = []) {
     getCompiledConfigPath() {
       return path.join(options.outDir, "source.config.mjs");
     },
+    getPlugins() {
+      return plugins;
+    },
+    getPluginContext() {
+      return pluginContext;
+    },
     async initServer(server) {
-      server.watcher?.on("all", async (event, file) => {
-        if (event === "change") removeFileCache(file);
-      });
       for (const plugin of plugins) {
         await plugin.configureServer?.call(pluginContext, server);
       }
@@ -172,6 +177,45 @@ function createCore(options, defaultPlugins = []) {
   };
   return core;
 }
+function postprocessPlugin() {
+  const LinkReferenceTypes = `{
+  /**
+   * extracted references (e.g. hrefs, paths), useful for analyzing relationships between pages.
+   */
+  extractedReferences: import("fumadocs-mdx").ExtractedReference[];
+}`;
+  return {
+    "index-file": {
+      generateTypeConfig() {
+        const lines = [];
+        lines.push("{");
+        lines.push("  DocData: {");
+        for (const collection of this.core.getConfig().collectionList) {
+          let postprocessOptions;
+          switch (collection.type) {
+            case "doc":
+              postprocessOptions = collection.postprocess;
+              break;
+            case "docs":
+              postprocessOptions = collection.docs.postprocess;
+              break;
+          }
+          if (postprocessOptions?.extractLinkReferences) {
+            lines.push(ident(`${collection.name}: ${LinkReferenceTypes},`, 2));
+          }
+        }
+        lines.push("  }");
+        lines.push("}");
+        return lines.join("\n");
+      },
+      serverOptions(options) {
+        options.doc ??= {};
+        options.doc.passthroughs ??= [];
+        options.doc.passthroughs.push("extractedReferences");
+      }
+    }
+  };
+}
 
 export {
   ValidationError,

package/dist/{chunk-SLY7WXTX.js → chunk-KOPLIEVQ.js}

@@ -38,6 +38,10 @@ function remarkPostprocess({
       });
     }
     file.data["mdx-export"] ??= [];
+    file.data["mdx-export"].push({
+      name: "frontmatter",
+      value: frontmatter
+    });
     if (extractLinkReferences) {
       const urls = [];
       visit(tree, "link", (node) => {
@@ -135,12 +139,7 @@ async function buildMDX(core, collection, {
     if (!processor) {
       const postprocessOptions = {
         _format: format,
-        ...collection?.postprocess,
-        valueToExport: [
-          ...collection?.postprocess?.valueToExport ?? [],
-          "structuredData",
-          "frontmatter"
-        ]
+        ...collection?.postprocess
       };
       processor = createProcessor({
         outputFormat: "program",

package/dist/{chunk-OXSRIWQW.js → chunk-LPX7ZO66.js}

@@ -1,15 +1,16 @@
 import {
   buildConfig
-} from "./chunk-ZY6UZ7NH.js";
+} from "./chunk-6RPNS75C.js";
 
 // src/config/load-from-file.ts
 import { pathToFileURL } from "url";
 async function compileConfig(core) {
   const { build } = await import("esbuild");
+  const { configPath, outDir } = core.getOptions();
   const transformed = await build({
-    entryPoints: [{ in: core._options.configPath, out: "source.config" }],
+    entryPoints: [{ in: configPath, out: "source.config" }],
     bundle: true,
-    outdir: core._options.outDir,
+    outdir: outDir,
     target: "node20",
     write: true,
     platform: "node",

package/dist/{chunk-SRSRFOVI.js → chunk-OLL7FM7W.js}

@@ -1,6 +1,6 @@
 import {
   ValidationError
-} from "./chunk-7L2KNF6B.js";
+} from "./chunk-GB4W3YCZ.js";
 
 // src/loaders/adapter.ts
 import { fileURLToPath } from "url";
@@ -137,13 +137,13 @@ function createStandaloneConfigLoader({
   let loaded;
   async function getConfigHash() {
     if (mode === "production") return "static";
-    const stats = await fs2.stat(core._options.configPath).catch(() => {
+    const stats = await fs2.stat(core.getOptions().configPath).catch(() => {
       throw new Error("Cannot find config file");
     });
     return stats.mtime.getTime().toString();
   }
   async function newConfig() {
-    const { loadConfig } = await import("./load-from-file-I3ALLIVB.js");
+    const { loadConfig } = await import("./load-from-file-OZ5N7DXU.js");
     await core.init({
       config: loadConfig(core, buildConfig)
     });

package/dist/{chunk-5UMZCWKV.js → chunk-Q5OSGLJL.js}

@@ -1,6 +1,6 @@
 import {
   createCore
-} from "./chunk-7L2KNF6B.js";
+} from "./chunk-GB4W3YCZ.js";
 
 // src/webpack/index.ts
 var core;

package/dist/{chunk-E5DJTSIM.js → chunk-S7KOJHHO.js}

@@ -47,7 +47,10 @@ function applyMdxPreset(options = {}) {
         ...v,
         remarkStructureOptions !== false && [
           plugins.remarkStructure,
-          remarkStructureOptions
+          {
+            exportAs: "structuredData",
+            ...remarkStructureOptions
+          }
         ],
         valueToExport.length > 0 && (() => {
           return (_, file) => {

package/dist/{chunk-6NISOLQ6.js → chunk-USWQVJWR.js}

@@ -73,7 +73,7 @@ function createMdxLoader(configLoader) {
         };
       }
       const lineOffset = isDevelopment ? countLines(matter.matter) : 0;
-      const { buildMDX } = await import("./build-mdx-6UAK5FF5.js");
+      const { buildMDX } = await import("./build-mdx-W3233QBZ.js");
       const compiled = await buildMDX(configLoader.core, docCollection, {
         isDevelopment,
         source: "\n".repeat(lineOffset) + matter.content,