fumadocs-mdx 11.10.1 → 12.0.0

package/dist/chunk-SWNOXPYJ.js

@@ -0,0 +1,142 @@
+import {
+  remarkInclude
+} from "./chunk-KTDVTBMH.js";
+
+// src/mdx/build-mdx.ts
+import { createProcessor } from "@mdx-js/mdx";
+
+// src/mdx/remark-postprocess.ts
+import { visit } from "unist-util-visit";
+import { toMarkdown } from "mdast-util-to-markdown";
+import { valueToEstree } from "estree-util-value-to-estree";
+function remarkPostprocess({
+  includeProcessedMarkdown = false,
+  valueToExport = []
+} = {}) {
+  return (tree, file) => {
+    let title;
+    const urls = [];
+    visit(tree, ["heading", "link"], (node) => {
+      if (node.type === "heading" && node.depth === 1) {
+        title = flattenNode(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 = 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: valueToEstree(value)
+                }
+              ]
+            }
+          }
+        ]
+      }
+    }
+  };
+}
+function flattenNode(node) {
+  if ("children" in node)
+    return node.children.map((child) => flattenNode(child)).join("");
+  if ("value" in node) return node.value;
+  return "";
+}
+
+// src/mdx/build-mdx.ts
+var cache = /* @__PURE__ */ new Map();
+async function buildMDX(cacheKey, source, options) {
+  const { filePath, frontmatter, data, _compiler, ...rest } = options;
+  function getProcessor(format) {
+    const key = `${cacheKey}:${format}`;
+    let processor = cache.get(key);
+    if (!processor) {
+      processor = createProcessor({
+        outputFormat: "program",
+        ...rest,
+        remarkPlugins: [
+          remarkInclude,
+          ...rest.remarkPlugins ?? [],
+          [
+            remarkPostprocess,
+            {
+              ...options.postprocess,
+              valueToExport: [
+                ...options.postprocess?.valueToExport ?? [],
+                "structuredData",
+                "extractedReferences",
+                "frontmatter",
+                "lastModified",
+                "_markdown"
+              ]
+            }
+          ]
+        ],
+        format
+      });
+      cache.set(key, processor);
+    }
+    return processor;
+  }
+  return getProcessor(
+    options.format ?? filePath.endsWith(".mdx") ? "mdx" : "md"
+  ).process({
+    value: source,
+    path: filePath,
+    data: {
+      ...data,
+      frontmatter,
+      _compiler,
+      _getProcessor: getProcessor
+    }
+  });
+}
+
+export {
+  buildMDX
+};

package/dist/{chunk-XXSKWWMB.js → chunk-TLD6JMT6.js}

@@ -6,7 +6,7 @@ import {
 import {
   findConfigFile,
   loadConfig
-} from "./chunk-766EAFX6.js";
+} from "./chunk-POXTQZ4D.js";
 
 // src/vite/postinstall.ts
 import fs from "fs/promises";

package/dist/{chunk-CNKI574E.js → chunk-VXEBLM4X.js}

