fumadocs-core 16.16.1 → 16.17.0

package/dist/{advanced-Ct13khZr.js → advanced-cJMxLDd5.js}

@@ -1,9 +1,7 @@
-import { createContentHighlighter } from "./search/index.js";
 import { t as removeUndefined } from "./remove-undefined-CzMSKybq.js";
 import { getByID, search } from "zbsearch";
 //#region src/search/zbsearch/search/simple.ts
 async function searchSimple(db, query, params = {}, locale) {
-	const highlighter = createContentHighlighter(query);
 	return (await search(db, {
 		term: query,
 		tolerance: 1,
@@ -18,7 +16,7 @@ async function searchSimple(db, query, params = {}, locale) {
 		})
 	})).hits.map((hit) => ({
 		type: "page",
-		content: highlighter.highlightMarkdown(hit.document.title),
+		content: hit.document.title,
 		breadcrumbs: hit.document.breadcrumbs,
 		id: hit.document.url,
 		url: hit.document.url
@@ -26,10 +24,10 @@ async function searchSimple(db, query, params = {}, locale) {
 }
 //#endregion
 //#region src/search/zbsearch/search/advanced.ts
-async function searchAdvanced(db, query, tag = [], { mode = "fulltext", ...override } = {}, locale) {
+async function searchAdvanced(db, query, tag = [], { mode = "fulltext", limit = 60, ...override } = {}, locale) {
 	if (typeof tag === "string") tag = [tag];
 	const params = {
-		limit: 60,
+		limit,
 		mode,
 		...override,
 		where: removeUndefined({
@@ -45,9 +43,7 @@ async function searchAdvanced(db, query, tag = [], { mode = "fulltext", ...overr
 		properties: mode === "fulltext" ? ["content"] : ["content", "embeddings"]
 	};
 	if (query.length > 0) params.term = query;
-	const highlighter = createContentHighlighter(query);
 	const result = await search(db, params);
-	const limit = typeof params.limit === "number" ? params.limit : Infinity;
 	const list = [];
 	for (const item of result.groups ?? []) {
 		if (list.length >= limit) break;
@@ -57,7 +53,7 @@ async function searchAdvanced(db, query, tag = [], { mode = "fulltext", ...overr
 		list.push({
 			id: pageId,
 			type: "page",
-			content: highlighter.highlightMarkdown(page.content),
+			content: page.content,
 			breadcrumbs: page.breadcrumbs,
 			url: page.url
 		});
@@ -66,10 +62,11 @@ async function searchAdvanced(db, query, tag = [], { mode = "fulltext", ...overr
 			if (hit.document.type === "page") continue;
 			list.push({
 				id: hit.document.id.toString(),
-				content: highlighter.highlightMarkdown(hit.document.content),
+				content: hit.document.content,
 				breadcrumbs: hit.document.breadcrumbs,
 				type: hit.document.type,
-				url: hit.document.url
+				url: hit.document.url,
+				table: hit.document.table
 			});
 		}
 	}

package/dist/{algolia-C5o8qrQ1.d.ts → algolia-6p3_Zitq.d.ts}

@@ -1,6 +1,6 @@
 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 { n as StructuredData } from "./remark-structure-C4hp7I5L.js";
+import { S as LoaderOutput, b as LoaderConfig } from "./index-CzLpE50a.js";
 import { Algoliasearch } from "algoliasearch";
 //#region src/search/algolia.d.ts
 interface DocumentRecord {
@@ -70,6 +70,7 @@ interface BaseIndex {
   section_id?: string;
   breadcrumbs?: string[];
   content: string;
+  table?: string;
 }
 //#endregion
 export { sync as a, setIndexSettings as i, DocumentRecord as n, toDocuments as o, SyncOptions as r, updateDocuments as s, BaseIndex as t };

package/dist/{build-doc-Cjg7QvFR.js → build-doc-C7HYXyRK.js}

@@ -42,7 +42,8 @@ function buildDocuments(indexes) {
 			type: "text",
 			url: content.heading ? `${page.url}#${content.heading}` : page.url,
 			content: content.content,
-			locale: page.locale
+			locale: page.locale,
+			table: content.table
 		});
 	}
 	return docs;

package/dist/{client-BcR4jyFl.d.ts → client-4RUaXHFg.d.ts}

@@ -1,12 +1,74 @@
 import { t as Awaitable } from "./types-D89QoQR-.js";
-import { r as SortedResult } from "./index-BM36H-xw.js";
-import { t as BaseIndex } from "./algolia-C5o8qrQ1.js";
+import { r as SortedResult } from "./index-BbTxYEFm.js";
+import { t as BaseIndex } from "./algolia-6p3_Zitq.js";
+import "./mixedbread-Df-Sw_4f.js";
 import { DependencyList } from "react";
 import { AnyZBSearch, SearchParams } from "zbsearch";
+import { Root } from "hast";
 import { LiteClient, SearchResponse } from "algoliasearch/lite";
 import { OramaCloud, OramaCloudSearchParams } from "@orama/core";
+import { Meilisearch } from "meilisearch";
 import { ClientSearchParams, OramaClient } from "@oramacloud/client";
 import Mixedbread from "@mixedbread/sdk";
+//#region src/search/use-search.d.ts
+interface UseSearchOptions {
+  /**
+   * The debounced delay for performing a search (in ms).
+   *
+   * @defaultValue 100
+   */
+  delayMs?: number;
+  /**
+   * still perform search even if query is empty.
+   *
+   * @defaultValue false
+   */
+  allowEmpty?: boolean;
+}
+interface SearchResultRecord extends SortedResult {
+  /** `content` parsed */
+  hastContent: Root;
+}
+interface SearchResultTable {
+  type: 'table';
+  /** the id of its first row */
+  id: string;
+  columns: number;
+  /** tables like the props of type tables have no header */
+  header?: Root;
+  rows: SearchResultRecord[];
+}
+type SearchResultItem = SearchResultRecord | SearchResultTable;
+interface SearchResult {
+  /** the query searched for */
+  query: string;
+  items: SearchResultItem[];
+}
+interface UseSearchReturn {
+  search: string;
+  onSearchChange: (search: string) => void;
+  /** a search for `search` is pending */
+  isLoading: boolean;
+  /** the last successful search, `undefined` when nothing is searched */
+  data?: SearchResult;
+  /** the last search failed, `data` stays from the search before */
+  error?: Error;
+}
+/**
+ * The base of search hooks, for search engines without one.
+ *
+ * @param run - memoized search function, search again when changed
+ */
+declare function useSearch(run: (query: string) => Awaitable<SortedResult[]>, { delayMs, allowEmpty }?: UseSearchOptions): UseSearchReturn;
+/**
+ * Highlight matches of `query` in the text of an element with the CSS Custom Highlight API, style them with `::highlight(fd-search)`.
+ *
+ * Text in elements with `data-highlight-ignore` is skipped. The highlights stay when the element is moved, but not when its text changes, give it a new `key` in that case.
+ *
+ * @returns a ref callback for the element
+ */
+declare function useHighlightQuery(query: string): (element: Element | null) => () => void;
+//#endregion
 //#region src/search/client/fetch.d.ts
 interface FetchOptions {
   /**
@@ -25,7 +87,11 @@ interface FetchOptions {
   locale?: string;
   cache?: Map<string, SortedResult[]>;
 }
-declare function fetchClient({ api, locale, tag, cache }?: FetchOptions): SearchClient;
+declare function fetchClient(options?: FetchOptions): SearchClient;
+/**
+ * Search with the search server, or an API of the same format.
+ */
+declare function useFetchSearch({ api, locale, tag, ...rest }?: FetchOptions & UseSearchOptions): UseSearchReturn;
 //#endregion
 //#region src/search/client/orama-static.d.ts
 interface StaticOptions {
@@ -59,6 +125,10 @@ interface StaticOptions {
   search?: Partial<SearchParams<AnyZBSearch>>;
 }
 declare function staticClient(options?: StaticOptions): SearchClient;
+/**
+ * Search the indexes exported by the search server, in the browser.
+ */
+declare function useStaticSearch({ from, locale, tag, ...rest }?: StaticOptions & UseSearchOptions): UseSearchReturn;
 /**
  * @deprecated Renamed to `staticClient`, note that the search engine is now ZBSearch.
  */
@@ -78,6 +148,7 @@ interface AlgoliaOptions {
   }>;
 }
 declare function algoliaClient(options: AlgoliaOptions): SearchClient;
+declare function useAlgoliaSearch({ indexName, client, locale, tag, ...rest }: AlgoliaOptions & UseSearchOptions): UseSearchReturn;
 //#endregion
 //#region src/search/client/orama-cloud.d.ts
 interface OramaCloudOptions {
@@ -102,6 +173,26 @@ interface OramaCloudOptions {
   locale?: string;
 }
 declare function oramaCloudClient(options: OramaCloudOptions): SearchClient;
+declare function useOramaCloudSearch({ client, index, tag, ...rest }: OramaCloudOptions & UseSearchOptions): UseSearchReturn;
+//#endregion
+//#region src/search/client/meilisearch.d.ts
+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;
+}
+declare function meilisearchClient(options: MeilisearchOptions): SearchClient;
+declare function useMeilisearch({ client, indexName, locale, tag, ...rest }: MeilisearchOptions & UseSearchOptions): UseSearchReturn;
 //#endregion
 //#region src/search/client/orama-cloud-legacy.d.ts
 interface OramaCloudLegacyOptions {
@@ -126,6 +217,7 @@ interface OramaCloudLegacyOptions {
   locale?: string;
 }
 declare function oramaCloudLegacyClient(options: OramaCloudLegacyOptions): SearchClient;
+declare function useOramaCloudLegacySearch({ client, index, tag, ...rest }: OramaCloudLegacyOptions & UseSearchOptions): UseSearchReturn;
 //#endregion
 //#region src/search/client/mixedbread.d.ts
 interface MixedbreadOptions {
@@ -146,16 +238,10 @@ interface MixedbreadOptions {
    */
   locale?: string;
 }
-interface SearchMetadata {
-  title?: string;
-  description?: string;
-  url?: string;
-  tag?: string;
-}
 /**
  * @deprecated Use `createMixedbreadSearchAPI` from `fumadocs-core/search/mixedbread` instead.
  * This client-side approach exposes your API key in the browser.
- * The server-side approach keeps the key secure and uses `client: fetchClient(...)` on the client.
+ * The server-side approach keeps the key secure and uses `useFetchSearch()` on the client.
  */
 declare function mixedbreadClient(options: MixedbreadOptions): SearchClient;
 //#endregion
@@ -169,79 +255,49 @@ interface FlexsearchStaticOptions {
   tag?: string | string[];
 }
 declare function flexsearchStaticClient(options?: FlexsearchStaticOptions): SearchClient;
+declare function useFlexsearchStatic({ from, locale, tag, ...rest }?: FlexsearchStaticOptions & UseSearchOptions): UseSearchReturn;
 //#endregion
-//#region src/search/client.d.ts
-interface UseDocsSearch {
-  search: string;
-  setSearch: (v: string) => void;
-  query: {
-    isLoading: boolean;
-    data?: SortedResult[] | 'empty';
-    error?: Error;
-  };
+//#region src/search/client/docs-search.d.ts
+interface SearchClient {
+  search: (query: string) => Awaitable<SortedResult[]>;
+  deps?: DependencyList;
 }
 type ClientPreset = ({
-  /**
-   * @deprecated Pass `client: fetchClient(...)` instead.
-   */
   type: 'fetch';
 } & FetchOptions) | ({
-  /**
-   * @deprecated Pass `client: staticClient(...)` instead.
-   */
   type: 'static';
 } & StaticOptions) | ({
-  /**
-   * @deprecated Pass `client: algoliaClient(...)` instead.
-   */
   type: 'algolia';
 } & AlgoliaOptions) | ({
-  /**
-   * @deprecated Pass `client: oramaCloudClient(...)` instead.
-   */
   type: 'orama-cloud';
 } & OramaCloudOptions) | ({
-  /**
-   * @deprecated Pass `client: oramaCloudLegacyClient(...)` instead.
-   */
   type: 'orama-cloud-legacy';
 } & OramaCloudLegacyOptions) | ({
-  /**
-   * @deprecated Pass `client: flexsearchStaticClient(...)` instead.
-   */
   type: 'flexsearch-static';
 } & FlexsearchStaticOptions) | ({
-  /**
-   * @deprecated Use `createMixedbreadSearchAPI` from `fumadocs-core/search/mixedbread` instead.
-   * This client-side approach exposes your API key in the browser.
-   * The server-side approach keeps the key secure and uses `client: fetchClient(...)` on the client.
-   */
   type: 'mixedbread';
 } & MixedbreadOptions) | {
   client: SearchClient;
 };
-interface SearchClient {
-  search: (query: string) => Awaitable<SortedResult[]>;
-  deps?: DependencyList;
-}
 /**
  * Provide a hook to query different official search clients.
  *
  * Note: it will re-query when its parameters changed, make sure to define `deps` array if you encounter rendering issues.
+ *
+ * @deprecated Use the search hook of your provider instead, like `useFetchSearch()`, or `experimental_useSearch()` for other clients.
  */
-declare function useDocsSearch(clientOptions: ClientPreset & {
-  /**
-   * The debounced delay for performing a search (in ms).
-   * .
-   * @defaultValue 100
-   */
-  delayMs?: number;
-  /**
-   * still perform search even if query is empty.
-   *
-   * @defaultValue false
-   */
-  allowEmpty?: boolean;
-}, customDeps?: DependencyList): UseDocsSearch;
+declare function useDocsSearch({ delayMs, allowEmpty, ...options }: ClientPreset & UseSearchOptions, customDeps?: DependencyList): {
+  search: string;
+  onSearchChange: (search: string) => void;
+  isLoading: boolean;
+  data?: SearchResult;
+  error?: Error;
+  setSearch: (search: string) => void;
+  query: {
+    isLoading: boolean;
+    data: "empty" | SearchResultRecord[];
+    error: Error | undefined;
+  };
+};
 //#endregion
-export { staticClient as _, flexsearchStaticClient as a, mixedbreadClient as c, OramaCloudOptions as d, oramaCloudClient as f, oramaStaticClient as g, StaticOptions as h, FlexsearchStaticOptions as i, OramaCloudLegacyOptions as l, algoliaClient as m, SearchClient as n, MixedbreadOptions as o, AlgoliaOptions as p, useDocsSearch as r, SearchMetadata as s, ClientPreset as t, oramaCloudLegacyClient as u, FetchOptions as v, fetchClient as y };
+export { SearchResultRecord as A, staticClient as C, useFetchSearch as D, fetchClient as E, useSearch as F, UseSearchOptions as M, UseSearchReturn as N, SearchResult as O, useHighlightQuery as P, oramaStaticClient as S, FetchOptions as T, useOramaCloudSearch as _, flexsearchStaticClient as a, useAlgoliaSearch as b, mixedbreadClient as c, useOramaCloudLegacySearch as d, MeilisearchOptions as f, oramaCloudClient as g, OramaCloudOptions as h, FlexsearchStaticOptions as i, SearchResultTable as j, SearchResultItem as k, OramaCloudLegacyOptions as l, useMeilisearch as m, SearchClient as n, useFlexsearchStatic as o, meilisearchClient as p, useDocsSearch as r, MixedbreadOptions as s, ClientPreset as t, oramaCloudLegacyClient as u, AlgoliaOptions as v, useStaticSearch as w, StaticOptions as x, algoliaClient as y };

package/dist/{codeblock-utils-CyP8qsYv.d.ts → codeblock-utils-D4AMPi6B.d.ts}

@@ -1,5 +1,5 @@
-import { MdxJsxAttribute, MdxJsxFlowElement } from "mdast-util-mdx";
 import { BlockContent, Text } from "mdast";
+import { MdxJsxAttribute, MdxJsxFlowElement } from "mdast-util-mdx";
 //#region src/mdx-plugins/codeblock-utils.d.ts
 interface CodeBlockTabsOptions {
   attributes?: MdxJsxAttribute[];

package/dist/content/mdx/preset-bundler.d.ts

@@ -1,10 +1,10 @@
 import { t as RehypeCodeOptions } from "../../rehype-code-CGahijs1.js";
 import { t as RemarkImageOptions } from "../../remark-image-BI2S9LOb.js";
-import { r as StructureOptions } from "../../remark-structure-CnHwvNZr.js";
+import { t as StructureOptions } from "../../remark-structure-C4hp7I5L.js";
 import { t as RemarkHeadingOptions } from "../../remark-heading-DEIzTkU5.js";
 import { t as RemarkCodeTabOptions } from "../../remark-code-tab-DE_4bdnu.js";
 import { t as RemarkNpmOptions } from "../../remark-npm-BbpvkJaT.js";
-import { t as index_d_exports } from "../../index-Cyv18VFj.js";
+import { t as index_d_exports } from "../../index-B-xgXq2T.js";
 import { t as ResolvePlugins } from "../../util-BDsqOxh3.js";
 import { Pluggable } from "unified";
 import { ProcessorOptions } from "@mdx-js/mdx";

package/dist/content/mdx/preset-runtime.d.ts

@@ -1,10 +1,10 @@
 import { t as RehypeCodeOptions } from "../../rehype-code-CGahijs1.js";
 import { t as RemarkImageOptions } from "../../remark-image-BI2S9LOb.js";
-import { r as StructureOptions } from "../../remark-structure-CnHwvNZr.js";
+import { t as StructureOptions } from "../../remark-structure-C4hp7I5L.js";
 import { t as RemarkHeadingOptions } from "../../remark-heading-DEIzTkU5.js";
 import { t as RemarkCodeTabOptions } from "../../remark-code-tab-DE_4bdnu.js";
 import { t as RemarkNpmOptions } from "../../remark-npm-BbpvkJaT.js";
-import { t as index_d_exports } from "../../index-Cyv18VFj.js";
+import { t as index_d_exports } from "../../index-B-xgXq2T.js";
 import { t as ResolvePlugins } from "../../util-BDsqOxh3.js";
 import { ProcessorOptions } from "@mdx-js/mdx";
 //#region src/content/mdx/preset-runtime.d.ts

package/dist/heading-id-CUA_RA6B.js

@@ -0,0 +1,16 @@
+//#region src/mdx-plugins/heading-id.ts
+/** a custom ID at the end of heading text, like `[#id]` */
+const headingIdRegex = /\s*\[#(?<slug>[^]+?)]\s*$/;
+/** write the ID of a heading in stringified Markdown, or remove its custom ID */
+function stringifyHeadingId(s, node, enabled) {
+	const start = s.range(node)?.start;
+	const last = node.children.at(-1);
+	const end = last && s.range(last)?.end;
+	if (start === void 0 || end === void 0) return;
+	const marker = headingIdRegex.exec(s.source.slice(start, end));
+	const id = node.data?.hProperties?.id;
+	if (!enabled && marker) s.edit(start + marker.index, end, "", node);
+	else if (enabled && !marker && id) s.edit(end, end, ` [#${id}]`, node);
+}
+//#endregion
+export { stringifyHeadingId as n, headingIdRegex as t };

package/dist/highlight-SXtD3BKk.js

@@ -0,0 +1,7 @@
+//#region src/search/highlight.ts
+function buildRegexFromQuery(query) {
+	const source = query.trim().replace(/[.*+?^${}()|[\]\\]/g, "\\$&").replace(/\s+/g, "|");
+	return source ? new RegExp(source, "gi") : null;
+}
+//#endregion
+export { buildRegexFromQuery as t };

package/dist/i18n/middleware.js

@@ -4085,7 +4085,8 @@ function createI18nMiddleware({ languages, defaultLanguage, format = DefaultForm
 			if (hideLocale === "default-locale") return NextResponse.rewrite(formatter.add(url, defaultLanguage));
 			const preferred = match(negotiateLanguages(request.headers.get("accept-language"), languages), languages, defaultLanguage);
 			if (hideLocale === "always") {
-				const locale = request.cookies.get(cookieName)?.value ?? preferred;
+				let locale = request.cookies.get(cookieName)?.value;
+				if (!locale || !languages.includes(locale)) locale = preferred;
 				return NextResponse.rewrite(formatter.add(url, locale));
 			}
 			return NextResponse.redirect(formatter.add(url, preferred));

package/dist/{index-Cyv18VFj.d.ts → index-B-xgXq2T.d.ts}

@@ -3,7 +3,7 @@ import { a as transformerTab } from "./rehype-code.core-COgx9A69.js";
 import { r as transformerIcon, t as CodeBlockIcon } from "./transformer-icon-DlrneIS3.js";
 import { n as rehypeCode, r as rehypeCodeDefaultOptions, t as RehypeCodeOptions } from "./rehype-code-CGahijs1.js";
 import { n as remarkImage, t as RemarkImageOptions } from "./remark-image-BI2S9LOb.js";
-import { a as defaultStringifier, c as structure, i as StructuredData, n as StringifyOptions, o as remarkStructure, r as StructureOptions, s as remarkStructureDefaultOptions, t as Stringifier } from "./remark-structure-CnHwvNZr.js";
+import { a as remarkStructureDefaultOptions, i as remarkStructure, n as StructuredData, o as structure, r as StructuredDataContent, t as StructureOptions } from "./remark-structure-C4hp7I5L.js";
 import { n as remarkHeading, t as RemarkHeadingOptions } from "./remark-heading-DEIzTkU5.js";
 import { n as remarkAdmonition, t as RemarkAdmonitionOptions } from "./remark-admonition-BwTcmI_S.js";
 import { n as remarkDirectiveAdmonition, t as RemarkDirectiveAdmonitionOptions } from "./remark-directive-admonition-BLiJ5l43.js";
@@ -11,13 +11,13 @@ import { n as RehypeTocOptions, r as rehypeToc, t as RehypeTOCItemType } from ".
 import { n as remarkCodeTab, t as RemarkCodeTabOptions } from "./remark-code-tab-DE_4bdnu.js";
 import { n as remarkSteps, t as RemarkStepsOptions } from "./remark-steps-DqVEo0iq.js";
 import { n as remarkNpm, t as RemarkNpmOptions } from "./remark-npm-BbpvkJaT.js";
-import { i as parseCodeBlockAttributes, n as CodeBlockTabsOptions, r as generateCodeBlockTabs, t as CodeBlockAttributes } from "./codeblock-utils-CyP8qsYv.js";
-import { a as remarkMdxFiles, r as RemarkMdxFilesOptions } from "./remark-mdx-files-Buvxc-sa.js";
+import { i as parseCodeBlockAttributes, n as CodeBlockTabsOptions, r as generateCodeBlockTabs, t as CodeBlockAttributes } from "./codeblock-utils-D4AMPi6B.js";
+import { a as remarkMdxFiles, r as RemarkMdxFilesOptions } from "./remark-mdx-files-NfjIpY1d.js";
 import { n as remarkMdxMermaid, t as RemarkMdxMermaidOptions } from "./remark-mdx-mermaid-C1bCHHc6.js";
 import { n as RemarkFeedbackBlockOptions, r as remarkFeedbackBlock, t as FeedbackBlockProps } from "./remark-feedback-block-BxtINXN-.js";
-import { t as LLMsOptions } from "./remark-llms-DxglVo94.js";
+import { t as LLMsOptions } from "./remark-llms-cgVaxL_5.js";
 declare namespace index_d_exports {
-  export { CodeBlockAttributes, CodeBlockIcon, CodeBlockTabsOptions, FeedbackBlockProps, LLMsOptions, RehypeCodeOptions, RehypeTOCItemType, RehypeTocOptions, RemarkAdmonitionOptions, RemarkCodeTabOptions, RemarkDirectiveAdmonitionOptions, RemarkFeedbackBlockOptions, RemarkGfmOptions, RemarkHeadingOptions, RemarkImageOptions, RemarkMdxFilesOptions, RemarkMdxMermaidOptions, RemarkNpmOptions, RemarkStepsOptions, Stringifier, StringifyOptions, StructureOptions, StructuredData, defaultStringifier, generateCodeBlockTabs, parseCodeBlockAttributes, rehypeCode, rehypeCodeDefaultOptions, rehypeToc, remarkAdmonition, remarkCodeTab, remarkDirectiveAdmonition, remarkFeedbackBlock, remarkGfm, remarkHeading, remarkImage, remarkMdxFiles, remarkMdxMermaid, remarkNpm, remarkSteps, remarkStructure, remarkStructureDefaultOptions, structure, transformerIcon, transformerTab };
+  export { CodeBlockAttributes, CodeBlockIcon, CodeBlockTabsOptions, FeedbackBlockProps, LLMsOptions, RehypeCodeOptions, RehypeTOCItemType, RehypeTocOptions, RemarkAdmonitionOptions, RemarkCodeTabOptions, RemarkDirectiveAdmonitionOptions, RemarkFeedbackBlockOptions, RemarkGfmOptions, RemarkHeadingOptions, RemarkImageOptions, RemarkMdxFilesOptions, RemarkMdxMermaidOptions, RemarkNpmOptions, RemarkStepsOptions, StructureOptions, StructuredData, StructuredDataContent, generateCodeBlockTabs, parseCodeBlockAttributes, rehypeCode, rehypeCodeDefaultOptions, rehypeToc, remarkAdmonition, remarkCodeTab, remarkDirectiveAdmonition, remarkFeedbackBlock, remarkGfm, remarkHeading, remarkImage, remarkMdxFiles, remarkMdxMermaid, remarkNpm, remarkSteps, remarkStructure, remarkStructureDefaultOptions, structure, transformerIcon, transformerTab };
 }
 //#endregion
 export { index_d_exports as t };

package/dist/index-BbTxYEFm.d.ts

@@ -0,0 +1,53 @@
+import { r as StructuredDataContent } from "./remark-structure-C4hp7I5L.js";
+import { ReactNode } from "react";
+//#region src/search/index.d.ts
+interface SortedResult<Content = string> {
+  id: string;
+  url: string;
+  type: 'page' | 'heading' | 'text';
+  content: Content;
+  /**
+   * breadcrumbs to be displayed on UI
+   */
+  breadcrumbs?: Content[];
+  /** the table of a table row, unique in its page */
+  table?: string;
+}
+type ReactSortedResult = SortedResult<ReactNode>;
+/**
+ * A table row as structured data: a Markdown table of the row, after the header row of its table.
+ */
+declare function tableRowToStructuredData({ table, heading, row, header }: {
+  /** the id of its table, unique in its page */
+  table: string;
+  heading?: string;
+  /** the cells, as inline Markdown */
+  row: string[];
+  /** the cells of the header row, tables like the props of type tables have none */
+  header?: string[];
+}): StructuredDataContent;
+/**
+ * @deprecated
+ */
+interface HighlightedText<Content = string> {
+  type: 'text';
+  content: Content;
+  styles?: {
+    highlight?: boolean;
+  };
+}
+/**
+ * @deprecated search results are no longer highlighted, highlight the rendered results with `useHighlightQuery()` instead.
+ */
+declare function createContentHighlighter(query: string | RegExp): {
+  /**
+   * @deprecated use `highlightMarkdown()` instead.
+   */
+  highlight(content: string): HighlightedText[];
+  /**
+   * @param content - Markdown, it assumes the content is already sanitized & safe, no escape is performed.
+   */
+  highlightMarkdown(content: string): string;
+};
+//#endregion
+export { tableRowToStructuredData as a, createContentHighlighter as i, ReactSortedResult as n, SortedResult as r, HighlightedText as t };

package/dist/{index-CBtz3H2e.d.ts → index-CzLpE50a.d.ts}

@@ -1,7 +1,7 @@
 import { a as Separator, i as Root, n as Item, o as definitions_d_exports, r as Node, t as Folder } from "./definitions-BZlqdyOx.js";
 import { t as Awaitable } from "./types-D89QoQR-.js";
-import { i as StructuredData } from "./remark-structure-CnHwvNZr.js";
-import "./index-Cyv18VFj.js";
+import { n as StructuredData } from "./remark-structure-C4hp7I5L.js";
+import "./index-B-xgXq2T.js";
 import { n as I18nConfig } from "./index-DydiXvgS.js";
 import { t as index_d_exports } from "./index-DUWMH-uy.js";
 import { n as SerializedPageTree } from "./index-DNn03jFO.js";
@@ -507,19 +507,19 @@ interface LLMsConfig<Page = unknown> {
    */
   renderPage?: (page: Page) => Awaitable<string>;
 }
-interface LLMs {
+interface LLMs<IndexOutput extends Awaitable<string> = Awaitable<string>> {
   /**
    * generate `llms.txt` content in Markdown format.
    *
    * use `indexNode(node)` instead for more control (e.g. add extra sections to output).
    */
-  index: (lang?: string) => Promise<string>;
+  index: (lang?: string) => IndexOutput;
   /**
    * generate `llms.txt` content for a single page tree node.
    */
-  indexNode: (node: Node, lang?: string) => Promise<string>;
+  indexNode: (node: Node, lang?: string) => IndexOutput;
 }
-interface LLMsWithPages<Page> extends LLMs {
+interface LLMsWithPages<Page, IndexOutput extends Awaitable<string> = Awaitable<string>> extends LLMs<IndexOutput> {
   /**
    * render a page with `renderPage`.
    */
@@ -529,9 +529,13 @@ interface LLMsWithPages<Page> extends LLMs {
    */
   full: (lang?: string) => Promise<string>;
 }
-declare function llms<C extends LoaderConfig = LoaderConfig>(input: LoaderOutput<C> | (() => Awaitable<LoaderOutput<C>>), config: LLMsConfig<C['page']> & {
+declare function llms<C extends LoaderConfig = LoaderConfig>(input: LoaderOutput<C>, config: LLMsConfig<C['page']> & {
   renderPage: (page: C['page']) => Awaitable<string>;
-}): LLMsWithPages<C['page']>;
-declare function llms<C extends LoaderConfig = LoaderConfig>(input: LoaderOutput<C> | (() => Awaitable<LoaderOutput<C>>), config?: LLMsConfig<C['page']>): LLMs;
+}): LLMsWithPages<C['page'], string>;
+declare function llms<C extends LoaderConfig = LoaderConfig>(input: LoaderOutput<C>, config?: LLMsConfig<C['page']>): LLMs<string>;
+declare function llms<C extends LoaderConfig = LoaderConfig>(input: () => Awaitable<LoaderOutput<C>>, config: LLMsConfig<C['page']> & {
+  renderPage: (page: C['page']) => Awaitable<string>;
+}): LLMsWithPages<C['page'], Promise<string>>;
+declare function llms<C extends LoaderConfig = LoaderConfig>(input: () => Awaitable<LoaderOutput<C>>, config?: LLMsConfig<C['page']>): LLMs<Promise<string>>;
 //#endregion
 export { types_d_exports as A, ContentStorage as B, LoaderPlugin as C, ResolvedLoaderConfig as D, Page as E, slugsPlugin as F, ContentStoragePageFile as H, PageTreeBuilder as I, PageTreeBuilderContext as L, SlugsPluginOptions as M, getSlugs as N, createGetUrl as O, slugsFromData as P, PageTreeOptions as R, LoaderOutput as S, Meta as T, FileSystem as U, ContentStorageMetaFile as V, dynamicLoader as _, path_d_exports as a, LoaderConfig as b, PageData as c, StaticSource as d, VirtualFile as f, DynamicLoaderConfig as g, DynamicLoader as h, llms as i, SlugFn as j, loader as k, Source as l, update as m, LLMsConfig as n, DynamicSource as o, multiple as p, LLMsWithPages as r, MetaData as s, LLMs as t, SourceUnion as u, InferMetaType as v, LoaderPluginOption as w, LoaderOptions as x, InferPageType as y, PageTreeTransformer as z };

package/dist/mcp.d.ts

@@ -1,6 +1,6 @@
 import { t as Awaitable } from "./types-D89QoQR-.js";
-import { r as SearchServer } from "./server-B7eP2V3p.js";
-import { S as LoaderOutput, b as LoaderConfig, r as LLMsWithPages } from "./index-CBtz3H2e.js";
+import { r as SearchServer } from "./server-BaG-Kb8Y.js";
+import { S as LoaderOutput, b as LoaderConfig, r as LLMsWithPages } from "./index-CzLpE50a.js";
 import { McpServer } from "@modelcontextprotocol/server";
 //#region src/mcp.d.ts
 /**

package/dist/mdx-plugins/codeblock-utils.d.ts

@@ -1,2 +1,2 @@
-import { i as parseCodeBlockAttributes, n as CodeBlockTabsOptions, r as generateCodeBlockTabs, t as CodeBlockAttributes } from "../codeblock-utils-CyP8qsYv.js";
+import { i as parseCodeBlockAttributes, n as CodeBlockTabsOptions, r as generateCodeBlockTabs, t as CodeBlockAttributes } from "../codeblock-utils-D4AMPi6B.js";
 export { CodeBlockAttributes, CodeBlockTabsOptions, generateCodeBlockTabs, parseCodeBlockAttributes };

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

@@ -3,7 +3,7 @@ import { a as transformerTab } from "../rehype-code.core-COgx9A69.js";
 import { r as transformerIcon, t as CodeBlockIcon } from "../transformer-icon-DlrneIS3.js";
 import { n as rehypeCode, r as rehypeCodeDefaultOptions, t as RehypeCodeOptions } from "../rehype-code-CGahijs1.js";
 import { n as remarkImage, t as RemarkImageOptions } from "../remark-image-BI2S9LOb.js";
-import { a as defaultStringifier, c as structure, i as StructuredData, n as StringifyOptions, o as remarkStructure, r as StructureOptions, s as remarkStructureDefaultOptions, t as Stringifier } from "../remark-structure-CnHwvNZr.js";
+import { a as remarkStructureDefaultOptions, i as remarkStructure, n as StructuredData, o as structure, r as StructuredDataContent, t as StructureOptions } from "../remark-structure-C4hp7I5L.js";
 import { n as remarkHeading, t as RemarkHeadingOptions } from "../remark-heading-DEIzTkU5.js";
 import { n as remarkAdmonition, t as RemarkAdmonitionOptions } from "../remark-admonition-BwTcmI_S.js";
 import { n as remarkDirectiveAdmonition, t as RemarkDirectiveAdmonitionOptions } from "../remark-directive-admonition-BLiJ5l43.js";
@@ -11,10 +11,10 @@ import { n as RehypeTocOptions, r as rehypeToc, t as RehypeTOCItemType } from ".
 import { n as remarkCodeTab, t as RemarkCodeTabOptions } from "../remark-code-tab-DE_4bdnu.js";
 import { n as remarkSteps, t as RemarkStepsOptions } from "../remark-steps-DqVEo0iq.js";
 import { n as remarkNpm, t as RemarkNpmOptions } from "../remark-npm-BbpvkJaT.js";
-import { i as parseCodeBlockAttributes, n as CodeBlockTabsOptions, r as generateCodeBlockTabs, t as CodeBlockAttributes } from "../codeblock-utils-CyP8qsYv.js";
-import { a as remarkMdxFiles, r as RemarkMdxFilesOptions } from "../remark-mdx-files-Buvxc-sa.js";
+import { i as parseCodeBlockAttributes, n as CodeBlockTabsOptions, r as generateCodeBlockTabs, t as CodeBlockAttributes } from "../codeblock-utils-D4AMPi6B.js";
+import { a as remarkMdxFiles, r as RemarkMdxFilesOptions } from "../remark-mdx-files-NfjIpY1d.js";
 import { n as remarkMdxMermaid, t as RemarkMdxMermaidOptions } from "../remark-mdx-mermaid-C1bCHHc6.js";
 import { n as RemarkFeedbackBlockOptions, r as remarkFeedbackBlock, t as FeedbackBlockProps } from "../remark-feedback-block-BxtINXN-.js";
-import { t as LLMsOptions } from "../remark-llms-DxglVo94.js";
-import "../index-Cyv18VFj.js";
-export { CodeBlockAttributes, type CodeBlockIcon, CodeBlockTabsOptions, FeedbackBlockProps, type LLMsOptions, RehypeCodeOptions, RehypeTOCItemType, RehypeTocOptions, RemarkAdmonitionOptions, RemarkCodeTabOptions, RemarkDirectiveAdmonitionOptions, RemarkFeedbackBlockOptions, type RemarkGfmOptions, RemarkHeadingOptions, RemarkImageOptions, type RemarkMdxFilesOptions, RemarkMdxMermaidOptions, RemarkNpmOptions, RemarkStepsOptions, Stringifier, StringifyOptions, StructureOptions, StructuredData, defaultStringifier, generateCodeBlockTabs, parseCodeBlockAttributes, rehypeCode, rehypeCodeDefaultOptions, rehypeToc, remarkAdmonition, remarkCodeTab, remarkDirectiveAdmonition, remarkFeedbackBlock, remarkGfm, remarkHeading, remarkImage, remarkMdxFiles, remarkMdxMermaid, remarkNpm, remarkSteps, remarkStructure, remarkStructureDefaultOptions, structure, transformerIcon, transformerTab };
+import { t as LLMsOptions } from "../remark-llms-cgVaxL_5.js";
+import "../index-B-xgXq2T.js";
+export { CodeBlockAttributes, type CodeBlockIcon, CodeBlockTabsOptions, FeedbackBlockProps, type LLMsOptions, RehypeCodeOptions, RehypeTOCItemType, RehypeTocOptions, RemarkAdmonitionOptions, RemarkCodeTabOptions, RemarkDirectiveAdmonitionOptions, RemarkFeedbackBlockOptions, type RemarkGfmOptions, RemarkHeadingOptions, RemarkImageOptions, type RemarkMdxFilesOptions, RemarkMdxMermaidOptions, RemarkNpmOptions, RemarkStepsOptions, StructureOptions, StructuredData, StructuredDataContent, generateCodeBlockTabs, parseCodeBlockAttributes, rehypeCode, rehypeCodeDefaultOptions, rehypeToc, remarkAdmonition, remarkCodeTab, remarkDirectiveAdmonition, remarkFeedbackBlock, remarkGfm, remarkHeading, remarkImage, remarkMdxFiles, remarkMdxMermaid, remarkNpm, remarkSteps, remarkStructure, remarkStructureDefaultOptions, structure, transformerIcon, transformerTab };

package/dist/mdx-plugins/index.js

@@ -1,11 +1,11 @@
 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-BFENmmvo.js";
+import { r as transformerTab } from "../rehype-code.core-BwH0Kyry.js";
 import { transformerIcon } from "./transformer-icon.js";
 import { rehypeCode, rehypeCodeDefaultOptions } from "./rehype-code.js";
 import { remarkImage } from "./remark-image.js";
-import { defaultStringifier, remarkStructure, remarkStructureDefaultOptions, structure } from "./remark-structure.js";
+import { remarkStructure, remarkStructureDefaultOptions, structure } from "./remark-structure.js";
 import { remarkAdmonition } from "./remark-admonition.js";
 import { remarkDirectiveAdmonition } from "./remark-directive-admonition.js";
 import { rehypeToc } from "./rehype-toc.js";
@@ -15,4 +15,4 @@ import { remarkNpm } from "./remark-npm.js";
 import { remarkMdxFiles } from "./remark-mdx-files.js";
 import { remarkMdxMermaid } from "./remark-mdx-mermaid.js";
 import { remarkFeedbackBlock } from "./remark-feedback-block.js";
-export { defaultStringifier, generateCodeBlockTabs, parseCodeBlockAttributes, rehypeCode, rehypeCodeDefaultOptions, rehypeToc, remarkAdmonition, remarkCodeTab, remarkDirectiveAdmonition, remarkFeedbackBlock, remarkGfm, remarkHeading, remarkImage, remarkMdxFiles, remarkMdxMermaid, remarkNpm, remarkSteps, remarkStructure, remarkStructureDefaultOptions, structure, transformerIcon, transformerTab };
+export { generateCodeBlockTabs, parseCodeBlockAttributes, rehypeCode, rehypeCodeDefaultOptions, rehypeToc, remarkAdmonition, remarkCodeTab, remarkDirectiveAdmonition, remarkFeedbackBlock, remarkGfm, remarkHeading, remarkImage, remarkMdxFiles, remarkMdxMermaid, remarkNpm, remarkSteps, remarkStructure, remarkStructureDefaultOptions, structure, transformerIcon, transformerTab };

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-BFENmmvo.js";
+import { n as rehypeCodeDefaultOptions, r as transformerTab, t as createRehypeCode } from "../rehype-code.core-BwH0Kyry.js";
 import { transformerIcon } from "./transformer-icon.js";
 export { createRehypeCode, rehypeCodeDefaultOptions, transformerIcon, transformerTab };