fumadocs-core 16.15.17 → 16.16.0

package/dist/mdx-plugins/index.js

@@ -1,7 +1,7 @@
 import { remarkHeading } from "./remark-heading.js";
 import { generateCodeBlockTabs, parseCodeBlockAttributes } from "./codeblock-utils.js";
 import { remarkGfm } from "./remark-gfm.js";
-import { r as transformerTab } from "../rehype-code.core-BwKlAUQz.js";
+import { r as transformerTab } from "../rehype-code.core-BFENmmvo.js";
 import { transformerIcon } from "./transformer-icon.js";
 import { rehypeCode, rehypeCodeDefaultOptions } from "./rehype-code.js";
 import { remarkImage } from "./remark-image.js";

package/dist/mdx-plugins/rehype-code.core.js

@@ -1,3 +1,3 @@
-import { n as rehypeCodeDefaultOptions, r as transformerTab, t as createRehypeCode } from "../rehype-code.core-BwKlAUQz.js";
+import { n as rehypeCodeDefaultOptions, r as transformerTab, t as createRehypeCode } from "../rehype-code.core-BFENmmvo.js";
 import { transformerIcon } from "./transformer-icon.js";
 export { createRehypeCode, rehypeCodeDefaultOptions, transformerIcon, transformerTab };

package/dist/mdx-plugins/rehype-code.js

@@ -1,5 +1,5 @@
 import { defaultShikiFactory, wasmShikiFactory } from "../highlight/shiki/full.js";
