fumadocs-mdx 11.9.1 → 11.10.0

package/dist/bun/index.js

@@ -0,0 +1,50 @@
+import {
+  createMdxLoader,
+  resolvedConfig
+} from "../chunk-5XJM5RPV.js";
+import {
+  findConfigFile
+} from "../chunk-2HKRTQYP.js";
+import "../chunk-QQWCBFFE.js";
+import "../chunk-SVTXMVLQ.js";
+import {
+  buildConfig
+} from "../chunk-QVZ7JH4H.js";
+import "../chunk-VWJKRQZR.js";
+
+// src/bun/index.ts
+import { parse } from "querystring";
+function createMdxPlugin(options = {}) {
+  const { configPath = findConfigFile() } = options;
+  async function getMdxLoader() {
+    const out = buildConfig(await import(configPath));
+    return createMdxLoader(resolvedConfig(out));
+  }
+  return {
+    name: "bun-plugin-fumadocs-mdx",
+    setup(build) {
+      const mdxLoader = getMdxLoader();
+      build.onLoad({ filter: /\.mdx(\?.+?)?$/ }, async (args) => {
+        const [filePath, query] = args.path.split("?", 2);
+        const content = await Bun.file(filePath).text();
+        const result = await (await mdxLoader)({
+          source: content,
+          query: parse(query),
+          filePath,
+          development: false,
+          compiler: {
+            addDependency() {
+            }
+          }
+        });
+        return {
+          contents: result.code,
+          loader: "js"
+        };
+      });
+    }
+  };
+}
+export {
+  createMdxPlugin
+};

package/dist/{chunk-766EAFX6.js → chunk-2HKRTQYP.js}

@@ -2,6 +2,44 @@ 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";
@@ -83,7 +121,33 @@ async function getConfigHash(configPath) {
   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-5XJM5RPV.js

@@ -0,0 +1,149 @@
+import {
+  getConfigHash,
+  getGitTimestamp,
+  loadConfig,
+  validate
+} from "./chunk-2HKRTQYP.js";
+import {
+  buildMDX
+} from "./chunk-QQWCBFFE.js";
+import {
+  fumaMatter
+} from "./chunk-VWJKRQZR.js";
+
+// src/utils/count-lines.ts
+function countLines(s) {
+  let num = 0;
+  for (const c of s) {
+    if (c === "\n") num++;
+  }
+  return num;
+}
+
+// src/loaders/mdx.ts
+import { z } from "zod";
+import fs from "fs/promises";
+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()
+}).loose();
+var cacheEntry = z.object({
+  code: z.string(),
+  map: z.any().optional(),
+  hash: z.string().optional()
+});
+function createMdxLoader(configLoader) {
+  return async ({
+    source: value,
+    development: isDevelopment,
+    query,
+    compiler,
+    filePath
+  }) => {
+    const matter = fumaMatter(value);
+    const parsed = querySchema.parse(query);
+    const loaded = await configLoader.getConfig(parsed.hash);
+    const cacheDir = isDevelopment ? void 0 : loaded.global.experimentalBuildCache;
+    const cacheKey = `${parsed.hash}_${parsed.collection ?? "global"}_${generateCacheHash(filePath)}`;
+    if (cacheDir) {
+      const cached = await fs.readFile(path.join(cacheDir, cacheKey)).then((content) => cacheEntry.parse(JSON.parse(content.toString()))).catch(() => null);
+      if (cached && cached.hash === generateCacheHash(value)) return cached;
+    }
+    const collection = parsed.collection ? loaded.collections.get(parsed.collection) : void 0;
+    let schema;
+    let mdxOptions;
+    switch (collection?.type) {
+      case "doc":
+        mdxOptions = collection.mdxOptions;
+        schema = collection.schema;
+        break;
+      case "docs":
+        mdxOptions = collection.docs.mdxOptions;
+        schema = collection.docs.schema;
+        break;
+    }
+    if (schema) {
+      matter.data = await validate(
+        schema,
+        matter.data,
+        {
+          source: value,
+          path: filePath
+        },
+        `invalid frontmatter in ${filePath}`
+      );
+    }
+    if (parsed.only === "frontmatter") {
+      return {
+        code: `export const frontmatter = ${JSON.stringify(matter.data)}`,
+        map: null
+      };
+    }
+    const data = {};
+    if (loaded.global.lastModifiedTime === "git") {
+      data.lastModified = (await getGitTimestamp(filePath))?.getTime();
+    }
+    const lineOffset = isDevelopment ? countLines(matter.matter) : 0;
+    const compiled = await buildMDX(
+      `${parsed.hash ?? ""}:${parsed.collection ?? "global"}`,
+      "\n".repeat(lineOffset) + matter.content,
+      {
+        development: isDevelopment,
+        ...mdxOptions ?? await loaded.getDefaultMDXOptions(),
+        data,
+        filePath,
+        frontmatter: matter.data,
+        _compiler: compiler
+      }
+    );
+    const out = {
+      code: String(compiled.value),
+      map: compiled.map
+    };
+    if (cacheDir) {
+      await fs.mkdir(cacheDir, { recursive: true });
+      await fs.writeFile(
+        path.join(cacheDir, cacheKey),
+        JSON.stringify({
+          ...out,
+          hash: generateCacheHash(value)
+        })
+      );
+    }
+    return out;
+  };
+}
+function generateCacheHash(input) {
+  return createHash("md5").update(input).digest("hex");
+}
+
+// src/loaders/config-loader.ts
+function resolvedConfig(loaded) {
+  return {
+    getConfig() {
+      return loaded;
+    }
+  };
+}
+function dynamicConfig(configPath, outDir) {
+  return {
+    async getConfig(hash) {
+      return loadConfig(
+        configPath,
+        outDir,
+        hash ?? await getConfigHash(configPath)
+      );
+    }
+  };
+}
+
+export {
+  createMdxLoader,
+  resolvedConfig,
+  dynamicConfig
+};

