@hanzo/docs-base-ui 16.5.0 → 16.7.5

package/dist/components/ui/popover.d.ts

@@ -1,12 +1,17 @@
-import * as React from "react";
+import * as React$1 from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
 import { Popover as Popover$1 } from "@base-ui/react/popover";
-import * as _base_ui_react3 from "@base-ui/react";
+import * as _base_ui_react0 from "@base-ui/react";
 
 //#region src/components/ui/popover.d.ts
 declare const Popover: typeof Popover$1.Root;
 declare const PopoverTrigger: Popover$1.Trigger;
-declare const PopoverContent: React.ForwardRefExoticComponent<Omit<_base_ui_react3.PopoverPopupProps & React.RefAttributes<HTMLDivElement>, "ref"> & Pick<_base_ui_react3.PopoverPositionerProps, "sideOffset" | "align"> & React.RefAttributes<HTMLDivElement>>;
-declare const PopoverClose: React.ForwardRefExoticComponent<_base_ui_react3.PopoverCloseProps & React.RefAttributes<HTMLButtonElement>>;
+declare function PopoverContent({
+  className,
+  align,
+  sideOffset,
+  ...props
+}: React$1.ComponentPropsWithRef<typeof Popover$1.Popup> & Pick<Popover$1.Positioner.Props, 'sideOffset' | 'align'>): react_jsx_runtime0.JSX.Element;
+declare const PopoverClose: React$1.ForwardRefExoticComponent<Omit<_base_ui_react0.PopoverCloseProps, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
 //#endregion
-export { Popover, PopoverClose, PopoverContent, PopoverTrigger };
-//# sourceMappingURL=popover.d.ts.map
+export { Popover, PopoverClose, PopoverContent, PopoverTrigger };

package/dist/components/ui/popover.js

@@ -1,27 +1,23 @@
-'use client';
-
-import { cn } from "@hanzo/docs-ui/cn";
+"use client";
+import { cn } from "../../utils/cn.js";
+import "react";
 import { jsx } from "react/jsx-runtime";
-import * as React from "react";
 import { Popover as Popover$1 } from "@base-ui/react/popover";
-
 //#region src/components/ui/popover.tsx
 const Popover = Popover$1.Root;
 const PopoverTrigger = Popover$1.Trigger;
-const PopoverContent = React.forwardRef(({ className, align = "center", sideOffset = 4, ...props }, ref) => /* @__PURE__ */ jsx(Popover$1.Portal, { children: /* @__PURE__ */ jsx(Popover$1.Positioner, {
-	align,
-	side: "bottom",
-	sideOffset,
-	className: "z-50",
-	children: /* @__PURE__ */ jsx(Popover$1.Popup, {
-		ref,
-		className: (s) => cn("z-50 origin-(--transform-origin) overflow-y-auto max-h-(--available-height) min-w-[240px] max-w-[98vw] rounded-xl border bg-fd-popover/60 backdrop-blur-lg p-2 text-sm text-fd-popover-foreground shadow-lg focus-visible:outline-none data-[closed]:animate-fd-popover-out data-[open]:animate-fd-popover-in", typeof className === "function" ? className(s) : className),
-		...props
-	})
-}) }));
-PopoverContent.displayName = Popover$1.Popup.displayName;
+function PopoverContent({ className, align = "center", sideOffset = 4, ...props }) {
+	return /* @__PURE__ */ jsx(Popover$1.Portal, { children: /* @__PURE__ */ jsx(Popover$1.Positioner, {
+		align,
+		side: "bottom",
+		sideOffset,
+		className: "z-50",
+		children: /* @__PURE__ */ jsx(Popover$1.Popup, {
+			className: (s) => cn("z-50 origin-(--transform-origin) overflow-y-auto max-h-(--available-height) min-w-[240px] max-w-[98vw] rounded-xl border bg-fd-popover/60 backdrop-blur-lg p-2 text-sm text-fd-popover-foreground shadow-lg focus-visible:outline-none data-[closed]:animate-fd-popover-out data-[open]:animate-fd-popover-in", typeof className === "function" ? className(s) : className),
+			...props
+		})
+	}) });
+}
 const PopoverClose = Popover$1.Close;
