fumadocs-core 11.3.1 → 12.0.0

package/dist/breadcrumb.d.ts

@@ -1,4 +1,4 @@
-import { R as Root } from './page-tree-mLHMYx2B.js';
+import { R as Root } from './page-tree-_z0bnHIU.js';
 import 'react';
 
 interface BreadcrumbItem {

package/dist/breadcrumb.js

@@ -1,4 +1,4 @@
-import "./chunk-WEAGW6MQ.js";
+import "./chunk-UWTMEZUM.js";
 
 // src/breadcrumb.tsx
 import { useMemo } from "react";

package/dist/{chunk-AFKH746E.js → chunk-2BP57A6C.js}

@@ -2,7 +2,7 @@ import {
   __objRest,
   __spreadProps,
   __spreadValues
-} from "./chunk-WEAGW6MQ.js";
+} from "./chunk-UWTMEZUM.js";
 
 // src/link.tsx
 import Original from "next/link";

package/dist/{chunk-5BST7EWT.js → chunk-QRNTLL6S.js}

@@ -1,6 +1,16 @@
 // src/mdx-plugins/remark-heading.ts
 import Slugger from "github-slugger";
 import { visit } from "unist-util-visit";
+
+// src/mdx-plugins/remark-utils.ts
+function flattenNode(node) {
+  if ("children" in node)
+    return node.children.map((child) => flattenNode(child)).join("");
+  if ("value" in node) return node.value;
+  return "";
+}
+
+// src/mdx-plugins/remark-heading.ts
 var slugger = new Slugger();
 var regex = new RegExp("\\s*\\[#(?<slug>[^]+?)]\\s*$");
 function remarkHeading({
@@ -12,25 +22,24 @@ function remarkHeading({
     slugger.reset();
     visit(root, "heading", (heading) => {
       var _a;
-      const node = heading.children.at(-1);
-      if (!node || node.type !== "text")
-        return;
       heading.data || (heading.data = {});
       (_a = heading.data).hProperties || (_a.hProperties = {});
-      let id = heading.data.hProperties.id;
-      if (!id && customId) {
-        const match = regex.exec(node.value);
+      const lastNode = heading.children.at(-1);
+      if (!heading.data.hProperties.id && (lastNode == null ? void 0 : lastNode.type) === "text" && customId) {
+        const match = regex.exec(lastNode.value);
         if (match == null ? void 0 : match[1]) {
-          id = match[1];
-          node.value = node.value.slice(0, match.index);
+          heading.data.hProperties.id = match[1];
+          lastNode.value = lastNode.value.slice(0, match.index);
         }
       }
+      const value = flattenNode(heading);
+      let id = heading.data.hProperties.id;
       if (!id) {
-        id = defaultSlug ? defaultSlug(root, heading, node.value) : slugger.slug(node.value);
+        id = defaultSlug ? defaultSlug(root, heading, value) : slugger.slug(value);
       }
       heading.data.hProperties.id = id;
       toc.push({
-        title: node.value,
+        title: value,
         url: `#${id}`,
         depth: heading.depth
       });
@@ -41,5 +50,6 @@ function remarkHeading({
 }
 
 export {
+  flattenNode,
   remarkHeading
 };

package/dist/dynamic-link.js

@@ -1,11 +1,11 @@
 "use client";
 import {
   Link
-} from "./chunk-AFKH746E.js";
+} from "./chunk-2BP57A6C.js";
 import {
   __objRest,
   __spreadValues
-} from "./chunk-WEAGW6MQ.js";
+} from "./chunk-UWTMEZUM.js";
 
 // src/dynamic-link.tsx
 import { useParams } from "next/navigation";

package/dist/link.js

@@ -1,7 +1,7 @@
 import {
   Link
-} from "./chunk-AFKH746E.js";
-import "./chunk-WEAGW6MQ.js";
+} from "./chunk-2BP57A6C.js";
+import "./chunk-UWTMEZUM.js";
 export {
   Link as default
 };

package/dist/mdx-plugins/index.d.ts

@@ -4,7 +4,7 @@ import { RehypeShikiOptions } from '@shikijs/rehype';
 import { Processor, Transformer } from 'unified';
 import { ShikiTransformer } from 'shiki';
 import { Root as Root$1, Heading } from 'mdast';
-export { a as StructureOptions, S as StructuredData, r as remarkStructure, s as structure } from '../remark-structure-Os9Vuaua.js';
+export { a as StructureOptions, S as StructuredData, r as remarkStructure, s as structure } from '../remark-structure-Dj8oa5Ba.js';
 
 interface CodeBlockIcon {
     viewBox: string;

package/dist/mdx-plugins/index.js

@@ -1,13 +1,14 @@
 import {
+  flattenNode,
   remarkHeading
-} from "../chunk-5BST7EWT.js";
+} from "../chunk-QRNTLL6S.js";
 import {
   slash
 } from "../chunk-UWEEHUJV.js";
 import {
   __async,
   __spreadValues
-} from "../chunk-WEAGW6MQ.js";
+} from "../chunk-UWTMEZUM.js";
 
 // src/mdx-plugins/index.ts
 import {
@@ -161,11 +162,9 @@ function transformerIcon(options = {}) {
     name: "rehype-code:icon",
     root(root) {
       const lang = this.options.lang;
-      if (!lang)
-        return;
+      if (!lang) return;
       const pre = root.children[0];
-      if (pre.type !== "element")
-        return;
+      if (pre.type !== "element" || pre.tagName !== "pre") return;
       const iconName = lang in shortcuts ? shortcuts[lang] : lang;
       const icon = iconName in icons ? icons[iconName] : icons.default;
       const tree = toEstree(pre, {
@@ -324,6 +323,14 @@ function rehypeCode(options = {}) {
           meta.__raw = codeOptions.filterMetaString((_a = meta.__raw) != null ? _a : "");
         }
         return code.replace(/\n$/, "");
+      },
+      line(hast) {
+        if (hast.children.length === 0) {
+          hast.children.push({
+            type: "text",
+            value: " "
+          });
+        }
       }
     },
     ...codeOptions.transformers
@@ -336,7 +343,7 @@ function rehypeCode(options = {}) {
   }
   const prefix = "language-";
   const transformer = rehypeShiki.call(this, codeOptions);
-  return (root, vfile) => __async(this, null, function* () {
+  return (root, file) => __async(this, null, function* () {
     visit(root, ["pre"], (element) => {
       var _a;
       const head = element.children[0];
@@ -344,8 +351,7 @@ function rehypeCode(options = {}) {
         return;
       (_a = head.properties).className || (_a.className = []);
       const classes = head.properties.className;
-      if (!Array.isArray(classes))
-        return;
+      if (!Array.isArray(classes)) return;
       const hasLanguage = classes.some(
         (d) => typeof d === "string" && d.startsWith(prefix)
       );
@@ -353,7 +359,7 @@ function rehypeCode(options = {}) {
         classes.push(`${prefix}${codeOptions.defaultLang}`);
     });
     if (transformer)
-      yield transformer.call(this, root, vfile, () => {
+      yield transformer.call(this, root, file, () => {
       });
   });
 }
@@ -455,17 +461,6 @@ import { remark } from "remark";
 import remarkGfm from "remark-gfm";
 import remarkMdx from "remark-mdx";
 import { visit as visit3 } from "unist-util-visit";
-
-// src/mdx-plugins/remark-utils.ts
-function flattenNode(node) {
-  if ("children" in node)
-    return node.children.map((child) => flattenNode(child)).join("");
-  if ("value" in node)
-    return node.value;
-  return "";
-}
-
-// src/mdx-plugins/remark-structure.ts
 var slugger = new Slugger();
 function remarkStructure({
   types = ["paragraph", "blockquote", "heading"]
@@ -476,8 +471,7 @@ function remarkStructure({
     let lastHeading = "";
     visit3(node, types, (element) => {
       var _a, _b;
-      if (element.type === "root")
-        return;
+      if (element.type === "root") return;
       const content = flattenNode(element).trim();
       if (element.type === "heading") {
         element.data || (element.data = {});

package/dist/middleware.js

@@ -1,4 +1,4 @@
-import "./chunk-WEAGW6MQ.js";
+import "./chunk-UWTMEZUM.js";
 
 // src/middleware.ts
 import { match as matchLocale } from "@formatjs/intl-localematcher";

package/dist/{page-tree-mLHMYx2B.d.ts → page-tree-_z0bnHIU.d.ts}

@@ -17,6 +17,10 @@ interface Separator {
     name: string;
 }
 interface Folder {
+    /**
+     * Optional id to be attached to folders
+     */
+    id?: string;
     type: 'folder';
     name: string;
     root?: boolean;
@@ -35,4 +39,4 @@ declare namespace pageTree {
   export type { pageTree_Folder as Folder, pageTree_Item as Item, pageTree_Node as Node, pageTree_Root as Root, pageTree_Separator as Separator };
 }
 
-export { type Item as I, type Node as N, type Root as R, pageTree as p };
+export { type Folder as F, type Item as I, type Node as N, type Root as R, type Separator as S, pageTree as p };

package/dist/search/client.js

@@ -1,23 +1,19 @@
 import {
   __async
-} from "../chunk-WEAGW6MQ.js";
+} from "../chunk-UWTMEZUM.js";
 
 // src/search/client.ts
 import { useEffect, useState } from "react";
 import useSWR from "swr";
 function fetchDocs(api, query, locale, tag) {
   return __async(this, null, function* () {
-    if (query.length === 0)
-      return "empty";
+    if (query.length === 0) return "empty";
     const params = new URLSearchParams();
     params.set("query", query);
-    if (locale)
-      params.set("locale", locale);
-    if (tag)
-      params.set("tag", tag);
+    if (locale) params.set("locale", locale);
+    if (tag) params.set("tag", tag);
     const res = yield fetch(`${api}?${params.toString()}`);
-    if (!res.ok)
-      throw new Error(yield res.text());
+    if (!res.ok) throw new Error(yield res.text());
     return yield res.json();
   });
 }

package/dist/search/server.d.ts

@@ -1,5 +1,5 @@
 import { NextRequest, NextResponse } from 'next/server';
-import { S as StructuredData } from '../remark-structure-Os9Vuaua.js';
+import { S as StructuredData } from '../remark-structure-Dj8oa5Ba.js';
 import { SortedResult } from './shared.js';
 import 'mdast';
 import 'unified';

package/dist/search/server.js

@@ -1,7 +1,7 @@
 import {
   __spreadProps,
   __spreadValues
-} from "../chunk-WEAGW6MQ.js";
+} from "../chunk-UWTMEZUM.js";
 
 // src/search/server.ts
 import { Document } from "flexsearch";
@@ -12,8 +12,7 @@ function create(search) {
     GET(request) {
       var _a, _b;
       const query = request.nextUrl.searchParams.get("query");
-      if (!query)
-        return NextResponse.json([]);
+      if (!query) return NextResponse.json([]);
       return NextResponse.json(
         search(query, {
           tag: (_a = request.nextUrl.searchParams.get("tag")) != null ? _a : void 0,
@@ -45,8 +44,7 @@ function createI18nSearchAPI(type, options) {
   return create((query, searchOptions) => {
     if (searchOptions == null ? void 0 : searchOptions.locale) {
       const handler = map.get(searchOptions.locale);
-      if (handler)
-        return handler.search(query, searchOptions);
+      if (handler) return handler.search(query, searchOptions);
     }
     return [];
   });
@@ -95,8 +93,7 @@ function initSearchAPI({ indexes, language }) {
       enrich: true,
       suggest: true
     });
-    if (results.length === 0)
-      return [];
+    if (results.length === 0) return [];
     return results[0].result.map((page) => ({
       type: "page",
       content: page.doc.title,
@@ -190,8 +187,7 @@ function initSearchAPIAdvanced({
     }
     for (const [id, items] of map.entries()) {
       const page = index.get(id);
-      if (!page)
-        continue;
+      if (!page) continue;
       sortedResult.push({
         id: page.id,
         content: page.content,

package/dist/search-algolia/client.d.ts

@@ -4,7 +4,7 @@ import { SWRResponse } from 'swr';
 import { SortedResult } from '../search/shared.js';
 import { BaseIndex } from './server.js';
 import 'algoliasearch';
-import '../remark-structure-Os9Vuaua.js';
+import '../remark-structure-Dj8oa5Ba.js';
 import 'mdast';
 import 'unified';
 

package/dist/search-algolia/client.js

@@ -2,7 +2,7 @@ import {
   __async,
   __objRest,
   __spreadValues
-} from "../chunk-WEAGW6MQ.js";
+} from "../chunk-UWTMEZUM.js";
 
 // src/search-algolia/client.ts
 import { useState } from "react";
@@ -51,8 +51,7 @@ function useAlgoliaSearch(index, _a = {}) {
   const query = useSWR(
     ["algolia-search", search, allowEmpty, options],
     () => __async(this, null, function* () {
-      if (allowEmpty && search.length === 0)
-        return "empty";
+      if (allowEmpty && search.length === 0) return "empty";
       return searchDocs(index, search, options);
     }),
     {

package/dist/search-algolia/server.d.ts

@@ -1,5 +1,5 @@
 import { SearchClient, SearchIndex } from 'algoliasearch';
-import { S as StructuredData } from '../remark-structure-Os9Vuaua.js';
+import { S as StructuredData } from '../remark-structure-Dj8oa5Ba.js';
 import 'mdast';
 import 'unified';
 

package/dist/search-algolia/server.js

@@ -1,7 +1,7 @@
 import {
   __async,
   __spreadValues
-} from "../chunk-WEAGW6MQ.js";
+} from "../chunk-UWTMEZUM.js";
 
 // src/search-algolia/server.ts
 import { randomUUID } from "crypto";

package/dist/server/index.d.ts

@@ -1,6 +1,6 @@
-export { a as TOCItemType, T as TableOfContents, g as getTableOfContents } from '../get-toc-YF_TdazL.js';
-import { N as Node, I as Item, R as Root } from '../page-tree-mLHMYx2B.js';
-export { p as PageTree } from '../page-tree-mLHMYx2B.js';
+export { a as TOCItemType, T as TableOfContents, g as getTableOfContents } from '../get-toc-B-AMfFKT.js';
+import { N as Node, I as Item, R as Root } from '../page-tree-_z0bnHIU.js';
+export { p as PageTree } from '../page-tree-_z0bnHIU.js';
 import 'react';
 
 /**

package/dist/server/index.js

@@ -1,17 +1,16 @@
 import {
   remarkHeading
-} from "../chunk-5BST7EWT.js";
+} from "../chunk-QRNTLL6S.js";
 import {
   __async
-} from "../chunk-WEAGW6MQ.js";
+} from "../chunk-UWTMEZUM.js";
 
 // src/server/get-toc.ts
 import { remark } from "remark";
 function getTableOfContents(content) {
   return __async(this, null, function* () {
     const result = yield remark().use(remarkHeading).process(content);
-    if ("toc" in result.data)
-      return result.data.toc;
+    if ("toc" in result.data) return result.data.toc;
     return [];
   });
 }
@@ -19,12 +18,10 @@ function getTableOfContents(content) {
 // src/server/page-tree-utils.ts
 function flattenTree(tree) {
   return tree.flatMap((node) => {
-    if (node.type === "separator")
-      return [];
+    if (node.type === "separator") return [];
     if (node.type === "folder") {
       const child = flattenTree(node.children);
-      if (node.index)
-        return [node.index, ...child];
+      if (node.index) return [node.index, ...child];
       return child;
     }
     return [node];
@@ -45,8 +42,7 @@ function findNeighbour(tree, url) {
 function separatePageTree(pageTree) {
   return pageTree.children.flatMap((child) => {
     var _a;
-    if (child.type !== "folder")
-      return [];
+    if (child.type !== "folder") return [];
     return {
       name: child.name,
       url: (_a = child.index) == null ? void 0 : _a.url,
@@ -88,8 +84,7 @@ function getGithubLastEdit(_0) {
         `Failed to fetch last edit time from Git ${yield res.text()}`
       );
     const data = yield res.json();
-    if (data.length === 0)
-      return null;
+    if (data.length === 0) return null;
     return new Date(data[0].commit.committer.date);
   });
 }

package/dist/sidebar.d.ts

@@ -12,15 +12,11 @@ type AsProps<T extends ElementType> = Omit<ComponentPropsWithoutRef<T>, 'as'> &
 type SidebarTriggerProps<T extends ElementType> = AsProps<T>;
 declare function SidebarTrigger<T extends ElementType = 'button'>({ as, ...props }: SidebarTriggerProps<T>): ReactElement;
 type SidebarContentProps<T extends ElementType> = AsProps<T> & {
-    /**
-     * @deprecated Use `blockScrollingWidth` instead
-     */
-    minWidth?: number;
     /**
      * Disable scroll blocking when the viewport width is larger than a certain number (in pixels)
      */
     blockScrollingWidth?: number;
 };
-declare function SidebarList<T extends ElementType = 'aside'>({ as, minWidth, blockScrollingWidth, ...props }: SidebarContentProps<T>): ReactElement;
+declare function SidebarList<T extends ElementType = 'aside'>({ as, blockScrollingWidth, ...props }: SidebarContentProps<T>): ReactElement;
 
 export { type SidebarContentProps, SidebarList, SidebarProvider, type SidebarProviderProps, SidebarTrigger, type SidebarTriggerProps };

package/dist/sidebar.js

@@ -2,10 +2,9 @@ import {
   __objRest,
   __spreadProps,
   __spreadValues
-} from "./chunk-WEAGW6MQ.js";
+} from "./chunk-UWTMEZUM.js";
 
 // src/sidebar.tsx
-import { usePathname } from "next/navigation";
 import {
   useCallback,
   createContext,
@@ -18,8 +17,7 @@ import { jsx } from "react/jsx-runtime";
 var SidebarContext = createContext(void 0);
 function useSidebarContext() {
   const ctx = useContext(SidebarContext);
-  if (!ctx)
-    throw new Error("Missing sidebar provider");
+  if (!ctx) throw new Error("Missing sidebar provider");
   return ctx;
 }
 function SidebarProvider(props) {
@@ -29,10 +27,6 @@ function SidebarProvider(props) {
     (_a = props.open) != null ? _a : openInner,
     (_b = props.onOpenChange) != null ? _b : setOpenInner
   ];
-  const pathname = usePathname();
-  useEffect(() => {
-    setOpen(false);
-  }, [pathname, setOpen]);
   return /* @__PURE__ */ jsx(SidebarContext.Provider, { value: [open, setOpen], children: props.children });
 }
 function SidebarTrigger(_a) {
@@ -57,18 +51,15 @@ function SidebarTrigger(_a) {
 function SidebarList(_a) {
   var _b = _a, {
     as,
-    minWidth,
-    blockScrollingWidth = minWidth
+    blockScrollingWidth
   } = _b, props = __objRest(_b, [
     "as",
-    "minWidth",
     "blockScrollingWidth"
   ]);
   const [open] = useSidebarContext();
   const [isBlocking, setIsBlocking] = useState(false);
   useEffect(() => {
-    if (!blockScrollingWidth)
-      return;
+    if (!blockScrollingWidth) return;
     const mediaQueryList = window.matchMedia(
       `(min-width: ${blockScrollingWidth.toString()}px)`
     );

package/dist/source/index.d.ts

@@ -1,5 +1,5 @@
 import { ReactElement } from 'react';
-import { R as Root } from '../page-tree-mLHMYx2B.js';
+import { R as Root, I as Item, F as Folder$1, S as Separator } from '../page-tree-_z0bnHIU.js';
 
 interface FileInfo {
     locale?: string;
@@ -97,11 +97,15 @@ interface LoaderOptions {
      */
     baseUrl?: string;
     languages?: string[];
-    icon?: NonNullable<CreatePageTreeBuilderOptions['resolveIcon']>;
+    icon?: NonNullable<BuildPageTreeOptions['resolveIcon']>;
     slugs?: LoadOptions['getSlugs'];
     url?: UrlFn;
     source: Source<any>;
     transformers?: Transformer[];
+    /**
+     * Additional options for page tree builder
+     */
+    pageTree?: Partial<Omit<BuildPageTreeOptions, 'storage' | 'getUrl'>>;
 }
 interface Source<Config extends SourceConfig> {
     /**
@@ -177,21 +181,30 @@ interface FileData {
     };
 }
 
-interface BuildPageTreeOptionsWithI18n {
-    languages: string[];
-}
-interface PageTreeBuilder {
-    build: () => Root;
+interface BuildPageTreeOptions {
     /**
-     * Build page tree and fallback to the default language if the localized page doesn't exist
+     * Attach the `folder.id` property
+     *
+     * @defaultValue false
      */
-    buildI18n: (options?: Partial<BuildPageTreeOptionsWithI18n>) => Record<string, Root>;
-}
-interface CreatePageTreeBuilderOptions {
+    attachFolderIds?: boolean;
+    attachFile?: (node: Item, file?: File) => Item;
+    attachFolder?: (node: Folder$1, folder: Folder, meta?: File) => Folder$1;
+    attachSeparator?: (node: Separator) => Separator;
     storage: Storage;
     getUrl: UrlFn;
     resolveIcon?: (icon: string | undefined) => ReactElement | undefined;
 }
-declare function createPageTreeBuilder(options: CreatePageTreeBuilderOptions): PageTreeBuilder;
+interface BuildPageTreeOptionsWithI18n extends BuildPageTreeOptions {
+    languages?: string[];
+}
+interface PageTreeBuilder {
+    build: (options: BuildPageTreeOptions) => Root;
+    /**
+     * Build page tree and fallback to the default language if the localized page doesn't exist
+     */
+    buildI18n: (options: BuildPageTreeOptionsWithI18n) => Record<string, Root>;
+}
+declare function createPageTreeBuilder(): PageTreeBuilder;
 
-export { type BuildPageTreeOptionsWithI18n, type CreatePageTreeBuilderOptions, type FileData, type FileInfo, fileSystem as FileSystem, 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, loader, parseFilePath, parseFolderPath };
+export { type BuildPageTreeOptions, type BuildPageTreeOptionsWithI18n, type FileData, type FileInfo, fileSystem as FileSystem, 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, loader, parseFilePath, parseFolderPath };

package/dist/source/index.js

@@ -3,9 +3,9 @@ import {
 } from "../chunk-UWEEHUJV.js";
 import {
   __export,
-  __spreadProps,
+  __objRest,
   __spreadValues
-} from "../chunk-WEAGW6MQ.js";
+} from "../chunk-UWTMEZUM.js";
 
 // src/source/path.ts
 import { parse } from "path";
@@ -73,8 +73,7 @@ function buildAll(nodes, ctx, skipIndex) {
     if ("data" in node && node.format === "page" && !node.file.locale) {
       const treeNode = buildFileNode(node, ctx);
       if (node.file.name === "index") {
-        if (!skipIndex)
-          output.unshift(treeNode);
+        if (!skipIndex) output.unshift(treeNode);
         continue;
       }
       output.push(treeNode);
@@ -86,39 +85,35 @@ function buildAll(nodes, ctx, skipIndex) {
   return output;
 }
 function resolveFolderItem(folder, item, ctx, addedNodePaths) {
-  var _a, _b, _c;
-  if (item === rest)
-    return "...";
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+  if (item === rest) return "...";
   const separateResult = separator.exec(item);
   if (separateResult == null ? void 0 : separateResult.groups) {
-    return [
-      {
-        type: "separator",
-        name: separateResult.groups.name
-      }
-    ];
+    const node = {
+      type: "separator",
+      name: separateResult.groups.name
+    };
+    return [(_c = (_b = (_a = ctx.options).attachSeparator) == null ? void 0 : _b.call(_a, node)) != null ? _c : node];
   }
   const linkResult = link.exec(item);
   if (linkResult == null ? void 0 : linkResult.groups) {
     const { url, text } = linkResult.groups;
     const isRelative = url.startsWith("/") || url.startsWith("#") || url.startsWith(".");
-    return [
-      {
-        type: "page",
-        name: text,
-        url,
-        external: !isRelative
-      }
-    ];
+    const node = {
+      type: "page",
+      name: text,
+      url,
+      external: !isRelative
+    };
+    return [(_f = (_e = (_d = ctx.options).attachFile) == null ? void 0 : _e.call(_d, node)) != null ? _f : node];
   }
   const extractResult = extractor.exec(item);
   const path = resolvePath(
     folder.file.path,
-    (_b = (_a = extractResult == null ? void 0 : extractResult.groups) == null ? void 0 : _a.name) != null ? _b : item
+    (_h = (_g = extractResult == null ? void 0 : extractResult.groups) == null ? void 0 : _g.name) != null ? _h : item
   );
-  const itemNode = (_c = ctx.storage.readDir(path)) != null ? _c : ctx.storage.read(path, "page");
-  if (!itemNode)
-    return [];
+  const itemNode = (_i = ctx.storage.readDir(path)) != null ? _i : ctx.storage.read(path, "page");
+  if (!itemNode) return [];
   addedNodePaths.add(itemNode.file.path);
   if ("children" in itemNode) {
     const node = buildFolderNode(itemNode, false, ctx);
@@ -127,7 +122,7 @@ function resolveFolderItem(folder, item, ctx, addedNodePaths) {
   return [buildFileNode(itemNode, ctx)];
 }
 function buildFolderNode(folder, defaultIsRoot, ctx) {
-  var _a, _b, _c, _d, _e, _f;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
   const metaPath = resolvePath(folder.file.path, "meta");
   let meta = ctx.storage.read(metaPath, "meta");
   meta = (_a = findLocalizedFile(metaPath, "meta", ctx)) != null ? _a : meta;
@@ -147,7 +142,7 @@ function buildFolderNode(folder, defaultIsRoot, ctx) {
       return resolveFolderItem(folder, item, ctx, addedNodePaths);
     });
     const restNodes = buildAll(
-      folder.children.filter((node) => !addedNodePaths.has(node.file.path)),
+      folder.children.filter((node2) => !addedNodePaths.has(node2.file.path)),
       ctx,
       !isRoot
     );
@@ -159,26 +154,33 @@ function buildFolderNode(folder, defaultIsRoot, ctx) {
     });
     children = nodes != null ? nodes : restNodes;
   }
-  return removeUndefined({
+  const node = {
     type: "folder",
     name: (_e = (_d = metadata == null ? void 0 : metadata.title) != null ? _d : index == null ? void 0 : index.name) != null ? _e : pathToName(folder.file.name),
-    icon: (_f = ctx.resolveIcon) == null ? void 0 : _f.call(ctx, metadata == null ? void 0 : metadata.icon),
+    icon: (_g = (_f = ctx.options).resolveIcon) == null ? void 0 : _g.call(_f, metadata == null ? void 0 : metadata.icon),
     root: metadata == null ? void 0 : metadata.root,
     defaultOpen: metadata == null ? void 0 : metadata.defaultOpen,
     index,
     children
-  });
+  };
+  if (ctx.options.attachFolderIds) {
+    node.id = folder.file.flattenedPath;
+  }
+  return removeUndefined(
+    (_j = (_i = (_h = ctx.options).attachFolder) == null ? void 0 : _i.call(_h, node, folder, meta)) != null ? _j : node
+  );
 }
 function buildFileNode(file, ctx) {
-  var _a, _b;
+  var _a, _b, _c, _d, _e, _f;
   const localized = (_a = findLocalizedFile(file.file.flattenedPath, "page", ctx)) != null ? _a : file;
   const data = localized.data;
-  return removeUndefined({
+  const item = {
     type: "page",
     name: data.data.title,
-    icon: (_b = ctx.resolveIcon) == null ? void 0 : _b.call(ctx, data.data.icon),
-    url: ctx.getUrl(data.slugs, ctx.lang)
-  });
+    icon: (_c = (_b = ctx.options).resolveIcon) == null ? void 0 : _c.call(_b, data.data.icon),
+    url: ctx.options.getUrl(data.slugs, ctx.lang)
+  };
+  return removeUndefined((_f = (_e = (_d = ctx.options).attachFile) == null ? void 0 : _e.call(_d, item, file)) != null ? _f : item);
 }
 function build(ctx) {
   const root = ctx.storage.root();
@@ -188,20 +190,24 @@ function build(ctx) {
     children: folder.children
   };
 }
-function createPageTreeBuilder(options) {
-  function getContext(builder, locale) {
-    return __spreadProps(__spreadValues({}, options), {
-      lang: locale,
-      builder
-    });
-  }
+function createPageTreeBuilder() {
   return {
-    build() {
-      return build(getContext(this));
+    build(options) {
+      return build({
+        options,
+        builder: this,
+        storage: options.storage
+      });
     },
-    buildI18n({ languages = [] } = {}) {
+    buildI18n(_a) {
+      var _b = _a, { languages = [] } = _b, options = __objRest(_b, ["languages"]);
       const entries = languages.map((lang) => {
-        const tree = build(getContext(this, lang));
+        const tree = build({
+          lang,
+          options,
+          builder: this,
+          storage: options.storage
+        });
         return [lang, tree];
       });
       return Object.fromEntries(entries);
@@ -209,8 +215,7 @@ function createPageTreeBuilder(options) {
   };
 }
 function findLocalizedFile(path, format, ctx) {
-  if (!ctx.lang)
-    return;
+  if (!ctx.lang) return;
   return ctx.storage.read(`${path}.${ctx.lang}`, format);
 }
 function pathToName(path) {
@@ -219,8 +224,7 @@ function pathToName(path) {
 function removeUndefined(value) {
   const obj = value;
   Object.keys(obj).forEach((key) => {
-    if (obj[key] === void 0)
-      delete obj[key];
+    if (obj[key] === void 0) delete obj[key];
   });
   return value;
 }
@@ -272,8 +276,7 @@ var Storage = class {
     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;
+      if (this.folders.has(segment)) continue;
       const folder = {
         file: parseFolderPath(segment),
         children: []
@@ -292,8 +295,7 @@ function loadFiles(files, options) {
   const rootDir = normalizePath((_a = options.rootDir) != null ? _a : "");
   for (const file of files) {
     const normalizedPath = normalizePath(file.path);
-    if (!normalizedPath.startsWith(rootDir))
-      continue;
+    if (!normalizedPath.startsWith(rootDir)) continue;
     const relativePath = normalizedPath.slice(rootDir.length);
     if (file.type === "page") {
       const parsedPath = parseFilePath(relativePath);
@@ -325,8 +327,7 @@ function buildPageMap(storage, languages, getUrl) {
   const defaultMap = /* @__PURE__ */ new Map();
   map.set("", defaultMap);
   for (const file of storage.list()) {
-    if (file.format !== "page" || file.file.locale)
-      continue;
+    if (file.format !== "page" || file.file.locale) continue;
     const page = fileToPage(file, getUrl);
     defaultMap.set(page.slugs.join("/"), page);
     for (const lang of languages) {
@@ -357,13 +358,14 @@ function loader(options) {
 }
 function createOutput({
   source,
-  icon,
+  icon: resolveIcon,
   languages,
   rootDir = "",
   transformers,
   baseUrl = "/",
   slugs: slugsFn = getSlugs,
-  url: getUrl = createGetUrl(baseUrl)
+  url: getUrl = createGetUrl(baseUrl),
+  pageTree: pageTreeOptions = {}
 }) {
   const storage = loadFiles(
     typeof source.files === "function" ? source.files(rootDir) : source.files,
@@ -374,12 +376,17 @@ function createOutput({
     }
   );
   const i18nMap = buildPageMap(storage, languages != null ? languages : [], getUrl);
-  const builder = createPageTreeBuilder({
+  const builder = createPageTreeBuilder();
+  const pageTree = languages === void 0 ? builder.build(__spreadValues({
     storage,
-    resolveIcon: icon,
+    resolveIcon,
     getUrl
-  });
-  const pageTree = languages === void 0 ? builder.build() : builder.buildI18n({ languages });
+  }, pageTreeOptions)) : builder.buildI18n(__spreadValues({
+    languages,
+    storage,
+    resolveIcon,
+    getUrl
+  }, pageTreeOptions));
   return {
     pageTree,
     files: storage.list(),

package/dist/toc.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { HTMLAttributes, RefObject, ReactNode, AnchorHTMLAttributes } from 'react';
-import { T as TableOfContents } from './get-toc-YF_TdazL.js';
+import { T as TableOfContents } from './get-toc-B-AMfFKT.js';
 
 declare const useActiveAnchor: (url: string) => boolean;
 interface TOCProviderProps extends HTMLAttributes<HTMLDivElement> {

package/dist/toc.js

@@ -2,7 +2,7 @@ import {
   __objRest,
   __spreadProps,
   __spreadValues
-} from "./chunk-WEAGW6MQ.js";
+} from "./chunk-UWTMEZUM.js";
 
 // src/toc.tsx
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-core",
-  "version": "11.3.1",
+  "version": "12.0.0",
   "description": "The library for building a documentation website in Next.js",
   "keywords": [
     "NextJs",
@@ -113,8 +113,8 @@
   ],
   "dependencies": {
     "@formatjs/intl-localematcher": "^0.5.4",
-    "@shikijs/rehype": "^1.6.1",
-    "@shikijs/transformers": "^1.6.1",
+    "@shikijs/rehype": "^1.6.3",
+    "@shikijs/transformers": "^1.6.3",
     "flexsearch": "0.7.21",
     "github-slugger": "^2.0.0",
     "hast-util-to-estree": "^3.1.0",
@@ -125,7 +125,7 @@
     "remark-gfm": "^4.0.0",
     "remark-mdx": "^3.0.1",
     "scroll-into-view-if-needed": "^3.1.0",
-    "shiki": "^1.6.1",
+    "shiki": "^1.6.3",
     "swr": "^2.2.5",
     "unist-util-visit": "^5.0.0"
   },