@fumadocs/ui 16.2.5

package/css/colors/vitepress.css

@@ -0,0 +1,77 @@
+@import './index.css';
+
+@theme {
+  --color-fd-muted: hsl(0, 0%, 96.1%);
+  --color-fd-popover: hsl(0, 0%, 100%);
+  --color-fd-popover-foreground: hsl(0, 0%, 15.1%);
+  --color-fd-card-foreground: hsl(0, 0%, 3.9%);
+  --color-fd-border: hsl(0, 0%, 89.8%);
+  --color-fd-primary-foreground: hsl(0, 0%, 98%);
+  --color-fd-secondary-foreground: hsl(0, 0%, 9%);
+  --color-fd-accent: hsl(0, 0%, 94.1%);
+  --color-fd-ring: hsl(0, 0%, 63.9%);
+
+  --color-fd-background: hsl(0, 0%, 100%);
+  --color-fd-card: hsl(0, 0%, 100%);
+  --color-fd-foreground: hsl(240, 6%, 25%);
+  --color-fd-muted-foreground: hsl(240, 6%, 50%);
+  --color-fd-secondary: hsl(240, 6%, 97%);
+  --color-fd-accent-foreground: hsl(240, 6%, 25%);
+  --color-fd-primary: hsl(226, 55%, 45%);
+}
+
+.dark {
+  --color-fd-ring: hsl(234, 100%, 83%);
+  --color-fd-primary: hsl(234, 100%, 83%);
+  --color-fd-secondary-foreground: hsl(60, 100%, 98%);
+  --color-fd-card-foreground: hsl(60, 100%, 98%);
+  --color-fd-background: hsl(240, 7%, 11%);
+  --color-fd-foreground: hsl(60, 100%, 98%);
+  --color-fd-popover: hsl(240, 7%, 11%);
+  --color-fd-popover-foreground: hsl(60, 100%, 98%);
+  --color-fd-primary-foreground: hsl(240, 7%, 11%);
+  --color-fd-card: hsl(240, 7%, 11%);
+  --color-fd-muted: hsl(0, 0%, 13%);
+  --color-fd-border: hsl(240, 4%, 19%);
+  --color-fd-accent: hsl(0, 0%, 15%);
+  --color-fd-secondary: hsl(240, 4%, 9%);
+  --color-fd-accent-foreground: hsl(0, 0%, 100%);
+  --color-fd-muted-foreground: hsl(240, 4%, 65%);
+}
+
+.prose {
+  --tw-prose-body: color-mix(
+    in oklab,
+    var(--color-fd-foreground) 85%,
+    transparent
+  );
+  --tw-prose-headings: color-mix(
+    in oklab,
+    var(--color-fd-foreground) 85%,
+    transparent
+  );
+  --tw-prose-links: var(--color-fd-primary);
+  --tw-prose-code: var(--color-fd-primary);
+}
+
+.prose :where(code):not(:where([class~='not-prose'], [class~='not-prose'] *)) {
+  border: none;
+  background-color: color-mix(
+    in oklab,
+    var(--color-fd-primary) 10%,
+    transparent
+  );
+}
+
+#nd-sidebar {
+  background-color: hsl(240, 6%, 97%);
+  border-color: transparent;
+}
+
+.dark #nd-sidebar {
+  background-color: hsl(240, 4%, 9%);
+}
+
+button[data-search-full] {
+  background-color: var(--color-fd-background);
+}

package/css/shiki.css

