fumadocs-mdx 11.10.0 → 12.0.0

package/dist/vite/index.d.cts

@@ -1,5 +1,7 @@
 import { Plugin } from 'vite';
 
+declare function postInstall(configPath?: string, outDir?: string, addJsExtension?: boolean): Promise<void>;
+
 interface PluginOptions {
     /**
      * Automatically generate index files for accessing files with `import.meta.glob`.
@@ -17,6 +19,7 @@ interface PluginOptions {
      */
     configPath?: string;
 }
+
 declare function mdx(config: Record<string, unknown>, options?: PluginOptions): Plugin;
 
-export { type PluginOptions, mdx as default };
+export { type PluginOptions, mdx as default, postInstall };

package/dist/vite/index.d.ts

@@ -1,5 +1,7 @@
 import { Plugin } from 'vite';
 
+declare function postInstall(configPath?: string, outDir?: string, addJsExtension?: boolean): Promise<void>;
+
 interface PluginOptions {
     /**
      * Automatically generate index files for accessing files with `import.meta.glob`.
@@ -17,6 +19,7 @@ interface PluginOptions {
      */
     configPath?: string;
 }
+
 declare function mdx(config: Record<string, unknown>, options?: PluginOptions): Plugin;
 
-export { type PluginOptions, mdx as default };
+export { type PluginOptions, mdx as default, postInstall };

package/dist/vite/index.js

@@ -1,22 +1,25 @@
 import {
-  entry
-} from "../chunk-COQ4VMK2.js";
+  entry,
+  postInstall
+} from "../chunk-TLD6JMT6.js";
+import "../chunk-6Y5JDZHD.js";
 import {
   toVite
-} from "../chunk-NVX3U5YE.js";
+} from "../chunk-VXEBLM4X.js";
 import {
   createMdxLoader,
   resolvedConfig
-} from "../chunk-5XJM5RPV.js";
+} from "../chunk-KGUBBRL6.js";
 import {
   ValidationError,
   validate
-} from "../chunk-2HKRTQYP.js";
-import "../chunk-QQWCBFFE.js";
-import "../chunk-SVTXMVLQ.js";
+} from "../chunk-IQAEAI4P.js";
+import "../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/vite/index.ts
@@ -112,5 +115,6 @@ function mdx(config, options = {}) {
   };
 }
 export {
-  mdx as default
+  mdx as default,
+  postInstall
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-mdx",
-  "version": "11.10.0",
+  "version": "12.0.0",
   "description": "The built-in source for Fumadocs",
   "keywords": [
     "NextJs",
@@ -18,11 +18,6 @@
       "types": "./dist/config/index.d.ts",
       "require": "./dist/config/index.cjs"
     },
-    "./config/zod-3": {
-      "import": "./dist/config/zod-3.js",
-      "types": "./dist/config/zod-3.d.ts",
-      "require": "./dist/config/zod-3.cjs"
-    },
     "./next": {
       "import": "./dist/next/index.js",
       "types": "./dist/next/index.d.ts",
@@ -33,9 +28,13 @@
       "types": "./dist/vite/index.d.ts",
       "require": "./dist/vite/index.cjs"
     },
+    ".": {
+      "import": "./dist/runtime/next/index.js",
+      "types": "./dist/runtime/next/index.d.ts"
+    },
     "./runtime/async": {
-      "import": "./dist/runtime/async.js",
-      "types": "./dist/runtime/async.d.ts"
+      "import": "./dist/runtime/next/async.js",
+      "types": "./dist/runtime/next/async.d.ts"
     },
     "./runtime/vite": {
       "browser": "./dist/runtime/vite/browser.js",
@@ -49,20 +48,14 @@
     "./bun": {
       "import": "./dist/bun/index.js",
       "types": "./dist/bun/index.d.ts"
-    },
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts",
-      "require": "./dist/index.cjs"
     }
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "bin": "./bin.js",
+  "bin": "./dist/bin.js",
   "files": [
     "dist/*",
-    "loader-mdx.cjs",
-    "bin.js"
+    "loader-mdx.cjs"
   ],
   "dependencies": {
     "@mdx-js/mdx": "^3.1.1",
@@ -72,6 +65,7 @@
     "estree-util-value-to-estree": "^3.4.0",
     "js-yaml": "^4.1.0",
     "lru-cache": "^11.2.1",
+    "mdast-util-to-markdown": "^2.1.2",
     "picocolors": "^1.1.1",
     "remark-mdx": "^3.1.1",
     "remark-parse": "^11.0.0",
@@ -97,7 +91,7 @@
     "webpack": "^5.101.3",
     "@fumadocs/mdx-remote": "1.4.0",
     "eslint-config-custom": "0.0.0",
-    "fumadocs-core": "15.7.12",
+    "fumadocs-core": "15.7.13",
     "tsconfig": "0.0.0"
   },
   "peerDependencies": {

package/bin.js

@@ -1,5 +0,0 @@
-#!/usr/bin/env node
-
-import { postInstall } from './dist/next/index.js';
-
-void postInstall(process.argv[2], process.argv[3]);

package/dist/build-mdx-DnC1jKvn.d.cts

@@ -1,46 +0,0 @@
-import { createProcessor } from '@mdx-js/mdx';
-import { StructuredData } from 'fumadocs-core/mdx-plugins';
-import { TableOfContents } from 'fumadocs-core/server';
-import { FC } from 'react';
-import { MDXProps } from 'mdx/types';
-
-declare module 'vfile' {
-    interface DataMap {
-        extractedReferences: ExtractedReference[];
-    }
-}
-interface ExtractedReference {
-    href: string;
-}
-
-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[];
-}
-
-declare module 'vfile' {
-    interface DataMap {
-        /**
-         * [Fumadocs MDX] raw frontmatter, you can modify it
-         */
-        frontmatter?: Record<string, unknown>;
-        /**
-         * [Fumadocs MDX] The compiler object from loader
-         */
-        _compiler?: CompilerOptions;
-        _getProcessor?: (format: 'md' | 'mdx') => Processor;
-    }
-}
-
-export type { CompiledMDXProperties as C };

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

@@ -1,46 +0,0 @@
-import { createProcessor } from '@mdx-js/mdx';
-import { StructuredData } from 'fumadocs-core/mdx-plugins';
-import { TableOfContents } from 'fumadocs-core/server';
-import { FC } from 'react';
-import { MDXProps } from 'mdx/types';
-
-declare module 'vfile' {
-    interface DataMap {
-        extractedReferences: ExtractedReference[];
-    }
-}
-interface ExtractedReference {
-    href: string;
-}
-
-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[];
-}
-
-declare module 'vfile' {
-    interface DataMap {
-        /**
-         * [Fumadocs MDX] raw frontmatter, you can modify it
-         */
-        frontmatter?: Record<string, unknown>;
-        /**
-         * [Fumadocs MDX] The compiler object from loader
-         */
-        _compiler?: CompilerOptions;
-        _getProcessor?: (format: 'md' | 'mdx') => Processor;
-    }
-}
-
-export type { CompiledMDXProperties as C };