@@ -57,7 +57,7 @@ function toWebpack(loader) {
     try {
       const result = await loader({
         filePath: this.resourcePath,
-        query: parse(this.resourceQuery),
+        query: parse(this.resourceQuery.slice(1)),
         source,
         development: this.mode === "development",
         compiler: this

package/dist/{chunk-QVZ7JH4H.js → chunk-YC25YEBF.js}

@@ -34,7 +34,7 @@ function buildConfig(config) {
       const input = this.global.mdxOptions;
       async function uncached() {
         const options = typeof input === "function" ? await input() : input;
-        const { getDefaultMDXOptions } = await import("./mdx-options-T73E4LQB.js");
+        const { getDefaultMDXOptions } = await import("./preset-WFEORCAB.js");
         if (options?.preset === "minimal") return options;
         return getDefaultMDXOptions({
           ...options,

package/dist/chunk-ZLCSVXCD.js

@@ -0,0 +1,10 @@
+// src/runtime/shared.ts
+function missingProcessedMarkdown() {
+  throw new Error(
+    "getText('processed') requires `includeProcessedMarkdown` to be enabled in your collection config."
+  );
+}
+
+export {
+  missingProcessedMarkdown
+};

package/dist/config/index.cjs

@@ -64,11 +64,7 @@ function defineCollections(options) {
   return options;
 }
 function defineDocs(options) {
-  if (!options)
-    console.warn(
-      "[`source.config.ts`] Deprecated: please pass options to `defineDocs()` and specify a `dir`."
-    );
-  const dir = options?.dir ?? "content/docs";
+  const dir = options.dir ?? "content/docs";
   return {
     type: "docs",
     dir,
@@ -90,81 +86,8 @@ function defineConfig(config = {}) {
   return config;
 }
 
-// src/utils/mdx-options.ts
+// src/mdx/preset.ts
 var plugins = __toESM(require("fumadocs-core/mdx-plugins"), 1);
-
-// src/mdx-plugins/remark-postprocess.ts
-var import_unist_util_visit = require("unist-util-visit");
-var import_estree_util_value_to_estree = require("estree-util-value-to-estree");
-function remarkPostprocess({
-  injectExports
-}) {
-  return (tree, file) => {
-    let title;
-    const urls = [];
-    (0, import_unist_util_visit.visit)(tree, ["heading", "link"], (node) => {
-      if (node.type === "heading" && node.depth === 1) {
-        title = flattenNode(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 flattenNode(node) {
-  if ("children" in node)
-    return node.children.map((child) => flattenNode(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)
-                }
-              ]
-            }
-          }
-        ]
-      }
-    }
-  };
-}
-
-// src/utils/mdx-options.ts
 function pluginOption(def, options = []) {
   const list = def(Array.isArray(options) ? options : []).filter(
     Boolean
@@ -185,13 +108,6 @@ function getDefaultMDXOptions({
   _withoutBundler = false,
   ...mdxOptions
 }) {
-  const mdxExports = [
-    "structuredData",
-    "extractedReferences",
-    "frontmatter",
-    "lastModified",
-    ...valueToExport
-  ];
   const remarkPlugins = pluginOption(
     (v) => [
       plugins.remarkGfm,
@@ -219,10 +135,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
   );
@@ -242,9 +163,9 @@ function getDefaultMDXOptions({
   };
 }
 
-// src/mdx-plugins/remark-include.ts
+// src/mdx/remark-include.ts
 var import_unified = require("unified");
-var import_unist_util_visit2 = require("unist-util-visit");
+var import_unist_util_visit = require("unist-util-visit");
 var path = __toESM(require("path"), 1);
 var fs = __toESM(require("fs/promises"), 1);
 
@@ -264,14 +185,14 @@ function fumaMatter(input) {
   return output;
 }
 
-// src/mdx-plugins/remark-include.ts
+// src/mdx/remark-include.ts
 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");
 var baseProcessor = (0, import_unified.unified)().use(import_mdx_plugins.remarkHeading);
-function flattenNode2(node) {
+function flattenNode(node) {
   if ("children" in node)
-    return node.children.map((child) => flattenNode2(child)).join("");
+    return node.children.map((child) => flattenNode(child)).join("");
   if ("value" in node) return node.value;
   return "";
 }
@@ -350,14 +271,14 @@ ${e instanceof Error ? e.message : String(e)}`,
   }
   async function update(tree, directory, data) {
     const queue = [];
-    (0, import_unist_util_visit2.visit)(
+    (0, import_unist_util_visit.visit)(
       tree,
       ["mdxJsxFlowElement", "mdxJsxTextElement"],
       (_node, _, parent) => {
         const node = _node;
         if (node.name !== TagName) return;
         const params = {};
-        const specifier = flattenNode2(node);
+        const specifier = flattenNode(node);
         if (specifier.length === 0) return "skip";
         for (const attr of node.attributes) {
           if (attr.type === "mdxJsxAttribute" && (typeof attr.value === "string" || attr.value === null)) {

package/dist/config/index.d.cts

@@ -1,4 +1,4 @@
-export { A as AnyCollection, B as BaseCollection, C as CollectionSchema, D as DefaultMDXOptions, a as DocCollection, b as DocsCollection, G as GlobalConfig, M as MetaCollection, d as defineCollections, e as defineConfig, c as defineDocs, f as frontmatterSchema, g as getDefaultMDXOptions, m as metaSchema } from '../define-BH4bnHQl.cjs';
+export { A as AnyCollection, B as BaseCollection, C as CollectionSchema, D as DefaultMDXOptions, a as DocCollection, b as DocsCollection, G as GlobalConfig, M as MetaCollection, d as defineCollections, e as defineConfig, c as defineDocs, f as frontmatterSchema, g as getDefaultMDXOptions, m as metaSchema } from '../define--6HQ1ehX.cjs';
 import { Processor, Transformer } from 'unified';
 import { Root } from 'mdast';
 import '@standard-schema/spec';

package/dist/config/index.d.ts

@@ -1,4 +1,4 @@
-export { A as AnyCollection, B as BaseCollection, C as CollectionSchema, D as DefaultMDXOptions, a as DocCollection, b as DocsCollection, G as GlobalConfig, M as MetaCollection, d as defineCollections, e as defineConfig, c as defineDocs, f as frontmatterSchema, g as getDefaultMDXOptions, m as metaSchema } from '../define-BH4bnHQl.js';
+export { A as AnyCollection, B as BaseCollection, C as CollectionSchema, D as DefaultMDXOptions, a as DocCollection, b as DocsCollection, G as GlobalConfig, M as MetaCollection, d as defineCollections, e as defineConfig, c as defineDocs, f as frontmatterSchema, g as getDefaultMDXOptions, m as metaSchema } from '../define--6HQ1ehX.js';
 import { Processor, Transformer } from 'unified';
 import { Root } from 'mdast';
 import '@standard-schema/spec';

package/dist/config/index.js

@@ -1,17 +1,56 @@
-import {
-  defineCollections,
-  defineConfig,
-  defineDocs,
-  frontmatterSchema,
-  metaSchema
-} from "../chunk-GBMFGEC7.js";
 import {
   getDefaultMDXOptions
-} from "../chunk-SMSNZ6N5.js";
+} from "../chunk-3M4SHY6K.js";
 import {
   remarkInclude
-} from "../chunk-SVTXMVLQ.js";
+} from "../chunk-KTDVTBMH.js";
 import "../chunk-VWJKRQZR.js";
+
+// src/config/zod-4.ts
+import { z } from "zod";
+var metaSchema = z.object({
+  title: z.string().optional(),
+  pages: z.array(z.string()).optional(),
+  description: z.string().optional(),
+  root: z.boolean().optional(),
+  defaultOpen: z.boolean().optional(),
+  icon: z.string().optional()
+});
+var frontmatterSchema = z.object({
+  title: z.string(),
+  description: z.string().optional(),
+  icon: z.string().optional(),
+  full: z.boolean().optional(),
+  // Fumadocs OpenAPI generated
+  _openapi: z.looseObject({}).optional()
+});
+
+// src/config/define.ts
+function defineCollections(options) {
+  return options;
+}
+function defineDocs(options) {
+  const dir = options.dir ?? "content/docs";
+  return {
+    type: "docs",
+    dir,
+    docs: defineCollections({
+      type: "doc",
+      dir,
+      schema: frontmatterSchema,
+      ...options?.docs
+    }),
+    meta: defineCollections({
+      type: "meta",
+      dir,
+      schema: metaSchema,
+      ...options?.meta
+    })
+  };
+}
+function defineConfig(config = {}) {
+  return config;
+}
 export {
   defineCollections,
   defineConfig,

package/dist/{define-BH4bnHQl.d.ts → define--6HQ1ehX.d.cts}

@@ -38,6 +38,20 @@ declare const frontmatterSchema: z.ZodObject<{
     _openapi: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
 }, z.core.$strip>;
 
+interface ExtractedReference {
+    href: string;
+}
+interface PostprocessOptions {
+    /**
+     * Properties to export from `vfile.data`
+     */
+    valueToExport?: string[];
+    /**
+     * stringify MDAST and export via `_markdown`.
+     */
+    includeProcessedMarkdown?: boolean;
+}
+
 type CollectionSchema<Schema extends StandardSchemaV1, Context> = Schema | ((ctx: Context) => Schema);
 type AnyCollection = DocsCollection | DocCollection | MetaCollection;
 interface BaseCollection {
@@ -61,6 +75,7 @@ interface MetaCollection<Schema extends StandardSchemaV1 = StandardSchemaV1> ext
 }
 interface DocCollection<Schema extends StandardSchemaV1 = StandardSchemaV1, Async extends boolean = boolean> extends BaseCollection {
     type: 'doc';
+    postprocess?: PostprocessOptions;
     mdxOptions?: ProcessorOptions;
     /**
      * Load files with async
@@ -101,9 +116,9 @@ interface GlobalConfig {
 }
 declare function defineCollections<Schema extends StandardSchemaV1 = StandardSchemaV1, Async extends boolean = false>(options: DocCollection<Schema, Async>): DocCollection<Schema, Async>;
 declare function defineCollections<Schema extends StandardSchemaV1 = StandardSchemaV1>(options: MetaCollection<Schema>): MetaCollection<Schema>;
-declare function defineDocs<DocSchema extends StandardSchemaV1 = typeof frontmatterSchema, MetaSchema extends StandardSchemaV1 = typeof metaSchema, Async extends boolean = false>(options?: {
+declare function defineDocs<DocSchema extends StandardSchemaV1 = typeof frontmatterSchema, MetaSchema extends StandardSchemaV1 = typeof metaSchema, Async extends boolean = false>(options: {
     /**
-     * The directory to scan files
+     * The content directory to scan files
      *
      *  @defaultValue 'content/docs'
      */
@@ -113,4 +128,4 @@ declare function defineDocs<DocSchema extends StandardSchemaV1 = typeof frontmat
 }): DocsCollection<DocSchema, MetaSchema, Async>;
 declare function defineConfig(config?: GlobalConfig): GlobalConfig;
 
-export { type AnyCollection as A, type BaseCollection as B, type CollectionSchema as C, type DefaultMDXOptions as D, type GlobalConfig as G, type MetaCollection as M, type DocCollection as a, type DocsCollection as b, defineDocs as c, defineCollections as d, defineConfig as e, frontmatterSchema as f, getDefaultMDXOptions as g, metaSchema as m };
+export { type AnyCollection as A, type BaseCollection as B, type CollectionSchema as C, type DefaultMDXOptions as D, type ExtractedReference as E, type GlobalConfig as G, type MetaCollection as M, type DocCollection as a, type DocsCollection as b, defineDocs as c, defineCollections as d, defineConfig as e, frontmatterSchema as f, getDefaultMDXOptions as g, metaSchema as m };

package/dist/{define-BH4bnHQl.d.cts → define--6HQ1ehX.d.ts}

@@ -38,6 +38,20 @@ declare const frontmatterSchema: z.ZodObject<{
     _openapi: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
 }, z.core.$strip>;
 
+interface ExtractedReference {
+    href: string;
+}
+interface PostprocessOptions {
+    /**
+     * Properties to export from `vfile.data`
+     */
+    valueToExport?: string[];
+    /**
+     * stringify MDAST and export via `_markdown`.
+     */
+    includeProcessedMarkdown?: boolean;
+}
+
 type CollectionSchema<Schema extends StandardSchemaV1, Context> = Schema | ((ctx: Context) => Schema);
 type AnyCollection = DocsCollection | DocCollection | MetaCollection;
 interface BaseCollection {
@@ -61,6 +75,7 @@ interface MetaCollection<Schema extends StandardSchemaV1 = StandardSchemaV1> ext
 }
 interface DocCollection<Schema extends StandardSchemaV1 = StandardSchemaV1, Async extends boolean = boolean> extends BaseCollection {
     type: 'doc';
+    postprocess?: PostprocessOptions;
     mdxOptions?: ProcessorOptions;
     /**
      * Load files with async
@@ -101,9 +116,9 @@ interface GlobalConfig {
 }
 declare function defineCollections<Schema extends StandardSchemaV1 = StandardSchemaV1, Async extends boolean = false>(options: DocCollection<Schema, Async>): DocCollection<Schema, Async>;
 declare function defineCollections<Schema extends StandardSchemaV1 = StandardSchemaV1>(options: MetaCollection<Schema>): MetaCollection<Schema>;
-declare function defineDocs<DocSchema extends StandardSchemaV1 = typeof frontmatterSchema, MetaSchema extends StandardSchemaV1 = typeof metaSchema, Async extends boolean = false>(options?: {
+declare function defineDocs<DocSchema extends StandardSchemaV1 = typeof frontmatterSchema, MetaSchema extends StandardSchemaV1 = typeof metaSchema, Async extends boolean = false>(options: {
     /**
-     * The directory to scan files
+     * The content directory to scan files
      *
      *  @defaultValue 'content/docs'
      */
@@ -113,4 +128,4 @@ declare function defineDocs<DocSchema extends StandardSchemaV1 = typeof frontmat
 }): DocsCollection<DocSchema, MetaSchema, Async>;
 declare function defineConfig(config?: GlobalConfig): GlobalConfig;
 
-export { type AnyCollection as A, type BaseCollection as B, type CollectionSchema as C, type DefaultMDXOptions as D, type GlobalConfig as G, type MetaCollection as M, type DocCollection as a, type DocsCollection as b, defineDocs as c, defineCollections as d, defineConfig as e, frontmatterSchema as f, getDefaultMDXOptions as g, metaSchema as m };
+export { type AnyCollection as A, type BaseCollection as B, type CollectionSchema as C, type DefaultMDXOptions as D, type ExtractedReference as E, type GlobalConfig as G, type MetaCollection as M, type DocCollection as a, type DocsCollection as b, defineDocs as c, defineCollections as d, defineConfig as e, frontmatterSchema as f, getDefaultMDXOptions as g, metaSchema as m };