-
 //#endregion
 export { Popover, PopoverClose, PopoverContent, PopoverTrigger };
-//# sourceMappingURL=popover.js.map

package/dist/components/ui/scroll-area.d.ts

@@ -1,12 +1,22 @@
-import * as React from "react";
+import * as React$1 from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
 import { ScrollArea as ScrollArea$1 } from "@base-ui/react/scroll-area";
-import * as _base_ui_react13 from "@base-ui/react";
 
 //#region src/components/ui/scroll-area.d.ts
-declare const ScrollArea: React.ForwardRefExoticComponent<Omit<_base_ui_react13.ScrollAreaRootProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const ScrollViewport: React.ForwardRefExoticComponent<Omit<_base_ui_react13.ScrollAreaViewportProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const ScrollBar: React.ForwardRefExoticComponent<Omit<_base_ui_react13.ScrollAreaScrollbarProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare function ScrollArea({
+  children,
+  ...props
+}: React$1.ComponentPropsWithRef<typeof ScrollArea$1.Root>): react_jsx_runtime0.JSX.Element;
+declare function ScrollViewport({
+  className,
+  children,
+  ...props
+}: React$1.ComponentPropsWithRef<typeof ScrollArea$1.Viewport>): react_jsx_runtime0.JSX.Element;
+declare function ScrollBar({
+  className,
+  orientation,
+  ...props
+}: React$1.ComponentPropsWithRef<typeof ScrollArea$1.Scrollbar>): react_jsx_runtime0.JSX.Element;
 type ScrollAreaProps = ScrollArea$1.Root.Props;
 //#endregion
-export { ScrollArea, ScrollAreaProps, ScrollBar, ScrollViewport };
-//# sourceMappingURL=scroll-area.d.ts.map
+export { ScrollArea, ScrollAreaProps, ScrollBar, ScrollViewport };

package/dist/components/ui/scroll-area.js

@@ -1,36 +1,32 @@
-import { cn } from "@hanzo/docs-ui/cn";
+import { cn } from "../../utils/cn.js";
+import "react";
 import { jsx, jsxs } from "react/jsx-runtime";
-import * as React from "react";
 import { ScrollArea as ScrollArea$1 } from "@base-ui/react/scroll-area";
-
 //#region src/components/ui/scroll-area.tsx
-const ScrollArea = React.forwardRef(({ className, children, ...props }, ref) => /* @__PURE__ */ jsxs(ScrollArea$1.Root, {
-	ref,
-	className: (s) => cn("overflow-hidden", typeof className === "function" ? className(s) : className),
-	...props,
-	children: [
-		children,
-		/* @__PURE__ */ jsx(ScrollArea$1.Corner, {}),
-		/* @__PURE__ */ jsx(ScrollBar, { orientation: "vertical" })
-	]
-}));
-ScrollArea.displayName = ScrollArea$1.Root.displayName;
-const ScrollViewport = React.forwardRef(({ className, children, ...props }, ref) => /* @__PURE__ */ jsx(ScrollArea$1.Viewport, {
-	ref,
-	className: (s) => cn("size-full rounded-[inherit]", typeof className === "function" ? className(s) : className),
-	...props,
-	children
-}));
-ScrollViewport.displayName = ScrollArea$1.Viewport.displayName;
-const ScrollBar = React.forwardRef(({ className, orientation = "vertical", ...props }, ref) => /* @__PURE__ */ jsx(ScrollArea$1.Scrollbar, {
-	ref,
-	orientation,
-	className: (s) => cn("flex select-none transition-opacity", !s.hovering && "opacity-0", orientation === "vertical" && "h-full w-1.5", orientation === "horizontal" && "h-1.5 flex-col", typeof className === "function" ? className(s) : className),
-	...props,
-	children: /* @__PURE__ */ jsx(ScrollArea$1.Thumb, { className: "relative flex-1 rounded-full bg-fd-border" })
-}));
-ScrollBar.displayName = ScrollArea$1.Scrollbar.displayName;
-
+function ScrollArea({ children, ...props }) {
+	return /* @__PURE__ */ jsxs(ScrollArea$1.Root, {
+		...props,
+		children: [
+			children,
+			/* @__PURE__ */ jsx(ScrollArea$1.Corner, {}),
+			/* @__PURE__ */ jsx(ScrollBar, { orientation: "vertical" })
+		]
+	});
+}
+function ScrollViewport({ className, children, ...props }) {
+	return /* @__PURE__ */ jsx(ScrollArea$1.Viewport, {
+		className: (s) => cn("size-full rounded-[inherit]", typeof className === "function" ? className(s) : className),
+		...props,
+		children
+	});
+}
+function ScrollBar({ className, orientation = "vertical", ...props }) {
+	return /* @__PURE__ */ jsx(ScrollArea$1.Scrollbar, {
+		orientation,
+		className: (s) => cn("flex select-none transition-opacity", !s.hovering && "opacity-0", orientation === "vertical" && "h-full w-1.5", orientation === "horizontal" && "h-1.5 flex-col", typeof className === "function" ? className(s) : className),
+		...props,
+		children: /* @__PURE__ */ jsx(ScrollArea$1.Thumb, { className: "relative flex-1 rounded-full bg-fd-border" })
+	});
+}
 //#endregion
 export { ScrollArea, ScrollBar, ScrollViewport };