package/dist/chunk-2HKRTQYP.js

@@ -1,154 +0,0 @@
-import {
-  buildConfig
-} from "./chunk-QVZ7JH4H.js";
-
-// src/utils/validation.ts
-import picocolors from "picocolors";
-var ValidationError = class extends Error {
-  constructor(message, issues) {
-    super(
-      `${message}:
-${issues.map((issue) => `  ${issue.path}: ${issue.message}`).join("\n")}`
-    );
-    this.title = message;
-    this.issues = issues;
-  }
-  toStringFormatted() {
-    return [
-      picocolors.bold(`[MDX] ${this.title}:`),
-      ...this.issues.map(
-        (issue) => picocolors.redBright(
-          `- ${picocolors.bold(issue.path?.join(".") ?? "*")}: ${issue.message}`
-        )
-      )
-    ].join("\n");
-  }
-};
-async function validate(schema, data, context, errorMessage) {
-  if (typeof schema === "function" && !("~standard" in schema)) {
-    schema = schema(context);
-  }
-  if ("~standard" in schema) {
-    const result = await schema["~standard"].validate(
-      data
-    );
-    if (result.issues) {
-      throw new ValidationError(errorMessage, result.issues);
-    }
-    return result.value;
-  }
-  return data;
-}
-
-// src/utils/config.ts
-import * as fs from "fs/promises";
-import * as path from "path";
-import { pathToFileURL } from "url";
-function findConfigFile() {
-  return path.resolve("source.config.ts");
-}
-var cache = null;
-async function isZod3() {
-  try {
-    const content = JSON.parse(
-      (await fs.readFile("node_modules/zod/package.json")).toString()
-    );
-    const version = content.version;
-    return typeof version === "string" && version.startsWith("3.");
-  } catch {
-    return false;
-  }
-}
-function createCompatZodPlugin() {
-  return {
-    name: "replace-zod-import",
-    async setup(build) {
-      const usingZod3 = await isZod3();
-      if (!usingZod3) return;
-      console.warn(
-        "[Fumadocs MDX] Noticed Zod v3 in your node_modules, we recommend upgrading to Zod v4 for better compatibility."
-      );
-      build.onResolve({ filter: /^fumadocs-mdx\/config$/ }, () => {
-        return {
-          path: "fumadocs-mdx/config/zod-3",
-          external: true
-        };
-      });
-    }
-  };
-}
-async function compileConfig(configPath, outDir) {
-  const { build } = await import("esbuild");
-  const transformed = await build({
-    entryPoints: [{ in: configPath, out: "source.config" }],
-    bundle: true,
-    outdir: outDir,
-    target: "node20",
-    write: true,
-    platform: "node",
-    format: "esm",
-    packages: "external",
-    plugins: [createCompatZodPlugin()],
-    outExtension: {
-      ".js": ".mjs"
-    },
-    allowOverwrite: true
-  });
-  if (transformed.errors.length > 0) {
-    throw new Error("failed to compile configuration file");
-  }
-}
-async function loadConfig(configPath, outDir, hash, build = false) {
-  if (cache && cache.hash === hash) {
-    return await cache.config;
-  }
-  if (build) await compileConfig(configPath, outDir);
-  const url = pathToFileURL(path.resolve(outDir, "source.config.mjs"));
-  const config = import(`${url.href}?hash=${hash}`).then((loaded) => {
-    return buildConfig(
-      // every call to `loadConfig` will cause the previous cache to be ignored
-      loaded
-    );
-  });
-  if (hash) cache = { config, hash };
-  return await config;
-}
-async function getConfigHash(configPath) {
-  const stats = await fs.stat(configPath).catch(() => void 0);
-  if (stats) {
-    return stats.mtime.getTime().toString();
-  }
-  throw new Error("Cannot find config file");
-}
-
-// src/utils/git-timestamp.ts
-import path2 from "path";
-import { x } from "tinyexec";
-var cache2 = /* @__PURE__ */ new Map();
-async function getGitTimestamp(file) {
-  const cached = cache2.get(file);
-  if (cached) return cached;
-  try {
-    const out = await x(
-      "git",
-      ["log", "-1", '--pretty="%ai"', path2.relative(process.cwd(), file)],
-      {
-        throwOnError: true
-      }
-    );
-    const time = new Date(out.stdout);
-    cache2.set(file, time);
-    return time;
-  } catch {
-    return;
-  }
-}
-
-export {
-  ValidationError,
-  validate,
-  getGitTimestamp,
-  findConfigFile,
-  loadConfig,
-  getConfigHash
-};