package/dist/chunk-NVX3U5YE.js

@@ -0,0 +1,82 @@
+import {
+  ValidationError
+} from "./chunk-2HKRTQYP.js";
+
+// src/loaders/adapter.ts
+import { fileURLToPath } from "url";
+import fs from "fs/promises";
+import { parse } from "querystring";
+import path from "path";
+function toNode(loader, filterByPath) {
+  return async (url, _context, nextLoad) => {
+    if (!url.startsWith("file:///")) return nextLoad(url);
+    const parsedUrl = new URL(url);
+    const filePath = fileURLToPath(parsedUrl);
+    if (filterByPath(filePath)) {
+      const source = (await fs.readFile(filePath)).toString();
+      const result = await loader({
+        filePath,
+        query: Object.fromEntries(parsedUrl.searchParams.entries()),
+        source,
+        development: false,
+        compiler: {
+          addDependency() {
+          }
+        }
+      });
+      return {
+        source: result.code,
+        format: "module",
+        shortCircuit: true
+      };
+    }
+    return nextLoad(url);
+  };
+}
+function toVite(loader) {
+  return async function(file, query, value) {
+    const result = await loader({
+      filePath: file,
+      query: parse(query),
+      source: value,
+      development: this.environment.mode === "dev",
+      compiler: {
+        addDependency: (file2) => {
+          this.addWatchFile(file2);
+        }
+      }
+    });
+    return {
+      code: result.code,
+      map: result.map
+    };
+  };
+}
+function toWebpack(loader) {
+  return async function(source, callback) {
+    try {
+      const result = await loader({
+        filePath: this.resourcePath,
+        query: parse(this.resourceQuery),
+        source,
+        development: this.mode === "development",
+        compiler: this
+      });
+      callback(void 0, result.code, result.map);
+    } catch (error) {
+      if (error instanceof ValidationError) {
+        return callback(new Error(error.toStringFormatted()));
+      }
+      if (!(error instanceof Error)) throw error;
+      const fpath = path.relative(this.context, this.resourcePath);
+      error.message = `${fpath}:${error.name}: ${error.message}`;
+      callback(error);
+    }
+  };
+}
+
+export {
+  toNode,
+  toVite,
+  toWebpack
+};

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-DnJzAZrj.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-BH4bnHQl.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-DnJzAZrj.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-BH4bnHQl.js';
 import { Processor, Transformer } from 'unified';
 import { Root } from 'mdast';
 import '@standard-schema/spec';

package/dist/config/zod-3.d.cts

@@ -1,5 +1,5 @@
 import { z } from 'zod/v3';
-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, g as getDefaultMDXOptions } from '../define-DnJzAZrj.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, g as getDefaultMDXOptions } from '../define-BH4bnHQl.cjs';
 export { Params, remarkInclude } from './index.cjs';
 import '@standard-schema/spec';
 import 'fumadocs-core/mdx-plugins';

package/dist/config/zod-3.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod/v3';
-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, g as getDefaultMDXOptions } from '../define-DnJzAZrj.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, g as getDefaultMDXOptions } from '../define-BH4bnHQl.js';
 export { Params, remarkInclude } from './index.js';
 import '@standard-schema/spec';
 import 'fumadocs-core/mdx-plugins';

package/dist/{define-DnJzAZrj.d.cts → define-BH4bnHQl.d.cts}

@@ -92,6 +92,12 @@ interface GlobalConfig {
      * @defaultValue 'none'
      */
     lastModifiedTime?: 'git' | 'none';
+    /**
+     * specify a directory to access & store cache (disabled during development mode).
+     *
+     * The cache will never be updated, delete the cache folder to clean.
+     */
+    experimentalBuildCache?: string;
 }
 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>;

package/dist/{define-DnJzAZrj.d.ts → define-BH4bnHQl.d.ts}

@@ -92,6 +92,12 @@ interface GlobalConfig {
      * @defaultValue 'none'
      */
     lastModifiedTime?: 'git' | 'none';
+    /**
+     * specify a directory to access & store cache (disabled during development mode).
+     *
+     * The cache will never be updated, delete the cache folder to clean.
+     */
+    experimentalBuildCache?: string;
 }
 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>;

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { PageData, MetaData, Source, VirtualFile } from 'fumadocs-core/source';
-import { R as Runtime, B as BaseCollectionEntry } from './types-BmVgoqsr.cjs';
+import { R as Runtime, B as BaseCollectionEntry } from './types-DT83Ijs6.cjs';
 import '@standard-schema/spec';
-import './define-DnJzAZrj.cjs';
+import './define-BH4bnHQl.cjs';
 import 'fumadocs-core/mdx-plugins';
 import '@mdx-js/mdx';
 import 'unified';

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { PageData, MetaData, Source, VirtualFile } from 'fumadocs-core/source';
-import { R as Runtime, B as BaseCollectionEntry } from './types-WSHJKA8L.js';
+import { R as Runtime, B as BaseCollectionEntry } from './types-DN9KrG7R.js';
 import '@standard-schema/spec';
-import './define-DnJzAZrj.js';
+import './define-BH4bnHQl.js';
 import 'fumadocs-core/mdx-plugins';
 import '@mdx-js/mdx';
 import 'unified';