-//# sourceMappingURL=scroll-area.js.map

package/dist/components/ui/tabs.d.ts

@@ -1,8 +1,8 @@
-import * as react_jsx_runtime18 from "react/jsx-runtime";
-import * as react3 from "react";
+import * as react from "react";
 import { ComponentProps } from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
 import { Tabs as Tabs$1 } from "@base-ui/react/tabs";
-import * as _base_ui_react1 from "@base-ui/react";
+import * as _base_ui_react0 from "@base-ui/react";
 
 //#region src/components/ui/tabs.d.ts
 interface TabsProps extends ComponentProps<typeof Tabs$1.Root> {
@@ -20,8 +20,8 @@ interface TabsProps extends ComponentProps<typeof Tabs$1.Root> {
   updateAnchor?: boolean;
   onValueChange?: (value: string) => void;
 }
-declare const TabsList: react3.ForwardRefExoticComponent<_base_ui_react1.TabsListProps & react3.RefAttributes<HTMLDivElement>>;
-declare const TabsTrigger: react3.ForwardRefExoticComponent<_base_ui_react1.TabsTabProps & react3.RefAttributes<Element>>;
+declare const TabsList: react.ForwardRefExoticComponent<Omit<_base_ui_react0.TabsListProps, "ref"> & react.RefAttributes<HTMLDivElement>>;
+declare const TabsTrigger: react.ForwardRefExoticComponent<Omit<_base_ui_react0.TabsTabProps, "ref"> & react.RefAttributes<HTMLElement>>;
 declare function Tabs({
   ref,
   groupId,
@@ -31,11 +31,10 @@ declare function Tabs({
   value: _value,
   onValueChange: _onValueChange,
   ...props
-}: TabsProps): react_jsx_runtime18.JSX.Element;
+}: TabsProps): react_jsx_runtime0.JSX.Element;
 declare function TabsContent({
   value,
   ...props
-}: ComponentProps<typeof Tabs$1.Panel>): react_jsx_runtime18.JSX.Element;
+}: ComponentProps<typeof Tabs$1.Panel>): react_jsx_runtime0.JSX.Element;
 //#endregion
-export { Tabs, TabsContent, TabsList, TabsProps, TabsTrigger };
-//# sourceMappingURL=tabs.d.ts.map
+export { Tabs, TabsContent, TabsList, TabsProps, TabsTrigger };

package/dist/components/ui/tabs.js

@@ -1,10 +1,8 @@
-'use client';
-
-import { jsx } from "react/jsx-runtime";
+"use client";
+import { mergeRefs } from "../../utils/merge-refs.js";
 import { createContext, use, useEffectEvent, useLayoutEffect, useMemo, useRef, useState } from "react";
