fumadocs-mdx 12.0.2 → 13.0.0

package/dist/bin.js

@@ -3,14 +3,14 @@
 // src/bin.ts
 import { existsSync } from "fs";
 async function start() {
-  const args = process.argv.slice(2);
+  const [configPath] = 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);
+    await postInstall(configPath);
   } else {
-    const { postInstall } = await import("./postinstall-SCSXM4IM.js");
-    await postInstall(...args);
+    const { postInstall } = await import("./vite/index.js");
+    await postInstall(configPath);
   }
 }
 void start();

package/dist/build-mdx-BHG-_uxo.d.cts

@@ -0,0 +1,53 @@
+import { createProcessor } from '@mdx-js/mdx';
+import { StructuredData } from 'fumadocs-core/mdx-plugins';
+import { TOCItemType } from 'fumadocs-core/toc';
+import { FC } from 'react';
+import { MDXProps } from 'mdx/types';
+import { E as ExtractedReference } from './remark-postprocess-K233ZVBK.cjs';
+
+type Processor = ReturnType<typeof createProcessor>;
+interface CompilerOptions {
+    addDependency: (file: string) => void;
+}
+interface CompiledMDXProperties<Frontmatter = Record<string, unknown>> {
+    frontmatter: Frontmatter;
+    structuredData: StructuredData;
+    toc: TOCItemType[];
+    default: FC<MDXProps>;
+    /**
+     * Only available when `lastModifiedTime` is enabled on MDX loader
+     */
+    lastModified?: Date;
+    extractedReferences?: ExtractedReference[];
+    _markdown?: string;
+    _mdast?: 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 {
+    }
+}
+
+export type { CompiledMDXProperties as C };

package/dist/build-mdx-CzrQDBRZ.d.ts

@@ -0,0 +1,53 @@
+import { createProcessor } from '@mdx-js/mdx';
+import { StructuredData } from 'fumadocs-core/mdx-plugins';
+import { TOCItemType } from 'fumadocs-core/toc';
+import { FC } from 'react';
+import { MDXProps } from 'mdx/types';
+import { E as ExtractedReference } from './remark-postprocess-K233ZVBK.js';
+
+type Processor = ReturnType<typeof createProcessor>;
+interface CompilerOptions {
+    addDependency: (file: string) => void;
+}
+interface CompiledMDXProperties<Frontmatter = Record<string, unknown>> {
+    frontmatter: Frontmatter;
+    structuredData: StructuredData;
+    toc: TOCItemType[];
+    default: FC<MDXProps>;
+    /**
+     * Only available when `lastModifiedTime` is enabled on MDX loader
+     */
+    lastModified?: Date;
+    extractedReferences?: ExtractedReference[];
+    _markdown?: string;
+    _mdast?: 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 {
+    }
+}
+
+export type { CompiledMDXProperties as C };

package/dist/bun/index.cjs

@@ -261,12 +261,56 @@ var import_mdx = require("@mdx-js/mdx");
 
 // src/loaders/mdx/remark-include.ts
 var import_unified = require("unified");
-var import_unist_util_visit = require("unist-util-visit");
+var import_unist_util_visit2 = require("unist-util-visit");
 var path2 = __toESM(require("path"), 1);
 var fs = __toESM(require("fs/promises"), 1);
-var import_remark_parse = __toESM(require("remark-parse"), 1);
-var import_remark_mdx = __toESM(require("remark-mdx"), 1);
 var import_mdx_plugins = require("fumadocs-core/mdx-plugins");