package/dist/chunk-GBMFGEC7.js

@@ -1,57 +0,0 @@
-// 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) {
-  if (!options)
-    console.warn(
-      "[`source.config.ts`] Deprecated: please pass options to `defineDocs()` and specify a `dir`."
-    );
-  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 {
-  metaSchema,
-  frontmatterSchema,
-  defineCollections,
-  defineDocs,
-  defineConfig
-};

package/dist/chunk-QQWCBFFE.js

@@ -1,40 +0,0 @@
-import {
-  remarkInclude
-} from "./chunk-SVTXMVLQ.js";
-
-// src/utils/build-mdx.ts
-import { createProcessor } from "@mdx-js/mdx";
-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 ?? []],
-        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-SMSNZ6N5.js

@@ -1,155 +0,0 @@
-// src/utils/mdx-options.ts
-import * as plugins from "fumadocs-core/mdx-plugins";
-
-// src/mdx-plugins/remark-postprocess.ts
-import { visit } from "unist-util-visit";
-import { valueToEstree } from "estree-util-value-to-estree";
-function remarkPostprocess({
-  injectExports
-}) {
-  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;
-    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: valueToEstree(value)
-                }
-              ]
-            }
-          }
-        ]
-      }
-    }
-  };
-}
-
-// src/utils/mdx-options.ts
-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 mdxExports = [
-    "structuredData",
-    "extractedReferences",
-    "frontmatter",
-    "lastModified",
-    ...valueToExport
-  ];
-  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
-      ],
-      [
-        remarkPostprocess,
-        { injectExports: mdxExports }
-      ]
-    ],
-    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
-};