fumadocs-mdx 11.7.5 → 11.8.1

package/dist/{types-CU9nn_je.d.ts → types-zBRxlyaM.d.ts}

@@ -2,10 +2,7 @@ import { StandardSchemaV1 } from '@standard-schema/spec';
 import { Source, PageData, MetaData } from 'fumadocs-core/source';
 import { a as DocCollection, M as MetaCollection, b as DocsCollection, G as GlobalConfig } from './define-DnJzAZrj.js';
 import { ProcessorOptions } from '@mdx-js/mdx';
-import { FC } from 'react';
-import { MDXProps } from 'mdx/types';
-import { StructuredData } from 'fumadocs-core/mdx-plugins';
-import { TableOfContents } from 'fumadocs-core/server';
+import { C as CompiledMDXProperties } from './build-mdx-DMe0r3s_.js';
 
 interface LoadedConfig {
     collections: Map<string, DocCollection | MetaCollection | DocsCollection>;
@@ -23,15 +20,8 @@ interface FileInfo {
     path: string;
     absolutePath: string;
 }
-interface MarkdownProps {
-    body: FC<MDXProps>;
-    structuredData: StructuredData;
-    toc: TableOfContents;
-    _exports: Record<string, unknown>;
-    /**
-     * Only available when `lastModifiedTime` is enabled on MDX loader
-     */
-    lastModified?: Date;
+interface MarkdownProps extends Omit<CompiledMDXProperties, 'frontmatter' | 'default'> {
+    body: CompiledMDXProperties['default'];
 }
 interface RuntimeFile {
     info: FileInfo;
@@ -40,10 +30,17 @@ interface RuntimeFile {
 interface AsyncRuntimeFile {
     info: FileInfo;
     data: Record<string, unknown>;
-    content: string;
+    content: {
+        matter: string;
+        body: string;
+    };
     lastModified?: Date;
 }
 type DocOut<Schema extends StandardSchemaV1> = Override<MarkdownProps & {
+    /**
+     * Other exports in the compiled Markdown/MDX file
+     */
+    _exports: Record<string, unknown>;
     /**
      * Read the original content of file from file system.
      */
@@ -65,7 +62,7 @@ interface Runtime {
 }
 type AsyncDocOut<Schema extends StandardSchemaV1> = StandardSchemaV1.InferOutput<Schema> & BaseCollectionEntry & {
     content: string;
-    load: () => Promise<MarkdownProps>;
+    load: () => Promise<MarkdownProps & Record<string, unknown>>;
 };
 interface RuntimeAsync {
     doc: <C>(files: AsyncRuntimeFile[], collection: string, config: LoadedConfig) => C extends DocCollection<infer Schema, true> ? AsyncDocOut<Schema>[] : never;

package/dist/vite/index.cjs

@@ -34,7 +34,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 function remarkMdxExport({ values }) {
   return (tree, vfile) => {
     for (const name of values) {
-      if (!(name in vfile.data)) return;
+      if (!(name in vfile.data)) continue;
       tree.children.unshift(getMdastExport(name, vfile.data[name]));
     }
   };
@@ -80,6 +80,27 @@ var init_remark_exports = __esm({
   }
 });
 
+// src/mdx-plugins/remark-extract.ts
+function remarkExtract() {
+  return (tree, file) => {
+    const urls = [];
+    (0, import_unist_util_visit.visit)(tree, "link", (node) => {
+      urls.push({
+        href: node.url
+      });
+      return "skip";
+    });
+    file.data.extractedReferences = urls;
+  };
+}
+var import_unist_util_visit;
+var init_remark_extract = __esm({
+  "src/mdx-plugins/remark-extract.ts"() {
+    "use strict";
+    import_unist_util_visit = require("unist-util-visit");
+  }
+});
+
 // src/utils/mdx-options.ts
 var mdx_options_exports = {};
 __export(mdx_options_exports, {
@@ -107,6 +128,7 @@ function getDefaultMDXOptions({
 }) {
   const mdxExports = [
     "structuredData",
+    "extractedReferences",
     "frontmatter",
     "lastModified",
     ...valueToExport
@@ -134,6 +156,7 @@ function getDefaultMDXOptions({
       ],
       "remarkNpm" in plugins && remarkNpmOptions !== false && [plugins.remarkNpm, remarkNpmOptions],
       ...v,
+      remarkExtract,
       remarkStructureOptions !== false && [
         plugins.remarkStructure,
         remarkStructureOptions
@@ -163,6 +186,7 @@ var init_mdx_options = __esm({
     "use strict";
     plugins = __toESM(require("fumadocs-core/mdx-plugins"), 1);
     init_remark_exports();
+    init_remark_extract();
   }
 });
 
@@ -227,7 +251,7 @@ function buildConfig(config) {
 var import_mdx = require("@mdx-js/mdx");
 
 // src/mdx-plugins/remark-include.ts
-var import_unist_util_visit = require("unist-util-visit");
+var import_unist_util_visit2 = require("unist-util-visit");
 var path = __toESM(require("path"), 1);
 var fs = __toESM(require("fs/promises"), 1);
 
@@ -240,9 +264,9 @@ function fumaMatter(input) {
   if (!match) {
     return output;
   }
-  output.matter = match[1];
+  output.matter = match[0];
   output.content = input.slice(match[0].length);
-  const loaded = (0, import_js_yaml.load)(output.matter);
+  const loaded = (0, import_js_yaml.load)(match[1]);
   output.data = loaded ?? {};
   return output;
 }
@@ -278,7 +302,7 @@ function remarkInclude() {
   const TagName = "include";
   async function update(tree, directory, data) {
     const queue = [];
-    (0, import_unist_util_visit.visit)(
+    (0, import_unist_util_visit2.visit)(
       tree,
       ["mdxJsxFlowElement", "mdxJsxTextElement"],
       (node, _, parent) => {
@@ -447,7 +471,14 @@ var import_zod = require("zod");
 var import_node_path = __toESM(require("path"), 1);
 function toImportPath(file, config) {
   const ext = import_node_path.default.extname(file);
-  const filename = ext === ".ts" ? file.substring(0, file.length - ext.length) : file;
+  let filename;
+  if (ext === ".ts" && config.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;
+  }
   let importPath;
   if ("relativeTo" in config) {
     importPath = import_node_path.default.relative(config.relativeTo, filename);
@@ -468,6 +499,29 @@ var fs2 = __toESM(require("fs/promises"), 1);
 var path4 = __toESM(require("path"), 1);
 var import_js_yaml2 = require("js-yaml");
 
+// src/utils/git-timestamp.ts
+var import_node_path2 = __toESM(require("path"), 1);
+var import_tinyexec = require("tinyexec");
+var cache2 = /* @__PURE__ */ new Map();
+async function getGitTimestamp(file) {
+  const cached = cache2.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)],
+      {
+        throwOnError: true
+      }
+    );
+    const time = new Date(out.stdout);
+    cache2.set(file, time);
+    return time;
+  } catch {
+    return;
+  }
+}
+
 // src/utils/collections.ts
 function getSupportedFormats(collection) {
   return {
@@ -481,17 +535,16 @@ function getGlobPatterns(collection) {
 }
 
 // src/vite/generate-glob.ts
-function generateGlob(name, collection) {
+function generateGlob(name, collection, globOptions) {
   const patterns = mapGlobPatterns(getGlobPatterns(collection));
   const options = {
+    ...globOptions,
     query: {
+      ...globOptions?.query,
       collection: name
     },
     base: getGlobBase(collection)
   };
-  if (collection.type === "meta") {
-    options.import = "default";
-  }
   return `import.meta.glob(${JSON.stringify(patterns)}, ${JSON.stringify(options, null, 2)})`;
 }
 function mapGlobPatterns(patterns) {
@@ -516,31 +569,38 @@ function getGlobBase(collection) {
   return dir;
 }
 
-// src/utils/git-timestamp.ts
-var import_node_path2 = __toESM(require("path"), 1);
-var import_tinyexec = require("tinyexec");
-var cache2 = /* @__PURE__ */ new Map();
-async function getGitTimestamp(file) {
-  const cached = cache2.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)],
-      {
-        throwOnError: true
-      }
-    );
-    const time = new Date(out.stdout);
-    cache2.set(file, time);
-    return time;
-  } catch {
-    return;
+// src/vite/generate.ts
+function docs(name, collection) {
+  const obj = [
+    ident(`doc: ${doc(name, collection.docs)}`),
+    ident(`meta: ${meta(name, collection.meta)}`)
+  ].join(",\n");
+  return `{
+${obj}
+}`;
+}
+function doc(name, collection) {
+  if (collection.async) {
+    return `create.docLazy("${name}", ${generateGlob(name, collection, {
+      query: {
+        only: "frontmatter"
+      },
+      import: "frontmatter"
+    })}, ${generateGlob(name, collection)})`;
   }
+  return `create.doc("${name}", ${generateGlob(name, collection)})`;
+}
+function meta(name, collection) {
+  return `create.meta("${name}", ${generateGlob(name, collection, {
+    import: "default"
+  })})`;
 }
 
 // src/vite/index.ts
-var onlySchema = import_zod.z.literal(["frontmatter", "all"]);
+var querySchema = import_zod.z.object({
+  only: import_zod.z.literal(["frontmatter", "all"]).default("all"),
+  collection: import_zod.z.string().optional()
+}).loose();
 function mdx(config, options = {}) {
   const { generateIndexFile = true, configPath = "source.config.ts" } = options;
   const loaded = buildConfig(config);
@@ -579,9 +639,8 @@ function mdx(config, options = {}) {
   async function transformContent(file, query, value) {
     const matter = fumaMatter(value);
     const isDevelopment = this.environment.mode === "dev";
-    const parsed = (0, import_node_querystring.parse)(query);
+    const parsed = querySchema.parse((0, import_node_querystring.parse)(query));
     const collection = parsed.collection ? loaded.collections.get(parsed.collection) : void 0;
-    const only = parsed.only ? onlySchema.parse(parsed.only) : "all";
     let schema;
     let mdxOptions;
     switch (collection?.type) {
@@ -605,7 +664,7 @@ function mdx(config, options = {}) {
         `invalid frontmatter in ${file}`
       );
     }
-    if (only === "frontmatter") {
+    if (parsed.only === "frontmatter") {
       return {
         code: `export const frontmatter = ${JSON.stringify(matter.data)}`,
         map: null
@@ -651,35 +710,23 @@ function mdx(config, options = {}) {
         '/// <reference types="vite/client" />',
         `import { fromConfig } from 'fumadocs-mdx/runtime/vite';`,
         `import type * as Config from '${toImportPath(configPath, {
-          relativeTo: outdir
+          relativeTo: outdir,
+          jsExtension: typeof generateIndexFile === "object" ? generateIndexFile.addJsExtension : void 0
         })}';`,
         "",
         `export const create = fromConfig<typeof Config>();`
       ];
-      function docs(name, collection) {
-        const args = [
-          ident(`doc: ${generateGlob(name, collection.docs)}`),
-          ident(`meta: ${generateGlob(name, collection.meta)}`)
-        ].join(",\n");
-        return `export const ${name} = create.docs("${name}", {
-${args}
-});`;
-      }
-      function doc(name, collection) {
-        return `export const ${name} = create.doc("${name}", ${generateGlob(name, collection)});`;
-      }
-      function meta(name, collection) {
-        return `export const ${name} = create.meta("${name}", ${generateGlob(name, collection)});`;
-      }
       for (const [name, collection] of loaded.collections.entries()) {
-        lines.push("");
+        let body;
         if (collection.type === "docs") {
-          lines.push(docs(name, collection));
+          body = docs(name, collection);
         } else if (collection.type === "meta") {
-          lines.push(meta(name, collection));
+          body = meta(name, collection);
         } else {
-          lines.push(doc(name, collection));
+          body = doc(name, collection);
         }
+        lines.push("");
+        lines.push(`export const ${name} = ${body};`);
       }
       await fs2.writeFile(path4.join(outdir, outFile), lines.join("\n"));
     },

package/dist/vite/index.d.cts

@@ -6,7 +6,12 @@ interface PluginOptions {
      *
      * @defaultValue true
      */
-    generateIndexFile?: boolean;
+    generateIndexFile?: boolean | {
+        /**
+         * add `.js` extensions to imports, needed for ESM without bundler resolution
+         */
+        addJsExtension?: boolean;
+    };
     /**
      * @defaultValue source.config.ts
      */

package/dist/vite/index.d.ts

@@ -6,7 +6,12 @@ interface PluginOptions {
      *
      * @defaultValue true
      */
-    generateIndexFile?: boolean;
+    generateIndexFile?: boolean | {
+        /**
+         * add `.js` extensions to imports, needed for ESM without bundler resolution
+         */
+        addJsExtension?: boolean;
+    };
     /**
      * @defaultValue source.config.ts
      */

package/dist/vite/index.js

@@ -1,26 +1,26 @@
 import {
   countLines
 } from "../chunk-UCY7OBZG.js";
-import {
-  buildMDX
-} from "../chunk-HWSF4OGZ.js";
-import "../chunk-3XN4P23K.js";
 import {
   getGlobPatterns,
   ident,
   toImportPath
-} from "../chunk-OWZSTKKX.js";
+} from "../chunk-6Y5JDZHD.js";
 import {
   ValidationError,
   getGitTimestamp,
   validate
 } from "../chunk-GX3THK2Q.js";
+import {
+  buildMDX
+} from "../chunk-7JFPDRW7.js";
+import "../chunk-IGXZS2W6.js";
 import {
   buildConfig
-} from "../chunk-XVL4ZQFK.js";
+} from "../chunk-S73DGUHI.js";
 import {
   fumaMatter
-} from "../chunk-KVWX6THC.js";
+} from "../chunk-VWJKRQZR.js";
 
 // src/vite/index.ts
 import { parse } from "querystring";
@@ -30,17 +30,16 @@ import * as path from "path";
 import { load } from "js-yaml";
 
 // src/vite/generate-glob.ts
-function generateGlob(name, collection) {
+function generateGlob(name, collection, globOptions) {
   const patterns = mapGlobPatterns(getGlobPatterns(collection));
   const options = {
+    ...globOptions,
     query: {
+      ...globOptions?.query,
       collection: name
     },
     base: getGlobBase(collection)
   };
-  if (collection.type === "meta") {
-    options.import = "default";
-  }
   return `import.meta.glob(${JSON.stringify(patterns)}, ${JSON.stringify(options, null, 2)})`;
 }
 function mapGlobPatterns(patterns) {
@@ -65,8 +64,38 @@ function getGlobBase(collection) {
   return dir;
 }
 
+// src/vite/generate.ts
+function docs(name, collection) {
+  const obj = [
+    ident(`doc: ${doc(name, collection.docs)}`),
+    ident(`meta: ${meta(name, collection.meta)}`)
+  ].join(",\n");
+  return `{
+${obj}
+}`;
+}
+function doc(name, collection) {
+  if (collection.async) {
+    return `create.docLazy("${name}", ${generateGlob(name, collection, {
+      query: {
+        only: "frontmatter"
+      },
+      import: "frontmatter"
+    })}, ${generateGlob(name, collection)})`;
+  }
+  return `create.doc("${name}", ${generateGlob(name, collection)})`;
+}
+function meta(name, collection) {
+  return `create.meta("${name}", ${generateGlob(name, collection, {
+    import: "default"
+  })})`;
+}
+
 // src/vite/index.ts
-var onlySchema = z.literal(["frontmatter", "all"]);
+var querySchema = z.object({
+  only: z.literal(["frontmatter", "all"]).default("all"),
+  collection: z.string().optional()
+}).loose();
 function mdx(config, options = {}) {
   const { generateIndexFile = true, configPath = "source.config.ts" } = options;
   const loaded = buildConfig(config);
@@ -105,9 +134,8 @@ function mdx(config, options = {}) {
   async function transformContent(file, query, value) {
     const matter = fumaMatter(value);
     const isDevelopment = this.environment.mode === "dev";
-    const parsed = parse(query);
+    const parsed = querySchema.parse(parse(query));
     const collection = parsed.collection ? loaded.collections.get(parsed.collection) : void 0;
-    const only = parsed.only ? onlySchema.parse(parsed.only) : "all";
     let schema;
     let mdxOptions;
     switch (collection?.type) {
@@ -131,7 +159,7 @@ function mdx(config, options = {}) {
         `invalid frontmatter in ${file}`
       );
     }
-    if (only === "frontmatter") {
+    if (parsed.only === "frontmatter") {
       return {
         code: `export const frontmatter = ${JSON.stringify(matter.data)}`,
         map: null
@@ -177,35 +205,23 @@ function mdx(config, options = {}) {
         '/// <reference types="vite/client" />',
         `import { fromConfig } from 'fumadocs-mdx/runtime/vite';`,
         `import type * as Config from '${toImportPath(configPath, {
-          relativeTo: outdir
+          relativeTo: outdir,
+          jsExtension: typeof generateIndexFile === "object" ? generateIndexFile.addJsExtension : void 0
         })}';`,
         "",
         `export const create = fromConfig<typeof Config>();`
       ];
-      function docs(name, collection) {
-        const args = [
-          ident(`doc: ${generateGlob(name, collection.docs)}`),
-          ident(`meta: ${generateGlob(name, collection.meta)}`)
-        ].join(",\n");
-        return `export const ${name} = create.docs("${name}", {
-${args}
-});`;
-      }
-      function doc(name, collection) {
-        return `export const ${name} = create.doc("${name}", ${generateGlob(name, collection)});`;
-      }
-      function meta(name, collection) {
-        return `export const ${name} = create.meta("${name}", ${generateGlob(name, collection)});`;
-      }
       for (const [name, collection] of loaded.collections.entries()) {
-        lines.push("");
+        let body;
         if (collection.type === "docs") {
-          lines.push(docs(name, collection));
+          body = docs(name, collection);
         } else if (collection.type === "meta") {
-          lines.push(meta(name, collection));
+          body = meta(name, collection);
         } else {
-          lines.push(doc(name, collection));
+          body = doc(name, collection);
         }
+        lines.push("");
+        lines.push(`export const ${name} = ${body};`);
       }
       await fs.writeFile(path.join(outdir, outFile), lines.join("\n"));
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-mdx",
-  "version": "11.7.5",
+  "version": "11.8.1",
   "description": "The built-in source for Fumadocs",
   "keywords": [
     "NextJs",
@@ -59,7 +59,7 @@
     "@mdx-js/mdx": "^3.1.0",
     "@standard-schema/spec": "^1.0.0",
     "chokidar": "^4.0.3",
-    "esbuild": "^0.25.8",
+    "esbuild": "^0.25.9",
     "estree-util-value-to-estree": "^3.4.0",
     "js-yaml": "^4.1.0",
     "lru-cache": "^11.1.0",
@@ -67,25 +67,25 @@
     "tinyexec": "^1.0.1",
     "tinyglobby": "^0.2.14",
     "unist-util-visit": "^5.0.0",
-    "zod": "^4.0.17"
+    "zod": "^4.1.0"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
     "@types/mdast": "^4.0.3",
     "@types/mdx": "^2.0.13",
-    "@types/node": "^24.2.1",
-    "@types/react": "^19.1.9",
+    "@types/node": "^24.3.0",
+    "@types/react": "^19.1.11",
     "mdast-util-mdx-jsx": "^3.2.0",
-    "next": "^15.4.6",
+    "next": "^15.5.0",
     "react": "^19.1.1",
-    "rollup": "^4.46.2",
+    "rollup": "^4.48.0",
     "unified": "^11.0.5",
     "vfile": "^6.0.3",
-    "vite": "^7.1.1",
-    "webpack": "^5.101.0",
-    "fumadocs-core": "15.6.10",
-    "eslint-config-custom": "0.0.0",
+    "vite": "^7.1.3",
+    "webpack": "^5.101.3",
     "@fumadocs/mdx-remote": "1.4.0",
+    "eslint-config-custom": "0.0.0",
+    "fumadocs-core": "15.7.3",
     "tsconfig": "0.0.0"
   },
   "peerDependencies": {