fumadocs-core 16.2.5 → 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-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/{loader-BvlPPJX0.d.ts → loader-_E2HOdV0.d.ts}

@@ -251,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;
         /**
@@ -261,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
      */

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 { f as LoaderOutput, b as LoaderConfig, I as InferPageType } from '../loader-BvlPPJX0.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, 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-BvlPPJX0.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,7 +15,7 @@ import {
 } from "../chunk-PFNP6PEB.js";
 import {
   visit
-} from "../chunk-XKUN7AUK.js";
+} from "../chunk-L4JKQWCM.js";
 import "../chunk-U67V476Y.js";
 
 // src/source/source.ts
@@ -81,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.
@@ -104,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);
       }
@@ -120,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;
@@ -136,23 +136,23 @@ 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) {
@@ -221,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("/");
@@ -334,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);
@@ -389,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) {
@@ -465,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;
     },
@@ -543,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");
       }
     }
@@ -581,6 +581,7 @@ function getSlugs(file) {
 }
 
 // src/source/loader.ts
+import path from "path";
 function indexPages(storages, { url }) {
   const result = {
     // (locale.slugs -> page)
@@ -593,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
@@ -610,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);
     }
   }
@@ -659,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);
       }
@@ -671,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()) {

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-core",
-  "version": "16.2.5",
+  "version": "16.3.0",
   "description": "The React.js library for building a documentation website",
   "keywords": [
     "Fumadocs",
@@ -154,8 +154,8 @@
     "vfile": "^6.0.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",