fumadocs-mdx 11.10.0 → 12.0.0

package/dist/bin.d.cts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/bin.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/bin.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+
+// src/bin.ts
+import { existsSync } from "fs";
+async function start() {
+  const args = process.argv.slice(2);
+  const isNext = existsSync("next.config.js") || existsSync("next.config.mjs") || existsSync("next.config.ts");
+  if (isNext) {
+    const { postInstall } = await import("./next/index.js");
+    await postInstall(...args);
+  } else {
+    const { postInstall } = await import("./postinstall-U7VROOY7.js");
+    await postInstall(...args);
+  }
+}
+void start();

package/dist/{browser-B2G8uAF2.d.cts → browser-D5lvL8vv.d.ts}

@@ -1,8 +1,55 @@
-import { C as CompiledMDXProperties } from './build-mdx-DnC1jKvn.cjs';
-import { ReactNode, FC } from 'react';
-import { a as DocCollection, b as DocsCollection, M as MetaCollection } from './define-BH4bnHQl.cjs';
+import { createProcessor } from '@mdx-js/mdx';
+import { StructuredData } from 'fumadocs-core/mdx-plugins';
+import { TableOfContents } from 'fumadocs-core/server';
+import { FC, ReactNode } from 'react';
+import { MDXProps } from 'mdx/types';
+import { E as ExtractedReference, a as DocCollection, b as DocsCollection, M as MetaCollection } from './define--6HQ1ehX.js';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 
+type Processor = ReturnType<typeof createProcessor>;
+interface CompilerOptions {
+    addDependency: (file: string) => void;
+}
+interface CompiledMDXProperties<Frontmatter = Record<string, unknown>> {
+    frontmatter: Frontmatter;
+    structuredData: StructuredData;
+    toc: TableOfContents;
+    default: FC<MDXProps>;
+    /**
+     * Only available when `lastModifiedTime` is enabled on MDX loader
+     */
+    lastModified?: Date;
+    extractedReferences?: ExtractedReference[];
+    _markdown?: string;
+}
+interface FumadocsDataMap {
+    /**
+     * [Fumadocs MDX] raw frontmatter, you can modify it
+     */
+    frontmatter?: Record<string, unknown>;
+    /**
+     * [Fumadocs MDX] additional ESM exports to write
+     */
+    'mdx-export'?: {
+        name: string;
+        value: unknown;
+    }[];
+    extractedReferences: ExtractedReference[];
+    /**
+     * [Fumadocs MDX] The compiler object from loader
+     */
+    _compiler?: CompilerOptions;
+    _getProcessor?: (format: 'md' | 'mdx') => Processor;
+    /**
+     * [Fumadocs MDX] Processed Markdown content before `remark-rehype`.
+     */
+    _markdown?: string;
+}
+declare module 'vfile' {
+    interface DataMap extends FumadocsDataMap {
+    }
+}
+
 type CompiledMDXFile<Frontmatter> = CompiledMDXProperties<Frontmatter> & Record<string, unknown>;
 type DocMap<Frontmatter> = Record<string, (() => Promise<CompiledMDXFile<Frontmatter>>) & {
     base: string;
@@ -48,4 +95,4 @@ interface ClientLoader<Frontmatter, Props> {
 declare function createClientLoader<Frontmatter, Props = object>(files: Record<string, () => Promise<CompiledMDXFile<Frontmatter>>>, options: ClientLoaderOptions<Frontmatter, Props>): ClientLoader<Frontmatter, Props>;
 declare function toClientRenderer<Frontmatter, Props = object>(files: Record<string, () => Promise<CompiledMDXFile<Frontmatter>>>, component: (loaded: CompiledMDXFile<Frontmatter>, props: Props) => ReactNode): ClientRenderer<Props>;
 
-export { type BaseCreate as B, type CompiledMDXFile as C, type DocMap as D, type LazyDocMap as L, type MetaMap as M, type ClientLoader as a, type ClientLoaderOptions as b, createClientLoader as c, fromConfigBase as f, toClientRenderer as t };
+export { type BaseCreate as B, type ClientLoader as C, type DocMap as D, type LazyDocMap as L, type MetaMap as M, type ClientLoaderOptions as a, type CompiledMDXFile as b, createClientLoader as c, fromConfigBase as f, toClientRenderer as t };

package/dist/{browser-DrH7tKRi.d.ts → browser-DjWADqp8.d.cts}

@@ -1,8 +1,55 @@
-import { C as CompiledMDXProperties } from './build-mdx-DnC1jKvn.js';
-import { ReactNode, FC } from 'react';
-import { a as DocCollection, b as DocsCollection, M as MetaCollection } from './define-BH4bnHQl.js';
+import { createProcessor } from '@mdx-js/mdx';
+import { StructuredData } from 'fumadocs-core/mdx-plugins';
+import { TableOfContents } from 'fumadocs-core/server';
+import { FC, ReactNode } from 'react';
+import { MDXProps } from 'mdx/types';
+import { E as ExtractedReference, a as DocCollection, b as DocsCollection, M as MetaCollection } from './define--6HQ1ehX.cjs';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 
+type Processor = ReturnType<typeof createProcessor>;
+interface CompilerOptions {
+    addDependency: (file: string) => void;
+}
+interface CompiledMDXProperties<Frontmatter = Record<string, unknown>> {
+    frontmatter: Frontmatter;
+    structuredData: StructuredData;
+    toc: TableOfContents;
+    default: FC<MDXProps>;
+    /**
+     * Only available when `lastModifiedTime` is enabled on MDX loader
+     */
+    lastModified?: Date;
+    extractedReferences?: ExtractedReference[];
+    _markdown?: string;
+}
+interface FumadocsDataMap {
+    /**
+     * [Fumadocs MDX] raw frontmatter, you can modify it
+     */
+    frontmatter?: Record<string, unknown>;
+    /**
+     * [Fumadocs MDX] additional ESM exports to write
+     */
+    'mdx-export'?: {
+        name: string;
+        value: unknown;
+    }[];
+    extractedReferences: ExtractedReference[];
+    /**
+     * [Fumadocs MDX] The compiler object from loader
+     */
+    _compiler?: CompilerOptions;
+    _getProcessor?: (format: 'md' | 'mdx') => Processor;
+    /**
+     * [Fumadocs MDX] Processed Markdown content before `remark-rehype`.
+     */
+    _markdown?: string;
+}
+declare module 'vfile' {
+    interface DataMap extends FumadocsDataMap {
+    }
+}
+
 type CompiledMDXFile<Frontmatter> = CompiledMDXProperties<Frontmatter> & Record<string, unknown>;
 type DocMap<Frontmatter> = Record<string, (() => Promise<CompiledMDXFile<Frontmatter>>) & {
     base: string;
@@ -48,4 +95,4 @@ interface ClientLoader<Frontmatter, Props> {
 declare function createClientLoader<Frontmatter, Props = object>(files: Record<string, () => Promise<CompiledMDXFile<Frontmatter>>>, options: ClientLoaderOptions<Frontmatter, Props>): ClientLoader<Frontmatter, Props>;
 declare function toClientRenderer<Frontmatter, Props = object>(files: Record<string, () => Promise<CompiledMDXFile<Frontmatter>>>, component: (loaded: CompiledMDXFile<Frontmatter>, props: Props) => ReactNode): ClientRenderer<Props>;
 
-export { type BaseCreate as B, type CompiledMDXFile as C, type DocMap as D, type LazyDocMap as L, type MetaMap as M, type ClientLoader as a, type ClientLoaderOptions as b, createClientLoader as c, fromConfigBase as f, toClientRenderer as t };
+export { type BaseCreate as B, type ClientLoader as C, type DocMap as D, type LazyDocMap as L, type MetaMap as M, type ClientLoaderOptions as a, type CompiledMDXFile as b, createClientLoader as c, fromConfigBase as f, toClientRenderer as t };

package/dist/bun/index.cjs

@@ -30,86 +30,9 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/mdx-plugins/remark-postprocess.ts
-function remarkPostprocess({
-  injectExports
-}) {
-  return (tree, file) => {
-    let title;
-    const urls = [];
-    (0, import_unist_util_visit2.visit)(tree, ["heading", "link"], (node) => {
-      if (node.type === "heading" && node.depth === 1) {
-        title = flattenNode2(node);
-      }
-      if (node.type !== "link") return;
-      urls.push({
-        href: node.url
-      });
-      return "skip";
-    });
-    if (title) {
-      file.data.frontmatter ??= {};
-      if (!file.data.frontmatter.title) file.data.frontmatter.title = title;
-    }
-    file.data.extractedReferences = urls;
-    for (const name of injectExports) {
-      if (!(name in file.data)) continue;
-      tree.children.unshift(getMdastExport(name, file.data[name]));
-    }
-  };
-}
-function flattenNode2(node) {
-  if ("children" in node)
-    return node.children.map((child) => flattenNode2(child)).join("");
-  if ("value" in node) return node.value;
-  return "";
-}
-function getMdastExport(name, value) {
-  return {
-    type: "mdxjsEsm",
-    value: "",
-    data: {
-      estree: {
-        type: "Program",
-        sourceType: "module",
-        body: [
-          {
-            type: "ExportNamedDeclaration",
-            attributes: [],
-            specifiers: [],
-            source: null,
-            declaration: {
-              type: "VariableDeclaration",
-              kind: "let",
-              declarations: [
-                {
-                  type: "VariableDeclarator",
-                  id: {
-                    type: "Identifier",
-                    name
-                  },
-                  init: (0, import_estree_util_value_to_estree.valueToEstree)(value)
-                }
-              ]
-            }
-          }
-        ]
-      }
-    }
-  };
-}
-var import_unist_util_visit2, import_estree_util_value_to_estree;
-var init_remark_postprocess = __esm({
-  "src/mdx-plugins/remark-postprocess.ts"() {
-    "use strict";
-    import_unist_util_visit2 = require("unist-util-visit");
-    import_estree_util_value_to_estree = require("estree-util-value-to-estree");
-  }
-});
-
-// src/utils/mdx-options.ts
-var mdx_options_exports = {};
-__export(mdx_options_exports, {
+// src/mdx/preset.ts
+var preset_exports = {};
+__export(preset_exports, {
   getDefaultMDXOptions: () => getDefaultMDXOptions
 });
 function pluginOption(def, options = []) {
@@ -132,13 +55,6 @@ function getDefaultMDXOptions({
   _withoutBundler = false,
   ...mdxOptions
 }) {
-  const mdxExports = [
-    "structuredData",
-    "extractedReferences",
-    "frontmatter",
-    "lastModified",
-    ...valueToExport
-  ];
   const remarkPlugins = pluginOption(
     (v) => [
       plugins.remarkGfm,
@@ -166,10 +82,15 @@ function getDefaultMDXOptions({
         plugins.remarkStructure,
         remarkStructureOptions
       ],
-      [
-        remarkPostprocess,
-        { injectExports: mdxExports }
-      ]
+      () => {
+        return (_, file) => {
+          file.data["mdx-export"] ??= [];
+          for (const name of valueToExport) {
+            if (name in file.data)
+              file.data["mdx-export"].push({ name, value: file.data[name] });
+          }
+        };
+      }
     ],
     mdxOptions.remarkPlugins
   );
@@ -189,11 +110,10 @@ function getDefaultMDXOptions({
   };
 }
 var plugins;
-var init_mdx_options = __esm({
-  "src/utils/mdx-options.ts"() {
+var init_preset = __esm({
+  "src/mdx/preset.ts"() {
     "use strict";
     plugins = __toESM(require("fumadocs-core/mdx-plugins"), 1);
-    init_remark_postprocess();
   }
 });
 
@@ -290,10 +210,10 @@ function countLines(s) {
   return num;
 }
 
-// src/utils/build-mdx.ts
+// src/mdx/build-mdx.ts
 var import_mdx = require("@mdx-js/mdx");
 
-// src/mdx-plugins/remark-include.ts
+// src/mdx/remark-include.ts
 var import_unified = require("unified");
 var import_unist_util_visit = require("unist-util-visit");
 var path2 = __toESM(require("path"), 1);
@@ -425,7 +345,90 @@ function getDefaultProcessor(format) {
   return mdProcessor.use(import_remark_mdx.default);
 }
 
-// src/utils/build-mdx.ts
+// src/mdx/remark-postprocess.ts
+var import_unist_util_visit2 = require("unist-util-visit");
+var import_mdast_util_to_markdown = require("mdast-util-to-markdown");
+var import_estree_util_value_to_estree = require("estree-util-value-to-estree");
+function remarkPostprocess({
+  includeProcessedMarkdown = false,
+  valueToExport = []
+} = {}) {
+  return (tree, file) => {
+    let title;
+    const urls = [];
+    (0, import_unist_util_visit2.visit)(tree, ["heading", "link"], (node) => {
+      if (node.type === "heading" && node.depth === 1) {
+        title = flattenNode2(node);
+      }
+      if (node.type !== "link") return;
+      urls.push({
+        href: node.url
+      });
+      return "skip";
+    });
+    if (title) {
+      file.data.frontmatter ??= {};
+      if (!file.data.frontmatter.title) file.data.frontmatter.title = title;
+    }
+    file.data.extractedReferences = urls;
+    if (includeProcessedMarkdown) {
+      file.data._markdown = (0, import_mdast_util_to_markdown.toMarkdown)(tree, {
+        ...this.data("settings"),
+        // @ts-expect-error - from https://github.com/remarkjs/remark/blob/main/packages/remark-stringify/lib/index.js
+        extensions: this.data("toMarkdownExtensions") || []
+      });
+    }
+    for (const { name, value } of file.data["mdx-export"] ?? []) {
+      tree.children.unshift(getMdastExport(name, value));
+    }
+    for (const name of valueToExport) {
+      if (!(name in file.data)) continue;
+      tree.children.unshift(getMdastExport(name, file.data[name]));
+    }
+  };
+}
+function getMdastExport(name, value) {
+  return {
+    type: "mdxjsEsm",
+    value: "",
+    data: {
+      estree: {
+        type: "Program",
+        sourceType: "module",
+        body: [
+          {
+            type: "ExportNamedDeclaration",
+            attributes: [],
+            specifiers: [],
+            source: null,
+            declaration: {
+              type: "VariableDeclaration",
+              kind: "let",
+              declarations: [
+                {
+                  type: "VariableDeclarator",
+                  id: {
+                    type: "Identifier",
+                    name
+                  },
+                  init: (0, import_estree_util_value_to_estree.valueToEstree)(value)
+                }
+              ]
+            }
+          }
+        ]
+      }
+    }
+  };
+}
+function flattenNode2(node) {
+  if ("children" in node)
+    return node.children.map((child) => flattenNode2(child)).join("");
+  if ("value" in node) return node.value;
+  return "";
+}
+
+// src/mdx/build-mdx.ts
 var cache2 = /* @__PURE__ */ new Map();
 async function buildMDX(cacheKey, source, options) {
   const { filePath, frontmatter, data, _compiler, ...rest } = options;
@@ -436,7 +439,24 @@ async function buildMDX(cacheKey, source, options) {
       processor = (0, import_mdx.createProcessor)({
         outputFormat: "program",
         ...rest,
-        remarkPlugins: [remarkInclude, ...rest.remarkPlugins ?? []],
+        remarkPlugins: [
+          remarkInclude,
+          ...rest.remarkPlugins ?? [],
+          [
+            remarkPostprocess,
+            {
+              ...options.postprocess,
+              valueToExport: [
+                ...options.postprocess?.valueToExport ?? [],
+                "structuredData",
+                "extractedReferences",
+                "frontmatter",
+                "lastModified",
+                "_markdown"
+              ]
+            }
+          ]
+        ],
         format
       });
       cache2.set(key, processor);
@@ -492,21 +512,18 @@ function createMdxLoader(configLoader) {
       if (cached && cached.hash === generateCacheHash(value)) return cached;
     }
     const collection = parsed.collection ? loaded.collections.get(parsed.collection) : void 0;
-    let schema;
-    let mdxOptions;
+    let docCollection;
     switch (collection?.type) {
       case "doc":
-        mdxOptions = collection.mdxOptions;
-        schema = collection.schema;
+        docCollection = collection;
         break;
       case "docs":
-        mdxOptions = collection.docs.mdxOptions;
-        schema = collection.docs.schema;
+        docCollection = collection.docs;
         break;
     }
-    if (schema) {
+    if (docCollection?.schema) {
       matter.data = await validate(
-        schema,
+        docCollection.schema,
         matter.data,
         {
           source: value,
@@ -531,7 +548,8 @@ function createMdxLoader(configLoader) {
       "\n".repeat(lineOffset) + matter.content,
       {
         development: isDevelopment,
-        ...mdxOptions ?? await loaded.getDefaultMDXOptions(),
+        ...docCollection?.mdxOptions ?? await loaded.getDefaultMDXOptions(),
+        postprocess: docCollection?.postprocess,
         data,
         filePath,
         frontmatter: matter.data,
@@ -600,7 +618,7 @@ function buildConfig(config) {
       const input = this.global.mdxOptions;
       async function uncached() {
         const options = typeof input === "function" ? await input() : input;
-        const { getDefaultMDXOptions: getDefaultMDXOptions2 } = await Promise.resolve().then(() => (init_mdx_options(), mdx_options_exports));
+        const { getDefaultMDXOptions: getDefaultMDXOptions2 } = await Promise.resolve().then(() => (init_preset(), preset_exports));
         if (options?.preset === "minimal") return options;
         return getDefaultMDXOptions2({
           ...options,
@@ -630,10 +648,12 @@ function resolvedConfig(loaded) {
 
 // src/bun/index.ts
 var import_node_querystring = require("querystring");
+var import_node_url2 = require("url");
 function createMdxPlugin(options = {}) {
   const { configPath = findConfigFile() } = options;
   async function getMdxLoader() {
-    const out = buildConfig(await import(configPath));
+    const importPath = (0, import_node_url2.pathToFileURL)(configPath).href;
+    const out = buildConfig(await import(importPath));
     return createMdxLoader(resolvedConfig(out));
   }
   return {

package/dist/bun/index.js

@@ -1,23 +1,26 @@
 import {
   createMdxLoader,
   resolvedConfig
-} from "../chunk-5XJM5RPV.js";
+} from "../chunk-KGUBBRL6.js";
+import "../chunk-IQAEAI4P.js";
 import {
   findConfigFile
-} from "../chunk-2HKRTQYP.js";
-import "../chunk-QQWCBFFE.js";
-import "../chunk-SVTXMVLQ.js";
+} from "../chunk-POXTQZ4D.js";
+import "../chunk-SWNOXPYJ.js";
+import "../chunk-KTDVTBMH.js";
 import {
   buildConfig
-} from "../chunk-QVZ7JH4H.js";
+} from "../chunk-YC25YEBF.js";
 import "../chunk-VWJKRQZR.js";
 
 // src/bun/index.ts
 import { parse } from "querystring";
+import { pathToFileURL } from "url";
 function createMdxPlugin(options = {}) {
   const { configPath = findConfigFile() } = options;
   async function getMdxLoader() {
-    const out = buildConfig(await import(configPath));
+    const importPath = pathToFileURL(configPath).href;
+    const out = buildConfig(await import(importPath));
     return createMdxLoader(resolvedConfig(out));
   }
   return {

package/dist/chunk-3M4SHY6K.js

@@ -0,0 +1,80 @@
+// src/mdx/preset.ts
+import * as plugins from "fumadocs-core/mdx-plugins";
+function pluginOption(def, options = []) {
+  const list = def(Array.isArray(options) ? options : []).filter(
+    Boolean
+  );
+  if (typeof options === "function") {
+    return options(list);
+  }
+  return list;
+}
+function getDefaultMDXOptions({
+  valueToExport = [],
+  rehypeCodeOptions,
+  remarkImageOptions,
+  remarkHeadingOptions,
+  remarkStructureOptions,
+  remarkCodeTabOptions,
+  remarkNpmOptions,
+  _withoutBundler = false,
+  ...mdxOptions
+}) {
+  const remarkPlugins = pluginOption(
+    (v) => [
+      plugins.remarkGfm,
+      [
+        plugins.remarkHeading,
+        {
+          generateToc: false,
+          ...remarkHeadingOptions
+        }
+      ],
+      remarkImageOptions !== false && [
+        plugins.remarkImage,
+        {
+          ...remarkImageOptions,
+          useImport: _withoutBundler ? false : remarkImageOptions?.useImport
+        }
+      ],
+      "remarkCodeTab" in plugins && remarkCodeTabOptions !== false && [
+        plugins.remarkCodeTab,
+        remarkCodeTabOptions
+      ],
+      "remarkNpm" in plugins && remarkNpmOptions !== false && [plugins.remarkNpm, remarkNpmOptions],
+      ...v,
+      remarkStructureOptions !== false && [
+        plugins.remarkStructure,
+        remarkStructureOptions
+      ],
+      () => {
+        return (_, file) => {
+          file.data["mdx-export"] ??= [];
+          for (const name of valueToExport) {
+            if (name in file.data)
+              file.data["mdx-export"].push({ name, value: file.data[name] });
+          }
+        };
+      }
+    ],
+    mdxOptions.remarkPlugins
+  );
+  const rehypePlugins = pluginOption(
+    (v) => [
+      rehypeCodeOptions !== false && [plugins.rehypeCode, rehypeCodeOptions],
+      ...v,
+      plugins.rehypeToc
+    ],
+    mdxOptions.rehypePlugins
+  );
+  return {
+    ...mdxOptions,
+    outputFormat: _withoutBundler ? "function-body" : mdxOptions.outputFormat,
+    remarkPlugins,
+    rehypePlugins
+  };
+}
+
+export {
+  getDefaultMDXOptions
+};

package/dist/chunk-6Y5JDZHD.js

@@ -0,0 +1,65 @@
+// src/utils/import-formatter.ts
+import path from "path";
+function getImportCode(info) {
+  const specifier = JSON.stringify(info.specifier);
+  if (info.type === "default") return `import ${info.name} from ${specifier}`;
+  if (info.type === "namespace")
+    return `import * as ${info.name} from ${specifier}`;
+  if (info.type === "named") {
+    const names = info.names.map(
+      (name) => Array.isArray(name) ? `${name[0]} as ${name[1]}` : name
+    );
+    return `import { ${names.join(", ")} } from ${specifier}`;
+  }
+  return `import ${specifier}`;
+}
+function toImportPath(file, config) {
+  const ext = path.extname(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 = path.relative(config.relativeTo, filename);
+    if (!path.isAbsolute(importPath) && !importPath.startsWith(".")) {
+      importPath = `./${importPath}`;
+    }
+  } else {
+    importPath = path.resolve(filename);
+  }
+  return importPath.replaceAll(path.sep, "/");
+}
+function ident(code, tab = 1) {
+  return code.split("\n").map((v) => "  ".repeat(tab) + v).join("\n");
+}
+
+// src/utils/collections.ts
+function getSupportedFormats(collection) {
+  return {
+    doc: ["mdx", "md"],
+    meta: ["json", "yaml"]
+  }[collection.type];
+}
+function getGlobPatterns(collection) {
+  if (collection.files) return collection.files;
+  return [`**/*.{${getSupportedFormats(collection).join(",")}}`];
+}
+function isFileSupported(filePath, collection) {
+  for (const format of getSupportedFormats(collection)) {
+    if (filePath.endsWith(`.${format}`)) return true;
+  }
+  return false;
+}
+
+export {
+  getImportCode,
+  toImportPath,
+  ident,
+  getGlobPatterns,
+  isFileSupported
+};