fumadocs-core 15.6.9 → 15.6.11

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

@@ -1,3 +1,6 @@
+import {
+  createContentHighlighter
+} from "./chunk-CNWEGOUF.js";
 import "./chunk-JSBRDJBE.js";
 
 // src/search/client/algolia.ts
@@ -24,24 +27,29 @@ function groupResults(hits) {
   return grouped;
 }
 async function searchDocs(query, { indexName, onSearch, client, locale, tag }) {
-  if (query.length > 0) {
-    const result = onSearch ? await onSearch(query, tag, locale) : await client.searchForHits({
-      requests: [
-        {
-          type: "default",
-          indexName,
-          query,
-          distinct: 5,
-          hitsPerPage: 10,
-          filters: tag ? `tag:${tag}` : void 0
-        }
-      ]
-    });
-    return groupResults(result.results[0].hits).filter(
-      (hit) => hit.type === "page"
-    );
-  }
-  return [];
+  if (query.trim().length === 0) return [];
+  const result = onSearch ? await onSearch(query, tag, locale) : await client.searchForHits({
+    requests: [
+      {
+        type: "default",
+        indexName,
+        query,
+        distinct: 5,
+        hitsPerPage: 10,
+        filters: tag ? `tag:${tag}` : void 0
+      }
+    ]
+  });
+  const highlighter = createContentHighlighter(query);
+  return groupResults(result.results[0].hits).flatMap((hit) => {
+    if (hit.type === "page") {
+      return {
+        ...hit,
+        contentWithHighlights: hit.contentWithHighlights ?? highlighter.highlight(hit.content)
+      };
+    }
+    return [];
+  });
 }
 export {
   groupResults,

package/dist/chunk-CNWEGOUF.js

@@ -0,0 +1,53 @@
+// src/search/shared.ts
+function escapeRegExp(input) {
+  return input.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function buildRegexFromQuery(q) {
+  const trimmed = q.trim();
+  if (trimmed.length === 0) return null;
+  const terms = Array.from(
+    new Set(
+      trimmed.split(/\s+/).map((t) => t.trim()).filter(Boolean)
+    )
+  );
+  if (terms.length === 0) return null;
+  const escaped = terms.map(escapeRegExp).join("|");
+  return new RegExp(`(${escaped})`, "gi");
+}
+function createContentHighlighter(query) {
+  const regex = typeof query === "string" ? buildRegexFromQuery(query) : query;
+  return {
+    highlight(content) {
+      if (!regex) return [{ type: "text", content }];
+      const out = [];
+      let i = 0;
+      for (const match of content.matchAll(regex)) {
+        if (i < match.index) {
+          out.push({
+            type: "text",
+            content: content.substring(i, match.index)
+          });
+        }
+        out.push({
+          type: "text",
+          content: match[0],
+          styles: {
+            highlight: true
+          }
+        });
+        i = match.index + match[0].length;
+      }
+      if (i < content.length) {
+        out.push({
+          type: "text",
+          content: content.substring(i)
+        });
+      }
+      return out;
+    }
+  };
+}
+
+export {
+  createContentHighlighter
+};

package/dist/{chunk-62HKBTBF.js → chunk-KIJ7AMBP.js}

@@ -1,10 +1,14 @@
 import {
   removeUndefined
 } from "./chunk-KAOEMCTI.js";
+import {
+  createContentHighlighter
+} from "./chunk-CNWEGOUF.js";
 
 // src/search/orama/search/simple.ts
 import { search } from "@orama/orama";
 async function searchSimple(db, query, params = {}) {
+  const highlighter = createContentHighlighter(query);
   const result = await search(db, {
     term: query,
     tolerance: 1,
@@ -17,6 +21,7 @@ async function searchSimple(db, query, params = {}) {
   return result.hits.map((hit) => ({
     type: "page",
     content: hit.document.title,
+    contentWithHighlights: highlighter.highlight(hit.document.title),
     id: hit.document.url,
     url: hit.document.url
   }));
@@ -47,16 +52,18 @@ async function searchAdvanced(db, query, tag = [], extraParams = {}) {
       properties: ["content"]
     };
   }
+  const highlighter = createContentHighlighter(query);
   const result = await search2(db, params);
   const list = [];
   for (const item of result.groups ?? []) {
     const pageId = item.values[0];
-    const page = await getByID(db, pageId);
+    const page = getByID(db, pageId);
     if (!page) continue;
     list.push({
       id: pageId,
       type: "page",
       content: page.content,
+      contentWithHighlights: highlighter.highlight(page.content),
       url: page.url
     });
     for (const hit of item.result) {
@@ -64,6 +71,7 @@ async function searchAdvanced(db, query, tag = [], extraParams = {}) {
       list.push({
         id: hit.document.id.toString(),
         content: hit.document.content,
+        contentWithHighlights: highlighter.highlight(hit.document.content),
         type: hit.document.type,
         url: hit.document.url
       });

package/dist/mdx-plugins/index.js

@@ -308,6 +308,7 @@ import * as path from "path";
 import { visit } from "unist-util-visit";
 import { imageSize } from "image-size";
 import { imageSizeFromFile } from "image-size/fromFile";
+import { fileURLToPath } from "url";
 var VALID_BLUR_EXT = [".jpeg", ".png", ".webp", ".avif", ".jpg"];
 var EXTERNAL_URL_REGEX = /^https?:\/\//;
 function remarkImage({
@@ -320,79 +321,21 @@ function remarkImage({
   return async (tree, file) => {
     const importsToInject = [];
     const promises = [];
-    function getImportPath(src) {
-      if (!src.startsWith("/")) return src;
-      const to = path.join(publicDir, src);
-      if (file.dirname) {
-        const relative2 = slash(path.relative(file.dirname, to));
-        return relative2.startsWith("./") ? relative2 : `./${relative2}`;
-      }
-      return slash(to);
-    }
-    visit(tree, "image", (node) => {
-      const url = decodeURI(node.url);
-      if (!url) return;
-      const isExternal = EXTERNAL_URL_REGEX.test(url);
-      if (isExternal && external || !useImport) {
-        const task = getImageSize(url, publicDir).then((size) => {
-          if (!size.width || !size.height) return;
-          Object.assign(node, {
-            type: "mdxJsxFlowElement",
-            name: "img",
-            attributes: [
-              {
-                type: "mdxJsxAttribute",
-                name: "alt",
-                value: node.alt ?? "image"
-              },
-              {
-                type: "mdxJsxAttribute",
-                name: "src",
-                value: url
-              },
-              {
-                type: "mdxJsxAttribute",
-                name: "width",
-                value: size.width.toString()
-              },
-              {
-                type: "mdxJsxAttribute",
-                name: "height",
-                value: size.height.toString()
-              }
-            ],
-            children: []
-          });
-        }).catch((e) => {
-          if (onError === "hide") {
-            Object.assign(node, {
-              type: "mdxJsxFlowElement",
-              name: null,
-              attributes: [],
-              children: []
-            });
-            return;
-          }
-          if (onError === "ignore") return;
-          if (onError === "error") {
-            throw new Error(
-              `[Remark Image] Failed obtain image size for ${url} (public directory configured as ${publicDir})`,
-              {
-                cause: e
-              }
-            );
-          }
-          onError(e);
-        });
-        promises.push(task);
-      } else if (!isExternal) {
-        const variableName = `__img${importsToInject.length.toString()}`;
-        const hasBlur = placeholder === "blur" && VALID_BLUR_EXT.some((ext) => url.endsWith(ext));
+    async function onImage(src, node) {
+      if (src.type === "file" && useImport) {
+        const variableName = `__img${importsToInject.length}`;
+        const hasBlur = placeholder === "blur" && VALID_BLUR_EXT.some((ext) => src.file.endsWith(ext));
+        if (!file.dirname) {
+          throw new Error(
+            "When `useImport` is enabled, you must specify `dirname` in the VFile passed to compiler."
+          );
+        }
         importsToInject.push({
           variableName,
-          importPath: getImportPath(url)
+          importPath: getImportPath(src.file, file.dirname)
         });
-        Object.assign(node, {
+        const out = {
+          children: [],
           type: "mdxJsxFlowElement",
           name: "img",
           attributes: [
@@ -401,11 +344,6 @@ function remarkImage({
               name: "alt",
               value: node.alt ?? "image"
             },
-            hasBlur && {
-              type: "mdxJsxAttribute",
-              name: "placeholder",
-              value: "blur"
-            },
             {
               type: "mdxJsxAttribute",
               name: "src",
@@ -419,14 +357,83 @@ function remarkImage({
                         type: "ExpressionStatement",
                         expression: { type: "Identifier", name: variableName }
                       }
-                    ]
+                    ],
+                    type: "Program",
+                    sourceType: "script"
                   }
                 }
               }
             }
-          ].filter(Boolean)
-        });
+          ]
+        };
+        if (hasBlur) {
+          out.attributes.push({
+            type: "mdxJsxAttribute",
+            name: "placeholder",
+            value: "blur"
+          });
+        }
+        return out;
       }
+      if (src.type === "url" && !external) return;
+      const size = await getImageSize(src).catch((e) => {
+        throw new Error(
+          `[Remark Image] Failed obtain image size for ${node.url} (public directory configured as ${publicDir})`,
+          {
+            cause: e
+          }
+        );
+      });
+      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()
+          }
+        ],
+        children: []
+      };
+    }
+    visit(tree, "image", (node) => {
+      const src = parseSrc(decodeURI(node.url), publicDir, file.dirname);
+      if (!src) return;
+      const task = onImage(src, node).catch((e) => {
+        if (onError === "ignore" || node.url.endsWith(".svg")) {
+          return;
+        }
+        if (onError === "hide") {
+          return {
+            type: "mdxJsxFlowElement",
+            name: null,
+            attributes: [],
+            children: []
+          };
+        }
+        if (onError === "error") throw e;
+        onError(e);
+      }).then((res) => {
+        if (res) Object.assign(node, res);
+      });
+      promises.push(task);
     });
     await Promise.all(promises);
     if (importsToInject.length === 0) return;
@@ -454,22 +461,47 @@ function remarkImage({
     tree.children.unshift(...imports);
   };
 }
-async function getImageSize(src, dir) {
-  const isRelative = src.startsWith("/") || !path.isAbsolute(src);
-  let url;
+function getImportPath(file, dir) {
+  const relative2 = slash(path.relative(dir, file));
+  return relative2.startsWith("../") ? relative2 : `./${relative2}`;
+}
+function parseSrc(src, publicDir, dir) {
+  if (src.startsWith("file:///"))
+    return { type: "file", file: fileURLToPath(src) };
   if (EXTERNAL_URL_REGEX.test(src)) {
-    url = src;
-  } else if (EXTERNAL_URL_REGEX.test(dir) && isRelative) {
-    const base = new URL(dir);
-    base.pathname = joinPath(base.pathname, src);
-    url = base.toString();
-  } else {
-    return imageSizeFromFile(isRelative ? path.join(dir, src) : src);
+    return {
+      type: "url",
+      url: new URL(src)
+    };
   }
-  const res = await fetch(url);
+  if (src.startsWith("/")) {
+    if (EXTERNAL_URL_REGEX.test(publicDir)) {
+      const url = new URL(publicDir);
+      url.pathname = joinPath(url.pathname, src);
+      return { type: "url", url };
+    }
+    return {
+      type: "file",
+      file: path.join(publicDir, src)
+    };
+  }
+  if (!dir) {
+    console.warn(
+      `[Remark Image] found relative path ${src} but missing 'dirname' in VFile, this image will be skipped for now.`
+    );
+    return;
+  }
+  return {
+    type: "file",
+    file: path.join(dir, src)
+  };
+}
+async function getImageSize(src) {
+  if (src.type === "file") return imageSizeFromFile(src.file);
+  const res = await fetch(src.url);
   if (!res.ok) {
     throw new Error(
-      `[Remark Image] Failed to fetch ${url} (${res.status}): ${await res.text()}`
+      `[Remark Image] Failed to fetch ${src.url} (${res.status}): ${await res.text()}`
     );
   }
   return imageSize(new Uint8Array(await res.arrayBuffer()));

package/dist/{mixedbread-2MQ3PSN7.js → mixedbread-AG5AAOKO.js}

@@ -88,7 +88,7 @@ async function search(query, options) {
       return_metadata: true
     }
   });
-  const results = res.data.flatMap((item) => {
+  return res.data.flatMap((item) => {
     const metadata = item.generated_metadata;
     const url = metadata.url || "#";
     const title = metadata.title || "Untitled";
@@ -112,7 +112,6 @@ async function search(query, options) {
     }
     return chunkResults;
   });
-  return results;
 }
 export {
   search

package/dist/{orama-cloud-6T5Z4MZY.js → orama-cloud-BYTAI6QU.js}

@@ -1,10 +1,14 @@
 import {
   removeUndefined
 } from "./chunk-KAOEMCTI.js";
+import {
+  createContentHighlighter
+} from "./chunk-CNWEGOUF.js";
 import "./chunk-JSBRDJBE.js";
 
 // src/search/client/orama-cloud.ts
 async function searchDocs(query, options) {
+  const highlighter = createContentHighlighter(query);
   const list = [];
   const { index = "default", client, params: extraParams = {}, tag } = options;
   if (index === "crawler") {
@@ -20,26 +24,26 @@ async function searchDocs(query, options) {
       limit: 10
     });
     if (!result2) return list;
-    if (index === "crawler") {
-      for (const hit of result2.hits) {
-        const doc = hit.document;
-        list.push(
-          {
-            id: hit.id,
-            type: "page",
-            content: doc.title,
-            url: doc.path
-          },
-          {
-            id: "page" + hit.id,
-            type: "text",
-            content: doc.content,
-            url: doc.path
-          }
-        );
-      }
-      return list;
+    for (const hit of result2.hits) {
+      const doc = hit.document;
+      list.push(
+        {
+          id: hit.id,
+          type: "page",
+          content: doc.title,
+          contentWithHighlights: highlighter.highlight(doc.title),
+          url: doc.path
+        },
+        {
+          id: "page" + hit.id,
+          type: "text",
+          content: doc.content,
+          contentWithHighlights: highlighter.highlight(doc.content),
+          url: doc.path
+        }
+      );
     }
+    return list;
   }
   const params = {
     ...extraParams,
@@ -65,6 +69,7 @@ async function searchDocs(query, options) {
           id: doc.page_id,
           type: "page",
           content: doc.title,
+          contentWithHighlights: highlighter.highlight(doc.title),
           url: doc.url
         });
         addedHead = true;
@@ -72,6 +77,7 @@ async function searchDocs(query, options) {
       list.push({
         id: doc.id,
         content: doc.content,
+        contentWithHighlights: highlighter.highlight(doc.content),
         type: doc.content === doc.section ? "heading" : "text",
         url: doc.section_id ? `${doc.url}#${doc.section_id}` : doc.url
       });

package/dist/search/client.d.ts

@@ -1,14 +1,14 @@
-import { S as SortedResult } from '../types-Ch8gnVgO.js';
 import { AnyOrama } from '@orama/orama';
+import '../remark-structure-DVje0Sib.js';
 import { BaseIndex } from './algolia.js';
 import { LiteClient, SearchResponse } from 'algoliasearch/lite';
 import { OramaClient, ClientSearchParams } from '@oramacloud/client';
 import Mixedbread from '@mixedbread/sdk';
-import 'algoliasearch';
-import '../remark-structure-DVje0Sib.js';
+import { S as SortedResult } from '../shared-ORgOfXFw.js';
 import 'mdast';
 import 'unified';
 import 'mdast-util-mdx-jsx';
+import 'algoliasearch';
 
 interface FetchOptions {
     /**

package/dist/search/client.js

@@ -69,19 +69,19 @@ function useDocsSearch(clientOptions, _locale, _tag, _delayMs = 100, _allowEmpty
           return fetchDocs(debouncedValue, client);
         }
         if (client.type === "algolia") {
-          const { searchDocs } = await import("../algolia-UCGCELZZ.js");
+          const { searchDocs } = await import("../algolia-KPRGMSJO.js");
           return searchDocs(debouncedValue, client);
         }
         if (client.type === "orama-cloud") {
-          const { searchDocs } = await import("../orama-cloud-6T5Z4MZY.js");
+          const { searchDocs } = await import("../orama-cloud-BYTAI6QU.js");
           return searchDocs(debouncedValue, client);
         }
         if (client.type === "static") {
-          const { search: search2 } = await import("../static-7YX4RCT6.js");
+          const { search: search2 } = await import("../static-IWYDJ3C5.js");
           return search2(debouncedValue, client);
         }
         if (client.type === "mixedbread") {
-          const { search: search2 } = await import("../mixedbread-2MQ3PSN7.js");
+          const { search: search2 } = await import("../mixedbread-AG5AAOKO.js");
           return search2(debouncedValue, client);
         }
         throw new Error("unknown search client");

package/dist/search/server.d.ts

@@ -1,6 +1,7 @@
 import { TypedDocument, Orama, Language, RawData, create, SearchParams } from '@orama/orama';
 import { S as StructuredData } from '../remark-structure-DVje0Sib.js';
-import { S as SortedResult } from '../types-Ch8gnVgO.js';
+import { S as SortedResult } from '../shared-ORgOfXFw.js';
+export { H as HighlightedText, c as createContentHighlighter } from '../shared-ORgOfXFw.js';
 import { I18nConfig } from '../i18n/index.js';
 import { LoaderOutput, LoaderConfig, InferPageType } from '../source/index.js';
 import 'mdast';
@@ -133,4 +134,4 @@ interface AdvancedIndex {
 }
 declare function initAdvancedSearch(options: AdvancedOptions): SearchServer;
 
-export { type AdvancedIndex, type AdvancedOptions, type Dynamic, type ExportedData, type Index, type SearchAPI, type SearchServer, type SimpleOptions, createFromSource, createI18nSearchAPI, createSearchAPI, initAdvancedSearch, initSimpleSearch };
+export { type AdvancedIndex, type AdvancedOptions, type Dynamic, type ExportedData, type Index, type SearchAPI, type SearchServer, type SimpleOptions, SortedResult, createFromSource, createI18nSearchAPI, createSearchAPI, initAdvancedSearch, initSimpleSearch };

package/dist/search/server.js

@@ -1,8 +1,11 @@
 import {
   searchAdvanced,
   searchSimple
-} from "../chunk-62HKBTBF.js";
+} from "../chunk-KIJ7AMBP.js";
 import "../chunk-KAOEMCTI.js";
+import {
+  createContentHighlighter
+} from "../chunk-CNWEGOUF.js";
 import {
   basename,
   extname
@@ -339,6 +342,7 @@ function initAdvancedSearch(options) {
   };
 }
 export {
+  createContentHighlighter,
   createFromSource,
   createI18nSearchAPI,
   createSearchAPI,

package/dist/server/index.d.ts

@@ -1,10 +1,10 @@
 export { a as TOCItemType, T as TableOfContents, g as getTableOfContents } from '../get-toc-Cr2URuiP.js';
 import { N as Node, I as Item, R as Root, F as Folder } from '../page-tree-bSt6K__E.js';
 export { p as PageTree } from '../page-tree-bSt6K__E.js';
-export { S as SortedResult } from '../types-Ch8gnVgO.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';
 import 'react';
 import 'unified';
 import 'vfile';

package/dist/shared-ORgOfXFw.d.ts

@@ -0,0 +1,19 @@
+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 };

package/dist/{static-7YX4RCT6.js → static-IWYDJ3C5.js}

@@ -1,8 +1,9 @@
 import {
   searchAdvanced,
   searchSimple
-} from "./chunk-62HKBTBF.js";
+} from "./chunk-KIJ7AMBP.js";
 import "./chunk-KAOEMCTI.js";
+import "./chunk-CNWEGOUF.js";
 import "./chunk-JSBRDJBE.js";
 
 // src/search/client/static.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-core",
-  "version": "15.6.9",
+  "version": "15.6.11",
   "description": "The library for building a documentation website in Next.js",
   "keywords": [
     "NextJs",
@@ -105,27 +105,27 @@
   },
   "devDependencies": {
     "@mdx-js/mdx": "^3.1.0",
-    "@mixedbread/sdk": "^0.19.0",
+    "@mixedbread/sdk": "^0.24.0",
     "@oramacloud/client": "^2.1.4",
-    "@tanstack/react-router": "^1.130.12",
+    "@tanstack/react-router": "^1.131.7",
     "@types/estree-jsx": "^1.0.5",
     "@types/hast": "^3.0.4",
     "@types/mdast": "^4.0.3",
     "@types/negotiator": "^0.6.4",
-    "@types/node": "24.1.0",
-    "@types/react": "^19.1.9",
+    "@types/node": "24.2.1",
+    "@types/react": "^19.1.10",
     "@types/react-dom": "^19.1.7",
     "algoliasearch": "5.35.0",
     "mdast-util-mdx-jsx": "^3.2.0",
     "mdast-util-mdxjs-esm": "^2.0.1",
-    "next": "^15.4.5",
-    "react-router": "^7.7.1",
+    "next": "^15.4.6",
+    "react-router": "^7.8.0",
     "remark-mdx": "^3.1.0",
     "remove-markdown": "^0.6.2",
     "typescript": "^5.9.2",
     "unified": "^11.0.5",
     "vfile": "^6.0.3",
-    "waku": "^0.23.7",
+    "waku": "^0.24.0",
     "eslint-config-custom": "0.0.0",
     "tsconfig": "0.0.0"
   },

package/dist/types-Ch8gnVgO.d.ts

@@ -1,8 +0,0 @@
-interface SortedResult {
-    id: string;
-    url: string;
-    type: 'page' | 'heading' | 'text';
-    content: string;
-}
-
-export type { SortedResult as S };