fumadocs-core 16.2.4 → 16.3.0

package/dist/breadcrumb.js

@@ -3,7 +3,7 @@ import {
 } from "./chunk-PFNP6PEB.js";
 import {
   findPath
-} from "./chunk-XKUN7AUK.js";
+} from "./chunk-L4JKQWCM.js";
 import "./chunk-U67V476Y.js";
 
 // src/breadcrumb.tsx

package/dist/chunk-GINBKBVQ.js

@@ -0,0 +1,12 @@
+// src/content/mdx/util.ts
+async function resolvePlugins(def, options = []) {
+  const list = (await Promise.all(def(Array.isArray(options) ? options : []))).filter((v) => v !== false);
+  if (typeof options === "function") {
+    return Promise.all(options(list));
+  }
+  return list;
+}
+
+export {
+  resolvePlugins
+};

package/dist/{chunk-XKUN7AUK.js → chunk-L4JKQWCM.js}

@@ -88,7 +88,7 @@ function findPath(nodes, matcher, options = {}) {
   }
   return run(nodes) ?? null;
 }
-var VisitBreak = Symbol("VisitBreak");
+var VisitBreak = /* @__PURE__ */ Symbol("VisitBreak");
 function visit(root, visitor) {
   function onNode(node, parent) {
     const result = visitor(node, parent);

package/dist/content/mdx/preset-bundler.d.ts

@@ -0,0 +1,31 @@
+import { ProcessorOptions } from '@mdx-js/mdx';
+import { RehypeCodeOptions } from '../../mdx-plugins/rehype-code.js';
+import { RemarkImageOptions } from '../../mdx-plugins/remark-image.js';
+import { StructureOptions } from '../../mdx-plugins/remark-structure.js';
+import { RemarkHeadingOptions } from '../../mdx-plugins/remark-heading.js';
+import { RemarkCodeTabOptions } from '../../mdx-plugins/remark-code-tab.js';
+import { RemarkNpmOptions } from '../../mdx-plugins/remark-npm.js';
+import { R as ResolvePlugins } from '../../util-bZU2QeJ2.js';
+import 'hast';
+import '@shikijs/rehype';
+import 'unified';
+import 'shiki';
+import 'mdast';
+import 'mdast-util-mdx-jsx';
+
+type MDXBundlerPresetOptions = Omit<NonNullable<ProcessorOptions>, 'rehypePlugins' | 'remarkPlugins'> & {
+    rehypePlugins?: ResolvePlugins;
+    remarkPlugins?: ResolvePlugins;
+    remarkStructureOptions?: StructureOptions | false;
+    remarkHeadingOptions?: RemarkHeadingOptions;
+    remarkImageOptions?: RemarkImageOptions | false;
+    remarkCodeTabOptions?: RemarkCodeTabOptions | false;
+    remarkNpmOptions?: RemarkNpmOptions | false;
+    rehypeCodeOptions?: RehypeCodeOptions | false;
+};
+/**
+ * apply MDX processor presets
+ */
+declare function mdxPreset(options?: MDXBundlerPresetOptions): Promise<ProcessorOptions>;
+
+export { type MDXBundlerPresetOptions, mdxPreset };

package/dist/content/mdx/preset-bundler.js

@@ -0,0 +1,72 @@
+import {
+  resolvePlugins
+} from "../../chunk-GINBKBVQ.js";
+import "../../chunk-U67V476Y.js";
+
+// src/content/mdx/preset-bundler.ts
+async function mdxPreset(options = {}) {
+  const {
+    rehypeCodeOptions,
+    remarkImageOptions,
+    remarkHeadingOptions,
+    remarkStructureOptions,
+    remarkCodeTabOptions,
+    remarkNpmOptions,
+    ...mdxOptions
+  } = options;
+  const remarkPlugins = await resolvePlugins(
+    (v) => [
+      import("remark-gfm").then((mod) => mod.default),
+      import("../../mdx-plugins/remark-heading.js").then((mod) => [
+        mod.remarkHeading,
+        {
+          generateToc: false,
+          ...remarkHeadingOptions
+        }
+      ]),
+      remarkImageOptions !== false && import("../../mdx-plugins/remark-image.js").then((mod) => [
+        mod.remarkImage,
+        {
+          ...remarkImageOptions,
+          useImport: remarkImageOptions?.useImport ?? true
+        }
+      ]),
+      remarkCodeTabOptions !== false && import("../../mdx-plugins/remark-code-tab.js").then((mod) => [
+        mod.remarkCodeTab,
+        remarkCodeTabOptions
+      ]),
+      remarkNpmOptions !== false && import("../../mdx-plugins/remark-npm.js").then((mod) => [
+        mod.remarkNpm,
+        remarkNpmOptions
+      ]),
+      ...v,
+      remarkStructureOptions !== false && import("../../mdx-plugins/remark-structure.js").then((mod) => [
+        mod.remarkStructure,
+        {
+          exportAs: "structuredData",
+          ...remarkStructureOptions
+        }
+      ])
+    ],
+    mdxOptions.remarkPlugins
+  );
+  const rehypePlugins = await resolvePlugins(
+    (v) => [
+      rehypeCodeOptions !== false && import("../../mdx-plugins/rehype-code.js").then((mod) => [
+        mod.rehypeCode,
+        rehypeCodeOptions
+      ]),
+      ...v,
+      import("../../mdx-plugins/rehype-toc.js").then((mod) => mod.rehypeToc)
+    ],
+    mdxOptions.rehypePlugins
+  );
+  return {
+    ...mdxOptions,
+    remarkPlugins,
+    rehypePlugins
+  };
+}
+export {
+  mdxPreset
+};

package/dist/content/mdx/preset-runtime.d.ts

@@ -0,0 +1,31 @@
+import { ProcessorOptions } from '@mdx-js/mdx';
+import { RehypeCodeOptions } from '../../mdx-plugins/rehype-code.js';
+import { RemarkImageOptions } from '../../mdx-plugins/remark-image.js';
+import { StructureOptions } from '../../mdx-plugins/remark-structure.js';
+import { RemarkHeadingOptions } from '../../mdx-plugins/remark-heading.js';
+import { RemarkCodeTabOptions } from '../../mdx-plugins/remark-code-tab.js';
+import { RemarkNpmOptions } from '../../mdx-plugins/remark-npm.js';
+import { R as ResolvePlugins } from '../../util-bZU2QeJ2.js';
+import 'hast';
+import '@shikijs/rehype';
+import 'unified';
+import 'shiki';
+import 'mdast';
+import 'mdast-util-mdx-jsx';
+
+type MDXRuntimePresetOptions = Omit<NonNullable<ProcessorOptions>, 'rehypePlugins' | 'remarkPlugins'> & {
+    rehypePlugins?: ResolvePlugins;
+    remarkPlugins?: ResolvePlugins;
+    remarkStructureOptions?: StructureOptions | false;
+    remarkHeadingOptions?: RemarkHeadingOptions;
+    remarkImageOptions?: RemarkImageOptions | false;
+    remarkCodeTabOptions?: RemarkCodeTabOptions | false;
+    remarkNpmOptions?: RemarkNpmOptions | false;
+    rehypeCodeOptions?: RehypeCodeOptions | false;
+};
+/**
+ * apply MDX processor presets
+ */
+declare function mdxPreset(options?: MDXRuntimePresetOptions): Promise<ProcessorOptions>;
+
+export { type MDXRuntimePresetOptions, mdxPreset };

package/dist/content/mdx/preset-runtime.js

@@ -0,0 +1,71 @@
+import {
+  resolvePlugins
+} from "../../chunk-GINBKBVQ.js";
+import "../../chunk-U67V476Y.js";
+
+// src/content/mdx/preset-runtime.ts
+async function mdxPreset(options = {}) {
+  const {
+    rehypeCodeOptions,
+    remarkImageOptions,
+    remarkHeadingOptions,
+    remarkStructureOptions,
+    remarkCodeTabOptions,
+    remarkNpmOptions,
+    outputFormat = "function-body",
+    ...mdxOptions
+  } = options;
+  const remarkPlugins = await resolvePlugins(
+    (v) => [
+      import("remark-gfm").then((mod) => mod.default),
+      import("../../mdx-plugins/remark-heading.js").then((mod) => [
+        mod.remarkHeading,
+        {
+          generateToc: false,
+          ...remarkHeadingOptions
+        }
+      ]),
+      remarkImageOptions !== false && import("../../mdx-plugins/remark-image.js").then((mod) => [
+        mod.remarkImage,
+        remarkImageOptions
+      ]),
+      remarkCodeTabOptions !== false && import("../../mdx-plugins/remark-code-tab.js").then((mod) => [
+        mod.remarkCodeTab,
+        remarkCodeTabOptions
+      ]),
+      remarkNpmOptions !== false && import("../../mdx-plugins/remark-npm.js").then((mod) => [
+        mod.remarkNpm,
+        remarkNpmOptions
+      ]),
+      ...v,
+      remarkStructureOptions !== false && import("../../mdx-plugins/remark-structure.js").then((mod) => [
+        mod.remarkStructure,
+        {
+          exportAs: "structuredData",
+          ...remarkStructureOptions
+        }
+      ])
+    ],
+    mdxOptions.remarkPlugins
+  );
+  const rehypePlugins = await resolvePlugins(
+    (v) => [
+      rehypeCodeOptions !== false && import("../../mdx-plugins/rehype-code.js").then((mod) => [
+        mod.rehypeCode,
+        rehypeCodeOptions
+      ]),
+      ...v,
+      import("../../mdx-plugins/rehype-toc.js").then((mod) => mod.rehypeToc)
+    ],
+    mdxOptions.rehypePlugins
+  );
+  return {
+    ...mdxOptions,
+    outputFormat,
+    remarkPlugins,
+    rehypePlugins
+  };
+}
+export {
+  mdxPreset
+};

package/dist/{loader-qkSHi822.d.ts → loader-_E2HOdV0.d.ts}

@@ -59,18 +59,30 @@ type _ConfigUnion_<T extends Record<string, Source>> = {
     } : never;
 }[keyof T];
 declare function multiple<T extends Record<string, Source>>(sources: T): Source<_ConfigUnion_<T>>;
+declare function source<Page extends PageData, Meta extends MetaData>(config: {
+    pages: VirtualPage<Page>[];
+    metas: VirtualMeta<Meta>[];
+}): Source<{
+    pageData: Page;
+    metaData: Meta;
+}>;
 /**
- * map virtual files in source
+ * update a source object in-place.
  */
-declare function map<Config extends SourceConfig>(source: Source<Config>): {
-    page<$Page extends PageData>(fn: (entry: VirtualPage<Config["pageData"]>) => VirtualPage<$Page>): Source<{
-        pageData: $Page;
+declare function update<Config extends SourceConfig>(source: Source<Config>): {
+    files<Page extends PageData, Meta extends MetaData>(fn: (files: VirtualFile<Config>[]) => (VirtualPage<Page> | VirtualMeta<Meta>)[]): typeof update<{
+        pageData: Page;
+        metaData: Meta;
+    }>;
+    page<V extends PageData>(fn: (page: VirtualPage<Config["pageData"]>) => VirtualPage<V>): typeof update<{
+        pageData: V;
         metaData: Config["metaData"];
     }>;
-    meta<$Meta extends MetaData>(fn: (entry: VirtualMeta<Config["metaData"]>) => VirtualMeta<$Meta>): Source<{
+    meta<V extends MetaData>(fn: (meta: VirtualMeta<Config["metaData"]>) => VirtualMeta<V>): typeof update<{
         pageData: Config["pageData"];
-        metaData: $Meta;
+        metaData: V;
     }>;
+    build(): Source<Config>;
 };
 
 /**
@@ -239,6 +251,12 @@ interface Meta<Data = MetaData> extends SharedFileInfo {
 interface LoaderOutput<Config extends LoaderConfig> {
     pageTree: Config['i18n'] extends I18nConfig ? Record<string, Root> : Root;
     getPageTree: (locale?: string) => Root;
+    /**
+     * get referenced page from href, supported:
+     *
+     * - relative file paths, like `./my/page.mdx`.
+     * - generated page pathname, like `/docs/my/page`.
+     */
     getPageByHref: (href: string, options?: {
         language?: string;
         /**
@@ -249,6 +267,12 @@ interface LoaderOutput<Config extends LoaderConfig> {
         page: Page<Config['source']['pageData']>;
         hash?: string;
     } | undefined;
+    /**
+     * resolve special hrefs in a page, including:
+     *
+     * - relative file paths, like `./my/page.mdx`.
+     */
+    resolveHref: (href: string, parent: Page<Config['source']['pageData']>) => string;
     /**
      * @internal
      */
@@ -306,4 +330,4 @@ declare function loader<Config extends SourceConfig, I18n extends I18nConfig | u
 type InferPageType<Utils extends LoaderOutput<any>> = Utils extends LoaderOutput<infer Config> ? Page<Config['source']['pageData']> : never;
 type InferMetaType<Utils extends LoaderOutput<any>> = Utils extends LoaderOutput<infer Config> ? Meta<Config['source']['metaData']> : never;
 
-export { type ContentStorage as C, FileSystem as F, type InferPageType as I, type LoaderPlugin as L, type MetaData as M, type PageData as P, type ResolvedLoaderConfig as R, type Source as S, type VirtualFile as V, type _ConfigUnion_ as _, type SourceConfig as a, map as b, type LoaderConfig as c, type LoaderOptions as d, type Page as e, type Meta as f, type LoaderOutput as g, createGetUrl as h, type InferMetaType as i, type PageTreeBuilderContext as j, type PageTreeTransformer as k, loader as l, multiple as m, type PageTreeOptions as n, type PageTreeBuilder as o, createPageTreeBuilder as p, type ContentStorageFile as q, buildContentStorage as r, type LoaderPluginOption as s, buildPlugins as t };
+export { type ContentStorage as C, FileSystem as F, type InferPageType as I, type LoaderPlugin as L, type MetaData as M, type PageData as P, type ResolvedLoaderConfig as R, type Source as S, type VirtualFile as V, type _ConfigUnion_ as _, type SourceConfig as a, type LoaderConfig as b, type LoaderOptions as c, type Page as d, type Meta as e, type LoaderOutput as f, createGetUrl as g, type InferMetaType as h, type PageTreeBuilderContext as i, type PageTreeTransformer as j, type PageTreeOptions as k, loader as l, multiple as m, type PageTreeBuilder as n, createPageTreeBuilder as o, type ContentStorageFile as p, buildContentStorage as q, type LoaderPluginOption as r, source as s, buildPlugins as t, update as u };

package/dist/page-tree/index.js

@@ -5,7 +5,7 @@ import {
   getPageTreePeers,
   getPageTreeRoots,
   visit
-} from "../chunk-XKUN7AUK.js";
+} from "../chunk-L4JKQWCM.js";
 import "../chunk-U67V476Y.js";
 export {
   findNeighbour,

package/dist/search/server.d.ts

@@ -3,7 +3,7 @@ import { StructuredData } from '../mdx-plugins/remark-structure.js';
 import { SortedResult } from './index.js';
 export { HighlightedText, ReactSortedResult, createContentHighlighter } from './index.js';
 import { I18nConfig } from '../i18n/index.js';
-import { g as LoaderOutput, c as LoaderConfig, I as InferPageType } from '../loader-qkSHi822.js';
+import { b as LoaderConfig, f as LoaderOutput, d as Page } from '../loader-_E2HOdV0.js';
 import 'mdast';
 import 'unified';
 import 'mdast-util-mdx-jsx';
@@ -31,13 +31,13 @@ declare const advancedSchema: {
 };
 
 type Awaitable<T> = T | Promise<T>;
-interface Options<S extends LoaderOutput<LoaderConfig>> extends Omit<AdvancedOptions, 'indexes'> {
+interface Options<C extends LoaderConfig> extends Omit<AdvancedOptions, 'indexes'> {
     localeMap?: {
-        [K in S extends LoaderOutput<infer C> ? C['i18n'] extends I18nConfig<infer Languages> ? Languages : string : string]?: Partial<AdvancedOptions> | Language;
+        [K in C['i18n'] extends I18nConfig<infer Languages> ? Languages : string]?: Partial<AdvancedOptions> | Language;
     };
-    buildIndex?: (page: InferPageType<S>) => Awaitable<AdvancedIndex>;
+    buildIndex?: (page: Page<C['source']['pageData']>) => Awaitable<AdvancedIndex>;
 }
-declare function createFromSource<S extends LoaderOutput<LoaderConfig>>(source: S, options?: Options<S>): SearchAPI;
+declare function createFromSource<C extends LoaderConfig>(source: LoaderOutput<C>, options?: Options<C>): SearchAPI;
 
 type I18nOptions<O extends SimpleOptions | AdvancedOptions, Idx> = Omit<O, 'language' | 'indexes'> & {
     i18n: I18nConfig;

package/dist/search/server.js

@@ -12,7 +12,7 @@ import {
 } from "../chunk-XZSI7AHE.js";
 import {
   findPath
-} from "../chunk-XKUN7AUK.js";
+} from "../chunk-L4JKQWCM.js";
 import "../chunk-U67V476Y.js";
 
 // src/search/server.ts

package/dist/source/client/index.js

@@ -1,6 +1,6 @@
 import {
   visit
-} from "../../chunk-XKUN7AUK.js";
+} from "../../chunk-L4JKQWCM.js";
 import "../../chunk-U67V476Y.js";
 
 // src/source/client/index.tsx

package/dist/source/index.d.ts

@@ -1,4 +1,4 @@
-export { C as ContentStorage, q as ContentStorageFile, F as FileSystem, i as InferMetaType, I as InferPageType, c as LoaderConfig, d as LoaderOptions, g as LoaderOutput, L as LoaderPlugin, s as LoaderPluginOption, f as Meta, M as MetaData, e as Page, P as PageData, o as PageTreeBuilder, j as PageTreeBuilderContext, n as PageTreeOptions, k as PageTreeTransformer, R as ResolvedLoaderConfig, S as Source, a as SourceConfig, V as VirtualFile, _ as _ConfigUnion_, r as buildContentStorage, t as buildPlugins, h as createGetUrl, p as createPageTreeBuilder, l as loader, b as map, m as multiple } from '../loader-qkSHi822.js';
+export { C as ContentStorage, p as ContentStorageFile, F as FileSystem, h as InferMetaType, I as InferPageType, b as LoaderConfig, c as LoaderOptions, f as LoaderOutput, L as LoaderPlugin, r as LoaderPluginOption, e as Meta, M as MetaData, d as Page, P as PageData, n as PageTreeBuilder, i as PageTreeBuilderContext, k as PageTreeOptions, j as PageTreeTransformer, R as ResolvedLoaderConfig, S as Source, a as SourceConfig, V as VirtualFile, _ as _ConfigUnion_, q as buildContentStorage, t as buildPlugins, g as createGetUrl, o as createPageTreeBuilder, l as loader, m as multiple, s as source, u as update } from '../loader-_E2HOdV0.js';
 import '../definitions-pJ7PybYY.js';
 import 'react';
 import '../i18n/index.js';

package/dist/source/index.js

@@ -15,14 +15,14 @@ import {
 } from "../chunk-PFNP6PEB.js";
 import {
   visit
-} from "../chunk-XKUN7AUK.js";
+} from "../chunk-L4JKQWCM.js";
 import "../chunk-U67V476Y.js";
 
 // src/source/source.ts
 function multiple(sources) {
   const out = { files: [] };
-  for (const [type, source] of Object.entries(sources)) {
-    for (const file of source.files) {
+  for (const [type, source2] of Object.entries(sources)) {
+    for (const file of source2.files) {
       out.files.push({
         ...file,
         data: {
@@ -34,21 +34,33 @@ function multiple(sources) {
   }
   return out;
 }
-function map(source) {
+function source(config) {
   return {
+    files: [...config.pages, ...config.metas]
+  };
+}
+function update(source2) {
+  return {
+    files(fn) {
+      source2.files = fn(source2.files);
+      return this;
+    },
     page(fn) {
-      return {
-        files: source.files.map(
-          (file) => file.type === "page" ? fn(file) : file
-        )
-      };
+      for (let i = 0; i < source2.files.length; i++) {
+        const file = source2.files[i];
+        if (file.type === "page") source2.files[i] = fn(file);
+      }
+      return this;
     },
     meta(fn) {
-      return {
-        files: source.files.map(
-          (file) => file.type === "meta" ? fn(file) : file
-        )
-      };
+      for (let i = 0; i < source2.files.length; i++) {
+        const file = source2.files[i];
+        if (file.type === "meta") source2.files[i] = fn(file);
+      }
+      return this;
+    },
+    build() {
+      return source2;
     }
   };
 }
@@ -69,22 +81,22 @@ var FileSystem = class {
       this.folders.set("", []);
     }
   }
-  read(path) {
-    return this.files.get(path);
+  read(path2) {
+    return this.files.get(path2);
   }
   /**
    * get the direct children of folder (in virtual file path)
    */
-  readDir(path) {
-    return this.folders.get(path);
+  readDir(path2) {
+    return this.folders.get(path2);
   }
-  write(path, file) {
-    if (!this.files.has(path)) {
-      const dir = dirname(path);
+  write(path2, file) {
+    if (!this.files.has(path2)) {
+      const dir = dirname(path2);
       this.makeDir(dir);
-      this.readDir(dir)?.push(path);
+      this.readDir(dir)?.push(path2);
     }
-    this.files.set(path, file);
+    this.files.set(path2, file);
   }
   /**
    * Delete files at specified path.
@@ -92,12 +104,12 @@ var FileSystem = class {
    * @param path - the target path.
    * @param [recursive=false] - if set to `true`, it will also delete directories.
    */
-  delete(path, recursive = false) {
-    if (this.files.delete(path)) return true;
+  delete(path2, recursive = false) {
+    if (this.files.delete(path2)) return true;
     if (recursive) {
-      const folder = this.folders.get(path);
+      const folder = this.folders.get(path2);
       if (!folder) return false;
-      this.folders.delete(path);
+      this.folders.delete(path2);
       for (const child of folder) {
         this.delete(child);
       }
@@ -108,8 +120,8 @@ var FileSystem = class {
   getFiles() {
     return Array.from(this.files.keys());
   }
-  makeDir(path) {
-    const segments = splitPath(path);
+  makeDir(path2) {
+    const segments = splitPath(path2);
     for (let i = 0; i < segments.length; i++) {
       const segment = segments.slice(0, i + 1).join("/");
       if (this.folders.has(segment)) continue;
@@ -124,28 +136,28 @@ function isLocaleValid(locale) {
   return locale.length > 0 && !/\d+/.test(locale);
 }
 var parsers = {
-  dir(path) {
-    const [locale, ...segs] = path.split("/");
+  dir(path2) {
+    const [locale, ...segs] = path2.split("/");
     if (locale && segs.length > 0 && isLocaleValid(locale))
       return [segs.join("/"), locale];
-    return [path];
+    return [path2];
   },
-  dot(path) {
-    const dir = dirname(path);
-    const base = basename(path);
+  dot(path2) {
+    const dir = dirname(path2);
+    const base = basename(path2);
     const parts = base.split(".");
-    if (parts.length < 3) return [path];
+    if (parts.length < 3) return [path2];
     const [locale] = parts.splice(parts.length - 2, 1);
-    if (!isLocaleValid(locale)) return [path];
+    if (!isLocaleValid(locale)) return [path2];
     return [joinPath(dir, parts.join(".")), locale];
   },
-  none(path) {
-    return [path];
+  none(path2) {
+    return [path2];
   }
 };
 function buildContentStorage(loaderConfig, defaultLanguage) {
   const {
-    source,
+    source: source2,
     plugins = [],
     i18n = {
       defaultLanguage,
@@ -156,7 +168,7 @@ function buildContentStorage(loaderConfig, defaultLanguage) {
   const parser = parsers[i18n.parser ?? "dot"];
   const storages = {};
   const normalized = /* @__PURE__ */ new Map();
-  for (const inputFile of source.files) {
+  for (const inputFile of source2.files) {
     let file;
     if (inputFile.type === "page") {
       file = {
@@ -209,8 +221,8 @@ function buildContentStorage(loaderConfig, defaultLanguage) {
   for (const lang of i18n.languages) scan(lang);
   return storages;
 }
-function normalizePath(path) {
-  const segments = splitPath(slash(path));
+function normalizePath(path2) {
+  const segments = splitPath(slash(path2));
   if (segments[0] === "." || segments[0] === "..")
     throw new Error("It must not start with './' or '../'");
   return segments.join("/");
@@ -298,15 +310,15 @@ function createPageTreeBuilder(loaderConfig) {
   };
 }
 function createFlattenPathResolver(storage) {
-  const map2 = /* @__PURE__ */ new Map();
+  const map = /* @__PURE__ */ new Map();
   const files = storage.getFiles();
   for (const file of files) {
     const content = storage.read(file);
     const flattenPath = file.substring(0, file.length - extname(file).length);
-    map2.set(flattenPath + "." + content.format, file);
+    map.set(flattenPath + "." + content.format, file);
   }
   return (name, format) => {
-    return map2.get(name + "." + format) ?? name;
+    return map.get(name + "." + format) ?? name;
   };
 }
 function createPageTreeBuilderUtils(ctx) {
@@ -322,15 +334,15 @@ function createPageTreeBuilderUtils(ctx) {
       const sortedPaths = paths.sort(
         (a, b) => a.localeCompare(b) * (reversed ? -1 : 1)
       );
-      for (const path of sortedPaths) {
-        const fileNode = this.file(path);
+      for (const path2 of sortedPaths) {
+        const fileNode = this.file(path2);
         if (fileNode) {
-          if (basename(path, extname(path)) === "index")
+          if (basename(path2, extname(path2)) === "index")
             items.unshift(fileNode);
           else items.push(fileNode);
           continue;
         }
-        const dirNode = this.folder(path, false);
+        const dirNode = this.folder(path2, false);
         if (dirNode) folders.push(dirNode);
       }
       items.push(...folders);
@@ -377,16 +389,16 @@ function createPageTreeBuilderUtils(ctx) {
       } else if (isExtract) {
         filename = item.slice(extractPrefix.length);
       }
-      const path = resolveFlattenPath(joinPath(folderPath, filename), "page");
+      const path2 = resolveFlattenPath(joinPath(folderPath, filename), "page");
       if (isExcept) {
-        visitedPaths.add(path);
+        visitedPaths.add(path2);
         return [];
       }
-      const dirNode = this.folder(path, false);
+      const dirNode = this.folder(path2, false);
       if (dirNode) {
         return isExtract ? dirNode.children : [dirNode];
       }
-      const fileNode = this.file(path);
+      const fileNode = this.file(path2);
       return fileNode ? [fileNode] : [];
     },
     folder(folderPath, isGlobalRoot) {
@@ -453,26 +465,26 @@ function createPageTreeBuilderUtils(ctx) {
       }
       return node;
     },
-    file(path) {
+    file(path2) {
       const { options, getUrl, storage, locale, transformers } = ctx;
-      const page = storage.read(path);
+      const page = storage.read(path2);
       if (page?.format !== "page") return;
       const { title, description, icon } = page.data;
       let item = {
-        $id: nextNodeId(path),
+        $id: nextNodeId(path2),
         type: "page",
-        name: title ?? pathToName(basename(path, extname(path))),
+        name: title ?? pathToName(basename(path2, extname(path2))),
         description,
         icon,
         url: getUrl(page.slugs, locale),
         $ref: !options.noRef ? {
-          file: path
+          file: path2
         } : void 0
       };
-      visitedPaths.add(path);
+      visitedPaths.add(path2);
       for (const transformer of transformers) {
         if (!transformer.file) continue;
-        item = transformer.file.call(ctx, item, path);
+        item = transformer.file.call(ctx, item, path2);
       }
       return item;
     },
@@ -531,22 +543,22 @@ function slugsPlugin(slugsFn) {
       const indexFiles = /* @__PURE__ */ new Set();
       const taken = /* @__PURE__ */ new Set();
       const autoIndex = slugsFn === void 0;
-      for (const path of storage.getFiles()) {
-        const file = storage.read(path);
+      for (const path2 of storage.getFiles()) {
+        const file = storage.read(path2);
         if (!file || file.format !== "page" || file.slugs) continue;
-        if (isIndex(path) && autoIndex) {
-          indexFiles.add(path);
+        if (isIndex(path2) && autoIndex) {
+          indexFiles.add(path2);
           continue;
         }
-        file.slugs = slugsFn ? slugsFn({ path }) : getSlugs(path);
+        file.slugs = slugsFn ? slugsFn({ path: path2 }) : getSlugs(path2);
         const key = file.slugs.join("/");
         if (taken.has(key)) throw new Error("Duplicated slugs");
         taken.add(key);
       }
-      for (const path of indexFiles) {
-        const file = storage.read(path);
+      for (const path2 of indexFiles) {
+        const file = storage.read(path2);
         if (file?.format !== "page") continue;
-        file.slugs = getSlugs(path);
+        file.slugs = getSlugs(path2);
         if (taken.has(file.slugs.join("/"))) file.slugs.push("index");
       }
     }
@@ -569,6 +581,7 @@ function getSlugs(file) {
 }
 
 // src/source/loader.ts
+import path from "path";
 function indexPages(storages, { url }) {
   const result = {
     // (locale.slugs -> page)
@@ -581,9 +594,9 @@ function indexPages(storages, { url }) {
   for (const [lang, storage] of Object.entries(storages)) {
     for (const filePath of storage.getFiles()) {
       const item = storage.read(filePath);
-      const path = `${lang}.${filePath}`;
+      const path2 = `${lang}.${filePath}`;
       if (item.format === "meta") {
-        result.pathToMeta.set(path, {
+        result.pathToMeta.set(path2, {
           path: item.path,
           absolutePath: item.absolutePath,
           data: item.data
@@ -598,7 +611,7 @@ function indexPages(storages, { url }) {
         data: item.data,
         locale: lang
       };
-      result.pathToPage.set(path, page);
+      result.pathToPage.set(path2, page);
       result.pages.set(`${lang}.${page.slugs.join("/")}`, page);
     }
   }
@@ -647,9 +660,9 @@ function loader(...args) {
     getPageByHref(href, { dir = "", language = defaultLanguage } = {}) {
       const [value, hash] = href.split("#", 2);
       let target;
-      if (value.startsWith(".") && (value.endsWith(".md") || value.endsWith(".mdx"))) {
-        const path = joinPath(dir, value);
-        target = walker.pathToPage.get(`${language}.${path}`);
+      if (value.startsWith("./")) {
+        const path2 = joinPath(dir, value);
+        target = walker.pathToPage.get(`${language}.${path2}`);
       } else {
         target = this.getPages(language).find((item) => item.url === value);
       }
@@ -659,6 +672,18 @@ function loader(...args) {
           hash
         };
     },
+    resolveHref(href, parent) {
+      if (href.startsWith("./")) {
+        const target = this.getPageByHref(href, {
+          dir: path.dirname(parent.path),
+          language: parent.locale
+        });
+        if (target) {
+          return target.hash ? `${target.page.url}#${target.hash}` : target.page.url;
+        }
+      }
+      return href;
+    },
     getPages(language) {
       const pages = [];
       for (const [key, value] of walker.pages.entries()) {
@@ -733,11 +758,11 @@ function loader(...args) {
     }
   };
 }
-function resolveConfig(source, { slugs, icon, plugins = [], baseUrl, url, ...base }) {
+function resolveConfig(source2, { slugs, icon, plugins = [], baseUrl, url, ...base }) {
   let config = {
     ...base,
     url: url ? (...args) => normalizeUrl(url(...args)) : createGetUrl(baseUrl, base.i18n),
-    source,
+    source: source2,
     plugins: buildPlugins([
       slugsPlugin(slugs),
       icon && iconPlugin(icon),
@@ -758,6 +783,7 @@ export {
   createGetUrl,
   getSlugs,
   loader,
-  map,
-  multiple
+  multiple,
+  source,
+  update
 };

package/dist/source/plugins/lucide-icons.d.ts

@@ -1,4 +1,4 @@
-import { L as LoaderPlugin } from '../../loader-qkSHi822.js';
+import { L as LoaderPlugin } from '../../loader-_E2HOdV0.js';
 import { icons } from 'lucide-react';
 import '../../definitions-pJ7PybYY.js';
 import 'react';

package/dist/util-bZU2QeJ2.d.ts

@@ -0,0 +1,6 @@
+import { Pluggable } from 'unified';
+
+type Thenable<T> = T | PromiseLike<T>;
+type ResolvePlugins = Thenable<Pluggable>[] | ((v: Pluggable[]) => Thenable<Pluggable>[]);
+
+export type { ResolvePlugins as R };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-core",
-  "version": "16.2.4",
+  "version": "16.3.0",
   "description": "The React.js library for building a documentation website",
   "keywords": [
     "Fumadocs",
@@ -111,8 +111,8 @@
   "dependencies": {
     "@formatjs/intl-localematcher": "^0.6.2",
     "@orama/orama": "^3.1.16",
-    "@shikijs/rehype": "^3.19.0",
-    "@shikijs/transformers": "^3.19.0",
+    "@shikijs/rehype": "^3.20.0",
+    "@shikijs/transformers": "^3.20.0",
     "estree-util-value-to-estree": "^3.5.0",
     "github-slugger": "^2.0.0",
     "hast-util-to-estree": "^3.1.3",
@@ -125,14 +125,14 @@
     "remark-gfm": "^4.0.1",
     "remark-rehype": "^11.1.2",
     "scroll-into-view-if-needed": "^3.1.0",
-    "shiki": "^3.19.0",
+    "shiki": "^3.20.0",
     "unist-util-visit": "^5.0.0"
   },
   "devDependencies": {
     "@mdx-js/mdx": "^3.1.1",
     "@mixedbread/sdk": "^0.46.0",
-    "@orama/core": "^1.2.13",
-    "@tanstack/react-router": "1.140.0",
+    "@orama/core": "^1.2.14",
+    "@tanstack/react-router": "1.136.18",
     "@types/estree-jsx": "^1.0.5",
     "@types/hast": "^3.0.4",
     "@types/mdast": "^4.0.4",
@@ -141,10 +141,10 @@
     "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",
     "algoliasearch": "5.46.0",
-    "lucide-react": "^0.556.0",
+    "lucide-react": "^0.561.0",
     "mdast-util-mdx-jsx": "^3.2.0",
     "mdast-util-mdxjs-esm": "^2.0.1",
-    "next": "16.0.8",
+    "next": "16.0.10",
     "react-router": "^7.10.1",
     "remark-directive": "^4.0.0",
     "remark-mdx": "^3.1.1",
@@ -152,10 +152,10 @@
     "typescript": "^5.9.3",
     "unified": "^11.0.5",
     "vfile": "^6.0.3",
-    "waku": "^0.27.3",
+    "waku": "^0.27.4",
     "zod": "^4.1.13",
-    "eslint-config-custom": "0.0.0",
-    "tsconfig": "0.0.0"
+    "tsconfig": "0.0.0",
+    "eslint-config-custom": "0.0.0"
   },
   "peerDependencies": {
     "@mixedbread/sdk": "^0.19.0",