fumadocs-mdx 11.7.0 → 11.7.3

package/dist/next/index.js

@@ -1,18 +1,22 @@
 import {
   findConfigFile,
   getConfigHash,
-  getGitTimestamp,
   loadConfig
-} from "../chunk-2KBRPMAM.js";
+} from "../chunk-4CGSOZUZ.js";
 import {
+  getGlobPatterns,
   getImportCode,
+  isFileSupported,
   toImportPath
-} from "../chunk-JPPCALFT.js";
-import "../chunk-GWR7KMRU.js";
+} from "../chunk-OWZSTKKX.js";
+import {
+  getGitTimestamp
+} from "../chunk-VUEZTR2H.js";
 import {
   ValidationError,
   validate
 } from "../chunk-ZOWJF3OH.js";
+import "../chunk-JFNBRKRV.js";
 import {
   fumaMatter
 } from "../chunk-KVWX6THC.js";
@@ -26,16 +30,6 @@ import * as path from "path";
 import * as fs from "fs/promises";
 import { glob } from "tinyglobby";
 
-// src/utils/get-type-from-path.ts
-import { extname } from "path";
-var docTypes = [".mdx", ".md"];
-var metaTypes = [".json", ".yaml"];
-function getTypeFromPath(path4) {
-  const ext = extname(path4);
-  if (docTypes.includes(ext)) return "doc";
-  if (metaTypes.includes(ext)) return "meta";
-}
-
 // src/map/file-cache.ts
 import { LRUCache } from "lru-cache";
 var map = new LRUCache({
@@ -126,8 +120,7 @@ async function generateJS(configPath, config, importPath, configHash = false) {
           specifier: "fumadocs-mdx/runtime/async",
           names: ["_runtimeAsync", "buildConfig"]
         }),
-        "const [err, _sourceConfig] = buildConfig(_source)",
-        "if (!_sourceConfig) throw new Error(err)"
+        "const _sourceConfig = buildConfig(_source)"
       );
       asyncInit = true;
     }
