fumadocs-core 15.7.12 → 15.8.0

package/dist/{algolia-KPRGMSJO.js → algolia-Z232AL35.js}

@@ -1,6 +1,6 @@
 import {
   createContentHighlighter
-} from "./chunk-CNWEGOUF.js";
+} from "./chunk-OTD7MV33.js";
 import "./chunk-JSBRDJBE.js";
 
 // src/search/client/algolia.ts
@@ -13,6 +13,7 @@ function groupResults(hits) {
       grouped.push({
         id: hit.url,
         type: "page",
+        breadcrumbs: hit.breadcrumbs,
         url: hit.url,
         content: hit.title
       });

package/dist/breadcrumb.d.ts

@@ -7,18 +7,20 @@ interface BreadcrumbItem {
 }
 interface BreadcrumbOptions {
     /**
-     * Include the root itself in the breadcrumb items array.
-     * Specify the url by passing an object instead
+     * Include the root folders in the breadcrumb items array.
      *
      * @defaultValue false
      */
     includeRoot?: boolean | {
+        /**
+         * Specify the url of root
+         */
         url: string;
     };
     /**
      * Include the page itself in the breadcrumb items array
      *
-     * @defaultValue true
+     * @defaultValue false
      */
     includePage?: boolean;
     /**
@@ -37,7 +39,7 @@ declare function getBreadcrumbItemsFromPath(tree: Root, path: Node[], options: B
  * - When the page doesn't exist, return null
  *
  * @returns The path to the target node from root
- * @internal
+ * @internal Don't use this on your own
  */
 declare function searchPath(nodes: Node[], url: string): Node[] | null;
 

package/dist/breadcrumb.js

@@ -1,6 +1,9 @@
 import {
   normalizeUrl
 } from "./chunk-PFNP6PEB.js";
+import {
+  findPath
+} from "./chunk-HV3YIUWE.js";
 import "./chunk-JSBRDJBE.js";
 
 // src/breadcrumb.tsx
@@ -19,33 +22,42 @@ function getBreadcrumbItems(url, tree, options = {}) {
   );
 }
 function getBreadcrumbItemsFromPath(tree, path, options) {
-  const { includePage = true, includeSeparator = false, includeRoot } = options;
+  const {
+    includePage = false,
+    includeSeparator = false,
+    includeRoot = false
+  } = options;
   let items = [];
-  path.forEach((item, i) => {
-    if (item.type === "separator" && item.name && includeSeparator) {
-      items.push({
-        name: item.name
-      });
-    }
-    if (item.type === "folder") {
-      const next = path.at(i + 1);
-      if (next && item.index === next) return;
-      if (item.root) {
-        items = [];
-        return;
-      }
-      items.push({
-        name: item.name,
-        url: item.index?.url
-      });
-    }
-    if (item.type === "page" && includePage) {
-      items.push({
-        name: item.name,
-        url: item.url
-      });
+  for (let i = 0; i < path.length; i++) {
+    const item = path[i];
+    switch (item.type) {
+      case "page":
+        if (includePage)
+          items.push({
+            name: item.name,
+            url: item.url
+          });
+        break;
+      case "folder":
+        if (item.root && !includeRoot) {
+          items = [];
+          break;
+        }
+        if (i === path.length - 1 || item.index !== path[i + 1]) {
+          items.push({
+            name: item.name,
+            url: item.index?.url
+          });
+        }
+        break;
+      case "separator":
+        if (item.name && includeSeparator)
+          items.push({
+            name: item.name
+          });
+        break;
     }
-  });
+  }
   if (includeRoot) {
     items.unshift({
       name: tree.name,
@@ -55,34 +67,11 @@ function getBreadcrumbItemsFromPath(tree, path, options) {
   return items;
 }
 function searchPath(nodes, url) {
-  const items = [];
-  url = normalizeUrl(url);
-  function run(nodes2) {
-    let separator;
-    for (const node of nodes2) {
-      if (node.type === "separator") separator = node;
-      if (node.type === "folder") {
-        if (node.index?.url === url) {
-          if (separator) items.push(separator);
-          items.push(node, node.index);
-          return true;
-        }
-        if (run(node.children)) {
-          items.unshift(node);
-          if (separator) items.unshift(separator);
-          return true;
-        }
-      }
-      if (node.type === "page" && node.url === url) {
-        if (separator) items.push(separator);
-        items.push(node);
-        return true;
-      }
-    }
-    return false;
-  }
-  if (run(nodes)) return items;
-  return null;
+  const normalizedUrl = normalizeUrl(url);
+  return findPath(
+    nodes,
+    (node) => node.type === "page" && node.url === normalizedUrl
+  );
 }
 export {
   getBreadcrumbItems,

package/dist/chunk-HV3YIUWE.js

@@ -0,0 +1,108 @@
+// src/utils/page-tree.tsx
+function flattenTree(nodes) {
+  const out = [];
+  for (const node of nodes) {
+    if (node.type === "folder") {
+      if (node.index) out.push(node.index);
+      out.push(...flattenTree(node.children));
+    } else if (node.type === "page") {
+      out.push(node);
+    }
+  }
+  return out;
+}
+function findNeighbour(tree, url, options) {
+  const { separateRoot = true } = options ?? {};
+  const roots = separateRoot ? getPageTreeRoots(tree) : [tree];
+  if (tree.fallback) roots.push(tree.fallback);
+  for (const root of roots) {
+    const list = flattenTree(root.children);
+    const idx = list.findIndex((item) => item.url === url);
+    if (idx === -1) continue;
+    return {
+      previous: list[idx - 1],
+      next: list[idx + 1]
+    };
+  }
+  return {};
+}
+function getPageTreeRoots(pageTree) {
+  const result = pageTree.children.flatMap((child) => {
+    if (child.type !== "folder") return [];
+    const roots = getPageTreeRoots(child);
+    if (child.root) roots.push(child);
+    return roots;
+  });
+  if (!("type" in pageTree)) result.push(pageTree);
+  return result;
+}
+function separatePageTree(pageTree) {
+  return pageTree.children.flatMap((child) => {
+    if (child.type !== "folder") return [];
+    return {
+      name: child.name,
+      url: child.index?.url,
+      children: child.children
+    };
+  });
+}
+function getPageTreePeers(tree, url) {
+  const parent = findParentFromTree(tree, url);
+  if (!parent) return [];
+  return parent.children.filter(
+    (item) => item.type === "page" && item.url !== url
+  );
+}
+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;
+    }
+  }
+  if ("fallback" in node && node.fallback) {
+    return findParentFromTree(node.fallback, url);
+  }
+}
+function findPath(nodes, matcher, options = {}) {
+  const { includeSeparator = true } = options;
+  function run(nodes2) {
+    let separator;
+    for (const node of nodes2) {
+      if (matcher(node)) {
+        const items = [];
+        if (separator) items.push(separator);
+        items.push(node);
+        return items;
+      }
+      if (node.type === "separator" && includeSeparator) {
+        separator = node;
+        continue;
+      }
+      if (node.type === "folder") {
+        const items = node.index && matcher(node.index) ? [node.index] : run(node.children);
+        if (items) {
+          items.unshift(node);
+          if (separator) items.unshift(separator);
+          return items;
+        }
+      }
+    }
+  }
+  return run(nodes) ?? null;
+}
+
+export {
+  flattenTree,
+  findNeighbour,
+  getPageTreeRoots,
+  separatePageTree,
+  getPageTreePeers,
+  findPath
+};

package/dist/{chunk-CNWEGOUF.js → chunk-OTD7MV33.js}

@@ -1,4 +1,4 @@
-// src/search/shared.ts
+// src/search/index.ts
 function escapeRegExp(input) {
   return input.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }

package/dist/{chunk-XMAVUWLD.js → chunk-XOFXGHS4.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-ZMWYLUDP.js";
 import {
   createContentHighlighter
-} from "./chunk-CNWEGOUF.js";
+} from "./chunk-OTD7MV33.js";
 
 // src/search/orama/search/simple.ts
 import { search } from "@orama/orama";
@@ -21,6 +21,7 @@ async function searchSimple(db, query, params = {}) {
   return result.hits.map((hit) => ({
     type: "page",
     content: hit.document.title,
+    breadcrumbs: hit.document.breadcrumbs,
     contentWithHighlights: highlighter.highlight(hit.document.title),
     id: hit.document.url,
     url: hit.document.url
@@ -67,6 +68,7 @@ async function searchAdvanced(db, query, tag = [], {
       id: pageId,
       type: "page",
       content: page.content,
+      breadcrumbs: page.breadcrumbs,
       contentWithHighlights: highlighter.highlight(page.content),
       url: page.url
     });
@@ -75,6 +77,7 @@ async function searchAdvanced(db, query, tag = [], {
       list.push({
         id: hit.document.id.toString(),
         content: hit.document.content,
+        breadcrumbs: hit.document.breadcrumbs,
         contentWithHighlights: highlighter.highlight(hit.document.content),
         type: hit.document.type,
         url: hit.document.url

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

@@ -185,7 +185,7 @@ interface CodeBlockTabsOptions {
 }
 declare function generateCodeBlockTabs({ persist, defaultValue, triggers, tabs, ...options }: CodeBlockTabsOptions): MdxJsxFlowElement;
 interface CodeBlockAttributes<Name extends string = string> {
-    attributes: Partial<Record<Name, string>>;
+    attributes: Partial<Record<Name, string | null>>;
     rest: string;
 }
 /**

package/dist/mdx-plugins/index.js

@@ -235,11 +235,11 @@ function generateCodeBlockTabs({
 }
 function parseCodeBlockAttributes(meta, allowedNames) {
   let str = meta;
-  const StringRegex = /(?<=^|\s)(?<name>\w+)=(?:"([^"]*)"|'([^']*)')/g;
+  const StringRegex = /(?<=^|\s)(?<name>\w+)(?:=(?:"([^"]*)"|'([^']*)'))?/g;
   const attributes = {};
   str = str.replaceAll(StringRegex, (match, name, value_1, value_2) => {
     if (allowedNames && !allowedNames.includes(name)) return match;
-    attributes[name] = value_1 ?? value_2;
+    attributes[name] = value_1 ?? value_2 ?? null;
     return "";
   });
   return {
@@ -270,7 +270,7 @@ var rehypeCodeDefaultOptions = {
     })
   ],
   parseMetaString(meta) {
-    const parsed = parseCodeBlockAttributes(meta);
+    const parsed = parseCodeBlockAttributes(meta, ["title", "tab"]);
     const data = parsed.attributes;
     parsed.rest = parseLineNumber(parsed.rest, data);
     data.__parsed_raw = parsed.rest;

package/dist/{orama-cloud-TXCWJTK3.js → orama-cloud-GMFFJOIB.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-ZMWYLUDP.js";
 import {
   createContentHighlighter
-} from "./chunk-CNWEGOUF.js";
+} from "./chunk-OTD7MV33.js";
 import "./chunk-JSBRDJBE.js";
 
 // src/search/client/orama-cloud.ts
@@ -69,6 +69,7 @@ async function searchDocs(query, options) {
           id: doc.page_id,
           type: "page",
           content: doc.title,
+          breadcrumbs: doc.breadcrumbs,
           contentWithHighlights: highlighter.highlight(doc.title),
           url: doc.url
         });

package/dist/search/algolia.d.ts

@@ -11,6 +11,7 @@ interface DocumentRecord {
     _id: string;
     title: string;
     description?: string;
+    breadcrumbs?: string[];
     /**
      * URL to the page
      */
@@ -67,6 +68,7 @@ interface BaseIndex {
      * Heading (anchor) id
      */
     section_id?: string;
+    breadcrumbs?: string[];
     content: string;
 }
 

package/dist/search/algolia.js

@@ -16,7 +16,8 @@ async function setIndexSettings(client, indexName) {
         "section",
         "content",
         "url",
-        "section_id"
+        "section_id",
+        "breadcrumbs"
       ],
       searchableAttributes: ["title", "section", "content"],
       attributesToSnippet: [],
@@ -31,6 +32,7 @@ function toIndex(page) {
   function createIndex(section, sectionId, content) {
     return {
       objectID: `${page._id}-${(id++).toString()}`,
+      breadcrumbs: page.breadcrumbs,
       title: page.title,
       url: page.url,
       page_id: page._id,

package/dist/search/client.d.ts

@@ -4,11 +4,12 @@ import { BaseIndex } from './algolia.js';
 import { LiteClient, SearchResponse } from 'algoliasearch/lite';
 import { OramaClient, ClientSearchParams } from '@oramacloud/client';
 import Mixedbread from '@mixedbread/sdk';
-import { S as SortedResult } from '../shared-ORgOfXFw.js';
+import { SortedResult } from './index.js';
 import 'mdast';
 import 'unified';
 import 'mdast-util-mdx-jsx';
 import 'algoliasearch';
+import 'react';
 
 interface FetchOptions {
     /**

package/dist/search/client.js

@@ -69,15 +69,15 @@ function useDocsSearch(clientOptions, _locale, _tag, _delayMs = 100, _allowEmpty
           return fetchDocs(debouncedValue, client);
         }
         if (client.type === "algolia") {
-          const { searchDocs } = await import("../algolia-KPRGMSJO.js");
+          const { searchDocs } = await import("../algolia-Z232AL35.js");
           return searchDocs(debouncedValue, client);
         }
         if (client.type === "orama-cloud") {
-          const { searchDocs } = await import("../orama-cloud-TXCWJTK3.js");
+          const { searchDocs } = await import("../orama-cloud-GMFFJOIB.js");
           return searchDocs(debouncedValue, client);
         }
         if (client.type === "static") {
-          const { search: search2 } = await import("../static-PIZYNE45.js");
+          const { search: search2 } = await import("../static-UVSWNGTY.js");
           return search2(debouncedValue, client);
         }
         if (client.type === "mixedbread") {

package/dist/search/index.d.ts

@@ -0,0 +1,26 @@
+import { ReactNode } from 'react';
+
+interface SortedResult<Content = string> {
+    id: string;
+    url: string;
+    type: 'page' | 'heading' | 'text';
+    content: Content;
+    /**
+     * breadcrumbs to be displayed on UI
+     */
+    breadcrumbs?: Content[];
+    contentWithHighlights?: HighlightedText<Content>[];
+}
+type ReactSortedResult = SortedResult<ReactNode>;
+interface HighlightedText<Content = string> {
+    type: 'text';
+    content: Content;
+    styles?: {
+        highlight?: boolean;
+    };
+}
+declare function createContentHighlighter(query: string | RegExp): {
+    highlight(content: string): HighlightedText[];
+};
+
+export { type HighlightedText, type ReactSortedResult, type SortedResult, createContentHighlighter };

package/dist/search/index.js

@@ -0,0 +1,7 @@
+import {
+  createContentHighlighter
+} from "../chunk-OTD7MV33.js";
+import "../chunk-JSBRDJBE.js";
+export {
+  createContentHighlighter
+};

package/dist/search/orama-cloud.d.ts

@@ -50,6 +50,7 @@ interface OramaDocument {
      * Data to be added to each section index
      */
     extra_data?: object;
+    breadcrumbs?: string[];
 }
 interface OramaIndex {
     id: string;
@@ -64,6 +65,7 @@ interface OramaIndex {
      * Heading content
      */
     section?: string;
+    breadcrumbs?: string[];
     /**
      * Heading (anchor) id
      */

package/dist/search/orama-cloud.js

@@ -30,6 +30,7 @@ function toIndex(page) {
       section,
       section_id: sectionId,
       content,
+      breadcrumbs: page.breadcrumbs,
       ...page.extra_data
     };
   }

package/dist/search/server.d.ts

@@ -1,7 +1,7 @@
 import { TypedDocument, Orama, Language, RawData, create, SearchParams } from '@orama/orama';
 import { S as StructuredData } from '../remark-structure-DkCXCzpD.js';
-import { S as SortedResult } from '../shared-ORgOfXFw.js';
-export { H as HighlightedText, c as createContentHighlighter } from '../shared-ORgOfXFw.js';
+import { SortedResult } from './index.js';
+export { HighlightedText, ReactSortedResult, createContentHighlighter } from './index.js';
 import { I18nConfig } from '../i18n/index.js';
 import { LoaderOutput, LoaderConfig, InferPageType } from '../source/index.js';
 import 'mdast';
@@ -10,23 +10,25 @@ import 'mdast-util-mdx-jsx';
 import 'react';
 import '../definitions-Q95-psoo.js';
 
+type SimpleDocument = TypedDocument<Orama<typeof simpleSchema>>;
+declare const simpleSchema: {
+    readonly url: "string";
+    readonly title: "string";
+    readonly breadcrumbs: "string[]";
+    readonly description: "string";
+    readonly content: "string";
+    readonly keywords: "string";
+};
 type AdvancedDocument = TypedDocument<Orama<typeof advancedSchema>>;
 declare const advancedSchema: {
     readonly content: "string";
     readonly page_id: "string";
     readonly type: "string";
+    readonly breadcrumbs: "string[]";
     readonly tags: "enum[]";
     readonly url: "string";
     readonly embeddings: "vector[512]";
 };
-type SimpleDocument = TypedDocument<Orama<typeof simpleSchema>>;
-declare const simpleSchema: {
-    readonly url: "string";
-    readonly title: "string";
-    readonly description: "string";
-    readonly content: "string";
-    readonly keywords: "string";
-};
 
 type Awaitable<T> = T | Promise<T>;
 interface Options<S extends LoaderOutput<LoaderConfig>> extends Omit<AdvancedOptions, 'indexes'> {
@@ -112,6 +114,7 @@ declare function createSearchAPI<T extends SearchType>(type: T, options: T exten
 interface Index {
     title: string;
     description?: string;
+    breadcrumbs?: string[];
     content: string;
     url: string;
     keywords?: string;
@@ -125,6 +128,7 @@ interface AdvancedIndex {
      * @deprecated No longer used
      */
     keywords?: string;
+    breadcrumbs?: string[];
     /**
      * Required if tag filter is enabled
      */

package/dist/search/server.js

@@ -1,15 +1,18 @@
+import {
+  basename,
+  extname
+} from "../chunk-BDG7Y4PS.js";
 import {
   searchAdvanced,
   searchSimple
-} from "../chunk-XMAVUWLD.js";
+} from "../chunk-XOFXGHS4.js";
 import "../chunk-ZMWYLUDP.js";
 import {
   createContentHighlighter
-} from "../chunk-CNWEGOUF.js";
+} from "../chunk-OTD7MV33.js";
 import {
-  basename,
-  extname
-} from "../chunk-BDG7Y4PS.js";
+  findPath
+} from "../chunk-HV3YIUWE.js";
 import "../chunk-JSBRDJBE.js";
 
 // src/search/server.ts
@@ -45,10 +48,19 @@ import {
   create,
   insertMultiple
 } from "@orama/orama";
+var simpleSchema = {
+  url: "string",
+  title: "string",
+  breadcrumbs: "string[]",
+  description: "string",
+  content: "string",
+  keywords: "string"
+};
 var advancedSchema = {
   content: "string",
   page_id: "string",
   type: "string",
+  breadcrumbs: "string[]",
   tags: "enum[]",
   url: "string",
   embeddings: "vector[512]"
@@ -70,7 +82,8 @@ async function createDB({
   });
   const mapTo = [];
   items.forEach((page) => {
-    const tags = Array.isArray(page.tag) ? page.tag : page.tag ? [page.tag] : [];
+    const pageTag = page.tag ?? [];
+    const tags = Array.isArray(pageTag) ? pageTag : [pageTag];
     const data = page.structuredData;
     let id = 0;
     mapTo.push({
@@ -78,12 +91,14 @@ async function createDB({
       page_id: page.id,
       type: "page",
       content: page.title,
+      breadcrumbs: page.breadcrumbs,
       tags,
       url: page.url
     });
+    const nextId = () => `${page.id}-${id++}`;
     if (page.description) {
       mapTo.push({
-        id: `${page.id}-${(id++).toString()}`,
+        id: nextId(),
         page_id: page.id,
         tags,
         type: "text",
@@ -93,7 +108,7 @@ async function createDB({
     }
     for (const heading of data.headings) {
       mapTo.push({
-        id: `${page.id}-${(id++).toString()}`,
+        id: nextId(),
         page_id: page.id,
         type: "heading",
         tags,
@@ -103,7 +118,7 @@ async function createDB({
     }
     for (const content of data.contents) {
       mapTo.push({
-        id: `${page.id}-${(id++).toString()}`,
+        id: nextId(),
         page_id: page.id,
         tags,
         type: "text",
@@ -115,13 +130,6 @@ async function createDB({
   await insertMultiple(db, mapTo);
   return db;
 }
-var simpleSchema = {
-  url: "string",
-  title: "string",
-  description: "string",
-  content: "string",
-  keywords: "string"
-};
 async function createDBSimple({
   indexes,
   tokenizer,
@@ -141,6 +149,7 @@ async function createDBSimple({
     items.map((page) => ({
       title: page.title,
       description: page.description,
+      breadcrumbs: page.breadcrumbs,
       url: page.url,
       content: page.content,
       keywords: page.keywords
@@ -150,73 +159,77 @@ async function createDBSimple({
 }
 
 // src/search/orama/create-from-source.ts
-async function pageToIndex(page) {
-  let structuredData;
-  if ("structuredData" in page.data) {
-    structuredData = page.data.structuredData;
-  } else if ("load" in page.data && typeof page.data.load === "function") {
-    structuredData = (await page.data.load()).structuredData;
+function defaultBuildIndex(source) {
+  function isBreadcrumbItem(item) {
+    return typeof item === "string" && item.length > 0;
   }
-  if (!structuredData)
-    throw new Error(
-      "Cannot find structured data from page, please define the page to index function."
+  return async (page) => {
+    let breadcrumbs;
+    let structuredData;
+    if ("structuredData" in page.data) {
+      structuredData = page.data.structuredData;
+    } else if ("load" in page.data && typeof page.data.load === "function") {
+      structuredData = (await page.data.load()).structuredData;
+    }
+    if (!structuredData)
+      throw new Error(
+        "Cannot find structured data from page, please define the page to index function."
+      );
+    const pageTree = source.getPageTree(page.locale);
+    const path = findPath(
+      pageTree.children,
+      (node) => node.type === "page" && node.url === page.url
     );
-  return {
-    title: page.data.title ?? basename(page.path, extname(page.path)),
-    description: "description" in page.data ? page.data.description : void 0,
-    url: page.url,
-    id: page.url,
-    structuredData
+    if (path) {
+      breadcrumbs = [];
+      path.pop();
+      if (isBreadcrumbItem(pageTree.name)) {
+        breadcrumbs.push(pageTree.name);
+      }
+      for (const segment of path) {
+        if (!isBreadcrumbItem(segment.name)) continue;
+        breadcrumbs.push(segment.name);
+      }
+    }
+    return {
+      title: page.data.title ?? basename(page.path, extname(page.path)),
+      breadcrumbs,
+      description: page.data.description,
+      url: page.url,
+      id: page.url,
+      structuredData
+    };
   };
 }
-function createFromSource(source, _buildIndexOrOptions = pageToIndex, _options) {
-  const { buildIndex = pageToIndex, ...options } = {
+function createFromSource(source, _buildIndexOrOptions, _options) {
+  const { buildIndex = defaultBuildIndex(source), ...options } = {
     ...typeof _buildIndexOrOptions === "function" ? {
       buildIndex: _buildIndexOrOptions
     } : _buildIndexOrOptions,
     ..._options
   };
-  const i18n = source._i18n;
-  let server;
-  if (i18n) {
-    const indexes = source.getLanguages().flatMap((entry) => {
-      return entry.pages.map(async (page) => ({
-        ...await buildIndex(page),
-        locale: entry.language
-      }));
-    });
-    server = Promise.all(indexes).then(
-      (loaded) => createI18nSearchAPI("advanced", {
-        ...options,
-        i18n,
-        indexes: loaded
-      })
-    );
-  } else {
-    const indexes = source.getPages().map(async (page) => {
-      return buildIndex(page);
+  if (source._i18n) {
+    return createI18nSearchAPI("advanced", {
+      ...options,
+      i18n: source._i18n,
+      indexes: async () => {
+        const indexes = source.getLanguages().flatMap((entry) => {
+          return entry.pages.map(async (page) => ({
+            ...await buildIndex(page),
+            locale: entry.language
+          }));
+        });
+        return Promise.all(indexes);
+      }
     });
-    server = Promise.all(indexes).then(
-      (loaded) => createSearchAPI("advanced", {
-        ...options,
-        indexes: loaded
-      })
-    );
   }
-  return {
-    async export(...args) {
-      return (await server).export(...args);
-    },
-    async GET(...args) {
-      return (await server).GET(...args);
-    },
-    async search(...args) {
-      return (await server).search(...args);
-    },
-    async staticGET(...args) {
-      return (await server).staticGET(...args);
+  return createSearchAPI("advanced", {
+    ...options,
+    indexes: async () => {
+      const indexes = source.getPages().map((page) => buildIndex(page));
+      return Promise.all(indexes);
     }
-  };
+  });
 }
 
 // src/search/orama/_stemmers.ts

package/dist/server/index.d.ts

@@ -4,7 +4,7 @@ export { d as PageTree } from '../definitions-Q95-psoo.js';
 import { Metadata } from 'next';
 import { NextRequest } from 'next/server';
 import { LoaderOutput, LoaderConfig, InferPageType } from '../source/index.js';
-export { S as SortedResult } from '../shared-ORgOfXFw.js';
+export { SortedResult } from '../search/index.js';
 import 'react';
 import 'unified';
 import 'vfile';
@@ -34,6 +34,14 @@ declare function separatePageTree(pageTree: Root): Root[];
  * Get other page tree nodes that lives under the same parent
  */
 declare function getPageTreePeers(tree: Root, url: string): Item[];
+/**
+ * Search the path of a node in the tree matched by the matcher.
+ *
+ * @returns The path to the target node (from starting root), or null if the page doesn't exist
+ */
+declare function findPath(nodes: Node[], matcher: (node: Node) => boolean, options?: {
+    includeSeparator?: boolean;
+}): Node[] | null;
 
 interface GetGithubLastCommitOptions {
     /**
@@ -116,4 +124,4 @@ declare function createMetadataImage<S extends LoaderOutput<LoaderConfig>>(optio
     }) => Response | Promise<Response>) => (request: NextRequest, options: any) => Response | Promise<Response>;
 };
 
-export { type GetGithubLastCommitOptions, createMetadataImage, findNeighbour, flattenTree, getGithubLastEdit, getPageTreePeers, getPageTreeRoots, separatePageTree };
+export { type GetGithubLastCommitOptions, createMetadataImage, findNeighbour, findPath, flattenTree, getGithubLastEdit, getPageTreePeers, getPageTreeRoots, separatePageTree };

package/dist/server/index.js

@@ -1,6 +1,14 @@
 import {
   remarkHeading
 } from "../chunk-QMATWJ5F.js";
+import {
+  findNeighbour,
+  findPath,
+  flattenTree,
+  getPageTreePeers,
+  getPageTreeRoots,
+  separatePageTree
+} from "../chunk-HV3YIUWE.js";
 import "../chunk-JSBRDJBE.js";
 
 // src/server/get-toc.ts
@@ -17,79 +25,6 @@ function getTableOfContents(content, remarkPlugins) {
   return [];
 }
 
-// src/utils/page-tree.tsx
-function flattenTree(nodes) {
-  const out = [];
-  for (const node of nodes) {
-    if (node.type === "folder") {
-      if (node.index) out.push(node.index);
-      out.push(...flattenTree(node.children));
-    } else if (node.type === "page") {
-      out.push(node);
-    }
-  }
-  return out;
-}
-function findNeighbour(tree, url, options) {
-  const { separateRoot = true } = options ?? {};
-  const roots = separateRoot ? getPageTreeRoots(tree) : [tree];
-  if (tree.fallback) roots.push(tree.fallback);
-  for (const root of roots) {
-    const list = flattenTree(root.children);
-    const idx = list.findIndex((item) => item.url === url);
-    if (idx === -1) continue;
-    return {
-      previous: list[idx - 1],
-      next: list[idx + 1]
-    };
-  }
-  return {};
-}
-function getPageTreeRoots(pageTree) {
-  const result = pageTree.children.flatMap((child) => {
-    if (child.type !== "folder") return [];
-    const roots = getPageTreeRoots(child);
-    if (child.root) roots.push(child);
-    return roots;
-  });
-  if (!("type" in pageTree)) result.push(pageTree);
-  return result;
-}
-function separatePageTree(pageTree) {
-  return pageTree.children.flatMap((child) => {
-    if (child.type !== "folder") return [];
-    return {
-      name: child.name,
-      url: child.index?.url,
-      children: child.children
-    };
-  });
-}
-function getPageTreePeers(tree, url) {
-  const parent = findParentFromTree(tree, url);
-  if (!parent) return [];
-  return parent.children.filter(
-    (item) => item.type === "page" && item.url !== url
-  );
-}
-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;
-    }
-  }
-  if ("fallback" in node && node.fallback) {
-    return findParentFromTree(node.fallback, url);
-  }
-}
-
 // src/source/page-tree/definitions.ts
 var definitions_exports = {};
 
@@ -194,6 +129,7 @@ export {
   definitions_exports as PageTree,
   createMetadataImage,
   findNeighbour,
+  findPath,
   flattenTree,
   getGithubLastEdit,
   getPageTreePeers,

package/dist/source/index.js

@@ -246,7 +246,7 @@ function build(id, ctx) {
   const folder = buildFolderNode("", true, ctx);
   let root = {
     $id: id,
-    name: folder.name,
+    name: folder.name || "Docs",
     children: folder.children
   };
   for (const transformer of ctx.transformers) {
@@ -584,7 +584,7 @@ function createOutput(options) {
         };
       }
     },
-    getPageByHref(href, { dir = "", language } = {}) {
+    getPageByHref(href, { dir = "", language = defaultLanguage } = {}) {
       const [value, hash] = href.split("#", 2);
       let target;
       if (value.startsWith(".") && (value.endsWith(".md") || value.endsWith(".mdx"))) {

package/dist/{static-PIZYNE45.js → static-UVSWNGTY.js}

@@ -1,9 +1,9 @@
 import {
   searchAdvanced,
   searchSimple
-} from "./chunk-XMAVUWLD.js";
+} from "./chunk-XOFXGHS4.js";
 import "./chunk-ZMWYLUDP.js";
-import "./chunk-CNWEGOUF.js";
+import "./chunk-OTD7MV33.js";
 import "./chunk-JSBRDJBE.js";
 
 // src/search/client/static.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-core",
-  "version": "15.7.12",
+  "version": "15.8.0",
   "description": "The library for building a documentation website in Next.js",
   "keywords": [
     "NextJs",
@@ -32,6 +32,10 @@
       "import": "./dist/hide-if-empty.js",
       "types": "./dist/hide-if-empty.d.ts"
     },
+    "./search": {
+      "import": "./dist/search/index.js",
+      "types": "./dist/search/index.d.ts"
+    },
     "./search/*": {
       "import": "./dist/search/*.js",
       "types": "./dist/search/*.d.ts"
@@ -91,9 +95,9 @@
   ],
   "dependencies": {
     "@formatjs/intl-localematcher": "^0.6.1",
-    "@orama/orama": "^3.1.13",
-    "@shikijs/rehype": "^3.12.2",
-    "@shikijs/transformers": "^3.12.2",
+    "@orama/orama": "^3.1.14",
+    "@shikijs/rehype": "^3.13.0",
+    "@shikijs/transformers": "^3.13.0",
     "github-slugger": "^2.0.0",
     "hast-util-to-estree": "^3.1.3",
     "hast-util-to-jsx-runtime": "^2.3.6",
@@ -105,25 +109,25 @@
     "remark-gfm": "^4.0.1",
     "remark-rehype": "^11.1.2",
     "scroll-into-view-if-needed": "^3.1.0",
-    "shiki": "^3.12.2",
+    "shiki": "^3.13.0",
     "unist-util-visit": "^5.0.0"
   },
   "devDependencies": {
     "@mdx-js/mdx": "^3.1.1",
     "@mixedbread/sdk": "^0.28.1",
     "@oramacloud/client": "^2.1.4",
-    "@tanstack/react-router": "^1.131.41",
+    "@tanstack/react-router": "^1.132.2",
     "@types/estree-jsx": "^1.0.5",
     "@types/hast": "^3.0.4",
     "@types/mdast": "^4.0.3",
     "@types/negotiator": "^0.6.4",
-    "@types/node": "24.3.3",
+    "@types/node": "24.5.2",
     "@types/react": "^19.1.13",
     "@types/react-dom": "^19.1.9",
     "algoliasearch": "5.37.0",
     "mdast-util-mdx-jsx": "^3.2.0",
     "mdast-util-mdxjs-esm": "^2.0.1",
-    "next": "^15.5.3",
+    "next": "^15.5.4",
     "react-router": "^7.9.1",
     "remark-mdx": "^3.1.1",
     "remove-markdown": "^0.6.2",

package/dist/shared-ORgOfXFw.d.ts

@@ -1,19 +0,0 @@
-interface SortedResult {
-    id: string;
-    url: string;
-    type: 'page' | 'heading' | 'text';
-    content: string;
-    contentWithHighlights?: HighlightedText[];
-}
-type HighlightedText = {
-    type: 'text';
-    content: string;
-    styles?: {
-        highlight?: boolean;
-    };
-};
-declare function createContentHighlighter(query: string | RegExp): {
-    highlight(content: string): HighlightedText[];
-};
-
-export { type HighlightedText as H, type SortedResult as S, createContentHighlighter as c };