fumadocs-mdx 11.10.1 → 12.0.1

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

@@ -4,9 +4,11 @@ import {
   toImportPath
 } from "./chunk-6Y5JDZHD.js";
 import {
-  findConfigFile,
   loadConfig
-} from "./chunk-766EAFX6.js";
+} from "./chunk-LGYVNESJ.js";
+import {
+  findConfigFile
+} from "./chunk-XMFLD5J6.js";
 
 // src/vite/postinstall.ts
 import fs from "fs/promises";

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/loaders/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/loaders/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,35 @@ function fumaMatter(input) {
   return output;
 }
 
-// src/mdx-plugins/remark-include.ts
+// src/loaders/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) {
+var ElementLikeTypes = [
+  "mdxJsxFlowElement",
+  "mdxJsxTextElement",
+  "containerDirective",
+  "textDirective",
+  "leafDirective"
+];
+function isElementLike(node) {
+  return ElementLikeTypes.includes(node.type);
+}
+function parseElementAttributes(element) {
+  if (Array.isArray(element.attributes)) {
+    const attributes = {};
+    for (const attr of element.attributes) {
+      if (attr.type === "mdxJsxAttribute" && (typeof attr.value === "string" || attr.value === null)) {
+        attributes[attr.name] = attr.value;
+      }
+    }
+    return attributes;
+  }
+  return element.attributes ?? {};
+}
+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 "";
 }
@@ -285,21 +227,31 @@ function parseSpecifier(specifier) {
 }
 function extractSection(root, section) {
   let nodes;
-  for (const node of root.children) {
-    if (node.type === "mdxJsxFlowElement" && node.name === "section" && node.attributes.some(
-      (attr) => attr.type === "mdxJsxAttribute" && attr.name === "id" && attr.value === section
-    )) {
-      nodes = node.children;
-      break;
+  let capturingHeadingContent = false;
+  (0, import_unist_util_visit.visit)(root, (node) => {
+    if (node.type === "heading") {
+      if (capturingHeadingContent) {
+        return false;
+      }
+      if (node.data?.hProperties?.id === section) {
+        capturingHeadingContent = true;
+        nodes = [node];
+        return "skip";
+      }
+      return;
     }
-    if (node.type === "heading" && node.data?.hProperties?.id === section) {
-      nodes = [node];
-      continue;
+    if (capturingHeadingContent) {
+      nodes?.push(node);
+      return "skip";
     }
-    if (!nodes) continue;
-    if (node.type === "heading") break;
-    nodes.push(node);
-  }
+    if (isElementLike(node) && node.name === "section") {
+      const attributes = parseElementAttributes(node);
+      if (attributes.id === section) {
+        nodes = node.children;
+        return false;
+      }
+    }
+  });
   if (nodes)
     return {
       type: "root",
@@ -331,55 +283,52 @@ ${e instanceof Error ? e.message : String(e)}`,
         data: {}
       };
     }
-    const processor = (data._getProcessor ?? getDefaultProcessor)(
+    const parser = (data._getProcessor ?? getDefaultProcessor)(
       ext === ".mdx" ? "mdx" : "md"
     );
-    let parsed = await baseProcessor.run(
-      processor.parse(fumaMatter(content).content)
-    );
+    const parsed = fumaMatter(content);
+    let mdast = parser.parse({
+      path: file,
+      value: parsed.content,
+      data: { frontmatter: parsed.data }
+    });
     if (heading) {
-      const extracted = extractSection(parsed, heading);
+      const extracted = extractSection(
+        await (0, import_unified.unified)().use(import_mdx_plugins.remarkHeading).run(mdast),
+        heading
+      );
       if (!extracted)
         throw new Error(
-          `Cannot find section ${heading} in ${file}, make sure you have encapsulated the section in a <section id="${heading}"> tag.`
+          `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.`
         );
-      parsed = extracted;
+      mdast = extracted;
     }
-    await update(parsed, path.dirname(file), data);
-    return parsed;
+    await update(mdast, path.dirname(file), data);
+    return mdast;
   }
   async function update(tree, directory, data) {
     const queue = [];
-    (0, import_unist_util_visit2.visit)(
-      tree,
-      ["mdxJsxFlowElement", "mdxJsxTextElement"],
-      (_node, _, parent) => {
-        const node = _node;
-        if (node.name !== TagName) return;
-        const params = {};
-        const specifier = flattenNode2(node);
-        if (specifier.length === 0) return "skip";
-        for (const attr of node.attributes) {
-          if (attr.type === "mdxJsxAttribute" && (typeof attr.value === "string" || attr.value === null)) {
-            params[attr.name] = attr.value;
-          }
-        }
-        const { file: relativePath, section } = parseSpecifier(specifier);
-        const file = path.resolve(
-          "cwd" in params ? process.cwd() : directory,
-          relativePath
-        );
-        queue.push(
-          embedContent(file, section, params, data).then((replace) => {
-            Object.assign(
-              parent && parent.type === "paragraph" ? parent : node,
-              replace
-            );
-          })
-        );
-        return "skip";
-      }
-    );
+    (0, import_unist_util_visit.visit)(tree, ElementLikeTypes, (_node, _, parent) => {
+      const node = _node;
+      if (node.name !== TagName) return;
+      const specifier = flattenNode(node);
+      if (specifier.length === 0) return "skip";
+      const attributes = parseElementAttributes(node);
+      const { file: relativePath, section } = parseSpecifier(specifier);
+      const file = path.resolve(
+        "cwd" in attributes ? process.cwd() : directory,
+        relativePath
+      );
+      queue.push(
+        embedContent(file, section, attributes, data).then((replace) => {
+          Object.assign(
+            parent && parent.type === "paragraph" ? parent : node,
+            replace
+          );
+        })
+      );
+      return "skip";
+    });
     await Promise.all(queue);
   }
   return async (tree, file) => {

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-FSZMKRVH.js";
 import {
   remarkInclude
-} from "../chunk-SVTXMVLQ.js";
+} from "../chunk-LMG6UWCL.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 };

package/dist/load-UUXLUBHL.js

@@ -0,0 +1,9 @@
+import {
+  getConfigHash,
+  loadConfig
+} from "./chunk-LGYVNESJ.js";
+import "./chunk-U4MQ44TS.js";
+export {
+  getConfigHash,
+  loadConfig
+};