fumadocs-core 15.5.1 → 15.5.2

package/dist/{algolia-KJKVXZ5Q.js → algolia-NXNLN7TR.js}

@@ -1,5 +1,3 @@
-import "./chunk-MLKGABMK.js";
-
 // src/search/client/algolia.ts
 function groupResults(hits) {
   const grouped = [];

package/dist/breadcrumb.js

@@ -1,5 +1,3 @@
-import "./chunk-MLKGABMK.js";
-
 // src/breadcrumb.tsx
 import { useMemo } from "react";
 function useBreadcrumb(url, tree, options) {

package/dist/chunk-7GNSIKII.js

@@ -0,0 +1,47 @@
+// src/source/path.ts
+function basename(path, ext) {
+  const idx = path.lastIndexOf("/");
+  return path.substring(
+    idx === -1 ? 0 : idx + 1,
+    ext ? path.length - ext.length : path.length
+  );
+}
+function extname(path) {
+  const dotIdx = path.lastIndexOf(".");
+  if (dotIdx !== -1) {
+    return path.substring(dotIdx);
+  }
+  return "";
+}
+function dirname(path) {
+  return path.split("/").slice(0, -1).join("/");
+}
+function parseFilePath(path) {
+  const ext = extname(path);
+  const name = basename(path, ext);
+  const dir = dirname(path);
+  return {
+    dirname: dir,
+    name,
+    ext,
+    path,
+    get flattenedPath() {
+      return [dir, name].filter((p) => p.length > 0).join("/");
+    }
+  };
+}
+function parseFolderPath(path) {
+  return {
+    dirname: dirname(path),
+    name: basename(path),
+    path
+  };
+}
+
+export {
+  basename,
+  extname,
+  dirname,
+  parseFilePath,
+  parseFolderPath
+};

package/dist/content/index.js

@@ -1,5 +1,3 @@
-import "../chunk-MLKGABMK.js";
-
 // src/content/index.ts
 import { remark } from "remark";
 import remarkGfm from "remark-gfm";

package/dist/dynamic-link.js

@@ -5,7 +5,6 @@ import {
 import {
   useParams
 } from "./chunk-BBP7MIO4.js";
-import "./chunk-MLKGABMK.js";
 
 // src/dynamic-link.tsx
 import { forwardRef, useMemo } from "react";

package/dist/{fetch-M245YYDD.js → fetch-ZSD7GUCX.js}

@@ -1,5 +1,3 @@
-import "./chunk-MLKGABMK.js";
-
 // src/search/client/fetch.ts
 var cache = /* @__PURE__ */ new Map();
 async function fetchDocs(query, { api = "/api/search", locale, tag }) {

package/dist/framework/index.js

@@ -8,7 +8,6 @@ import {
   usePathname,
   useRouter
 } from "../chunk-BBP7MIO4.js";
-import "../chunk-MLKGABMK.js";
 export {
   FrameworkProvider,
   Image,

package/dist/framework/next.js

@@ -2,7 +2,6 @@
 import {
   FrameworkProvider
 } from "../chunk-BBP7MIO4.js";
-import "../chunk-MLKGABMK.js";
 
 // src/framework/next.tsx
 import { useParams, usePathname, useRouter } from "next/navigation";

package/dist/framework/react-router.js

@@ -1,7 +1,6 @@
 import {
   FrameworkProvider
 } from "../chunk-BBP7MIO4.js";
-import "../chunk-MLKGABMK.js";
 
 // src/framework/react-router.tsx
 import { useMemo } from "react";

package/dist/framework/tanstack.js

@@ -1,7 +1,6 @@
 import {
   FrameworkProvider
 } from "../chunk-BBP7MIO4.js";
-import "../chunk-MLKGABMK.js";
 
 // src/framework/tanstack.tsx
 import { useMemo } from "react";

package/dist/hide-if-empty.d.ts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import react__default from 'react';
+import { ReactNode } from 'react';
 
 /**
  * The built-in CSS `:empty` selector cannot detect if the children is hidden, classes such as `md:hidden` causes it to fail.
@@ -8,7 +8,7 @@ import react__default from 'react';
  * This can be expensive, please avoid this whenever possible.
  */
 declare function HideIfEmpty({ children }: {
-    children: react__default.ReactNode;
+    children: ReactNode;
 }): react_jsx_runtime.JSX.Element;
 
 export { HideIfEmpty };

package/dist/hide-if-empty.js

@@ -1,5 +1,4 @@
 "use client";
-import "./chunk-MLKGABMK.js";
 
 // src/hide-if-empty.tsx
 import React from "react";

package/dist/highlight/client.js

@@ -4,7 +4,6 @@ import {
   _renderHighlight,
   highlight
 } from "../chunk-KNWSJ4IF.js";
-import "../chunk-MLKGABMK.js";
 
 // src/highlight/client.tsx
 import {

package/dist/highlight/index.js

@@ -2,7 +2,6 @@ import {
   getHighlighter,
   highlight
 } from "../chunk-KNWSJ4IF.js";
-import "../chunk-MLKGABMK.js";
 export {
   getHighlighter,
   highlight

package/dist/i18n/index.js

@@ -1,5 +1,3 @@
-import "../chunk-MLKGABMK.js";
-
 // src/i18n/middleware.ts
 import { match as matchLocale } from "@formatjs/intl-localematcher";
 import Negotiator from "negotiator";

package/dist/link.js

@@ -3,7 +3,6 @@ import {
   Link
 } from "./chunk-5SU2O5AS.js";
 import "./chunk-BBP7MIO4.js";
-import "./chunk-MLKGABMK.js";
 export {
   Link as default
 };

package/dist/mdx-plugins/index.js

@@ -10,7 +10,6 @@ import {
   defaultThemes,
   getHighlighter
 } from "../chunk-KNWSJ4IF.js";
-import "../chunk-MLKGABMK.js";
 
 // src/mdx-plugins/index.ts
 import {

package/dist/{orama-cloud-SBXZAVQC.js → orama-cloud-I4WBDIAI.js}

@@ -1,7 +1,6 @@
 import {
   removeUndefined
 } from "./chunk-KAOEMCTI.js";
-import "./chunk-MLKGABMK.js";
 
 // src/search/client/orama-cloud.ts
 async function searchDocs(query, options) {

package/dist/search/algolia.js

@@ -1,5 +1,3 @@
-import "../chunk-MLKGABMK.js";
-
 // src/search/algolia.ts
 async function sync(client, options) {
   const { document = "document", indexName = document, documents } = options;

package/dist/search/client.js

@@ -1,7 +1,6 @@
 import {
   useOnChange
 } from "../chunk-EMWGTXSW.js";
-import "../chunk-MLKGABMK.js";
 
 // src/search/client.ts
 import { useRef as useRef2, useState as useState2 } from "react";
@@ -65,19 +64,19 @@ function useDocsSearch(clientOptions, _locale, _tag, _delayMs = 100, _allowEmpty
       async function run() {
         if (debouncedValue.length === 0 && !allowEmpty) return "empty";
         if (client.type === "fetch") {
-          const { fetchDocs } = await import("../fetch-M245YYDD.js");
+          const { fetchDocs } = await import("../fetch-ZSD7GUCX.js");
           return fetchDocs(debouncedValue, client);
         }
         if (client.type === "algolia") {
-          const { searchDocs } = await import("../algolia-KJKVXZ5Q.js");
+          const { searchDocs } = await import("../algolia-NXNLN7TR.js");
           return searchDocs(debouncedValue, client);
         }
         if (client.type === "orama-cloud") {
-          const { searchDocs } = await import("../orama-cloud-SBXZAVQC.js");
+          const { searchDocs } = await import("../orama-cloud-I4WBDIAI.js");
           return searchDocs(debouncedValue, client);
         }
         if (client.type === "static") {
-          const { search: search2 } = await import("../static-IM4OAJFY.js");
+          const { search: search2 } = await import("../static-QTPM5MZT.js");
           return search2(debouncedValue, client);
         }
         throw new Error("unknown search client");

package/dist/search/orama-cloud.js

@@ -1,5 +1,3 @@
-import "../chunk-MLKGABMK.js";
-
 // src/search/orama-cloud.ts
 async function sync(cloudManager, options) {
   const { autoDeploy = true } = options;

package/dist/search/server.js

@@ -3,7 +3,10 @@ import {
   searchSimple
 } from "../chunk-WFUH5VBX.js";
 import "../chunk-KAOEMCTI.js";
-import "../chunk-MLKGABMK.js";
+import {
+  basename,
+  extname
+} from "../chunk-7GNSIKII.js";
 
 // src/search/server.ts
 import {
@@ -150,7 +153,7 @@ function pageToIndex(page) {
   }
   const structuredData = page.data.structuredData;
   return {
-    title: page.data.title ?? page.file.name,
+    title: page.data.title ?? basename(page.path, extname(page.path)),
     description: "description" in page.data ? page.data.description : void 0,
     url: page.url,
     id: page.url,

package/dist/server/index.js

@@ -1,7 +1,6 @@
 import {
   remarkHeading
 } from "../chunk-Y2774T3B.js";
-import "../chunk-MLKGABMK.js";
 
 // src/server/get-toc.ts
 import { remark } from "remark";

package/dist/sidebar.js

@@ -2,7 +2,6 @@
 import {
   useMediaQuery
 } from "./chunk-EP5LHGDZ.js";
-import "./chunk-MLKGABMK.js";
 
 // src/sidebar.tsx
 import {

package/dist/source/index.d.ts

@@ -1,8 +1,48 @@
 import { ReactElement } from 'react';
 import { I18nConfig } from '../i18n/index.js';
-import { R as Root, I as Item, F as Folder$1, S as Separator } from '../page-tree-bSt6K__E.js';
+import { R as Root, I as Item, F as Folder, S as Separator } from '../page-tree-bSt6K__E.js';
 import 'next/dist/server/web/types';
 
+/**
+ * In memory file system.
+ */
+declare class FileSystem<File> {
+    files: Map<string, File>;
+    folders: Map<string, string[]>;
+    constructor();
+    read(path: string): File | undefined;
+    /**
+     * get the direct children of folder (in virtual file path)
+     */
+    readDir(path: string): string[] | undefined;
+    write(path: string, file: File): void;
+    getFiles(): string[];
+    makeDir(path: string): void;
+}
+
+interface LoadOptions {
+    transformers?: Transformer[];
+}
+type ContentStorage = FileSystem<MetaFile | PageFile>;
+interface MetaFile<Data extends MetaData = MetaData> {
+    path: string;
+    absolutePath: string;
+    format: 'meta';
+    data: Data;
+}
+interface PageFile<Data extends PageData = PageData> {
+    path: string;
+    absolutePath: string;
+    format: 'page';
+    slugs: string[];
+    data: Data;
+}
+type Transformer = (context: {
+    storage: ContentStorage;
+    options: LoadOptions;
+}) => void;
+declare function loadFiles(files: VirtualFile[], buildFile: (file: VirtualFile) => MetaFile | PageFile, options: LoadOptions): ContentStorage;
+
 interface FileInfo {
     /**
      * File path without extension
@@ -38,32 +78,11 @@ interface FolderInfo {
     dirname: string;
 }
 declare function parseFilePath(path: string): FileInfo;
+/**
+ * @deprecated use `dirname` and `basename` directly.
+ */
 declare function parseFolderPath(path: string): FolderInfo;
 
-interface LoadOptions {
-    transformers?: Transformer[];
-    getSlugs: (info: FileInfo) => string[];
-}
-interface VirtualFile {
-    /**
-     * Relative path
-     *
-     * @example `docs/page.mdx`
-     */
-    path: string;
-    type: 'page' | 'meta';
-    /**
-     * Specified Slugs for page
-     */
-    slugs?: string[];
-    data: unknown;
-}
-type Transformer = (context: {
-    storage: Storage;
-    options: LoadOptions;
-}) => void;
-declare function loadFiles<O extends LoadOptions>(files: VirtualFile[], options: O): Storage;
-
 interface LoaderConfig {
     source: SourceConfig;
     i18n: boolean;
@@ -74,15 +93,15 @@ interface SourceConfig {
 }
 interface LoaderOptions<T extends SourceConfig = SourceConfig, I18n extends I18nConfig | undefined = I18nConfig | undefined> {
     baseUrl: string;
-    icon?: NonNullable<BaseOptions['resolveIcon']>;
-    slugs?: LoadOptions['getSlugs'];
+    icon?: NonNullable<BuildPageTreeOptions['resolveIcon']>;
+    slugs?: (info: FileInfo) => string[];
     url?: UrlFn;
     source: Source<T>;
     transformers?: Transformer[];
     /**
      * Additional options for page tree builder
      */
-    pageTree?: Partial<BaseOptions<T['pageData'], T['metaData']>>;
+    pageTree?: Partial<Omit<BuildPageTreeOptions<T['pageData'], T['metaData']>, 'storage'>>;
     /**
      * Configure i18n
      */
@@ -95,21 +114,49 @@ interface Source<Config extends SourceConfig> {
     _config?: Config;
     files: VirtualFile[] | (() => VirtualFile[]);
 }
-interface Page<Data = PageData> {
+interface SharedFileInfo {
     /**
-     * Virtualized file path
+     * Virtualized file path (parsed)
+     *
+     * @deprecated Use `path` instead.
      */
     file: FileInfo;
+    /**
+     * Virtualized file path (relative to content directory)
+     *
+     * @example `docs/page.mdx`
+     */
+    path: string;
+    /**
+     * Absolute path of the file
+     */
+    absolutePath: string;
+}
+interface VirtualFile {
+    /**
+     * Virtualized path (relative to content directory)
+     *
+     * @example `docs/page.mdx`
+     */
+    path: string;
+    /**
+     * Absolute path of the file
+     */
+    absolutePath?: string;
+    type: 'page' | 'meta';
+    /**
+     * Specified Slugs for page
+     */
+    slugs?: string[];
+    data: unknown;
+}
+interface Page<Data = PageData> extends SharedFileInfo {
     slugs: string[];
     url: string;
     data: Data;
     locale?: string | undefined;
 }
-interface Meta<Data = MetaData> {
-    /**
-     * Virtualized file path
-     */
-    file: FileInfo;
+interface Meta<Data = MetaData> extends SharedFileInfo {
     data: Data;
 }
 interface LanguageEntry<Data = PageData> {
@@ -144,7 +191,7 @@ interface LoaderOutput<Config extends LoaderConfig> {
      */
     getPage: (slugs: string[] | undefined, language?: string) => Page<Config['source']['pageData']> | undefined;
     getNodePage: (node: Item, language?: string) => Page<Config['source']['pageData']> | undefined;
-    getNodeMeta: (node: Folder$1, language?: string) => Meta<Config['source']['metaData']> | undefined;
+    getNodeMeta: (node: Folder, language?: string) => Meta<Config['source']['metaData']> | undefined;
     /**
      * generate static params for Next.js SSG
      *
@@ -183,59 +230,6 @@ type InferMetaType<Utils extends LoaderOutput<any>> = Utils extends LoaderOutput
  */
 type UrlFn = (slugs: string[], locale?: string) => string;
 
-interface MetaFile<Data extends MetaData = MetaData> {
-    file: FileInfo;
-    format: 'meta';
-    data: Data;
-}
-interface PageFile<Data extends PageData = PageData> {
-    file: FileInfo;
-    format: 'page';
-    data: {
-        slugs: string[];
-        data: Data;
-    };
-}
-type File = MetaFile | PageFile;
-interface Folder<Page extends PageData = PageData, Meta extends MetaData = MetaData> {
-    file: FolderInfo;
-    children: (MetaFile<Meta> | PageFile<Page> | Folder<Page, Meta>)[];
-}
-/**
- * A virtual file system that solves inconsistent behaviours
- *
- * Some source providers may not provide the full file structure, this will cause inconsistent outputs for page builder and other transformers
- */
-declare class Storage {
-    files: Map<string, File>;
-    folders: Map<string, Folder<PageData, MetaData>>;
-    private rootFolder;
-    constructor();
-    /**
-     * @param path - flattened path
-     * @param format - file format
-     */
-    read<F extends File['format']>(path: string, format: F): Extract<File, {
-        format: F;
-    }> | undefined;
-    readDir(path: string): Folder | undefined;
-    root(): Folder;
-    write<F extends File['format']>(path: string, format: F, data: Extract<File, {
-        format: F;
-    }>['data']): void;
-    list(): File[];
-    makeDir(path: string): void;
-}
-
-type fileSystem_Folder<Page extends PageData = PageData, Meta extends MetaData = MetaData> = Folder<Page, Meta>;
-type fileSystem_MetaFile<Data extends MetaData = MetaData> = MetaFile<Data>;
-type fileSystem_PageFile<Data extends PageData = PageData> = PageFile<Data>;
-type fileSystem_Storage = Storage;
-declare const fileSystem_Storage: typeof Storage;
-declare namespace fileSystem {
-  export { type fileSystem_Folder as Folder, type fileSystem_MetaFile as MetaFile, type fileSystem_PageFile as PageFile, fileSystem_Storage as Storage };
-}
-
 interface BaseOptions<Page extends PageData = PageData, Meta extends MetaData = MetaData> {
     /**
      * Remove references to the file path of original nodes (`$ref`)
@@ -244,15 +238,17 @@ interface BaseOptions<Page extends PageData = PageData, Meta extends MetaData =
      */
     noRef?: boolean;
     attachFile?: (node: Item, file?: PageFile<Page>) => Item;
-    attachFolder?: (node: Folder$1, folder: Folder<Page, Meta>, meta?: MetaFile<Meta>) => Folder$1;
+    attachFolder?: (node: Folder, folder: {
+        children: (PageFile<Page> | MetaFile<Meta>)[];
+    }, meta?: MetaFile<Meta>) => Folder;
     attachSeparator?: (node: Separator) => Separator;
     resolveIcon?: (icon: string | undefined) => ReactElement | undefined;
 }
-interface BuildPageTreeOptions extends BaseOptions {
-    storage: Storage;
+interface BuildPageTreeOptions<Page extends PageData = PageData, Meta extends MetaData = MetaData> extends BaseOptions<Page, Meta> {
+    storage: ContentStorage;
 }
-interface BuildPageTreeOptionsWithI18n extends BaseOptions {
-    storages: Record<string, Storage>;
+interface BuildPageTreeOptionsWithI18n<Page extends PageData = PageData, Meta extends MetaData = MetaData> extends BaseOptions<Page, Meta> {
+    storages: Record<string, ContentStorage>;
     i18n: I18nConfig;
 }
 interface PageTreeBuilder {
@@ -264,4 +260,4 @@ interface PageTreeBuilder {
 }
 declare function createPageTreeBuilder(getUrl: UrlFn): PageTreeBuilder;
 
-export { type BaseOptions, type BuildPageTreeOptions, type BuildPageTreeOptionsWithI18n, type FileInfo, fileSystem as FileSystem, type FolderInfo, type InferMetaType, type InferPageType, type LanguageEntry, type LoadOptions, type LoaderConfig, type LoaderOptions, type LoaderOutput, type Meta, type MetaData, type Page, type PageData, type PageTreeBuilder, type Source, type SourceConfig, type Transformer, type UrlFn, type VirtualFile, createGetUrl, createPageTreeBuilder, getSlugs, loadFiles, loader, parseFilePath, parseFolderPath };
+export { type BuildPageTreeOptions, type BuildPageTreeOptionsWithI18n, type ContentStorage, type FileInfo, FileSystem, type FolderInfo, type InferMetaType, type InferPageType, type LanguageEntry, type LoadOptions, type LoaderConfig, type LoaderOptions, type LoaderOutput, type Meta, type MetaData, type MetaFile, type Page, type PageData, type PageFile, type PageTreeBuilder, type Source, type SourceConfig, type Transformer, type UrlFn, type VirtualFile, createGetUrl, createPageTreeBuilder, getSlugs, loadFiles, loader, parseFilePath, parseFolderPath };

package/dist/source/index.js

@@ -1,11 +1,15 @@
+import {
+  basename,
+  dirname,
+  extname,
+  parseFilePath,
+  parseFolderPath
+} from "../chunk-7GNSIKII.js";
 import {
   joinPath,
   slash,
   splitPath
 } from "../chunk-3JSIVMCJ.js";
-import {
-  __export
-} from "../chunk-MLKGABMK.js";
 
 // src/source/page-tree-builder.ts
 var group = /^\((?<name>.+)\)$/;
@@ -15,44 +19,30 @@ var rest = "...";
 var restReversed = "z...a";
 var extractPrefix = "...";
 var excludePrefix = "!";
-function isPageFile(node) {
-  return "data" in node && node.format === "page";
-}
-function buildAll(nodes, ctx, filter, reversed = false) {
-  const { localeStorage } = ctx;
+function buildAll(paths, ctx, filter, reversed = false) {
   const output = [];
-  for (const node of [...nodes].sort((a, b) => {
-    let result;
-    if (isPageFile(a) && "children" in b) result = -1;
-    else if ("children" in a && isPageFile(b)) result = 1;
-    else result = a.file.name.localeCompare(b.file.name);
-    return reversed ? result * -1 : result;
-  })) {
-    if (filter && !filter(node)) continue;
-    if (isPageFile(node)) {
-      const localized = localeStorage?.read(
-        joinPath(node.file.dirname, node.file.name),
-        "page"
-      );
-      const treeNode = buildFileNode(localized ?? node, ctx);
-      if (node.file.name === "index") {
-        output.unshift(treeNode);
-        continue;
-      }
-      output.push(treeNode);
-    } else if ("children" in node) {
-      output.push(buildFolderNode(node, false, ctx));
-    }
+  const sortedPaths = (filter ? paths.filter(filter) : [...paths]).sort(
+    (a, b) => a.localeCompare(b) * (reversed ? -1 : 1)
+  );
+  for (const path of sortedPaths) {
+    const fileNode = buildFileNode(path, ctx);
+    if (!fileNode) continue;
+    if (basename(path, extname(path)) === "index") output.unshift(fileNode);
+    else output.push(fileNode);
+  }
+  for (const dir of sortedPaths) {
+    const dirNode = buildFolderNode(dir, false, ctx);
+    if (dirNode) output.push(dirNode);
   }
   return output;
 }
-function resolveFolderItem(folder, item, ctx, idx, addedNodePaths) {
+function resolveFolderItem(folderPath, item, ctx, idx, restNodePaths) {
   if (item === rest || item === restReversed) return item;
-  const { options, storage, localeStorage } = ctx;
+  const { options, resolveName } = ctx;
   let match = separator.exec(item);
   if (match?.groups) {
     const node = {
-      $id: `${folder.file.path}#${idx}`,
+      $id: `${folderPath}#${idx}`,
       type: "separator",
       icon: options.resolveIcon?.(match.groups.icon),
       name: match.groups.name
@@ -80,93 +70,101 @@ function resolveFolderItem(folder, item, ctx, idx, addedNodePaths) {
   } else if (isExtract) {
     filename = item.slice(extractPrefix.length);
   }
-  const path = joinPath(folder.file.path, filename);
-  const itemNode = storage.readDir(path) ?? localeStorage?.read(path, "page") ?? storage.read(path, "page");
-  if (!itemNode) return [];
-  addedNodePaths.add(itemNode.file.path);
+  const path = resolveName(joinPath(folderPath, filename), "page");
+  restNodePaths.delete(path);
   if (isExcept) return [];
-  if ("children" in itemNode) {
-    const node = buildFolderNode(itemNode, false, ctx);
-    return isExtract ? node.children : [node];
+  const dirNode = buildFolderNode(path, false, ctx);
+  if (dirNode) {
+    return isExtract ? dirNode.children : [dirNode];
   }
-  return [buildFileNode(itemNode, ctx)];
+  const fileNode = buildFileNode(path, ctx);
+  return fileNode ? [fileNode] : [];
 }
-function buildFolderNode(folder, isGlobalRoot, ctx) {
-  const { storage, localeStorage, options } = ctx;
-  const metaPath = joinPath(folder.file.path, "meta");
-  const meta = localeStorage?.read(metaPath, "meta") ?? storage.read(metaPath, "meta");
-  const indexPath = joinPath(folder.file.path, "index");
-  const indexFile = localeStorage?.read(indexPath, "page") ?? storage.read(indexPath, "page");
+function buildFolderNode(folderPath, isGlobalRoot, ctx) {
+  const { storage, localeStorage, options, resolveName } = ctx;
+  const files = storage.readDir(folderPath);
+  if (!files) return;
+  const metaPath = resolveName(joinPath(folderPath, "meta"), "meta");
+  const indexPath = resolveName(joinPath(folderPath, "index"), "page");
+  let meta = localeStorage?.read(metaPath) ?? storage.read(metaPath);
+  if (meta?.format !== "meta") {
+    meta = void 0;
+  }
   const isRoot = meta?.data.root ?? isGlobalRoot;
-  let index;
+  let indexDisabled = false;
   let children;
   if (!meta?.data.pages) {
-    if (indexFile) index = buildFileNode(indexFile, ctx);
-    children = buildAll(folder.children, ctx, (node2) => {
-      return node2.file.name !== "index" || isRoot;
-    });
+    children = buildAll(files, ctx, (file) => isRoot || file !== indexPath);
   } else {
-    const addedNodePaths = /* @__PURE__ */ new Set();
-    const resolved = meta.data.pages.flatMap((item, i) => resolveFolderItem(folder, item, ctx, i, addedNodePaths));
-    if (indexFile && (isRoot || !addedNodePaths.has(indexFile.file.path))) {
-      index = buildFileNode(indexFile, ctx);
+    const restItems = new Set(files);
+    const resolved = meta.data.pages.flatMap((item, i) => resolveFolderItem(folderPath, item, ctx, i, restItems));
+    if (!isRoot && !restItems.has(indexPath)) {
+      indexDisabled = true;
     }
     for (let i = 0; i < resolved.length; i++) {
-      if (resolved[i] === rest || resolved[i] === restReversed) {
-        resolved.splice(
-          i,
-          1,
-          ...buildAll(
-            folder.children,
-            ctx,
-            (node2) => {
-              if (node2.file.name === "index" && !isRoot) return false;
-              return !addedNodePaths.has(node2.file.path);
-            },
-            resolved[i] === restReversed
-          )
-        );
-        break;
-      }
+      const item = resolved[i];
+      if (item !== rest && item !== restReversed) continue;
+      const items = buildAll(
+        files,
+        ctx,
+        // index files are not included in ... unless it's a root folder
+        (file) => (file !== indexPath || isRoot) && restItems.has(file),
+        item === restReversed
+      );
+      resolved.splice(i, 1, ...items);
+      break;
     }
     children = resolved;
   }
+  const index = !indexDisabled ? buildFileNode(indexPath, ctx) : void 0;
+  let name = meta?.data.title ?? index?.name;
+  if (!name) {
+    const folderName = basename(folderPath);
+    name = pathToName(group.exec(folderName)?.[1] ?? folderName);
+  }
   const node = {
     type: "folder",
-    name: meta?.data.title ?? index?.name ?? // resolve folder groups like (group_name)
-    pathToName(group.exec(folder.file.name)?.[1] ?? folder.file.name),
+    name,
     icon: options.resolveIcon?.(meta?.data.icon) ?? index?.icon,
     root: meta?.data.root,
     defaultOpen: meta?.data.defaultOpen,
     description: meta?.data.description,
     index,
     children,
-    $id: folder.file.path,
+    $id: folderPath,
     $ref: !options.noRef && meta ? {
       metaFile: metaPath
     } : void 0
   };
-  return options.attachFolder?.(node, folder, meta) ?? node;
+  return options.attachFolder?.(
+    node,
+    {
+      get children() {
+        return files.flatMap((file) => storage.read(file) ?? []);
+      }
+    },
+    meta
+  ) ?? node;
 }
-function buildFileNode(page, { options, getUrl, locale }) {
-  const file = page.file;
-  const { slugs, data } = page.data;
+function buildFileNode(path, { options, getUrl, storage, localeStorage, locale }) {
+  const page = localeStorage?.read(path) ?? storage.read(path);
+  if (page?.format !== "page") return;
+  const { title, description, icon } = page.data;
   const item = {
-    $id: file.path,
+    $id: path,
     type: "page",
-    name: data.title ?? pathToName(file.name),
-    description: data.description,
-    icon: options.resolveIcon?.(data.icon),
-    url: getUrl(slugs, locale),
+    name: title ?? pathToName(basename(path, extname(path))),
+    description,
+    icon: options.resolveIcon?.(icon),
+    url: getUrl(page.slugs, locale),
     $ref: !options.noRef ? {
-      file: joinPath(file.dirname, file.name)
+      file: path
     } : void 0
   };
   return options.attachFile?.(item, page) ?? item;
 }
 function build(ctx) {
-  const root = ctx.storage.root();
-  const folder = buildFolderNode(root, true, ctx);
+  const folder = buildFolderNode("", true, ctx);
   return {
     $id: ctx.locale ?? "root",
     name: folder.name,
@@ -174,24 +172,45 @@ function build(ctx) {
   };
 }
 function createPageTreeBuilder(getUrl) {
+  function createFlattenPathResolver(storage) {
+    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);
+      map.set(flattenPath + "." + content.format, file);
+    }
+    return (name, format) => {
+      return map.get(name + "." + format);
+    };
+  }
   return {
     build(options) {
+      const resolve = createFlattenPathResolver(options.storage);
       return build({
         options,
         builder: this,
         storage: options.storage,
-        getUrl
+        getUrl,
+        resolveName(name, format) {
+          return resolve(name, format) ?? name;
+        }
       });
     },
     buildI18n({ i18n, ...options }) {
+      const storage = options.storages[i18n.defaultLanguage];
+      const resolve = createFlattenPathResolver(storage);
       const entries = i18n.languages.map((lang) => {
         const tree = build({
           options,
           getUrl,
           builder: this,
           locale: lang,
-          storage: options.storages[i18n.defaultLanguage],
-          localeStorage: options.storages[lang]
+          storage,
+          localeStorage: options.storages[lang],
+          resolveName(name, format) {
+            return resolve(name, format) ?? name;
+          }
         });
         return [lang, tree];
       });
@@ -209,118 +228,49 @@ function pathToName(name) {
   return result.join("");
 }
 
-// src/source/path.ts
-function parseFilePath(path) {
-  const segments = splitPath(slash(path));
-  const dirname = segments.slice(0, -1).join("/");
-  let name = segments.at(-1) ?? "";
-  let ext = "";
-  const dotIdx = name.lastIndexOf(".");
-  if (dotIdx !== -1) {
-    ext = name.substring(dotIdx);
-    name = name.substring(0, dotIdx);
-  }
-  return {
-    dirname,
-    name,
-    path: segments.join("/"),
-    ext,
-    get flattenedPath() {
-      return [dirname, name].filter((p) => p.length > 0).join("/");
-    }
-  };
-}
-function parseFolderPath(path) {
-  const segments = splitPath(slash(path));
-  const base = segments.at(-1) ?? "";
-  return {
-    dirname: segments.slice(0, -1).join("/"),
-    name: base,
-    path: segments.join("/")
-  };
-}
-function normalizePath(path) {
-  const segments = splitPath(slash(path));
-  if (segments[0] === "." || segments[0] === "..")
-    throw new Error("It must not start with './' or '../'");
-  return segments.join("/");
-}
-
 // src/source/file-system.ts
-var file_system_exports = {};
-__export(file_system_exports, {
-  Storage: () => Storage
-});
-var Storage = class {
+var FileSystem = class {
   constructor() {
     this.files = /* @__PURE__ */ new Map();
     this.folders = /* @__PURE__ */ new Map();
-    this.rootFolder = {
-      file: parseFolderPath(""),
-      children: []
-    };
-    this.folders.set("", this.rootFolder);
+    this.folders.set("", []);
+  }
+  read(path) {
+    return this.files.get(path);
   }
   /**
-   * @param path - flattened path
-   * @param format - file format
+   * get the direct children of folder (in virtual file path)
    */
-  read(path, format) {
-    return this.files.get(`${path}.${format}`);
-  }
   readDir(path) {
     return this.folders.get(path);
   }
-  root() {
-    return this.rootFolder;
+  write(path, file) {
+    const dir = dirname(path);
+    this.makeDir(dir);
+    this.readDir(dir)?.push(path);
+    this.files.set(path, file);
   }
-  write(path, format, data) {
-    const node = {
-      format,
-      file: parseFilePath(path),
-      data
-    };
-    this.makeDir(node.file.dirname);
-    this.readDir(node.file.dirname)?.children.push(node);
-    this.files.set(
-      joinPath(node.file.dirname, `${node.file.name}.${node.format}`),
-      node
-    );
-  }
-  list() {
-    return Array.from(this.files.values());
+  getFiles() {
+    return Array.from(this.files.keys());
   }
   makeDir(path) {
     const segments = splitPath(path);
     for (let i = 0; i < segments.length; i++) {
       const segment = segments.slice(0, i + 1).join("/");
       if (this.folders.has(segment)) continue;
-      const folder = {
-        file: parseFolderPath(segment),
-        children: []
-      };
-      this.folders.set(folder.file.path, folder);
-      this.readDir(folder.file.dirname)?.children.push(folder);
+      this.folders.set(segment, []);
+      this.readDir(dirname(segment))?.push(path);
     }
   }
 };
 
 // src/source/load-files.ts
-function loadFiles(files, options) {
+function loadFiles(files, buildFile, options) {
   const { transformers = [] } = options;
-  const storage = new Storage();
+  const storage = new FileSystem();
   for (const file of files) {
     const parsedPath = normalizePath(file.path);
-    if (file.type === "page") {
-      const slugs = file.slugs ?? options.getSlugs(parseFilePath(parsedPath));
-      storage.write(parsedPath, file.type, {
-        slugs,
-        data: file.data
-      });
-    }
-    if (file.type === "meta") {
-      storage.write(parsedPath, file.type, file.data);
-    }
+    storage.write(parsedPath, buildFile(file));
   }
   for (const transformer of transformers) {
     transformer({
@@ -330,7 +280,7 @@ function loadFiles(files, options) {
   }
   return storage;
 }
-function loadFilesI18n(files, options) {
+function loadFilesI18n(files, buildFile, options) {
   const parser = options.i18n.parser === "dir" ? dirParser : dotParser;
   const storages = {};
   for (const lang of options.i18n.languages) {
@@ -345,6 +295,7 @@ function loadFilesI18n(files, options) {
         }
         return [];
       }),
+      buildFile,
       options
     );
   }
@@ -368,39 +319,56 @@ function dotParser(path) {
   }
   return [path];
 }
+function normalizePath(path) {
+  const segments = splitPath(slash(path));
+  if (segments[0] === "." || segments[0] === "..")
+    throw new Error("It must not start with './' or '../'");
+  return segments.join("/");
+}
 
 // src/source/loader.ts
 function indexPages(storages, getUrl, i18n) {
+  const result = {
+    // (locale.slugs -> page)
+    pages: /* @__PURE__ */ new Map(),
+    // (locale.path -> page)
+    pathToMeta: /* @__PURE__ */ new Map(),
+    // (locale.path -> meta)
+    pathToPage: /* @__PURE__ */ new Map()
+  };
   const defaultLanguage = i18n?.defaultLanguage ?? "";
-  const map = /* @__PURE__ */ new Map();
-  const fileMapped = /* @__PURE__ */ new WeakMap();
-  for (const item of storages[defaultLanguage].list()) {
+  for (const filePath of storages[defaultLanguage].getFiles()) {
+    const item = storages[defaultLanguage].read(filePath);
     if (item.format === "meta") {
-      fileMapped.set(item, fileToMeta(item));
+      result.pathToMeta.set(
+        `${defaultLanguage}.${item.path}`,
+        fileToMeta(item)
+      );
     }
     if (item.format === "page") {
       const page = fileToPage(item, getUrl, defaultLanguage);
-      fileMapped.set(item, page);
-      map.set(`${defaultLanguage}.${page.slugs.join("/")}`, page);
+      result.pathToPage.set(`${defaultLanguage}.${item.path}`, page);
+      result.pages.set(`${defaultLanguage}.${page.slugs.join("/")}`, page);
       if (!i18n) continue;
-      const path = joinPath(item.file.dirname, item.file.name);
       for (const lang of i18n.languages) {
         if (lang === defaultLanguage) continue;
-        const localizedItem = storages[lang].read(path, "page");
-        const localizedPage = fileToPage(localizedItem ?? item, getUrl, lang);
+        const localizedItem = storages[lang].read(filePath);
+        const localizedPage = fileToPage(
+          localizedItem?.format === "page" ? localizedItem : item,
+          getUrl,
+          lang
+        );
         if (localizedItem) {
-          fileMapped.set(localizedItem, localizedPage);
+          result.pathToPage.set(`${lang}.${item.path}`, localizedPage);
         }
-        map.set(`${lang}.${localizedPage.slugs.join("/")}`, localizedPage);
+        result.pages.set(
+          `${lang}.${localizedPage.slugs.join("/")}`,
+          localizedPage
+        );
       }
     }
   }
-  return {
-    pages: map,
-    getResultFromFile(file) {
-      return fileMapped.get(file);
-    }
-  };
+  return result;
 }
 function createGetUrl(baseUrl, i18n) {
   const baseSlugs = baseUrl.split("/");
@@ -438,18 +406,31 @@ function createOutput(options) {
   const defaultLanguage = i18n?.defaultLanguage ?? "";
   const getUrl = options.url ?? createGetUrl(options.baseUrl ?? "/", options.i18n);
   const files = typeof source.files === "function" ? source.files() : source.files;
-  const storages = i18n ? loadFilesI18n(files, {
+  function buildFile(file) {
+    if (file.type === "page") {
+      return {
+        format: "page",
+        path: file.path,
+        slugs: file.slugs ?? slugsFn(parseFilePath(file.path)),
+        data: file.data,
+        absolutePath: file.absolutePath ?? ""
+      };
+    }
+    return {
+      format: "meta",
+      path: file.path,
+      absolutePath: file.absolutePath ?? "",
+      data: file.data
+    };
+  }
+  const storages = i18n ? loadFilesI18n(files, buildFile, {
+    ...options,
     i18n: {
       ...i18n,
       parser: i18n.parser ?? "dot"
-    },
-    transformers: options.transformers,
-    getSlugs: slugsFn
+    }
   }) : {
-    "": loadFiles(files, {
-      transformers: options.transformers,
-      getSlugs: slugsFn
-    })
+    "": loadFiles(files, buildFile, options)
   };
   const walker = indexPages(storages, getUrl, i18n);
   const builder = createPageTreeBuilder(getUrl);
@@ -516,14 +497,12 @@ function createOutput(options) {
     getNodeMeta(node, language = defaultLanguage) {
       const ref = node.$ref?.metaFile;
       if (!ref) return;
-      const file = storages[language].read(ref, "meta");
-      if (file) return walker.getResultFromFile(file);
+      return walker.pathToMeta.get(`${language}.${ref}`);
     },
     getNodePage(node, language = defaultLanguage) {
       const ref = node.$ref?.file;
       if (!ref) return;
-      const file = storages[language].read(ref, "page");
-      if (file) return walker.getResultFromFile(file);
+      return walker.pathToPage.get(`${language}.${ref}`);
     },
     getPageTree(locale) {
       if (options.i18n) {
@@ -549,21 +528,29 @@ function createOutput(options) {
 }
 function fileToMeta(file) {
   return {
-    file: file.file,
+    path: file.path,
+    absolutePath: file.absolutePath,
+    get file() {
+      return parseFilePath(this.path);
+    },
     data: file.data
   };
 }
 function fileToPage(file, getUrl, locale) {
   return {
-    file: file.file,
-    url: getUrl(file.data.slugs, locale),
-    slugs: file.data.slugs,
-    data: file.data.data,
+    get file() {
+      return parseFilePath(this.path);
+    },
+    absolutePath: file.absolutePath,
+    path: file.path,
+    url: getUrl(file.slugs, locale),
+    slugs: file.slugs,
+    data: file.data,
     locale
   };
 }
 export {
-  file_system_exports as FileSystem,
+  FileSystem,
   createGetUrl,
   createPageTreeBuilder,
   getSlugs,

package/dist/{static-IM4OAJFY.js → static-QTPM5MZT.js}

@@ -3,7 +3,6 @@ import {
   searchSimple
 } from "./chunk-WFUH5VBX.js";
 import "./chunk-KAOEMCTI.js";
-import "./chunk-MLKGABMK.js";
 
 // src/search/client/static.ts
 import { create, load } from "@orama/orama";

package/dist/toc.js

@@ -2,7 +2,6 @@
 import {
   useOnChange
 } from "./chunk-EMWGTXSW.js";
-import "./chunk-MLKGABMK.js";
 
 // src/toc.tsx
 import { createContext, forwardRef, useContext, useMemo, useRef } from "react";

package/dist/utils/use-effect-event.js

@@ -1,5 +1,4 @@
 "use client";
-import "../chunk-MLKGABMK.js";
 
 // src/utils/use-effect-event.ts
 import { useCallback, useRef } from "react";

package/dist/utils/use-media-query.js

@@ -1,7 +1,6 @@
 import {
   useMediaQuery
 } from "../chunk-EP5LHGDZ.js";
-import "../chunk-MLKGABMK.js";
 export {
   useMediaQuery
 };

package/dist/utils/use-on-change.js

@@ -1,7 +1,6 @@
 import {
   useOnChange
 } from "../chunk-EMWGTXSW.js";
-import "../chunk-MLKGABMK.js";
 export {
   useOnChange
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-core",
-  "version": "15.5.1",
+  "version": "15.5.2",
   "description": "The library for building a documentation website in Next.js",
   "keywords": [
     "NextJs",
@@ -87,37 +87,37 @@
   "dependencies": {
     "@formatjs/intl-localematcher": "^0.6.1",
     "@orama/orama": "^3.1.6",
-    "@shikijs/rehype": "^3.4.2",
-    "@shikijs/transformers": "^3.4.2",
+    "@shikijs/rehype": "^3.6.0",
+    "@shikijs/transformers": "^3.6.0",
     "github-slugger": "^2.0.0",
     "hast-util-to-estree": "^3.1.3",
     "hast-util-to-jsx-runtime": "^2.3.6",
     "image-size": "^2.0.2",
     "negotiator": "^1.0.0",
-    "react-remove-scroll": "^2.6.3",
+    "react-remove-scroll": "^2.7.1",
     "remark": "^15.0.0",
     "remark-gfm": "^4.0.1",
     "remark-rehype": "^11.1.2",
     "scroll-into-view-if-needed": "^3.1.0",
-    "shiki": "^3.4.2",
+    "shiki": "^3.6.0",
     "unist-util-visit": "^5.0.0"
   },
   "devDependencies": {
     "@mdx-js/mdx": "^3.1.0",
     "@oramacloud/client": "^2.1.4",
-    "@tanstack/react-router": "^1.120.12",
+    "@tanstack/react-router": "^1.121.2",
     "@types/estree-jsx": "^1.0.5",
     "@types/hast": "^3.0.4",
     "@types/mdast": "^4.0.3",
-    "@types/negotiator": "^0.6.3",
-    "@types/node": "22.15.28",
-    "@types/react": "^19.1.6",
-    "@types/react-dom": "^19.1.5",
-    "algoliasearch": "5.25.0",
+    "@types/negotiator": "^0.6.4",
+    "@types/node": "24.0.1",
+    "@types/react": "^19.1.8",
+    "@types/react-dom": "^19.1.6",
+    "algoliasearch": "5.27.0",
     "mdast-util-mdx-jsx": "^3.2.0",
     "mdast-util-mdxjs-esm": "^2.0.1",
     "next": "^15.3.3",
-    "react-router": "^7.6.1",
+    "react-router": "^7.6.2",
     "remark-mdx": "^3.1.0",
     "typescript": "^5.8.3",
     "unified": "^11.0.5",
@@ -130,9 +130,13 @@
     "algoliasearch": "5.x.x",
     "next": "14.x.x || 15.x.x",
     "react": "18.x.x || 19.x.x",
-    "react-dom": "18.x.x || 19.x.x"
+    "react-dom": "18.x.x || 19.x.x",
+    "@types/react": "*"
   },
   "peerDependenciesMeta": {
+    "@types/react": {
+      "optional": true
+    },
     "@oramacloud/client": {
       "optional": true
     },

package/dist/chunk-MLKGABMK.js

@@ -1,9 +0,0 @@
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-
-export {
-  __export
-};