@@ -189,14 +182,15 @@ async function generateJS(configPath, config, importPath, configHash = false) {
 async function getCollectionFiles(collection) {
   const files = /* @__PURE__ */ new Map();
   const dirs = Array.isArray(collection.dir) ? collection.dir : [collection.dir];
+  const patterns = getGlobPatterns(collection);
   await Promise.all(
     dirs.map(async (dir) => {
-      const result = await glob(collection.files ?? "**/*", {
+      const result = await glob(patterns, {
         cwd: path.resolve(dir),
         absolute: true
       });
       for (const item of result) {
-        if (getTypeFromPath(item) !== collection.type) continue;
+        if (!isFileSupported(item, collection)) continue;
         files.set(item, {
           path: path.relative(dir, item),
           absolutePath: item
@@ -207,16 +201,16 @@ async function getCollectionFiles(collection) {
   return Array.from(files.values());
 }
 function parseMetaEntry(file, content) {
-  const extname3 = path.extname(file);
+  const extname2 = path.extname(file);
   try {
-    if (extname3 === ".json") return JSON.parse(content);
-    if (extname3 === ".yaml") return load(content);
+    if (extname2 === ".json") return JSON.parse(content);
+    if (extname2 === ".yaml") return load(content);
   } catch (e) {
     throw new Error(`Failed to parse meta file: ${file}.`, {
       cause: e
     });
   }
-  throw new Error(`Unknown meta file format: ${extname3}, in ${file}.`);
+  throw new Error(`Unknown meta file format: ${extname2}, in ${file}.`);
 }
 
 // src/map/index.ts
@@ -274,7 +268,16 @@ async function start(dev, configPath, outDir) {
 }
 
 // src/next/create.ts
+import { readFileSync } from "fs";
 var defaultPageExtensions = ["mdx", "md", "jsx", "js", "tsx", "ts"];
+var isTurboExperimental;
+try {
+  const content = readFileSync("./node_modules/next/package.json").toString();
+  const version = JSON.parse(content).version;
+  isTurboExperimental = version.startsWith("15.0.") || version.startsWith("15.1.") || version.startsWith("15.2.");
+} catch {
+  isTurboExperimental = false;
+}
 function createMDX({
   configPath = findConfigFile(),
   outDir = ".source"
@@ -290,24 +293,25 @@ function createMDX({
       configPath,
       outDir
     };
-    return {
-      ...nextConfig,
-      turbopack: {
-        ...nextConfig?.turbopack,
-        rules: {
-          ...nextConfig?.turbopack?.rules,
-          // @ts-expect-error -- safe
-          "*.{md,mdx}": {
-            loaders: [
-              {
-                loader: "fumadocs-mdx/loader-mdx",
-                options: mdxLoaderOptions
-              }
-            ],
-            as: "*.js"
-          }
+    const turbo = {
+      ...nextConfig.experimental?.turbo,
+      ...nextConfig.turbopack,
+      rules: {
+        ...nextConfig.experimental?.turbo?.rules,
+        ...nextConfig.turbopack?.rules,
+        "*.{md,mdx}": {
+          loaders: [
+            {
+              loader: "fumadocs-mdx/loader-mdx",
+              options: mdxLoaderOptions
+            }
+          ],
+          as: "*.js"
         }
-      },
+      }
+    };
+    const updated = {
+      ...nextConfig,
       pageExtensions: nextConfig.pageExtensions ?? defaultPageExtensions,
       webpack: (config, options) => {
         config.resolve ||= {};
@@ -327,6 +331,12 @@ function createMDX({
         return nextConfig.webpack?.(config, options) ?? config;
       }
     };
+    if (isTurboExperimental) {
+      updated.experimental = { ...updated.experimental, turbo };
+    } else {
+      updated.turbopack = turbo;
+    }
+    return updated;
   };
 }
 

package/dist/runtime/async.cjs

@@ -338,7 +338,7 @@ function resolveFiles({ docs, meta }) {
 // src/config/build.ts
 function buildConfig(config) {
   const collections = /* @__PURE__ */ new Map();
-  let globalConfig;
+  let globalConfig = {};
   for (const [k, v] of Object.entries(config)) {
     if (!v) {
       continue;
@@ -353,34 +353,30 @@ function buildConfig(config) {
         continue;
       }
     }
-    if (k === "default") {
+    if (k === "default" && v) {
       globalConfig = v;
       continue;
     }
-    return [
-      `Unknown export "${k}", you can only export collections from source configuration file.`,
-      null
-    ];
+    throw new Error(
+      `Unknown export "${k}", you can only export collections from source configuration file.`
+    );
   }
   let cachedMdxOptions;
-  return [
-    null,
-    {
-      global: globalConfig,
-      collections,
-      async getDefaultMDXOptions() {
-        if (cachedMdxOptions) return cachedMdxOptions;
-        const input = this.global?.mdxOptions;
-        async function uncached() {
-          const options = typeof input === "function" ? await input() : input;
-          const { getDefaultMDXOptions: getDefaultMDXOptions2 } = await Promise.resolve().then(() => (init_mdx_options(), mdx_options_exports));
-          if (options?.preset === "minimal") return options;
-          return getDefaultMDXOptions2(options ?? {});
-        }
-        return cachedMdxOptions = uncached();
+  return {
+    global: globalConfig,
+    collections,
+    async getDefaultMDXOptions() {
+      if (cachedMdxOptions) return cachedMdxOptions;
+      const input = this.global.mdxOptions;
+      async function uncached() {
+        const options = typeof input === "function" ? await input() : input;
+        const { getDefaultMDXOptions: getDefaultMDXOptions2 } = await Promise.resolve().then(() => (init_mdx_options(), mdx_options_exports));
+        if (options?.preset === "minimal") return options;
+        return getDefaultMDXOptions2(options ?? {});
       }
+      return cachedMdxOptions = uncached();
     }
-  ];
+  };
 }
 
 // src/runtime/async.ts

package/dist/runtime/async.d.cts

@@ -1,7 +1,7 @@
-import { L as LoadedConfig, a as RuntimeAsync } from '../types-CnslxmoO.cjs';
+import { L as LoadedConfig, a as RuntimeAsync } from '../types-Lh_-Uuix.cjs';
 import '@standard-schema/spec';
 import 'fumadocs-core/source';
-import '../define-CCrinVBZ.cjs';
+import '../define-E6TRBwBQ.cjs';
 import 'zod';
 import 'fumadocs-core/mdx-plugins';
 import '@mdx-js/mdx';
@@ -10,7 +10,7 @@ import 'react';
 import 'mdx/types';
 import 'fumadocs-core/server';
 
-declare function buildConfig(config: Record<string, unknown>): [err: string, value: null] | [err: null, value: LoadedConfig];
+declare function buildConfig(config: Record<string, unknown>): LoadedConfig;
 
 declare const _runtimeAsync: RuntimeAsync;
 

package/dist/runtime/async.d.ts

@@ -1,7 +1,7 @@
-import { L as LoadedConfig, a as RuntimeAsync } from '../types-C0bKwtAx.js';
+import { L as LoadedConfig, a as RuntimeAsync } from '../types-DiL328cG.js';
 import '@standard-schema/spec';
 import 'fumadocs-core/source';
-import '../define-CCrinVBZ.js';
+import '../define-E6TRBwBQ.js';
 import 'zod';
 import 'fumadocs-core/mdx-plugins';
 import '@mdx-js/mdx';
@@ -10,7 +10,7 @@ import 'react';
 import 'mdx/types';
 import 'fumadocs-core/server';
 
-declare function buildConfig(config: Record<string, unknown>): [err: string, value: null] | [err: null, value: LoadedConfig];
+declare function buildConfig(config: Record<string, unknown>): LoadedConfig;
 
 declare const _runtimeAsync: RuntimeAsync;
 

package/dist/runtime/async.js

@@ -2,12 +2,12 @@ import {
   _runtime,
   createMDXSource
 } from "../chunk-NUDEC6C5.js";
-import {
-  buildConfig
-} from "../chunk-GWR7KMRU.js";
 import {
   remarkInclude
 } from "../chunk-AVMO2SRO.js";
+import {
+  buildConfig
+} from "../chunk-JFNBRKRV.js";
 import "../chunk-KVWX6THC.js";
 
 // src/runtime/async.ts

package/dist/runtime/vite.cjs

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/runtime/vite.ts
 var vite_exports = {};
 __export(vite_exports, {
+  createClientLoader: () => createClientLoader,
   fromConfig: () => fromConfig,
   toClientRenderer: () => toClientRenderer
 });
@@ -35,12 +36,13 @@ function fromConfig() {
     return out;
   }
   function mapPageData(entry) {
-    const { toc, structuredData } = entry;
+    const { toc, structuredData, lastModified, frontmatter } = entry;
     return {
-      ...entry.frontmatter,
+      ...frontmatter,
       default: entry.default,
       toc,
       structuredData,
+      lastModified,
       _exports: entry
     };
   }
@@ -99,18 +101,51 @@ function fromConfig() {
     }
   };
 }
-function toClientRenderer(files, renderer) {
-  const loader = {};
+var loaderStore = /* @__PURE__ */ new Map();
+function createClientLoader(files, options) {
+  const { id = "", component } = options;
+  const store = loaderStore.get(id) ?? {
+    preloaded: /* @__PURE__ */ new Map()
+  };
+  loaderStore.set(id, store);
+  let renderer;
+  return {
+    async preload(path) {
+      const loaded = await files[path]();
+      store.preloaded.set(path, loaded);
+      return loaded;
+    },
+    getComponent(path) {
+      renderer ??= toClientRenderer(files, component, {
+        cache: store.preloaded
+      });
+      return renderer[path];
+    }
+  };
+}
+function toClientRenderer(files, component, options = {}) {
+  const { cache } = options;
+  const renderer = {};
   for (const k in files) {
-    loader[k] = (0, import_react.lazy)(async () => {
+    const OnDemand = (0, import_react.lazy)(async () => {
       const loaded = await files[k]();
-      return { default: (props) => renderer(loaded, props) };
+      return { default: (props) => component(loaded, props) };
     });
+    if (cache) {
+      renderer[k] = (props) => {
+        const cached = cache.get(k);
+        if (!cached) return (0, import_react.createElement)(OnDemand, props);
+        return component(cached, props);
+      };
+    } else {
+      renderer[k] = OnDemand;
+    }
   }
-  return loader;
+  return renderer;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  createClientLoader,
   fromConfig,
   toClientRenderer
 });

package/dist/runtime/vite.d.cts

@@ -1,24 +1,26 @@
 import { TableOfContents } from 'fumadocs-core/server';
-import { FC, ReactNode, LazyExoticComponent } from 'react';
+import { FC, ReactNode } from 'react';
 import { MDXProps } from 'mdx/types';
 import { StructuredData } from 'fumadocs-core/mdx-plugins';
-import { D as DocCollection, M as MetaCollection, a as DocsCollection } from '../define-CCrinVBZ.cjs';
+import { a as DocCollection, M as MetaCollection, b as DocsCollection } from '../define-E6TRBwBQ.cjs';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import { PageData, MetaData, Source } from 'fumadocs-core/source';
 import 'zod';
 import '@mdx-js/mdx';
 import 'unified';
 
-type CompiledMDXFile<Frontmatter> = {
+interface CompiledMDXProperties<Frontmatter> {
     frontmatter: Frontmatter;
-    toc: TableOfContents;
-    default: FC<MDXProps>;
     structuredData: StructuredData;
-} & Record<string, unknown>;
-type MDXFileToPageData<Frontmatter> = Frontmatter & {
     toc: TableOfContents;
     default: FC<MDXProps>;
-    structuredData: StructuredData;
+    /**
+     * Only available when `lastModifiedTime` is enabled on MDX loader
+     */
+    lastModified?: Date;
+}
+type CompiledMDXFile<Frontmatter> = CompiledMDXProperties<Frontmatter> & Record<string, unknown>;
+type MDXFileToPageData<Frontmatter> = Frontmatter & Omit<CompiledMDXProperties<Frontmatter>, 'frontmatter'> & {
     _exports: Record<string, unknown>;
 };
 type AttachGlobValue<GlobValue, Attach> = GlobValue extends () => Promise<unknown> ? () => Promise<Attach> : Attach;
@@ -41,7 +43,31 @@ declare function fromConfig<Config>(): {
         metaData: MetaOut;
     }>>;
 };
-type ClientLoader<Props> = Record<string, LazyExoticComponent<(props: Props) => ReactNode>>;
-declare function toClientRenderer<Frontmatter, Props extends object = object>(files: Record<string, () => Promise<CompiledMDXFile<Frontmatter>>>, renderer: (loaded: CompiledMDXFile<Frontmatter>, props: Props) => ReactNode): ClientLoader<Props>;
+interface ClientLoaderOptions<Frontmatter, Props> {
+    /**
+     * Loader ID (usually your collection name)
+     *
+     * The code splitting strategy of frameworks like Tanstack Start may duplicate `createClientLoader()` into different chunks.
+     *
+     * We use loader ID to share cache between multiple instances of client loader.
+     *
+     * @defaultValue ''
+     */
+    id?: string;
+    component: (loaded: CompiledMDXFile<Frontmatter>, props: Props) => ReactNode;
+}
+interface ClientLoader<Frontmatter, Props> {
+    preload: (path: string) => Promise<CompiledMDXFile<Frontmatter>>;
+    /**
+     * Get a component that renders content with `React.lazy`
+     */
+    getComponent: (path: string) => FC<Props>;
+}
+declare function createClientLoader<Frontmatter, Props = object>(files: Record<string, () => Promise<CompiledMDXFile<Frontmatter>>>, options: ClientLoaderOptions<Frontmatter, Props>): ClientLoader<Frontmatter, Props>;
+interface ClientRendererOptions<Frontmatter> {
+    cache?: Map<string, CompiledMDXFile<Frontmatter>>;
+}
+type ClientRenderer<Props> = Record<string, FC<Props>>;
+declare function toClientRenderer<Frontmatter, Props = object>(files: Record<string, () => Promise<CompiledMDXFile<Frontmatter>>>, component: (loaded: CompiledMDXFile<Frontmatter>, props: Props) => ReactNode, options?: ClientRendererOptions<Frontmatter>): ClientRenderer<Props>;
 
-export { type CompiledMDXFile, fromConfig, toClientRenderer };
+export { type ClientLoader, type ClientLoaderOptions, type ClientRendererOptions, type CompiledMDXFile, createClientLoader, fromConfig, toClientRenderer };

package/dist/runtime/vite.d.ts

@@ -1,24 +1,26 @@
 import { TableOfContents } from 'fumadocs-core/server';
-import { FC, ReactNode, LazyExoticComponent } from 'react';
+import { FC, ReactNode } from 'react';
 import { MDXProps } from 'mdx/types';
 import { StructuredData } from 'fumadocs-core/mdx-plugins';
-import { D as DocCollection, M as MetaCollection, a as DocsCollection } from '../define-CCrinVBZ.js';
+import { a as DocCollection, M as MetaCollection, b as DocsCollection } from '../define-E6TRBwBQ.js';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import { PageData, MetaData, Source } from 'fumadocs-core/source';
 import 'zod';
 import '@mdx-js/mdx';
 import 'unified';
 
-type CompiledMDXFile<Frontmatter> = {
+interface CompiledMDXProperties<Frontmatter> {
     frontmatter: Frontmatter;
-    toc: TableOfContents;
-    default: FC<MDXProps>;
     structuredData: StructuredData;
-} & Record<string, unknown>;
-type MDXFileToPageData<Frontmatter> = Frontmatter & {
     toc: TableOfContents;
     default: FC<MDXProps>;
-    structuredData: StructuredData;
+    /**
+     * Only available when `lastModifiedTime` is enabled on MDX loader
+     */
+    lastModified?: Date;
+}
+type CompiledMDXFile<Frontmatter> = CompiledMDXProperties<Frontmatter> & Record<string, unknown>;
+type MDXFileToPageData<Frontmatter> = Frontmatter & Omit<CompiledMDXProperties<Frontmatter>, 'frontmatter'> & {
     _exports: Record<string, unknown>;
 };
 type AttachGlobValue<GlobValue, Attach> = GlobValue extends () => Promise<unknown> ? () => Promise<Attach> : Attach;
@@ -41,7 +43,31 @@ declare function fromConfig<Config>(): {
         metaData: MetaOut;
     }>>;
 };
-type ClientLoader<Props> = Record<string, LazyExoticComponent<(props: Props) => ReactNode>>;
-declare function toClientRenderer<Frontmatter, Props extends object = object>(files: Record<string, () => Promise<CompiledMDXFile<Frontmatter>>>, renderer: (loaded: CompiledMDXFile<Frontmatter>, props: Props) => ReactNode): ClientLoader<Props>;
+interface ClientLoaderOptions<Frontmatter, Props> {
+    /**
+     * Loader ID (usually your collection name)
+     *
+     * The code splitting strategy of frameworks like Tanstack Start may duplicate `createClientLoader()` into different chunks.
+     *
+     * We use loader ID to share cache between multiple instances of client loader.
+     *
+     * @defaultValue ''
+     */
+    id?: string;
+    component: (loaded: CompiledMDXFile<Frontmatter>, props: Props) => ReactNode;
+}
+interface ClientLoader<Frontmatter, Props> {
+    preload: (path: string) => Promise<CompiledMDXFile<Frontmatter>>;
+    /**
+     * Get a component that renders content with `React.lazy`
+     */
+    getComponent: (path: string) => FC<Props>;
+}
+declare function createClientLoader<Frontmatter, Props = object>(files: Record<string, () => Promise<CompiledMDXFile<Frontmatter>>>, options: ClientLoaderOptions<Frontmatter, Props>): ClientLoader<Frontmatter, Props>;
+interface ClientRendererOptions<Frontmatter> {
+    cache?: Map<string, CompiledMDXFile<Frontmatter>>;
+}
+type ClientRenderer<Props> = Record<string, FC<Props>>;
+declare function toClientRenderer<Frontmatter, Props = object>(files: Record<string, () => Promise<CompiledMDXFile<Frontmatter>>>, component: (loaded: CompiledMDXFile<Frontmatter>, props: Props) => ReactNode, options?: ClientRendererOptions<Frontmatter>): ClientRenderer<Props>;
 
-export { type CompiledMDXFile, fromConfig, toClientRenderer };
+export { type ClientLoader, type ClientLoaderOptions, type ClientRendererOptions, type CompiledMDXFile, createClientLoader, fromConfig, toClientRenderer };

package/dist/runtime/vite.js

@@ -1,5 +1,5 @@
 // src/runtime/vite.ts
-import { lazy } from "react";
+import { createElement, lazy } from "react";
 function fromConfig() {
   function normalize(entries) {
     const out = {};
@@ -10,12 +10,13 @@ function fromConfig() {
     return out;
   }
   function mapPageData(entry) {
-    const { toc, structuredData } = entry;
+    const { toc, structuredData, lastModified, frontmatter } = entry;
     return {
-      ...entry.frontmatter,
+      ...frontmatter,
       default: entry.default,
       toc,
       structuredData,
+      lastModified,
       _exports: entry
     };
   }
@@ -74,17 +75,50 @@ function fromConfig() {
     }
   };
 }
-function toClientRenderer(files, renderer) {
-  const loader = {};
+var loaderStore = /* @__PURE__ */ new Map();
+function createClientLoader(files, options) {
+  const { id = "", component } = options;
+  const store = loaderStore.get(id) ?? {
+    preloaded: /* @__PURE__ */ new Map()
+  };
+  loaderStore.set(id, store);
+  let renderer;
+  return {
+    async preload(path) {
+      const loaded = await files[path]();
+      store.preloaded.set(path, loaded);
+      return loaded;
+    },
+    getComponent(path) {
+      renderer ??= toClientRenderer(files, component, {
+        cache: store.preloaded
+      });
+      return renderer[path];
+    }
+  };
+}
+function toClientRenderer(files, component, options = {}) {
+  const { cache } = options;
+  const renderer = {};
   for (const k in files) {
-    loader[k] = lazy(async () => {
+    const OnDemand = lazy(async () => {
       const loaded = await files[k]();
-      return { default: (props) => renderer(loaded, props) };
+      return { default: (props) => component(loaded, props) };
     });
+    if (cache) {
+      renderer[k] = (props) => {
+        const cached = cache.get(k);
+        if (!cached) return createElement(OnDemand, props);
+        return component(cached, props);
+      };
+    } else {
+      renderer[k] = OnDemand;
+    }
   }
-  return loader;
+  return renderer;
 }
 export {
+  createClientLoader,
   fromConfig,
   toClientRenderer
 };

package/dist/{types-C0bKwtAx.d.ts → types-DiL328cG.d.ts}

@@ -1,6 +1,6 @@
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import { Source, PageData, MetaData } from 'fumadocs-core/source';
-import { D as DocCollection, M as MetaCollection, a as DocsCollection, G as GlobalConfig } from './define-CCrinVBZ.js';
+import { a as DocCollection, M as MetaCollection, b as DocsCollection, G as GlobalConfig } from './define-E6TRBwBQ.js';
 import { ProcessorOptions } from '@mdx-js/mdx';
 import { FC } from 'react';
 import { MDXProps } from 'mdx/types';
@@ -9,7 +9,7 @@ import { TableOfContents } from 'fumadocs-core/server';
 
 interface LoadedConfig {
     collections: Map<string, DocCollection | MetaCollection | DocsCollection>;
-    global?: GlobalConfig;
+    global: GlobalConfig;
     getDefaultMDXOptions(): Promise<ProcessorOptions>;
 }
 

package/dist/{types-CnslxmoO.d.cts → types-Lh_-Uuix.d.cts}

@@ -1,6 +1,6 @@
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import { Source, PageData, MetaData } from 'fumadocs-core/source';
-import { D as DocCollection, M as MetaCollection, a as DocsCollection, G as GlobalConfig } from './define-CCrinVBZ.cjs';
+import { a as DocCollection, M as MetaCollection, b as DocsCollection, G as GlobalConfig } from './define-E6TRBwBQ.cjs';
 import { ProcessorOptions } from '@mdx-js/mdx';
 import { FC } from 'react';
 import { MDXProps } from 'mdx/types';
@@ -9,7 +9,7 @@ import { TableOfContents } from 'fumadocs-core/server';
 
 interface LoadedConfig {
     collections: Map<string, DocCollection | MetaCollection | DocsCollection>;
-    global?: GlobalConfig;
+    global: GlobalConfig;
     getDefaultMDXOptions(): Promise<ProcessorOptions>;
 }