fumadocs-mdx 11.7.1 → 11.7.4

package/dist/next/index.cjs

@@ -205,7 +205,7 @@ var import_node_url = require("url");
 // 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;
@@ -220,34 +220,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/utils/config.ts
@@ -282,12 +278,10 @@ async function loadConfig(configPath, outDir, hash, build = false) {
   if (build) await compileConfig(configPath, outDir);
   const url = (0, import_node_url.pathToFileURL)(path.resolve(outDir, "source.config.mjs"));
   const config = import(`${url.href}?hash=${hash}`).then((loaded) => {
-    const [err, config2] = buildConfig(
+    return buildConfig(
       // every call to `loadConfig` will cause the previous cache to be ignored
       loaded
     );
-    if (err !== null) throw new Error(err);
-    return config2;
   });
   cache = { config, hash };
   return await config;
@@ -543,8 +537,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;
     }

package/dist/next/index.js

@@ -1,20 +1,22 @@
 import {
   findConfigFile,
   getConfigHash,
-  getGitTimestamp,
   loadConfig
-} from "../chunk-2KBRPMAM.js";
+} from "../chunk-4CGSOZUZ.js";
 import {
   getGlobPatterns,
   getImportCode,
   isFileSupported,
   toImportPath
 } from "../chunk-OWZSTKKX.js";
-import "../chunk-GWR7KMRU.js";
+import {
+  getGitTimestamp
+} from "../chunk-VUEZTR2H.js";
 import {
   ValidationError,
   validate
 } from "../chunk-ZOWJF3OH.js";
+import "../chunk-JFNBRKRV.js";
 import {
   fumaMatter
 } from "../chunk-KVWX6THC.js";
@@ -118,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;
     }

package/dist/runtime/async.cjs

@@ -195,9 +195,29 @@ function flattenNode(node) {
   if ("value" in node) return node.value;
   return "";
 }
+function parseSpecifier(specifier) {
+  const idx = specifier.lastIndexOf("#");
+  if (idx === -1) return { file: specifier };
+  return {
+    file: specifier.slice(0, idx),
+    section: specifier.slice(idx + 1)
+  };
+}
+function extractSection(root, section) {
+  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
+    )) {
+      return {
+        type: "root",
+        children: node.children
+      };
+    }
+  }
+}
 function remarkInclude() {
   const TagName = "include";
-  async function update(tree, file, processor, compiler) {
+  async function update(tree, directory, processor, compiler) {
     const queue = [];
     (0, import_unist_util_visit.visit)(
       tree,
@@ -217,27 +237,41 @@ function remarkInclude() {
           }
         }
         if (!specifier) return;
+        const { file, section } = parseSpecifier(specifier);
         const targetPath = path.resolve(
-          "cwd" in params ? process.cwd() : path.dirname(file),
-          specifier
+          "cwd" in params ? process.cwd() : directory,
+          file
         );
-        const asCode = params.lang || !specifier.endsWith(".md") && !specifier.endsWith(".mdx");
+        const asCode = params.lang || !file.endsWith(".md") && !file.endsWith(".mdx");
         queue.push(
           fs.readFile(targetPath).then((buffer) => buffer.toString()).then(async (content) => {
             compiler?.addDependency(targetPath);
             if (asCode) {
-              const lang = params.lang ?? path.extname(specifier).slice(1);
+              const lang = params.lang ?? path.extname(file).slice(1);
               Object.assign(node, {
                 type: "code",
                 lang,
                 meta: params.meta,
-                value: content.toString(),
+                value: content,
                 data: {}
               });
               return;
             }
-            const parsed = processor.parse(fumaMatter(content).content);
-            await update(parsed, targetPath, processor, compiler);
+            let parsed = processor.parse(fumaMatter(content).content);
+            if (section) {
+              const extracted = extractSection(parsed, section);
+              if (!extracted)
+                throw new Error(
+                  `Cannot find section ${section} in ${file}, make sure you have encapsulated the section in a <section id="${section}"> tag`
+                );
+              parsed = extracted;
+            }
+            await update(
+              parsed,
+              path.dirname(targetPath),
+              processor,
+              compiler
+            );
             Object.assign(
               parent && parent.type === "paragraph" ? parent : node,
               parsed
@@ -245,7 +279,8 @@ function remarkInclude() {
           }).catch((e) => {
             throw new Error(
               `failed to read file ${targetPath}
-${e instanceof Error ? e.message : String(e)}`
+${e instanceof Error ? e.message : String(e)}`,
+              { cause: e }
             );
           })
         );
@@ -255,7 +290,7 @@ ${e instanceof Error ? e.message : String(e)}`
     await Promise.all(queue);
   }
   return async (tree, file) => {
-    await update(tree, file.path, this, file.data._compiler);
+    await update(tree, path.dirname(file.path), this, file.data._compiler);
   };
 }
 
@@ -338,7 +373,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 +388,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";
+} from "../chunk-PQCNPAD3.js";
+import {
+  buildConfig
+} from "../chunk-JFNBRKRV.js";
 import "../chunk-KVWX6THC.js";
 
 // src/runtime/async.ts

package/dist/runtime/vite.cjs

@@ -36,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
     };
   }

package/dist/runtime/vite.d.cts

@@ -2,23 +2,25 @@ import { TableOfContents } from 'fumadocs-core/server';
 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;

package/dist/runtime/vite.d.ts

@@ -2,23 +2,25 @@ import { TableOfContents } from 'fumadocs-core/server';
 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;

package/dist/runtime/vite.js

@@ -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
     };
   }

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>;
 }