fumadocs-mdx 14.0.0 → 14.0.1

package/dist/next/index.js

@@ -1,6 +1,6 @@
 import {
   loadConfig
-} from "../chunk-OXSRIWQW.js";
+} from "../chunk-MTTISKQJ.js";
 import "../chunk-ZY6UZ7NH.js";
 import "../chunk-E5DJTSIM.js";
 import {
@@ -11,11 +11,11 @@ import {
   ValidationError,
   _Defaults,
   createCore
-} from "../chunk-7L2KNF6B.js";
+} from "../chunk-BEBCWQC7.js";
 import {
   indexFile
-} from "../chunk-XHJCLBZ4.js";
-import "../chunk-PKI7ZDA5.js";
+} from "../chunk-7UKSZSPY.js";
+import "../chunk-WBIHDYMN.js";
 import "../chunk-VWJKRQZR.js";
 
 // src/next/index.ts
@@ -30,7 +30,7 @@ function createMDX(createOptions = {}) {
   }
   return (nextConfig = {}) => {
     const loaderOptions = {
-      ...core._options,
+      ...core.getOptions(),
       compiledConfigPath: core.getCompiledConfigPath(),
       isDev
     };
@@ -112,12 +112,13 @@ async function init(dev, core) {
   }
   async function devServer() {
     const { FSWatcher } = await import("chokidar");
+    const { configPath, outDir } = core.getOptions();
     const watcher = new FSWatcher({
       ignoreInitial: true,
       persistent: true,
-      ignored: [core._options.outDir]
+      ignored: [outDir]
     });
-    watcher.add(core._options.configPath);
+    watcher.add(configPath);
     for (const collection of core.getConfig().collectionList) {
       if (collection.type === "docs") {
         watcher.add(collection.docs.dir);
@@ -129,8 +130,9 @@ async function init(dev, core) {
     watcher.on("ready", () => {
       console.log("[MDX] started dev server");
     });
+    const absoluteConfigPath = path.resolve(configPath);
     watcher.on("all", async (_event, file) => {
-      if (path.resolve(file) === path.resolve(core._options.configPath)) {
+      if (path.resolve(file) === absoluteConfigPath) {
         watcher.removeAllListeners();
         await watcher.close();
         await initOrReload();

package/dist/node/loader.cjs

@@ -177,7 +177,7 @@ function remarkInclude() {
   const embedContent = async (file, heading, params, data) => {
     let content;
     try {
-      content = (await fs3.readFile(file)).toString();
+      content = (await fs2.readFile(file)).toString();
     } catch (e) {
       throw new Error(
         `failed to read file ${file}
@@ -250,14 +250,14 @@ ${e instanceof Error ? e.message : String(e)}`,
     await update(tree, path3.dirname(file.path), file.data);
   };
 }
-var import_unified, import_unist_util_visit2, path3, fs3, import_mdx_plugins, ElementLikeTypes;
+var import_unified, import_unist_util_visit2, path3, fs2, import_mdx_plugins, ElementLikeTypes;
 var init_remark_include = __esm({
   "src/loaders/mdx/remark-include.ts"() {
     "use strict";
     import_unified = require("unified");
     import_unist_util_visit2 = require("unist-util-visit");
     path3 = __toESM(require("path"), 1);
-    fs3 = __toESM(require("fs/promises"), 1);
+    fs2 = __toESM(require("fs/promises"), 1);
     init_fuma_matter();
     import_mdx_plugins = require("fumadocs-core/mdx-plugins");
     init_remark_unravel();
@@ -653,10 +653,11 @@ __export(load_from_file_exports, {
 });
 async function compileConfig(core2) {
   const { build } = await import("esbuild");
+  const { configPath, outDir } = core2.getOptions();
   const transformed = await build({
-    entryPoints: [{ in: core2._options.configPath, out: "source.config" }],
+    entryPoints: [{ in: configPath, out: "source.config" }],
     bundle: true,
-    outdir: core2._options.outDir,
+    outdir: outDir,
     target: "node20",
     write: true,
     platform: "node",
@@ -698,24 +699,7 @@ module.exports = __toCommonJS(loader_exports);
 
 // src/core.ts
 var import_node_path2 = __toESM(require("path"), 1);
-var import_promises2 = __toESM(require("fs/promises"), 1);
-
-// src/utils/codegen/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;
-}
-function removeFileCache(file) {
-  map.delete(toFullPath(file));
-}
 
 // src/utils/validation.ts
 var ValidationError = class extends Error {
@@ -755,6 +739,13 @@ async function validate(schema, data, context, errorMessage) {
   return data;
 }
 
+// src/utils/codegen.ts
+var import_node_path = __toESM(require("path"), 1);
+var import_tinyglobby = require("tinyglobby");
+function ident(code, tab = 1) {
+  return code.split("\n").map((v) => "  ".repeat(tab) + v).join("\n");
+}
+
 // src/core.ts
 var _Defaults = {
   configPath: "source.config.ts",
@@ -788,7 +779,6 @@ function createCore(options, defaultPlugins = []) {
     return data;
   }
   const core2 = {
-    _options: options,
     /**
      * Convenient cache store, reset when config changes
      */
@@ -797,6 +787,7 @@ function createCore(options, defaultPlugins = []) {
       config = await newConfig;
       this.cache.clear();
       plugins = await getPlugins([
+        postprocessPlugin(),
         ...defaultPlugins,
         ...config.global.plugins ?? []
       ]);
@@ -804,7 +795,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;
@@ -815,10 +808,13 @@ function createCore(options, defaultPlugins = []) {
     getCompiledConfigPath() {
       return import_node_path2.default.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);
       }
@@ -837,8 +833,8 @@ function createCore(options, defaultPlugins = []) {
       await Promise.all(
         out.map(async (entry) => {
           const file = import_node_path2.default.join(options.outDir, entry.path);
-          await import_promises2.default.mkdir(import_node_path2.default.dirname(file), { recursive: true });
-          await import_promises2.default.writeFile(file, entry.content);
+          await import_promises.default.mkdir(import_node_path2.default.dirname(file), { recursive: true });
+          await import_promises.default.writeFile(file, entry.content);
         })
       );
       console.log(`[MDX] generated files in ${performance.now() - start}ms`);
@@ -885,11 +881,50 @@ function createCore(options, defaultPlugins = []) {
   };
   return core2;
 }
+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");
+      }
+    }
+  };
+}
 
 // src/loaders/mdx/index.ts
 init_fuma_matter();
 var import_zod = require("zod");
-var import_promises3 = __toESM(require("fs/promises"), 1);
+var import_promises2 = __toESM(require("fs/promises"), 1);
 var import_node_path3 = __toESM(require("path"), 1);
 var import_node_crypto = require("crypto");
 
@@ -925,11 +960,11 @@ function createMdxLoader(configLoader2) {
       if (!isDevelopment && config.global.experimentalBuildCache) {
         const cacheDir = config.global.experimentalBuildCache;
         const cacheKey = `${parsed.hash}_${parsed.collection ?? "global"}_${generateCacheHash(filePath)}`;
-        const cached = await import_promises3.default.readFile(import_node_path3.default.join(cacheDir, cacheKey)).then((content) => cacheEntry.parse(JSON.parse(content.toString()))).catch(() => null);
+        const cached = await import_promises2.default.readFile(import_node_path3.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_promises3.default.mkdir(cacheDir, { recursive: true });
-          await import_promises3.default.writeFile(
+          await import_promises2.default.mkdir(cacheDir, { recursive: true });
+          await import_promises2.default.writeFile(
             import_node_path3.default.join(cacheDir, cacheKey),
             JSON.stringify({
               ...out,
@@ -992,7 +1027,7 @@ function countLines(s) {
 
 // src/loaders/adapter.ts
 var import_node_url = require("url");
-var import_promises4 = __toESM(require("fs/promises"), 1);
+var import_promises3 = __toESM(require("fs/promises"), 1);
 var import_node_querystring = require("querystring");
 var import_node_path4 = __toESM(require("path"), 1);
 var import_node_fs = require("fs");
@@ -1005,7 +1040,7 @@ function toNode(loader) {
         filePath,
         query: Object.fromEntries(parsedUrl.searchParams.entries()),
         async getSource() {
-          return (await import_promises4.default.readFile(filePath)).toString();
+          return (await import_promises3.default.readFile(filePath)).toString();
         },
         development: false,
         compiler: {
@@ -1026,7 +1061,7 @@ function toNode(loader) {
 }
 
 // src/loaders/config.ts
-var import_promises5 = __toESM(require("fs/promises"), 1);
+var import_promises4 = __toESM(require("fs/promises"), 1);
 function createStandaloneConfigLoader({
   core: core2,
   buildConfig: buildConfig2,
@@ -1035,7 +1070,7 @@ function createStandaloneConfigLoader({
   let loaded;
   async function getConfigHash() {
     if (mode === "production") return "static";
-    const stats = await import_promises5.default.stat(core2._options.configPath).catch(() => {
+    const stats = await import_promises4.default.stat(core2.getOptions().configPath).catch(() => {
       throw new Error("Cannot find config file");
     });
     return stats.mtime.getTime().toString();

package/dist/node/loader.js

@@ -7,13 +7,13 @@ import {
 import {
   createStandaloneConfigLoader,
   toNode
-} from "../chunk-SRSRFOVI.js";
+} from "../chunk-K6HCOGOX.js";
 import "../chunk-4JSFLXXT.js";
 import {
   _Defaults,
   createCore
-} from "../chunk-7L2KNF6B.js";
-import "../chunk-PKI7ZDA5.js";
+} from "../chunk-BEBCWQC7.js";
+import "../chunk-WBIHDYMN.js";
 import "../chunk-VWJKRQZR.js";
 
 // src/node/loader.ts

package/dist/plugins/index-file.cjs

@@ -35,7 +35,7 @@ __export(index_file_exports, {
 module.exports = __toCommonJS(index_file_exports);
 var import_path = __toESM(require("path"), 1);
 
-// src/utils/codegen/index.ts
+// src/utils/codegen.ts
 var import_node_path = __toESM(require("path"), 1);
 var import_tinyglobby = require("tinyglobby");
 function createCodegen({
@@ -160,7 +160,7 @@ function ident(code, tab = 1) {
 // src/plugins/index-file.ts
 var import_tinyglobby2 = require("tinyglobby");
 
-// src/utils/codegen/cache.ts
+// src/utils/fs-cache.ts
 var import_lru_cache = require("lru-cache");
 var import_promises = __toESM(require("fs/promises"), 1);
 var import_node_path2 = __toESM(require("path"), 1);
@@ -173,7 +173,7 @@ function toFullPath(file) {
   }
   return file;
 }
-async function readFileWithCache(file) {
+function readFileWithCache(file) {
   const fullPath = toFullPath(file);
   const cached = map.get(fullPath);
   if (cached) return cached;
@@ -181,6 +181,9 @@ async function readFileWithCache(file) {
   map.set(fullPath, read);
   return read;
 }
+function removeFileCache(file) {
+  map.delete(toFullPath(file));
+}
 
 // src/plugins/index-file.ts
 var import_crypto = require("crypto");
@@ -214,6 +217,25 @@ 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 = [];
+    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);
+    }
+    if (typeConfigs.length === 0) {
+      typeConfigs.push("{ DocData: {} }");
+    }
+    return {
+      serverOptions,
+      tc: typeConfigs.join(" & ")
+    };
+  }
   return {
     name: "index-file",
     config(v) {
@@ -223,6 +245,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;
@@ -242,48 +265,47 @@ function indexFile(options = {}) {
     },
     async emit() {
       const globCache = /* @__PURE__ */ new Map();
-      const makeCodeGen = () => createCodegen({
-        target,
-        outDir: this.outDir,
-        jsExtension: addJsExtension,
-        globCache
-      });
-      async function toEmitEntry(path4, content) {
+      const { serverOptions, tc } = generateConfigs(this.core);
+      const toEmitEntry = async (path4, content) => {
+        const codegen = createCodegen({
+          target,
+          outDir: this.outDir,
+          jsExtension: addJsExtension,
+          globCache
+        });
+        await content({
+          core: this.core,
+          codegen,
+          serverOptions,
+          tc
+        });
         return {
           path: path4,
-          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) {
@@ -330,22 +352,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 = import_path.default.join(collection.dir, file);
@@ -408,14 +434,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) {
@@ -430,14 +455,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/plugins/index-file.d.cts

@@ -1,4 +1,4 @@
-import { j as Plugin } from '../index-D7JdSMpp.cjs';
+export { J as IndexFilePlugin, I as IndexFilePluginOptions, H as default } from '../core-DTuP23zu.cjs';
 import '@mdx-js/mdx';
 import '@standard-schema/spec';
 import 'unified';
@@ -6,24 +6,9 @@ import 'fumadocs-core/mdx-plugins';
 import 'zod';
 import 'chokidar';
 import 'vfile';
-
-interface IndexFilePluginOptions {
-    target?: 'default' | 'vite';
-    /**
-     * add `.js` extensions to imports, needed for ESM without bundler resolution
-     */
-    addJsExtension?: boolean;
-    /**
-     * Generate entry point for browser
-     * @defaultValue true
-     */
-    browser?: boolean;
-    /**
-     * Generate entry point for dynamic compilation
-     * @defaultValue true
-     */
-    dynamic?: boolean;
-}
-declare function indexFile(options?: IndexFilePluginOptions): Plugin;
-
-export { type IndexFilePluginOptions, indexFile as default };
+import 'fumadocs-core/source';
+import '../runtime/types.cjs';
+import 'fumadocs-core/mdx-plugins/remark-structure';
+import 'fumadocs-core/toc';
+import 'mdast';
+import 'mdx/types';

package/dist/plugins/index-file.d.ts

@@ -1,4 +1,4 @@
-import { j as Plugin } from '../index-D7JdSMpp.js';
+export { J as IndexFilePlugin, I as IndexFilePluginOptions, H as default } from '../core-B9ZoS6sA.js';
 import '@mdx-js/mdx';
 import '@standard-schema/spec';
 import 'unified';
@@ -6,24 +6,9 @@ import 'fumadocs-core/mdx-plugins';
 import 'zod';
 import 'chokidar';
 import 'vfile';
-
-interface IndexFilePluginOptions {
-    target?: 'default' | 'vite';
-    /**
-     * add `.js` extensions to imports, needed for ESM without bundler resolution
-     */
-    addJsExtension?: boolean;
-    /**
-     * Generate entry point for browser
-     * @defaultValue true
-     */
-    browser?: boolean;
-    /**
-     * Generate entry point for dynamic compilation
-     * @defaultValue true
-     */
-    dynamic?: boolean;
-}
-declare function indexFile(options?: IndexFilePluginOptions): Plugin;
-
-export { type IndexFilePluginOptions, indexFile as default };
+import 'fumadocs-core/source';
+import '../runtime/types.js';
+import 'fumadocs-core/mdx-plugins/remark-structure';
+import 'fumadocs-core/toc';
+import 'mdast';
+import 'mdx/types';

package/dist/plugins/index-file.js

@@ -1,7 +1,7 @@
 import {
   indexFile
-} from "../chunk-XHJCLBZ4.js";
-import "../chunk-PKI7ZDA5.js";
+} from "../chunk-7UKSZSPY.js";
+import "../chunk-WBIHDYMN.js";
 import "../chunk-VWJKRQZR.js";
 export {
   indexFile as default

package/dist/plugins/json-schema.d.cts

@@ -1,4 +1,4 @@
-import { j as Plugin } from '../index-D7JdSMpp.cjs';
+import { j as Plugin } from '../core-DTuP23zu.cjs';
 import '@mdx-js/mdx';
 import '@standard-schema/spec';
 import 'unified';
@@ -6,6 +6,12 @@ import 'fumadocs-core/mdx-plugins';
 import 'zod';
 import 'chokidar';
 import 'vfile';
+import 'fumadocs-core/source';
+import '../runtime/types.cjs';
+import 'fumadocs-core/mdx-plugins/remark-structure';
+import 'fumadocs-core/toc';
+import 'mdast';
+import 'mdx/types';
 
 interface JSONSchemaOptions {
     /**

package/dist/plugins/json-schema.d.ts

@@ -1,4 +1,4 @@
-import { j as Plugin } from '../index-D7JdSMpp.js';
+import { j as Plugin } from '../core-B9ZoS6sA.js';
 import '@mdx-js/mdx';
 import '@standard-schema/spec';
 import 'unified';
@@ -6,6 +6,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 JSONSchemaOptions {
     /**