+import { jsx } from "react/jsx-runtime";
 import { Tabs as Tabs$1 } from "@base-ui/react/tabs";
-import { mergeRefs } from "@hanzo/docs-ui/merge-refs";
-
 //#region src/components/ui/tabs.tsx
 const listeners = /* @__PURE__ */ new Map();
 const TabsContext = createContext(null);
@@ -38,8 +36,8 @@ function Tabs({ ref, groupId, persist = false, updateAnchor = false, defaultValu
 	useLayoutEffect(() => {
 		const hash = window.location.hash.slice(1);
 		if (!hash) return;
-		for (const [value$1, id] of valueToIdMap.entries()) if (id === hash) {
-			setValue(value$1);
+		for (const [value, id] of valueToIdMap.entries()) if (id === hash) {
+			setValue(value);
 			tabsRef.current?.scrollIntoView();
 			break;
 		}
@@ -75,7 +73,5 @@ function TabsContent({ value, ...props }) {
 		children: props.children
 	});
 }
-
 //#endregion
 export { Tabs, TabsContent, TabsList, TabsTrigger };
-//# sourceMappingURL=tabs.js.map

package/dist/contexts/i18n.d.ts

@@ -1 +1,62 @@
-export * from "@hanzo/docs-ui/contexts/i18n";
+import { ReactNode } from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/contexts/i18n.d.ts
+interface Translations {
+  search: string;
+  searchNoResult: string;
+  toc: string;
+  tocNoHeadings: string;
+  lastUpdate: string;
+  chooseLanguage: string;
+  nextPage: string;
+  previousPage: string;
+  chooseTheme: string;
+  editOnGithub: string;
+}
+type TranslationsOption = {
+  [key: string]: string | TranslationsOption;
+};
+interface LocaleItem {
+  name: string;
+  locale: string;
+}
+interface I18nContextType {
+  text: Translations & TranslationsOption;
+  locale?: string;
+  onChange?: (v: string) => void;
+  locales?: LocaleItem[];
+}
+declare const defaultTranslations: Translations;
+declare function I18nLabel(props: {
+  label: keyof Translations;
+}): string;
+declare function useI18n(): I18nContextType;
+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?: TranslationsOption;
+  /**
+   * Available languages
+   */
+  locales?: LocaleItem[];
+  children?: ReactNode;
+}
+declare function I18nProvider({
+  locales,
+  locale,
+  onLocaleChange,
+  children,
+  translations
+}: I18nProviderProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { I18nLabel, I18nProvider, I18nProviderProps, Translations, TranslationsOption, defaultTranslations, useI18n };

package/dist/contexts/i18n.js

@@ -1,12 +1,55 @@
-import { __reExport } from "../_virtual/rolldown_runtime.js";
-
-export * from "@hanzo/docs-ui/contexts/i18n"
-
+"use client";
+import { createContext, useContext, useMemo, useRef } from "react";
+import { usePathname, useRouter } from "@hanzo/docs-core/framework";
+import { jsx } from "react/jsx-runtime";
 //#region src/contexts/i18n.tsx
-var i18n_exports = {};
-import * as import__hanzo_docs_ui_contexts_i18n from "@hanzo/docs-ui/contexts/i18n";
-__reExport(i18n_exports, import__hanzo_docs_ui_contexts_i18n);
-
+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 } });
+function I18nLabel(props) {
+	return useI18n().text[props.label];
+}
+function useI18n() {
+	return useContext(I18nContext);
+}
+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 (segments[0] !== locale) segments.unshift(value);
+		else segments[0] = value;
+		router.push(`/${segments.join("/")}`);
+	};
+	const onChangeRef = useRef(onChange);
+	onChangeRef.current = onChange;
+	return /* @__PURE__ */ jsx(I18nContext, {
+		value: useMemo(() => ({
+			locale,
+			locales,
+			text: {
+				...defaultTranslations,
+				...translations
+			},
+			onChange: (v) => onChangeRef.current(v)
+		}), [
+			locale,
+			locales,
+			translations
+		]),
+		children
+	});
+}
 //#endregion