@@ -0,0 +1,90 @@
+.shiki:not(.not-fumadocs-codeblock *) {
+  --padding-left: calc(var(--spacing) * 4);
+  --padding-right: calc(var(--spacing) * 4);
+
+  code span {
+    color: var(--shiki-light);
+  }
+}
+
+.dark .shiki:not(.not-fumadocs-codeblock *) {
+  code span {
+    color: var(--shiki-dark);
+  }
+}
+
+:is(pre *):is(.shiki *):not(.not-fumadocs-codeblock *) {
+  .line& {
+    position: relative;
+    min-height: 1lh;
+    padding-left: var(--padding-left);
+    padding-right: var(--padding-right);
+  }
+
+  .has-focused .line&:not(.focused) {
+    filter: blur(2px);
+    transition: filter 200ms;
+  }
+
+  .has-focused:hover .line&:not(.focused) {
+    filter: blur(0);
+  }
+
+  [data-line-numbers] .twoslash-meta-line& {
+    padding-left: calc(var(--padding-left) + 7 * var(--spacing));
+  }
+
+  [data-line-numbers] .line& {
+    counter-increment: line;
+    padding-left: calc(var(--padding-left) + 7 * var(--spacing));
+  }
+
+  [data-line-numbers] .line&::after {
+    position: absolute;
+    content: counter(line);
+    color: color-mix(
+      in oklab,
+      var(--fd-counter-color, var(--color-fd-muted-foreground)) 60%,
+      transparent
+    );
+    @apply top-0 left-4;
+  }
+
+  .diff&::before {
+    position: absolute;
+    left: calc(var(--spacing) * 1.5);
+  }
+
+  .diff.remove& {
+    opacity: 0.7;
+    --fd-counter-color: var(--color-fd-diff-remove-symbol);
+    @apply bg-fd-diff-remove;
+  }
+
+  .diff.remove&::before {
+    content: '-';
+    @apply text-fd-diff-remove-symbol;
+  }
+
+  .diff.add& {
+    --fd-counter-color: var(--color-fd-diff-add-symbol);
+    @apply bg-fd-diff-add;
+  }
+
+  .diff.add&::before {
+    content: '+';
+    @apply text-fd-diff-add-symbol;
+  }
+
+  .highlighted& {
+    --fd-counter-color: var(--color-fd-primary);
+    padding-left: calc(var(--padding-left) - 2px);
+
+    @apply border-l-2 border-fd-primary/50 bg-fd-primary/10;
+  }
+
+  .highlighted-word& {
+    padding: 1px;
+    @apply border -my-px border-fd-primary/30 bg-fd-primary/10 rounded-md font-medium;
+  }
+}

package/dist/cn.d.ts

@@ -0,0 +1,2 @@
+export { twMerge as cn } from 'tailwind-merge';
+//# sourceMappingURL=cn.d.ts.map

package/dist/cn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.d.ts","sourceRoot":"","sources":["../src/cn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/cn.js

@@ -0,0 +1 @@
+export { twMerge as cn } from 'tailwind-merge';

package/dist/components/toc/clerk.d.ts