-import { n as rehypeCodeDefaultOptions$1, r as transformerTab, t as createRehypeCode } from "../rehype-code.core-BwKlAUQz.js";
+import { n as rehypeCodeDefaultOptions$1, r as transformerTab, t as createRehypeCode } from "../rehype-code.core-BFENmmvo.js";
 import { transformerIcon } from "./transformer-icon.js";
 //#region src/mdx-plugins/rehype-code.ts
 const rehypeCodeDefaultOptions = {

package/dist/{rehype-code.core-BwKlAUQz.js → rehype-code.core-BFENmmvo.js}

@@ -121,10 +121,11 @@ function transformerAddLanguage(lang) {
 	};
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@shikijs+transformers@4.4.3/node_modules/@shikijs/transformers/dist/index.mjs
+//#region ../../node_modules/.pnpm/@shikijs+transformers@4.5.0/node_modules/@shikijs/transformers/dist/index.mjs
 const RE_SPLIT_COMMENT = /(\s+\/\/)/;
 const RE_V1_END_COMMENT_PREFIX = /(?:\/\/|["'#]|;{1,2}|%{1,2}|--)(\s*)$/;
 const RE_V3_END_COMMENT_PREFIX = /(?:\/\/|#|;{1,2}|%{1,2}|--)(\s*)$/;
+const RE_LINE_COMMENT_PREFIX = /^(?:\/\/|["'#]|;{1,2}|%{1,2}|--)$/;
 /**
 * some comment formats have to be located at the end of line
 * hence we can skip matching them for other tokens
@@ -184,7 +185,7 @@ function parseComments(lines, jsx, matchAlgorithm) {
 				const prevToken = elements[i - 1];
 				if (prevToken?.type === "element") {
 					const prevHead = prevToken.children.at(0);
-					if (prevHead?.type === "text" && prevHead.value.includes("//")) {
+					if (prevHead?.type === "text" && (prevHead.value.includes("//") || RE_LINE_COMMENT_PREFIX.test(prevHead.value.trim()))) {
 						const combinedMatch = matchToken(prevHead.value + head.value, isLast);
 						if (combinedMatch) {
 							match = combinedMatch;
@@ -270,6 +271,7 @@ function v3ClearEndCommentPrefix(text) {
 	if (match && match[1].trim().length === 0) return text.slice(0, match.index).trimEnd();
 	return text;
 }
+const RE_NOTATION = /#?\s*\[!code\b(?:\\.|[^\]])*\]/gi;
 function createCommentNotationTransformer(name, regex, onMatch, matchAlgorithm) {
 	matchAlgorithm ??= "v3";
 	return {
@@ -284,7 +286,8 @@ function createCommentNotationTransformer(name, regex, onMatch, matchAlgorithm)
 			for (const comment of parsed) {
 				if (comment.info[1].length === 0) continue;
 				let lineIdx = lines.indexOf(comment.line);
-				if (comment.isLineCommentOnly && matchAlgorithm !== "v1") lineIdx++;
+				const isStandaloneNotation = comment.info[1].replace(RE_NOTATION, "").replace(regex, "").trim().length === 0;
+				if (comment.isLineCommentOnly && isStandaloneNotation && matchAlgorithm !== "v1") lineIdx++;
 				let replaced = false;
 				comment.info[1] = comment.info[1].replace(regex, (...match) => {
 					if (onMatch.call(this, match, comment.line, comment.token, lines, lineIdx)) {
@@ -449,12 +452,13 @@ function inheritElement(original, overrides) {
 const RE_CODE_WORD = /\s*\[!code word:((?:\\.|[^:\]])+)(:\d+)?\]/;
 const RE_UNESCAPE = /\\(.)/g;
 function transformerNotationWordHighlight(options = {}) {
-	const { classActiveWord = "highlighted-word", classActivePre = void 0 } = options;
+	const { classActiveWord = "highlighted-word", classActivePre = void 0, classActiveCode = void 0 } = options;
 	return createCommentNotationTransformer("@shikijs/transformers:notation-highlight-word", RE_CODE_WORD, function([_, word, range], _line, comment, lines, index) {
 		const lineNum = range ? Number.parseInt(range.slice(1), 10) : lines.length;
 		word = word.replace(RE_UNESCAPE, "$1");
 		for (let i = index; i < Math.min(index + lineNum, lines.length); i++) highlightWordInLine.call(this, lines[i], comment, word, classActiveWord);
 		if (classActivePre) this.addClassToHast(this.pre, classActivePre);
+		if (classActiveCode) this.addClassToHast(this.code, classActiveCode);
 		return true;
 	}, options.matchAlgorithm);
 }

package/dist/search/client/meilisearch.d.ts

@@ -0,0 +1,20 @@
+import { n as SearchClient } from "../../client-BcR4jyFl.js";
+import { Meilisearch } from "meilisearch";
+//#region src/search/client/meilisearch.d.ts
+export interface MeilisearchOptions {
+  /**
+   * Meilisearch client with a search API key
+   */
+  client: Meilisearch;
+  indexName: string;
+  /**
+   * Filter results with specific tag(s).
+   */
+  tag?: string | string[];
+  /**
+   * Filter results by locale.
+   */
+  locale?: string;
+}
+export declare function meilisearchClient(options: MeilisearchOptions): SearchClient;
+//#endregion

package/dist/search/client/meilisearch.js

@@ -0,0 +1,50 @@
+import { createContentHighlighter } from "../index.js";
+//#region src/search/client/meilisearch.ts
+function meilisearchClient(options) {
+	const { client, indexName, tag, locale } = options;
+	return {
+		deps: [
+			client,
+			indexName,
+			tag,
+			locale
+		],
+		async search(query) {
+			if (query.trim().length === 0) return [];
+			const filter = [];
+			if (locale) filter.push(`locale = ${JSON.stringify(locale)}`);
+			for (const item of typeof tag === "string" ? [tag] : tag ?? []) filter.push(`tag = ${JSON.stringify(item)}`);
+			const { hits } = await client.index(indexName).search(query, {
+				filter,
+				limit: 20
+			});
+			const highlighter = createContentHighlighter(query);
+			const groups = /* @__PURE__ */ new Map();
+			for (const hit of hits) {
+				let group = groups.get(hit.url);
+				if (!group) {
+					group = [{
+						id: hit.url,
+						type: "page",
+						content: highlighter.highlightMarkdown(hit.title),
+						breadcrumbs: hit.breadcrumbs,
+						url: hit.url
+					}];
+					groups.set(hit.url, group);
+				}
+				if (hit.type === "page") continue;
+				group.push({
+					id: hit.id.toString(),
+					type: hit.type,
+					content: highlighter.highlightMarkdown(hit.content),
+					url: hit.heading ? `${hit.url}#${hit.heading}` : hit.url
+				});
+			}
+			const results = [];
+			for (const group of groups.values()) results.push(...group);
+			return results;
+		}
+	};
+}
+//#endregion
+export { meilisearchClient };

package/dist/search/meilisearch.d.ts

@@ -0,0 +1,50 @@
+import { t as Awaitable } from "../types-D89QoQR-.js";
+import { i as StructuredData } from "../remark-structure-CnHwvNZr.js";
+import { S as LoaderOutput, b as LoaderConfig } from "../index-CBtz3H2e.js";
+import { Meilisearch } from "meilisearch";
+//#region src/search/meilisearch.d.ts
+export interface DocumentRecord {
+  title: string;
+  description?: string;
+  breadcrumbs?: string[];
+  /**
+   * URL to the page
+   */
+  url: string;
+  structured: StructuredData;
+  /**
+   * Tag(s) to filter results
+   */
+  tag?: string | string[];
+  locale?: string;
+}
+/**
+ * Document in Meilisearch, for the title, headings and paragraphs of a page
+ */
+export interface MeilisearchDocument extends Omit<DocumentRecord, 'description' | 'structured'> {
+  id: number;
+  type: 'page' | 'heading' | 'text';
+  /**
+   * ID of the heading it belongs to
+   */
+  heading?: string;
+  content: string;
+}
+/**
+ * Build the search documents of every page in a source.
+ */
+export declare function toDocuments<C extends LoaderConfig>(source: LoaderOutput<C> | (() => Awaitable<LoaderOutput<C>>), options?: {
+  /** Tag to filter results by. */
+  tag?: (page: C['page']) => string | string[];
+}): Promise<DocumentRecord[]>;
+export interface SyncOptions {
+  indexName: string;
+  documents: DocumentRecord[];
+}
+/**
+ * Configure the index and replace its documents, existing documents stay searchable until the new ones are indexed.
+ *
+ * @param client - Meilisearch client with an admin API key
+ */
+export declare function sync(client: Meilisearch, options: SyncOptions): Promise<void>;
+//#endregion

package/dist/search/meilisearch.js

@@ -0,0 +1,55 @@
+import { n as buildDocuments, t as buildBreadcrumbs } from "../build-index-BD-VRKOW.js";
+//#region src/search/meilisearch.ts
+/**
+* Build the search documents of every page in a source.
+*/
+async function toDocuments(source, options = {}) {
+	const loader = typeof source === "function" ? await source() : source;
+	return buildDocuments(loader, (index, page) => ({
+		title: index.title,
+		description: index.description,
+		breadcrumbs: buildBreadcrumbs(loader, page),
+		url: index.url,
+		structured: index.structuredData,
+		tag: options.tag?.(page),
+		locale: page.locale
+	}));
+}
+/**
+* Configure the index and replace its documents, existing documents stay searchable until the new ones are indexed.
+*
+* @param client - Meilisearch client with an admin API key
+*/
+async function sync(client, options) {
+	const index = client.index(options.indexName);
+	const documents = [];
+	for (const { description, structured, ...page } of options.documents) {
+		const add = (type, content, heading) => documents.push({
+			...page,
+			id: documents.length,
+			type,
+			content,
+			heading
+		});
+		add("page", page.title);
+		if (description && !structured.contents.some((item) => item.content === description)) add("text", description);
+		for (const heading of structured.headings) add("heading", heading.content, heading.id);
+		for (const item of structured.contents) add("text", item.content, item.heading);
+	}
+	await run(index.updateSettings({
+		searchableAttributes: ["content"],
+		filterableAttributes: [
+			"id",
+			"tag",
+			"locale"
+		]
+	}));
+	await run(index.addDocuments(documents, { primaryKey: "id" }));
+	await run(index.deleteDocuments({ filter: `id >= ${documents.length}` }));
+}
+async function run(task) {
+	const { status, error } = await task.waitTask({ timeout: 0 });
+	if (status !== "succeeded") throw new Error(error ? error.message : `Meilisearch task ${status}`, { cause: error });
+}
+//#endregion
+export { sync, toDocuments };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-core",
-  "version": "16.15.17",
+  "version": "16.16.0",
   "description": "The React.js library for building a documentation website",
   "keywords": [
     "Docs",
@@ -75,11 +75,13 @@
     "./search/client/algolia": "./dist/search/client/algolia.js",
     "./search/client/fetch": "./dist/search/client/fetch.js",
     "./search/client/flexsearch-static": "./dist/search/client/flexsearch-static.js",
+    "./search/client/meilisearch": "./dist/search/client/meilisearch.js",
     "./search/client/mixedbread": "./dist/search/client/mixedbread.js",
     "./search/client/orama-cloud": "./dist/search/client/orama-cloud.js",
     "./search/client/orama-cloud-legacy": "./dist/search/client/orama-cloud-legacy.js",
     "./search/client/orama-static": "./dist/search/client/orama-static.js",
     "./search/flexsearch": "./dist/search/flexsearch.js",
+    "./search/meilisearch": "./dist/search/meilisearch.js",
     "./search/mixedbread": "./dist/search/mixedbread.js",
     "./search/orama-cloud": "./dist/search/orama-cloud.js",
     "./search/orama-cloud-legacy": "./dist/search/orama-cloud-legacy.js",
@@ -116,39 +118,40 @@
     "hast-util-to-estree": "^3.1.3",
     "hast-util-to-jsx-runtime": "^2.3.6",
     "mdast-util-mdx": "^3.0.0",
-    "mdast-util-to-markdown": "^2.1.2",
+    "mdast-util-to-markdown": "^2.1.3",
     "npm-to-yarn": "3.2.0",
     "remark": "^15.0.1",
     "remark-gfm": "^4.0.1",
     "remark-rehype": "^11.1.2",
     "scroll-into-view-if-needed": "^3.1.0",
-    "shiki": "^4.4.3",
+    "shiki": "^4.5.0",
     "tinyglobby": "^0.2.17",
     "unified": "^11.0.5",
     "unist-util-visit": "^5.1.0",
     "vfile": "^6.0.3",
     "yaml": "^2.9.1",
-    "zbsearch": "^4.0.0"
+    "zbsearch": "^4.0.1"
   },
   "devDependencies": {
     "@formatjs/intl-localematcher": "^0.9.0",
     "@mdx-js/mdx": "^3.1.1",
     "@mixedbread/sdk": "0.78.0",
-    "@modelcontextprotocol/server": "2.0.0",
+    "@modelcontextprotocol/server": "2.2.0",
     "@orama/core": "^1.2.19",
     "@oramacloud/client": "^2.1.4",
-    "@shikijs/transformers": "^4.4.3",
-    "@tanstack/react-router": "1.170.38",
+    "@shikijs/transformers": "^4.5.0",
+    "@tanstack/react-router": "1.170.41",
     "@types/estree-jsx": "^1.0.5",
     "@types/hast": "^3.0.5",
     "@types/mdast": "^4.0.4",
-    "@types/node": "26.6.1",
+    "@types/node": "26.6.4",
     "@types/react": "^19.3.0",
     "@types/react-dom": "^19.3.0",
     "algoliasearch": "5.59.0",
     "flexsearch": "^0.8.212",
-    "lucide-react": "^1.47.0",
-    "next": "16.3.5",
+    "lucide-react": "^1.50.0",
+    "meilisearch": "0.62.0",
+    "next": "16.3.8",
     "path-to-regexp": "^8.4.2",
     "react-router": "^8.4.0",
     "rehype-raw": "^7.0.0",
@@ -157,7 +160,7 @@
     "tsconfig": "0.0.0",
     "tsdown": "0.23.0",
     "typescript": "^7.0.2",
-    "waku": "1.0.0-rc.1",
+    "waku": "1.0.0-rc.2",
     "zod": "4.6.5"
   },
   "peerDependencies": {
@@ -174,6 +177,7 @@
     "algoliasearch": "5.x.x",
     "flexsearch": "*",
     "lucide-react": "*",
+    "meilisearch": ">=0.50.0 <1.0.0",
     "next": "16.x.x",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
@@ -215,6 +219,9 @@
     "algoliasearch": {
       "optional": true
     },
+    "meilisearch": {
+      "optional": true
+    },
     "next": {
       "optional": true
     },
@@ -243,7 +250,7 @@
   "inlinedDependencies": {
     "@formatjs/fast-memoize": "3.1.7",
     "@formatjs/intl-localematcher": "0.9.0",
-    "@shikijs/transformers": "4.4.3",
+    "@shikijs/transformers": "4.5.0",
     "path-to-regexp": "8.4.2"
   },
   "scripts": {