+
+// src/loaders/mdx/remark-unravel.ts
+var import_unist_util_visit = require("unist-util-visit");
+function remarkMarkAndUnravel() {
+  return (tree) => {
+    (0, import_unist_util_visit.visit)(tree, function(node, index, parent) {
+      let offset = -1;
+      let all = true;
+      let oneOrMore = false;
+      if (parent && typeof index === "number" && node.type === "paragraph") {
+        const children = node.children;
+        while (++offset < children.length) {
+          const child = children[offset];
+          if (child.type === "mdxJsxTextElement" || child.type === "mdxTextExpression") {
+            oneOrMore = true;
+          } else if (child.type === "text" && child.value.trim().length === 0) {
+          } else {
+            all = false;
+            break;
+          }
+        }
+        if (all && oneOrMore) {
+          offset = -1;
+          const newChildren = [];
+          while (++offset < children.length) {
+            const child = children[offset];
+            if (child.type === "mdxJsxTextElement") {
+              child.type = "mdxJsxFlowElement";
+            }
+            if (child.type === "mdxTextExpression") {
+              child.type = "mdxFlowExpression";
+            }
+            if (child.type === "text" && /^[\t\r\n ]+$/.test(String(child.value))) {
+            } else {
+              newChildren.push(child);
+            }
+          }
+          parent.children.splice(index, 1, ...newChildren);
+          return index;
+        }
+      }
+    });
+  };
+}
+
+// src/loaders/mdx/remark-include.ts
 var ElementLikeTypes = [
   "mdxJsxFlowElement",
   "mdxJsxTextElement",
@@ -306,7 +350,7 @@ function parseSpecifier(specifier) {
 function extractSection(root, section) {
   let nodes;
   let capturingHeadingContent = false;
-  (0, import_unist_util_visit.visit)(root, (node) => {
+  (0, import_unist_util_visit2.visit)(root, (node) => {
     if (node.type === "heading") {
       if (capturingHeadingContent) {
         return false;
@@ -338,7 +382,7 @@ function extractSection(root, section) {
 }
 function remarkInclude() {
   const TagName = "include";
-  async function embedContent(file, heading, params, data) {
+  const embedContent = async (file, heading, params, data) => {
     let content;
     try {
       content = (await fs.readFile(file)).toString();
@@ -361,18 +405,17 @@ ${e instanceof Error ? e.message : String(e)}`,
         data: {}
       };
     }
-    const parser = (data._getProcessor ?? getDefaultProcessor)(
-      ext === ".mdx" ? "mdx" : "md"
-    );
+    const parser = data._getProcessor ? data._getProcessor(ext === ".mdx" ? "mdx" : "md") : this;
     const parsed = fumaMatter(content);
     let mdast = parser.parse({
       path: file,
       value: parsed.content,
       data: { frontmatter: parsed.data }
     });
+    const baseProcessor = (0, import_unified.unified)().use(remarkMarkAndUnravel);
     if (heading) {
       const extracted = extractSection(
-        await (0, import_unified.unified)().use(import_mdx_plugins.remarkHeading).run(mdast),
+        await baseProcessor.use(import_mdx_plugins.remarkHeading).run(mdast),
         heading
       );
       if (!extracted)
@@ -380,13 +423,15 @@ ${e instanceof Error ? e.message : String(e)}`,
           `Cannot find section ${heading} in ${file}, make sure you have encapsulated the section in a <section id="${heading}"> tag, or a :::section directive with remark-directive configured.`
         );
       mdast = extracted;
+    } else {
+      mdast = await baseProcessor.run(mdast);
     }
     await update(mdast, path2.dirname(file), data);
     return mdast;
-  }
+  };
   async function update(tree, directory, data) {
     const queue = [];
-    (0, import_unist_util_visit.visit)(tree, ElementLikeTypes, (_node, _, parent) => {
+    (0, import_unist_util_visit2.visit)(tree, ElementLikeTypes, (_node, _, parent) => {
       const node = _node;
       if (node.name !== TagName) return;
       const specifier = flattenNode(node);
@@ -413,24 +458,28 @@ ${e instanceof Error ? e.message : String(e)}`,
     await update(tree, path2.dirname(file.path), file.data);
   };
 }
-function getDefaultProcessor(format) {
-  const mdProcessor = (0, import_unified.unified)().use(import_remark_parse.default);
-  if (format === "md") return mdProcessor;
-  return mdProcessor.use(import_remark_mdx.default);
-}
 
 // src/loaders/mdx/remark-postprocess.ts
-var import_unist_util_visit2 = require("unist-util-visit");
+var import_unist_util_visit3 = 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");
+var import_unist_util_remove_position = require("unist-util-remove-position");
+var import_remark_mdx = __toESM(require("remark-mdx"), 1);
 function remarkPostprocess({
+  _format,
   includeProcessedMarkdown = false,
+  includeMDAST = false,
   valueToExport = []
-} = {}) {
+}) {
+  let _stringifyProcessor;
+  const getStringifyProcessor = () => {
+    if (_format === "mdx") return this;
+    return _stringifyProcessor ??= this().use(import_remark_mdx.default).freeze();
+  };
   return (tree, file) => {
     let title;
     const urls = [];
-    (0, import_unist_util_visit2.visit)(tree, ["heading", "link"], (node) => {
+    (0, import_unist_util_visit3.visit)(tree, ["heading", "link"], (node) => {
       if (node.type === "heading" && node.depth === 1) {
         title = flattenNode2(node);
       }
@@ -446,12 +495,19 @@ function remarkPostprocess({
     }
     file.data.extractedReferences = urls;
     if (includeProcessedMarkdown) {
+      const processor = getStringifyProcessor();
       file.data._markdown = (0, import_mdast_util_to_markdown.toMarkdown)(tree, {
-        ...this.data("settings"),
+        ...processor.data("settings"),
         // from https://github.com/remarkjs/remark/blob/main/packages/remark-stringify/lib/index.js
-        extensions: this.data("toMarkdownExtensions") || []
+        extensions: processor.data("toMarkdownExtensions") || []
       });
     }
+    if (includeMDAST) {
+      const options = includeMDAST === true ? {} : includeMDAST;
+      file.data._mdast = JSON.stringify(
+        options.removePosition ? (0, import_unist_util_remove_position.removePosition)(structuredClone(tree)) : tree
+      );
+    }
     for (const { name, value } of file.data["mdx-export"] ?? []) {
       tree.children.unshift(getMdastExport(name, value));
     }
@@ -519,6 +575,7 @@ async function buildMDX(cacheKey, source, options) {
           [
             remarkPostprocess,
             {
+              _format: format,
               ...options.postprocess,
               valueToExport: [
                 ...options.postprocess?.valueToExport ?? [],
@@ -526,7 +583,8 @@ async function buildMDX(cacheKey, source, options) {
                 "extractedReferences",
                 "frontmatter",
                 "lastModified",
-                "_markdown"
+                "_markdown",
+                "_mdast"
               ]
             }
           ]
@@ -558,16 +616,21 @@ var import_node_path2 = __toESM(require("path"), 1);
 var import_node_crypto = require("crypto");
 var querySchema = import_zod.z.object({
   only: import_zod.z.literal(["frontmatter", "all"]).default("all"),
-  collection: import_zod.z.string().optional(),
-  hash: import_zod.z.string().describe(
-    "the hash of config, used for revalidation on Turbopack/Webpack."
-  ).optional()
+  collection: import_zod.z.string().optional()
 }).loose();
 var cacheEntry = import_zod.z.object({
   code: import_zod.z.string(),
   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,
@@ -578,7 +641,7 @@ function createMdxLoader(configLoader) {
   }) => {
     const matter = fumaMatter(value);
     const parsed = querySchema.parse(query);
-    const loaded = await configLoader.getConfig(parsed.hash);
+    const loaded = await configLoader.getConfig();
     const cacheDir = isDevelopment ? void 0 : loaded.global.experimentalBuildCache;
     const cacheKey = `${parsed.hash}_${parsed.collection ?? "global"}_${generateCacheHash(filePath)}`;
     if (cacheDir) {
@@ -618,7 +681,7 @@ function createMdxLoader(configLoader) {
     }
     const lineOffset = isDevelopment ? countLines(matter.matter) : 0;
     const compiled = await buildMDX(
-      `${parsed.hash ?? ""}:${parsed.collection ?? "global"}`,
+      `${getConfigHash(loaded)}:${parsed.collection ?? "global"}`,
       "\n".repeat(lineOffset) + matter.content,
       {
         development: isDevelopment,
@@ -660,6 +723,7 @@ function countLines(s) {
 
 // src/loaders/config/index.ts
 var import_node_path3 = __toESM(require("path"), 1);
+var import_promises2 = __toESM(require("fs/promises"), 1);
 function findConfigFile() {
   return import_node_path3.default.resolve("source.config.ts");
 }

package/dist/bun/index.js

@@ -1,16 +1,15 @@
+import {
+  createMdxLoader
+} from "../chunk-CEA6MYJU.js";
+import "../chunk-3J3WL7WN.js";
+import "../chunk-K5ZLPEIQ.js";
 import {
   buildConfig
 } from "../chunk-U4MQ44TS.js";
-import {
-  createMdxLoader
-} from "../chunk-RMDXSZYE.js";
-import "../chunk-QAUWMR5D.js";
-import "../chunk-LMG6UWCL.js";
-import "../chunk-IQAEAI4P.js";
 import {
   findConfigFile,
   resolvedConfig
-} from "../chunk-XMFLD5J6.js";
+} from "../chunk-HI62EXSB.js";
 import "../chunk-VWJKRQZR.js";
 
 // src/bun/index.ts

package/dist/{chunk-QAUWMR5D.js → chunk-3J3WL7WN.js}

@@ -1,6 +1,6 @@
 import {
   remarkInclude
-} from "./chunk-LMG6UWCL.js";
+} from "./chunk-K5ZLPEIQ.js";
 
 // src/loaders/mdx/build-mdx.ts
 import { createProcessor } from "@mdx-js/mdx";
@@ -9,10 +9,19 @@ import { createProcessor } from "@mdx-js/mdx";
 import { visit } from "unist-util-visit";
 import { toMarkdown } from "mdast-util-to-markdown";
 import { valueToEstree } from "estree-util-value-to-estree";
+import { removePosition } from "unist-util-remove-position";
+import remarkMdx from "remark-mdx";
 function remarkPostprocess({
+  _format,
   includeProcessedMarkdown = false,
+  includeMDAST = false,
   valueToExport = []
-} = {}) {
+}) {
+  let _stringifyProcessor;
+  const getStringifyProcessor = () => {
+    if (_format === "mdx") return this;
+    return _stringifyProcessor ??= this().use(remarkMdx).freeze();
+  };
   return (tree, file) => {
     let title;
     const urls = [];
@@ -32,12 +41,19 @@ function remarkPostprocess({
     }
     file.data.extractedReferences = urls;
     if (includeProcessedMarkdown) {
+      const processor = getStringifyProcessor();
       file.data._markdown = toMarkdown(tree, {
-        ...this.data("settings"),
+        ...processor.data("settings"),
         // from https://github.com/remarkjs/remark/blob/main/packages/remark-stringify/lib/index.js
-        extensions: this.data("toMarkdownExtensions") || []
+        extensions: processor.data("toMarkdownExtensions") || []
       });
     }
+    if (includeMDAST) {
+      const options = includeMDAST === true ? {} : includeMDAST;
+      file.data._mdast = JSON.stringify(
+        options.removePosition ? removePosition(structuredClone(tree)) : tree
+      );
+    }
     for (const { name, value } of file.data["mdx-export"] ?? []) {
       tree.children.unshift(getMdastExport(name, value));
     }
@@ -105,6 +121,7 @@ async function buildMDX(cacheKey, source, options) {
           [
             remarkPostprocess,
             {
+              _format: format,
               ...options.postprocess,
               valueToExport: [
                 ...options.postprocess?.valueToExport ?? [],
@@ -112,7 +129,8 @@ async function buildMDX(cacheKey, source, options) {
                 "extractedReferences",
                 "frontmatter",
                 "lastModified",
-                "_markdown"
+                "_markdown",
+                "_mdast"
               ]
             }
           ]

package/dist/chunk-4MAYA5QX.js

@@ -0,0 +1,44 @@
+// src/plugins/index.ts
+import path from "path";
+import fs from "fs/promises";
+function createPluginHandler(context, defaultPlugins = []) {
+  const plugins = [];
+  async function write(entry) {
+    const file = path.join(context.outDir, entry.path);
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    await fs.writeFile(file, entry.content);
+  }
+  return {
+    async init(config) {
+      if (config.global.plugins) {
+        defaultPlugins.push(...config.global.plugins);
+      }
+      for await (const option of defaultPlugins) {
+        if (!option) continue;
+        if (Array.isArray(option)) plugins.push(...option);
+        else plugins.push(option);
+      }
+      for (const plugin of plugins) {
+        const out = await plugin.config?.call(context, config);
+        if (out) config = out;
+      }
+      return config;
+    },
+    async emit() {
+      const out = await Promise.all(
+        plugins.map((plugin) => {
+          return plugin.emit?.call(context) ?? [];
+        })
+      );
+      return out.flat();
+    },
+    async emitAndWrite() {
+      const entries = await this.emit();
+      await Promise.all(entries.map(write));
+    }
+  };
+}
+
+export {
+  createPluginHandler
+};

package/dist/{chunk-RMDXSZYE.js → chunk-CEA6MYJU.js}

@@ -1,10 +1,10 @@
 import {
   buildMDX
-} from "./chunk-QAUWMR5D.js";
+} from "./chunk-3J3WL7WN.js";
 import {
   getGitTimestamp,
   validate
-} from "./chunk-IQAEAI4P.js";
+} from "./chunk-HI62EXSB.js";
 import {
   fumaMatter
 } from "./chunk-VWJKRQZR.js";
@@ -16,16 +16,21 @@ import path from "path";
 import { createHash } from "crypto";
 var querySchema = z.object({
   only: z.literal(["frontmatter", "all"]).default("all"),
-  collection: z.string().optional(),
-  hash: z.string().describe(
-    "the hash of config, used for revalidation on Turbopack/Webpack."
-  ).optional()
+  collection: z.string().optional()
 }).loose();
 var cacheEntry = z.object({
   code: z.string(),
   map: z.any().optional(),
   hash: 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,
@@ -36,7 +41,7 @@ function createMdxLoader(configLoader) {
   }) => {
     const matter = fumaMatter(value);
     const parsed = querySchema.parse(query);
-    const loaded = await configLoader.getConfig(parsed.hash);
+    const loaded = await configLoader.getConfig();
     const cacheDir = isDevelopment ? void 0 : loaded.global.experimentalBuildCache;
     const cacheKey = `${parsed.hash}_${parsed.collection ?? "global"}_${generateCacheHash(filePath)}`;
     if (cacheDir) {
@@ -76,7 +81,7 @@ function createMdxLoader(configLoader) {
     }
     const lineOffset = isDevelopment ? countLines(matter.matter) : 0;
     const compiled = await buildMDX(
-      `${parsed.hash ?? ""}:${parsed.collection ?? "global"}`,
+      `${getConfigHash(loaded)}:${parsed.collection ?? "global"}`,
       "\n".repeat(lineOffset) + matter.content,
       {
         development: isDevelopment,

package/dist/{chunk-IQAEAI4P.js → chunk-HI62EXSB.js}

@@ -1,3 +1,60 @@
+// src/loaders/config/index.ts
+import path from "path";
+import fs from "fs/promises";
+function findConfigFile() {
+  return path.resolve("source.config.ts");
+}
+function resolvedConfig(loaded) {
+  return {
+    getConfig() {
+      return loaded;
+    }
+  };
+}
+function staticConfig({
+  outDir,
+  configPath,
+  buildConfig
+}) {
+  let cached;
+  return {
+    async getConfig() {
+      if (cached) return cached;
+      cached = import("./load-MNG3CLET.js").then(
+        (mod) => mod.loadConfig(configPath, outDir, buildConfig)
+      );
+      return cached;
+    }
+  };
+}
+function dynamicConfig({
+  outDir,
+  configPath,
+  buildConfig
+}) {
+  let loaded;
+  async function getConfigHash() {
+    const stats = await fs.stat(configPath).catch(() => void 0);
+    if (stats) {
+      return stats.mtime.getTime().toString();
+    }
+    throw new Error("Cannot find config file");
+  }
+  return {
+    async getConfig() {
+      const hash = await getConfigHash();
+      if (loaded && loaded.hash === hash) return loaded.config;
+      loaded = {
+        hash,
+        config: import("./load-MNG3CLET.js").then(
+          (mod) => mod.loadConfig(configPath, outDir, buildConfig)
+        )
+      };
+      return loaded.config;
+    }
+  };
+}
+
 // src/utils/validation.ts
 import picocolors from "picocolors";
 var ValidationError = class extends Error {
@@ -37,7 +94,7 @@ async function validate(schema, data, context, errorMessage) {
 }
 
 // src/utils/git-timestamp.ts
-import path from "path";
+import path2 from "path";
 import { x } from "tinyexec";
 var cache = /* @__PURE__ */ new Map();
 async function getGitTimestamp(file) {
@@ -46,7 +103,7 @@ async function getGitTimestamp(file) {
   try {
     const out = await x(
       "git",
-      ["log", "-1", '--pretty="%ai"', path.relative(process.cwd(), file)],
+      ["log", "-1", '--pretty="%ai"', path2.relative(process.cwd(), file)],
       {
         throwOnError: true
       }
@@ -60,6 +117,10 @@ async function getGitTimestamp(file) {
 }
 
 export {
+  findConfigFile,
+  resolvedConfig,
+  staticConfig,
+  dynamicConfig,
   ValidationError,
   validate,
   getGitTimestamp

package/dist/{chunk-46UPKP5R.js → chunk-II3H5ZVZ.js}

@@ -1,7 +1,5 @@
-// src/runtime/vite/browser.ts
-import { createElement, lazy } from "react";
-
 // src/runtime/vite/base.ts
+import { createElement, lazy } from "react";
 function fromConfigBase() {
   function normalize(entries, base) {
     const out = {};
@@ -28,8 +26,6 @@ function fromConfigBase() {
     }
   };
 }
-
-// src/runtime/vite/browser.ts
 var loaderStore = /* @__PURE__ */ new Map();
 function createClientLoader(files, options) {
   const { id = "", component } = options;
@@ -63,6 +59,10 @@ function createClientLoader(files, options) {
     getRenderer,
     getComponent(path) {
       return getRenderer()[path];
+    },
+    useContent(path, props) {
+      const Comp = this.getComponent(path);
+      return createElement(Comp, props);
     }
   };
 }