@@ -0,0 +1,3 @@
+import { type ComponentProps } from 'react';
+export declare function TOCItems({ ref, className, ...props }: ComponentProps<'div'>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=clerk.d.ts.map

package/dist/components/toc/clerk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clerk.d.ts","sourceRoot":"","sources":["../../../src/components/toc/clerk.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,cAAc,EAA+B,MAAM,OAAO,CAAC;AAMzE,wBAAgB,QAAQ,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,CAAC,KAAK,CAAC,2CAsG3E"}

package/dist/components/toc/clerk.js

@@ -0,0 +1,76 @@
+'use client';
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import * as Primitive from 'fumadocs-core/toc';
+import { useEffect, useRef, useState } from 'react';
+import { cn } from '../../cn.js';
+import { TocThumb, useTOCItems } from './index.js';
+import { mergeRefs } from '../../merge-refs.js';
+import { useI18n } from '../../contexts/i18n.js';
+export function TOCItems({ ref, className, ...props }) {
+    const containerRef = useRef(null);
+    const items = useTOCItems();
+    const { text } = useI18n();
+    const [svg, setSvg] = useState();
+    useEffect(() => {
+        if (!containerRef.current)
+            return;
+        const container = containerRef.current;
+        function onResize() {
+            if (container.clientHeight === 0)
+                return;
+            let w = 0, h = 0;
+            const d = [];
+            for (let i = 0; i < items.length; i++) {
+                const element = container.querySelector(`a[href="#${items[i].url.slice(1)}"]`);
+                if (!element)
+                    continue;
+                const styles = getComputedStyle(element);
+                const offset = getLineOffset(items[i].depth) + 1, top = element.offsetTop + parseFloat(styles.paddingTop), bottom = element.offsetTop +
+                    element.clientHeight -
+                    parseFloat(styles.paddingBottom);
+                w = Math.max(offset, w);
+                h = Math.max(h, bottom);
+                d.push(`${i === 0 ? 'M' : 'L'}${offset} ${top}`);
+                d.push(`L${offset} ${bottom}`);
+            }
+            setSvg({
+                path: d.join(' '),
+                width: w + 1,
+                height: h,
+            });
+        }
+        const observer = new ResizeObserver(onResize);
+        onResize();
+        observer.observe(container);
+        return () => {
+            observer.disconnect();
+        };
+    }, [items]);
+    if (items.length === 0)
+        return (_jsx("div", { className: "rounded-lg border bg-fd-card p-3 text-xs text-fd-muted-foreground", children: text.tocNoHeadings }));
+    return (_jsxs(_Fragment, { children: [svg && (_jsx("div", { className: "absolute start-0 top-0 rtl:-scale-x-100", style: {
+                    width: svg.width,
+                    height: svg.height,
+                    maskImage: `url("data:image/svg+xml,${
+                    // Inline SVG
+                    encodeURIComponent(`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${svg.width} ${svg.height}"><path d="${svg.path}" stroke="black" stroke-width="1" fill="none" /></svg>`)}")`,
+                }, children: _jsx(TocThumb, { containerRef: containerRef, className: "translate-y-(--fd-top) h-(--fd-height) bg-fd-primary transition-[translate,height]" }) })), _jsx("div", { ref: mergeRefs(containerRef, ref), className: cn('flex flex-col', className), ...props, children: items.map((item, i) => (_jsx(TOCItem, { item: item, upper: items[i - 1]?.depth, lower: items[i + 1]?.depth }, item.url))) })] }));
+}
+function getItemOffset(depth) {
+    if (depth <= 2)
+        return 14;
+    if (depth === 3)
+        return 26;
+    return 36;
+}
+function getLineOffset(depth) {
+    return depth >= 3 ? 10 : 0;
+}
+function TOCItem({ item, upper = item.depth, lower = item.depth, }) {
+    const offset = getLineOffset(item.depth), upperOffset = getLineOffset(upper), lowerOffset = getLineOffset(lower);
+    return (_jsxs(Primitive.TOCItem, { href: item.url, style: {
+            paddingInlineStart: getItemOffset(item.depth),
+        }, className: "prose relative py-1.5 text-sm text-fd-muted-foreground hover:text-fd-accent-foreground transition-colors wrap-anywhere first:pt-0 last:pb-0 data-[active=true]:text-fd-primary", children: [offset !== upperOffset && (_jsx("svg", { xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 16 16", className: "absolute -top-1.5 start-0 size-4 rtl:-scale-x-100", children: _jsx("line", { x1: upperOffset, y1: "0", x2: offset, y2: "12", className: "stroke-fd-foreground/10", strokeWidth: "1" }) })), _jsx("div", { className: cn('absolute inset-y-0 w-px bg-fd-foreground/10', offset !== upperOffset && 'top-1.5', offset !== lowerOffset && 'bottom-1.5'), style: {
+                    insetInlineStart: offset,
+                } }), item.title] }));
+}

package/dist/components/toc/default.d.ts

@@ -0,0 +1,3 @@
+import { type ComponentProps } from 'react';
+export declare function TOCItems({ ref, className, ...props }: ComponentProps<'div'>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=default.d.ts.map

package/dist/components/toc/default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../../src/components/toc/default.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,cAAc,EAAU,MAAM,OAAO,CAAC;AAKpD,wBAAgB,QAAQ,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,CAAC,KAAK,CAAC,2CAgC3E"}

package/dist/components/toc/default.js

@@ -0,0 +1,19 @@
+'use client';
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useI18n } from '../../contexts/i18n.js';
+import { cn } from '../../cn.js';
+import { useRef } from 'react';
+import { mergeRefs } from '../../merge-refs.js';
+import { TocThumb, useTOCItems } from './index.js';
+import * as Primitive from 'fumadocs-core/toc';
+export function TOCItems({ ref, className, ...props }) {
+    const containerRef = useRef(null);
+    const items = useTOCItems();
+    const { text } = useI18n();
+    if (items.length === 0)
+        return (_jsx("div", { className: "rounded-lg border bg-fd-card p-3 text-xs text-fd-muted-foreground", children: text.tocNoHeadings }));
+    return (_jsxs(_Fragment, { children: [_jsx(TocThumb, { containerRef: containerRef, className: "absolute top-0 translate-y-(--fd-top) h-(--fd-height) w-px bg-fd-primary transition-[translate,height]" }), _jsx("div", { ref: mergeRefs(ref, containerRef), className: cn('flex flex-col border-s border-fd-foreground/10', className), ...props, children: items.map((item) => (_jsx(TOCItem, { item: item }, item.url))) })] }));
+}
+function TOCItem({ item }) {
+    return (_jsx(Primitive.TOCItem, { href: item.url, className: cn('prose py-1.5 text-sm text-fd-muted-foreground transition-colors wrap-anywhere first:pt-0 last:pb-0 data-[active=true]:text-fd-primary', item.depth <= 2 && 'ps-3', item.depth === 3 && 'ps-6', item.depth >= 4 && 'ps-8'), children: item.title }));
+}

package/dist/components/toc/index.d.ts

@@ -0,0 +1,11 @@
+import * as Primitive from 'fumadocs-core/toc';
+import { type ComponentProps, type RefObject } from 'react';
+export declare function useTOCItems(): Primitive.TOCItemType[];
+export declare function TOCProvider({ toc, children, ...props }: ComponentProps<typeof Primitive.AnchorProvider>): import("react/jsx-runtime").JSX.Element;
+export declare function TOCScrollArea({ ref, className, ...props }: ComponentProps<'div'>): import("react/jsx-runtime").JSX.Element;
+interface RefProps {
+    containerRef: RefObject<HTMLElement | null>;
+}
+export declare function TocThumb({ containerRef, ...props }: ComponentProps<'div'> & RefProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/components/toc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/toc/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EACL,KAAK,cAAc,EAEnB,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAOf,wBAAgB,WAAW,IAAI,SAAS,CAAC,WAAW,EAAE,CAErD;AAED,wBAAgB,WAAW,CAAC,EAC1B,GAAG,EACH,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,cAAc,CAAC,OAAO,SAAS,CAAC,cAAc,CAAC,2CAQjD;AAED,wBAAgB,aAAa,CAAC,EAC5B,GAAG,EACH,SAAS,EACT,GAAG,KAAK,EACT,EAAE,cAAc,CAAC,KAAK,CAAC,2CAiBvB;AAID,UAAU,QAAQ;IAChB,YAAY,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAC7C;AAED,wBAAgB,QAAQ,CAAC,EACvB,YAAY,EACZ,GAAG,KAAK,EACT,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,QAAQ,2CA4BlC"}

package/dist/components/toc/index.js

@@ -0,0 +1,64 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import * as Primitive from 'fumadocs-core/toc';
+import { createContext, use, useEffect, useEffectEvent, useRef, } from 'react';
+import { cn } from '../../cn.js';
+import { mergeRefs } from '../../merge-refs.js';
+import { useOnChange } from 'fumadocs-core/utils/use-on-change';
+const TOCContext = createContext([]);
+export function useTOCItems() {
+    return use(TOCContext);
+}
+export function TOCProvider({ toc, children, ...props }) {
+    return (_jsx(TOCContext, { value: toc, children: _jsx(Primitive.AnchorProvider, { toc: toc, ...props, children: children }) }));
+}
+export function TOCScrollArea({ ref, className, ...props }) {
+    const viewRef = useRef(null);
+    return (_jsx("div", { ref: mergeRefs(viewRef, ref), className: cn('relative min-h-0 text-sm ms-px overflow-auto [scrollbar-width:none] mask-[linear-gradient(to_bottom,transparent,white_16px,white_calc(100%-16px),transparent)] py-3', className), ...props, children: _jsx(Primitive.ScrollProvider, { containerRef: viewRef, children: props.children }) }));
+}
+export function TocThumb({ containerRef, ...props }) {
+    const thumbRef = useRef(null);
+    const active = Primitive.useActiveAnchors();
+    const onPrint = useEffectEvent(() => {
+        if (!containerRef.current || !thumbRef.current)
+            return;
+        update(thumbRef.current, calc(containerRef.current, active));
+    });
+    useEffect(() => {
+        if (!containerRef.current)
+            return;
+        const container = containerRef.current;
+        const observer = new ResizeObserver(onPrint);
+        observer.observe(container);
+        return () => {
+            observer.disconnect();
+        };
+    }, [containerRef]);
+    useOnChange(active, () => {
+        if (containerRef.current && thumbRef.current) {
+            update(thumbRef.current, calc(containerRef.current, active));
+        }
+    });
+    return _jsx("div", { ref: thumbRef, role: "none", ...props });
+}
+function calc(container, active) {
+    if (active.length === 0 || container.clientHeight === 0) {
+        return [0, 0];
+    }
+    let upper = Number.MAX_VALUE, lower = 0;
+    for (const item of active) {
+        const element = container.querySelector(`a[href="#${item}"]`);
+        if (!element)
+            continue;
+        const styles = getComputedStyle(element);
+        upper = Math.min(upper, element.offsetTop + parseFloat(styles.paddingTop));
+        lower = Math.max(lower, element.offsetTop +
+            element.clientHeight -
+            parseFloat(styles.paddingBottom));
+    }
+    return [upper, lower - upper];
+}
+function update(element, info) {
+    element.style.setProperty('--fd-top', `${info[0]}px`);
+    element.style.setProperty('--fd-height', `${info[1]}px`);
+}

package/dist/contexts/i18n.d.ts

@@ -0,0 +1,50 @@
+import { type ReactNode } from 'react';
+export interface Translations {
+    search: string;
+    searchNoResult: string;
+    toc: string;
+    tocNoHeadings: string;
+    lastUpdate: string;
+    chooseLanguage: string;
+    nextPage: string;
+    previousPage: string;
+    chooseTheme: string;
+    editOnGithub: string;
+}
+export interface LocaleItem {
+    name: string;
+    locale: string;
+}
+interface I18nContextType {
+    locale?: string;
+    onChange?: (v: string) => void;
+    text: Translations;
+    locales?: LocaleItem[];
+}
+export declare const defaultTranslations: Translations;
+export declare function I18nLabel(props: {
+    label: keyof Translations;
+}): string;
+export declare function useI18n(): I18nContextType;
+export interface I18nProviderProps {
+    /**
+     * Current locale
+     */
+    locale: string;
+    /**
+     * Handle changes to the locale, redirect user when not specified.
+     */
+    onLocaleChange?: (v: string) => void;
+    /**
+     * Translations of current locale
+     */
+    translations?: Partial<Translations>;
+    /**
+     * Available languages
+     */
+    locales?: LocaleItem[];
+    children?: ReactNode;
+}
+export declare function I18nProvider({ locales, locale, onLocaleChange, children, translations, }: I18nProviderProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=i18n.d.ts.map

package/dist/contexts/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/contexts/i18n.tsx"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,SAAS,EAIf,MAAM,OAAO,CAAC;AAGf,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IAEvB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IAEtB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,eAAe;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,eAAO,MAAM,mBAAmB,EAAE,YAWjC,CAAC;AAMF,wBAAgB,SAAS,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,YAAY,CAAA;CAAE,GAAG,MAAM,CAItE;AAED,wBAAgB,OAAO,IAAI,eAAe,CAEzC;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAErC;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAErC;;OAEG;IACH,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IAEvB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,wBAAgB,YAAY,CAAC,EAC3B,OAAY,EACZ,MAAM,EACN,cAAc,EACd,QAAQ,EACR,YAAY,GACb,EAAE,iBAAiB,2CAuCnB"}

package/dist/contexts/i18n.js

@@ -0,0 +1,55 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo, useRef, } from 'react';
+import { usePathname, useRouter } from 'fumadocs-core/framework';
+export const defaultTranslations = {
+    search: 'Search',
+    searchNoResult: 'No results found',
+    toc: 'On this page',
+    tocNoHeadings: 'No Headings',
+    lastUpdate: 'Last updated on',
+    chooseLanguage: 'Choose a language',
+    nextPage: 'Next Page',
+    previousPage: 'Previous Page',
+    chooseTheme: 'Theme',
+    editOnGithub: 'Edit on GitHub',
+};
+const I18nContext = createContext({
+    text: defaultTranslations,
+});
+export function I18nLabel(props) {
+    const { text } = useI18n();
+    return text[props.label];
+}
+export function useI18n() {
+    return useContext(I18nContext);
+}
+export function I18nProvider({ locales = [], locale, onLocaleChange, children, translations, }) {
+    const router = useRouter();
+    const pathname = usePathname();
+    const onChange = (value) => {
+        if (onLocaleChange) {
+            return onLocaleChange(value);
+        }
+        const segments = pathname.split('/').filter((v) => v.length > 0);
+        // If locale prefix hidden
+        if (segments[0] !== locale) {
+            segments.unshift(value);
+        }
+        else {
+            segments[0] = value;
+        }
+        router.push(`/${segments.join('/')}`);
+    };
+    const onChangeRef = useRef(onChange);
+    onChangeRef.current = onChange;
+    return (_jsx(I18nContext, { value: useMemo(() => ({
+            locale,
+            locales,
+            text: {
+                ...defaultTranslations,
+                ...translations,
+            },
+            onChange: (v) => onChangeRef.current(v),
+        }), [locale, locales, translations]), children: children }));
+}

package/dist/contexts/search.d.ts

@@ -0,0 +1,61 @@
+import { type ComponentType, type ReactNode } from 'react';
+interface HotKey {
+    display: ReactNode;
+    /**
+     * Key code or a function determining whether the key is pressed.
+     */
+    key: string | ((e: KeyboardEvent) => boolean);
+}
+export interface SharedProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+}
+export type SearchLink = [name: string, href: string];
+export interface TagItem {
+    name: string;
+    value: string;
+}
+export interface SearchProviderProps {
+    /**
+     * Preload search dialog before opening it
+     *
+     * @defaultValue `true`
+     */
+    preload?: boolean;
+    /**
+     * Custom links to be displayed if search is empty
+     */
+    links?: SearchLink[];
+    /**
+     * Hotkeys for triggering search dialog
+     *
+     * @defaultValue Meta/Ctrl + K
+     */
+    hotKey?: HotKey[];
+    /**
+     * Replace default search dialog, allowing you to use other solutions such as Algolia Search
+     *
+     * It receives the `open` and `onOpenChange` prop, can be lazy loaded with `next/dynamic`
+     */
+    SearchDialog: ComponentType<SharedProps>;
+    /**
+     * Additional props to the dialog
+     */
+    options?: Partial<SharedProps & Record<string, unknown>>;
+    children?: ReactNode;
+}
+interface SearchContextType {
+    enabled: boolean;
+    hotKey: HotKey[];
+    setOpenSearch: (value: boolean) => void;
+}
+export declare function useSearchContext(): SearchContextType;
+export declare function SearchProvider({ SearchDialog, children, preload, options, hotKey, links, }: SearchProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Show children only when search is enabled via React Context
+ */
+export declare function SearchOnly({ children }: {
+    children: ReactNode;
+}): ReactNode;
+export {};
+//# sourceMappingURL=search.d.ts.map

package/dist/contexts/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/contexts/search.tsx"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AAEf,UAAU,MAAM;IACd,OAAO,EAAE,SAAS,CAAC;IAEnB;;OAEG;IACH,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACvC;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAEtD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IAErB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB;;;;OAIG;IACH,YAAY,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IAEzC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAEzD,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,UAAU,iBAAiB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACzC;AAQD,wBAAgB,gBAAgB,IAAI,iBAAiB,CAEpD;AAcD,wBAAgB,cAAc,CAAC,EAC7B,YAAY,EACZ,QAAQ,EACR,OAAc,EACd,OAAO,EACP,MASC,EACD,KAAK,GACN,EAAE,mBAAmB,2CA2CrB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,aAI/D"}

package/dist/contexts/search.js

@@ -0,0 +1,59 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { createContext, use, useEffect, useEffectEvent, useMemo, useState, } from 'react';
+const SearchContext = createContext({
+    enabled: false,
+    hotKey: [],
+    setOpenSearch: () => undefined,
+});
+export function useSearchContext() {
+    return use(SearchContext);
+}
+function MetaOrControl() {
+    const [key, setKey] = useState('⌘');
+    useEffect(() => {
+        const isWindows = window.navigator.userAgent.includes('Windows');
+        if (isWindows)
+            setKey('Ctrl');
+    }, []);
+    return key;
+}
+export function SearchProvider({ SearchDialog, children, preload = true, options, hotKey = [
+    {
+        key: (e) => e.metaKey || e.ctrlKey,
+        display: _jsx(MetaOrControl, {}),
+    },
+    {
+        key: 'k',
+        display: 'K',
+    },
+], links, }) {
+    const [isOpen, setIsOpen] = useState(preload ? false : undefined);
+    const onKeyDown = useEffectEvent((e) => {
+        if (hotKey.every((v) => typeof v.key === 'string' ? e.key === v.key : v.key(e))) {
+            setIsOpen((open) => !open);
+            e.preventDefault();
+        }
+    });
+    useEffect(() => {
+        window.addEventListener('keydown', onKeyDown);
+        return () => {
+            window.removeEventListener('keydown', onKeyDown);
+        };
+    }, [hotKey]);
+    return (_jsxs(SearchContext, { value: useMemo(() => ({
+            enabled: true,
+            hotKey,
+            setOpenSearch: setIsOpen,
+        }), [hotKey]), children: [isOpen !== undefined && (_jsx(SearchDialog, { open: isOpen, onOpenChange: setIsOpen, 
+                // @ts-expect-error -- insert prop for official UIs
+                links: links, ...options })), children] }));
+}
+/**
+ * Show children only when search is enabled via React Context
+ */
+export function SearchOnly({ children }) {
+    const search = useSearchContext();
+    if (search.enabled)
+        return children;
+}

package/dist/contexts/tree.d.ts

@@ -0,0 +1,15 @@
+import type * as PageTree from 'fumadocs-core/page-tree';
+import { type ReactNode } from 'react';
+type MakeRequired<O, K extends keyof O> = Omit<O, K> & Pick<Required<O>, K>;
+interface TreeContextType {
+    root: MakeRequired<PageTree.Root | PageTree.Folder, '$id'>;
+    full: PageTree.Root;
+}
+export declare function TreeContextProvider({ tree: rawTree, children, }: {
+    tree: PageTree.Root;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useTreePath(): PageTree.Node[];
+export declare function useTreeContext(): TreeContextType;
+export {};
+//# sourceMappingURL=tree.d.ts.map

package/dist/contexts/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../src/contexts/tree.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,QAAQ,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,KAAK,SAAS,EAAuC,MAAM,OAAO,CAAC;AAG5E,KAAK,YAAY,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAE5E,UAAU,eAAe;IACvB,IAAI,EAAE,YAAY,CAAC,QAAQ,CAAC,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3D,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;CACrB;AAKD,wBAAgB,mBAAmB,CAAC,EAClC,IAAI,EAAE,OAAO,EACb,QAAQ,GACT,EAAE;IACD,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;CACrB,2CA8BA;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAAC,IAAI,EAAE,CAE7C;AAED,wBAAgB,cAAc,IAAI,eAAe,CAMhD"}

package/dist/contexts/tree.js

@@ -0,0 +1,32 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { usePathname } from 'fumadocs-core/framework';
+import { useMemo, useRef, createContext, use } from 'react';
+import { searchPath } from 'fumadocs-core/breadcrumb';
+const TreeContext = createContext(null);
+const PathContext = createContext([]);
+export function TreeContextProvider({ tree: rawTree, children, }) {
+    const nextIdRef = useRef(0);
+    const pathname = usePathname();
+    // I found that object-typed props passed from a RSC will be re-constructed, hence breaking all hooks' dependencies
+    // using the id here to make sure this never happens
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    const tree = useMemo(() => rawTree, [rawTree.$id ?? rawTree]);
+    const path = useMemo(() => {
+        return (searchPath(tree.children, pathname) ??
+            (tree.fallback ? searchPath(tree.fallback.children, pathname) : null) ??
+            []);
+    }, [tree, pathname]);
+    const root = path.findLast((item) => item.type === 'folder' && item.root) ?? tree;
+    root.$id ?? (root.$id = String(nextIdRef.current++));
+    return (_jsx(TreeContext, { value: useMemo(() => ({ root, full: tree }), [root, tree]), children: _jsx(PathContext, { value: path, children: children }) }));
+}
+export function useTreePath() {
+    return use(PathContext);
+}
+export function useTreeContext() {
+    const ctx = use(TreeContext);
+    if (!ctx)
+        throw new Error('You must wrap this component under <DocsLayout />');
+    return ctx;
+}