fumadocs-core 14.5.6 → 14.6.0

package/dist/{chunk-SNREABER.js → chunk-775SHR3E.js}

@@ -40,7 +40,6 @@ async function searchAdvanced(db, query, tag, extraParams = {}) {
     params = {
       ...params,
       term: query,
-      tolerance: 1,
       properties: ["content", "keywords"],
       ...extraParams,
       where: params.where,

package/dist/{chunk-7CSWJQ5H.js → chunk-VD7J34CI.js}

@@ -1,11 +1,7 @@
-// src/server/shiki.ts
-import {
-  getSingletonHighlighter
-} from "shiki";
+// src/utils/shiki.ts
 import { toJsxRuntime } from "hast-util-to-jsx-runtime";
 import { Fragment } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { createOnigurumaEngine } from "shiki/engine/oniguruma";
 function createStyleTransformer() {
   return {
     name: "rehype-code:styles",
@@ -23,37 +19,50 @@ var defaultThemes = {
   light: "github-light",
   dark: "github-dark"
 };
-async function highlight(code, options) {
-  const { lang, components, engine, ...rest } = options;
+async function _highlight(code, options) {
+  const { getSingletonHighlighter } = await import("shiki");
+  const { lang, components: _, engine: defaultEngine, ...rest } = options;
   let themes = { themes: defaultThemes };
   if ("theme" in options && options.theme) {
     themes = { theme: options.theme };
   } else if ("themes" in options && options.themes) {
     themes = { themes: options.themes };
   }
+  let engine = defaultEngine;
+  if (!engine) {
+    const { createOnigurumaEngine } = await import("shiki/engine/oniguruma");
+    engine = await createOnigurumaEngine(await import("shiki/wasm"));
+  }
   const highlighter = await getSingletonHighlighter({
     langs: [lang],
-    engine: engine ?? createOnigurumaEngine(() => import("shiki/wasm")),
+    engine,
     themes: "theme" in themes ? [themes.theme] : Object.values(themes.themes).filter((v) => v !== void 0)
   });
-  const hast = highlighter.codeToHast(code, {
+  return highlighter.codeToHast(code, {
     lang,
     ...rest,
     ...themes,
     transformers: [createStyleTransformer(), ...rest.transformers ?? []],
     defaultColor: "themes" in themes ? false : void 0
   });
+}
+function _renderHighlight(hast, options) {
   return toJsxRuntime(hast, {
     jsx,
     jsxs,
     development: false,
-    components,
+    components: options?.components,
     Fragment
   });
 }
+async function highlight(code, options) {
+  return _renderHighlight(await _highlight(code, options), options);
+}
 
 export {
   createStyleTransformer,
   defaultThemes,
+  _highlight,
+  _renderHighlight,
   highlight
 };

package/dist/mdx-plugins/index.js

@@ -9,7 +9,7 @@ import {
 import {
   createStyleTransformer,
   defaultThemes
-} from "../chunk-7CSWJQ5H.js";
+} from "../chunk-VD7J34CI.js";
 import "../chunk-MLKGABMK.js";
 
 // src/mdx-plugins/index.ts
@@ -20,7 +20,7 @@ import {
 // src/mdx-plugins/rehype-code.ts
 import rehypeShikiFromHighlighter from "@shikijs/rehype/core";
 
-// ../../node_modules/.pnpm/shiki-transformers@1.0.1_shiki@1.24.0/node_modules/shiki-transformers/dist/index.js
+// ../../node_modules/.pnpm/shiki-transformers@1.0.1_shiki@1.24.2/node_modules/shiki-transformers/dist/index.js
 var matchers = [
   [/^(<!--)(.+)(-->)$/, false],
   [/^(\/\*)(.+)(\*\/)$/, false],
@@ -437,6 +437,10 @@ var metaValues = [
   {
     name: "tab",
     regex: /tab="(?<value>[^"]+)"/
+  },
+  {
+    name: "tab",
+    regex: /tab/
   }
 ];
 var rehypeCodeDefaultOptions = {
@@ -453,19 +457,14 @@ var rehypeCodeDefaultOptions = {
   parseMetaString(meta) {
     const map = {};
     for (const value of metaValues) {
-      const result = value.regex.exec(meta);
-      if (result) {
-        map[value.name] = result[1];
-      }
+      meta = meta.replace(value.regex, (_, ...args) => {
+        const first = args.at(0);
+        map[value.name] = typeof first === "string" ? first : "";
+        return "";
+      });
     }
+    map.__parsed_raw = meta;
     return map;
-  },
-  filterMetaString(meta) {
-    let replaced = meta;
-    for (const value of metaValues) {
-      replaced = replaced.replace(value.regex, "");
-    }
-    return replaced;
   }
 };
 function rehypeCode(options = {}) {
@@ -478,6 +477,10 @@ function rehypeCode(options = {}) {
     {
       name: "rehype-code:pre-process",
       preprocess(code, { meta }) {
+        if (meta && "__parsed_raw" in meta) {
+          meta.__raw = meta.__parsed_raw;
+          delete meta.__parsed_raw;
+        }
         if (meta && codeOptions.filterMetaString) {
           meta.__raw = codeOptions.filterMetaString(meta.__raw ?? "");
         }
@@ -510,7 +513,7 @@ function rehypeCode(options = {}) {
     (instance) => rehypeShikiFromHighlighter(instance, codeOptions)
   );
   return async (tree, file) => {
-    await (await transformer)(tree, file, () => {
+    (await transformer)(tree, file, () => {
     });
   };
 }
@@ -519,8 +522,8 @@ function transformerTab() {
     name: "rehype-code:tab",
     // @ts-expect-error -- types not compatible with MDX
     root(root) {
-      const meta = this.options.meta;
-      if (typeof meta?.tab !== "string") return root;
+      const value = this.options.meta?.tab;
+      if (typeof value !== "string") return root;
       return {
         type: "root",
         children: [
@@ -530,9 +533,7 @@ function transformerTab() {
             data: {
               _codeblock: true
             },
-            attributes: [
-              { type: "mdxJsxAttribute", name: "value", value: meta.tab }
-            ],
+            attributes: value !== "" ? [{ type: "mdxJsxAttribute", name: "value", value }] : [],
             children: root.children
           }
         ]

package/dist/search/client.js

@@ -10,7 +10,7 @@ import { useMemo, useRef as useRef2, useState as useState2 } from "react";
 import { useRef, useState } from "react";
 function useDebounce(value, delayMs = 1e3) {
   const [debouncedValue, setDebouncedValue] = useState(value);
-  const timer = useRef();
+  const timer = useRef(void 0);
   if (delayMs === 0) return value;
   if (value !== debouncedValue && timer.current?.value !== value) {
     if (timer.current) clearTimeout(timer.current.handler);
@@ -31,7 +31,7 @@ function useDocsSearch(client, locale, tag, delayMs = 100, allowEmpty = false, k
   const [error, setError] = useState2();
   const [isLoading, setIsLoading] = useState2(false);
   const debouncedValue = useDebounce(search, delayMs);
-  const onStart = useRef2();
+  const onStart = useRef2(void 0);
   const cacheKey = useMemo(() => {
     return key ?? JSON.stringify([client.type, debouncedValue, locale, tag]);
   }, [client.type, debouncedValue, locale, tag, key]);
@@ -67,7 +67,7 @@ function useDocsSearch(client, locale, tag, delayMs = 100, allowEmpty = false, k
         const { searchDocs } = await import("../orama-cloud-QNHGN6SO.js");
         return searchDocs(debouncedValue, tag, client);
       }
-      const { createStaticClient } = await import("../static-FSUPSGDU.js");
+      const { createStaticClient } = await import("../static-HJNGYVTY.js");
       if (!staticClient) staticClient = createStaticClient(client);
       return staticClient.search(debouncedValue, locale, tag);
     }

package/dist/search/server.d.ts

@@ -1,4 +1,4 @@
-import { TypedDocument, Orama, Language, SearchParams, SorterConfig, Tokenizer, DefaultTokenizerConfig, OramaPlugin } from '@orama/orama';
+import { TypedDocument, Orama, Language, SearchParams, create } from '@orama/orama';
 import { NextRequest } from 'next/server';
 import { S as StructuredData } from '../remark-structure-mP51W1AN.js';
 import { S as SortedResult } from '../types-Ch8gnVgO.js';
@@ -48,7 +48,7 @@ declare function createI18nSearchAPI<T extends 'simple' | 'advanced'>(type: T, o
 type Options = Omit<AdvancedOptions, 'language' | 'indexes'> & {
     localeMap?: LocaleMap<Partial<AdvancedOptions>>;
 };
-declare function createFromSource<S extends LoaderOutput<LoaderConfig>>(source: S, pageToIndex?: (page: InferPageType<S>) => AdvancedIndex, options?: Options): SearchAPI;
+declare function createFromSource<S extends LoaderOutput<LoaderConfig>>(source: S, pageToIndexFn?: (page: InferPageType<S>) => AdvancedIndex, options?: Options): SearchAPI;
 
 interface SearchServer {
     search: (query: string, options?: {
@@ -73,12 +73,11 @@ interface SearchAPI extends SearchServer {
  * Resolve indexes dynamically
  */
 type Dynamic<T> = () => T[] | Promise<T[]>;
-interface SharedOptions {
+type OramaInput = Parameters<typeof create>[0];
+type SharedOptions = Pick<OramaInput, 'sort' | 'components' | 'plugins'> & {
     language?: string;
-    sort?: SorterConfig;
-    tokenizer?: Tokenizer | DefaultTokenizerConfig;
-    plugins?: OramaPlugin[];
-}
+    tokenizer?: Required<OramaInput>['components']['tokenizer'];
+};
 interface SimpleOptions extends SharedOptions {
     indexes: Index[] | Dynamic<Index>;
     /**

package/dist/search/server.js

@@ -1,14 +1,12 @@
 import {
   searchAdvanced,
   searchSimple
-} from "../chunk-SNREABER.js";
+} from "../chunk-775SHR3E.js";
 import "../chunk-2V6SCS43.js";
 import "../chunk-MLKGABMK.js";
 
 // src/search/server.ts
-import {
-  save
-} from "@orama/orama";
+import { save } from "@orama/orama";
 
 // src/search/create-endpoint.ts
 function createEndpoint(server) {
@@ -52,11 +50,11 @@ async function createDB({
 }) {
   const items = typeof indexes === "function" ? await indexes() : indexes;
   const db = await create({
-    ...rest,
     schema: advancedSchema,
     components: {
       tokenizer
-    }
+    },
+    ...rest
   });
   const mapTo = [];
   items.forEach((page) => {
@@ -111,20 +109,25 @@ import {
   create as create2,
   insertMultiple as insertMultiple2
 } from "@orama/orama";
+var schema = {
+  url: "string",
+  title: "string",
+  description: "string",
+  content: "string",
+  keywords: "string"
+};
 async function createDBSimple({
   indexes,
-  language
+  tokenizer,
+  ...rest
 }) {
   const items = typeof indexes === "function" ? await indexes() : indexes;
   const db = await create2({
-    language,
-    schema: {
-      url: "string",
-      title: "string",
-      description: "string",
-      content: "string",
-      keywords: "string"
-    }
+    schema,
+    components: {
+      tokenizer
+    },
+    ...rest
   });
   await insertMultiple2(
     db,
@@ -140,7 +143,7 @@ async function createDBSimple({
 }
 
 // src/search/create-from-source.ts
-function defaultToIndex(page) {
+function pageToIndex(page) {
   if (!("structuredData" in page.data)) {
     throw new Error(
       "Cannot find structured data from page, please define the page to index function."
@@ -154,7 +157,7 @@ function defaultToIndex(page) {
     structuredData: page.data.structuredData
   };
 }
-function createFromSource(source, pageToIndex = defaultToIndex, options = {}) {
+function createFromSource(source, pageToIndexFn = pageToIndex, options = {}) {
   if (source._i18n) {
     return createI18nSearchAPI("advanced", {
       ...options,
@@ -162,7 +165,7 @@ function createFromSource(source, pageToIndex = defaultToIndex, options = {}) {
       indexes: source.getLanguages().flatMap((entry) => {
         return entry.pages.map((page) => {
           return {
-            ...pageToIndex(page),
+            ...pageToIndexFn(page),
             locale: entry.language
           };
         });
@@ -172,7 +175,7 @@ function createFromSource(source, pageToIndex = defaultToIndex, options = {}) {
   return createSearchAPI("advanced", {
     ...options,
     indexes: source.getPages().map((page) => {
-      return pageToIndex(page);
+      return pageToIndexFn(page);
     })
   });
 }
@@ -277,7 +280,7 @@ function createI18nSearchAPI(type, options) {
         data: Object.fromEntries(await Promise.all(entries))
       };
     },
-    search: async (query, searchOptions) => {
+    async search(query, searchOptions) {
       const map = await get;
       const locale = searchOptions?.locale ?? options.i18n.defaultLanguage;
       const handler = map.get(locale);
@@ -303,7 +306,7 @@ function initSimpleSearch(options) {
         ...save(await doc)
       };
     },
-    search: async (query) => {
+    async search(query) {
       const db = await doc;
       return searchSimple(db, query, options.search);
     }
@@ -318,7 +321,7 @@ function initAdvancedSearch(options) {
         ...save(await get)
       };
     },
-    search: async (query, searchOptions) => {
+    async search(query, searchOptions) {
       const db = await get;
       return searchAdvanced(db, query, searchOptions?.tag, options.search);
     }

package/dist/server/index.d.ts

@@ -5,7 +5,7 @@ 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 { H as HighlightOptions, c as createStyleTransformer, d as defaultThemes, h as highlight } from '../shiki-FJwEmGMA.js';
+export { H as HighlightOptions, c as createStyleTransformer, h as highlight } from '../shiki-fdNJu0Yj.js';
 import 'react';
 import '../config-inq6kP6y.js';
 import 'shiki';

package/dist/server/index.js

@@ -3,9 +3,8 @@ import {
 } from "../chunk-4MNUWZIW.js";
 import {
   createStyleTransformer,
-  defaultThemes,
   highlight
-} from "../chunk-7CSWJQ5H.js";
+} from "../chunk-VD7J34CI.js";
 import "../chunk-MLKGABMK.js";
 
 // src/server/get-toc.ts
@@ -153,7 +152,6 @@ export {
   page_tree_exports as PageTree,
   createMetadataImage,
   createStyleTransformer,
-  defaultThemes,
   findNeighbour,
   flattenTree,
   getGithubLastEdit,

package/dist/{shiki-FJwEmGMA.d.ts → shiki-fdNJu0Yj.d.ts}

@@ -4,13 +4,9 @@ import { Components } from 'hast-util-to-jsx-runtime';
 import { ReactNode } from 'react';
 
 declare function createStyleTransformer(): ShikiTransformer;
-declare const defaultThemes: {
-    light: string;
-    dark: string;
-};
 type HighlightOptions = CodeToHastOptionsCommon<BundledLanguage> & Pick<HighlighterCoreOptions, 'engine'> & Partial<CodeOptionsThemes<BundledTheme>> & CodeOptionsMeta & {
     components?: Partial<Components>;
 };
 declare function highlight(code: string, options: HighlightOptions): Promise<ReactNode>;
 
-export { type HighlightOptions as H, createStyleTransformer as c, defaultThemes as d, highlight as h };
+export { type HighlightOptions as H, createStyleTransformer as c, highlight as h };

package/dist/{static-FSUPSGDU.js → static-HJNGYVTY.js}

@@ -1,7 +1,7 @@
 import {
   searchAdvanced,
   searchSimple
-} from "./chunk-SNREABER.js";
+} from "./chunk-775SHR3E.js";
 import "./chunk-2V6SCS43.js";
 import "./chunk-MLKGABMK.js";
 

package/dist/toc.d.ts

@@ -24,7 +24,7 @@ interface ScrollProviderProps {
     /**
      * Scroll into the view of container when active
      */
-    containerRef: RefObject<HTMLElement>;
+    containerRef: RefObject<HTMLElement | null>;
     children?: ReactNode;
 }
 declare function ScrollProvider({ containerRef, children, }: ScrollProviderProps): React.ReactElement;

package/dist/toc.js

@@ -70,7 +70,9 @@ function useAnchorObserver(watch, single) {
 // src/toc.tsx
 import { jsx } from "react/jsx-runtime";
 var ActiveAnchorContext = createContext([]);
-var ScrollContext = createContext({ current: null });
+var ScrollContext = createContext({
+  current: null
+});
 function useActiveAnchor() {
   return useContext(ActiveAnchorContext).at(-1);
 }

package/dist/utils/use-shiki.d.ts

@@ -1,11 +1,24 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, DependencyList } from 'react';
-import { H as HighlightOptions } from '../shiki-FJwEmGMA.js';
+import { H as HighlightOptions } from '../shiki-fdNJu0Yj.js';
+import { Root } from 'hast';
 import 'shiki';
 import 'shiki/themes';
 import 'hast-util-to-jsx-runtime';
 
-declare function useShiki(code: string, options: HighlightOptions & {
+declare global {
+    interface Window {
+        _use_shiki?: Map<string, Root>;
+    }
+}
+declare function useShiki(code: string, { defaultValue, scriptKey, ...options }: HighlightOptions & {
     defaultValue?: ReactNode;
+    scriptKey?: string;
 }, deps?: DependencyList): ReactNode;
+declare function PrerenderScript({ scriptKey, code, options, }: {
+    scriptKey: string;
+    code: string;
+    options: HighlightOptions;
+}): react_jsx_runtime.JSX.Element | null;
 
-export { useShiki };
+export { PrerenderScript, useShiki };

package/dist/utils/use-shiki.js

@@ -1,38 +1,96 @@
 "use client";
 import {
+  _highlight,
+  _renderHighlight,
   highlight
-} from "../chunk-7CSWJQ5H.js";
+} from "../chunk-VD7J34CI.js";
 import "../chunk-MLKGABMK.js";
 
 // src/utils/use-shiki.tsx
 import {
+  use,
   useEffect,
+  useRef,
   useState
 } from "react";
-import { createJavaScriptRegexEngine } from "shiki/engine/javascript";
 import { jsx } from "react/jsx-runtime";
 var jsEngine;
-function useShiki(code, options, deps) {
-  const [out, setOut] = useState(() => {
-    if (options.defaultValue) return options.defaultValue;
-    const { pre: Pre = "pre", code: Code = "code" } = options.components ?? {};
+function getHighlightOptions(from) {
+  if (from.engine) return from;
+  if (!jsEngine) {
+    jsEngine = import("shiki/engine/javascript").then(
+      (res) => res.createJavaScriptRegexEngine()
+    );
+  }
+  return {
+    ...from,
+    engine: jsEngine
+  };
+}
+var cache = /* @__PURE__ */ new Map();
+function useShiki(code, {
+  defaultValue,
+  scriptKey,
+  ...options
+}, deps) {
+  const key = deps ? JSON.stringify(deps) : `${options.lang}:${code}`;
+  const shikiOptions = getHighlightOptions(options);
+  const currentTask = useRef({
+    key,
+    aborted: false
+  });
+  const [rendered, setRendered] = useState(() => {
+    if (defaultValue) return defaultValue;
+    const cached = cache.get(key);
+    if (cached) return cached;
+    const hast = globalThis._use_shiki?.get(scriptKey);
+    if (hast) {
+      const node = _renderHighlight(hast, shikiOptions);
+      cache.set(key, node);
+      return node;
+    }
+    currentTask.current = void 0;
+    const Pre = options.components?.pre ?? "pre";
+    const Code = options.components?.code ?? "code";
     return /* @__PURE__ */ jsx(Pre, { children: /* @__PURE__ */ jsx(Code, { children: code }) });
   });
-  if (!options.engine && !jsEngine) {
-    jsEngine = createJavaScriptRegexEngine();
+  if (typeof window === "undefined") {
+    return use(highlight(code, shikiOptions));
   }
-  useEffect(
-    () => {
-      void highlight(code, {
-        ...options,
-        engine: options.engine ?? jsEngine
-      }).then(setOut);
-    },
-    // eslint-disable-next-line react-hooks/exhaustive-deps -- custom deps
-    deps ?? [code, options.lang]
+  if (!currentTask.current || currentTask.current.key !== key) {
+    if (currentTask.current) {
+      currentTask.current.aborted = true;
+    }
+    const task = {
+      key,
+      aborted: false
+    };
+    currentTask.current = task;
+    highlight(code, shikiOptions).then((result) => {
+      cache.set(key, result);
+      if (!task.aborted) setRendered(result);
+    });
+  }
+  return rendered;
+}
+function PrerenderScript({
+  scriptKey,
+  code,
+  options
+}) {
+  const [mounted, setMounted] = useState(false);
+  useEffect(() => {
+    setMounted(true);
+  }, []);
+  const tree = typeof window === "undefined" ? use(_highlight(code, getHighlightOptions(options))) : (
+    // @ts-expect-error -- typed
+    globalThis._use_shiki?.get(scriptKey)
   );
-  return out;
+  if (mounted || !tree) return null;
+  return /* @__PURE__ */ jsx("script", { children: `if (typeof globalThis._use_shiki === "undefined") globalThis._use_shiki = new Map()
+globalThis._use_shiki.set(${JSON.stringify(scriptKey)}, ${JSON.stringify(tree)})` });
 }
 export {
+  PrerenderScript,
   useShiki
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-core",
-  "version": "14.5.6",
+  "version": "14.6.0",
   "description": "The library for building a documentation website in Next.js",
   "keywords": [
     "NextJs",
@@ -73,9 +73,9 @@
     "dist/*"
   ],
   "dependencies": {
-    "@formatjs/intl-localematcher": "^0.5.8",
+    "@formatjs/intl-localematcher": "^0.5.9",
     "@orama/orama": "^2.1.1",
-    "@shikijs/rehype": "^1.24.0",
+    "@shikijs/rehype": "^1.24.2",
     "github-slugger": "^2.0.0",
     "hast-util-to-estree": "^3.1.0",
     "hast-util-to-jsx-runtime": "^2.3.2",
@@ -85,11 +85,10 @@
     "remark": "^15.0.0",
     "remark-gfm": "^4.0.0",
     "scroll-into-view-if-needed": "^3.1.0",
-    "shiki": "^1.24.0",
+    "shiki": "^1.24.2",
     "unist-util-visit": "^5.0.0"
   },
   "devDependencies": {
-    "typescript": "^5.7.2",
     "@algolia/client-search": "4.24.0",
     "@mdx-js/mdx": "^3.1.0",
     "@oramacloud/client": "^2.1.4",
@@ -98,15 +97,16 @@
     "@types/mdast": "^4.0.3",
     "@types/negotiator": "^0.6.3",
     "@types/node": "22.10.1",
-    "@types/react": "^18.3.12",
-    "@types/react-dom": "^18.3.1",
+    "@types/react": "^19.0.1",
+    "@types/react-dom": "^19.0.2",
     "algoliasearch": "4.24.0",
     "mdast-util-mdx-jsx": "^3.1.3",
     "mdast-util-mdxjs-esm": "^2.0.1",
-    "next": "^15.0.3",
+    "next": "^15.0.4",
     "remark-mdx": "^3.1.0",
     "remark-rehype": "^11.1.1",
     "shiki-transformers": "^1.0.1",
+    "typescript": "^5.7.2",
     "unified": "^11.0.5",
     "eslint-config-custom": "0.0.0",
     "tsconfig": "0.0.0"
@@ -115,8 +115,8 @@
     "@oramacloud/client": "1.x.x || 2.x.x",
     "algoliasearch": "4.24.0",
     "next": "14.x.x || 15.x.x",
-    "react": ">= 18",
-    "react-dom": ">= 18"
+    "react": "18.x.x || 19.x.x",
+    "react-dom": "18.x.x || 19.x.x"
   },
   "peerDependenciesMeta": {
     "@oramacloud/client": {