fumadocs-core 16.2.1 → 16.2.2

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-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/{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-Dz9yZIJQ.d.ts}

@@ -280,6 +280,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,6 +1,3 @@
-import {
-  default as default2
-} from "../chunk-ONG4RVCR.js";
 import {
   remarkImage
 } from "../chunk-YDNO7UZ6.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/page-tree/index.d.ts

@@ -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,7 +3,7 @@ import { StructuredData } from '../mdx-plugins/remark-structure.js';
 import { SortedResult } from './index.js';
 export { HighlightedText, ReactSortedResult, createContentHighlighter } from './index.js';
 import { I18nConfig } from '../i18n/index.js';
-import { 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-Dz9yZIJQ.js';
 import 'mdast';
 import 'unified';
 import 'mdast-util-mdx-jsx';

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-DbCug1P3.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,4 +1,4 @@
-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';
+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-Dz9yZIJQ.js';
 import '../definitions-DbCug1P3.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;
@@ -618,48 +622,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 +699,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 +716,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,4 +1,4 @@
-import { L as LoaderPlugin } from '../../loader-DgL6G4CA.js';
+import { L as LoaderPlugin } from '../../loader-Dz9yZIJQ.js';
 import { icons } from 'lucide-react';
 import '../../definitions-DbCug1P3.js';
 import 'react';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-core",
-  "version": "16.2.1",
+  "version": "16.2.2",
   "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,10 @@
       "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/*": {
       "import": "./dist/source/plugins/*.js",
       "types": "./dist/source/plugins/*.d.ts"
@@ -107,8 +107,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.18.0",
+    "@shikijs/transformers": "^3.18.0",
     "estree-util-value-to-estree": "^3.5.0",
     "github-slugger": "^2.0.0",
     "hast-util-to-estree": "^3.1.3",
@@ -121,26 +121,26 @@
     "remark-gfm": "^4.0.1",
     "remark-rehype": "^11.1.2",
     "scroll-into-view-if-needed": "^3.1.0",
-    "shiki": "^3.15.0",
+    "shiki": "^3.18.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",
+    "next": "16.0.6",
     "react-router": "^7.9.6",
     "remark-directive": "^4.0.0",
     "remark-mdx": "^3.1.1",
@@ -148,9 +148,9 @@
     "typescript": "^5.9.3",
     "unified": "^11.0.5",
     "vfile": "^6.0.3",
-    "waku": "^0.27.0",
-    "eslint-config-custom": "0.0.0",
-    "tsconfig": "0.0.0"
+    "waku": "^0.27.2",
+    "tsconfig": "0.0.0",
+    "eslint-config-custom": "0.0.0"
   },
   "peerDependencies": {
     "@mixedbread/sdk": "^0.19.0",

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
-};