boltdocs 2.7.10 → 2.7.11

package/dist/client/index.js

@@ -3,4 +3,1883 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-import{$ as e,B as t,C as n,F as r,H as i,J as a,K as o,L as s,O as c,Q as l,T as u,V as d,W as f,X as p,Y as m,Z as h,_ as g,b as _,et as v,j as y,k as b,nt as x,q as S,s as C,tt as w,w as ee,y as T}from"../icons-dev-B_RZIyxu.js";import{D as te,E as ne,M as E,N as D,T as O,_ as k,h as A,i as j,j as re,k as M,m as ie,n as ae,r as oe,t as N,w as se}from"../docs-layout-KoWNZc8_.js";import{c as ce,l as P}from"../image-CqKzYD8f.js";import{n as F}from"../search-dialog-D6BNohIJ.js";import{n as le,t as ue}from"../search-dialog-B584t9ZF.js";import{a as de,i as fe,n as pe,r as me,t as he}from"../mdx-DudBEac0.js";import{ViteReactSSG as ge}from"@bdocs/ssg";import{Outlet as _e,useLoaderData as ve,useLocation as I,useNavigate as ye}from"react-router-dom";import{Suspense as be,createContext as xe,lazy as Se,use as Ce,useCallback as we,useEffect as L,useLayoutEffect as Te,useMemo as R,useRef as Ee,useState as z}from"react";import{Fragment as B,jsx as V,jsxs as H}from"react/jsx-runtime";import{Button as De}from"react-aria-components";import Oe from"virtual:boltdocs-icons";import*as ke from"react-helmet-async";import Ae from"virtual:boltdocs-mdx-components";import je from"virtual:boltdocs-layout";const Me=Symbol.for(`__BDOCS_MDX_COMPONENTS_CONTEXT__`),U=Symbol.for(`__BDOCS_MDX_COMPONENTS_INSTANCE__`),Ne=globalThis[Me]||(globalThis[Me]=xe({}));function W(){let e=Ce(Ne);return(!e||Object.keys(e).length===0)&&globalThis[U]?globalThis[U]:e}function Pe({components:e,children:t}){let n=R(()=>{let t={},n={};return Object.entries(e).forEach(([e,r])=>{if(e.startsWith(`Frontmatter_`)){let t=e.slice(12);n[t]=r}else t[e]=r}),t.Frontmatter=n,t},[e]);return typeof globalThis<`u`&&(globalThis[U]=n),V(Ne.Provider,{value:n,children:t})}function Fe(){let{currentRoute:e}=p(),t=[];return e&&(e.groupTitle&&t.push({label:e.groupTitle}),t.push({label:e.title,href:e.path})),{crumbs:t,activeRoute:e}}function Ie(){let{crumbs:e,activeRoute:t}=Fe();return e.length===0?null:H(D.Root,{className:`gap-2 text-xs sm:text-sm font-medium`,children:[V(D.Item,{children:V(D.Link,{href:`/`,className:`text-muted hover:text-body transition-colors flex items-center`,children:V(r,{size:14})})}),e.map((e,n)=>{let r=e.href===t?.path;return H(D.Item,{className:`gap-2`,children:[V(D.Separator,{className:`text-muted/40`}),V(D.Link,{href:e.href,className:T(`transition-colors`,r?`text-body font-semibold cursor-default pointer-events-none`:`text-muted hover:text-body`),children:e.label})]},`crumb-${e.href}-${e.label}-${n}`)})]})}const Le=e=>{let[t,n]=z(!1);return{copied:t,handleCopy:()=>{navigator.clipboard.writeText(e),n(!0),setTimeout(()=>n(!1),2e3)},handleOpenRaw:()=>{let t=new Blob([e],{type:`text/plain;charset=utf-8`}),n=URL.createObjectURL(t);window.open(n,`_blank`)}}};function Re({content:e,mdxRaw:t}){let n=t||e||``,{copied:r,handleCopy:i,handleOpenRaw:a}=Le(n);return n?V(`div`,{className:`relative inline-flex z-100 shrink-0 w-max`,children:H(re,{className:`rounded-xl border border-subtle bg-surface transition-all duration-300 hover:border-primary-500/50 group overflow-hidden`,children:[V(E,{onPress:i,className:T(`md:hidden flex items-center justify-center w-8 h-8 bg-transparent outline-none select-none cursor-pointer border-none`,`text-muted transition-all duration-300 hover:bg-primary-500/5 hover:text-body`,r&&`text-emerald-500 hover:bg-emerald-500/5`),"aria-label":r?`Copied!`:`Copy Markdown`,children:V(r?ee:b,{size:14})}),H(E,{onPress:i,className:T(`hidden md:flex items-center gap-2 px-5 py-2 bg-transparent text-[0.8125rem] font-semibold h-9 shrink-0 outline-none select-none cursor-pointer border-none`,`text-body transition-all duration-300 hover:bg-primary-500/5`,r&&`text-emerald-500 hover:bg-emerald-500/5`),children:[V(r?ee:b,{size:16}),r?`Copied!`:`Copy Markdown`]}),H(M.Trigger,{placement:`bottom end`,children:[V(E,{className:T(`flex items-center justify-center px-2.5 md:px-3.5 h-8 md:h-9 border-none border-l border-subtle/50 text-muted rounded-none bg-transparent shrink-0 outline-none select-none cursor-pointer`,`transition-all duration-300 hover:bg-primary-500/5 hover:text-primary-500`),children:V(u,{size:14})}),H(M.Root,{className:`w-52 bg-main border border-subtle rounded-xl p-1.5 shadow-md outline-none flex flex-col gap-0.5 animate-fade-in z-100`,children:[H(M.Item,{onAction:i,className:`flex items-center px-3 py-2 rounded-lg text-xs font-medium text-body dark:hover:bg-primary-300/50 hover:bg-primary-200/50 transition-colors duration-100 cursor-pointer select-none outline-none group`,children:[V(b,{size:16,className:`size-4 text-muted dark:group-hover:text-primary-500 group-hover:text-primary-400`}),V(`span`,{className:`ml-2`,children:`Copy Markdown`})]}),H(M.Item,{onAction:a,className:`flex items-center gap-2 px-3 py-2 rounded-lg text-xs font-medium text-body dark:hover:bg-primary-300/50 hover:bg-primary-200/50 transition-colors duration-100 cursor-pointer select-none outline-none group`,children:[V(y,{size:16,className:`size-4 text-muted dark:group-hover:text-primary-500 group-hover:text-primary-400`}),V(`span`,{className:`ml-2`,children:`View as Markdown`})]})]})]})]})}):null}function ze({children:e,fallback:t}){return V(te,{fallback:t,children:e})}async function Be(e,t,n=`https://api.github.com`){let r=new Headers;t&&r.append(`authorization`,t);let i=await(await fetch(`${n}/repos/${e}`,{headers:r})).json();return i.stargazers_count===void 0?`0`:Ve(i.stargazers_count)}const Ve=e=>Intl.NumberFormat(`en`,{notation:`compact`,compactDisplay:`short`}).format(e);function He({repo:e}){let[t,n]=z(null);return L(()=>{e&&Be(e).then(e=>n(e)).catch(()=>n(`0`))},[e]),H(`a`,{href:`https://github.com/${e}`,target:`_blank`,rel:`noopener noreferrer`,className:`inline-flex items-center gap-2 rounded-xl border border-subtle bg-surface px-3 py-1.5 text-xs font-semibold text-muted dark:hover:bg-primary-300/50 hover:bg-primary-200/50 transition-colors duration-100 hover:border-primary-500/50 hover:text-body select-none outline-none`,children:[V(C,{className:`h-4 w-4 text-body`}),t!==null&&H(`span`,{className:`tabular-nums font-medium`,children:[t,` stars`]})]})}function G(e,t){return e?typeof e==`string`?e:t&&e[t]?e[t]:Object.values(e)[0]||``:``}function K(){let e=x(),{theme:t,resolvedTheme:n}=P(),r=I(),{currentLocale:i}=p(),a=e.theme||{},o=G(a.title,i)||`Boltdocs`,s=a.navbar||[],c=a.socialLinks||[],l=a.githubRepo,u=R(()=>s.map(t=>{let n=t.href||t.to||t.link||``,a=t=>{let n=r.pathname;if(n===t)return!0;if(!t||t===`/`)return n===`/`;let i=t=>{let n=t.split(`/`).filter(Boolean),r=0;return e.i18n?.locales&&n[r]&&e.i18n.locales[n[r]]&&r++,e.versions?.versions&&n[r]&&e.versions.versions.some(e=>e.path===n[r])&&r++,n.slice(r)},a=i(t),o=i(n);return a.length===0?o.length===0:o.length<a.length?!1:a.every((e,t)=>o[t]===e)},o=(e=>{if(!(!e||e.length===0))return e.map(e=>{let t=e.href||e.to||e.link||``;return{label:G(e.label||e.text,i),href:t,active:a(t),to:t.startsWith(`http`)||t.startsWith(`//`)?`external`:void 0}})})(t.items);return{label:G(t.label||t.text,i),href:n,active:a(n),to:n.startsWith(`http`)||n.startsWith(`//`)?`external`:void 0,items:o}}),[s,r.pathname,i,e]),d=a.logo;return{links:u,title:o,logo:d?typeof d==`string`?d:n===`dark`?d.dark:d.light:null,logoProps:{alt:(d&&typeof d==`object`?d.alt:void 0)||o,width:d&&typeof d==`object`?d.width:void 0,height:d&&typeof d==`object`?d.height:void 0},github:l?`https://github.com/${l}`:null,social:c,config:e,theme:t}}function Ue(){let{theme:e,setTheme:t}=P(),[n,r]=z(!1);if(L(()=>{r(!0)},[]),!n)return V(`div`,{className:`h-9 w-9`});let a=e===`system`?d:e===`dark`?i:o;return H(M.Trigger,{placement:`bottom right`,children:[V(De,{className:`flex h-9 w-9 items-center justify-center rounded-xl text-muted transition-colors hover:bg-surface hover:text-body outline-none border-none bg-transparent cursor-pointer`,"aria-label":`Selection theme`,children:V(a,{size:20,className:`animate-in fade-in zoom-in duration-300`})}),H(M.Root,{selectionMode:`single`,selectedKeys:[e],onSelectionChange:e=>{let n=Array.from(e)[0];t(n)},className:`w-36 bg-main border border-subtle rounded-xl p-1.5 shadow-md outline-none flex flex-col gap-0.5 animate-fade-in z-100`,children:[H(M.Item,{id:`light`,className:`group flex items-center gap-2 px-3 py-2 rounded-lg text-xs font-medium text-body dark:hover:bg-primary-300/50 hover:bg-primary-200/50 transition-colors duration-100 cursor-pointer select-none outline-none group data-selected:text-primary-500 data-selected:bg-primary-500/5`,children:[V(o,{className:`group-hover:text-primary-500 dark:group-hover:text-primary-200`,size:16}),V(`span`,{className:`ml-2`,children:`Light`})]}),H(M.Item,{id:`dark`,className:`flex items-center gap-2 px-3 py-2 rounded-lg text-xs font-medium text-body dark:hover:bg-primary-300/50 hover:bg-primary-200/50 transition-colors duration-100 cursor-pointer select-none outline-none group data-selected:text-primary-500 data-selected:bg-primary-500/5`,children:[V(i,{className:`group-hover:text-primary-500 dark:group-hover:text-primary-200`,size:16}),V(`span`,{className:`ml-2`,children:`Dark`})]}),H(M.Item,{id:`system`,className:`flex items-center gap-2 px-3 py-2 rounded-lg text-xs font-medium text-body dark:hover:bg-primary-300/50 hover:bg-primary-200/50 transition-colors duration-100 cursor-pointer select-none outline-none group data-selected:text-primary-500 data-selected:bg-primary-500/5`,children:[V(d,{className:`group-hover:text-primary-500 dark:group-hover:text-primary-200`,size:16}),V(`span`,{className:`ml-2`,children:`System`})]})]})]})}function We({className:e}){let{theme:t,setTheme:n}=P(),[r,a]=z(!1);if(L(()=>{a(!0)},[]),!r)return V(`div`,{className:T(`h-10 w-full bg-surface rounded-xl animate-pulse`,e)});let s=t===`dark`;return H(`div`,{className:T(`flex p-1 bg-surface border border-subtle rounded-xl relative w-full h-11`,e),children:[V(`div`,{className:T(`absolute inset-y-1 w-[calc(50%-4px)] bg-main border border-subtle rounded-lg transition-all duration-300 ease-out shadow-xs`,s?`translate-x-full`:`translate-x-0`)}),V(`button`,{onClick:()=>n(`light`),className:T(`flex-1 flex items-center justify-center rounded-lg z-10 transition-colors outline-none cursor-pointer border-none bg-transparent`,s?`text-muted hover:text-body`:`text-body font-semibold`),"aria-label":`Light mode`,children:V(o,{size:18})}),V(`button`,{onClick:()=>n(`dark`),className:T(`flex-1 flex items-center justify-center rounded-lg z-10 transition-colors outline-none cursor-pointer border-none bg-transparent`,s?`text-body font-semibold`:`text-muted hover:text-body`),"aria-label":`Dark mode`,children:V(i,{size:18})})]})}function Ge(e=[],t=[]){let n=I(),r=Ee([]),[i,a]=z({opacity:0,transform:`translateX(0) scaleX(0)`,width:0}),o=h(n.pathname),s=t.find(e=>h(e.path)===o)?.tab?.toLowerCase(),c=e.findIndex(e=>e.id.toLowerCase()===s),l=c===-1?0:c;return L(()=>{let e=r.current[l];e&&a({opacity:1,width:e.offsetWidth,transform:`translateX(${e.offsetLeft}px)`})},[l,e.length,n.pathname]),{tabs:e,activeIndex:l,indicatorStyle:i,tabRefs:r,activeTabId:s}}function Ke({tabs:e,routes:t}){let{currentLocale:n}=p(),{indicatorStyle:r,tabRefs:i,activeIndex:a}=Ge(e,t);L(()=>{let e=i.current[a];e&&e.scrollIntoView({behavior:`smooth`,block:`nearest`,inline:`center`})},[a]);let o=e=>{if(!e)return null;if(e.trim().startsWith(`<svg`))return V(`span`,{className:`h-4 w-4`,dangerouslySetInnerHTML:{__html:e}});let t={...m,...Oe},n=t[e]||t[e+`Icon`];return n?V(n,{size:16}):V(`img`,{src:e,alt:``,className:`h-4 w-4 object-contain`})};return V(`div`,{className:`mx-auto max-w-(--breakpoint-3xl) px-4 md:px-6 select-none`,children:H(ne.List,{className:`border-none py-0 scrollbar-hide relative flex flex-row items-center`,children:[e.map((e,r)=>{let s=r===a,c=t.find(t=>t.tab&&t.tab.toLowerCase()===e.id.toLowerCase());return H(g,{href:c?c.path:`#`,ref:e=>{i.current[r]=e},className:`relative flex items-center gap-2 px-4 py-3.5 text-sm font-semibold transition-colors duration-300 outline-none whitespace-nowrap ${s?`text-primary-500`:`text-muted hover:text-body`}`,children:[o(e.icon),V(`span`,{children:G(e.text,n)})]},e.id)}),V(ne.Indicator,{style:r,className:`h-0.5 bg-primary-500 rounded-full transition-all duration-300`})]})})}function q(e,t,n){let r=e;return t&&(r===t||r.startsWith(t+`/`))&&(r=r===t?`index.md`:r.slice(t.length+1)),n&&(r===n||r.startsWith(n+`/`))&&(r=r===n?`index.md`:r.slice(n.length+1)),r}function qe(){let t=ye(),n=x(),{allRoutes:r,currentRoute:i,currentVersion:a,currentLocale:o}=p(),s=n.versions,{setVersion:c}=e();return{currentVersion:a,currentVersionLabel:s?.versions?.find?.(e=>e.path===a)?.label||a,availableVersions:R(()=>s?s.versions.map(e=>({key:e.path,label:e.label,value:e.path,isCurrent:e.path===a})):[],[s,a]),handleVersionChange:e=>{if(!s||e===a)return;c(e);let l=`${(n.base||`/docs`).replace(/\/$/,``)}/${e}${o?`/${o}`:``}`;if(i){let t=q(i.filePath,i.version,i.locale),a=r.find(r=>q(r.filePath,r.version,r.locale)===t&&(r.version||s.defaultVersion)===e&&(!n.i18n||(r.locale||n.i18n.defaultLocale)===o));if(a)l=a.path;else{let t=r.find(t=>q(t.filePath,t.version,t.locale)===`index.md`&&(t.version||s.defaultVersion)===e&&(!n.i18n||(t.locale||n.i18n.defaultLocale)===o));t&&(l=t.path)}}else{let t=r.find(t=>(t.version||s.defaultVersion)===e&&(!n.i18n||(t.locale||n.i18n.defaultLocale)===o));t&&(l=t.path)}t(l)}}}function Je(){let t=ye(),n=x(),{allRoutes:r,currentRoute:i,currentLocale:a,currentVersion:o}=p(),s=n.i18n,{setLocale:c}=e(),l=e=>{if(!s||e===a)return;c(e);let l=n.base||`/`,u=l===`/`?``:l.replace(/\/$/,``),d=!!i?.filePath,f=``;if(i)if(d){let t=q(i.filePath,i.version,i.locale),n=r.find(n=>q(n.filePath,n.version,n.locale)===t&&(n.locale||s.defaultLocale)===e&&n.version===i.version);if(n)f=n.path;else{let t=r.find(t=>q(t.filePath,t.version,t.locale)===`index.md`&&(t.locale||s.defaultLocale)===e&&t.version===i.version);f=t?t.path:`${u}${i.version?`/${i.version}`:``}${e===s.defaultLocale?``:`/${e}`}`||`/`}}else{let t=i.path,n=t.split(`/`).filter(Boolean);if(n.length>0&&(Array.isArray(s.locales)?s.locales.includes(n[0]):s.locales[n[0]])&&(n.shift(),t=`/`+n.join(`/`)),e===s.defaultLocale)f=t===``?`/`:t;else{let n=t.startsWith(`/`)?t:`/${t}`;f=`/${e}${n===`/`?``:n}`}}else{let t=r.find(t=>(t.locale||s.defaultLocale)===e&&(t.version||n.versions?.defaultVersion)===(o||n.versions?.defaultVersion));if(t)f=t.path;else{let t=o&&o!==n.versions?.defaultVersion?`/${o}`:``;f=e===s.defaultLocale?`${u}${t}`:`${u}${t}/${e}`}}(!f||f===``)&&(f=`/`),f=f.replace(/\/+/g,`/`),t(f)},u=s?.locales,d=u?Array.isArray(u)?a:u[a]:void 0;return{currentLocale:a,currentLocaleLabel:s?.localeConfigs?.[a]?.label||d||a,availableLocales:R(()=>s?Array.isArray(s.locales)?s.locales.map(e=>({key:e,label:s?.localeConfigs?.[e]?.label||e,value:e,isCurrent:e===a})):Object.entries(s.locales).map(([e,t])=>({key:e,label:s?.localeConfigs?.[e]?.label||t,value:e,isCurrent:e===a})):[],[s,a]),handleLocaleChange:l}}function J({className:e}){let{currentVersionLabel:t,availableVersions:n,handleVersionChange:r}=qe();return n.length===0?null:H(M.Trigger,{children:[H(E,{className:T(`flex h-9 items-center justify-between gap-2 border border-subtle bg-surface px-4 py-1.5 rounded-xl text-xs font-semibold text-body hover:bg-primary-50/20 hover:border-primary-500/50 transition-all duration-300 outline-none select-none cursor-pointer`,e),children:[V(`span`,{className:`font-semibold text-[0.8125rem]`,children:t}),V(u,{className:`w-3.5 h-3.5 text-muted/60`})]}),V(M.Root,{className:`w-40 bg-main border border-subtle rounded-xl p-1.5 shadow-md outline-none flex flex-col gap-0.5 animate-fade-in z-100`,children:V(M.Section,{items:n,children:e=>V(M.Item,{onPress:()=>r(e.value),className:`flex items-center gap-2 px-3 py-2 rounded-lg text-xs font-medium text-body hover:bg-primary-50/50 cursor-pointer select-none outline-none group data-selected:text-primary-500 data-selected:bg-primary-500/5`,children:e.label},`${e.value??``}`)})})]})}function Ye({className:e}){let{currentLocale:t,availableLocales:n,handleLocaleChange:r}=Je();return n.length===0?null:H(M.Trigger,{children:[H(E,{className:T(`flex h-9 items-center justify-between gap-2 border border-subtle bg-surface px-4 py-1.5 rounded-xl text-xs font-semibold text-body hover:bg-primary-50/20 hover:border-primary-500/50 transition-all duration-300 outline-none select-none cursor-pointer`,e),children:[H(`div`,{className:`flex items-center gap-1.5`,children:[V(s,{className:`w-3.5 h-3.5 text-primary-500`}),V(`span`,{className:`font-bold text-[0.75rem] uppercase opacity-90`,children:t||`en`})]}),V(u,{className:`w-3.5 h-3.5 text-muted/60`})]}),V(M.Root,{className:`w-40 bg-main border border-subtle rounded-xl p-1.5 shadow-md outline-none flex flex-col gap-0.5 animate-fade-in z-100`,children:V(M.Section,{items:n,children:e=>V(M.Item,{onPress:()=>r(e.value),className:`flex items-center gap-2 px-3 py-2 rounded-lg text-xs font-medium text-body dark:hover:bg-primary-300/50 hover:bg-primary-200/50 transition-colors duration-100 cursor-pointer select-none outline-none group data-selected:text-primary-500 data-selected:bg-primary-500/5`,children:V(`span`,{children:e.label})},`${e.value??``}`)})})]})}const Xe=Se(()=>import(`../search-dialog-ByvGScjt.js`).then(e=>({default:e.SearchDialog})));function Ze(){let{links:e,title:n,logo:r,logoProps:i,github:o,social:s,config:c}=K(),{routes:l,allRoutes:u,currentRoute:d,currentVersion:f,currentLocale:m}=p(),{pathname:h}=I(),{isSidebarOpen:g,toggleSidebar:_}=O(),[v,y]=z(!1),b=c.theme||{},x=!!d?.filePath,S=b?.tabs&&b.tabs.length>0;return H(F.Root,{className:T(`border-b border-subtle bg-main/80 backdrop-blur-md`,S&&`border-b-0`),children:[H(F.Content,{children:[H(F.Left,{children:[x&&V(E,{onPress:_,className:`mr-2 lg:hidden p-1.5 h-8 w-8 flex items-center justify-center bg-transparent border-none outline-none select-none cursor-pointer rounded-xl hover:bg-primary-50/50 transition-colors`,"aria-label":g?`Close sidebar`:`Open sidebar`,children:V(g?a:t,{className:`w-5 h-5 text-body`})}),r&&V(F.Logo,{src:r,alt:i?.alt||n,width:i?.width??24,height:i?.height??24,href:`site:/`}),V(F.Title,{href:`site:/`,children:n}),V(`div`,{className:`hidden sm:block`,children:c.versions&&f&&V(J,{})})]}),V(F.Center,{children:V(be,{fallback:V(`div`,{className:`h-9 w-32 animate-pulse rounded-md bg-surface`}),children:V(Xe,{routes:l||[]})})}),H(F.Right,{children:[V(be,{fallback:null,children:V(`div`,{className:`lg:hidden`,children:V(Xe,{routes:l||[]})})}),V(F.Links,{children:e.map(e=>V(Qe,{link:e},e.href))}),H(`div`,{className:`hidden sm:flex items-center gap-2`,children:[c.i18n&&m&&V(Ye,{}),V(F.Split,{className:`bg-subtle`})]}),V(`div`,{className:`hidden md:block`,children:V(Ue,{})}),o&&V(`div`,{className:`hidden md:block`,children:V(He,{repo:b?.githubRepo??``})}),s.length>0&&V(`div`,{className:`hidden md:block`,children:V(F.Split,{className:`bg-subtle`})}),V(`div`,{className:`hidden md:flex items-center gap-1`,children:s.map(({icon:e,link:t})=>V(F.Socials,{icon:e,link:t,className:`p-1.5 text-muted hover:text-body hover:bg-surface rounded-md transition-all focus-visible:ring-2 focus-visible:ring-primary-500/30`},t))}),V(F.More,{onPress:()=>y(!0),className:`text-muted hover:text-body active:scale-90 transition-all focus-visible:ring-2 focus-visible:ring-primary-500/30`})]})]}),H(F.MobileMenu,{isOpen:v,onClose:()=>y(!1),className:`bg-main/98 backdrop-blur-2xl`,children:[V(`div`,{className:`flex flex-col gap-1`,children:e.map(e=>V($e,{link:e,onClose:()=>y(!1)},e.href))}),s.length>0&&H(`div`,{className:`mt-6`,children:[V(`div`,{className:`px-4 mb-4 text-xs font-bold uppercase tracking-widest text-muted/50`,children:`Connect`}),V(`div`,{className:`flex flex-wrap gap-2 px-2`,children:s.map(({icon:e,link:t})=>V(F.Socials,{icon:e,link:t,className:`p-3 bg-surface border border-subtle rounded-xl flex-1 justify-center`},t))})]})]}),x&&S&&b?.tabs&&V(`div`,{className:`w-full border-b border-subtle bg-main`,children:V(Ke,{tabs:b.tabs,routes:u||l||[]})})]})}function Qe({link:e}){let t=_(e.href||``),{pathname:n}=I(),r=n===t||n.startsWith(t+`/`);return e.items&&e.items.length>0?V(F.Dropdown,{label:V(`span`,{className:T(`transition-colors outline-none font-medium focus-visible:ring-2 focus-visible:ring-primary-500/30 rounded-sm px-2 py-1`,r?`text-primary-500`:`text-muted hover:text-body`),children:e.label}),children:e.items?.map(e=>V(F.DropdownItem,{href:_(e.href||``),label:e.label},e.href))}):V(F.Link,{...e,href:t,active:r,className:T(`transition-colors outline-none font-medium focus-visible:ring-2 focus-visible:ring-primary-500/30 rounded-sm`,r?`text-primary-500`:`text-muted hover:text-body`)})}function $e({link:e,onClose:t}){let n=_(e.href||``),{pathname:r}=I(),i=r===n;return e.items&&e.items.length>0?H(`div`,{className:`flex flex-col gap-1`,children:[V(`div`,{className:T(`px-3 py-2 text-sm transition-all`,i?`text-body`:`text-muted/80 hover:text-body`),children:e.label}),V(`div`,{className:`flex flex-col gap-1 pl-4`,children:e.items?.map(e=>V($e,{link:e,onClose:t},e.href))})]}):V(F.MobileLink,{...e,href:n,active:i,onPress:t,className:T(`transition-all`,i?`text-body`:`text-muted/80 hover:text-body`)})}function Y(){return V(`div`,{className:`flex items-center justify-center min-h-[65vh] text-center px-4`,children:H(`div`,{className:`space-y-6 max-w-md mx-auto p-8 border border-subtle bg-surface rounded-2xl shadow-xs`,children:[V(`span`,{className:`block text-7xl font-extrabold tracking-tight text-primary-500`,children:`404`}),H(`div`,{className:`space-y-2`,children:[V(`h1`,{className:`text-xl font-bold text-body`,children:`Page Not Found`}),V(`p`,{className:`text-sm text-muted leading-relaxed`,children:`The page you're looking for doesn't exist or has been moved.`})]}),H(g,{href:`/`,className:`inline-flex items-center gap-2 rounded-xl border border-subtle bg-main px-6 py-2.5 text-xs font-semibold text-body hover:bg-primary-50/50 hover:border-primary-500/50 transition-all duration-300 outline-none select-none`,children:[V(n,{size:14}),` Go to Home`]})]})})}function et({headings:e=[],editLink:t,communityHelp:n,filePath:r}){return e.length===0?null:H(k.Root,{children:[H(k.Header,{className:`flex flex-row gap-x-2`,children:[V(S,{size:16}),`On this page`]}),V(k.Tree,{headings:e}),(t||n)&&H(`div`,{className:`mt-8 pt-8 border-t border-subtle space-y-4`,children:[V(`p`,{className:`text-xs font-bold text-body`,children:`Need help?`}),H(`ul`,{className:`space-y-3`,children:[t&&r&&V(`li`,{children:H(`a`,{href:t.replace(`:path`,r),target:`_blank`,rel:`noopener noreferrer`,className:`flex items-center gap-2 text-sm text-muted hover:text-body transition-colors`,children:[V(f,{size:16}),`Edit this page`]})}),n&&V(`li`,{children:H(`a`,{href:n,target:`_blank`,rel:`noopener noreferrer`,className:`flex items-center gap-2 text-sm text-muted hover:text-body transition-colors`,children:[V(c,{size:16}),`Community help`]})})]})]})]})}function tt(){let{routes:e,currentRoute:t}=p(),n=I();return R(()=>{if(!t)return{prevPage:null,nextPage:null,currentRoute:null};let r=t.tab?.toLowerCase(),i=r?e.filter(e=>e.tab?.toLowerCase()===r):e.filter(e=>!e.tab),a=i.findIndex(e=>e.path===n.pathname);return{prevPage:a>0?i[a-1]:null,nextPage:a!==-1&&a<i.length-1?i[a+1]:null,currentRoute:t}},[e,t,n.pathname])}function nt(){let{prevPage:e,nextPage:t}=tt();return!e&&!t?null:H(A.Root,{className:`pt-8 border-t border-subtle grid sm:grid-cols-2 gap-4 animate-in fade-in slide-in-from-bottom-4 duration-700 select-none`,children:[e?H(A.Link,{to:e.path,direction:`prev`,className:`group border border-subtle bg-surface p-5 rounded-2xl transition-all duration-300 hover:border-primary-500/50 hover:bg-primary-50/20`,children:[V(A.Title,{className:`text-xs font-bold uppercase tracking-wider text-muted/60 mb-1`,children:`Previous`}),V(A.Description,{className:`text-sm sm:text-base font-bold text-body group-hover:text-primary-500 transition-colors`,children:e.title})]}):V(`div`,{}),t?H(A.Link,{to:t.path,direction:`next`,className:`group border border-subtle bg-surface p-5 rounded-2xl transition-all duration-300 hover:border-primary-500/50 hover:bg-primary-50/20`,children:[V(A.Title,{className:`text-xs font-bold uppercase tracking-wider text-muted/60 mb-1`,children:`Next`}),V(A.Description,{className:`text-sm sm:text-base font-bold text-body group-hover:text-primary-500 transition-colors`,children:t.title})]}):V(`div`,{})]})}function rt({routes:e,config:t}){let{logo:n,title:r,logoProps:i}=K(),{closeSidebar:o}=O(),s=n?V(`img`,{src:n,alt:i?.alt||r,width:24,height:24,className:`rounded-xl`}):null,c=t.versions||t.i18n;return H(B,{children:[V(j.Root,{children:V(j.Content,{children:V(j.Items,{routes:e})})}),H(j.Mobile,{children:[H(j.Header,{children:[H(`div`,{className:`flex items-center gap-3`,children:[s,V(`span`,{className:`font-bold text-lg tracking-tight text-body truncate max-w-[120px]`,children:r})]}),H(`div`,{className:`flex items-center gap-2`,children:[V(We,{className:`w-24 h-9 rounded-xl`}),V(E,{onPress:o,className:`h-9 w-9 flex items-center justify-center bg-transparent border-none outline-none select-none cursor-pointer rounded-xl hover:bg-primary-50/50 text-muted hover:text-body transition-colors`,"aria-label":`Close sidebar`,children:V(a,{size:20})})]})]}),H(j.Content,{children:[c&&H(`div`,{className:`flex flex-col gap-4 mb-10`,children:[H(`div`,{className:`flex gap-3`,children:[t.versions&&V(J,{className:`flex-1 justify-between h-10 bg-surface border-subtle rounded-xl`}),t.i18n&&V(Ye,{className:`flex-1 justify-between h-10 bg-surface border-subtle rounded-xl`})]}),V(`div`,{className:`mt-2 border-b border-subtle`})]}),V(j.Items,{routes:e})]})]})]})}const it=Object.assign(rt,{Root:j.Root,Mobile:j.Mobile,Header:j.Header,Content:j.Content,Group:j.Group,Link:j.Link,SubGroup:j.SubGroup,Item:j.Item,Items:j.Items});function at({date:e}){if(!e)return null;let t=new Date(e);if(isNaN(t.getTime()))return null;let n=t.toLocaleDateString(void 0,{year:`numeric`,month:`long`,day:`numeric`});return H(`div`,{className:`mt-16 pt-6 border-t border-subtle flex items-center justify-between text-xs text-muted select-none`,children:[V(`span`,{}),H(`span`,{className:`italic`,children:[`Last updated on `,n]})]})}function ot({route:e,content:t,mdxComponents:n}){let r=W(),i=R(()=>({LastUpdated:at,...r,...n}),[r,n]),a=i.LastUpdated||at;return t?H(B,{children:[V(t,{components:i}),e?.lastUpdated&&V(a,{date:e.lastUpdated})]}):null}function st({MDXComponent:e,mdxComponents:t}){let n=ve(),r=e||n?.MDXComponent,i=t||n?.mdxComponents;return r?V(ot,{route:{path:n.path,filePath:n.filePath,title:n.frontmatter.title,description:n.frontmatter.description,headings:n.headings,locale:n.locale,version:n.version,group:n.group,groupTitle:n.groupTitle,lastUpdated:n.lastUpdated,frontmatter:n.frontmatter},content:r,mdxComponents:i}):null}const X=ke,ct=X.Helmet||X.default?.Helmet||(({children:e})=>V(B,{children:e})),lt=X.HelmetProvider||X.default?.HelmetProvider||(({children:e})=>V(B,{children:e}));function ut(){let{pathname:e,hash:t}=I(),n=(e=`auto`)=>{let n=document.querySelector(`.boltdocs-content`)||window,r=()=>n===window?window.scrollY:n.scrollTop,i=(e,t)=>{n===window?window.scrollTo({top:e,behavior:t}):n.scrollTo({top:e,behavior:t})};if(t){let a=t.replace(`#`,``),o=document.getElementById(a);if(o){let t=n===window?0:n.getBoundingClientRect().top;return i(o.getBoundingClientRect().top-t-80+r(),e),!0}}return i(0,e),!1};return Te(()=>{n(`auto`)},[e,t]),L(()=>{n(`auto`);let e=requestAnimationFrame(()=>{n(`auto`),window.dispatchEvent(new Event(`resize`))});return()=>cancelAnimationFrame(e)},[e,t]),null}const dt={...he,NotFound:Y,404:Y};function Z(e){return e.endsWith(`/`)&&e.length>1?e.slice(0,-1):e}function ft({config:t}){let{currentLocale:n}=e();return L(()=>{if(!t.i18n||typeof document>`u`)return;let e=n||t.i18n.defaultLocale,r=t.i18n.localeConfigs?.[e];document.documentElement.lang=r?.htmlLang||e||`en`,document.documentElement.dir=r?.direction||`ltr`},[n,t.i18n]),null}function pt({config:t,routeMap:n}){let r=I(),{setLocale:i,setVersion:a}=e();return L(()=>{let e=Z(r.pathname),o=n.get(e);o&&(t.i18n&&i(o.locale||t.i18n.defaultLocale),t.versions&&a(o.version||t.versions.defaultVersion))},[r.pathname,t,n,i,a]),null}function mt({config:e,routes:t,components:n={}}){let r=R(()=>({...dt,...Ae,...n}),[n]),{pathname:i}=I(),a=R(()=>Z(i||`/`),[i]),o=R(()=>{let e=new Map;for(let n of t){let t=Z(n.path===``?`/`:n.path);e.set(t,n)}return e},[t]),s=R(()=>{let t=o.get(a),n,r;return t&&(e.i18n&&(n=t.locale||e.i18n.defaultLocale),e.versions&&(r=t.version||e.versions.defaultVersion)),{initLocale:n,initVersion:r}},[a,e,o]);return V(lt,{children:V(v,{routes:t,children:V(ce,{children:V(se,{children:V(Pe,{components:r,children:H(w.Provider,{value:e,children:[V(ut,{}),H(l,{initialLocale:s.initLocale,initialVersion:s.initVersion,children:[V(pt,{config:e,routeMap:o}),V(ft,{config:e}),V(_e,{})]})]})})})})})})}function ht({siteTitle:e,siteDescription:t,routes:n}){let r=I(),i=x(),{currentLocale:a}=p(),o=R(()=>n?.find?.(e=>e.path===r.pathname),[n,r.pathname]),s=o?.title,c=G(t,a),l=o?.description||c||``,u=G(e,a),d=s?`${s} | ${u}`:u,f=o?.seo||{},m=i?.seo?.metatags||{},h=i?.seo?.thumbnails?.background,g=f[`og:image`]||h;return H(ct,{children:[V(`title`,{children:d}),V(`meta`,{name:`description`,content:l}),V(`meta`,{property:`og:title`,content:d}),V(`meta`,{property:`og:description`,content:l}),V(`meta`,{property:`og:type`,content:`article`}),typeof window<`u`&&V(`meta`,{property:`og:url`,content:window.location.href}),typeof window<`u`&&V(`link`,{rel:`canonical`,href:window.location.origin+r.pathname}),V(`meta`,{name:`twitter:card`,content:`summary`}),V(`meta`,{name:`twitter:title`,content:d}),V(`meta`,{name:`twitter:description`,content:l}),g&&V(`meta`,{name:`twitter:image`,content:g}),g&&V(`meta`,{property:`og:image`,content:g}),V(`meta`,{name:`generator`,content:`Boltdocs`}),Object.entries(m).map(([e,t])=>e.startsWith(`og:`)||e.startsWith(`music:`)||e.startsWith(`video:`)||e.startsWith(`article:`)||e.startsWith(`book:`)||e.startsWith(`profile:`)?V(`meta`,{property:e,content:t},e):V(`meta`,{name:e,content:t},e)),Object.entries(f).map(([e,t])=>e===`noindex`&&t===!0?V(`meta`,{name:`robots`,content:`noindex`},`noindex`):e===`robots`?V(`meta`,{name:`robots`,content:t},`robots`):e===`canonical`?V(`link`,{rel:`canonical`,href:t},`canonical`):e.startsWith(`og:`)||e.startsWith(`music:`)||e.startsWith(`video:`)||e.startsWith(`article:`)||e.startsWith(`book:`)||e.startsWith(`profile:`)?V(`meta`,{property:e,content:t},e):V(`meta`,{name:e,content:t},e))]})}function gt(){let e=x(),{currentRoute:t,allRoutes:n}=p();return H(B,{children:[V(ht,{siteTitle:e.theme?.title,siteDescription:e.theme?.description,routes:n||[]}),V(je,{route:t,children:V(_e,{})})]})}const _t=()=>V(`div`,{className:`text-muted text-sm py-4`,children:`Loading...`}),vt=({moduleLoader:e,moduleKey:t,route:n,components:r})=>{let i=e?.default??e??null;return L(()=>{if(!import.meta.hot||!t)return;let e=e=>{e.relPath.replace(/\\/g,`/`).replace(/^\//,``)===n.filePath.replace(/\\/g,`/`).replace(/^\//,``)&&import(t+`?t=`+Date.now()).then(e=>{})};return import.meta.hot.on(`boltdocs:mdx-update`,e),()=>import.meta.hot?.off(`boltdocs:mdx-update`,e)},[t,n.filePath]),i?V(st,{MDXComponent:i,mdxComponents:r}):V(_t,{})},yt=()=>{let e=W();return V(e.NotFound||e[404]||Y,{})};function bt(e){let{routesData:t,config:n,mdxModules:r,externalPages:i,externalLayout:a,components:o}=e,s=a||(({children:e})=>V(B,{children:e})),c=e=>{let t=n.base||`/`;return e.startsWith(t)?e:`${t===`/`?``:t.replace(/\/$/,``)}${e.startsWith(`/`)?e:`/${e}`}`||`/`},l=[],u=n.versions?.defaultVersion,d=(n.base||`/docs`).replace(/\/$/,``),f=(n.base||`/docs`).replace(/\/$/,``);f||=`/`,u&&t.forEach(e=>{if(e.version)return;let t=e.path||``,n=t.startsWith(d)?t.substring(d.length).replace(/^\//,``):t.replace(/^\//,``);if(!(n===u||n.startsWith(`${u}/`))){let t=`${d}/${u}/${n}`.replace(/\/+/g,`/`).replace(/\/$/,``)||`/`;l.push({...e,path:t,version:u})}});let p=[...t,...l],m=new Map,h=Object.keys(r);if(h.length>0){let e=h[0].replace(/\\/g,`/`).split(`/`).filter(Boolean)[0]||`docs`,t=`/${e}/`,n=`./${e}/`;for(let e of h){let r=e.replace(/\\/g,`/`),i=``;r.indexOf(t)===-1?r.startsWith(n)&&(i=r.substring(n.length)):i=r.substring(r.indexOf(t)+t.length),i?m.set(i,e):m.set(r,e)}}let g=p.map(e=>{let t=e.filePath.replace(/\\/g,`/`),n=m.get(t),i=n?r[n]:null,a=c(e.path===``?`/`:e.path),s=a===f?`.`:a.startsWith(f+`/`)?a.slice(f.length+1):a;return{path:s,element:V(vt,{moduleKey:n,moduleLoader:i,route:e,components:o},n||s),loader:async()=>({path:s,frontmatter:{title:e.title,description:e.description||``,...e.frontmatter||{}},headings:e.headings||[],filePath:e.filePath,locale:e.locale,version:e.version,group:e.group,groupTitle:e.groupTitle,date:e.date,lastUpdated:e.lastUpdated}),getStaticPaths:()=>[s]}}),_=n.i18n?.locales?Array.isArray(n.i18n.locales)?n.i18n.locales:Object.keys(n.i18n.locales):[],v=n.versions?.versions?.map(e=>e.path)||[],y=[];y.push({path:f,filter:()=>!0});let b=[];v.length>0&&v.forEach(e=>b.push(`/${e}`)),_.length>0&&_.forEach(e=>b.push(`/${e}`)),v.length>0&&_.length>0&&v.forEach(e=>{_.forEach(t=>{b.push(`/${e}/${t}`)})}),b.forEach(e=>{let t=f===`/`?e:`${f}${e}`;y.push({path:t,filter:e=>e.startsWith(t.replace(/\/$/,``)+`/`)})});let x=new Set(g.map(e=>(e.path||``).replace(/\/$/,``))),S=new Set;i&&Object.keys(i).forEach(e=>{let t=e.startsWith(`/`)?e:`/${e}`;S.add(t.replace(/\/$/,``)),n.i18n&&Object.keys(n.i18n.locales).forEach(e=>{S.add(`/${e}${t===`/`?``:t}`.replace(/\/$/,``))})}),y.forEach(({path:e,filter:t})=>{if(e===`/`)return;let r=e.replace(/\/$/,``);if(!(x.has(r)||S.has(r))){let i=n.theme?.tabs?.[0]?.id,a=i?`${r}/${i}`.replace(/\/+/g,`/`):null,o=a&&x.has(a.replace(/\/$/,``))?g.find(e=>e.path.replace(/\/$/,``)===a.replace(/\/$/,``)):g.find(e=>t(e.path)&&e.path!==r);if(!o&&g.length>0&&(o=g[0]),o){let t=e===f?`.`:e.startsWith(f+`/`)?e.slice(f.length+1):e,r=t===`.`;g.push({...r?{index:!0}:{path:t},element:o.element,loader:o.loader,getStaticPaths:()=>[]});let i=p.find(e=>{let t=c(e.path===``?`/`:e.path);return(t===f?`.`:t.startsWith(f+`/`)?t.slice(f.length+1):t)===o.path});if(i){let t=c(i.path),r=n.siteUrl?`${n.siteUrl.replace(/\/$/,``)}${t}`:t;p.push({...i,path:e,filePath:``,slugParts:[],seo:{...i.seo,canonical:r}})}}}});let C=[{path:f,element:V(gt,{}),children:g}],w=[];return i&&Object.entries(i).forEach(([e,t])=>{let r=e.startsWith(`/`)?e:`/${e}`;C.find(e=>e.path===r)||(w.push({path:r,locale:n.i18n?.defaultLocale,title:e===`/`?`Home`:e.replace(/^\//,``).split(`/`).pop()||`Page`,filePath:``,headings:[]}),C.push({path:r,element:V(s,{children:V(t,{})}),loader:async()=>({path:r,locale:n.i18n?.defaultLocale}),getStaticPaths:()=>[r]}),n.i18n&&Object.keys(n.i18n.locales).forEach(n=>{let r=`/${n}${e===`/`?``:e}`;C.find(e=>e.path===r)||(w.push({path:r,locale:n,title:e,filePath:``,headings:[]}),C.push({path:r,element:V(s,{children:V(t,{})}),loader:async()=>({path:r,locale:n}),getStaticPaths:()=>[r]}))}))}),C.push({path:`*`,element:V(s,{children:V(yt,{})})}),[{element:V(mt,{config:n,routes:[...p,...w],components:o}),children:C}]}function Q(e){return typeof window>`u`?$():typeof window.gtag==`function`?xt(e):window.dataLayer?St(e):$()}function xt(e){return{trackPageView:(t,n)=>{window.gtag?.(`event`,`page_view`,{page_path:t,page_title:n||document.title,send_to:e?.ga4?.measurementId})},trackEvent:({action:t,category:n,label:r,value:i,params:a})=>{window.gtag?.(`event`,t,{event_category:n,event_label:r,value:i,send_to:e?.ga4?.measurementId,...a})},trackSearch:(t,n)=>{window.gtag?.(`event`,`search`,{search_term:t,results_count:n,send_to:e?.ga4?.measurementId})},trackDownload:(t,n)=>{window.gtag?.(`event`,`file_download`,{file_name:t,file_type:n||t.split(`.`).pop(),send_to:e?.ga4?.measurementId})},trackExternalLink:t=>{window.gtag?.(`event`,`external_link`,{link_url:t,send_to:e?.ga4?.measurementId})},isEnabled:!0}}function St(e){return{trackPageView:(t,n)=>{window.dataLayer?.push({event:`page_view`,page_path:t,page_title:n||document.title,send_to:e?.gtm?.tagId})},trackEvent:({action:t,category:n,label:r,value:i,params:a})=>{window.dataLayer?.push({event:t,event_category:n,event_label:r,value:i,send_to:e?.gtm?.tagId,...a})},trackSearch:(t,n)=>{window.dataLayer?.push({event:`search`,search_term:t,results_count:n,send_to:e?.gtm?.tagId})},trackDownload:(t,n)=>{window.dataLayer?.push({event:`file_download`,file_name:t,file_type:n||t.split(`.`).pop(),send_to:e?.gtm?.tagId})},trackExternalLink:t=>{window.dataLayer?.push({event:`external_link`,link_url:t,send_to:e?.gtm?.tagId})},isEnabled:!0}}function $(){return{trackPageView:()=>{},trackEvent:()=>{},trackSearch:()=>{},trackDownload:()=>{},trackExternalLink:()=>{},isEnabled:!1}}const Ct=Symbol.for(`__BDOCS_CONFIG_INSTANCE__`);function wt(e={}){let{config:t,autoTrackPageViews:n=!0,autoTrackDownloads:r=!0,autoTrackExternalLinks:i=!0,excludePatterns:a=[]}=e,o=typeof globalThis<`u`?globalThis[Ct]:void 0,s=t??o?.integrations,c=R(()=>Q(s),[s]),l=Ee(``),u=oe();return L(()=>{if(!n||!c.isEnabled)return;let e=u.pathname+u.search;e!==l.current&&(l.current=e,c.trackPageView(e,document.title))},[u.pathname,n,c]),L(()=>{if(!r||!c.isEnabled)return;let e=e=>{let t=e.target?.closest(`a`);if(!t)return;let n=t.getAttribute(`href`);if(n&&!a.some(e=>e.test(n))&&(t.hasAttribute(`download`)||/\.(pdf|doc|docx|xls|xlsx|ppt|pptx|zip|rar|7z|tar|gz|mp3|mp4|avi|mov|png|jpg|jpeg|gif|svg|webp)$/i.test(n))){let e=n.split(`/`).pop()||n;c.trackDownload(e,e.split(`.`).pop())}};return document.addEventListener(`click`,e),()=>document.removeEventListener(`click`,e)},[r,i,c,a]),L(()=>{if(!i||!c.isEnabled)return;let e=e=>{let t=e.target?.closest(`a`);if(!t)return;let n=t.getAttribute(`href`);n&&(a.some(e=>e.test(n))||(n.startsWith(`http://`)||n.startsWith(`https://`)||n.startsWith(`//`))&&!n.includes(window.location.hostname)&&c.trackExternalLink(n))};return document.addEventListener(`click`,e),()=>document.removeEventListener(`click`,e)},[i,c,a]),c}function Tt(){let e=R(()=>Q(),[]);return we((t,n)=>{e.trackPageView(t,n)},[e])}function Et(){let e=R(()=>Q(),[]);return we(t=>{e.trackEvent(t)},[e])}function Dt({children:e}){let{routes:t,currentRoute:n}=p(),r=x();return H(N,{className:`selection:bg-primary-500/10 selection:text-primary-500`,children:[V(Ze,{}),H(N.Body,{className:`bg-main`,children:[V(it,{routes:t||[],config:r}),V(N.Content,{className:`animate-in fade-in duration-500 scroll-smooth`,children:H(N.ContentMdx,{className:`max-w-3xl sm:max-w-4xl lg:max-w-4xl px-2 pt-8 pb-24`,children:[H(N.Header,{children:[H(`div`,{className:`mb-4 border-b border-subtle pb-4 flex flex-wrap items-center justify-between gap-3`,children:[V(Ie,{}),V(Re,{mdxRaw:n?._rawContent,route:n})]}),n?.title&&V(`h1`,{className:`text-4xl font-bold tracking-tight text-default mb-3`,children:n.title}),n?.description&&V(`p`,{className:`text-lg text-muted-foreground mb-6 leading-relaxed`,children:n.description})]}),V(ze,{children:V(`div`,{className:`prose prose-neutral dark:prose-invert max-w-none`,children:e})}),V(N.Footer,{children:V(nt,{})})]})}),V(et,{headings:n?.headings,editLink:r.theme?.editLink,communityHelp:r.theme?.communityHelp,filePath:n?.filePath})]})]})}const Ot=Object.assign(Dt,{Body:N.Body,Content:N.Content,ContentMdx:N.ContentMdx,Header:N.Header,Footer:N.Footer});export{mt as BoltdocsShell,Ie as Breadcrumbs,me as Card,pe as Cards,Re as CopyMarkdown,Ot as DocsLayout,ze as ErrorBoundary,st as MdxPage,Ze as Navbar,Y as NotFound,et as OnThisPage,nt as PageNav,ue as SearchDialog,it as Sidebar,ge as ViteReactSSG,T as cn,fe as copyToClipboard,bt as createRoutes,Be as getStarsRepo,G as getTranslated,de as reactToText,wt as useAnalytics,Fe as useBreadcrumbs,x as useConfig,Je as useI18n,_ as useLocalizedTo,oe as useLocation,W as useMdxComponents,K as useNavbar,tt as usePageNav,p as useRoutes,le as useSearch,ae as useSearchHighlight,ie as useSidebar,Ge as useTabs,P as useTheme,Et as useTrackEvent,Tt as useTrackPageView,O as useUI,qe as useVersion};
+import { $ as useBoltdocsContext, B as Menu, C as ArrowLeft, F as Home, H as Moon, J as X, K as Sun, L as Languages, O as CircleHelp, Q as BoltdocsProvider, T as ChevronDown, V as Monitor, W as Pencil, X as useRoutes, Y as icons_exports, Z as normalizePath$1, _ as Link, b as useLocalizedTo, et as RoutesProvider, j as ExternalLink, k as Copy, nt as useConfig, q as TextAlignStart, s as Github, tt as ConfigContext, w as Check, y as cn } from "../icons-dev-Df8OQ481.js";
+import { D as ErrorBoundary$1, E as Tabs$1, M as Button$1, N as Breadcrumbs$2, T as useUI, _ as OnThisPage$1, h as PageNav$1, i as Sidebar$1, j as ButtonGroup, k as Menu$1, m as useSidebar, n as useSearchHighlight, r as useLocation, t as DocsLayout$2, w as UIProvider } from "../docs-layout-DwFndmj5.js";
+import { c as ThemeProvider, l as useTheme } from "../image-jxPb-2iV.js";
+import { n as Navbar$1 } from "../search-dialog-BNF10tDl.js";
+import { n as useSearch, t as SearchDialog } from "../search-dialog-D-DDN7zJ.js";
+import { a as reactToText, i as copyToClipboard, n as Cards, r as Card, t as mdx_components_default } from "../mdx-UTTLFWJq.js";
+import { ViteReactSSG } from "@bdocs/ssg";
+import { Outlet, useLoaderData, useLocation as useLocation$1, useNavigate } from "react-router-dom";
+import { Suspense, createContext, lazy, use, useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { Button } from "react-aria-components";
+import virtualIcons from "virtual:boltdocs-icons";
+import * as ReactHelmetAsync from "react-helmet-async";
+import virtualCustomComponents from "virtual:boltdocs-mdx-components";
+import UserLayout from "virtual:boltdocs-layout";
+
+//#region src/client/app/mdx-components-context.tsx
+const MDX_COMPONENTS_CONTEXT_SYMBOL = Symbol.for("__BDOCS_MDX_COMPONENTS_CONTEXT__");
+const MDX_COMPONENTS_INSTANCE_SYMBOL = Symbol.for("__BDOCS_MDX_COMPONENTS_INSTANCE__");
+const MdxComponentsContext = globalThis[MDX_COMPONENTS_CONTEXT_SYMBOL] || (globalThis[MDX_COMPONENTS_CONTEXT_SYMBOL] = createContext({}));
+function useMdxComponents() {
+	const context = use(MdxComponentsContext);
+	if ((!context || Object.keys(context).length === 0) && globalThis[MDX_COMPONENTS_INSTANCE_SYMBOL]) return globalThis[MDX_COMPONENTS_INSTANCE_SYMBOL];
+	return context;
+}
+function MdxComponentsProvider({ components, children }) {
+	const processedComponents = useMemo(() => {
+		const processed = {};
+		const frontmatter = {};
+		Object.entries(components).forEach(([key, value]) => {
+			if (key.startsWith("Frontmatter_")) {
+				const cleanKey = key.slice(12);
+				frontmatter[cleanKey] = value;
+			} else processed[key] = value;
+		});
+		processed.Frontmatter = frontmatter;
+		return processed;
+	}, [components]);
+	if (typeof globalThis !== "undefined") globalThis[MDX_COMPONENTS_INSTANCE_SYMBOL] = processedComponents;
+	return /* @__PURE__ */ jsx(MdxComponentsContext.Provider, {
+		value: processedComponents,
+		children
+	});
+}
+
+//#endregion
+//#region src/client/hooks/use-breadcrumbs.ts
+/**
+* Hook to generate breadcrumbs based on the current active route.
+*/
+function useBreadcrumbs() {
+	const { currentRoute: activeRoute } = useRoutes();
+	const crumbs = [];
+	if (activeRoute) {
+		if (activeRoute.groupTitle) crumbs.push({ label: activeRoute.groupTitle });
+		crumbs.push({
+			label: activeRoute.title,
+			href: activeRoute.path
+		});
+	}
+	return {
+		crumbs,
+		activeRoute
+	};
+}
+
+//#endregion
+//#region src/client/components/ui-base/breadcrumbs.tsx
+function Breadcrumbs() {
+	const { crumbs, activeRoute } = useBreadcrumbs();
+	if (crumbs.length === 0) return null;
+	return /* @__PURE__ */ jsxs(Breadcrumbs$2.Root, {
+		className: "gap-2 text-xs sm:text-sm font-medium",
+		children: [/* @__PURE__ */ jsx(Breadcrumbs$2.Item, { children: /* @__PURE__ */ jsx(Breadcrumbs$2.Link, {
+			href: "/",
+			className: "text-muted hover:text-body transition-colors flex items-center",
+			children: /* @__PURE__ */ jsx(Home, { size: 14 })
+		}) }), crumbs.map((crumb, i) => {
+			const isActive = crumb.href === activeRoute?.path;
+			return /* @__PURE__ */ jsxs(Breadcrumbs$2.Item, {
+				className: "gap-2",
+				children: [/* @__PURE__ */ jsx(Breadcrumbs$2.Separator, { className: "text-muted/40" }), /* @__PURE__ */ jsx(Breadcrumbs$2.Link, {
+					href: crumb.href,
+					className: cn("transition-colors", isActive ? "text-body font-semibold cursor-default pointer-events-none" : "text-muted hover:text-body"),
+					children: crumb.label
+				})]
+			}, `crumb-${crumb.href}-${crumb.label}-${i}`);
+		})]
+	});
+}
+
+//#endregion
+//#region src/client/components/ui-base/copy-markdown.tsx
+const useCopyMarkdown = (content) => {
+	const [copied, setCopied] = useState(false);
+	const handleCopy = () => {
+		navigator.clipboard.writeText(content);
+		setCopied(true);
+		setTimeout(() => setCopied(false), 2e3);
+	};
+	const handleOpenRaw = () => {
+		const blob = new Blob([content], { type: "text/plain;charset=utf-8" });
+		const url = URL.createObjectURL(blob);
+		window.open(url, "_blank");
+	};
+	return {
+		copied,
+		handleCopy,
+		handleOpenRaw
+	};
+};
+function CopyMarkdown({ content, mdxRaw }) {
+	const displayContent = mdxRaw || content || "";
+	const { copied, handleCopy, handleOpenRaw } = useCopyMarkdown(displayContent);
+	if (!displayContent) return null;
+	return /* @__PURE__ */ jsx("div", {
+		className: "relative inline-flex z-100 shrink-0 w-max",
+		children: /* @__PURE__ */ jsxs(ButtonGroup, {
+			className: "rounded-xl border border-subtle bg-surface transition-all duration-300 hover:border-primary-500/50 group overflow-hidden",
+			children: [
+				/* @__PURE__ */ jsx(Button$1, {
+					onPress: handleCopy,
+					className: cn("md:hidden flex items-center justify-center w-8 h-8 bg-transparent outline-none select-none cursor-pointer border-none", "text-muted transition-all duration-300 hover:bg-primary-500/5 hover:text-body", copied && "text-emerald-500 hover:bg-emerald-500/5"),
+					"aria-label": copied ? "Copied!" : "Copy Markdown",
+					children: copied ? /* @__PURE__ */ jsx(Check, { size: 14 }) : /* @__PURE__ */ jsx(Copy, { size: 14 })
+				}),
+				/* @__PURE__ */ jsxs(Button$1, {
+					onPress: handleCopy,
+					className: cn("hidden md:flex items-center gap-2 px-5 py-2 bg-transparent text-[0.8125rem] font-semibold h-9 shrink-0 outline-none select-none cursor-pointer border-none", "text-body transition-all duration-300 hover:bg-primary-500/5", copied && "text-emerald-500 hover:bg-emerald-500/5"),
+					children: [copied ? /* @__PURE__ */ jsx(Check, { size: 16 }) : /* @__PURE__ */ jsx(Copy, { size: 16 }), copied ? "Copied!" : "Copy Markdown"]
+				}),
+				/* @__PURE__ */ jsxs(Menu$1.Trigger, {
+					placement: "bottom end",
+					children: [/* @__PURE__ */ jsx(Button$1, {
+						className: cn("flex items-center justify-center px-2.5 md:px-3.5 h-8 md:h-9 border-none border-l border-subtle/50 text-muted rounded-none bg-transparent shrink-0 outline-none select-none cursor-pointer", "transition-all duration-300 hover:bg-primary-500/5 hover:text-primary-500"),
+						children: /* @__PURE__ */ jsx(ChevronDown, { size: 14 })
+					}), /* @__PURE__ */ jsxs(Menu$1.Root, {
+						className: "w-52 bg-main border border-subtle rounded-xl p-1.5 shadow-md outline-none flex flex-col gap-0.5 animate-fade-in z-100",
+						children: [/* @__PURE__ */ jsxs(Menu$1.Item, {
+							onAction: handleCopy,
+							className: "flex items-center px-3 py-2 rounded-lg text-xs font-medium text-body dark:hover:bg-primary-300/50 hover:bg-primary-200/50 transition-colors duration-100 cursor-pointer select-none outline-none group",
+							children: [/* @__PURE__ */ jsx(Copy, {
+								size: 16,
+								className: "size-4 text-muted dark:group-hover:text-primary-500 group-hover:text-primary-400"
+							}), /* @__PURE__ */ jsx("span", {
+								className: "ml-2",
+								children: "Copy Markdown"
+							})]
+						}), /* @__PURE__ */ jsxs(Menu$1.Item, {
+							onAction: handleOpenRaw,
+							className: "flex items-center gap-2 px-3 py-2 rounded-lg text-xs font-medium text-body dark:hover:bg-primary-300/50 hover:bg-primary-200/50 transition-colors duration-100 cursor-pointer select-none outline-none group",
+							children: [/* @__PURE__ */ jsx(ExternalLink, {
+								size: 16,
+								className: "size-4 text-muted dark:group-hover:text-primary-500 group-hover:text-primary-400"
+							}), /* @__PURE__ */ jsx("span", {
+								className: "ml-2",
+								children: "View as Markdown"
+							})]
+						})]
+					})]
+				})
+			]
+		})
+	});
+}
+
+//#endregion
+//#region src/client/components/ui-base/error-boundary.tsx
+function ErrorBoundary({ children, fallback }) {
+	return /* @__PURE__ */ jsx(ErrorBoundary$1, {
+		fallback,
+		children
+	});
+}
+
+//#endregion
+//#region src/client/utils/github.ts
+const BASE_URL = "https://api.github.com";
+/**
+* Get the number of stars for a GitHub repository.
+* @param repo - owner/repo
+* @param token - The GitHub token.
+* @param baseUrl - The GitHub API base URL.
+* @returns The number of stars for the repository.
+* @example
+* getStarsRepo('owner/repo') // 100k
+*/
+async function getStarsRepo(repo, token, baseUrl = BASE_URL) {
+	const headers = new Headers();
+	if (token) headers.append("authorization", token);
+	const data = await (await fetch(`${baseUrl}/repos/${repo}`, { headers })).json();
+	if (data.stargazers_count !== void 0) return formatStars(data.stargazers_count);
+	else return "0";
+}
+/**
+* Format a number of stars in a compact form.
+* @param count - The number of stars to format.
+* @returns The formatted number of stars.
+*/
+const formatStars = (count) => {
+	return Intl.NumberFormat("en", {
+		notation: "compact",
+		compactDisplay: "short"
+	}).format(count);
+};
+
+//#endregion
+//#region src/client/components/ui-base/github-stars.tsx
+function GithubStars({ repo }) {
+	const [stars, setStars] = useState(null);
+	useEffect(() => {
+		if (repo) getStarsRepo(repo).then((stars) => setStars(stars)).catch(() => setStars("0"));
+	}, [repo]);
+	return /* @__PURE__ */ jsxs("a", {
+		href: `https://github.com/${repo}`,
+		target: "_blank",
+		rel: "noopener noreferrer",
+		className: "inline-flex items-center gap-2 rounded-xl border border-subtle bg-surface px-3 py-1.5 text-xs font-semibold text-muted dark:hover:bg-primary-300/50 hover:bg-primary-200/50 transition-colors duration-100 hover:border-primary-500/50 hover:text-body select-none outline-none",
+		children: [/* @__PURE__ */ jsx(Github, { className: "h-4 w-4 text-body" }), stars !== null && /* @__PURE__ */ jsxs("span", {
+			className: "tabular-nums font-medium",
+			children: [stars, " stars"]
+		})]
+	});
+}
+
+//#endregion
+//#region src/client/utils/i18n.ts
+/**
+* Retrieves the correct translation from a value that can be either
+* a simple string or a map of locale-specific strings.
+*
+* @param value - The text to translate
+* @param locale - The current active locale (e.g., 'en', 'es')
+* @returns The translated string
+*/
+function getTranslated(value, locale) {
+	if (!value) return "";
+	if (typeof value === "string") return value;
+	if (locale && value[locale]) return value[locale];
+	return Object.values(value)[0] || "";
+}
+
+//#endregion
+//#region src/client/hooks/use-navbar.ts
+function useNavbar() {
+	const config = useConfig();
+	const { theme, resolvedTheme } = useTheme();
+	const location = useLocation$1();
+	const { currentLocale } = useRoutes();
+	const themeConfig = config.theme || {};
+	const title = getTranslated(themeConfig.title, currentLocale) || "Boltdocs";
+	const rawLinks = themeConfig.navbar || [];
+	const socialLinks = themeConfig.socialLinks || [];
+	const githubRepo = themeConfig.githubRepo;
+	const links = useMemo(() => {
+		return rawLinks.map((item) => {
+			const href = item.href || item.to || item.link || "";
+			const getIsActive = (h) => {
+				const activePath = location.pathname;
+				if (activePath === h) return true;
+				if (!h || h === "/") return activePath === "/";
+				const cleanPathParts = (p) => {
+					const parts = p.split("/").filter(Boolean);
+					let i = 0;
+					if (config.i18n?.locales && parts[i] && config.i18n.locales[parts[i]]) i++;
+					if (config.versions?.versions && parts[i]) {
+						if (config.versions.versions.some((v) => v.path === parts[i])) i++;
+					}
+					return parts.slice(i);
+				};
+				const hParts = cleanPathParts(h);
+				const pParts = cleanPathParts(activePath);
+				if (hParts.length === 0) return pParts.length === 0;
+				if (pParts.length < hParts.length) return false;
+				return hParts.every((part, i) => pParts[i] === part);
+			};
+			const processItems = (items) => {
+				if (!items || items.length === 0) return void 0;
+				return items.map((subItem) => {
+					const subHref = subItem.href || subItem.to || subItem.link || "";
+					return {
+						label: getTranslated(subItem.label || subItem.text, currentLocale),
+						href: subHref,
+						active: getIsActive(subHref),
+						to: subHref.startsWith("http") || subHref.startsWith("//") ? "external" : void 0
+					};
+				});
+			};
+			const linkItems = processItems(item.items);
+			return {
+				label: getTranslated(item.label || item.text, currentLocale),
+				href,
+				active: getIsActive(href),
+				to: href.startsWith("http") || href.startsWith("//") ? "external" : void 0,
+				items: linkItems
+			};
+		});
+	}, [
+		rawLinks,
+		location.pathname,
+		currentLocale,
+		config
+	]);
+	const logo = themeConfig.logo;
+	return {
+		links,
+		title,
+		logo: !logo ? null : typeof logo === "string" ? logo : resolvedTheme === "dark" ? logo.dark : logo.light,
+		logoProps: {
+			alt: (logo && typeof logo === "object" ? logo.alt : void 0) || title,
+			width: logo && typeof logo === "object" ? logo.width : void 0,
+			height: logo && typeof logo === "object" ? logo.height : void 0
+		},
+		github: githubRepo ? `https://github.com/${githubRepo}` : null,
+		social: socialLinks,
+		config,
+		theme
+	};
+}
+
+//#endregion
+//#region src/client/components/ui-base/theme-toggle.tsx
+function ThemeToggle() {
+	const { theme, setTheme } = useTheme();
+	const [mounted, setMounted] = useState(false);
+	useEffect(() => {
+		setMounted(true);
+	}, []);
+	if (!mounted) return /* @__PURE__ */ jsx("div", { className: "h-9 w-9" });
+	const Icon = theme === "system" ? Monitor : theme === "dark" ? Moon : Sun;
+	return /* @__PURE__ */ jsxs(Menu$1.Trigger, {
+		placement: "bottom right",
+		children: [/* @__PURE__ */ jsx(Button, {
+			className: "flex h-9 w-9 items-center justify-center rounded-xl text-muted transition-colors hover:bg-surface hover:text-body outline-none border-none bg-transparent cursor-pointer",
+			"aria-label": "Selection theme",
+			children: /* @__PURE__ */ jsx(Icon, {
+				size: 20,
+				className: "animate-in fade-in zoom-in duration-300"
+			})
+		}), /* @__PURE__ */ jsxs(Menu$1.Root, {
+			selectionMode: "single",
+			selectedKeys: [theme],
+			onSelectionChange: (keys) => {
+				const newTheme = Array.from(keys)[0];
+				setTheme(newTheme);
+			},
+			className: "w-36 bg-main border border-subtle rounded-xl p-1.5 shadow-md outline-none flex flex-col gap-0.5 animate-fade-in z-100",
+			children: [
+				/* @__PURE__ */ jsxs(Menu$1.Item, {
+					id: "light",
+					className: "group flex items-center gap-2 px-3 py-2 rounded-lg text-xs font-medium text-body dark:hover:bg-primary-300/50 hover:bg-primary-200/50 transition-colors duration-100 cursor-pointer select-none outline-none group data-selected:text-primary-500 data-selected:bg-primary-500/5",
+					children: [/* @__PURE__ */ jsx(Sun, {
+						className: "group-hover:text-primary-500 dark:group-hover:text-primary-200",
+						size: 16
+					}), /* @__PURE__ */ jsx("span", {
+						className: "ml-2",
+						children: "Light"
+					})]
+				}),
+				/* @__PURE__ */ jsxs(Menu$1.Item, {
+					id: "dark",
+					className: "flex items-center gap-2 px-3 py-2 rounded-lg text-xs font-medium text-body dark:hover:bg-primary-300/50 hover:bg-primary-200/50 transition-colors duration-100 cursor-pointer select-none outline-none group data-selected:text-primary-500 data-selected:bg-primary-500/5",
+					children: [/* @__PURE__ */ jsx(Moon, {
+						className: "group-hover:text-primary-500 dark:group-hover:text-primary-200",
+						size: 16
+					}), /* @__PURE__ */ jsx("span", {
+						className: "ml-2",
+						children: "Dark"
+					})]
+				}),
+				/* @__PURE__ */ jsxs(Menu$1.Item, {
+					id: "system",
+					className: "flex items-center gap-2 px-3 py-2 rounded-lg text-xs font-medium text-body dark:hover:bg-primary-300/50 hover:bg-primary-200/50 transition-colors duration-100 cursor-pointer select-none outline-none group data-selected:text-primary-500 data-selected:bg-primary-500/5",
+					children: [/* @__PURE__ */ jsx(Monitor, {
+						className: "group-hover:text-primary-500 dark:group-hover:text-primary-200",
+						size: 16
+					}), /* @__PURE__ */ jsx("span", {
+						className: "ml-2",
+						children: "System"
+					})]
+				})
+			]
+		})]
+	});
+}
+function ThemeSwitcher({ className }) {
+	const { theme, setTheme } = useTheme();
+	const [mounted, setMounted] = useState(false);
+	useEffect(() => {
+		setMounted(true);
+	}, []);
+	if (!mounted) return /* @__PURE__ */ jsx("div", { className: cn("h-10 w-full bg-surface rounded-xl animate-pulse", className) });
+	const isDark = theme === "dark";
+	return /* @__PURE__ */ jsxs("div", {
+		className: cn("flex p-1 bg-surface border border-subtle rounded-xl relative w-full h-11", className),
+		children: [
+			/* @__PURE__ */ jsx("div", { className: cn("absolute inset-y-1 w-[calc(50%-4px)] bg-main border border-subtle rounded-lg transition-all duration-300 ease-out shadow-xs", isDark ? "translate-x-full" : "translate-x-0") }),
+			/* @__PURE__ */ jsx("button", {
+				onClick: () => setTheme("light"),
+				className: cn("flex-1 flex items-center justify-center rounded-lg z-10 transition-colors outline-none cursor-pointer border-none bg-transparent", !isDark ? "text-body font-semibold" : "text-muted hover:text-body"),
+				"aria-label": "Light mode",
+				children: /* @__PURE__ */ jsx(Sun, { size: 18 })
+			}),
+			/* @__PURE__ */ jsx("button", {
+				onClick: () => setTheme("dark"),
+				className: cn("flex-1 flex items-center justify-center rounded-lg z-10 transition-colors outline-none cursor-pointer border-none bg-transparent", isDark ? "text-body font-semibold" : "text-muted hover:text-body"),
+				"aria-label": "Dark mode",
+				children: /* @__PURE__ */ jsx(Moon, { size: 18 })
+			})
+		]
+	});
+}
+
+//#endregion
+//#region src/client/hooks/use-tabs.ts
+function useTabs(tabs = [], routes = []) {
+	const location = useLocation$1();
+	const tabRefs = useRef([]);
+	const [indicatorStyle, setIndicatorStyle] = useState({
+		opacity: 0,
+		transform: "translateX(0) scaleX(0)",
+		width: 0
+	});
+	const currentPath = normalizePath$1(location.pathname);
+	const activeTabId = routes.find((r) => normalizePath$1(r.path) === currentPath)?.tab?.toLowerCase();
+	const activeIndex = tabs.findIndex((tab) => tab.id.toLowerCase() === activeTabId);
+	const finalActiveIndex = activeIndex === -1 ? 0 : activeIndex;
+	useEffect(() => {
+		const activeTab = tabRefs.current[finalActiveIndex];
+		if (activeTab) setIndicatorStyle({
+			opacity: 1,
+			width: activeTab.offsetWidth,
+			transform: `translateX(${activeTab.offsetLeft}px)`
+		});
+	}, [
+		finalActiveIndex,
+		tabs.length,
+		location.pathname
+	]);
+	return {
+		tabs,
+		activeIndex: finalActiveIndex,
+		indicatorStyle,
+		tabRefs,
+		activeTabId
+	};
+}
+
+//#endregion
+//#region src/client/components/ui-base/tabs.tsx
+function Tabs({ tabs, routes }) {
+	const { currentLocale } = useRoutes();
+	const { indicatorStyle, tabRefs, activeIndex } = useTabs(tabs, routes);
+	useEffect(() => {
+		const activeTab = tabRefs.current[activeIndex];
+		if (activeTab) activeTab.scrollIntoView({
+			behavior: "smooth",
+			block: "nearest",
+			inline: "center"
+		});
+	}, [activeIndex]);
+	const renderTabIcon = (iconName) => {
+		if (!iconName) return null;
+		if (iconName.trim().startsWith("<svg")) return /* @__PURE__ */ jsx("span", {
+			className: "h-4 w-4",
+			dangerouslySetInnerHTML: { __html: iconName }
+		});
+		const icons = {
+			...icons_exports,
+			...virtualIcons
+		};
+		const TabIcon = icons[iconName] || icons[iconName + "Icon"];
+		if (TabIcon) return /* @__PURE__ */ jsx(TabIcon, { size: 16 });
+		return /* @__PURE__ */ jsx("img", {
+			src: iconName,
+			alt: "",
+			className: "h-4 w-4 object-contain"
+		});
+	};
+	return /* @__PURE__ */ jsx("div", {
+		className: "mx-auto max-w-(--breakpoint-3xl) px-4 md:px-6 select-none",
+		children: /* @__PURE__ */ jsxs(Tabs$1.List, {
+			className: "border-none py-0 scrollbar-hide relative flex flex-row items-center",
+			children: [tabs.map((tab, index) => {
+				const isActive = index === activeIndex;
+				const firstRoute = routes.find((r) => r.tab && r.tab.toLowerCase() === tab.id.toLowerCase());
+				return /* @__PURE__ */ jsxs(Link, {
+					href: firstRoute ? firstRoute.path : "#",
+					ref: (el) => {
+						tabRefs.current[index] = el;
+					},
+					className: `relative flex items-center gap-2 px-4 py-3.5 text-sm font-semibold transition-colors duration-300 outline-none whitespace-nowrap ${isActive ? "text-primary-500" : "text-muted hover:text-body"}`,
+					children: [renderTabIcon(tab.icon), /* @__PURE__ */ jsx("span", { children: getTranslated(tab.text, currentLocale) })]
+				}, tab.id);
+			}), /* @__PURE__ */ jsx(Tabs$1.Indicator, {
+				style: indicatorStyle,
+				className: "h-0.5 bg-primary-500 rounded-full transition-all duration-300"
+			})]
+		})
+	});
+}
+
+//#endregion
+//#region src/client/utils/get-base-file-path.ts
+/**
+* Get the base file path by removing version and locale prefixes.
+* @param filePath - The full file path.
+* @param version - The version to remove from the path.
+* @param locale - The locale to remove from the path.
+* @returns The base file path.
+*/
+function getBaseFilePath(filePath, version, locale) {
+	let path = filePath;
+	if (version && (path === version || path.startsWith(version + "/"))) path = path === version ? "index.md" : path.slice(version.length + 1);
+	if (locale && (path === locale || path.startsWith(locale + "/"))) path = path === locale ? "index.md" : path.slice(locale.length + 1);
+	return path;
+}
+
+//#endregion
+//#region src/client/hooks/use-version.ts
+/**
+* Hook to manage and switch between different versions of the documentation.
+*/
+function useVersion() {
+	const navigate = useNavigate();
+	const config = useConfig();
+	const { allRoutes, currentRoute, currentVersion, currentLocale } = useRoutes();
+	const versions = config.versions;
+	const { setVersion } = useBoltdocsContext();
+	const handleVersionChange = (version) => {
+		if (!versions || version === currentVersion) return;
+		setVersion(version);
+		let targetPath = `${(config.base || "/docs").replace(/\/$/, "")}/${version}${currentLocale ? `/${currentLocale}` : ""}`;
+		if (currentRoute) {
+			const baseFile = getBaseFilePath(currentRoute.filePath, currentRoute.version, currentRoute.locale);
+			const targetRoute = allRoutes.find((r) => getBaseFilePath(r.filePath, r.version, r.locale) === baseFile && (r.version || versions.defaultVersion) === version && (!config.i18n || (r.locale || config.i18n.defaultLocale) === currentLocale));
+			if (targetRoute) targetPath = targetRoute.path;
+			else {
+				const versionIndexRoute = allRoutes.find((r) => getBaseFilePath(r.filePath, r.version, r.locale) === "index.md" && (r.version || versions.defaultVersion) === version && (!config.i18n || (r.locale || config.i18n.defaultLocale) === currentLocale));
+				if (versionIndexRoute) targetPath = versionIndexRoute.path;
+			}
+		} else {
+			const fallbackRoute = allRoutes.find((r) => (r.version || versions.defaultVersion) === version && (!config.i18n || (r.locale || config.i18n.defaultLocale) === currentLocale));
+			if (fallbackRoute) targetPath = fallbackRoute.path;
+		}
+		navigate(targetPath);
+	};
+	return {
+		currentVersion,
+		currentVersionLabel: (versions?.versions?.find?.((v) => v.path === currentVersion))?.label || currentVersion,
+		availableVersions: useMemo(() => {
+			return versions ? versions.versions.map((v) => ({
+				key: v.path,
+				label: v.label,
+				value: v.path,
+				isCurrent: v.path === currentVersion
+			})) : [];
+		}, [versions, currentVersion]),
+		handleVersionChange
+	};
+}
+
+//#endregion
+//#region src/client/hooks/use-i18n.ts
+/**
+* Hook to manage and switch between different locales (languages) of the documentation.
+*/
+function useI18n() {
+	const navigate = useNavigate();
+	const config = useConfig();
+	const { allRoutes, currentRoute, currentLocale, currentVersion } = useRoutes();
+	const i18n = config.i18n;
+	const { setLocale } = useBoltdocsContext();
+	const handleLocaleChange = (locale) => {
+		if (!i18n || locale === currentLocale) return;
+		setLocale(locale);
+		const base = config.base || "/";
+		const safeBase = base === "/" ? "" : base.replace(/\/$/, "");
+		const isDocRoute = !!currentRoute?.filePath;
+		let targetPath = "";
+		if (currentRoute) if (isDocRoute) {
+			const baseFile = getBaseFilePath(currentRoute.filePath, currentRoute.version, currentRoute.locale);
+			const targetRoute = allRoutes.find((r) => getBaseFilePath(r.filePath, r.version, r.locale) === baseFile && (r.locale || i18n.defaultLocale) === locale && r.version === currentRoute.version);
+			if (targetRoute) targetPath = targetRoute.path;
+			else {
+				const defaultIndexRoute = allRoutes.find((r) => getBaseFilePath(r.filePath, r.version, r.locale) === "index.md" && (r.locale || i18n.defaultLocale) === locale && r.version === currentRoute.version);
+				if (defaultIndexRoute) targetPath = defaultIndexRoute.path;
+				else targetPath = `${safeBase}${currentRoute.version ? `/${currentRoute.version}` : ""}${locale === i18n.defaultLocale ? "" : `/${locale}`}` || "/";
+			}
+		} else {
+			let rawExternal = currentRoute.path;
+			const parts = rawExternal.split("/").filter(Boolean);
+			if (parts.length > 0 && (Array.isArray(i18n.locales) ? i18n.locales.includes(parts[0]) : !!i18n.locales[parts[0]])) {
+				parts.shift();
+				rawExternal = "/" + parts.join("/");
+			}
+			if (locale === i18n.defaultLocale) targetPath = rawExternal === "" ? "/" : rawExternal;
+			else {
+				const cleanExt = rawExternal.startsWith("/") ? rawExternal : `/${rawExternal}`;
+				targetPath = `/${locale}${cleanExt === "/" ? "" : cleanExt}`;
+			}
+		}
+		else {
+			const targetRoute = allRoutes.find((r) => (r.locale || i18n.defaultLocale) === locale && (r.version || config.versions?.defaultVersion) === (currentVersion || config.versions?.defaultVersion));
+			if (targetRoute) targetPath = targetRoute.path;
+			else {
+				const vPath = currentVersion && currentVersion !== config.versions?.defaultVersion ? `/${currentVersion}` : "";
+				targetPath = locale === i18n.defaultLocale ? `${safeBase}${vPath}` : `${safeBase}${vPath}/${locale}`;
+			}
+		}
+		if (!targetPath || targetPath === "") targetPath = "/";
+		targetPath = targetPath.replace(/\/+/g, "/");
+		navigate(targetPath);
+	};
+	const locales = i18n?.locales;
+	const defaultLabel = locales ? Array.isArray(locales) ? currentLocale : locales[currentLocale] : void 0;
+	return {
+		currentLocale,
+		currentLocaleLabel: (i18n?.localeConfigs?.[currentLocale])?.label || defaultLabel || currentLocale,
+		availableLocales: useMemo(() => {
+			return i18n ? Array.isArray(i18n.locales) ? i18n.locales.map((key) => {
+				return {
+					key,
+					label: (i18n?.localeConfigs?.[key])?.label || key,
+					value: key,
+					isCurrent: key === currentLocale
+				};
+			}) : Object.entries(i18n.locales).map(([key, label]) => {
+				return {
+					key,
+					label: (i18n?.localeConfigs?.[key])?.label || label,
+					value: key,
+					isCurrent: key === currentLocale
+				};
+			}) : [];
+		}, [i18n, currentLocale]),
+		handleLocaleChange
+	};
+}
+
+//#endregion
+//#region src/client/components/ui-base/version-i18n.tsx
+function VersionSelector({ className }) {
+	const { currentVersionLabel, availableVersions, handleVersionChange } = useVersion();
+	if (availableVersions.length === 0) return null;
+	return /* @__PURE__ */ jsxs(Menu$1.Trigger, { children: [/* @__PURE__ */ jsxs(Button$1, {
+		className: cn("flex h-9 items-center justify-between gap-2 border border-subtle bg-surface px-4 py-1.5 rounded-xl text-xs font-semibold text-body hover:bg-primary-50/20 hover:border-primary-500/50 transition-all duration-300 outline-none select-none cursor-pointer", className),
+		children: [/* @__PURE__ */ jsx("span", {
+			className: "font-semibold text-[0.8125rem]",
+			children: currentVersionLabel
+		}), /* @__PURE__ */ jsx(ChevronDown, { className: "w-3.5 h-3.5 text-muted/60" })]
+	}), /* @__PURE__ */ jsx(Menu$1.Root, {
+		className: "w-40 bg-main border border-subtle rounded-xl p-1.5 shadow-md outline-none flex flex-col gap-0.5 animate-fade-in z-100",
+		children: /* @__PURE__ */ jsx(Menu$1.Section, {
+			items: availableVersions,
+			children: (version) => /* @__PURE__ */ jsx(Menu$1.Item, {
+				onPress: () => handleVersionChange(version.value),
+				className: "flex items-center gap-2 px-3 py-2 rounded-lg text-xs font-medium text-body hover:bg-primary-50/50 cursor-pointer select-none outline-none group data-selected:text-primary-500 data-selected:bg-primary-500/5",
+				children: version.label
+			}, `${version.value ?? ""}`)
+		})
+	})] });
+}
+function I18nSelector({ className }) {
+	const { currentLocale, availableLocales, handleLocaleChange } = useI18n();
+	if (availableLocales.length === 0) return null;
+	return /* @__PURE__ */ jsxs(Menu$1.Trigger, { children: [/* @__PURE__ */ jsxs(Button$1, {
+		className: cn("flex h-9 items-center justify-between gap-2 border border-subtle bg-surface px-4 py-1.5 rounded-xl text-xs font-semibold text-body hover:bg-primary-50/20 hover:border-primary-500/50 transition-all duration-300 outline-none select-none cursor-pointer", className),
+		children: [/* @__PURE__ */ jsxs("div", {
+			className: "flex items-center gap-1.5",
+			children: [/* @__PURE__ */ jsx(Languages, { className: "w-3.5 h-3.5 text-primary-500" }), /* @__PURE__ */ jsx("span", {
+				className: "font-bold text-[0.75rem] uppercase opacity-90",
+				children: currentLocale || "en"
+			})]
+		}), /* @__PURE__ */ jsx(ChevronDown, { className: "w-3.5 h-3.5 text-muted/60" })]
+	}), /* @__PURE__ */ jsx(Menu$1.Root, {
+		className: "w-40 bg-main border border-subtle rounded-xl p-1.5 shadow-md outline-none flex flex-col gap-0.5 animate-fade-in z-100",
+		children: /* @__PURE__ */ jsx(Menu$1.Section, {
+			items: availableLocales,
+			children: (locale) => /* @__PURE__ */ jsx(Menu$1.Item, {
+				onPress: () => handleLocaleChange(locale.value),
+				className: "flex items-center gap-2 px-3 py-2 rounded-lg text-xs font-medium text-body dark:hover:bg-primary-300/50 hover:bg-primary-200/50 transition-colors duration-100 cursor-pointer select-none outline-none group data-selected:text-primary-500 data-selected:bg-primary-500/5",
+				children: /* @__PURE__ */ jsx("span", { children: locale.label })
+			}, `${locale.value ?? ""}`)
+		})
+	})] });
+}
+
+//#endregion
+//#region src/client/components/ui-base/navbar.tsx
+const SearchDialog$1 = lazy(() => import("../search-dialog-BHuIiUC6.js").then((m) => ({ default: m.SearchDialog })));
+function Navbar() {
+	const { links, title, logo, logoProps, github, social, config } = useNavbar();
+	const { routes, allRoutes, currentRoute, currentVersion, currentLocale } = useRoutes();
+	const { pathname } = useLocation$1();
+	const { isSidebarOpen, toggleSidebar } = useUI();
+	const [isMobileMenuOpen, setIsMobileMenuOpen] = useState(false);
+	const themeConfig = config.theme || {};
+	const isDocs = !!currentRoute?.filePath;
+	const hasTabs = themeConfig?.tabs && themeConfig.tabs.length > 0;
+	return /* @__PURE__ */ jsxs(Navbar$1.Root, {
+		className: cn("border-b border-subtle bg-main/80 backdrop-blur-md", hasTabs && "border-b-0"),
+		children: [
+			/* @__PURE__ */ jsxs(Navbar$1.Content, { children: [
+				/* @__PURE__ */ jsxs(Navbar$1.Left, { children: [
+					isDocs && /* @__PURE__ */ jsx(Button$1, {
+						onPress: toggleSidebar,
+						className: "mr-2 lg:hidden p-1.5 h-8 w-8 flex items-center justify-center bg-transparent border-none outline-none select-none cursor-pointer rounded-xl hover:bg-primary-50/50 transition-colors",
+						"aria-label": isSidebarOpen ? "Close sidebar" : "Open sidebar",
+						children: isSidebarOpen ? /* @__PURE__ */ jsx(X, { className: "w-5 h-5 text-body" }) : /* @__PURE__ */ jsx(Menu, { className: "w-5 h-5 text-body" })
+					}),
+					logo && /* @__PURE__ */ jsx(Navbar$1.Logo, {
+						src: logo,
+						alt: logoProps?.alt || title,
+						width: logoProps?.width ?? 24,
+						height: logoProps?.height ?? 24,
+						href: "site:/"
+					}),
+					/* @__PURE__ */ jsx(Navbar$1.Title, {
+						href: "site:/",
+						children: title
+					}),
+					/* @__PURE__ */ jsx("div", {
+						className: "hidden sm:block",
+						children: config.versions && currentVersion && /* @__PURE__ */ jsx(VersionSelector, {})
+					})
+				] }),
+				/* @__PURE__ */ jsx(Navbar$1.Center, { children: /* @__PURE__ */ jsx(Suspense, {
+					fallback: /* @__PURE__ */ jsx("div", { className: "h-9 w-32 animate-pulse rounded-md bg-surface" }),
+					children: /* @__PURE__ */ jsx(SearchDialog$1, { routes: routes || [] })
+				}) }),
+				/* @__PURE__ */ jsxs(Navbar$1.Right, { children: [
+					/* @__PURE__ */ jsx(Suspense, {
+						fallback: null,
+						children: /* @__PURE__ */ jsx("div", {
+							className: "lg:hidden",
+							children: /* @__PURE__ */ jsx(SearchDialog$1, { routes: routes || [] })
+						})
+					}),
+					/* @__PURE__ */ jsx(Navbar$1.Links, { children: links.map((link) => /* @__PURE__ */ jsx(NavbarLinkItem, { link }, link.href)) }),
+					/* @__PURE__ */ jsxs("div", {
+						className: "hidden sm:flex items-center gap-2",
+						children: [config.i18n && currentLocale && /* @__PURE__ */ jsx(I18nSelector, {}), /* @__PURE__ */ jsx(Navbar$1.Split, { className: "bg-subtle" })]
+					}),
+					/* @__PURE__ */ jsx("div", {
+						className: "hidden md:block",
+						children: /* @__PURE__ */ jsx(ThemeToggle, {})
+					}),
+					github && /* @__PURE__ */ jsx("div", {
+						className: "hidden md:block",
+						children: /* @__PURE__ */ jsx(GithubStars, { repo: themeConfig?.githubRepo ?? "" })
+					}),
+					social.length > 0 && /* @__PURE__ */ jsx("div", {
+						className: "hidden md:block",
+						children: /* @__PURE__ */ jsx(Navbar$1.Split, { className: "bg-subtle" })
+					}),
+					/* @__PURE__ */ jsx("div", {
+						className: "hidden md:flex items-center gap-1",
+						children: social.map(({ icon, link }) => /* @__PURE__ */ jsx(Navbar$1.Socials, {
+							icon,
+							link,
+							className: "p-1.5 text-muted hover:text-body hover:bg-surface rounded-md transition-all focus-visible:ring-2 focus-visible:ring-primary-500/30"
+						}, link))
+					}),
+					/* @__PURE__ */ jsx(Navbar$1.More, {
+						onPress: () => setIsMobileMenuOpen(true),
+						className: "text-muted hover:text-body active:scale-90 transition-all focus-visible:ring-2 focus-visible:ring-primary-500/30"
+					})
+				] })
+			] }),
+			/* @__PURE__ */ jsxs(Navbar$1.MobileMenu, {
+				isOpen: isMobileMenuOpen,
+				onClose: () => setIsMobileMenuOpen(false),
+				className: "bg-main/98 backdrop-blur-2xl",
+				children: [/* @__PURE__ */ jsx("div", {
+					className: "flex flex-col gap-1",
+					children: links.map((link) => /* @__PURE__ */ jsx(NavbarMobileLinkItem, {
+						link,
+						onClose: () => setIsMobileMenuOpen(false)
+					}, link.href))
+				}), social.length > 0 && /* @__PURE__ */ jsxs("div", {
+					className: "mt-6",
+					children: [/* @__PURE__ */ jsx("div", {
+						className: "px-4 mb-4 text-xs font-bold uppercase tracking-widest text-muted/50",
+						children: "Connect"
+					}), /* @__PURE__ */ jsx("div", {
+						className: "flex flex-wrap gap-2 px-2",
+						children: social.map(({ icon, link }) => /* @__PURE__ */ jsx(Navbar$1.Socials, {
+							icon,
+							link,
+							className: "p-3 bg-surface border border-subtle rounded-xl flex-1 justify-center"
+						}, link))
+					})]
+				})]
+			}),
+			isDocs && hasTabs && themeConfig?.tabs && /* @__PURE__ */ jsx("div", {
+				className: "w-full border-b border-subtle bg-main",
+				children: /* @__PURE__ */ jsx(Tabs, {
+					tabs: themeConfig.tabs,
+					routes: allRoutes || routes || []
+				})
+			})
+		]
+	});
+}
+function NavbarLinkItem({ link }) {
+	const localizedHref = useLocalizedTo(link.href || "");
+	const { pathname } = useLocation$1();
+	const active = pathname === localizedHref || pathname.startsWith(localizedHref + "/");
+	if (link.items && link.items.length > 0) return /* @__PURE__ */ jsx(Navbar$1.Dropdown, {
+		label: /* @__PURE__ */ jsx("span", {
+			className: cn("transition-colors outline-none font-medium focus-visible:ring-2 focus-visible:ring-primary-500/30 rounded-sm px-2 py-1", active ? "text-primary-500" : "text-muted hover:text-body"),
+			children: link.label
+		}),
+		children: link.items?.map((item) => /* @__PURE__ */ jsx(Navbar$1.DropdownItem, {
+			href: useLocalizedTo(item.href || ""),
+			label: item.label
+		}, item.href))
+	});
+	return /* @__PURE__ */ jsx(Navbar$1.Link, {
+		...link,
+		href: localizedHref,
+		active,
+		className: cn("transition-colors outline-none font-medium focus-visible:ring-2 focus-visible:ring-primary-500/30 rounded-sm", active ? "text-primary-500" : "text-muted hover:text-body")
+	});
+}
+function NavbarMobileLinkItem({ link, onClose }) {
+	const localizedHref = useLocalizedTo(link.href || "");
+	const { pathname } = useLocation$1();
+	const active = pathname === localizedHref;
+	if (link.items && link.items.length > 0) return /* @__PURE__ */ jsxs("div", {
+		className: "flex flex-col gap-1",
+		children: [/* @__PURE__ */ jsx("div", {
+			className: cn("px-3 py-2 text-sm transition-all", active ? "text-body" : "text-muted/80 hover:text-body"),
+			children: link.label
+		}), /* @__PURE__ */ jsx("div", {
+			className: "flex flex-col gap-1 pl-4",
+			children: link.items?.map((item) => /* @__PURE__ */ jsx(NavbarMobileLinkItem, {
+				link: item,
+				onClose
+			}, item.href))
+		})]
+	});
+	return /* @__PURE__ */ jsx(Navbar$1.MobileLink, {
+		...link,
+		href: localizedHref,
+		active,
+		onPress: onClose,
+		className: cn("transition-all", active ? "text-body" : "text-muted/80 hover:text-body")
+	});
+}
+
+//#endregion
+//#region src/client/components/ui-base/not-found.tsx
+function NotFound() {
+	return /* @__PURE__ */ jsx("div", {
+		className: "flex items-center justify-center min-h-[65vh] text-center px-4",
+		children: /* @__PURE__ */ jsxs("div", {
+			className: "space-y-6 max-w-md mx-auto p-8 border border-subtle bg-surface rounded-2xl shadow-xs",
+			children: [
+				/* @__PURE__ */ jsx("span", {
+					className: "block text-7xl font-extrabold tracking-tight text-primary-500",
+					children: "404"
+				}),
+				/* @__PURE__ */ jsxs("div", {
+					className: "space-y-2",
+					children: [/* @__PURE__ */ jsx("h1", {
+						className: "text-xl font-bold text-body",
+						children: "Page Not Found"
+					}), /* @__PURE__ */ jsx("p", {
+						className: "text-sm text-muted leading-relaxed",
+						children: "The page you're looking for doesn't exist or has been moved."
+					})]
+				}),
+				/* @__PURE__ */ jsxs(Link, {
+					href: "/",
+					className: "inline-flex items-center gap-2 rounded-xl border border-subtle bg-main px-6 py-2.5 text-xs font-semibold text-body hover:bg-primary-50/50 hover:border-primary-500/50 transition-all duration-300 outline-none select-none",
+					children: [/* @__PURE__ */ jsx(ArrowLeft, { size: 14 }), " Go to Home"]
+				})
+			]
+		})
+	});
+}
+
+//#endregion
+//#region src/client/components/ui-base/on-this-page.tsx
+function OnThisPage({ headings = [], editLink, communityHelp, filePath }) {
+	if (headings.length === 0) return null;
+	return /* @__PURE__ */ jsxs(OnThisPage$1.Root, { children: [
+		/* @__PURE__ */ jsxs(OnThisPage$1.Header, {
+			className: "flex flex-row gap-x-2",
+			children: [/* @__PURE__ */ jsx(TextAlignStart, { size: 16 }), "On this page"]
+		}),
+		/* @__PURE__ */ jsx(OnThisPage$1.Tree, { headings }),
+		(editLink || communityHelp) && /* @__PURE__ */ jsxs("div", {
+			className: "mt-8 pt-8 border-t border-subtle space-y-4",
+			children: [/* @__PURE__ */ jsx("p", {
+				className: "text-xs font-bold text-body",
+				children: "Need help?"
+			}), /* @__PURE__ */ jsxs("ul", {
+				className: "space-y-3",
+				children: [editLink && filePath && /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsxs("a", {
+					href: editLink.replace(":path", filePath),
+					target: "_blank",
+					rel: "noopener noreferrer",
+					className: "flex items-center gap-2 text-sm text-muted hover:text-body transition-colors",
+					children: [/* @__PURE__ */ jsx(Pencil, { size: 16 }), "Edit this page"]
+				}) }), communityHelp && /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsxs("a", {
+					href: communityHelp,
+					target: "_blank",
+					rel: "noopener noreferrer",
+					className: "flex items-center gap-2 text-sm text-muted hover:text-body transition-colors",
+					children: [/* @__PURE__ */ jsx(CircleHelp, { size: 16 }), "Community help"]
+				}) })]
+			})]
+		})
+	] });
+}
+
+//#endregion
+//#region src/client/hooks/use-page-nav.ts
+/**
+* Hook to manage the previous and next button functionality for documentation pages.
+* Intelligent: respects current locale, version, and tab to keep navigation logical.
+*/
+function usePageNav() {
+	const { routes, currentRoute } = useRoutes();
+	const location = useLocation$1();
+	return useMemo(() => {
+		if (!currentRoute) return {
+			prevPage: null,
+			nextPage: null,
+			currentRoute: null
+		};
+		const activeTabId = currentRoute.tab?.toLowerCase();
+		const contextRoutes = activeTabId ? routes.filter((r) => r.tab?.toLowerCase() === activeTabId) : routes.filter((r) => !r.tab);
+		const currentIndex = contextRoutes.findIndex((r) => r.path === location.pathname);
+		return {
+			prevPage: currentIndex > 0 ? contextRoutes[currentIndex - 1] : null,
+			nextPage: currentIndex !== -1 && currentIndex < contextRoutes.length - 1 ? contextRoutes[currentIndex + 1] : null,
+			currentRoute
+		};
+	}, [
+		routes,
+		currentRoute,
+		location.pathname
+	]);
+}
+
+//#endregion
+//#region src/client/components/ui-base/page-nav.tsx
+/**
+* Component to display the previous and next page navigation buttons.
+* Enhanced with subtle entrance animations, modern card layout, and hover highlights.
+*/
+function PageNav() {
+	const { prevPage, nextPage } = usePageNav();
+	if (!prevPage && !nextPage) return null;
+	return /* @__PURE__ */ jsxs(PageNav$1.Root, {
+		className: "pt-8 border-t border-subtle grid sm:grid-cols-2 gap-4 animate-in fade-in slide-in-from-bottom-4 duration-700 select-none",
+		children: [prevPage ? /* @__PURE__ */ jsxs(PageNav$1.Link, {
+			to: prevPage.path,
+			direction: "prev",
+			className: "group border border-subtle bg-surface p-5 rounded-2xl transition-all duration-300 hover:border-primary-500/50 hover:bg-primary-50/20",
+			children: [/* @__PURE__ */ jsx(PageNav$1.Title, {
+				className: "text-xs font-bold uppercase tracking-wider text-muted/60 mb-1",
+				children: "Previous"
+			}), /* @__PURE__ */ jsx(PageNav$1.Description, {
+				className: "text-sm sm:text-base font-bold text-body group-hover:text-primary-500 transition-colors",
+				children: prevPage.title
+			})]
+		}) : /* @__PURE__ */ jsx("div", {}), nextPage ? /* @__PURE__ */ jsxs(PageNav$1.Link, {
+			to: nextPage.path,
+			direction: "next",
+			className: "group border border-subtle bg-surface p-5 rounded-2xl transition-all duration-300 hover:border-primary-500/50 hover:bg-primary-50/20",
+			children: [/* @__PURE__ */ jsx(PageNav$1.Title, {
+				className: "text-xs font-bold uppercase tracking-wider text-muted/60 mb-1",
+				children: "Next"
+			}), /* @__PURE__ */ jsx(PageNav$1.Description, {
+				className: "text-sm sm:text-base font-bold text-body group-hover:text-primary-500 transition-colors",
+				children: nextPage.title
+			})]
+		}) : /* @__PURE__ */ jsx("div", {})]
+	});
+}
+
+//#endregion
+//#region src/client/components/ui-base/sidebar.tsx
+function SidebarMain({ routes, config }) {
+	const { logo, title, logoProps } = useNavbar();
+	const { closeSidebar } = useUI();
+	const SidebarLogo = logo ? /* @__PURE__ */ jsx("img", {
+		src: logo,
+		alt: logoProps?.alt || title,
+		width: 24,
+		height: 24,
+		className: "rounded-xl"
+	}) : null;
+	const hasUtilities = config.versions || config.i18n;
+	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(Sidebar$1.Root, { children: /* @__PURE__ */ jsx(Sidebar$1.Content, { children: /* @__PURE__ */ jsx(Sidebar$1.Items, { routes }) }) }), /* @__PURE__ */ jsxs(Sidebar$1.Mobile, { children: [/* @__PURE__ */ jsxs(Sidebar$1.Header, { children: [/* @__PURE__ */ jsxs("div", {
+		className: "flex items-center gap-3",
+		children: [SidebarLogo, /* @__PURE__ */ jsx("span", {
+			className: "font-bold text-lg tracking-tight text-body truncate max-w-[120px]",
+			children: title
+		})]
+	}), /* @__PURE__ */ jsxs("div", {
+		className: "flex items-center gap-2",
+		children: [/* @__PURE__ */ jsx(ThemeSwitcher, { className: "w-24 h-9 rounded-xl" }), /* @__PURE__ */ jsx(Button$1, {
+			onPress: closeSidebar,
+			className: "h-9 w-9 flex items-center justify-center bg-transparent border-none outline-none select-none cursor-pointer rounded-xl hover:bg-primary-50/50 text-muted hover:text-body transition-colors",
+			"aria-label": "Close sidebar",
+			children: /* @__PURE__ */ jsx(X, { size: 20 })
+		})]
+	})] }), /* @__PURE__ */ jsxs(Sidebar$1.Content, { children: [hasUtilities && /* @__PURE__ */ jsxs("div", {
+		className: "flex flex-col gap-4 mb-10",
+		children: [/* @__PURE__ */ jsxs("div", {
+			className: "flex gap-3",
+			children: [config.versions && /* @__PURE__ */ jsx(VersionSelector, { className: "flex-1 justify-between h-10 bg-surface border-subtle rounded-xl" }), config.i18n && /* @__PURE__ */ jsx(I18nSelector, { className: "flex-1 justify-between h-10 bg-surface border-subtle rounded-xl" })]
+		}), /* @__PURE__ */ jsx("div", { className: "mt-2 border-b border-subtle" })]
+	}), /* @__PURE__ */ jsx(Sidebar$1.Items, { routes })] })] })] });
+}
+const Sidebar = Object.assign(SidebarMain, {
+	Root: Sidebar$1.Root,
+	Mobile: Sidebar$1.Mobile,
+	Header: Sidebar$1.Header,
+	Content: Sidebar$1.Content,
+	Group: Sidebar$1.Group,
+	Link: Sidebar$1.Link,
+	SubGroup: Sidebar$1.SubGroup,
+	Item: Sidebar$1.Item,
+	Items: Sidebar$1.Items
+});
+
+//#endregion
+//#region src/client/components/ui-base/last-updated.tsx
+/**
+* A subtle display for when the page was last updated.
+* Small, opaque, and positioned at the bottom of the content with a thin top border divider.
+*/
+function LastUpdated({ date }) {
+	if (!date) return null;
+	const d = new Date(date);
+	if (isNaN(d.getTime())) return null;
+	const formattedDate = d.toLocaleDateString(void 0, {
+		year: "numeric",
+		month: "long",
+		day: "numeric"
+	});
+	return /* @__PURE__ */ jsxs("div", {
+		className: "mt-16 pt-6 border-t border-subtle flex items-center justify-between text-xs text-muted select-none",
+		children: [/* @__PURE__ */ jsx("span", {}), /* @__PURE__ */ jsxs("span", {
+			className: "italic",
+			children: ["Last updated on ", formattedDate]
+		})]
+	});
+}
+
+//#endregion
+//#region src/client/app/doc-page.tsx
+/**
+* DocPage renders the MDX content and page-specific metadata.
+* It is rendered inside the Outlet of DocsLayout.
+*/
+function DocPage({ route, content: Content, mdxComponents: propComponents }) {
+	const contextComponents = useMdxComponents();
+	const allComponents = useMemo(() => ({
+		LastUpdated,
+		...contextComponents,
+		...propComponents
+	}), [contextComponents, propComponents]);
+	const LastUpdated$1 = allComponents.LastUpdated || LastUpdated;
+	if (!Content) return null;
+	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(Content, { components: allComponents }), route?.lastUpdated && /* @__PURE__ */ jsx(LastUpdated$1, { date: route.lastUpdated })] });
+}
+
+//#endregion
+//#region src/client/ssg/mdx-page.tsx
+/**
+* Renders an MDX page by consuming pre-loaded module data.
+* Uses DocPage to ensure consistent layout and metadata application.
+*/
+function MdxPage({ MDXComponent: propMDX, mdxComponents: propComponents }) {
+	const data = useLoaderData();
+	const MDXComponent = propMDX || data?.MDXComponent;
+	const components = propComponents || data?.mdxComponents;
+	if (!MDXComponent) return null;
+	return /* @__PURE__ */ jsx(DocPage, {
+		route: {
+			path: data.path,
+			filePath: data.filePath,
+			title: data.frontmatter.title,
+			description: data.frontmatter.description,
+			headings: data.headings,
+			locale: data.locale,
+			version: data.version,
+			group: data.group,
+			groupTitle: data.groupTitle,
+			lastUpdated: data.lastUpdated,
+			frontmatter: data.frontmatter
+		},
+		content: MDXComponent,
+		mdxComponents: components
+	});
+}
+
+//#endregion
+//#region src/client/app/helmet-compat.tsx
+const mod = ReactHelmetAsync;
+/**
+* The `<Helmet>` component, resolved across CJS/ESM module shapes.
+* Falls back to a transparent fragment wrapper if the module cannot be resolved.
+*/
+const Helmet = mod.Helmet || mod.default?.Helmet || (({ children }) => /* @__PURE__ */ jsx(Fragment, { children }));
+/**
+* The `<HelmetProvider>` component, resolved across CJS/ESM module shapes.
+* Falls back to a transparent fragment wrapper if the module cannot be resolved.
+*/
+const HelmetProvider = mod.HelmetProvider || mod.default?.HelmetProvider || (({ children }) => /* @__PURE__ */ jsx(Fragment, { children }));
+
+//#endregion
+//#region src/client/app/scroll-handler.tsx
+/**
+* Handles scroll restoration and hash scrolling on navigation.
+* It ensures the page scrolls to top on pathname changes,
+* or specifically to an anchor element if a hash is present.
+*/
+function ScrollHandler() {
+	const { pathname, hash } = useLocation$1();
+	const handleScroll = (behavior = "auto") => {
+		const container = document.querySelector(".boltdocs-content") || window;
+		const getScrollTop = () => {
+			if (container === window) return window.scrollY;
+			return container.scrollTop;
+		};
+		const scrollTo = (top, scrollBehavior) => {
+			if (container === window) window.scrollTo({
+				top,
+				behavior: scrollBehavior
+			});
+			else container.scrollTo({
+				top,
+				behavior: scrollBehavior
+			});
+		};
+		if (hash) {
+			const id = hash.replace("#", "");
+			const element = document.getElementById(id);
+			if (element) {
+				const offset = 80;
+				const containerTop = container === window ? 0 : container.getBoundingClientRect().top;
+				scrollTo(element.getBoundingClientRect().top - containerTop - offset + getScrollTop(), behavior);
+				return true;
+			}
+		}
+		scrollTo(0, behavior);
+		return false;
+	};
+	useLayoutEffect(() => {
+		handleScroll("auto");
+	}, [pathname, hash]);
+	useEffect(() => {
+		handleScroll("auto");
+		const rafId = requestAnimationFrame(() => {
+			handleScroll("auto");
+			window.dispatchEvent(new Event("resize"));
+		});
+		return () => cancelAnimationFrame(rafId);
+	}, [pathname, hash]);
+	return null;
+}
+
+//#endregion
+//#region src/client/app/mdx-component.tsx
+const mdxComponentsDefault = {
+	...mdx_components_default,
+	NotFound,
+	"404": NotFound
+};
+
+//#endregion
+//#region src/client/ssg/boltdocs-shell.tsx
+/** Normalize a path: strip trailing slash unless it is exactly '/'. */
+function normalizePath(p) {
+	return p.endsWith("/") && p.length > 1 ? p.slice(0, -1) : p;
+}
+/**
+* Updates the HTML lang and dir attributes based on the current locale configuration.
+*/
+function I18nUpdater({ config }) {
+	const { currentLocale } = useBoltdocsContext();
+	useEffect(() => {
+		if (!config.i18n || typeof document === "undefined") return;
+		const locale = currentLocale || config.i18n.defaultLocale;
+		const localeConfig = config.i18n.localeConfigs?.[locale];
+		document.documentElement.lang = localeConfig?.htmlLang || locale || "en";
+		document.documentElement.dir = localeConfig?.direction || "ltr";
+	}, [currentLocale, config.i18n]);
+	return null;
+}
+/**
+* Synchronizes the Zustand store with the current URL pathname.
+* Receives a pre-built Map for O(1) route lookups instead of O(n) .find().
+*/
+function StoreSync({ config, routeMap }) {
+	const location = useLocation$1();
+	const { setLocale, setVersion } = useBoltdocsContext();
+	useEffect(() => {
+		const currentPath = normalizePath(location.pathname);
+		const matchedRoute = routeMap.get(currentPath);
+		if (matchedRoute) {
+			if (config.i18n) setLocale(matchedRoute.locale || config.i18n.defaultLocale);
+			if (config.versions) setVersion(matchedRoute.version || config.versions.defaultVersion);
+		}
+	}, [
+		location.pathname,
+		config,
+		routeMap,
+		setLocale,
+		setVersion
+	]);
+	return null;
+}
+function BoltdocsShell({ config, routes, components = {} }) {
+	const allComponents = useMemo(() => ({
+		...mdxComponentsDefault,
+		...virtualCustomComponents,
+		...components
+	}), [components]);
+	const { pathname } = useLocation$1();
+	const currentPath = useMemo(() => normalizePath(pathname || "/"), [pathname]);
+	const routeMap = useMemo(() => {
+		const map = /* @__PURE__ */ new Map();
+		for (const r of routes) {
+			const key = normalizePath(r.path === "" ? "/" : r.path);
+			map.set(key, r);
+		}
+		return map;
+	}, [routes]);
+	const initialData = useMemo(() => {
+		const matched = routeMap.get(currentPath);
+		let initLocale = void 0;
+		let initVersion = void 0;
+		if (matched) {
+			if (config.i18n) initLocale = matched.locale || config.i18n.defaultLocale;
+			if (config.versions) initVersion = matched.version || config.versions.defaultVersion;
+		}
+		return {
+			initLocale,
+			initVersion
+		};
+	}, [
+		currentPath,
+		config,
+		routeMap
+	]);
+	return /* @__PURE__ */ jsx(HelmetProvider, { children: /* @__PURE__ */ jsx(RoutesProvider, {
+		routes,
+		children: /* @__PURE__ */ jsx(ThemeProvider, { children: /* @__PURE__ */ jsx(UIProvider, { children: /* @__PURE__ */ jsx(MdxComponentsProvider, {
+			components: allComponents,
+			children: /* @__PURE__ */ jsxs(ConfigContext.Provider, {
+				value: config,
+				children: [/* @__PURE__ */ jsx(ScrollHandler, {}), /* @__PURE__ */ jsxs(BoltdocsProvider, {
+					initialLocale: initialData.initLocale,
+					initialVersion: initialData.initVersion,
+					children: [
+						/* @__PURE__ */ jsx(StoreSync, {
+							config,
+							routeMap
+						}),
+						/* @__PURE__ */ jsx(I18nUpdater, { config }),
+						/* @__PURE__ */ jsx(Outlet, {})
+					]
+				})]
+			})
+		}) }) })
+	}) });
+}
+
+//#endregion
+//#region src/client/app/head.tsx
+function Head({ siteTitle, siteDescription, routes }) {
+	const location = useLocation$1();
+	const config = useConfig();
+	const { currentLocale } = useRoutes();
+	const currentRoute = useMemo(() => routes?.find?.((r) => r.path === location.pathname), [routes, location.pathname]);
+	const pageTitle = currentRoute?.title;
+	const translatedSiteDescription = getTranslated(siteDescription, currentLocale);
+	const pageDescription = currentRoute?.description || translatedSiteDescription || "";
+	const translatedSiteTitle = getTranslated(siteTitle, currentLocale);
+	const finalTitle = pageTitle ? `${pageTitle} | ${translatedSiteTitle}` : translatedSiteTitle;
+	const seo = currentRoute?.seo || {};
+	const globalMetatags = config?.seo?.metatags || {};
+	const defaultOgImage = config?.seo?.thumbnails?.background;
+	const ogImage = seo["og:image"] || defaultOgImage;
+	return /* @__PURE__ */ jsxs(Helmet, { children: [
+		/* @__PURE__ */ jsx("title", { children: finalTitle }),
+		/* @__PURE__ */ jsx("meta", {
+			name: "description",
+			content: pageDescription
+		}),
+		/* @__PURE__ */ jsx("meta", {
+			property: "og:title",
+			content: finalTitle
+		}),
+		/* @__PURE__ */ jsx("meta", {
+			property: "og:description",
+			content: pageDescription
+		}),
+		/* @__PURE__ */ jsx("meta", {
+			property: "og:type",
+			content: "article"
+		}),
+		typeof window !== "undefined" && /* @__PURE__ */ jsx("meta", {
+			property: "og:url",
+			content: window.location.href
+		}),
+		typeof window !== "undefined" && /* @__PURE__ */ jsx("link", {
+			rel: "canonical",
+			href: window.location.origin + location.pathname
+		}),
+		/* @__PURE__ */ jsx("meta", {
+			name: "twitter:card",
+			content: "summary"
+		}),
+		/* @__PURE__ */ jsx("meta", {
+			name: "twitter:title",
+			content: finalTitle
+		}),
+		/* @__PURE__ */ jsx("meta", {
+			name: "twitter:description",
+			content: pageDescription
+		}),
+		ogImage && /* @__PURE__ */ jsx("meta", {
+			name: "twitter:image",
+			content: ogImage
+		}),
+		ogImage && /* @__PURE__ */ jsx("meta", {
+			property: "og:image",
+			content: ogImage
+		}),
+		/* @__PURE__ */ jsx("meta", {
+			name: "generator",
+			content: "Boltdocs"
+		}),
+		Object.entries(globalMetatags).map(([key, value]) => {
+			return key.startsWith("og:") || key.startsWith("music:") || key.startsWith("video:") || key.startsWith("article:") || key.startsWith("book:") || key.startsWith("profile:") ? /* @__PURE__ */ jsx("meta", {
+				property: key,
+				content: value
+			}, key) : /* @__PURE__ */ jsx("meta", {
+				name: key,
+				content: value
+			}, key);
+		}),
+		Object.entries(seo).map(([key, value]) => {
+			if (key === "noindex" && value === true) return /* @__PURE__ */ jsx("meta", {
+				name: "robots",
+				content: "noindex"
+			}, "noindex");
+			if (key === "robots") return /* @__PURE__ */ jsx("meta", {
+				name: "robots",
+				content: value
+			}, "robots");
+			if (key === "canonical") return /* @__PURE__ */ jsx("link", {
+				rel: "canonical",
+				href: value
+			}, "canonical");
+			return key.startsWith("og:") || key.startsWith("music:") || key.startsWith("video:") || key.startsWith("article:") || key.startsWith("book:") || key.startsWith("profile:") ? /* @__PURE__ */ jsx("meta", {
+				property: key,
+				content: value
+			}, key) : /* @__PURE__ */ jsx("meta", {
+				name: key,
+				content: value
+			}, key);
+		})
+	] });
+}
+
+//#endregion
+//#region src/client/app/docs-layout.tsx
+/**
+* Wraps the docs Outlet with the user's (or default) layout component.
+* The Layout receives the routed page as `children`.
+* We use useRoutes to pass the current route context to the persistent layout.
+*/
+function DocsLayout$1() {
+	const config = useConfig();
+	const { currentRoute, allRoutes } = useRoutes();
+	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(Head, {
+		siteTitle: config.theme?.title,
+		siteDescription: config.theme?.description,
+		routes: allRoutes || []
+	}), /* @__PURE__ */ jsx(UserLayout, {
+		route: currentRoute,
+		children: /* @__PURE__ */ jsx(Outlet, {})
+	})] });
+}
+
+//#endregion
+//#region src/client/ssg/create-routes.tsx
+const Loading = () => /* @__PURE__ */ jsx("div", {
+	className: "text-muted text-sm py-4",
+	children: "Loading..."
+});
+/**
+* Stable component to render MDX pages.
+* By being outside createRoutes, it prevents React from unmounting the page on HMR.
+*/
+const MdxRouteElement = ({ moduleLoader, moduleKey, route, components }) => {
+	const MDXComponent = moduleLoader?.default ?? moduleLoader ?? null;
+	useEffect(() => {
+		if (!import.meta.hot || !moduleKey) return;
+		const handler = (data) => {
+			if (data.relPath.replace(/\\/g, "/").replace(/^\//, "") !== route.filePath.replace(/\\/g, "/").replace(/^\//, "")) return;
+			import(moduleKey + "?t=" + Date.now()).then((m) => {});
+		};
+		import.meta.hot.on("boltdocs:mdx-update", handler);
+		return () => import.meta.hot?.off("boltdocs:mdx-update", handler);
+	}, [moduleKey, route.filePath]);
+	if (!MDXComponent) return /* @__PURE__ */ jsx(Loading, {});
+	return /* @__PURE__ */ jsx(MdxPage, {
+		MDXComponent,
+		mdxComponents: components
+	});
+};
+const NotFoundWrapper = () => {
+	const components = useMdxComponents();
+	return /* @__PURE__ */ jsx(components.NotFound || components["404"] || NotFound, {});
+};
+function createRoutes(options) {
+	const { routesData, config, mdxModules, externalPages, externalLayout, components } = options;
+	const EffectiveExternalLayout = externalLayout || (({ children }) => /* @__PURE__ */ jsx(Fragment, { children }));
+	const withBase = (path) => {
+		const base = config.base || "/";
+		if (path.startsWith(base)) return path;
+		return `${base === "/" ? "" : base.replace(/\/$/, "")}${path.startsWith("/") ? path : `/${path}`}` || "/";
+	};
+	const defaultVersionMetadata = [];
+	const defaultVersion = config.versions?.defaultVersion;
+	const docsBase = (config.base || "/docs").replace(/\/$/, "");
+	let baseDocsPath = (config.base || "/docs").replace(/\/$/, "");
+	if (!baseDocsPath) baseDocsPath = "/";
+	if (defaultVersion) routesData.forEach((route) => {
+		if (route.version) return;
+		const p = route.path || "";
+		const subPath = p.startsWith(docsBase) ? p.substring(docsBase.length).replace(/^\//, "") : p.replace(/^\//, "");
+		if (!(subPath === defaultVersion || subPath.startsWith(`${defaultVersion}/`))) {
+			const explicitPath = `${docsBase}/${defaultVersion}/${subPath}`.replace(/\/+/g, "/").replace(/\/$/, "") || "/";
+			defaultVersionMetadata.push({
+				...route,
+				path: explicitPath,
+				version: defaultVersion
+			});
+		}
+	});
+	const docMetadata = [...routesData, ...defaultVersionMetadata];
+	const moduleMap = /* @__PURE__ */ new Map();
+	const mdxModuleKeys = Object.keys(mdxModules);
+	if (mdxModuleKeys.length > 0) {
+		const docsDirName = mdxModuleKeys[0].replace(/\\/g, "/").split("/").filter(Boolean)[0] || "docs";
+		const primaryPrefix = `/${docsDirName}/`;
+		const altPrefix = `./${docsDirName}/`;
+		for (const rawKey of mdxModuleKeys) {
+			const k = rawKey.replace(/\\/g, "/");
+			let relativePath = "";
+			if (k.indexOf(primaryPrefix) !== -1) relativePath = k.substring(k.indexOf(primaryPrefix) + primaryPrefix.length);
+			else if (k.startsWith(altPrefix)) relativePath = k.substring(altPrefix.length);
+			if (relativePath) moduleMap.set(relativePath, rawKey);
+			else moduleMap.set(k, rawKey);
+		}
+	}
+	const docRoutes = docMetadata.map((route) => {
+		const normalizedFilePath = route.filePath.replace(/\\/g, "/");
+		const moduleKey = moduleMap.get(normalizedFilePath);
+		const moduleLoader = moduleKey ? mdxModules[moduleKey] : null;
+		const fullPath = withBase(route.path === "" ? "/" : route.path);
+		const path = fullPath === baseDocsPath ? "." : fullPath.startsWith(baseDocsPath + "/") ? fullPath.slice(baseDocsPath.length + 1) : fullPath;
+		return {
+			path,
+			element: /* @__PURE__ */ jsx(MdxRouteElement, {
+				moduleKey,
+				moduleLoader,
+				route,
+				components
+			}, moduleKey || path),
+			loader: async () => ({
+				path,
+				frontmatter: {
+					title: route.title,
+					description: route.description || "",
+					...route.frontmatter || {}
+				},
+				headings: route.headings || [],
+				filePath: route.filePath,
+				locale: route.locale,
+				version: route.version,
+				group: route.group,
+				groupTitle: route.groupTitle,
+				date: route.date,
+				lastUpdated: route.lastUpdated
+			}),
+			getStaticPaths: () => [path]
+		};
+	});
+	const locales = config.i18n?.locales ? Array.isArray(config.i18n.locales) ? config.i18n.locales : Object.keys(config.i18n.locales) : [];
+	const allVersions = config.versions?.versions?.map((v) => v.path) || [];
+	const targetBasePaths = [];
+	targetBasePaths.push({
+		path: baseDocsPath,
+		filter: () => true
+	});
+	const subPaths = [];
+	if (allVersions.length > 0) allVersions.forEach((v) => subPaths.push(`/${v}`));
+	if (locales.length > 0) locales.forEach((l) => subPaths.push(`/${l}`));
+	if (allVersions.length > 0 && locales.length > 0) allVersions.forEach((v) => {
+		locales.forEach((l) => {
+			subPaths.push(`/${v}/${l}`);
+		});
+	});
+	subPaths.forEach((sp) => {
+		const fullP = baseDocsPath === "/" ? sp : `${baseDocsPath}${sp}`;
+		targetBasePaths.push({
+			path: fullP,
+			filter: (rp) => rp.startsWith(fullP.replace(/\/$/, "") + "/")
+		});
+	});
+	const docPathRegistry = new Set(docRoutes.map((r) => (r.path || "").replace(/\/$/, "")));
+	const externalPaths = /* @__PURE__ */ new Set();
+	if (externalPages) Object.keys(externalPages).forEach((rawPath) => {
+		const p = rawPath.startsWith("/") ? rawPath : `/${rawPath}`;
+		externalPaths.add(p.replace(/\/$/, ""));
+		if (config.i18n) Object.keys(config.i18n.locales).forEach((locale) => {
+			externalPaths.add(`/${locale}${p === "/" ? "" : p}`.replace(/\/$/, ""));
+		});
+	});
+	targetBasePaths.forEach(({ path: bPath, filter }) => {
+		if (bPath === "/") return;
+		const normalizedPath = bPath.replace(/\/$/, "");
+		if (!(docPathRegistry.has(normalizedPath) || externalPaths.has(normalizedPath))) {
+			const defaultTab = config.theme?.tabs?.[0]?.id;
+			const defaultTabPath = defaultTab ? `${normalizedPath}/${defaultTab}`.replace(/\/+/g, "/") : null;
+			let matchedRouteObj = defaultTabPath && docPathRegistry.has(defaultTabPath.replace(/\/$/, "")) ? docRoutes.find((r) => r.path.replace(/\/$/, "") === defaultTabPath.replace(/\/$/, "")) : docRoutes.find((r) => filter(r.path) && r.path !== normalizedPath);
+			if (!matchedRouteObj && docRoutes.length > 0) matchedRouteObj = docRoutes[0];
+			if (matchedRouteObj) {
+				const redirectPath = bPath === baseDocsPath ? "." : bPath.startsWith(baseDocsPath + "/") ? bPath.slice(baseDocsPath.length + 1) : bPath;
+				const isBasePathFallback = redirectPath === ".";
+				docRoutes.push({
+					...isBasePathFallback ? { index: true } : { path: redirectPath },
+					element: matchedRouteObj.element,
+					loader: matchedRouteObj.loader,
+					getStaticPaths: () => []
+				});
+				const matchedMetaObj = docMetadata.find((m) => {
+					const fullPath = withBase(m.path === "" ? "/" : m.path);
+					return (fullPath === baseDocsPath ? "." : fullPath.startsWith(baseDocsPath + "/") ? fullPath.slice(baseDocsPath.length + 1) : fullPath) === matchedRouteObj.path;
+				});
+				if (matchedMetaObj) {
+					const canonicalPath = withBase(matchedMetaObj.path);
+					const canonicalUrl = config.siteUrl ? `${config.siteUrl.replace(/\/$/, "")}${canonicalPath}` : canonicalPath;
+					docMetadata.push({
+						...matchedMetaObj,
+						path: bPath,
+						filePath: "",
+						slugParts: [],
+						seo: {
+							...matchedMetaObj.seo,
+							canonical: canonicalUrl
+						}
+					});
+				}
+			}
+		}
+	});
+	const children = [{
+		path: baseDocsPath,
+		element: /* @__PURE__ */ jsx(DocsLayout$1, {}),
+		children: docRoutes
+	}];
+	const externalMetadata = [];
+	if (externalPages) Object.entries(externalPages).forEach(([rawPath, ExtComponent]) => {
+		const path = rawPath.startsWith("/") ? rawPath : `/${rawPath}`;
+		if (!children.find((r) => r.path === path)) {
+			externalMetadata.push({
+				path,
+				locale: config.i18n?.defaultLocale,
+				title: rawPath === "/" ? "Home" : rawPath.replace(/^\//, "").split("/").pop() || "Page",
+				filePath: "",
+				headings: []
+			});
+			children.push({
+				path,
+				element: /* @__PURE__ */ jsx(EffectiveExternalLayout, { children: /* @__PURE__ */ jsx(ExtComponent, {}) }),
+				loader: async () => ({
+					path,
+					locale: config.i18n?.defaultLocale
+				}),
+				getStaticPaths: () => [path]
+			});
+			if (config.i18n) Object.keys(config.i18n.locales).forEach((locale) => {
+				const localePath = `/${locale}${rawPath === "/" ? "" : rawPath}`;
+				if (!children.find((r) => r.path === localePath)) {
+					externalMetadata.push({
+						path: localePath,
+						locale,
+						title: rawPath,
+						filePath: "",
+						headings: []
+					});
+					children.push({
+						path: localePath,
+						element: /* @__PURE__ */ jsx(EffectiveExternalLayout, { children: /* @__PURE__ */ jsx(ExtComponent, {}) }),
+						loader: async () => ({
+							path: localePath,
+							locale
+						}),
+						getStaticPaths: () => [localePath]
+					});
+				}
+			});
+		}
+	});
+	children.push({
+		path: "*",
+		element: /* @__PURE__ */ jsx(EffectiveExternalLayout, { children: /* @__PURE__ */ jsx(NotFoundWrapper, {}) })
+	});
+	return [{
+		element: /* @__PURE__ */ jsx(BoltdocsShell, {
+			config,
+			routes: [...docMetadata, ...externalMetadata],
+			components
+		}),
+		children
+	}];
+}
+
+//#endregion
+//#region src/client/hooks/use-analytics.ts
+function createAnalyticsInstance(config) {
+	if (typeof window === "undefined") return createDisabledAnalytics();
+	if (typeof window.gtag === "function") return createGtagAnalytics(config);
+	if (window.dataLayer) return createDataLayerAnalytics(config);
+	return createDisabledAnalytics();
+}
+function createGtagAnalytics(config) {
+	return {
+		trackPageView: (path, title) => {
+			window.gtag?.("event", "page_view", {
+				page_path: path,
+				page_title: title || document.title,
+				send_to: config?.ga4?.measurementId
+			});
+		},
+		trackEvent: ({ action, category, label, value, params }) => {
+			window.gtag?.("event", action, {
+				event_category: category,
+				event_label: label,
+				value,
+				send_to: config?.ga4?.measurementId,
+				...params
+			});
+		},
+		trackSearch: (query, resultsCount) => {
+			window.gtag?.("event", "search", {
+				search_term: query,
+				results_count: resultsCount,
+				send_to: config?.ga4?.measurementId
+			});
+		},
+		trackDownload: (file, type) => {
+			window.gtag?.("event", "file_download", {
+				file_name: file,
+				file_type: type || file.split(".").pop(),
+				send_to: config?.ga4?.measurementId
+			});
+		},
+		trackExternalLink: (url) => {
+			window.gtag?.("event", "external_link", {
+				link_url: url,
+				send_to: config?.ga4?.measurementId
+			});
+		},
+		isEnabled: true
+	};
+}
+function createDataLayerAnalytics(config) {
+	return {
+		trackPageView: (path, title) => {
+			window.dataLayer?.push({
+				event: "page_view",
+				page_path: path,
+				page_title: title || document.title,
+				send_to: config?.gtm?.tagId
+			});
+		},
+		trackEvent: ({ action, category, label, value, params }) => {
+			window.dataLayer?.push({
+				event: action,
+				event_category: category,
+				event_label: label,
+				value,
+				send_to: config?.gtm?.tagId,
+				...params
+			});
+		},
+		trackSearch: (query, resultsCount) => {
+			window.dataLayer?.push({
+				event: "search",
+				search_term: query,
+				results_count: resultsCount,
+				send_to: config?.gtm?.tagId
+			});
+		},
+		trackDownload: (file, type) => {
+			window.dataLayer?.push({
+				event: "file_download",
+				file_name: file,
+				file_type: type || file.split(".").pop(),
+				send_to: config?.gtm?.tagId
+			});
+		},
+		trackExternalLink: (url) => {
+			window.dataLayer?.push({
+				event: "external_link",
+				link_url: url,
+				send_to: config?.gtm?.tagId
+			});
+		},
+		isEnabled: true
+	};
+}
+function createDisabledAnalytics() {
+	return {
+		trackPageView: () => {},
+		trackEvent: () => {},
+		trackSearch: () => {},
+		trackDownload: () => {},
+		trackExternalLink: () => {},
+		isEnabled: false
+	};
+}
+const CONFIG_INSTANCE_SYMBOL = Symbol.for("__BDOCS_CONFIG_INSTANCE__");
+function useAnalytics(options = {}) {
+	const { config: optionsConfig, autoTrackPageViews = true, autoTrackDownloads = true, autoTrackExternalLinks = true, excludePatterns = [] } = options;
+	const globalConfig = typeof globalThis !== "undefined" ? globalThis[CONFIG_INSTANCE_SYMBOL] : void 0;
+	const config = optionsConfig ?? globalConfig?.integrations;
+	const analytics = useMemo(() => createAnalyticsInstance(config), [config]);
+	const previousPath = useRef("");
+	const location = useLocation();
+	useEffect(() => {
+		if (!autoTrackPageViews || !analytics.isEnabled) return;
+		const path = location.pathname + location.search;
+		if (path !== previousPath.current) {
+			previousPath.current = path;
+			analytics.trackPageView(path, document.title);
+		}
+	}, [
+		location.pathname,
+		autoTrackPageViews,
+		analytics
+	]);
+	useEffect(() => {
+		if (!autoTrackDownloads || !analytics.isEnabled) return;
+		const handleClick = (event) => {
+			const target = event.target?.closest("a");
+			if (!target) return;
+			const href = target.getAttribute("href");
+			if (!href) return;
+			if (excludePatterns.some((pattern) => pattern.test(href))) return;
+			if (target.hasAttribute("download") || /\.(pdf|doc|docx|xls|xlsx|ppt|pptx|zip|rar|7z|tar|gz|mp3|mp4|avi|mov|png|jpg|jpeg|gif|svg|webp)$/i.test(href)) {
+				const fileName = href.split("/").pop() || href;
+				analytics.trackDownload(fileName, fileName.split(".").pop());
+			}
+		};
+		document.addEventListener("click", handleClick);
+		return () => document.removeEventListener("click", handleClick);
+	}, [
+		autoTrackDownloads,
+		autoTrackExternalLinks,
+		analytics,
+		excludePatterns
+	]);
+	useEffect(() => {
+		if (!autoTrackExternalLinks || !analytics.isEnabled) return;
+		const handleClick = (event) => {
+			const target = event.target?.closest("a");
+			if (!target) return;
+			const href = target.getAttribute("href");
+			if (!href) return;
+			if (excludePatterns.some((pattern) => pattern.test(href))) return;
+			if ((href.startsWith("http://") || href.startsWith("https://") || href.startsWith("//")) && !href.includes(window.location.hostname)) analytics.trackExternalLink(href);
+		};
+		document.addEventListener("click", handleClick);
+		return () => document.removeEventListener("click", handleClick);
+	}, [
+		autoTrackExternalLinks,
+		analytics,
+		excludePatterns
+	]);
+	return analytics;
+}
+function useTrackPageView() {
+	const analytics = useMemo(() => createAnalyticsInstance(), []);
+	return useCallback((path, title) => {
+		analytics.trackPageView(path, title);
+	}, [analytics]);
+}
+function useTrackEvent() {
+	const analytics = useMemo(() => createAnalyticsInstance(), []);
+	return useCallback((event) => {
+		analytics.trackEvent(event);
+	}, [analytics]);
+}
+
+//#endregion
+//#region src/client/components/docs-layout-default.tsx
+/**
+* Pre-assembled high-fidelity documentation layout component.
+* Fully styled and optimized to adapt seamlessly to our custom Parchment/Slate theme.
+*/
+function DocsLayoutComponent({ children }) {
+	const { routes: filteredRoutes, currentRoute } = useRoutes();
+	const config = useConfig();
+	return /* @__PURE__ */ jsxs(DocsLayout$2, {
+		className: "selection:bg-primary-500/10 selection:text-primary-500",
+		children: [/* @__PURE__ */ jsx(Navbar, {}), /* @__PURE__ */ jsxs(DocsLayout$2.Body, {
+			className: "bg-main",
+			children: [
+				/* @__PURE__ */ jsx(Sidebar, {
+					routes: filteredRoutes || [],
+					config
+				}),
+				/* @__PURE__ */ jsx(DocsLayout$2.Content, {
+					className: "animate-in fade-in duration-500 scroll-smooth",
+					children: /* @__PURE__ */ jsxs(DocsLayout$2.ContentMdx, {
+						className: "max-w-3xl sm:max-w-4xl lg:max-w-4xl px-2 pt-8 pb-24",
+						children: [
+							/* @__PURE__ */ jsxs(DocsLayout$2.Header, { children: [
+								/* @__PURE__ */ jsxs("div", {
+									className: "mb-4 border-b border-subtle pb-4 flex flex-wrap items-center justify-between gap-3",
+									children: [/* @__PURE__ */ jsx(Breadcrumbs, {}), /* @__PURE__ */ jsx(CopyMarkdown, {
+										mdxRaw: currentRoute?._rawContent,
+										route: currentRoute
+									})]
+								}),
+								currentRoute?.title && /* @__PURE__ */ jsx("h1", {
+									className: "text-4xl font-bold tracking-tight text-default mb-3",
+									children: currentRoute.title
+								}),
+								currentRoute?.description && /* @__PURE__ */ jsx("p", {
+									className: "text-lg text-muted-foreground mb-6 leading-relaxed",
+									children: currentRoute.description
+								})
+							] }),
+							/* @__PURE__ */ jsx(ErrorBoundary, { children: /* @__PURE__ */ jsx("div", {
+								className: "prose prose-neutral dark:prose-invert max-w-none",
+								children
+							}) }),
+							/* @__PURE__ */ jsx(DocsLayout$2.Footer, { children: /* @__PURE__ */ jsx(PageNav, {}) })
+						]
+					})
+				}),
+				/* @__PURE__ */ jsx(OnThisPage, {
+					headings: currentRoute?.headings,
+					editLink: config.theme?.editLink,
+					communityHelp: config.theme?.communityHelp,
+					filePath: currentRoute?.filePath
+				})
+			]
+		})]
+	});
+}
+const DocsLayout = Object.assign(DocsLayoutComponent, {
+	Body: DocsLayout$2.Body,
+	Content: DocsLayout$2.Content,
+	ContentMdx: DocsLayout$2.ContentMdx,
+	Header: DocsLayout$2.Header,
+	Footer: DocsLayout$2.Footer
+});
+
+//#endregion
+export { BoltdocsShell, Breadcrumbs, Card, Cards, CopyMarkdown, DocsLayout, ErrorBoundary, MdxPage, Navbar, NotFound, OnThisPage, PageNav, SearchDialog, Sidebar, ViteReactSSG, cn, copyToClipboard, createRoutes, getStarsRepo, getTranslated, reactToText, useAnalytics, useBreadcrumbs, useConfig, useI18n, useLocalizedTo, useLocation, useMdxComponents, useNavbar, usePageNav, useRoutes, useSearch, useSearchHighlight, useSidebar, useTabs, useTheme, useTrackEvent, useTrackPageView, useUI, useVersion };