fumadocs-core 16.2.1 → 16.2.3

package/dist/breadcrumb.d.ts

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

package/dist/breadcrumb.js

@@ -1,9 +1,9 @@
-import {
-  findPath
-} from "./chunk-IZPLHEX4.js";
 import {
   normalizeUrl
 } from "./chunk-PFNP6PEB.js";
+import {
+  findPath
+} from "./chunk-XKUN7AUK.js";
 import "./chunk-U67V476Y.js";
 
 // src/breadcrumb.tsx

package/dist/{chunk-YDNO7UZ6.js → chunk-5PMI7QDD.js}

@@ -15,6 +15,20 @@ function remarkImage({
     const importsToInject = [];
     const promises = [];
     async function onImage(src, node) {
+      const attributes = [
+        {
+          type: "mdxJsxAttribute",
+          name: "alt",
+          value: node.alt ?? "image"
+        }
+      ];
+      if (node.title) {
+        attributes.push({
+          type: "mdxJsxAttribute",
+          name: "title",
+          value: node.title
+        });
+      }
       if (src.type === "file" && useImport) {
         const variableName = `__img${importsToInject.length}`;
         const hasBlur = placeholder === "blur" && VALID_BLUR_EXT.some((ext) => src.file.endsWith(ext));
@@ -27,37 +41,31 @@ function remarkImage({
           variableName,
           importPath: getImportPath(src.file, file.dirname)
         });
+        attributes.push({
+          type: "mdxJsxAttribute",
+          name: "src",
+          value: {
+            type: "mdxJsxAttributeValueExpression",
+            value: variableName,
+            data: {
+              estree: {
+                body: [
+                  {
+                    type: "ExpressionStatement",
+                    expression: { type: "Identifier", name: variableName }
+                  }
+                ],
+                type: "Program",
+                sourceType: "script"
+              }
+            }
+          }
+        });
         const out = {
           children: [],
           type: "mdxJsxFlowElement",
           name: "img",
-          attributes: [
-            {
-              type: "mdxJsxAttribute",
-              name: "alt",
-              value: node.alt ?? "image"
-            },
-            {
-              type: "mdxJsxAttribute",
-              name: "src",
-              value: {
-                type: "mdxJsxAttributeValueExpression",
-                value: variableName,
-                data: {
-                  estree: {
-                    body: [
-                      {
-                        type: "ExpressionStatement",
-                        expression: { type: "Identifier", name: variableName }
-                      }
-                    ],
-                    type: "Program",
-                    sourceType: "script"
-                  }
-                }
-              }
-            }
-          ]
+          attributes
         };
         if (hasBlur) {
           out.attributes.push({
@@ -77,32 +85,28 @@ function remarkImage({
         );
       });
       if (!size) return;
+      attributes.push(
+        {
+          type: "mdxJsxAttribute",
+          name: "src",
+          // `src` doesn't support file paths, we can use `node.url` for files and let the underlying framework handle it
+          value: src.type === "url" ? src.url.toString() : node.url
+        },
+        {
+          type: "mdxJsxAttribute",
+          name: "width",
+          value: size.width.toString()
+        },
+        {
+          type: "mdxJsxAttribute",
+          name: "height",
+          value: size.height.toString()
+        }
+      );
       return {
         type: "mdxJsxFlowElement",
         name: "img",
-        attributes: [
-          {
-            type: "mdxJsxAttribute",
-            name: "alt",
-            value: node.alt ?? "image"
-          },
-          {
-            type: "mdxJsxAttribute",
-            name: "src",
-            // `src` doesn't support file paths, we can use `node.url` for files and let the underlying framework handle it
-            value: src.type === "url" ? src.url.toString() : node.url
-          },
-          {
-            type: "mdxJsxAttribute",
-            name: "width",
-            value: size.width.toString()
-          },
-          {
-            type: "mdxJsxAttribute",
-            name: "height",
-            value: size.height.toString()
-          }
-        ],
+        attributes,
         children: []
       };
     }

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

@@ -45,36 +45,21 @@ function getPageTreePeers(treeOrTrees, url) {
       (item) => item.type === "page" && item.url !== url
     );
   }
-  const trees = treeOrTrees;
-  for (const lang in trees) {
-    const rootTree = trees[lang];
-    if (rootTree) {
-      const parent = findParentFromTree(rootTree, url);
-      if (parent) {
-        return parent.children.filter(
-          (item) => item.type === "page" && item.url !== url
-        );
-      }
-    }
+  for (const lang in treeOrTrees) {
+    const result = getPageTreePeers(treeOrTrees[lang], url);
+    if (result) return result;
   }
   return [];
 }
-function findParentFromTree(node, url) {
-  if ("index" in node && node.index?.url === url) {
-    return node;
-  }
-  for (const child of node.children) {
-    if (child.type === "folder") {
-      const parent = findParentFromTree(child, url);
-      if (parent) return parent;
-    }
-    if (child.type === "page" && child.url === url) {
-      return node;
+function findParentFromTree(from, url) {
+  let result;
+  visit(from, (node, parent) => {
+    if ("type" in node && node.type === "page" && node.url === url) {
+      result = parent;
+      return "break";
     }
-  }
-  if ("fallback" in node && node.fallback) {
-    return findParentFromTree(node.fallback, url);
-  }
+  });
+  return result;
 }
 function findPath(nodes, matcher, options = {}) {
   const { includeSeparator = true } = options;
@@ -103,11 +88,44 @@ function findPath(nodes, matcher, options = {}) {
   }
   return run(nodes) ?? null;
 }
+var VisitBreak = Symbol("VisitBreak");
+function visit(root, visitor) {
+  function onNode(node, parent) {
+    const result = visitor(node, parent);
+    switch (result) {
+      case "skip":
+        return node;
+      case "break":
+        throw VisitBreak;
+      default:
+        if (result) node = result;
+    }
+    if ("index" in node && node.index) {
+      node.index = onNode(node.index, node);
+    }
+    if ("fallback" in node && node.fallback) {
+      node.fallback = onNode(node.fallback, node);
+    }
+    if ("children" in node) {
+      for (let i = 0; i < node.children.length; i++) {
+        node.children[i] = onNode(node.children[i], node);
+      }
+    }
+    return node;
+  }
+  try {
+    return onNode(root);
+  } catch (e) {
+    if (e === VisitBreak) return root;
+    throw e;
+  }
+}
 
 export {
   flattenTree,
   findNeighbour,
   getPageTreeRoots,
   getPageTreePeers,
-  findPath
+  findPath,
+  visit
 };

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

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

package/dist/{fetch-2XFMBLBA.js → fetch-IBTWQCJR.js}

@@ -8,10 +8,10 @@ async function fetchDocs(query, { api = "/api/search", locale, tag }) {
   if (locale) url.searchParams.set("locale", locale);
   if (tag)
     url.searchParams.set("tag", Array.isArray(tag) ? tag.join(",") : tag);
-  const key = `${url.pathname}?${url.searchParams}`;
+  const key = url.toString();
   const cached = cache.get(key);
   if (cached) return cached;
-  const res = await fetch(key);
+  const res = await fetch(url);
   if (!res.ok) throw new Error(await res.text());
   const result = await res.json();
   cache.set(key, result);

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

@@ -1,4 +1,4 @@
-import { R as Root, I as Item, F as Folder, S as Separator } from './definitions-DbCug1P3.js';
+import { R as Root, I as Item, F as Folder, S as Separator } from './definitions-pJ7PybYY.js';
 import { I18nConfig } from './i18n/index.js';
 import { ReactNode } from 'react';
 
@@ -15,6 +15,7 @@ interface MetaData {
     root?: boolean | undefined;
     pages?: string[] | undefined;
     defaultOpen?: boolean | undefined;
+    collapsible?: boolean | undefined;
     description?: string | undefined;
 }
 interface PageData {
@@ -280,6 +281,10 @@ interface LoaderOutput<Config extends LoaderConfig> {
      * @param lang - customise parameter name for lang
      */
     generateParams: <TSlug extends string = 'slug', TLang extends string = 'lang'>(slug?: TSlug, lang?: TLang) => (Record<TSlug, string[]> & Record<TLang, string>)[];
+    /**
+     * serialize page tree for non-RSC environments
+     */
+    serializePageTree: (tree: Root) => Promise<object>;
 }
 declare function createGetUrl(baseUrl: string, i18n?: I18nConfig): ResolvedLoaderConfig['url'];
 declare function loader<Config extends SourceConfig, I18n extends I18nConfig | undefined = undefined>(source: Source<Config>, options: LoaderOptions<{

package/dist/mdx-plugins/index.js

@@ -1,9 +1,6 @@
-import {
-  default as default2
-} from "../chunk-ONG4RVCR.js";
 import {
   remarkImage
-} from "../chunk-YDNO7UZ6.js";
+} from "../chunk-5PMI7QDD.js";
 import {
   remarkMdxFiles
 } from "../chunk-ADBHPKXG.js";
@@ -42,6 +39,9 @@ import {
 import {
   remarkDirectiveAdmonition
 } from "../chunk-APKPSBSB.js";
+import {
+  default as default2
+} from "../chunk-ONG4RVCR.js";
 import "../chunk-XN2LKXFZ.js";
 import {
   remarkHeading

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

@@ -1,6 +1,6 @@
 import {
   remarkImage
-} from "../chunk-YDNO7UZ6.js";
+} from "../chunk-5PMI7QDD.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-DbCug1P3.js';
-export { S as Separator } from '../definitions-DbCug1P3.js';
+import { N as Node, I as Item, R as Root, F as Folder } from '../definitions-pJ7PybYY.js';
+export { S as Separator } from '../definitions-pJ7PybYY.js';
 import 'react';
 
 /**
@@ -28,5 +28,6 @@ declare function getPageTreePeers(treeOrTrees: Root | Record<string, Root>, url:
 declare function findPath(nodes: Node[], matcher: (node: Node) => boolean, options?: {
     includeSeparator?: boolean;
 }): Node[] | null;
+declare function visit<Root extends Node | Root>(root: Root, visitor: <T extends Node | Root>(node: T, parent?: Root | Folder) => 'skip' | 'break' | T | void): Root;
 
-export { Folder, Item, Node, Root, findNeighbour, findPath, flattenTree, getPageTreePeers, getPageTreeRoots };
+export { Folder, Item, Node, Root, findNeighbour, findPath, flattenTree, getPageTreePeers, getPageTreeRoots, visit };

package/dist/page-tree/index.js

@@ -3,13 +3,15 @@ import {
   findPath,
   flattenTree,
   getPageTreePeers,
-  getPageTreeRoots
-} from "../chunk-IZPLHEX4.js";
+  getPageTreeRoots,
+  visit
+} from "../chunk-XKUN7AUK.js";
 import "../chunk-U67V476Y.js";
 export {
   findNeighbour,
   findPath,
   flattenTree,
   getPageTreePeers,
-  getPageTreeRoots
+  getPageTreeRoots,
+  visit
 };

package/dist/search/client.d.ts

@@ -13,7 +13,7 @@ import 'react';
 
 interface FetchOptions {
     /**
-     * API route for search endpoint
+     * API route for search endpoint, support absolute URLs.
      *
      * @defaultValue '/api/search'
      */

package/dist/search/client.js

@@ -58,7 +58,7 @@ function useDocsSearch(clientOptions) {
       async function run() {
         if (debouncedValue.length === 0 && !allowEmpty) return "empty";
         if (client.type === "fetch") {
-          const { fetchDocs } = await import("../fetch-2XFMBLBA.js");
+          const { fetchDocs } = await import("../fetch-IBTWQCJR.js");
           return fetchDocs(debouncedValue, client);
         }
         if (client.type === "algolia") {

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 { g as LoaderOutput, c as LoaderConfig, I as InferPageType } from '../loader-DgL6G4CA.js';
+import { g as LoaderOutput, c as LoaderConfig, I as InferPageType } from '../loader-qkSHi822.js';
 import 'mdast';
 import 'unified';
 import 'mdast-util-mdx-jsx';
 import 'react';
-import '../definitions-DbCug1P3.js';
+import '../definitions-pJ7PybYY.js';
 
 type SimpleDocument = TypedDocument<Orama<typeof simpleSchema>>;
 declare const simpleSchema: {

package/dist/search/server.js

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

package/dist/source/client/index.d.ts

@@ -0,0 +1,16 @@
+import { R as Root } from '../../definitions-pJ7PybYY.js';
+import 'react';
+
+declare function deserializePageTree(root: Root): Root;
+/**
+ * Deserialize data passed from server-side loader.
+ *
+ * It only receives the serialized data from server-side, hence not sharing plugins and some properties.
+ */
+declare function useFumadocsLoader<V extends {
+    pageTree?: object;
+}>(serialized: V): {
+    pageTree: V["pageTree"] extends object ? Root : undefined;
+};
+
+export { deserializePageTree, useFumadocsLoader };

package/dist/source/client/index.js

@@ -0,0 +1,41 @@
+import {
+  visit
+} from "../../chunk-XKUN7AUK.js";
+import "../../chunk-U67V476Y.js";
+
+// src/source/client/index.tsx
+import { useMemo } from "react";
+import { jsx } from "react/jsx-runtime";
+function deserializePageTree(root) {
+  function deserializeHTML(html) {
+    return /* @__PURE__ */ jsx(
+      "span",
+      {
+        dangerouslySetInnerHTML: {
+          __html: html
+        }
+      }
+    );
+  }
+  visit(root, (item) => {
+    if ("icon" in item && typeof item.icon === "string") {
+      item.icon = deserializeHTML(item.icon);
+    }
+    if (typeof item.name === "string") {
+      item.name = deserializeHTML(item.name);
+    }
+  });
+  return root;
+}
+function useFumadocsLoader(serialized) {
+  const { pageTree } = serialized;
+  return useMemo(() => {
+    return {
+      pageTree: pageTree ? deserializePageTree(pageTree) : void 0
+    };
+  }, [pageTree]);
+}
+export {
+  deserializePageTree,
+  useFumadocsLoader
+};

package/dist/source/index.d.ts

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

package/dist/source/index.js

@@ -13,6 +13,9 @@ import {
 import {
   normalizeUrl
 } from "../chunk-PFNP6PEB.js";
+import {
+  visit
+} from "../chunk-XKUN7AUK.js";
 import "../chunk-U67V476Y.js";
 
 // src/source/source.ts
@@ -330,7 +333,8 @@ function createPageTreeBuilderUtils(ctx) {
         const dirNode = this.folder(path, false);
         if (dirNode) folders.push(dirNode);
       }
-      return [...items, ...folders];
+      items.push(...folders);
+      return items;
     },
     resolveFolderItem(folderPath, item) {
       if (item === rest || item === restReversed) return item;
@@ -395,15 +399,14 @@ function createPageTreeBuilderUtils(ctx) {
         "page"
       );
       let meta = storage.read(metaPath);
-      if (meta?.format !== "meta") {
-        meta = void 0;
-      }
-      const isRoot = meta?.data.root ?? isGlobalRoot;
+      if (meta && meta.format !== "meta") meta = void 0;
+      const metadata = meta?.data ?? {};
+      const { root = isGlobalRoot, pages } = metadata;
       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)) {
+      if (pages) {
+        const resolved = pages.flatMap((item) => this.resolveFolderItem(folderPath, item));
+        if (!root && !visitedPaths.has(indexPath)) {
           index = this.file(indexPath);
         }
         for (let i = 0; i < resolved.length; i++) {
@@ -418,25 +421,24 @@ function createPageTreeBuilderUtils(ctx) {
         }
         children = resolved;
       } else {
-        if (!isRoot && !visitedPaths.has(indexPath)) {
+        if (!root && !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,
+        name: metadata.title ?? index?.name ?? (() => {
+          const folderName = basename(folderPath);
+          return pathToName(group.exec(folderName)?.[1] ?? folderName);
+        })(),
+        icon: metadata.icon,
+        root: metadata.root,
+        defaultOpen: metadata.defaultOpen,
+        description: metadata.description,
+        collapsible: metadata.collapsible,
         index,
         children,
         $id: nextNodeId(folderPath),
@@ -618,48 +620,28 @@ function createGetUrl(baseUrl, i18n) {
   };
 }
 function loader(...args) {
-  const resolved = args.length === 2 ? resolveConfig(args[0], args[1]) : resolveConfig(args[0].source, args[0]);
-  return createOutput(resolved);
-}
-function resolveConfig(source, { slugs, icon, plugins = [], baseUrl, url, ...base }) {
-  let config = {
-    ...base,
-    url: url ? (...args) => normalizeUrl(url(...args)) : createGetUrl(baseUrl, base.i18n),
-    source,
-    plugins: buildPlugins([
-      slugsPlugin(slugs),
-      icon && iconPlugin(icon),
-      ...typeof plugins === "function" ? plugins({
-        typedPlugin: (plugin) => plugin
-      }) : plugins
-    ])
-  };
-  for (const plugin of config.plugins ?? []) {
-    const result = plugin.config?.(config);
-    if (result) config = result;
-  }
-  return config;
-}
-function createOutput(loaderConfig) {
+  const loaderConfig = args.length === 2 ? resolveConfig(args[0], args[1]) : resolveConfig(args[0].source, args[0]);
   const { i18n } = loaderConfig;
   const defaultLanguage = i18n?.defaultLanguage ?? "";
   const storages = buildContentStorage(loaderConfig, defaultLanguage);
   const walker = indexPages(storages, loaderConfig);
   const builder = createPageTreeBuilder(loaderConfig);
-  let pageTree;
+  let pageTrees;
+  function getPageTrees() {
+    return pageTrees ??= builder.buildI18n(storages);
+  }
   return {
     _i18n: i18n,
     get pageTree() {
-      pageTree ??= builder.buildI18n(storages);
-      return i18n ? pageTree : pageTree[defaultLanguage];
+      const trees = getPageTrees();
+      return i18n ? trees : trees[defaultLanguage];
     },
     set pageTree(v) {
       if (i18n) {
-        pageTree = v;
+        pageTrees = v;
       } else {
-        pageTree = {
-          [defaultLanguage]: v
-        };
+        pageTrees ??= {};
+        pageTrees[defaultLanguage] = v;
       }
     },
     getPageByHref(href, { dir = "", language = defaultLanguage } = {}) {
@@ -715,11 +697,9 @@ function createOutput(loaderConfig) {
       if (!ref) return;
       return walker.pathToPage.get(`${language}.${ref}`);
     },
-    getPageTree(locale) {
-      if (i18n) {
-        return this.pageTree[locale ?? defaultLanguage];
-      }
-      return this.pageTree;
+    getPageTree(locale = defaultLanguage) {
+      const trees = getPageTrees();
+      return trees[locale] ?? trees[defaultLanguage];
     },
     // @ts-expect-error -- ignore this
     generateParams(slug, lang) {
@@ -734,9 +714,44 @@ function createOutput(loaderConfig) {
       return this.getPages().map((page) => ({
         [slug ?? "slug"]: page.slugs
       }));
+    },
+    async serializePageTree(tree) {
+      const { renderToString } = await import("react-dom/server.edge");
+      return visit(tree, (node) => {
+        node = { ...node };
+        if ("icon" in node && node.icon) {
+          node.icon = renderToString(node.icon);
+        }
+        if (node.name) {
+          node.name = renderToString(node.name);
+        }
+        if ("children" in node) {
+          node.children = [...node.children];
+        }
+        return node;
+      });
     }
   };
 }
+function resolveConfig(source, { slugs, icon, plugins = [], baseUrl, url, ...base }) {
+  let config = {
+    ...base,
+    url: url ? (...args) => normalizeUrl(url(...args)) : createGetUrl(baseUrl, base.i18n),
+    source,
+    plugins: buildPlugins([
+      slugsPlugin(slugs),
+      icon && iconPlugin(icon),
+      ...typeof plugins === "function" ? plugins({
+        typedPlugin: (plugin) => plugin
+      }) : plugins
+    ])
+  };
+  for (const plugin of config.plugins ?? []) {
+    const result = plugin.config?.(config);
+    if (result) config = result;
+  }
+  return config;
+}
 export {
   FileSystem,
   path_exports as PathUtils,

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

@@ -1,6 +1,6 @@
-import { L as LoaderPlugin } from '../../loader-DgL6G4CA.js';
+import { L as LoaderPlugin } from '../../loader-qkSHi822.js';
 import { icons } from 'lucide-react';
-import '../../definitions-DbCug1P3.js';
+import '../../definitions-pJ7PybYY.js';
 import 'react';
 import '../../i18n/index.js';
 

package/dist/source/schema.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+
+/**
+ * Zod 4 schema
+ */
+declare const metaSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    pages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    description: z.ZodOptional<z.ZodString>;
+    root: z.ZodOptional<z.ZodBoolean>;
+    defaultOpen: z.ZodOptional<z.ZodBoolean>;
+    collapsible: z.ZodOptional<z.ZodBoolean>;
+    icon: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Zod 4 schema
+ */
+declare const pageSchema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    full: z.ZodOptional<z.ZodBoolean>;
+    _openapi: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+}, z.core.$strip>;
+
+export { metaSchema, pageSchema };

package/dist/source/schema.js

@@ -0,0 +1,25 @@
+import "../chunk-U67V476Y.js";
+
+// src/source/schema.ts
+import { z } from "zod";
+var metaSchema = z.object({
+  title: z.string().optional(),
+  pages: z.array(z.string()).optional(),
+  description: z.string().optional(),
+  root: z.boolean().optional(),
+  defaultOpen: z.boolean().optional(),
+  collapsible: z.boolean().optional(),
+  icon: z.string().optional()
+});
+var pageSchema = z.object({
+  title: z.string(),
+  description: z.string().optional(),
+  icon: z.string().optional(),
+  full: z.boolean().optional(),
+  // Fumadocs OpenAPI generated
+  _openapi: z.looseObject({}).optional()
+});
+export {
+  metaSchema,
+  pageSchema
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-core",
-  "version": "16.2.1",
+  "version": "16.2.3",
   "description": "The React.js library for building a documentation website",
   "keywords": [
     "Fumadocs",
@@ -28,10 +28,6 @@
       "import": "./dist/content/*.js",
       "types": "./dist/content/*.d.ts"
     },
-    "./hide-if-empty": {
-      "import": "./dist/hide-if-empty.js",
-      "types": "./dist/hide-if-empty.d.ts"
-    },
     "./negotiation": {
       "import": "./dist/negotiation/index.js",
       "types": "./dist/negotiation/index.d.ts"
@@ -52,6 +48,14 @@
       "import": "./dist/source/index.js",
       "types": "./dist/source/index.d.ts"
     },
+    "./source/client": {
+      "import": "./dist/source/client/index.js",
+      "types": "./dist/source/client/index.d.ts"
+    },
+    "./source/schema": {
+      "import": "./dist/source/schema.js",
+      "types": "./dist/source/schema.d.ts"
+    },
     "./source/*": {
       "import": "./dist/source/plugins/*.js",
       "types": "./dist/source/plugins/*.d.ts"
@@ -107,8 +111,8 @@
   "dependencies": {
     "@formatjs/intl-localematcher": "^0.6.2",
     "@orama/orama": "^3.1.16",
-    "@shikijs/rehype": "^3.15.0",
-    "@shikijs/transformers": "^3.15.0",
+    "@shikijs/rehype": "^3.19.0",
+    "@shikijs/transformers": "^3.19.0",
     "estree-util-value-to-estree": "^3.5.0",
     "github-slugger": "^2.0.0",
     "hast-util-to-estree": "^3.1.3",
@@ -121,34 +125,35 @@
     "remark-gfm": "^4.0.1",
     "remark-rehype": "^11.1.2",
     "scroll-into-view-if-needed": "^3.1.0",
-    "shiki": "^3.15.0",
+    "shiki": "^3.19.0",
     "unist-util-visit": "^5.0.0"
   },
   "devDependencies": {
     "@mdx-js/mdx": "^3.1.1",
-    "@mixedbread/sdk": "^0.44.0",
+    "@mixedbread/sdk": "^0.45.0",
     "@orama/core": "^1.2.13",
-    "@tanstack/react-router": "^1.136.6",
+    "@tanstack/react-router": "1.136.18",
     "@types/estree-jsx": "^1.0.5",
     "@types/hast": "^3.0.4",
     "@types/mdast": "^4.0.4",
     "@types/negotiator": "^0.6.4",
     "@types/node": "24.10.1",
-    "@types/react": "^19.2.5",
+    "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",
-    "algoliasearch": "5.44.0",
-    "lucide-react": "^0.553.0",
+    "algoliasearch": "5.45.0",
+    "lucide-react": "^0.555.0",
     "mdast-util-mdx-jsx": "^3.2.0",
     "mdast-util-mdxjs-esm": "^2.0.1",
-    "next": "16.0.3",
-    "react-router": "^7.9.6",
+    "next": "16.0.7",
+    "react-router": "^7.10.0",
     "remark-directive": "^4.0.0",
     "remark-mdx": "^3.1.1",
     "remove-markdown": "^0.6.2",
     "typescript": "^5.9.3",
     "unified": "^11.0.5",
     "vfile": "^6.0.3",
-    "waku": "^0.27.0",
+    "waku": "^0.27.2",
+    "zod": "^4.1.13",
     "eslint-config-custom": "0.0.0",
     "tsconfig": "0.0.0"
   },
@@ -163,7 +168,8 @@
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "react-router": "7.x.x",
-    "waku": "^0.26.0 || ^0.27.0"
+    "waku": "^0.26.0 || ^0.27.0",
+    "zod": "*"
   },
   "peerDependenciesMeta": {
     "@mixedbread/sdk": {
@@ -198,6 +204,9 @@
     },
     "lucide-react": {
       "optional": true
+    },
+    "zod": {
+      "optional": true
     }
   },
   "publishConfig": {

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

@@ -1,18 +0,0 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode, HTMLAttributes, FC } from 'react';
-
-declare function HideIfEmptyProvider({ nonce, children, }: {
-    nonce?: string;
-    children: ReactNode;
-}): react_jsx_runtime.JSX.Element;
-/**
- * The built-in CSS `:empty` selector cannot detect if the children is hidden, classes such as `md:hidden` causes it to fail.
- * This component is an enhancement to `empty:hidden` to fix the issue described above.
- *
- * This can be expensive, please avoid this whenever possible.
- */
-declare function HideIfEmpty<Props extends HTMLAttributes<HTMLElement>>({ as: Comp, ...props }: Props & {
-    as: FC<Props>;
-}): react_jsx_runtime.JSX.Element;
-
-export { HideIfEmpty, HideIfEmptyProvider };

package/dist/hide-if-empty.js

@@ -1,83 +0,0 @@
-"use client";
-import "./chunk-U67V476Y.js";
-
-// src/hide-if-empty.tsx
-import {
-  createContext,
-  useContext,
-  useEffect,
-  useId,
-  useMemo,
-  useState
-} from "react";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-var Context = createContext({
-  nonce: void 0
-});
-function HideIfEmptyProvider({
-  nonce,
-  children
-}) {
-  return /* @__PURE__ */ jsx(Context.Provider, { value: useMemo(() => ({ nonce }), [nonce]), children });
-}
-function getElement(id) {
-  return document.querySelector(`[data-fd-if-empty="${id}"]`);
-}
-function isEmpty(node) {
-  for (let i = 0; i < node.childNodes.length; i++) {
-    const child = node.childNodes.item(i);
-    if (child.nodeType === Node.TEXT_NODE || child.nodeType === Node.ELEMENT_NODE && window.getComputedStyle(child).display !== "none") {
-      return false;
-    }
-  }
-  return true;
-}
-function HideIfEmpty({
-  as: Comp,
-  ...props
-}) {
-  const id = useId();
-  const { nonce } = useContext(Context);
-  const [empty, setEmpty] = useState(() => {
-    const element = typeof window !== "undefined" ? getElement(id) : null;
-    if (element) return isEmpty(element);
-  });
-  useEffect(() => {
-    const handleResize = () => {
-      const element = getElement(id);
-      if (element) setEmpty(isEmpty(element));
-    };
-    window.addEventListener("resize", handleResize);
-    return () => window.removeEventListener("resize", handleResize);
-  }, [id]);
-  const init = (id2) => {
-    const element = getElement(id2);
-    if (element) {
-      element.hidden = isEmpty(element);
-    }
-  };
-  return /* @__PURE__ */ jsxs(Fragment, { children: [
-    /* @__PURE__ */ jsx(
-      Comp,
-      {
-        ...props,
-        "data-fd-if-empty": id,
-        hidden: empty ?? false
-      }
-    ),
-    /* @__PURE__ */ jsx(
-      "script",
-      {
-        suppressHydrationWarning: true,
-        nonce,
-        dangerouslySetInnerHTML: {
-          __html: `{${getElement};${isEmpty};(${init})("${id}")}`
-        }
-      }
-    )
-  ] });
-}
-export {
-  HideIfEmpty,
-  HideIfEmptyProvider
-};