-export { i18n_exports };
-//# sourceMappingURL=i18n.js.map
+export { I18nLabel, I18nProvider, defaultTranslations, useI18n };

package/dist/contexts/search.d.ts

@@ -1,8 +1,74 @@
-export * from "@hanzo/docs-ui/contexts/search";
+import { ComponentType, ReactNode } from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/contexts/search.d.ts
-
-import * as import__hanzo_docs_ui_contexts_search from "@hanzo/docs-ui/contexts/search";
+interface HotKey {
+  display: ReactNode;
+  /**
+   * Key code or a function determining whether the key is pressed.
+   */
+  key: string | ((e: KeyboardEvent) => boolean);
+}
+interface SharedProps {
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+}
+type SearchLink = [name: string, href: string];
+interface TagItem {
+  name: string;
+  value: string;
+}
+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;
+  open: boolean;
+  hotKey: HotKey[];
+  setOpenSearch: (value: boolean) => void;
+}
+declare function useSearchContext(): SearchContextType;
+declare function SearchProvider({
+  SearchDialog,
+  children,
+  preload,
+  options,
+  hotKey,
+  links
+}: SearchProviderProps): react_jsx_runtime0.JSX.Element;
+/**
+ * Show children only when search is enabled via React Context
+ */
+declare function SearchOnly({
+  children
+}: {
+  children: ReactNode;
+}): ReactNode;
 //#endregion
-export { import__hanzo_docs_ui_contexts_search as search_d_exports };
-//# sourceMappingURL=search.d.ts.map
+export { SearchLink, SearchOnly, SearchProvider, SearchProviderProps, SharedProps, TagItem, useSearchContext };

package/dist/contexts/search.js

@@ -1,12 +1,66 @@
-import { __reExport } from "../_virtual/rolldown_runtime.js";
-
-export * from "@hanzo/docs-ui/contexts/search"
-
+"use client";
+import { Suspense, createContext, use, useEffect, useEffectEvent, useMemo, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/contexts/search.tsx
-var search_exports = {};
-import * as import__hanzo_docs_ui_contexts_search from "@hanzo/docs-ui/contexts/search";
-__reExport(search_exports, import__hanzo_docs_ui_contexts_search);
-
+const SearchContext = createContext({
+	enabled: false,
+	open: false,
+	hotKey: [],
+	setOpenSearch: () => void 0
+});
+function useSearchContext() {
+	return use(SearchContext);
+}
+function MetaOrControl() {
+	const [key, setKey] = useState("⌘");
+	useEffect(() => {
+		if (window.navigator.userAgent.includes("Windows")) setKey("Ctrl");
+	}, []);
+	return key;
+}
+function SearchProvider({ SearchDialog, children, preload = true, options, hotKey = [{
+	key: (e) => e.metaKey || e.ctrlKey,
+	display: /* @__PURE__ */ jsx(MetaOrControl, {})
+}, {
+	key: "k",
+	display: "K"
+}], links }) {
+	const [isOpen, setIsOpen] = useState(preload ? false : void 0);
+	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 /* @__PURE__ */ jsxs(SearchContext, {
+		value: useMemo(() => ({
+			enabled: true,
+			open: isOpen ?? false,
+			hotKey,
+			setOpenSearch: setIsOpen
+		}), [isOpen, hotKey]),
+		children: [isOpen !== void 0 && /* @__PURE__ */ jsx(Suspense, {
+			fallback: null,
+			children: /* @__PURE__ */ jsx(SearchDialog, {
+				open: isOpen,
+				onOpenChange: setIsOpen,
+				links,
+				...options
+			})
+		}), children]
+	});
+}
+/**
+* Show children only when search is enabled via React Context
+*/
+function SearchOnly({ children }) {
+	if (useSearchContext().enabled) return children;
+}
 //#endregion
-export { search_exports };
-//# sourceMappingURL=search.js.map
+export { SearchOnly, SearchProvider, useSearchContext };

package/dist/contexts/tree.d.ts

@@ -1 +1,21 @@
-export * from "@hanzo/docs-ui/contexts/tree";
+import { ReactNode } from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+import * as PageTree from "@hanzo/docs-core/page-tree";
+
+//#region src/contexts/tree.d.ts
+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;
+}
+declare function TreeContextProvider({
+  tree: rawTree,
+  children
+}: {
+  tree: PageTree.Root;
+  children: ReactNode;
+}): react_jsx_runtime0.JSX.Element;
+declare function useTreePath(): PageTree.Node[];
+declare function useTreeContext(): TreeContextType;
+//#endregion
+export { TreeContextProvider, useTreeContext, useTreePath };

