fumadocs-core 16.0.9 → 16.0.11

package/dist/breadcrumb.d.ts

@@ -1,5 +1,5 @@
 import { ReactNode } from 'react';
-import { R as Root, N as Node } from './definitions-DQnHJeWn.js';
+import { R as Root, N as Node } from './definitions-DbCug1P3.js';
 
 interface BreadcrumbItem {
     name: ReactNode;

package/dist/{builder-BynMF2Pa.d.ts → builder-DEvYXjy8.d.ts}

@@ -1,4 +1,4 @@
-import { R as Root, I as Item, F as Folder, S as Separator } from './definitions-DQnHJeWn.js';
+import { R as Root, I as Item, F as Folder, S as Separator } from './definitions-DbCug1P3.js';
 import { I18nConfig } from './i18n/index.js';
 import { ReactNode } from 'react';
 
@@ -249,10 +249,8 @@ interface PageFile<Data extends PageData = PageData> {
 }
 
 interface PageTreeBuilderContext<Page extends PageData = PageData, Meta extends MetaData = MetaData> {
-    /**
-     * @internal resolve paths without extensions
-     */
-    resolveName: (name: string, format: 'meta' | 'page') => string;
+    rootId: string;
+    generateNodeId: () => string;
     options: PageTreeOptions;
     transformers: PageTreeTransformer<Page, Meta>[];
     builder: PageTreeBuilder;
@@ -260,7 +258,6 @@ interface PageTreeBuilderContext<Page extends PageData = PageData, Meta extends
     getUrl: UrlFn;
     storages?: Record<string, ContentStorage<Page, Meta>>;
     locale?: string;
-    visitedPaths: Set<string>;
 }
 interface PageTreeTransformer<Page extends PageData = PageData, Meta extends MetaData = MetaData> {
     file?: (this: PageTreeBuilderContext<Page, Meta>, node: Item, filePath?: string) => Item;

package/dist/chunk-APKPSBSB.js

@@ -0,0 +1,74 @@
+// src/mdx-plugins/remark-directive-admonition.ts
+import { visit } from "unist-util-visit";
+function remarkDirectiveAdmonition({
+  tags: {
+    CalloutContainer = "CalloutContainer",
+    CalloutTitle = "CalloutTitle",
+    CalloutDescription = "CalloutDescription"
+  } = {},
+  types = {
+    note: "info",
+    tip: "info",
+    info: "info",
+    warn: "warning",
+    warning: "warning",
+    danger: "error",
+    success: "success"
+  }
+} = {}) {
+  return (tree) => {
+    visit(tree, "containerDirective", (node) => {
+      if (!(node.name in types)) return;
+      const attributes = [
+        {
+          type: "mdxJsxAttribute",
+          name: "type",
+          value: types[node.name]
+        }
+      ];
+      for (const [k, v] of Object.entries(node.attributes ?? {})) {
+        attributes.push({
+          type: "mdxJsxAttribute",
+          name: k,
+          value: v
+        });
+      }
+      const titleNodes = [];
+      const descriptionNodes = [];
+      for (const item of node.children) {
+        if (item.type === "paragraph" && item.data?.directiveLabel) {
+          titleNodes.push(...item.children);
+        } else {
+          descriptionNodes.push(item);
+        }
+      }
+      const children = [];
+      if (titleNodes.length > 0) {
+        children.push({
+          type: "mdxJsxFlowElement",
+          name: CalloutTitle,
+          attributes: [],
+          children: titleNodes
+        });
+      }
+      if (descriptionNodes.length > 0) {
+        children.push({
+          type: "mdxJsxFlowElement",
+          name: CalloutDescription,
+          attributes: [],
+          children: descriptionNodes
+        });
+      }
+      Object.assign(node, {
+        type: "mdxJsxFlowElement",
+        attributes,
+        name: CalloutContainer,
+        children
+      });
+    });
+  };
+}
+
+export {
+  remarkDirectiveAdmonition
+};

package/dist/{chunk-BBP7MIO4.js → chunk-K4WNLOVQ.js}

@@ -1,12 +1,12 @@
 // src/framework/index.tsx
-import React from "react";
+import { createContext, use, useMemo } from "react";
 import { jsx } from "react/jsx-runtime";
 var notImplemented = () => {
   throw new Error(
     "You need to wrap your application inside `FrameworkProvider`."
   );
 };
-var FrameworkContext = createContext("FrameworkContext", {
+var FrameworkContext = createContext({
   useParams: notImplemented,
   useRouter: notImplemented,
   usePathname: notImplemented
@@ -19,7 +19,7 @@ function FrameworkProvider({
   Image: Image2,
   children
 }) {
-  const framework = React.useMemo(
+  const framework = useMemo(
     () => ({
       usePathname: usePathname2,
       useRouter: useRouter2,
@@ -29,19 +29,19 @@ function FrameworkProvider({
     }),
     [Link2, usePathname2, useRouter2, useParams2, Image2]
   );
-  return /* @__PURE__ */ jsx(FrameworkContext.Provider, { value: framework, children });
+  return /* @__PURE__ */ jsx(FrameworkContext, { value: framework, children });
 }
 function usePathname() {
-  return FrameworkContext.use().usePathname();
+  return use(FrameworkContext).usePathname();
 }
 function useRouter() {
-  return FrameworkContext.use().useRouter();
+  return use(FrameworkContext).useRouter();
 }
 function useParams() {
-  return FrameworkContext.use().useParams();
+  return use(FrameworkContext).useParams();
 }
 function Image(props) {
-  const { Image: Image2 } = FrameworkContext.use();
+  const { Image: Image2 } = use(FrameworkContext);
   if (!Image2) {
     const { src, alt, priority, ...rest } = props;
     return /* @__PURE__ */ jsx(
@@ -57,29 +57,13 @@ function Image(props) {
   return /* @__PURE__ */ jsx(Image2, { ...props });
 }
 function Link(props) {
-  const { Link: Link2 } = FrameworkContext.use();
+  const { Link: Link2 } = use(FrameworkContext);
   if (!Link2) {
     const { href, prefetch: _, ...rest } = props;
     return /* @__PURE__ */ jsx("a", { href, ...rest });
   }
   return /* @__PURE__ */ jsx(Link2, { ...props });
 }
-function createContext(name, v) {
-  const Context = React.createContext(v);
-  return {
-    Provider: (props) => {
-      return /* @__PURE__ */ jsx(Context.Provider, { value: props.value, children: props.children });
-    },
-    use: (errorMessage) => {
-      const value = React.useContext(Context);
-      if (!value)
-        throw new Error(
-          errorMessage ?? `Provider of ${name} is required but missing.`
-        );
-      return value;
-    }
-  };
-}
 
 export {
   FrameworkProvider,
@@ -87,6 +71,5 @@ export {
   useRouter,
   useParams,
   Image,
-  Link,
-  createContext
+  Link
 };

package/dist/{chunk-N2ZQXKIX.js → chunk-SH7BNTG7.js}

@@ -1,6 +1,6 @@
 import {
   Link
-} from "./chunk-BBP7MIO4.js";
+} from "./chunk-K4WNLOVQ.js";
 
 // src/link.tsx
 import { forwardRef } from "react";

package/dist/{chunk-VW3XKOZZ.js → chunk-YDNO7UZ6.js}

@@ -1,8 +1,6 @@
 // src/mdx-plugins/remark-image.ts
 import * as path from "path";
 import { visit } from "unist-util-visit";
-import { imageSize } from "image-size";
-import { imageSizeFromFile } from "image-size/fromFile";
 import { fileURLToPath } from "url";
 var VALID_BLUR_EXT = [".jpeg", ".png", ".webp", ".avif", ".jpg"];
 var EXTERNAL_URL_REGEX = /^https?:\/\//;
@@ -195,7 +193,10 @@ function parseSrc(src, publicDir, dir) {
   };
 }
 async function getImageSize(src, onExternal) {
-  if (src.type === "file") return imageSizeFromFile(src.file);
+  if (src.type === "file") {
+    const { imageSizeFromFile } = await import("image-size/fromFile");
+    return imageSizeFromFile(src.file);
+  }
   if (onExternal === false) return;
   const { timeout } = typeof onExternal === "object" ? onExternal : {};
   const res = await fetch(src.url, {
@@ -206,6 +207,7 @@ async function getImageSize(src, onExternal) {
       `[Remark Image] Failed to fetch ${src.url} (${res.status}): ${await res.text()}`
     );
   }
+  const { imageSize } = await import("image-size");
   return imageSize(new Uint8Array(await res.arrayBuffer()));
 }
 

package/dist/{definitions-DQnHJeWn.d.ts → definitions-DbCug1P3.d.ts}

@@ -1,7 +1,12 @@
 import { ReactNode } from 'react';
 
-interface Root {
+interface INode {
+    /**
+     * ID for the node, unique in all page trees (even across different locales)
+     */
     $id?: string;
+}
+interface Root extends INode {
     name: ReactNode;
     children: Node[];
     /**
@@ -10,8 +15,7 @@ interface Root {
     fallback?: Root;
 }
 type Node = Item | Separator | Folder;
-interface Item {
-    $id?: string;
+interface Item extends INode {
     /**
      * @internal
      */
@@ -30,14 +34,12 @@ interface Item {
     description?: ReactNode;
     icon?: ReactNode;
 }
-interface Separator {
-    $id?: string;
+interface Separator extends INode {
     type: 'separator';
     name?: ReactNode;
     icon?: ReactNode;
 }
-interface Folder {
-    $id?: string;
+interface Folder extends INode {
     /**
      * @internal
      */

package/dist/dynamic-link.js

@@ -1,10 +1,10 @@
 "use client";
 import {
   Link
-} from "./chunk-N2ZQXKIX.js";
+} from "./chunk-SH7BNTG7.js";
 import {
   useParams
-} from "./chunk-BBP7MIO4.js";
+} from "./chunk-K4WNLOVQ.js";
 import "./chunk-U67V476Y.js";
 
 // src/dynamic-link.tsx

package/dist/framework/index.d.ts

@@ -37,12 +37,5 @@ declare function useRouter(): Router;
 declare function useParams(): Record<string, string | string[]>;
 declare function Image(props: ImageProps): react_jsx_runtime.JSX.Element;
 declare function Link(props: LinkProps): react_jsx_runtime.JSX.Element;
-declare function createContext<T>(name: string, v?: T): {
-    Provider: (props: {
-        value: T;
-        children: ReactNode;
-    }) => react_jsx_runtime.JSX.Element;
-    use: (errorMessage?: string) => Exclude<T, undefined | null>;
-};
 
-export { type Framework, FrameworkProvider, Image, type ImageProps, Link, type Router, createContext, useParams, usePathname, useRouter };
+export { type Framework, FrameworkProvider, Image, type ImageProps, Link, type Router, useParams, usePathname, useRouter };

package/dist/framework/index.js

@@ -3,17 +3,15 @@ import {
   FrameworkProvider,
   Image,
   Link,
-  createContext,
   useParams,
   usePathname,
   useRouter
-} from "../chunk-BBP7MIO4.js";
+} from "../chunk-K4WNLOVQ.js";
 import "../chunk-U67V476Y.js";
 export {
   FrameworkProvider,
   Image,
   Link,
-  createContext,
   useParams,
   usePathname,
   useRouter

package/dist/framework/next.js

@@ -1,7 +1,7 @@
 "use client";
 import {
   FrameworkProvider
-} from "../chunk-BBP7MIO4.js";
+} from "../chunk-K4WNLOVQ.js";
 import "../chunk-U67V476Y.js";
 
 // src/framework/next.tsx

package/dist/framework/react-router.js

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

package/dist/framework/tanstack.js

@@ -1,6 +1,6 @@
 import {
   FrameworkProvider
-} from "../chunk-BBP7MIO4.js";
+} from "../chunk-K4WNLOVQ.js";
 import "../chunk-U67V476Y.js";
 
 // src/framework/tanstack.tsx

package/dist/framework/waku.js

@@ -1,7 +1,7 @@
 "use client";
 import {
   FrameworkProvider
-} from "../chunk-BBP7MIO4.js";
+} from "../chunk-K4WNLOVQ.js";
 import "../chunk-U67V476Y.js";
 
 // src/framework/waku.tsx

package/dist/link.js

@@ -1,8 +1,8 @@
 "use client";
 import {
   Link
-} from "./chunk-N2ZQXKIX.js";
-import "./chunk-BBP7MIO4.js";
+} from "./chunk-SH7BNTG7.js";
+import "./chunk-K4WNLOVQ.js";
 import "./chunk-U67V476Y.js";
 export {
   Link as default

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

@@ -4,6 +4,7 @@ export { RemarkImageOptions, remarkImage } from './remark-image.js';
 export { StructureOptions, StructuredData, remarkStructure, structure } from './remark-structure.js';
 export { RemarkHeadingOptions, remarkHeading } from './remark-heading.js';
 export { RemarkAdmonitionOptions, remarkAdmonition } from './remark-admonition.js';
+export { RemarkDirectiveAdmonitionOptions, remarkDirectiveAdmonition } from './remark-directive-admonition.js';
 export { RehypeTocOptions, rehypeToc } from './rehype-toc.js';
 export { RemarkCodeTabOptions, remarkCodeTab } from './remark-code-tab.js';
 export { RemarkStepsOptions, remarkSteps } from './remark-steps.js';

package/dist/mdx-plugins/index.js

@@ -3,7 +3,7 @@ import {
 } from "../chunk-ONG4RVCR.js";
 import {
   remarkImage
-} from "../chunk-VW3XKOZZ.js";
+} from "../chunk-YDNO7UZ6.js";
 import {
   remarkMdxFiles
 } from "../chunk-ADBHPKXG.js";
@@ -39,6 +39,9 @@ import {
   generateCodeBlockTabs,
   parseCodeBlockAttributes
 } from "../chunk-TWIDBWFG.js";
+import {
+  remarkDirectiveAdmonition
+} from "../chunk-APKPSBSB.js";
 import "../chunk-XN2LKXFZ.js";
 import {
   remarkHeading
@@ -53,6 +56,7 @@ export {
   rehypeToc,
   remarkAdmonition,
   remarkCodeTab,
+  remarkDirectiveAdmonition,
   default2 as remarkGfm,
   remarkHeading,
   remarkImage,

package/dist/mdx-plugins/remark-admonition.d.ts

@@ -12,6 +12,8 @@ interface RemarkAdmonitionOptions {
  * Remark Plugin to support Admonition syntax
  *
  * Useful when Migrating from Docusaurus
+ *
+ * @deprecated Use `remarkDirectiveAdmonition` with `remark-directive` configured instead.
  */
 declare function remarkAdmonition(options?: RemarkAdmonitionOptions): Transformer<Root, Root>;
 

package/dist/mdx-plugins/remark-directive-admonition.d.ts

@@ -0,0 +1,27 @@
+import { Root } from 'mdast';
+import { Transformer } from 'unified';
+
+interface RemarkDirectiveAdmonitionOptions {
+    /**
+     * the tag names of Callout component.
+     */
+    tags?: {
+        CalloutContainer?: string;
+        CalloutTitle?: string;
+        CalloutDescription?: string;
+    };
+    /**
+     * All supported admonition types and their linked Callout type.
+     *
+     * When specified, all defaults will be cleared.
+     */
+    types?: Record<string, string>;
+}
+/**
+ * Remark Plugin to support Admonition syntax in Docusaurus, useful for migrating from Docusaurus.
+ *
+ * Requires [`remark-directive`](https://github.com/remarkjs/remark-directive) to be configured.
+ */
+declare function remarkDirectiveAdmonition({ tags: { CalloutContainer, CalloutTitle, CalloutDescription, }, types, }?: RemarkDirectiveAdmonitionOptions): Transformer<Root, Root>;
+
+export { type RemarkDirectiveAdmonitionOptions, remarkDirectiveAdmonition };

package/dist/mdx-plugins/remark-directive-admonition.js

@@ -0,0 +1,7 @@
+import {
+  remarkDirectiveAdmonition
+} from "../chunk-APKPSBSB.js";
+import "../chunk-U67V476Y.js";
+export {
+  remarkDirectiveAdmonition
+};

package/dist/mdx-plugins/remark-image.js

@@ -1,6 +1,6 @@
 import {
   remarkImage
-} from "../chunk-VW3XKOZZ.js";
+} from "../chunk-YDNO7UZ6.js";
 import "../chunk-U67V476Y.js";
 export {
   remarkImage

package/dist/page-tree/index.d.ts

@@ -1,5 +1,5 @@
-import { N as Node, I as Item, R as Root, F as Folder } from '../definitions-DQnHJeWn.js';
-export { S as Separator } from '../definitions-DQnHJeWn.js';
+import { N as Node, I as Item, R as Root, F as Folder } from '../definitions-DbCug1P3.js';
+export { S as Separator } from '../definitions-DbCug1P3.js';
 import 'react';
 
 /**

package/dist/search/server.d.ts

@@ -3,12 +3,12 @@ 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 { k as LoaderOutput, f as LoaderConfig, I as InferPageType } from '../builder-BynMF2Pa.js';
+import { k as LoaderOutput, f as LoaderConfig, I as InferPageType } from '../builder-DEvYXjy8.js';
 import 'mdast';
 import 'unified';
 import 'mdast-util-mdx-jsx';
 import 'react';
-import '../definitions-DQnHJeWn.js';
+import '../definitions-DbCug1P3.js';
 
 type SimpleDocument = TypedDocument<Orama<typeof simpleSchema>>;
 declare const simpleSchema: {

package/dist/source/index.d.ts

@@ -1,5 +1,5 @@
-export { C as ContentStorage, F as FileSystem, t as InferMetaType, I as InferPageType, f as LoaderConfig, g as LoaderOptions, k as LoaderOutput, L as LoaderPlugin, j as Meta, p as MetaData, M as MetaFile, i as Page, q as PageData, e as PageFile, a as PageTreeBuilder, b as PageTreeBuilderContext, d as PageTreeOptions, P as PageTreeTransformer, R as ResolvedLoaderConfig, h as Source, S as SourceConfig, U as UrlFn, s as VirtualFile, r as VirtualMeta, V as VirtualPage, _ as _ConfigUnion_, u as buildPlugins, l as createGetUrl, c as createPageTreeBuilder, m as loader, o as map, n as multiple } from '../builder-BynMF2Pa.js';
-import '../definitions-DQnHJeWn.js';
+export { C as ContentStorage, F as FileSystem, t as InferMetaType, I as InferPageType, f as LoaderConfig, g as LoaderOptions, k as LoaderOutput, L as LoaderPlugin, j as Meta, p as MetaData, M as MetaFile, i as Page, q as PageData, e as PageFile, a as PageTreeBuilder, b as PageTreeBuilderContext, d as PageTreeOptions, P as PageTreeTransformer, R as ResolvedLoaderConfig, h as Source, S as SourceConfig, U as UrlFn, s as VirtualFile, r as VirtualMeta, V as VirtualPage, _ as _ConfigUnion_, u as buildPlugins, l as createGetUrl, c as createPageTreeBuilder, m as loader, o as map, n as multiple } from '../builder-DEvYXjy8.js';
+import '../definitions-DbCug1P3.js';
 import 'react';
 import '../i18n/index.js';
 

package/dist/source/index.js

@@ -54,217 +54,31 @@ var rest = "...";
 var restReversed = "z...a";
 var extractPrefix = "...";
 var excludePrefix = "!";
-function buildAll(paths, ctx, reversed = false) {
-  const items = [];
-  const folders = [];
-  const sortedPaths = paths.sort(
-    (a, b) => a.localeCompare(b) * (reversed ? -1 : 1)
-  );
-  for (const path of sortedPaths) {
-    ctx.visitedPaths.add(path);
-    const fileNode = buildFileNode(path, ctx);
-    if (fileNode) {
-      if (basename(path, extname(path)) === "index") items.unshift(fileNode);
-      else items.push(fileNode);
-      continue;
-    }
-    const dirNode = buildFolderNode(path, false, ctx);
-    if (dirNode) folders.push(dirNode);
-  }
-  return [...items, ...folders];
-}
-function resolveFolderItem(folderPath, item, ctx, idx) {
-  if (item === rest || item === restReversed) return item;
-  const { resolveName } = ctx;
-  let match = separator.exec(item);
-  if (match?.groups) {
-    let node = {
-      $id: `${folderPath}#${idx}`,
-      type: "separator",
-      icon: match.groups.icon,
-      name: match.groups.name
-    };
-    for (const transformer of ctx.transformers) {
-      if (!transformer.separator) continue;
-      node = transformer.separator.call(ctx, node);
-    }
-    return [node];
-  }
-  match = link.exec(item);
-  if (match?.groups) {
-    const { icon, url, name, external } = match.groups;
-    let node = {
-      type: "page",
-      icon,
-      name,
-      url,
-      external: external ? true : void 0
-    };
-    for (const transformer of ctx.transformers) {
-      if (!transformer.file) continue;
-      node = transformer.file.call(ctx, node);
-    }
-    return [node];
-  }
-  const isExcept = item.startsWith(excludePrefix);
-  const isExtract = !isExcept && item.startsWith(extractPrefix);
-  let filename = item;
-  if (isExcept) {
-    filename = item.slice(excludePrefix.length);
-  } else if (isExtract) {
-    filename = item.slice(extractPrefix.length);
-  }
-  const path = resolveName(joinPath(folderPath, filename), "page");
-  ctx.visitedPaths.add(path);
-  if (isExcept) return [];
-  const dirNode = buildFolderNode(path, false, ctx);
-  if (dirNode) {
-    return isExtract ? dirNode.children : [dirNode];
-  }
-  const fileNode = buildFileNode(path, ctx);
-  return fileNode ? [fileNode] : [];
-}
-function buildFolderNode(folderPath, isGlobalRoot, ctx) {
-  const { storage, options, resolveName, transformers } = 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 = storage.read(metaPath);
-  if (meta?.format !== "meta") {
-    meta = void 0;
-  }
-  const isRoot = meta?.data.root ?? isGlobalRoot;
-  let index;
-  let children;
-  function setIndexIfUnused() {
-    if (isRoot || ctx.visitedPaths.has(indexPath)) return;
-    ctx.visitedPaths.add(indexPath);
-    index = buildFileNode(indexPath, ctx);
-  }
-  if (meta && meta.data.pages) {
-    const resolved = meta.data.pages.flatMap((item, i) => resolveFolderItem(folderPath, item, ctx, i));
-    setIndexIfUnused();
-    for (let i = 0; i < resolved.length; i++) {
-      const item = resolved[i];
-      if (item !== rest && item !== restReversed) continue;
-      const items = buildAll(
-        files.filter((file) => !ctx.visitedPaths.has(file)),
-        ctx,
-        item === restReversed
-      );
-      resolved.splice(i, 1, ...items);
-      break;
-    }
-    children = resolved;
-  } else {
-    setIndexIfUnused();
-    children = buildAll(
-      files.filter((file) => !ctx.visitedPaths.has(file)),
-      ctx
-    );
-  }
-  let name = meta?.data.title ?? index?.name;
-  if (!name) {
-    const folderName = basename(folderPath);
-    name = pathToName(group.exec(folderName)?.[1] ?? folderName);
-  }
-  let node = {
-    type: "folder",
-    name,
-    icon: meta?.data.icon ?? index?.icon,
-    root: meta?.data.root,
-    defaultOpen: meta?.data.defaultOpen,
-    description: meta?.data.description,
-    index,
-    children,
-    $id: folderPath,
-    $ref: !options.noRef && meta ? {
-      metaFile: metaPath
-    } : void 0
-  };
-  for (const transformer of transformers) {
-    if (!transformer.folder) continue;
-    node = transformer.folder.call(ctx, node, folderPath, metaPath);
-  }
-  return node;
-}
-function buildFileNode(path, ctx) {
-  const { options, getUrl, storage, locale, transformers } = ctx;
-  const page = storage.read(path);
-  if (page?.format !== "page") return;
-  const { title, description, icon } = page.data;
-  let item = {
-    $id: path,
-    type: "page",
-    name: title ?? pathToName(basename(path, extname(path))),
-    description,
-    icon,
-    url: getUrl(page.slugs, locale),
-    $ref: !options.noRef ? {
-      file: path
-    } : void 0
-  };
-  for (const transformer of transformers) {
-    if (!transformer.file) continue;
-    item = transformer.file.call(ctx, item, path);
-  }
-  return item;
-}
-function build(id, ctx) {
-  const folder = buildFolderNode("", true, ctx);
-  let root = {
-    $id: id,
-    name: folder.name || "Docs",
-    children: folder.children
-  };
-  for (const transformer of ctx.transformers) {
-    if (!transformer.root) continue;
-    root = transformer.root.call(ctx, root);
-  }
-  return root;
-}
 function createPageTreeBuilder(getUrl, plugins) {
-  function getTransformers({
-    generateFallback = true,
-    ...options
-  }) {
-    const transformers = [];
-    if (options.transformers) {
-      transformers.push(...options.transformers);
-    }
-    for (const plugin of plugins ?? []) {
-      if (plugin.transformPageTree) transformers.push(plugin.transformPageTree);
-    }
-    if (generateFallback) {
-      transformers.push(transformerFallback());
-    }
-    return transformers;
-  }
-  function createFlattenPathResolver(storage) {
-    const map2 = /* @__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);
-    }
-    return (name, format) => {
-      return map2.get(name + "." + format);
-    };
-  }
   return {
     build(storage, options) {
       const key = "";
       return this.buildI18n({ [key]: storage }, options)[key];
     },
     buildI18n(storages, options = {}) {
-      const transformers = getTransformers(options);
+      let nextId = 0;
       const out = {};
+      const transformers = [];
+      if (options.transformers) {
+        transformers.push(...options.transformers);
+      }
+      for (const plugin of plugins ?? []) {
+        if (plugin.transformPageTree)
+          transformers.push(plugin.transformPageTree);
+      }
+      if (options.generateFallback ?? true) {
+        transformers.push(transformerFallback());
+      }
       for (const [locale, storage] of Object.entries(storages)) {
-        const resolve = createFlattenPathResolver(storage);
-        const branch = locale.length === 0 ? "root" : locale;
-        out[locale] = build(options.id ? `${options.id}-${branch}` : branch, {
+        let rootId = locale.length === 0 ? "root" : locale;
+        if (options.id) rootId = `${options.id}-${rootId}`;
+        out[locale] = createPageTreeBuilderUtils({
+          rootId,
           transformers,
           builder: this,
           options,
@@ -272,16 +86,210 @@ function createPageTreeBuilder(getUrl, plugins) {
           locale,
           storage,
           storages,
-          visitedPaths: /* @__PURE__ */ new Set(),
-          resolveName(name, format) {
-            return resolve(name, format) ?? name;
+          generateNodeId() {
+            return "_" + nextId++;
           }
-        });
+        }).root();
       }
       return out;
     }
   };
 }
+function createFlattenPathResolver(storage) {
+  const map2 = /* @__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);
+  }
+  return (name, format) => {
+    return map2.get(name + "." + format) ?? name;
+  };
+}
+function createPageTreeBuilderUtils(ctx) {
+  const resolveFlattenPath = createFlattenPathResolver(ctx.storage);
+  const visitedPaths = /* @__PURE__ */ new Set();
+  function nextNodeId(localId = ctx.generateNodeId()) {
+    return `${ctx.rootId}:${localId}`;
+  }
+  return {
+    buildPaths(paths, reversed = false) {
+      const items = [];
+      const folders = [];
+      const sortedPaths = paths.sort(
+        (a, b) => a.localeCompare(b) * (reversed ? -1 : 1)
+      );
+      for (const path of sortedPaths) {
+        const fileNode = this.file(path);
+        if (fileNode) {
+          if (basename(path, extname(path)) === "index")
+            items.unshift(fileNode);
+          else items.push(fileNode);
+          continue;
+        }
+        const dirNode = this.folder(path, false);
+        if (dirNode) folders.push(dirNode);
+      }
+      return [...items, ...folders];
+    },
+    resolveFolderItem(folderPath, item) {
+      if (item === rest || item === restReversed) return item;
+      let match = separator.exec(item);
+      if (match?.groups) {
+        let node = {
+          $id: nextNodeId(),
+          type: "separator",
+          icon: match.groups.icon,
+          name: match.groups.name
+        };
+        for (const transformer of ctx.transformers) {
+          if (!transformer.separator) continue;
+          node = transformer.separator.call(ctx, node);
+        }
+        return [node];
+      }
+      match = link.exec(item);
+      if (match?.groups) {
+        const { icon, url, name, external } = match.groups;
+        let node = {
+          $id: nextNodeId(),
+          type: "page",
+          icon,
+          name,
+          url,
+          external: external ? true : void 0
+        };
+        for (const transformer of ctx.transformers) {
+          if (!transformer.file) continue;
+          node = transformer.file.call(ctx, node);
+        }
+        return [node];
+      }
+      const isExcept = item.startsWith(excludePrefix);
+      const isExtract = !isExcept && item.startsWith(extractPrefix);
+      let filename = item;
+      if (isExcept) {
+        filename = item.slice(excludePrefix.length);
+      } else if (isExtract) {
+        filename = item.slice(extractPrefix.length);
+      }
+      const path = resolveFlattenPath(joinPath(folderPath, filename), "page");
+      if (isExcept) {
+        visitedPaths.add(path);
+        return [];
+      }
+      const dirNode = this.folder(path, false);
+      if (dirNode) {
+        return isExtract ? dirNode.children : [dirNode];
+      }
+      const fileNode = this.file(path);
+      return fileNode ? [fileNode] : [];
+    },
+    folder(folderPath, isGlobalRoot) {
+      const { storage, options, transformers } = ctx;
+      const files = storage.readDir(folderPath);
+      if (!files) return;
+      const metaPath = resolveFlattenPath(joinPath(folderPath, "meta"), "meta");
+      const indexPath = resolveFlattenPath(
+        joinPath(folderPath, "index"),
+        "page"
+      );
+      let meta = storage.read(metaPath);
+      if (meta?.format !== "meta") {
+        meta = void 0;
+      }
+      const isRoot = meta?.data.root ?? isGlobalRoot;
+      let index;
+      let children;
+      if (meta && meta.data.pages) {
+        const resolved = meta.data.pages.flatMap((item) => this.resolveFolderItem(folderPath, item));
+        if (!isRoot && !visitedPaths.has(indexPath)) {
+          index = this.file(indexPath);
+        }
+        for (let i = 0; i < resolved.length; i++) {
+          const item = resolved[i];
+          if (item !== rest && item !== restReversed) continue;
+          const items = this.buildPaths(
+            files.filter((file) => !visitedPaths.has(file)),
+            item === restReversed
+          );
+          resolved.splice(i, 1, ...items);
+          break;
+        }
+        children = resolved;
+      } else {
+        if (!isRoot && !visitedPaths.has(indexPath)) {
+          index = this.file(indexPath);
+        }
+        children = this.buildPaths(
+          files.filter((file) => !visitedPaths.has(file))
+        );
+      }
+      let name = meta?.data.title ?? index?.name;
+      if (!name) {
+        const folderName = basename(folderPath);
+        name = pathToName(group.exec(folderName)?.[1] ?? folderName);
+      }
+      let node = {
+        type: "folder",
+        name,
+        icon: meta?.data.icon ?? index?.icon,
+        root: meta?.data.root,
+        defaultOpen: meta?.data.defaultOpen,
+        description: meta?.data.description,
+        index,
+        children,
+        $id: nextNodeId(folderPath),
+        $ref: !options.noRef && meta ? {
+          metaFile: metaPath
+        } : void 0
+      };
+      visitedPaths.add(folderPath);
+      for (const transformer of transformers) {
+        if (!transformer.folder) continue;
+        node = transformer.folder.call(ctx, node, folderPath, metaPath);
+      }
+      return node;
+    },
+    file(path) {
+      const { options, getUrl, storage, locale, transformers } = ctx;
+      const page = storage.read(path);
+      if (page?.format !== "page") return;
+      const { title, description, icon } = page.data;
+      let item = {
+        $id: nextNodeId(path),
+        type: "page",
+        name: title ?? pathToName(basename(path, extname(path))),
+        description,
+        icon,
+        url: getUrl(page.slugs, locale),
+        $ref: !options.noRef ? {
+          file: path
+        } : void 0
+      };
+      visitedPaths.add(path);
+      for (const transformer of transformers) {
+        if (!transformer.file) continue;
+        item = transformer.file.call(ctx, item, path);
+      }
+      return item;
+    },
+    root() {
+      const folder = this.folder("", true);
+      let root = {
+        $id: ctx.rootId,
+        name: folder.name || "Docs",
+        children: folder.children
+      };
+      for (const transformer of ctx.transformers) {
+        if (!transformer.root) continue;
+        root = transformer.root.call(ctx, root);
+      }
+      return root;
+    }
+  };
+}
 function pathToName(name) {
   const result = [];
   for (const c of name) {

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

@@ -1,6 +1,6 @@
-import { L as LoaderPlugin } from '../../builder-BynMF2Pa.js';
+import { L as LoaderPlugin } from '../../builder-DEvYXjy8.js';
 import { icons } from 'lucide-react';
-import '../../definitions-DQnHJeWn.js';
+import '../../definitions-DbCug1P3.js';
 import 'react';
 import '../../i18n/index.js';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-core",
-  "version": "16.0.9",
+  "version": "16.0.11",
   "description": "The library for building a documentation website in any React.js framework",
   "keywords": [
     "Fumadocs",
@@ -142,6 +142,7 @@
     "mdast-util-mdxjs-esm": "^2.0.1",
     "next": "16.0.1",
     "react-router": "^7.9.5",
+    "remark-directive": "^4.0.0",
     "remark-mdx": "^3.1.1",
     "remove-markdown": "^0.6.2",
     "typescript": "^5.9.3",