fumadocs-core 15.7.13 → 15.8.1

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
      */