package/dist/contexts/tree.js

@@ -1,12 +1,38 @@
-import { __reExport } from "../_virtual/rolldown_runtime.js";
-
-export * from "@hanzo/docs-ui/contexts/tree"
-
+"use client";
+import { createContext, use, useMemo, useRef } from "react";
+import { usePathname } from "@hanzo/docs-core/framework";
+import { jsx } from "react/jsx-runtime";
+import { searchPath } from "@hanzo/docs-core/breadcrumb";
 //#region src/contexts/tree.tsx
-var tree_exports = {};
-import * as import__hanzo_docs_ui_contexts_tree from "@hanzo/docs-ui/contexts/tree";
-__reExport(tree_exports, import__hanzo_docs_ui_contexts_tree);
-
+const TreeContext = createContext(null);
+const PathContext = createContext([]);
+function TreeContextProvider({ tree: rawTree, children }) {
+	const nextIdRef = useRef(0);
+	const pathname = usePathname();
+	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 ??= String(nextIdRef.current++);
+	return /* @__PURE__ */ jsx(TreeContext, {
+		value: useMemo(() => ({
+			root,
+			full: tree
+		}), [root, tree]),
+		children: /* @__PURE__ */ jsx(PathContext, {
+			value: path,
+			children
+		})
+	});
+}
+function useTreePath() {
+	return use(PathContext);
+}
+function useTreeContext() {
+	const ctx = use(TreeContext);
+	if (!ctx) throw new Error("You must wrap this component under <DocsLayout />");
+	return ctx;
+}
 //#endregion
-export { tree_exports };
-//# sourceMappingURL=tree.js.map
+export { TreeContextProvider, useTreeContext, useTreePath };

package/dist/i18n.d.ts

@@ -1 +1,21 @@
-export * from "@hanzo/docs-ui/i18n";
+import { I18nProviderProps, Translations, defaultTranslations } from "./contexts/i18n.js";
+import { I18nConfig } from "@hanzo/docs-core/i18n";
+
+//#region src/i18n.d.ts
+interface I18nUIConfig<Languages extends string> extends I18nConfig<Languages> {
+  /**
+   * get i18n config for Fumadocs UI `<RootProvider i18n={config} />`.
+   */
+  provider: (locale?: Languages | (string & {})) => I18nProviderProps;
+}
+type TranslationsConfig<Languages extends string> = { [K in Languages]?: Partial<Translations> & {
+  displayName?: string;
+} };
+declare function defineI18nUI<Languages extends string>(config: I18nConfig<Languages>, options?: {
+  /**
+   * @deprecated you can directly define the translations in outer scope (the parent object of `translations`)
+   */
+  translations: TranslationsConfig<Languages>;
+} | TranslationsConfig<Languages>): I18nUIConfig<Languages>;
+//#endregion
+export { type I18nProviderProps, I18nUIConfig, type Translations, defaultTranslations, defineI18nUI };

package/dist/i18n.js

@@ -1,3 +1,20 @@
-export * from "@hanzo/docs-ui/i18n"
-
-export {  };
+import { defaultTranslations } from "./contexts/i18n.js";
+//#region src/i18n.tsx
+function defineI18nUI(config, options = {}) {
+	const translations = "translations" in options ? options.translations : options;
+	return {
+		...config,
+		provider(locale = config.defaultLanguage) {
+			return {
+				locale,
+				translations: translations[locale],
+				locales: config.languages.map((locale) => ({
+					locale,
+					name: translations[locale]?.displayName ?? locale
+				}))
+			};
+		}
+	};
+}
+//#endregion
+export { defaultTranslations, defineI18nUI };