boltdocs 1.7.0 → 1.7.1

package/dist/client/index.js

@@ -839,8 +839,29 @@ var init_GithubStars = __esm({
 // src/client/theme/ui/Navbar/Tabs.tsx
 function Tabs({ tabs, routes }) {
   const location = (0, import_react_router_dom4.useLocation)();
+  const containerRef = (0, import_react8.useRef)(null);
+  const tabRefs = (0, import_react8.useRef)([]);
+  const [indicatorStyle, setIndicatorStyle] = (0, import_react8.useState)({
+    opacity: 0,
+    transform: "translateX(0) scaleX(0)",
+    width: 0
+  });
   const currentRoute = routes.find((r) => r.path === location.pathname);
   const currentTabId = currentRoute?.tab?.toLowerCase();
+  const activeIndex = tabs.findIndex(
+    (tab) => currentTabId ? currentTabId === tab.id.toLowerCase() : false
+  );
+  const finalActiveIndex = activeIndex === -1 ? 0 : activeIndex;
+  (0, import_react8.useEffect)(() => {
+    const activeTab = tabRefs.current[finalActiveIndex];
+    if (activeTab) {
+      setIndicatorStyle({
+        opacity: 1,
+        width: activeTab.offsetWidth,
+        transform: `translateX(${activeTab.offsetLeft}px)`
+      });
+    }
+  }, [finalActiveIndex, tabs, location.pathname]);
   if (!tabs || tabs.length === 0) return null;
   const renderTabIcon = (iconName) => {
     if (!iconName) return null;
@@ -859,28 +880,37 @@ function Tabs({ tabs, routes }) {
     }
     return /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("img", { src: iconName, alt: "", className: "tab-icon img-icon" });
   };
-  return /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("div", { className: "boltdocs-tabs-container", children: /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("div", { className: "boltdocs-tabs", children: tabs.map((tab, index) => {
-    const isActive = currentTabId ? currentTabId === tab.id.toLowerCase() : index === 0;
-    const firstRoute = routes.find((r) => r.tab && r.tab.toLowerCase() === tab.id.toLowerCase());
-    const linkTo = firstRoute ? firstRoute.path : "#";
-    return /* @__PURE__ */ (0, import_jsx_runtime11.jsxs)(
-      Link,
-      {
-        to: linkTo,
-        className: `boltdocs-tab-item ${isActive ? "active" : ""}`,
-        children: [
-          renderTabIcon(tab.icon),
-          /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("span", { children: tab.text })
-        ]
-      },
-      tab.id
-    );
-  }) }) });
+  return /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("div", { className: "boltdocs-tabs-container", children: /* @__PURE__ */ (0, import_jsx_runtime11.jsxs)("div", { className: "boltdocs-tabs", ref: containerRef, children: [
+    tabs.map((tab, index) => {
+      const isActive = index === finalActiveIndex;
+      const firstRoute = routes.find(
+        (r) => r.tab && r.tab.toLowerCase() === tab.id.toLowerCase()
+      );
+      const linkTo = firstRoute ? firstRoute.path : "#";
+      return /* @__PURE__ */ (0, import_jsx_runtime11.jsxs)(
+        Link,
+        {
+          to: linkTo,
+          ref: (el) => {
+            tabRefs.current[index] = el;
+          },
+          className: `boltdocs-tab-item ${isActive ? "active" : ""}`,
+          children: [
+            renderTabIcon(tab.icon),
+            /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("span", { children: tab.text })
+          ]
+        },
+        tab.id
+      );
+    }),
+    /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("div", { className: "boltdocs-tab-indicator", style: indicatorStyle })
+  ] }) });
 }
-var import_react_router_dom4, Icons, import_jsx_runtime11;
+var import_react8, import_react_router_dom4, Icons, import_jsx_runtime11;
 var init_Tabs = __esm({
   "src/client/theme/ui/Navbar/Tabs.tsx"() {
     "use strict";
+    import_react8 = require("react");
     import_react_router_dom4 = require("react-router-dom");
     init_Link2();
     Icons = __toESM(require("lucide-react"));
@@ -890,10 +920,10 @@ var init_Tabs = __esm({
 
 // src/client/theme/ui/SearchDialog/SearchDialog.tsx
 function SearchDialog({ routes }) {
-  const [isOpen, setIsOpen] = (0, import_react8.useState)(false);
-  const [query, setQuery] = (0, import_react8.useState)("");
-  const inputRef = (0, import_react8.useRef)(null);
-  (0, import_react8.useEffect)(() => {
+  const [isOpen, setIsOpen] = (0, import_react9.useState)(false);
+  const [query, setQuery] = (0, import_react9.useState)("");
+  const inputRef = (0, import_react9.useRef)(null);
+  (0, import_react9.useEffect)(() => {
     const handleKeyDown = (e) => {
       if ((e.metaKey || e.ctrlKey) && e.key === "k") {
         e.preventDefault();
@@ -906,14 +936,14 @@ function SearchDialog({ routes }) {
     window.addEventListener("keydown", handleKeyDown);
     return () => window.removeEventListener("keydown", handleKeyDown);
   }, [isOpen]);
-  (0, import_react8.useEffect)(() => {
+  (0, import_react9.useEffect)(() => {
     if (isOpen) {
       setTimeout(() => inputRef.current?.focus(), 50);
     } else {
       setQuery("");
     }
   }, [isOpen]);
-  const searchResults = import_react8.default.useMemo(() => {
+  const searchResults = import_react9.default.useMemo(() => {
     if (!query) {
       return routes.slice(0, 10).map((r) => ({
         title: r.title,
@@ -943,6 +973,13 @@ function SearchDialog({ routes }) {
           }
         }
       }
+      if (route._content && route._content.toLowerCase().includes(lowerQuery)) {
+        results.push({
+          title: route.title,
+          path: route.path,
+          groupTitle: route.groupTitle
+        });
+      }
     }
     const uniqueResults = [];
     const seenPaths = /* @__PURE__ */ new Set();
@@ -1063,11 +1100,11 @@ function SearchDialog({ routes }) {
     )
   ] });
 }
-var import_react8, import_react_dom2, import_lucide_react4, import_jsx_runtime12;
+var import_react9, import_react_dom2, import_lucide_react4, import_jsx_runtime12;
 var init_SearchDialog = __esm({
   "src/client/theme/ui/SearchDialog/SearchDialog.tsx"() {
     "use strict";
-    import_react8 = __toESM(require("react"));
+    import_react9 = __toESM(require("react"));
     import_react_dom2 = require("react-dom");
     init_Link2();
     import_lucide_react4 = require("lucide-react");
@@ -1173,7 +1210,7 @@ function Navbar({
           ] }),
           /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)("div", { className: "navbar-right", children: [
             /* @__PURE__ */ (0, import_jsx_runtime13.jsx)("nav", { className: "navbar-links", "aria-label": "Top Navigation Right", children: rightItems.map(renderNavItem) }),
-            /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(import_react9.Suspense, { fallback: /* @__PURE__ */ (0, import_jsx_runtime13.jsx)("div", { className: "navbar-search-placeholder" }), children: /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(SearchDialog2, { routes: routes || [] }) }),
+            /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(import_react10.Suspense, { fallback: /* @__PURE__ */ (0, import_jsx_runtime13.jsx)("div", { className: "navbar-search-placeholder" }), children: /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(SearchDialog2, { routes: routes || [] }) }),
             config.i18n && currentLocale && allRoutes && /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(
               LanguageSwitcher,
               {
@@ -1213,11 +1250,11 @@ function Navbar({
     )
   ] });
 }
-var import_react9, import_react_router_dom5, import_lucide_react5, import_jsx_runtime13, SearchDialog2, ICON_MAP;
+var import_react10, import_react_router_dom5, import_lucide_react5, import_jsx_runtime13, SearchDialog2, ICON_MAP;
 var init_Navbar = __esm({
   "src/client/theme/ui/Navbar/Navbar.tsx"() {
     "use strict";
-    import_react9 = require("react");
+    import_react10 = require("react");
     import_react_router_dom5 = require("react-router-dom");
     import_lucide_react5 = require("lucide-react");
     init_LanguageSwitcher2();
@@ -1228,7 +1265,7 @@ var init_Navbar = __esm({
     init_GithubStars();
     init_Tabs();
     import_jsx_runtime13 = require("react/jsx-runtime");
-    SearchDialog2 = (0, import_react9.lazy)(
+    SearchDialog2 = (0, import_react10.lazy)(
       () => Promise.resolve().then(() => (init_SearchDialog2(), SearchDialog_exports)).then((m) => ({ default: m.SearchDialog }))
     );
     ICON_MAP = {
@@ -1405,7 +1442,7 @@ function SidebarGroupSection({
   currentPath
 }) {
   const isActive = group.routes.some((r) => currentPath === r.path);
-  const [open, setOpen] = (0, import_react10.useState)(true);
+  const [open, setOpen] = (0, import_react11.useState)(true);
   return /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("div", { className: "sidebar-group", children: [
     /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)(
       "button",
@@ -1437,11 +1474,11 @@ function SidebarGroupSection({
     ) }, route.path)) })
   ] });
 }
-var import_react10, import_react_router_dom6, import_lucide_react7, LucideIcons, import_jsx_runtime15;
+var import_react11, import_react_router_dom6, import_lucide_react7, LucideIcons, import_jsx_runtime15;
 var init_Sidebar = __esm({
   "src/client/theme/ui/Sidebar/Sidebar.tsx"() {
     "use strict";
-    import_react10 = require("react");
+    import_react11 = require("react");
     import_react_router_dom6 = require("react-router-dom");
     init_Link2();
     init_PoweredBy2();
@@ -1466,13 +1503,13 @@ function OnThisPage({
   communityHelp,
   filePath
 }) {
-  const [activeId, setActiveId] = (0, import_react11.useState)(null);
-  const [indicatorStyle, setIndicatorStyle] = (0, import_react11.useState)({});
-  const observerRef = (0, import_react11.useRef)(null);
+  const [activeId, setActiveId] = (0, import_react12.useState)(null);
+  const [indicatorStyle, setIndicatorStyle] = (0, import_react12.useState)({});
+  const observerRef = (0, import_react12.useRef)(null);
   const location = (0, import_react_router_dom7.useLocation)();
-  const listRef = (0, import_react11.useRef)(null);
-  const visibleIdsRef = (0, import_react11.useRef)(/* @__PURE__ */ new Set());
-  (0, import_react11.useEffect)(() => {
+  const listRef = (0, import_react12.useRef)(null);
+  const visibleIdsRef = (0, import_react12.useRef)(/* @__PURE__ */ new Set());
+  (0, import_react12.useEffect)(() => {
     if (headings.length > 0) {
       const hash = window.location.hash.substring(1);
       if (hash && headings.some((h) => h.id === hash)) {
@@ -1482,7 +1519,7 @@ function OnThisPage({
       }
     }
   }, [location.pathname, headings]);
-  (0, import_react11.useEffect)(() => {
+  (0, import_react12.useEffect)(() => {
     if (!activeId || !listRef.current) return;
     const activeLink = listRef.current.querySelector(
       `a[href="#${activeId}"]`
@@ -1497,7 +1534,7 @@ function OnThisPage({
       });
     }
   }, [activeId, headings]);
-  (0, import_react11.useEffect)(() => {
+  (0, import_react12.useEffect)(() => {
     if (headings.length === 0) return;
     visibleIdsRef.current.clear();
     if (observerRef.current) {
@@ -1555,7 +1592,7 @@ function OnThisPage({
       window.removeEventListener("scroll", handleScroll);
     };
   }, [headings, location.pathname]);
-  (0, import_react11.useEffect)(() => {
+  (0, import_react12.useEffect)(() => {
     if (!activeId || !listRef.current) return;
     const activeLink = listRef.current.querySelector(
       `a[href="#${activeId}"]`
@@ -1574,18 +1611,12 @@ function OnThisPage({
       }
     }
   }, [activeId]);
-  const handleClick = (0, import_react11.useCallback)(
+  const handleClick = (0, import_react12.useCallback)(
     (e, id) => {
       e.preventDefault();
       const el = document.getElementById(id);
       if (el) {
-        const offset = 80;
-        const bodyRect = document.body.getBoundingClientRect().top;
-        const elementRect = el.getBoundingClientRect().top;
-        const elementPosition = elementRect - bodyRect;
-        const offsetPosition = elementPosition - offset;
-        window.scrollTo({
-          top: offsetPosition,
+        el.scrollIntoView({
           behavior: "smooth"
         });
         setActiveId(id);
@@ -1643,11 +1674,11 @@ function OnThisPage({
     ] })
   ] });
 }
-var import_react11, import_react_router_dom7, import_lucide_react8, import_jsx_runtime16;
+var import_react12, import_react_router_dom7, import_lucide_react8, import_jsx_runtime16;
 var init_OnThisPage = __esm({
   "src/client/theme/ui/OnThisPage/OnThisPage.tsx"() {
     "use strict";
-    import_react11 = require("react");
+    import_react12 = require("react");
     import_react_router_dom7 = require("react-router-dom");
     import_lucide_react8 = require("lucide-react");
     import_jsx_runtime16 = require("react/jsx-runtime");
@@ -1665,7 +1696,7 @@ var init_OnThisPage2 = __esm({
 // src/client/theme/ui/Head/Head.tsx
 function Head({ siteTitle, siteDescription, routes }) {
   const location = (0, import_react_router_dom8.useLocation)();
-  (0, import_react12.useEffect)(() => {
+  (0, import_react13.useEffect)(() => {
     const currentRoute = routes.find((r) => r.path === location.pathname);
     const pageTitle = currentRoute?.title;
     const pageDescription = currentRoute?.description || siteDescription || "";
@@ -1709,11 +1740,11 @@ function setMetaTag(attr, key, content) {
   }
   tag.content = content;
 }
-var import_react12, import_react_router_dom8;
+var import_react13, import_react_router_dom8;
 var init_Head = __esm({
   "src/client/theme/ui/Head/Head.tsx"() {
     "use strict";
-    import_react12 = require("react");
+    import_react13 = require("react");
     import_react_router_dom8 = require("react-router-dom");
   }
 });
@@ -1794,6 +1825,118 @@ var init_BackgroundGradient2 = __esm({
   }
 });
 
+// src/client/theme/ui/ProgressBar/ProgressBar.css
+var init_ProgressBar = __esm({
+  "src/client/theme/ui/ProgressBar/ProgressBar.css"() {
+  }
+});
+
+// src/client/theme/ui/ProgressBar/ProgressBar.tsx
+function ProgressBar() {
+  const [progress, setProgress] = (0, import_react14.useState)(0);
+  (0, import_react14.useEffect)(() => {
+    let container = null;
+    let timer;
+    const handleScroll = () => {
+      if (!container) return;
+      const { scrollTop, scrollHeight, clientHeight } = container;
+      if (scrollHeight <= clientHeight) {
+        setProgress(0);
+        return;
+      }
+      const scrollPercent = scrollTop / (scrollHeight - clientHeight) * 100;
+      setProgress(Math.min(100, Math.max(0, scrollPercent)));
+    };
+    const attachListener = () => {
+      container = document.querySelector(".boltdocs-content");
+      if (container) {
+        container.addEventListener("scroll", handleScroll);
+        handleScroll();
+        if (timer) clearInterval(timer);
+        return true;
+      }
+      return false;
+    };
+    if (!attachListener()) {
+      timer = setInterval(attachListener, 100);
+    }
+    return () => {
+      if (container) container.removeEventListener("scroll", handleScroll);
+      if (timer) clearInterval(timer);
+    };
+  }, []);
+  return /* @__PURE__ */ (0, import_jsx_runtime19.jsx)("div", { className: "boltdocs-progress-container", children: /* @__PURE__ */ (0, import_jsx_runtime19.jsx)(
+    "div",
+    {
+      className: "boltdocs-progress-bar",
+      style: { width: `${progress}%` }
+    }
+  ) });
+}
+var import_react14, import_jsx_runtime19;
+var init_ProgressBar2 = __esm({
+  "src/client/theme/ui/ProgressBar/ProgressBar.tsx"() {
+    "use strict";
+    import_react14 = require("react");
+    init_ProgressBar();
+    import_jsx_runtime19 = require("react/jsx-runtime");
+  }
+});
+
+// src/client/theme/ui/ProgressBar/index.ts
+var init_ProgressBar3 = __esm({
+  "src/client/theme/ui/ProgressBar/index.ts"() {
+    "use strict";
+    init_ProgressBar2();
+  }
+});
+
+// src/client/theme/ui/ErrorBoundary/ErrorBoundary.tsx
+var import_react15, import_jsx_runtime20, ErrorBoundary;
+var init_ErrorBoundary = __esm({
+  "src/client/theme/ui/ErrorBoundary/ErrorBoundary.tsx"() {
+    "use strict";
+    import_react15 = require("react");
+    import_jsx_runtime20 = require("react/jsx-runtime");
+    ErrorBoundary = class extends import_react15.Component {
+      state = {
+        hasError: false
+      };
+      static getDerivedStateFromError(error) {
+        return { hasError: true, error };
+      }
+      componentDidCatch(error, errorInfo) {
+        console.error("Uncaught error in Boltdocs Layout:", error, errorInfo);
+      }
+      render() {
+        if (this.state.hasError) {
+          return this.props.fallback || /* @__PURE__ */ (0, import_jsx_runtime20.jsxs)("div", { className: "boltdocs-error-boundary", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("div", { className: "boltdocs-error-title", children: "Something went wrong" }),
+            /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("p", { className: "boltdocs-error-message", children: this.state.error?.message || "An unexpected error occurred while rendering this page." }),
+            /* @__PURE__ */ (0, import_jsx_runtime20.jsx)(
+              "button",
+              {
+                className: "boltdocs-error-retry",
+                onClick: () => this.setState({ hasError: false }),
+                children: "Try again"
+              }
+            )
+          ] });
+        }
+        return this.props.children;
+      }
+    };
+  }
+});
+
+// src/client/theme/ui/ErrorBoundary/index.ts
+var init_ErrorBoundary2 = __esm({
+  "src/client/theme/ui/ErrorBoundary/index.ts"() {
+    "use strict";
+    init_ErrorBoundary();
+  }
+});
+
 // src/client/theme/styles.css
 var init_styles = __esm({
   "src/client/theme/styles.css"() {
@@ -1832,13 +1975,14 @@ function ThemeLayout({
   const prevPage = localIndex > 0 ? filteredRoutes[localIndex - 1] : null;
   const nextPage = localIndex >= 0 && localIndex < filteredRoutes.length - 1 ? filteredRoutes[localIndex + 1] : null;
   const { preload } = usePreload();
-  import_react13.default.useEffect(() => {
+  import_react16.default.useEffect(() => {
     if (prevPage?.path) preload(prevPage.path);
     if (nextPage?.path) preload(nextPage.path);
   }, [prevPage, nextPage, preload]);
-  return /* @__PURE__ */ (0, import_jsx_runtime19.jsxs)("div", { className: `boltdocs-layout ${className}`, style, children: [
-    background !== void 0 ? background : /* @__PURE__ */ (0, import_jsx_runtime19.jsx)(BackgroundGradient, {}),
-    head !== void 0 ? head : /* @__PURE__ */ (0, import_jsx_runtime19.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("div", { className: `boltdocs-layout ${className}`, style, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(ProgressBar, {}),
+    background !== void 0 ? background : /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(BackgroundGradient, {}),
+    head !== void 0 ? head : /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
       Head,
       {
         siteTitle,
@@ -1846,7 +1990,7 @@ function ThemeLayout({
         routes
       }
     ),
-    navbar !== void 0 ? navbar : /* @__PURE__ */ (0, import_jsx_runtime19.jsx)(
+    navbar !== void 0 ? navbar : /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
       Navbar,
       {
         config,
@@ -1856,43 +2000,43 @@ function ThemeLayout({
         currentVersion
       }
     ),
-    /* @__PURE__ */ (0, import_jsx_runtime19.jsxs)("div", { className: "boltdocs-main-container", children: [
-      sidebar !== void 0 ? sidebar : /* @__PURE__ */ (0, import_jsx_runtime19.jsx)(Sidebar, { routes: filteredRoutes, config }),
-      /* @__PURE__ */ (0, import_jsx_runtime19.jsxs)("main", { className: "boltdocs-content", children: [
-        breadcrumbs !== void 0 ? breadcrumbs : /* @__PURE__ */ (0, import_jsx_runtime19.jsx)(Breadcrumbs, { routes: filteredRoutes, config }),
-        /* @__PURE__ */ (0, import_jsx_runtime19.jsx)("div", { className: "boltdocs-page", children }),
-        (prevPage || nextPage) && /* @__PURE__ */ (0, import_jsx_runtime19.jsxs)("nav", { className: "page-nav", "aria-label": "Pagination", children: [
-          prevPage ? /* @__PURE__ */ (0, import_jsx_runtime19.jsxs)(
+    /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("div", { className: "boltdocs-main-container", children: [
+      sidebar !== void 0 ? sidebar : /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(Sidebar, { routes: filteredRoutes, config }),
+      /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("main", { className: "boltdocs-content", children: [
+        breadcrumbs !== void 0 ? breadcrumbs : /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(Breadcrumbs, { routes: filteredRoutes, config }),
+        /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("div", { className: "boltdocs-page", children: /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(ErrorBoundary, { children }) }),
+        (prevPage || nextPage) && /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("nav", { className: "page-nav", "aria-label": "Pagination", children: [
+          prevPage ? /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)(
             Link,
             {
               to: prevPage.path || "/",
               className: "page-nav-link page-nav-link--prev",
               children: [
-                /* @__PURE__ */ (0, import_jsx_runtime19.jsxs)("div", { className: "page-nav-info", children: [
-                  /* @__PURE__ */ (0, import_jsx_runtime19.jsx)("span", { className: "page-nav-label", children: "Previous" }),
-                  /* @__PURE__ */ (0, import_jsx_runtime19.jsx)("span", { className: "page-nav-title", children: prevPage.title })
+                /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("div", { className: "page-nav-info", children: [
+                  /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("span", { className: "page-nav-label", children: "Previous" }),
+                  /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("span", { className: "page-nav-title", children: prevPage.title })
                 ] }),
-                /* @__PURE__ */ (0, import_jsx_runtime19.jsx)(import_lucide_react10.ChevronLeft, { className: "page-nav-arrow", size: 16 })
+                /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(import_lucide_react10.ChevronLeft, { className: "page-nav-arrow", size: 16 })
               ]
             }
-          ) : /* @__PURE__ */ (0, import_jsx_runtime19.jsx)("span", {}),
-          nextPage ? /* @__PURE__ */ (0, import_jsx_runtime19.jsxs)(
+          ) : /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("span", {}),
+          nextPage ? /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)(
             Link,
             {
               to: nextPage.path || "/",
               className: "page-nav-link page-nav-link--next",
               children: [
-                /* @__PURE__ */ (0, import_jsx_runtime19.jsxs)("div", { className: "page-nav-info", children: [
-                  /* @__PURE__ */ (0, import_jsx_runtime19.jsx)("span", { className: "page-nav-label", children: "Next" }),
-                  /* @__PURE__ */ (0, import_jsx_runtime19.jsx)("span", { className: "page-nav-title", children: nextPage.title })
+                /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("div", { className: "page-nav-info", children: [
+                  /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("span", { className: "page-nav-label", children: "Next" }),
+                  /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("span", { className: "page-nav-title", children: nextPage.title })
                 ] }),
-                /* @__PURE__ */ (0, import_jsx_runtime19.jsx)(import_lucide_react10.ChevronRight, { className: "page-nav-arrow", size: 16 })
+                /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(import_lucide_react10.ChevronRight, { className: "page-nav-arrow", size: 16 })
               ]
             }
-          ) : /* @__PURE__ */ (0, import_jsx_runtime19.jsx)("span", {})
+          ) : /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("span", {})
         ] })
       ] }),
-      toc !== void 0 ? toc : /* @__PURE__ */ (0, import_jsx_runtime19.jsx)(
+      toc !== void 0 ? toc : /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
         OnThisPage,
         {
           headings: routes[currentIndex]?.headings,
@@ -1904,11 +2048,11 @@ function ThemeLayout({
     ] })
   ] });
 }
-var import_react13, import_react_router_dom10, import_lucide_react10, import_jsx_runtime19;
+var import_react16, import_react_router_dom10, import_lucide_react10, import_jsx_runtime21;
 var init_Layout = __esm({
   "src/client/theme/ui/Layout/Layout.tsx"() {
     "use strict";
-    import_react13 = __toESM(require("react"));
+    import_react16 = __toESM(require("react"));
     import_react_router_dom10 = require("react-router-dom");
     init_Link2();
     import_lucide_react10 = require("lucide-react");
@@ -1925,8 +2069,10 @@ var init_Layout = __esm({
     init_Head2();
     init_Breadcrumbs2();
     init_BackgroundGradient2();
+    init_ProgressBar3();
+    init_ErrorBoundary2();
     init_styles();
-    import_jsx_runtime19 = require("react/jsx-runtime");
+    import_jsx_runtime21 = require("react/jsx-runtime");
   }
 });
 
@@ -1940,23 +2086,23 @@ var init_Layout2 = __esm({
 
 // src/client/theme/ui/NotFound/NotFound.tsx
 function NotFound() {
-  return /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("div", { className: "boltdocs-not-found", children: /* @__PURE__ */ (0, import_jsx_runtime20.jsxs)("div", { className: "not-found-content", children: [
-    /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("span", { className: "not-found-code", children: "404" }),
-    /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("h1", { className: "not-found-title", children: "Page Not Found" }),
-    /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("p", { className: "not-found-text", children: "The page you're looking for doesn't exist or has been moved." }),
-    /* @__PURE__ */ (0, import_jsx_runtime20.jsxs)(Link, { to: "/", className: "not-found-link", children: [
-      /* @__PURE__ */ (0, import_jsx_runtime20.jsx)(import_lucide_react11.ArrowLeft, { size: 16 }),
+  return /* @__PURE__ */ (0, import_jsx_runtime22.jsx)("div", { className: "boltdocs-not-found", children: /* @__PURE__ */ (0, import_jsx_runtime22.jsxs)("div", { className: "not-found-content", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime22.jsx)("span", { className: "not-found-code", children: "404" }),
+    /* @__PURE__ */ (0, import_jsx_runtime22.jsx)("h1", { className: "not-found-title", children: "Page Not Found" }),
+    /* @__PURE__ */ (0, import_jsx_runtime22.jsx)("p", { className: "not-found-text", children: "The page you're looking for doesn't exist or has been moved." }),
+    /* @__PURE__ */ (0, import_jsx_runtime22.jsxs)(Link, { to: "/", className: "not-found-link", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(import_lucide_react11.ArrowLeft, { size: 16 }),
       " Go to Home"
     ] })
   ] }) });
 }
-var import_lucide_react11, import_jsx_runtime20;
+var import_lucide_react11, import_jsx_runtime22;
 var init_NotFound = __esm({
   "src/client/theme/ui/NotFound/NotFound.tsx"() {
     "use strict";
     init_Link2();
     import_lucide_react11 = require("lucide-react");
-    import_jsx_runtime20 = require("react/jsx-runtime");
+    import_jsx_runtime22 = require("react/jsx-runtime");
   }
 });
 
@@ -1970,16 +2116,16 @@ var init_NotFound2 = __esm({
 
 // src/client/theme/ui/Loading/Loading.tsx
 function Loading() {
-  return /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("div", { className: "boltdocs-loading", children: [
-    /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("div", { className: "loading-spinner" }),
-    /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("p", { className: "loading-text", children: "Loading..." })
+  return /* @__PURE__ */ (0, import_jsx_runtime23.jsxs)("div", { className: "boltdocs-loading", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime23.jsx)("div", { className: "loading-spinner" }),
+    /* @__PURE__ */ (0, import_jsx_runtime23.jsx)("p", { className: "loading-text", children: "Loading..." })
   ] });
 }
-var import_jsx_runtime21;
+var import_jsx_runtime23;
 var init_Loading = __esm({
   "src/client/theme/ui/Loading/Loading.tsx"() {
     "use strict";
-    import_jsx_runtime21 = require("react/jsx-runtime");
+    import_jsx_runtime23 = require("react/jsx-runtime");
   }
 });
 
@@ -1993,35 +2139,35 @@ var init_Loading2 = __esm({
 
 // src/client/theme/components/CodeBlock/CodeBlock.tsx
 function CodeBlock({ children, ...props }) {
-  const [copied, setCopied] = (0, import_react14.useState)(false);
-  const preRef = (0, import_react14.useRef)(null);
-  const handleCopy = (0, import_react14.useCallback)(async () => {
+  const [copied, setCopied] = (0, import_react17.useState)(false);
+  const preRef = (0, import_react17.useRef)(null);
+  const handleCopy = (0, import_react17.useCallback)(async () => {
     const code = preRef.current?.textContent || "";
     copyToClipboard(code);
     setCopied(true);
     setTimeout(() => setCopied(false), 2e3);
   }, []);
-  return /* @__PURE__ */ (0, import_jsx_runtime22.jsxs)("div", { className: "code-block-wrapper", children: [
-    /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime24.jsxs)("div", { className: "code-block-wrapper", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
       "button",
       {
         className: `code-block-copy ${copied ? "copied" : ""}`,
         onClick: handleCopy,
         "aria-label": "Copy code",
-        children: copied ? /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(import_lucide_react12.Check, { size: 16 }) : /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(import_lucide_react12.Copy, { size: 16 })
+        children: copied ? /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(import_lucide_react12.Check, { size: 16 }) : /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(import_lucide_react12.Copy, { size: 16 })
       }
     ),
-    /* @__PURE__ */ (0, import_jsx_runtime22.jsx)("pre", { ref: preRef, ...props, children })
+    /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("pre", { ref: preRef, ...props, children })
   ] });
 }
-var import_react14, import_lucide_react12, import_jsx_runtime22;
+var import_react17, import_lucide_react12, import_jsx_runtime24;
 var init_CodeBlock = __esm({
   "src/client/theme/components/CodeBlock/CodeBlock.tsx"() {
     "use strict";
-    import_react14 = require("react");
+    import_react17 = require("react");
     import_lucide_react12 = require("lucide-react");
     init_utils();
-    import_jsx_runtime22 = require("react/jsx-runtime");
+    import_jsx_runtime24 = require("react/jsx-runtime");
   }
 });
 
@@ -2043,9 +2189,9 @@ function Video({
   preload = "metadata",
   ...rest
 }) {
-  const containerRef = (0, import_react15.useRef)(null);
-  const [isVisible, setIsVisible] = (0, import_react15.useState)(false);
-  (0, import_react15.useEffect)(() => {
+  const containerRef = (0, import_react18.useRef)(null);
+  const [isVisible, setIsVisible] = (0, import_react18.useState)(false);
+  (0, import_react18.useEffect)(() => {
     const el = containerRef.current;
     if (!el) return;
     const observer = new IntersectionObserver(
@@ -2060,7 +2206,7 @@ function Video({
     observer.observe(el);
     return () => observer.disconnect();
   }, []);
-  return /* @__PURE__ */ (0, import_jsx_runtime23.jsx)("div", { ref: containerRef, className: "boltdocs-video-wrapper", children: isVisible ? /* @__PURE__ */ (0, import_jsx_runtime23.jsxs)(
+  return /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("div", { ref: containerRef, className: "boltdocs-video-wrapper", children: isVisible ? /* @__PURE__ */ (0, import_jsx_runtime25.jsxs)(
     "video",
     {
       className: "boltdocs-video",
@@ -2075,7 +2221,7 @@ function Video({
         "Your browser does not support the video tag."
       ]
     }
-  ) : /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(
+  ) : /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
     "div",
     {
       className: "boltdocs-video-placeholder",
@@ -2084,12 +2230,12 @@ function Video({
     }
   ) });
 }
-var import_react15, import_jsx_runtime23;
+var import_react18, import_jsx_runtime25;
 var init_Video = __esm({
   "src/client/theme/components/Video/Video.tsx"() {
     "use strict";
-    import_react15 = require("react");
-    import_jsx_runtime23 = require("react/jsx-runtime");
+    import_react18 = require("react");
+    import_jsx_runtime25 = require("react/jsx-runtime");
   }
 });
 
@@ -2106,14 +2252,14 @@ var init_Video2 = __esm({
 });
 
 // src/client/theme/icons/npm.tsx
-var import_jsx_runtime24, NPM;
+var import_jsx_runtime26, NPM;
 var init_npm = __esm({
   "src/client/theme/icons/npm.tsx"() {
     "use strict";
-    import_jsx_runtime24 = require("react/jsx-runtime");
-    NPM = (props) => /* @__PURE__ */ (0, import_jsx_runtime24.jsxs)("svg", { ...props, viewBox: "0 0 2500 2500", children: [
-      /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("path", { fill: "#c00", d: "M0 0h2500v2500H0z" }),
-      /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
+    import_jsx_runtime26 = require("react/jsx-runtime");
+    NPM = (props) => /* @__PURE__ */ (0, import_jsx_runtime26.jsxs)("svg", { ...props, viewBox: "0 0 2500 2500", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime26.jsx)("path", { fill: "#c00", d: "M0 0h2500v2500H0z" }),
+      /* @__PURE__ */ (0, import_jsx_runtime26.jsx)(
         "path",
         {
           fill: "#fff",
@@ -2125,69 +2271,69 @@ var init_npm = __esm({
 });
 
 // src/client/theme/icons/pnpm.tsx
-var import_jsx_runtime25, Pnpm;
+var import_jsx_runtime27, Pnpm;
 var init_pnpm = __esm({
   "src/client/theme/icons/pnpm.tsx"() {
     "use strict";
-    import_jsx_runtime25 = require("react/jsx-runtime");
-    Pnpm = (props) => /* @__PURE__ */ (0, import_jsx_runtime25.jsxs)(
+    import_jsx_runtime27 = require("react/jsx-runtime");
+    Pnpm = (props) => /* @__PURE__ */ (0, import_jsx_runtime27.jsxs)(
       "svg",
       {
         ...props,
         xmlnsXlink: "http://www.w3.org/1999/xlink",
         viewBox: "76.58987244897958 44 164.00775510204068 164",
         children: [
-          /* @__PURE__ */ (0, import_jsx_runtime25.jsxs)("defs", { children: [
-            /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
+          /* @__PURE__ */ (0, import_jsx_runtime27.jsxs)("defs", { children: [
+            /* @__PURE__ */ (0, import_jsx_runtime27.jsx)(
               "path",
               {
                 d: "M237.6 95L187.6 95L187.6 45L237.6 45L237.6 95Z",
                 id: "pnpm_dark__b45vdTD8hs"
               }
             ),
-            /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
+            /* @__PURE__ */ (0, import_jsx_runtime27.jsx)(
               "path",
               {
                 d: "M182.59 95L132.59 95L132.59 45L182.59 45L182.59 95Z",
                 id: "pnpm_dark__a40WtxIl8d"
               }
             ),
-            /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
+            /* @__PURE__ */ (0, import_jsx_runtime27.jsx)(
               "path",
               {
                 d: "M127.59 95L77.59 95L77.59 45L127.59 45L127.59 95Z",
                 id: "pnpm_dark__h2CN9AEEpe"
               }
             ),
-            /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
+            /* @__PURE__ */ (0, import_jsx_runtime27.jsx)(
               "path",
               {
                 d: "M237.6 150L187.6 150L187.6 100L237.6 100L237.6 150Z",
                 id: "pnpm_dark__dqv5133G8"
               }
             ),
-            /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
+            /* @__PURE__ */ (0, import_jsx_runtime27.jsx)(
               "path",
               {
                 d: "M182.59 150L132.59 150L132.59 100L182.59 100L182.59 150Z",
                 id: "pnpm_dark__b1Lv79ypvm"
               }
             ),
-            /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
+            /* @__PURE__ */ (0, import_jsx_runtime27.jsx)(
               "path",
               {
                 d: "M182.59 205L132.59 205L132.59 155L182.59 155L182.59 205Z",
                 id: "pnpm_dark__hy1IZWwLX"
               }
             ),
-            /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
+            /* @__PURE__ */ (0, import_jsx_runtime27.jsx)(
               "path",
               {
                 d: "M237.6 205L187.6 205L187.6 155L237.6 155L237.6 205Z",
                 id: "pnpm_dark__akQfjxQes"
               }
             ),
-            /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
+            /* @__PURE__ */ (0, import_jsx_runtime27.jsx)(
               "path",
               {
                 d: "M127.59 205L77.59 205L77.59 155L127.59 155L127.59 205Z",
@@ -2195,15 +2341,15 @@ var init_pnpm = __esm({
               }
             )
           ] }),
-          /* @__PURE__ */ (0, import_jsx_runtime25.jsxs)("g", { children: [
-            /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("g", { children: /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("use", { xlinkHref: "#pnpm_dark__b45vdTD8hs", fill: "#f9ad00" }) }),
-            /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("g", { children: /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("use", { xlinkHref: "#pnpm_dark__a40WtxIl8d", fill: "#f9ad00" }) }),
-            /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("g", { children: /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("use", { xlinkHref: "#pnpm_dark__h2CN9AEEpe", fill: "#f9ad00" }) }),
-            /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("g", { children: /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("use", { xlinkHref: "#pnpm_dark__dqv5133G8", fill: "#f9ad00" }) }),
-            /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("g", { children: /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("use", { xlinkHref: "#pnpm_dark__b1Lv79ypvm", fill: "#ffffff" }) }),
-            /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("g", { children: /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("use", { xlinkHref: "#pnpm_dark__hy1IZWwLX", fill: "#ffffff" }) }),
-            /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("g", { children: /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("use", { xlinkHref: "#pnpm_dark__akQfjxQes", fill: "#ffffff" }) }),
-            /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("g", { children: /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("use", { xlinkHref: "#pnpm_dark__bdSrwE5pk", fill: "#ffffff" }) })
+          /* @__PURE__ */ (0, import_jsx_runtime27.jsxs)("g", { children: [
+            /* @__PURE__ */ (0, import_jsx_runtime27.jsx)("g", { children: /* @__PURE__ */ (0, import_jsx_runtime27.jsx)("use", { xlinkHref: "#pnpm_dark__b45vdTD8hs", fill: "#f9ad00" }) }),
+            /* @__PURE__ */ (0, import_jsx_runtime27.jsx)("g", { children: /* @__PURE__ */ (0, import_jsx_runtime27.jsx)("use", { xlinkHref: "#pnpm_dark__a40WtxIl8d", fill: "#f9ad00" }) }),
+            /* @__PURE__ */ (0, import_jsx_runtime27.jsx)("g", { children: /* @__PURE__ */ (0, import_jsx_runtime27.jsx)("use", { xlinkHref: "#pnpm_dark__h2CN9AEEpe", fill: "#f9ad00" }) }),
+            /* @__PURE__ */ (0, import_jsx_runtime27.jsx)("g", { children: /* @__PURE__ */ (0, import_jsx_runtime27.jsx)("use", { xlinkHref: "#pnpm_dark__dqv5133G8", fill: "#f9ad00" }) }),
+            /* @__PURE__ */ (0, import_jsx_runtime27.jsx)("g", { children: /* @__PURE__ */ (0, import_jsx_runtime27.jsx)("use", { xlinkHref: "#pnpm_dark__b1Lv79ypvm", fill: "#ffffff" }) }),
+            /* @__PURE__ */ (0, import_jsx_runtime27.jsx)("g", { children: /* @__PURE__ */ (0, import_jsx_runtime27.jsx)("use", { xlinkHref: "#pnpm_dark__hy1IZWwLX", fill: "#ffffff" }) }),
+            /* @__PURE__ */ (0, import_jsx_runtime27.jsx)("g", { children: /* @__PURE__ */ (0, import_jsx_runtime27.jsx)("use", { xlinkHref: "#pnpm_dark__akQfjxQes", fill: "#ffffff" }) }),
+            /* @__PURE__ */ (0, import_jsx_runtime27.jsx)("g", { children: /* @__PURE__ */ (0, import_jsx_runtime27.jsx)("use", { xlinkHref: "#pnpm_dark__bdSrwE5pk", fill: "#ffffff" }) })
           ] })
         ]
       }
@@ -2212,62 +2358,62 @@ var init_pnpm = __esm({
 });
 
 // src/client/theme/icons/bun.tsx
-var import_jsx_runtime26, Bun;
+var import_jsx_runtime28, Bun;
 var init_bun = __esm({
   "src/client/theme/icons/bun.tsx"() {
     "use strict";
-    import_jsx_runtime26 = require("react/jsx-runtime");
-    Bun = (props) => /* @__PURE__ */ (0, import_jsx_runtime26.jsxs)("svg", { ...props, viewBox: "0 0 80 70", children: [
-      /* @__PURE__ */ (0, import_jsx_runtime26.jsx)("path", { d: "M71.09 20.74c-.16-.17-.33-.34-.5-.5s-.33-.34-.5-.5-.33-.34-.5-.5-.33-.34-.5-.5-.33-.34-.5-.5-.33-.34-.5-.5-.33-.34-.5-.5A26.46 26.46 0 0 1 75.5 35.7c0 16.57-16.82 30.05-37.5 30.05-11.58 0-21.94-4.23-28.83-10.86l.5.5.5.5.5.5.5.5.5.5.5.5.5.5C19.55 65.3 30.14 69.75 42 69.75c20.68 0 37.5-13.48 37.5-30 0-7.06-3.04-13.75-8.41-19.01Z" }),
-      /* @__PURE__ */ (0, import_jsx_runtime26.jsx)(
+    import_jsx_runtime28 = require("react/jsx-runtime");
+    Bun = (props) => /* @__PURE__ */ (0, import_jsx_runtime28.jsxs)("svg", { ...props, viewBox: "0 0 80 70", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime28.jsx)("path", { d: "M71.09 20.74c-.16-.17-.33-.34-.5-.5s-.33-.34-.5-.5-.33-.34-.5-.5-.33-.34-.5-.5-.33-.34-.5-.5-.33-.34-.5-.5-.33-.34-.5-.5A26.46 26.46 0 0 1 75.5 35.7c0 16.57-16.82 30.05-37.5 30.05-11.58 0-21.94-4.23-28.83-10.86l.5.5.5.5.5.5.5.5.5.5.5.5.5.5C19.55 65.3 30.14 69.75 42 69.75c20.68 0 37.5-13.48 37.5-30 0-7.06-3.04-13.75-8.41-19.01Z" }),
+      /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(
         "path",
         {
           d: "M73 35.7c0 15.21-15.67 27.54-35 27.54S3 50.91 3 35.7C3 26.27 9 17.94 18.22 13S33.18 3 38 3s8.94 4.13 19.78 10C67 17.94 73 26.27 73 35.7Z",
           style: { fill: "#fbf0df" }
         }
       ),
-      /* @__PURE__ */ (0, import_jsx_runtime26.jsx)(
+      /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(
         "path",
         {
           d: "M73 35.7a21.67 21.67 0 0 0-.8-5.78c-2.73 33.3-43.35 34.9-59.32 24.94A40 40 0 0 0 38 63.24c19.3 0 35-12.35 35-27.54Z",
           style: { fill: "#f6dece" }
         }
       ),
-      /* @__PURE__ */ (0, import_jsx_runtime26.jsx)(
+      /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(
         "path",
         {
           d: "M24.53 11.17C29 8.49 34.94 3.46 40.78 3.45A9.29 9.29 0 0 0 38 3c-2.42 0-5 1.25-8.25 3.13-1.13.66-2.3 1.39-3.54 2.15-2.33 1.44-5 3.07-8 4.7C8.69 18.13 3 26.62 3 35.7v1.19c6.06-21.41 17.07-23.04 21.53-25.72Z",
           style: { fill: "#fffefc" }
         }
       ),
-      /* @__PURE__ */ (0, import_jsx_runtime26.jsx)(
+      /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(
         "path",
         {
           d: "M35.12 5.53A16.41 16.41 0 0 1 29.49 18c-.28.25-.06.73.3.59 3.37-1.31 7.92-5.23 6-13.14-.08-.45-.67-.33-.67.08Zm2.27 0A16.24 16.24 0 0 1 39 19c-.12.35.31.65.55.36 2.19-2.8 4.1-8.36-1.62-14.36-.29-.26-.74.14-.54.49Zm2.76-.17A16.42 16.42 0 0 1 47 17.12a.33.33 0 0 0 .65.11c.92-3.49.4-9.44-7.17-12.53-.4-.16-.66.38-.33.62Zm-18.46 10.4a16.94 16.94 0 0 0 10.47-9c.18-.36.75-.22.66.18-1.73 8-7.52 9.67-11.12 9.45-.38.01-.37-.52-.01-.63Z",
           style: { fill: "#ccbea7", fillRule: "evenodd" }
         }
       ),
-      /* @__PURE__ */ (0, import_jsx_runtime26.jsx)("path", { d: "M38 65.75C17.32 65.75.5 52.27.5 35.7c0-10 6.18-19.33 16.53-24.92 3-1.6 5.57-3.21 7.86-4.62 1.26-.78 2.45-1.51 3.6-2.19C32 1.89 35 .5 38 .5s5.62 1.2 8.9 3.14c1 .57 2 1.19 3.07 1.87 2.49 1.54 5.3 3.28 9 5.27C69.32 16.37 75.5 25.69 75.5 35.7c0 16.57-16.82 30.05-37.5 30.05ZM38 3c-2.42 0-5 1.25-8.25 3.13-1.13.66-2.3 1.39-3.54 2.15-2.33 1.44-5 3.07-8 4.7C8.69 18.13 3 26.62 3 35.7c0 15.19 15.7 27.55 35 27.55S73 50.89 73 35.7c0-9.08-5.69-17.57-15.22-22.7-3.78-2-6.73-3.88-9.12-5.36-1.09-.67-2.09-1.29-3-1.84C42.63 4 40.42 3 38 3Z" }),
-      /* @__PURE__ */ (0, import_jsx_runtime26.jsxs)("g", { children: [
-        /* @__PURE__ */ (0, import_jsx_runtime26.jsx)(
+      /* @__PURE__ */ (0, import_jsx_runtime28.jsx)("path", { d: "M38 65.75C17.32 65.75.5 52.27.5 35.7c0-10 6.18-19.33 16.53-24.92 3-1.6 5.57-3.21 7.86-4.62 1.26-.78 2.45-1.51 3.6-2.19C32 1.89 35 .5 38 .5s5.62 1.2 8.9 3.14c1 .57 2 1.19 3.07 1.87 2.49 1.54 5.3 3.28 9 5.27C69.32 16.37 75.5 25.69 75.5 35.7c0 16.57-16.82 30.05-37.5 30.05ZM38 3c-2.42 0-5 1.25-8.25 3.13-1.13.66-2.3 1.39-3.54 2.15-2.33 1.44-5 3.07-8 4.7C8.69 18.13 3 26.62 3 35.7c0 15.19 15.7 27.55 35 27.55S73 50.89 73 35.7c0-9.08-5.69-17.57-15.22-22.7-3.78-2-6.73-3.88-9.12-5.36-1.09-.67-2.09-1.29-3-1.84C42.63 4 40.42 3 38 3Z" }),
+      /* @__PURE__ */ (0, import_jsx_runtime28.jsxs)("g", { children: [
+        /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(
           "path",
           {
             d: "M45.05 43a8.93 8.93 0 0 1-2.92 4.71 6.81 6.81 0 0 1-4 1.88A6.84 6.84 0 0 1 34 47.71 8.93 8.93 0 0 1 31.12 43a.72.72 0 0 1 .8-.81h12.34a.72.72 0 0 1 .79.81Z",
             style: { fill: "#b71422" }
           }
         ),
-        /* @__PURE__ */ (0, import_jsx_runtime26.jsx)(
+        /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(
           "path",
           {
             d: "M34 47.79a6.91 6.91 0 0 0 4.12 1.9 6.91 6.91 0 0 0 4.11-1.9 10.63 10.63 0 0 0 1-1.07 6.83 6.83 0 0 0-4.9-2.31 6.15 6.15 0 0 0-5 2.78c.23.21.43.41.67.6Z",
             style: { fill: "#ff6164" }
           }
         ),
-        /* @__PURE__ */ (0, import_jsx_runtime26.jsx)("path", { d: "M34.16 47a5.36 5.36 0 0 1 4.19-2.08 6 6 0 0 1 4 1.69c.23-.25.45-.51.66-.77a7 7 0 0 0-4.71-1.93 6.36 6.36 0 0 0-4.89 2.36 9.53 9.53 0 0 0 .75.73Z" }),
-        /* @__PURE__ */ (0, import_jsx_runtime26.jsx)("path", { d: "M38.09 50.19a7.42 7.42 0 0 1-4.45-2 9.52 9.52 0 0 1-3.11-5.05 1.2 1.2 0 0 1 .26-1 1.41 1.41 0 0 1 1.13-.51h12.34a1.44 1.44 0 0 1 1.13.51 1.19 1.19 0 0 1 .25 1 9.52 9.52 0 0 1-3.11 5.05 7.42 7.42 0 0 1-4.44 2Zm-6.17-7.4c-.16 0-.2.07-.21.09a8.29 8.29 0 0 0 2.73 4.37A6.23 6.23 0 0 0 38.09 49a6.28 6.28 0 0 0 3.65-1.73 8.3 8.3 0 0 0 2.72-4.37.21.21 0 0 0-.2-.09Z" })
+        /* @__PURE__ */ (0, import_jsx_runtime28.jsx)("path", { d: "M34.16 47a5.36 5.36 0 0 1 4.19-2.08 6 6 0 0 1 4 1.69c.23-.25.45-.51.66-.77a7 7 0 0 0-4.71-1.93 6.36 6.36 0 0 0-4.89 2.36 9.53 9.53 0 0 0 .75.73Z" }),
+        /* @__PURE__ */ (0, import_jsx_runtime28.jsx)("path", { d: "M38.09 50.19a7.42 7.42 0 0 1-4.45-2 9.52 9.52 0 0 1-3.11-5.05 1.2 1.2 0 0 1 .26-1 1.41 1.41 0 0 1 1.13-.51h12.34a1.44 1.44 0 0 1 1.13.51 1.19 1.19 0 0 1 .25 1 9.52 9.52 0 0 1-3.11 5.05 7.42 7.42 0 0 1-4.44 2Zm-6.17-7.4c-.16 0-.2.07-.21.09a8.29 8.29 0 0 0 2.73 4.37A6.23 6.23 0 0 0 38.09 49a6.28 6.28 0 0 0 3.65-1.73 8.3 8.3 0 0 0 2.72-4.37.21.21 0 0 0-.2-.09Z" })
       ] }),
-      /* @__PURE__ */ (0, import_jsx_runtime26.jsxs)("g", { children: [
-        /* @__PURE__ */ (0, import_jsx_runtime26.jsx)(
+      /* @__PURE__ */ (0, import_jsx_runtime28.jsxs)("g", { children: [
+        /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(
           "ellipse",
           {
             cx: "53.22",
@@ -2277,7 +2423,7 @@ var init_bun = __esm({
             style: { fill: "#febbd0" }
           }
         ),
-        /* @__PURE__ */ (0, import_jsx_runtime26.jsx)(
+        /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(
           "ellipse",
           {
             cx: "22.95",
@@ -2287,14 +2433,14 @@ var init_bun = __esm({
             style: { fill: "#febbd0" }
           }
         ),
-        /* @__PURE__ */ (0, import_jsx_runtime26.jsx)(
+        /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(
           "path",
           {
             d: "M25.7 38.8a5.51 5.51 0 1 0-5.5-5.51 5.51 5.51 0 0 0 5.5 5.51Zm24.77 0A5.51 5.51 0 1 0 45 33.29a5.5 5.5 0 0 0 5.47 5.51Z",
             style: { fillRule: "evenodd" }
           }
         ),
-        /* @__PURE__ */ (0, import_jsx_runtime26.jsx)(
+        /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(
           "path",
           {
             d: "M24 33.64a2.07 2.07 0 1 0-2.06-2.07A2.07 2.07 0 0 0 24 33.64Zm24.77 0a2.07 2.07 0 1 0-2.06-2.07 2.07 2.07 0 0 0 2.04 2.07Z",
@@ -2307,12 +2453,12 @@ var init_bun = __esm({
 });
 
 // src/client/theme/icons/deno.tsx
-var import_jsx_runtime27, Deno;
+var import_jsx_runtime29, Deno;
 var init_deno = __esm({
   "src/client/theme/icons/deno.tsx"() {
     "use strict";
-    import_jsx_runtime27 = require("react/jsx-runtime");
-    Deno = (props) => /* @__PURE__ */ (0, import_jsx_runtime27.jsx)(
+    import_jsx_runtime29 = require("react/jsx-runtime");
+    Deno = (props) => /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(
       "svg",
       {
         ...props,
@@ -2322,7 +2468,7 @@ var init_deno = __esm({
         strokeMiterlimit: "2",
         clipRule: "evenodd",
         viewBox: "0 0 441 441",
-        children: /* @__PURE__ */ (0, import_jsx_runtime27.jsx)(
+        children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(
           "path",
           {
             fill: "currentColor",
@@ -2369,19 +2515,19 @@ function PackageManagerTabs({
   pkg = "",
   className = ""
 }) {
-  const [activeTab, setActiveTab] = (0, import_react16.useState)("npm");
-  const [copied, setCopied] = (0, import_react16.useState)(false);
+  const [activeTab, setActiveTab] = (0, import_react19.useState)("npm");
+  const [copied, setCopied] = (0, import_react19.useState)(false);
   const activeCommand = getCommandForManager(activeTab, command, pkg);
-  const handleCopy = (0, import_react16.useCallback)(async () => {
+  const handleCopy = (0, import_react19.useCallback)(async () => {
     copyToClipboard(activeCommand);
     setCopied(true);
     setTimeout(() => setCopied(false), 2e3);
   }, [activeCommand]);
-  return /* @__PURE__ */ (0, import_jsx_runtime28.jsxs)("div", { className: `pkg-tabs-wrapper ${className}`, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime28.jsx)("div", { className: "pkg-tabs-header", children: MANAGERS.map((mgr) => {
+  return /* @__PURE__ */ (0, import_jsx_runtime30.jsxs)("div", { className: `pkg-tabs-wrapper ${className}`, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime30.jsx)("div", { className: "pkg-tabs-header", children: MANAGERS.map((mgr) => {
       const Icon = mgr.icon;
       const isActive = activeTab === mgr.id;
-      return /* @__PURE__ */ (0, import_jsx_runtime28.jsxs)(
+      return /* @__PURE__ */ (0, import_jsx_runtime30.jsxs)(
         "button",
         {
           className: `pkg-tab-btn ${isActive ? "active" : ""}`,
@@ -2389,40 +2535,40 @@ function PackageManagerTabs({
           "aria-selected": isActive,
           role: "tab",
           children: [
-            /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(Icon, { className: "pkg-tab-icon", width: "16", height: "16" }),
-            /* @__PURE__ */ (0, import_jsx_runtime28.jsx)("span", { children: mgr.label })
+            /* @__PURE__ */ (0, import_jsx_runtime30.jsx)(Icon, { className: "pkg-tab-icon", width: "16", height: "16" }),
+            /* @__PURE__ */ (0, import_jsx_runtime30.jsx)("span", { children: mgr.label })
           ]
         },
         mgr.id
       );
     }) }),
-    /* @__PURE__ */ (0, import_jsx_runtime28.jsxs)("div", { className: "code-block-wrapper pkg-tabs-content", children: [
-      /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(
+    /* @__PURE__ */ (0, import_jsx_runtime30.jsxs)("div", { className: "code-block-wrapper pkg-tabs-content", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime30.jsx)(
         "button",
         {
           className: `code-block-copy ${copied ? "copied" : ""}`,
           onClick: handleCopy,
           type: "button",
           "aria-label": "Copy code",
-          children: copied ? /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(import_lucide_react13.Check, { size: 14 }) : /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(import_lucide_react13.Copy, { size: 14 })
+          children: copied ? /* @__PURE__ */ (0, import_jsx_runtime30.jsx)(import_lucide_react13.Check, { size: 14 }) : /* @__PURE__ */ (0, import_jsx_runtime30.jsx)(import_lucide_react13.Copy, { size: 14 })
         }
       ),
-      /* @__PURE__ */ (0, import_jsx_runtime28.jsx)("pre", { children: /* @__PURE__ */ (0, import_jsx_runtime28.jsx)("code", { children: /* @__PURE__ */ (0, import_jsx_runtime28.jsx)("span", { className: "line", children: activeCommand }) }) })
+      /* @__PURE__ */ (0, import_jsx_runtime30.jsx)("pre", { children: /* @__PURE__ */ (0, import_jsx_runtime30.jsx)("code", { children: /* @__PURE__ */ (0, import_jsx_runtime30.jsx)("span", { className: "line", children: activeCommand }) }) })
     ] })
   ] });
 }
-var import_react16, import_lucide_react13, import_jsx_runtime28, MANAGERS;
+var import_react19, import_lucide_react13, import_jsx_runtime30, MANAGERS;
 var init_PackageManagerTabs = __esm({
   "src/client/theme/components/PackageManagerTabs/PackageManagerTabs.tsx"() {
     "use strict";
-    import_react16 = require("react");
+    import_react19 = require("react");
     import_lucide_react13 = require("lucide-react");
     init_npm();
     init_pnpm();
     init_bun();
     init_deno();
     init_utils();
-    import_jsx_runtime28 = require("react/jsx-runtime");
+    import_jsx_runtime30 = require("react/jsx-runtime");
     MANAGERS = [
       { id: "npm", label: "npm", icon: NPM },
       { id: "pnpm", label: "pnpm", icon: Pnpm },
@@ -2446,7 +2592,7 @@ var init_PackageManagerTabs2 = __esm({
 
 // src/client/app/index.tsx
 function useConfig() {
-  return (0, import_react19.useContext)(ConfigContext);
+  return (0, import_react22.useContext)(ConfigContext);
 }
 function AppShell({
   initialRoutes,
@@ -2457,8 +2603,8 @@ function AppShell({
   homePage: HomePage,
   components: customComponents = {}
 }) {
-  const [routesInfo, setRoutesInfo] = (0, import_react17.useState)(initialRoutes);
-  const [config] = (0, import_react17.useState)(initialConfig);
+  const [routesInfo, setRoutesInfo] = (0, import_react20.useState)(initialRoutes);
+  const [config] = (0, import_react20.useState)(initialConfig);
   const resolveRoutes = (infos) => {
     return infos.filter(
       (route) => !(HomePage && (route.path === "/" || route.path === ""))
@@ -2469,35 +2615,35 @@ function AppShell({
       const loader = loaderKey ? modules[loaderKey] : null;
       return {
         ...route,
-        Component: import_react17.default.lazy(() => {
+        Component: import_react20.default.lazy(() => {
           if (!loader)
-            return Promise.resolve({ default: () => /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(NotFound, {}) });
+            return Promise.resolve({ default: () => /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(NotFound, {}) });
           return loader();
         })
       };
     });
   };
-  const [resolvedRoutes, setResolvedRoutes] = (0, import_react17.useState)(
+  const [resolvedRoutes, setResolvedRoutes] = (0, import_react20.useState)(
     () => resolveRoutes(initialRoutes)
   );
-  (0, import_react17.useEffect)(() => {
+  (0, import_react20.useEffect)(() => {
     if (hot) {
       hot.on("boltdocs:routes-update", (newRoutes) => {
         setRoutesInfo(newRoutes);
       });
     }
   }, [hot]);
-  (0, import_react17.useEffect)(() => {
+  (0, import_react20.useEffect)(() => {
     setResolvedRoutes(resolveRoutes(routesInfo));
   }, [routesInfo, modules, docsDirName]);
-  return /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(ConfigContext.Provider, { value: config, children: /* @__PURE__ */ (0, import_jsx_runtime29.jsxs)(PreloadProvider, { routes: routesInfo, modules, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(ScrollHandler, {}),
-    /* @__PURE__ */ (0, import_jsx_runtime29.jsxs)(import_react_router_dom11.Routes, { children: [
-      HomePage && /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(ConfigContext.Provider, { value: config, children: /* @__PURE__ */ (0, import_jsx_runtime31.jsxs)(PreloadProvider, { routes: routesInfo, modules, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(ScrollHandler, {}),
+    /* @__PURE__ */ (0, import_jsx_runtime31.jsxs)(import_react_router_dom11.Routes, { children: [
+      HomePage && /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(
         import_react_router_dom11.Route,
         {
           path: "/",
-          element: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(
+          element: /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(
             ThemeLayout,
             {
               config,
@@ -2506,20 +2652,20 @@ function AppShell({
               toc: null,
               breadcrumbs: null,
               ...config.themeConfig?.layoutProps,
-              children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(HomePage, {})
+              children: /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(HomePage, {})
             }
           )
         }
       ),
-      /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(
+      /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(
         import_react_router_dom11.Route,
         {
-          element: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(DocsLayout, { config, routes: routesInfo }),
-          children: resolvedRoutes.map((route) => /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(
+          element: /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(DocsLayout, { config, routes: routesInfo }),
+          children: resolvedRoutes.map((route) => /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(
             import_react_router_dom11.Route,
             {
               path: route.path === "" ? "/" : route.path,
-              element: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(import_react17.default.Suspense, { fallback: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(Loading, {}), children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(
+              element: /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(import_react20.default.Suspense, { fallback: /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(Loading, {}), children: /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(
                 MdxPage,
                 {
                   Component: route.Component,
@@ -2532,17 +2678,17 @@ function AppShell({
         },
         "docs-layout"
       ),
-      /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(
+      /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(
         import_react_router_dom11.Route,
         {
           path: "*",
-          element: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(
+          element: /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(
             ThemeLayout,
             {
               config,
               routes: routesInfo,
               ...config.themeConfig?.layoutProps,
-              children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(NotFound, {})
+              children: /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(NotFound, {})
             }
           )
         }
@@ -2552,24 +2698,26 @@ function AppShell({
 }
 function ScrollHandler() {
   const { pathname, hash } = (0, import_react_router_dom11.useLocation)();
-  (0, import_react19.useLayoutEffect)(() => {
+  (0, import_react22.useLayoutEffect)(() => {
+    const container = document.querySelector(".boltdocs-content");
+    if (!container) return;
     if (hash) {
       const id = hash.replace("#", "");
       const element = document.getElementById(id);
       if (element) {
         const offset = 80;
-        const bodyRect = document.body.getBoundingClientRect().top;
+        const containerRect = container.getBoundingClientRect().top;
         const elementRect = element.getBoundingClientRect().top;
-        const elementPosition = elementRect - bodyRect;
-        const offsetPosition = elementPosition - offset;
-        window.scrollTo({
+        const elementPosition = elementRect - containerRect;
+        const offsetPosition = elementPosition - offset + container.scrollTop;
+        container.scrollTo({
           top: offsetPosition,
           behavior: "smooth"
         });
         return;
       }
     }
-    window.scrollTo(0, 0);
+    container.scrollTo(0, 0);
   }, [pathname, hash]);
   return null;
 }
@@ -2577,22 +2725,22 @@ function DocsLayout({
   config,
   routes
 }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(
     ThemeLayout,
     {
       config,
       routes,
       ...config.themeConfig?.layoutProps,
-      children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(import_react_router_dom11.Outlet, {})
+      children: /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(import_react_router_dom11.Outlet, {})
     }
   );
 }
 function MdxPage({
-  Component,
+  Component: Component2,
   customComponents = {}
 }) {
   const allComponents = { ...mdxComponents, ...customComponents };
-  return /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(import_react18.MDXProvider, { components: allComponents, children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(Component, {}) });
+  return /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(import_react21.MDXProvider, { components: allComponents, children: /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(Component2, {}) });
 }
 function createBoltdocsApp(options) {
   const { target, routes, docsDirName, config, modules, hot, homePage } = options;
@@ -2602,7 +2750,7 @@ function createBoltdocsApp(options) {
       `[boltdocs] Mount target "${target}" not found in document.`
     );
   }
-  const app = /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(import_react17.default.StrictMode, { children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(import_react_router_dom11.BrowserRouter, { children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(
+  const app = /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(import_react20.default.StrictMode, { children: /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(import_react_router_dom11.BrowserRouter, { children: /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(
     AppShell,
     {
       initialRoutes: routes,
@@ -2617,27 +2765,27 @@ function createBoltdocsApp(options) {
   container.innerHTML = "";
   import_client.default.createRoot(container).render(app);
 }
-var import_react17, import_client, import_react_router_dom11, import_react18, import_react19, import_lucide_react14, import_jsx_runtime29, ConfigContext, Video2, PackageManagerTabs2, Heading, mdxComponents;
+var import_react20, import_client, import_react_router_dom11, import_react21, import_react22, import_lucide_react14, import_jsx_runtime31, ConfigContext, Video2, PackageManagerTabs2, Heading, mdxComponents;
 var init_app = __esm({
   "src/client/app/index.tsx"() {
     "use strict";
-    import_react17 = __toESM(require("react"));
+    import_react20 = __toESM(require("react"));
     import_client = __toESM(require("react-dom/client"));
     import_react_router_dom11 = require("react-router-dom");
     init_Layout2();
     init_NotFound2();
     init_Loading2();
-    import_react18 = require("@mdx-js/react");
-    import_react19 = require("react");
+    import_react21 = require("@mdx-js/react");
+    import_react22 = require("react");
     import_lucide_react14 = require("lucide-react");
     init_CodeBlock2();
     init_preload();
-    import_jsx_runtime29 = require("react/jsx-runtime");
-    ConfigContext = (0, import_react19.createContext)(null);
-    Video2 = (0, import_react19.lazy)(
+    import_jsx_runtime31 = require("react/jsx-runtime");
+    ConfigContext = (0, import_react22.createContext)(null);
+    Video2 = (0, import_react22.lazy)(
       () => Promise.resolve().then(() => (init_Video2(), Video_exports)).then((m) => ({ default: m.Video }))
     );
-    PackageManagerTabs2 = (0, import_react19.lazy)(
+    PackageManagerTabs2 = (0, import_react22.lazy)(
       () => Promise.resolve().then(() => (init_PackageManagerTabs2(), PackageManagerTabs_exports)).then((m) => ({
         default: m.PackageManagerTabs
       }))
@@ -2648,21 +2796,21 @@ var init_app = __esm({
       children
     }) => {
       const Tag = `h${level}`;
-      return /* @__PURE__ */ (0, import_jsx_runtime29.jsxs)(Tag, { id, className: "boltdocs-heading", children: [
+      return /* @__PURE__ */ (0, import_jsx_runtime31.jsxs)(Tag, { id, className: "boltdocs-heading", children: [
         children,
-        id && /* @__PURE__ */ (0, import_jsx_runtime29.jsx)("a", { href: `#${id}`, className: "header-anchor", "aria-label": "Anchor", children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(import_lucide_react14.Link, { size: 16 }) })
+        id && /* @__PURE__ */ (0, import_jsx_runtime31.jsx)("a", { href: `#${id}`, className: "header-anchor", "aria-label": "Anchor", children: /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(import_lucide_react14.Link, { size: 16 }) })
       ] });
     };
     mdxComponents = {
-      h1: (props) => /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(Heading, { level: 1, ...props }),
-      h2: (props) => /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(Heading, { level: 2, ...props }),
-      h3: (props) => /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(Heading, { level: 3, ...props }),
-      h4: (props) => /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(Heading, { level: 4, ...props }),
-      h5: (props) => /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(Heading, { level: 5, ...props }),
-      h6: (props) => /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(Heading, { level: 6, ...props }),
-      pre: (props) => /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(CodeBlock, { ...props, children: props.children }),
-      video: (props) => /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(import_react19.Suspense, { fallback: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)("div", { className: "video-skeleton" }), children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(Video2, { ...props }) }),
-      PackageManagerTabs: (props) => /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(import_react19.Suspense, { fallback: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)("div", { className: "pkg-tabs-skeleton" }), children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(PackageManagerTabs2, { ...props }) })
+      h1: (props) => /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(Heading, { level: 1, ...props }),
+      h2: (props) => /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(Heading, { level: 2, ...props }),
+      h3: (props) => /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(Heading, { level: 3, ...props }),
+      h4: (props) => /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(Heading, { level: 4, ...props }),
+      h5: (props) => /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(Heading, { level: 5, ...props }),
+      h6: (props) => /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(Heading, { level: 6, ...props }),
+      pre: (props) => /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(CodeBlock, { ...props, children: props.children }),
+      video: (props) => /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(import_react22.Suspense, { fallback: /* @__PURE__ */ (0, import_jsx_runtime31.jsx)("div", { className: "video-skeleton" }), children: /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(Video2, { ...props }) }),
+      PackageManagerTabs: (props) => /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(import_react22.Suspense, { fallback: /* @__PURE__ */ (0, import_jsx_runtime31.jsx)("div", { className: "pkg-tabs-skeleton" }), children: /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(PackageManagerTabs2, { ...props }) })
     };
   }
 });
@@ -2710,10 +2858,10 @@ init_Breadcrumbs2();
 init_BackgroundGradient2();
 
 // src/client/theme/components/Playground/Playground.tsx
-var import_react20 = __toESM(require("react"));
+var import_react23 = __toESM(require("react"));
 var import_react_live = require("react-live");
 var import_lucide_react15 = require("lucide-react");
-var import_jsx_runtime30 = require("react/jsx-runtime");
+var import_jsx_runtime32 = require("react/jsx-runtime");
 function prepareCode(raw) {
   const trimmed = raw.trim();
   const fnMatch = trimmed.match(/export\s+default\s+function\s+(\w+)/);
@@ -2746,48 +2894,48 @@ function Playground({
   }
   const prepared = prepareCode(initialCode);
   const useNoInline = forceNoInline ?? prepared.noInline;
-  const [copied, setCopied] = (0, import_react20.useState)(false);
-  const [activeCode, setActiveCode] = (0, import_react20.useState)(prepared.code);
+  const [copied, setCopied] = (0, import_react23.useState)(false);
+  const [activeCode, setActiveCode] = (0, import_react23.useState)(prepared.code);
   const handleCopy = () => {
     navigator.clipboard.writeText(activeCode);
     setCopied(true);
     setTimeout(() => setCopied(false), 2e3);
   };
-  const extendedScope = { React: import_react20.default, ...scope };
-  return /* @__PURE__ */ (0, import_jsx_runtime30.jsx)("div", { className: "boltdocs-playground", "data-readonly": readonly, children: /* @__PURE__ */ (0, import_jsx_runtime30.jsx)(
+  const extendedScope = { React: import_react23.default, ...scope };
+  return /* @__PURE__ */ (0, import_jsx_runtime32.jsx)("div", { className: "boltdocs-playground", "data-readonly": readonly, children: /* @__PURE__ */ (0, import_jsx_runtime32.jsx)(
     import_react_live.LiveProvider,
     {
       code: activeCode,
       scope: extendedScope,
       theme: void 0,
       noInline: useNoInline,
-      children: /* @__PURE__ */ (0, import_jsx_runtime30.jsxs)("div", { className: "playground-split-container", children: [
-        /* @__PURE__ */ (0, import_jsx_runtime30.jsxs)("div", { className: "playground-panel playground-editor-panel", children: [
-          /* @__PURE__ */ (0, import_jsx_runtime30.jsxs)("div", { className: "playground-panel-header", children: [
-            /* @__PURE__ */ (0, import_jsx_runtime30.jsxs)("div", { className: "playground-panel-title", children: [
-              /* @__PURE__ */ (0, import_jsx_runtime30.jsx)(import_lucide_react15.Terminal, { size: 14 }),
-              /* @__PURE__ */ (0, import_jsx_runtime30.jsx)("span", { children: readonly ? "Code Example" : "Live Editor" })
+      children: /* @__PURE__ */ (0, import_jsx_runtime32.jsxs)("div", { className: "playground-split-container", children: [
+        /* @__PURE__ */ (0, import_jsx_runtime32.jsxs)("div", { className: "playground-panel playground-editor-panel", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime32.jsxs)("div", { className: "playground-panel-header", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime32.jsxs)("div", { className: "playground-panel-title", children: [
+              /* @__PURE__ */ (0, import_jsx_runtime32.jsx)(import_lucide_react15.Terminal, { size: 14 }),
+              /* @__PURE__ */ (0, import_jsx_runtime32.jsx)("span", { children: readonly ? "Code Example" : "Live Editor" })
             ] }),
-            /* @__PURE__ */ (0, import_jsx_runtime30.jsx)(
+            /* @__PURE__ */ (0, import_jsx_runtime32.jsx)(
               "button",
               {
                 className: "playground-copy-btn",
                 onClick: handleCopy,
                 title: "Copy code",
-                children: copied ? /* @__PURE__ */ (0, import_jsx_runtime30.jsx)(import_lucide_react15.Check, { size: 14 }) : /* @__PURE__ */ (0, import_jsx_runtime30.jsx)(import_lucide_react15.Copy, { size: 14 })
+                children: copied ? /* @__PURE__ */ (0, import_jsx_runtime32.jsx)(import_lucide_react15.Check, { size: 14 }) : /* @__PURE__ */ (0, import_jsx_runtime32.jsx)(import_lucide_react15.Copy, { size: 14 })
               }
             )
           ] }),
-          /* @__PURE__ */ (0, import_jsx_runtime30.jsx)("div", { className: "playground-panel-content playground-editor", children: /* @__PURE__ */ (0, import_jsx_runtime30.jsx)(import_react_live.LiveEditor, { disabled: readonly, onChange: setActiveCode }) })
+          /* @__PURE__ */ (0, import_jsx_runtime32.jsx)("div", { className: "playground-panel-content playground-editor", children: /* @__PURE__ */ (0, import_jsx_runtime32.jsx)(import_react_live.LiveEditor, { disabled: readonly, onChange: setActiveCode }) })
         ] }),
-        /* @__PURE__ */ (0, import_jsx_runtime30.jsxs)("div", { className: "playground-panel playground-preview-panel", children: [
-          /* @__PURE__ */ (0, import_jsx_runtime30.jsx)("div", { className: "playground-panel-header", children: /* @__PURE__ */ (0, import_jsx_runtime30.jsxs)("div", { className: "playground-panel-title", children: [
-            /* @__PURE__ */ (0, import_jsx_runtime30.jsx)(import_lucide_react15.Play, { size: 14 }),
-            /* @__PURE__ */ (0, import_jsx_runtime30.jsx)("span", { children: "Preview" })
+        /* @__PURE__ */ (0, import_jsx_runtime32.jsxs)("div", { className: "playground-panel playground-preview-panel", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime32.jsx)("div", { className: "playground-panel-header", children: /* @__PURE__ */ (0, import_jsx_runtime32.jsxs)("div", { className: "playground-panel-title", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime32.jsx)(import_lucide_react15.Play, { size: 14 }),
+            /* @__PURE__ */ (0, import_jsx_runtime32.jsx)("span", { children: "Preview" })
           ] }) }),
-          /* @__PURE__ */ (0, import_jsx_runtime30.jsxs)("div", { className: "playground-panel-content playground-preview", children: [
-            /* @__PURE__ */ (0, import_jsx_runtime30.jsx)(import_react_live.LivePreview, {}),
-            /* @__PURE__ */ (0, import_jsx_runtime30.jsx)(import_react_live.LiveError, { className: "playground-error" })
+          /* @__PURE__ */ (0, import_jsx_runtime32.jsxs)("div", { className: "playground-panel-content playground-preview", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime32.jsx)(import_react_live.LivePreview, {}),
+            /* @__PURE__ */ (0, import_jsx_runtime32.jsx)(import_react_live.LiveError, { className: "playground-error" })
           ] })
         ] })
       ] })
@@ -2802,7 +2950,7 @@ init_CodeBlock2();
 init_Video2();
 
 // src/client/theme/components/mdx/Button.tsx
-var import_jsx_runtime31 = require("react/jsx-runtime");
+var import_jsx_runtime33 = require("react/jsx-runtime");
 function Button({
   variant = "primary",
   size = "md",
@@ -2813,7 +2961,7 @@ function Button({
 }) {
   const cls = `ld-btn ld-btn--${variant} ld-btn--${size} ${className}`.trim();
   if (href) {
-    return /* @__PURE__ */ (0, import_jsx_runtime31.jsx)(
+    return /* @__PURE__ */ (0, import_jsx_runtime33.jsx)(
       "a",
       {
         href,
@@ -2824,18 +2972,18 @@ function Button({
       }
     );
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime31.jsx)("button", { className: cls, ...rest, children });
+  return /* @__PURE__ */ (0, import_jsx_runtime33.jsx)("button", { className: cls, ...rest, children });
 }
 
 // src/client/theme/components/mdx/Badge.tsx
-var import_jsx_runtime32 = require("react/jsx-runtime");
+var import_jsx_runtime34 = require("react/jsx-runtime");
 function Badge({
   variant = "default",
   children,
   className = "",
   ...rest
 }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime32.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime34.jsx)(
     "span",
     {
       className: `ld-badge ld-badge--${variant} ${className}`.trim(),
@@ -2846,14 +2994,14 @@ function Badge({
 }
 
 // src/client/theme/components/mdx/Card.tsx
-var import_jsx_runtime33 = require("react/jsx-runtime");
+var import_jsx_runtime35 = require("react/jsx-runtime");
 function Cards({
   cols = 3,
   children,
   className = "",
   ...rest
 }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime33.jsx)("div", { className: `ld-cards ld-cards--${cols} ${className}`.trim(), ...rest, children });
+  return /* @__PURE__ */ (0, import_jsx_runtime35.jsx)("div", { className: `ld-cards ld-cards--${cols} ${className}`.trim(), ...rest, children });
 }
 function Card({
   title,
@@ -2863,13 +3011,13 @@ function Card({
   className = "",
   ...rest
 }) {
-  const inner = /* @__PURE__ */ (0, import_jsx_runtime33.jsxs)(import_jsx_runtime33.Fragment, { children: [
-    icon && /* @__PURE__ */ (0, import_jsx_runtime33.jsx)("span", { className: "ld-card__icon", children: icon }),
-    title && /* @__PURE__ */ (0, import_jsx_runtime33.jsx)("h3", { className: "ld-card__title", children: title }),
-    children && /* @__PURE__ */ (0, import_jsx_runtime33.jsx)("div", { className: "ld-card__body", children })
+  const inner = /* @__PURE__ */ (0, import_jsx_runtime35.jsxs)(import_jsx_runtime35.Fragment, { children: [
+    icon && /* @__PURE__ */ (0, import_jsx_runtime35.jsx)("span", { className: "ld-card__icon", children: icon }),
+    title && /* @__PURE__ */ (0, import_jsx_runtime35.jsx)("h3", { className: "ld-card__title", children: title }),
+    children && /* @__PURE__ */ (0, import_jsx_runtime35.jsx)("div", { className: "ld-card__body", children })
   ] });
   if (href) {
-    return /* @__PURE__ */ (0, import_jsx_runtime33.jsx)(
+    return /* @__PURE__ */ (0, import_jsx_runtime35.jsx)(
       "a",
       {
         href,
@@ -2879,34 +3027,34 @@ function Card({
       }
     );
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime33.jsx)("div", { className: `ld-card ${className}`.trim(), ...rest, children: inner });
+  return /* @__PURE__ */ (0, import_jsx_runtime35.jsx)("div", { className: `ld-card ${className}`.trim(), ...rest, children: inner });
 }
 
 // src/client/theme/components/mdx/Tabs.tsx
-var import_react21 = require("react");
+var import_react24 = require("react");
 init_CodeBlock2();
 init_npm();
 init_pnpm();
 init_bun();
 init_deno();
-var import_jsx_runtime34 = require("react/jsx-runtime");
+var import_jsx_runtime36 = require("react/jsx-runtime");
 function Tab({ children }) {
-  const content = typeof children === "string" ? /* @__PURE__ */ (0, import_jsx_runtime34.jsx)(CodeBlock, { className: "language-bash", children: /* @__PURE__ */ (0, import_jsx_runtime34.jsx)("code", { children: children.trim() }) }) : children;
-  return /* @__PURE__ */ (0, import_jsx_runtime34.jsx)("div", { className: "ld-tab-panel", children: content });
+  const content = typeof children === "string" ? /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(CodeBlock, { className: "language-bash", children: /* @__PURE__ */ (0, import_jsx_runtime36.jsx)("code", { children: children.trim() }) }) : children;
+  return /* @__PURE__ */ (0, import_jsx_runtime36.jsx)("div", { className: "ld-tab-panel", children: content });
 }
 var getIconForLabel = (label) => {
   const l = label.toLowerCase();
-  if (l.includes("pnpm")) return /* @__PURE__ */ (0, import_jsx_runtime34.jsx)(Pnpm, {});
-  if (l.includes("npm")) return /* @__PURE__ */ (0, import_jsx_runtime34.jsx)(NPM, {});
-  if (l.includes("bun")) return /* @__PURE__ */ (0, import_jsx_runtime34.jsx)(Bun, {});
-  if (l.includes("deno")) return /* @__PURE__ */ (0, import_jsx_runtime34.jsx)(Deno, {});
+  if (l.includes("pnpm")) return /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(Pnpm, {});
+  if (l.includes("npm")) return /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(NPM, {});
+  if (l.includes("bun")) return /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(Bun, {});
+  if (l.includes("deno")) return /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(Deno, {});
   return null;
 };
 function Tabs2({ defaultIndex = 0, children }) {
-  const [active, setActive] = (0, import_react21.useState)(defaultIndex);
-  const tabRefs = (0, import_react21.useRef)([]);
-  const tabs = import_react21.Children.toArray(children).filter(
-    (child) => (0, import_react21.isValidElement)(child) && child.props?.label
+  const [active, setActive] = (0, import_react24.useState)(defaultIndex);
+  const tabRefs = (0, import_react24.useRef)([]);
+  const tabs = import_react24.Children.toArray(children).filter(
+    (child) => (0, import_react24.isValidElement)(child) && child.props?.label
   );
   const handleKeyDown = (e) => {
     let newIndex = active;
@@ -2920,11 +3068,11 @@ function Tabs2({ defaultIndex = 0, children }) {
       tabRefs.current[newIndex]?.focus();
     }
   };
-  return /* @__PURE__ */ (0, import_jsx_runtime34.jsxs)("div", { className: "ld-tabs", children: [
-    /* @__PURE__ */ (0, import_jsx_runtime34.jsx)("div", { className: "ld-tabs__bar", role: "tablist", onKeyDown: handleKeyDown, children: tabs.map((child, i) => {
+  return /* @__PURE__ */ (0, import_jsx_runtime36.jsxs)("div", { className: "ld-tabs", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime36.jsx)("div", { className: "ld-tabs__bar", role: "tablist", onKeyDown: handleKeyDown, children: tabs.map((child, i) => {
       const label = child.props.label;
       const Icon = getIconForLabel(label);
-      return /* @__PURE__ */ (0, import_jsx_runtime34.jsxs)(
+      return /* @__PURE__ */ (0, import_jsx_runtime36.jsxs)(
         "button",
         {
           role: "tab",
@@ -2939,13 +3087,13 @@ function Tabs2({ defaultIndex = 0, children }) {
           onClick: () => setActive(i),
           children: [
             Icon,
-            /* @__PURE__ */ (0, import_jsx_runtime34.jsx)("span", { children: label })
+            /* @__PURE__ */ (0, import_jsx_runtime36.jsx)("span", { children: label })
           ]
         },
         i
       );
     }) }),
-    /* @__PURE__ */ (0, import_jsx_runtime34.jsx)(
+    /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(
       "div",
       {
         className: "ld-tabs__content",
@@ -2960,13 +3108,13 @@ function Tabs2({ defaultIndex = 0, children }) {
 
 // src/client/theme/components/mdx/Admonition.tsx
 var import_lucide_react16 = require("lucide-react");
-var import_jsx_runtime35 = require("react/jsx-runtime");
+var import_jsx_runtime37 = require("react/jsx-runtime");
 var ICON_MAP2 = {
-  note: /* @__PURE__ */ (0, import_jsx_runtime35.jsx)(import_lucide_react16.Bookmark, { size: 18 }),
-  tip: /* @__PURE__ */ (0, import_jsx_runtime35.jsx)(import_lucide_react16.Lightbulb, { size: 18 }),
-  info: /* @__PURE__ */ (0, import_jsx_runtime35.jsx)(import_lucide_react16.Info, { size: 18 }),
-  warning: /* @__PURE__ */ (0, import_jsx_runtime35.jsx)(import_lucide_react16.AlertTriangle, { size: 18 }),
-  danger: /* @__PURE__ */ (0, import_jsx_runtime35.jsx)(import_lucide_react16.ShieldAlert, { size: 18 })
+  note: /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(import_lucide_react16.Bookmark, { size: 18 }),
+  tip: /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(import_lucide_react16.Lightbulb, { size: 18 }),
+  info: /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(import_lucide_react16.Info, { size: 18 }),
+  warning: /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(import_lucide_react16.AlertTriangle, { size: 18 }),
+  danger: /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(import_lucide_react16.ShieldAlert, { size: 18 })
 };
 var LABEL_MAP = {
   note: "Note",
@@ -2982,35 +3130,35 @@ function Admonition({
   className = "",
   ...rest
 }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime35.jsxs)(
+  return /* @__PURE__ */ (0, import_jsx_runtime37.jsxs)(
     "div",
     {
       className: `ld-admonition ld-admonition--${type} ${className}`.trim(),
       role: type === "warning" || type === "danger" ? "alert" : "note",
       ...rest,
       children: [
-        /* @__PURE__ */ (0, import_jsx_runtime35.jsxs)("div", { className: "ld-admonition__header", children: [
-          /* @__PURE__ */ (0, import_jsx_runtime35.jsx)("span", { className: "ld-admonition__icon", children: ICON_MAP2[type] }),
-          /* @__PURE__ */ (0, import_jsx_runtime35.jsx)("span", { className: "ld-admonition__title", children: title || LABEL_MAP[type] })
+        /* @__PURE__ */ (0, import_jsx_runtime37.jsxs)("div", { className: "ld-admonition__header", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime37.jsx)("span", { className: "ld-admonition__icon", children: ICON_MAP2[type] }),
+          /* @__PURE__ */ (0, import_jsx_runtime37.jsx)("span", { className: "ld-admonition__title", children: title || LABEL_MAP[type] })
         ] }),
-        /* @__PURE__ */ (0, import_jsx_runtime35.jsx)("div", { className: "ld-admonition__body", children })
+        /* @__PURE__ */ (0, import_jsx_runtime37.jsx)("div", { className: "ld-admonition__body", children })
       ]
     }
   );
 }
-var Note = (props) => /* @__PURE__ */ (0, import_jsx_runtime35.jsx)(Admonition, { type: "note", ...props });
-var Tip = (props) => /* @__PURE__ */ (0, import_jsx_runtime35.jsx)(Admonition, { type: "tip", ...props });
-var Warning = (props) => /* @__PURE__ */ (0, import_jsx_runtime35.jsx)(Admonition, { type: "warning", ...props });
-var Danger = (props) => /* @__PURE__ */ (0, import_jsx_runtime35.jsx)(Admonition, { type: "danger", ...props });
-var InfoBox = (props) => /* @__PURE__ */ (0, import_jsx_runtime35.jsx)(Admonition, { type: "info", ...props });
+var Note = (props) => /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(Admonition, { type: "note", ...props });
+var Tip = (props) => /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(Admonition, { type: "tip", ...props });
+var Warning = (props) => /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(Admonition, { type: "warning", ...props });
+var Danger = (props) => /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(Admonition, { type: "danger", ...props });
+var InfoBox = (props) => /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(Admonition, { type: "info", ...props });
 
 // src/client/theme/components/mdx/List.tsx
-var import_react22 = __toESM(require("react"));
+var import_react25 = __toESM(require("react"));
 var import_lucide_react17 = require("lucide-react");
-var import_jsx_runtime36 = require("react/jsx-runtime");
+var import_jsx_runtime38 = require("react/jsx-runtime");
 var ICON_MAP3 = {
-  checked: /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(import_lucide_react17.Check, { size: 14, className: "ld-list__icon" }),
-  arrow: /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(import_lucide_react17.ChevronRight, { size: 14, className: "ld-list__icon" })
+  checked: /* @__PURE__ */ (0, import_jsx_runtime38.jsx)(import_lucide_react17.Check, { size: 14, className: "ld-list__icon" }),
+  arrow: /* @__PURE__ */ (0, import_jsx_runtime38.jsx)(import_lucide_react17.ChevronRight, { size: 14, className: "ld-list__icon" })
 };
 function List({
   variant = "default",
@@ -3019,27 +3167,27 @@ function List({
   ...rest
 }) {
   if (variant === "default") {
-    return /* @__PURE__ */ (0, import_jsx_runtime36.jsx)("ul", { className: `ld-list ${className}`.trim(), ...rest, children });
+    return /* @__PURE__ */ (0, import_jsx_runtime38.jsx)("ul", { className: `ld-list ${className}`.trim(), ...rest, children });
   }
   const icon = ICON_MAP3[variant];
-  return /* @__PURE__ */ (0, import_jsx_runtime36.jsx)("ul", { className: `ld-list ld-list--${variant} ${className}`.trim(), ...rest, children: import_react22.Children.map(children, (child) => {
-    if (!import_react22.default.isValidElement(child)) return child;
-    return /* @__PURE__ */ (0, import_jsx_runtime36.jsxs)("li", { className: "ld-list__item", children: [
+  return /* @__PURE__ */ (0, import_jsx_runtime38.jsx)("ul", { className: `ld-list ld-list--${variant} ${className}`.trim(), ...rest, children: import_react25.Children.map(children, (child) => {
+    if (!import_react25.default.isValidElement(child)) return child;
+    return /* @__PURE__ */ (0, import_jsx_runtime38.jsxs)("li", { className: "ld-list__item", children: [
       icon,
-      /* @__PURE__ */ (0, import_jsx_runtime36.jsx)("span", { className: "ld-list__text", children: child.props.children })
+      /* @__PURE__ */ (0, import_jsx_runtime38.jsx)("span", { className: "ld-list__text", children: child.props.children })
     ] });
   }) });
 }
 
 // src/client/theme/components/mdx/FileTree.tsx
-var import_react23 = __toESM(require("react"));
+var import_react26 = __toESM(require("react"));
 var import_lucide_react18 = require("lucide-react");
-var import_jsx_runtime37 = require("react/jsx-runtime");
+var import_jsx_runtime39 = require("react/jsx-runtime");
 function getTextContent(node) {
   if (typeof node === "string") return node;
   if (typeof node === "number") return node.toString();
   if (Array.isArray(node)) return node.map(getTextContent).join("");
-  if ((0, import_react23.isValidElement)(node)) {
+  if ((0, import_react26.isValidElement)(node)) {
     return getTextContent(node.props.children);
   }
   return "";
@@ -3047,13 +3195,13 @@ function getTextContent(node) {
 function getFileIcon(filename) {
   const name = filename.toLowerCase();
   if (name.endsWith(".ts") || name.endsWith(".tsx") || name.endsWith(".js") || name.endsWith(".jsx") || name.endsWith(".json") || name.endsWith(".mjs") || name.endsWith(".cjs") || name.endsWith(".astro") || name.endsWith(".vue") || name.endsWith(".svelte")) {
-    return /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(import_lucide_react18.FileCode, { size: 16, strokeWidth: 2, className: "ld-file-tree__icon-file" });
+    return /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(import_lucide_react18.FileCode, { size: 16, strokeWidth: 2, className: "ld-file-tree__icon-file" });
   }
   if (name.endsWith(".md") || name.endsWith(".mdx") || name.endsWith(".txt")) {
-    return /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(import_lucide_react18.FileText, { size: 16, strokeWidth: 2, className: "ld-file-tree__icon-file" });
+    return /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(import_lucide_react18.FileText, { size: 16, strokeWidth: 2, className: "ld-file-tree__icon-file" });
   }
   if (name.endsWith(".png") || name.endsWith(".jpg") || name.endsWith(".jpeg") || name.endsWith(".svg") || name.endsWith(".gif")) {
-    return /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(
+    return /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(
       import_lucide_react18.FileImage,
       {
         size: 16,
@@ -3062,7 +3210,7 @@ function getFileIcon(filename) {
       }
     );
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(import_lucide_react18.File, { size: 16, strokeWidth: 2, className: "ld-file-tree__icon-file" });
+  return /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(import_lucide_react18.File, { size: 16, strokeWidth: 2, className: "ld-file-tree__icon-file" });
 }
 function isListElement(node, tag) {
   if (typeof node.type === "string") {
@@ -3084,16 +3232,16 @@ function FolderNode({
   nestedNodes,
   depth
 }) {
-  const [isOpen, setIsOpen] = (0, import_react23.useState)(true);
-  return /* @__PURE__ */ (0, import_jsx_runtime37.jsxs)("li", { className: "ld-file-tree__item", children: [
-    /* @__PURE__ */ (0, import_jsx_runtime37.jsxs)(
+  const [isOpen, setIsOpen] = (0, import_react26.useState)(true);
+  return /* @__PURE__ */ (0, import_jsx_runtime39.jsxs)("li", { className: "ld-file-tree__item", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime39.jsxs)(
       "div",
       {
         className: "ld-file-tree__label ld-file-tree__label--folder",
         onClick: () => setIsOpen(!isOpen),
         style: { cursor: "pointer" },
         children: [
-          /* @__PURE__ */ (0, import_jsx_runtime37.jsx)("span", { className: "ld-file-tree__icon ld-file-tree__icon--chevron", children: /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(
+          /* @__PURE__ */ (0, import_jsx_runtime39.jsx)("span", { className: "ld-file-tree__icon ld-file-tree__icon--chevron", children: /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(
             import_lucide_react18.ChevronRight,
             {
               size: 14,
@@ -3101,7 +3249,7 @@ function FolderNode({
               strokeWidth: 3
             }
           ) }),
-          /* @__PURE__ */ (0, import_jsx_runtime37.jsx)("span", { className: "ld-file-tree__icon", children: /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(
+          /* @__PURE__ */ (0, import_jsx_runtime39.jsx)("span", { className: "ld-file-tree__icon", children: /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(
             import_lucide_react18.Folder,
             {
               size: 16,
@@ -3111,30 +3259,30 @@ function FolderNode({
               fillOpacity: 0.15
             }
           ) }),
-          /* @__PURE__ */ (0, import_jsx_runtime37.jsx)("span", { className: "ld-file-tree__name", children: labelText })
+          /* @__PURE__ */ (0, import_jsx_runtime39.jsx)("span", { className: "ld-file-tree__name", children: labelText })
         ]
       }
     ),
-    isOpen && nestedNodes.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime37.jsx)("div", { className: "ld-file-tree__nested", children: nestedNodes.map((child, index) => /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(import_react23.default.Fragment, { children: parseNode(child, depth) }, index)) })
+    isOpen && nestedNodes.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime39.jsx)("div", { className: "ld-file-tree__nested", children: nestedNodes.map((child, index) => /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(import_react26.default.Fragment, { children: parseNode(child, depth) }, index)) })
   ] });
 }
 function parseNode(node, depth = 0) {
-  if (!(0, import_react23.isValidElement)(node)) {
+  if (!(0, import_react26.isValidElement)(node)) {
     return node;
   }
   if (isListElement(node, "ul")) {
-    return /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(
+    return /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(
       "ul",
       {
         className: `ld-file-tree__list ${depth === 0 ? "ld-file-tree__list--root" : ""}`,
-        children: import_react23.Children.map(node.props.children, (child, index) => /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(import_react23.default.Fragment, { children: parseNode(child, depth + 1) }, index))
+        children: import_react26.Children.map(node.props.children, (child, index) => /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(import_react26.default.Fragment, { children: parseNode(child, depth + 1) }, index))
       }
     );
   }
   if (isListElement(node, "li")) {
-    const children = import_react23.Children.toArray(node.props.children);
+    const children = import_react26.Children.toArray(node.props.children);
     const nestedListIndex = children.findIndex(
-      (child) => (0, import_react23.isValidElement)(child) && isListElement(child, "ul")
+      (child) => (0, import_react26.isValidElement)(child) && isListElement(child, "ul")
     );
     const hasNested = nestedListIndex !== -1;
     const labelNodes = hasNested ? children.slice(0, nestedListIndex) : children;
@@ -3144,7 +3292,7 @@ function parseNode(node, depth = 0) {
     const labelText = isExplicitDir ? rawLabelContent.slice(0, -1) : rawLabelContent;
     const isFolder = hasNested || isExplicitDir;
     if (isFolder) {
-      return /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(
+      return /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(
         FolderNode,
         {
           labelText,
@@ -3153,34 +3301,135 @@ function parseNode(node, depth = 0) {
         }
       );
     }
-    return /* @__PURE__ */ (0, import_jsx_runtime37.jsx)("li", { className: "ld-file-tree__item", children: /* @__PURE__ */ (0, import_jsx_runtime37.jsxs)("div", { className: "ld-file-tree__label ld-file-tree__label--file", children: [
-      /* @__PURE__ */ (0, import_jsx_runtime37.jsx)("span", { className: "ld-file-tree__icon ld-file-tree__icon--spacer" }),
-      /* @__PURE__ */ (0, import_jsx_runtime37.jsx)("span", { className: "ld-file-tree__icon", children: getFileIcon(labelText) }),
-      /* @__PURE__ */ (0, import_jsx_runtime37.jsx)("span", { className: "ld-file-tree__name", children: labelText })
+    return /* @__PURE__ */ (0, import_jsx_runtime39.jsx)("li", { className: "ld-file-tree__item", children: /* @__PURE__ */ (0, import_jsx_runtime39.jsxs)("div", { className: "ld-file-tree__label ld-file-tree__label--file", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime39.jsx)("span", { className: "ld-file-tree__icon ld-file-tree__icon--spacer" }),
+      /* @__PURE__ */ (0, import_jsx_runtime39.jsx)("span", { className: "ld-file-tree__icon", children: getFileIcon(labelText) }),
+      /* @__PURE__ */ (0, import_jsx_runtime39.jsx)("span", { className: "ld-file-tree__name", children: labelText })
     ] }) });
   }
   if (node.props.children) {
-    return import_react23.Children.map(node.props.children, (child, index) => /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(import_react23.default.Fragment, { children: parseNode(child, depth) }, index));
+    return import_react26.Children.map(node.props.children, (child, index) => /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(import_react26.default.Fragment, { children: parseNode(child, depth) }, index));
   }
   return node;
 }
 function FileTree({ children }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime37.jsx)("div", { className: "ld-file-tree", dir: "ltr", children: import_react23.Children.map(children, (child) => parseNode(child, 0)) });
+  return /* @__PURE__ */ (0, import_jsx_runtime39.jsx)("div", { className: "ld-file-tree", dir: "ltr", children: import_react26.Children.map(children, (child) => parseNode(child, 0)) });
 }
 
 // src/client/theme/components/mdx/Table.tsx
-var import_jsx_runtime38 = require("react/jsx-runtime");
+var import_react27 = require("react");
+var import_lucide_react19 = require("lucide-react");
+var import_jsx_runtime40 = require("react/jsx-runtime");
 function Table({
   headers,
   data,
   children,
-  className = ""
+  className = "",
+  sortable = false,
+  paginated = false,
+  pageSize = 10
 }) {
-  const tableContent = children ? children : /* @__PURE__ */ (0, import_jsx_runtime38.jsxs)(import_jsx_runtime38.Fragment, { children: [
-    headers && /* @__PURE__ */ (0, import_jsx_runtime38.jsx)("thead", { children: /* @__PURE__ */ (0, import_jsx_runtime38.jsx)("tr", { children: headers.map((header, i) => /* @__PURE__ */ (0, import_jsx_runtime38.jsx)("th", { children: header }, i)) }) }),
-    data && /* @__PURE__ */ (0, import_jsx_runtime38.jsx)("tbody", { children: data.map((row, i) => /* @__PURE__ */ (0, import_jsx_runtime38.jsx)("tr", { children: row.map((cell, j) => /* @__PURE__ */ (0, import_jsx_runtime38.jsx)("td", { children: cell }, j)) }, i)) })
+  const [sortConfig, setSortConfig] = (0, import_react27.useState)(null);
+  const [currentPage, setCurrentPage] = (0, import_react27.useState)(1);
+  const processedData = (0, import_react27.useMemo)(() => {
+    if (!data) return [];
+    let items = [...data];
+    if (sortable && sortConfig !== null) {
+      items.sort((a, b) => {
+        const aVal = a[sortConfig.key];
+        const bVal = b[sortConfig.key];
+        const aStr = typeof aVal === "string" ? aVal : "";
+        const bStr = typeof bVal === "string" ? bVal : "";
+        if (aStr < bStr) return sortConfig.direction === "asc" ? -1 : 1;
+        if (aStr > bStr) return sortConfig.direction === "asc" ? 1 : -1;
+        return 0;
+      });
+    }
+    return items;
+  }, [data, sortConfig, sortable]);
+  const totalPages = Math.ceil(processedData.length / pageSize);
+  const paginatedData = (0, import_react27.useMemo)(() => {
+    if (!paginated) return processedData;
+    const start = (currentPage - 1) * pageSize;
+    return processedData.slice(start, start + pageSize);
+  }, [processedData, paginated, currentPage, pageSize]);
+  const requestSort = (index) => {
+    if (!sortable) return;
+    let direction = "asc";
+    if (sortConfig && sortConfig.key === index && sortConfig.direction === "asc") {
+      direction = "desc";
+    }
+    setSortConfig({ key: index, direction });
+  };
+  const renderSortIcon = (index) => {
+    if (!sortable) return null;
+    if (sortConfig?.key !== index) return /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(import_lucide_react19.ChevronDown, { size: 14, className: "ld-table-sort-icon ld-table-sort-icon--hidden" });
+    return sortConfig.direction === "asc" ? /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(import_lucide_react19.ChevronUp, { size: 14, className: "ld-table-sort-icon" }) : /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(import_lucide_react19.ChevronDown, { size: 14, className: "ld-table-sort-icon" });
+  };
+  const tableContent = children ? children : /* @__PURE__ */ (0, import_jsx_runtime40.jsxs)(import_jsx_runtime40.Fragment, { children: [
+    headers && /* @__PURE__ */ (0, import_jsx_runtime40.jsx)("thead", { children: /* @__PURE__ */ (0, import_jsx_runtime40.jsx)("tr", { children: headers.map((header, i) => /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(
+      "th",
+      {
+        onClick: () => requestSort(i),
+        className: sortable ? "ld-table-header--sortable" : "",
+        children: /* @__PURE__ */ (0, import_jsx_runtime40.jsxs)("div", { className: "ld-table-header-content", children: [
+          header,
+          renderSortIcon(i)
+        ] })
+      },
+      i
+    )) }) }),
+    paginatedData && /* @__PURE__ */ (0, import_jsx_runtime40.jsx)("tbody", { children: paginatedData.map((row, i) => /* @__PURE__ */ (0, import_jsx_runtime40.jsx)("tr", { children: row.map((cell, j) => /* @__PURE__ */ (0, import_jsx_runtime40.jsx)("td", { children: cell }, j)) }, i)) })
+  ] });
+  return /* @__PURE__ */ (0, import_jsx_runtime40.jsxs)("div", { className: `ld-table-container ${className}`.trim(), children: [
+    /* @__PURE__ */ (0, import_jsx_runtime40.jsx)("div", { className: "ld-table-wrapper", children: /* @__PURE__ */ (0, import_jsx_runtime40.jsx)("table", { className: "ld-table", children: tableContent }) }),
+    paginated && totalPages > 1 && /* @__PURE__ */ (0, import_jsx_runtime40.jsxs)("div", { className: "ld-table-pagination", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime40.jsxs)("div", { className: "ld-table-pagination-info", children: [
+        "Page ",
+        currentPage,
+        " of ",
+        totalPages
+      ] }),
+      /* @__PURE__ */ (0, import_jsx_runtime40.jsxs)("div", { className: "ld-table-pagination-controls", children: [
+        /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(
+          "button",
+          {
+            onClick: () => setCurrentPage(1),
+            disabled: currentPage === 1,
+            className: "ld-table-pagination-btn",
+            children: /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(import_lucide_react19.ChevronsLeft, { size: 16 })
+          }
+        ),
+        /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(
+          "button",
+          {
+            onClick: () => setCurrentPage((prev) => Math.max(prev - 1, 1)),
+            disabled: currentPage === 1,
+            className: "ld-table-pagination-btn",
+            children: /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(import_lucide_react19.ChevronLeft, { size: 16 })
+          }
+        ),
+        /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(
+          "button",
+          {
+            onClick: () => setCurrentPage((prev) => Math.min(prev + 1, totalPages)),
+            disabled: currentPage === totalPages,
+            className: "ld-table-pagination-btn",
+            children: /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(import_lucide_react19.ChevronRight, { size: 16 })
+          }
+        ),
+        /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(
+          "button",
+          {
+            onClick: () => setCurrentPage(totalPages),
+            disabled: currentPage === totalPages,
+            className: "ld-table-pagination-btn",
+            children: /* @__PURE__ */ (0, import_jsx_runtime40.jsx)(import_lucide_react19.ChevronsRight, { size: 16 })
+          }
+        )
+      ] })
+    ] })
   ] });
-  return /* @__PURE__ */ (0, import_jsx_runtime38.jsx)("div", { className: `ld-table-container ${className}`.trim(), children: /* @__PURE__ */ (0, import_jsx_runtime38.jsx)("table", { className: "ld-table", children: tableContent }) });
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {