boltdocs 1.11.0 → 2.0.0

package/dist/node/index.mjs

@@ -0,0 +1,57 @@
+import{a as $,b as G,c as H,d as it,e as nt,f as D,g as J,h as rt,i as _,j as X,k as j,l as st,m as at}from"../chunk-MFU7Q6WF.mjs";import"../chunk-JZXLCA2E.mjs";import{loadEnv as zt}from"vite";import jt from"fast-glob";var R=new st({name:"routes"});function K(){R.invalidateAll()}function Z(o){R.invalidate(o)}import F from"path";import Dt from"github-slugger";function lt(o,r,i,p){let e=decodeURIComponent(o),c=F.resolve(e),l=F.resolve(r),u=$(F.relative(l,c));if(u.startsWith("../")||u===".."||c.includes("\0"))throw new Error(`Security breach: File is outside of docs directory or contains null bytes: ${o}`);let{data:t,content:n}=nt(o),s=u.split("/"),a,f;if(p?.versions&&s.length>0){let C=s[0];p.versions.versions[C]&&(f=C,s=s.slice(1))}if(p?.i18n&&s.length>0){let C=s[0];p.i18n.locales[C]&&(a=C,s=s.slice(1))}let v;if(s.length>0){let C=s[0].match(/^\((.+)\)$/);C&&(v=C[1].toLowerCase(),s=s.slice(1))}let d=s.join("/"),m;t.permalink?m=t.permalink.startsWith("/")?t.permalink:`/${t.permalink}`:m=rt(d||"index.md");let g=i;f&&(g+="/"+f),a&&(g+="/"+a),g+=m==="/"?"":m,(!g||g==="")&&(g="/");let y=s[s.length-1],k=G(y),x=G(F.basename(o,F.extname(o))),h=t.sidebarPosition??H(y),w=s.length>=2?s[0]:void 0,S=w?G(w):void 0,L=s.length>=2&&/^index\.mdx?$/.test(k),$t=new Dt,tt=[],wt=/^(#{2,4})\s+(.+)$/gm,V;for(;(V=wt.exec(n))!==null;){let C=V[1].length,St=V[2].replace(/\[([^\]]+)\]\([^\)]+\)/g,"$1").replace(/[_*`]/g,"").trim(),ot=_(St).trim(),Mt=$t.slug(ot);tt.push({level:C,text:ot,id:Mt})}let kt=t.title?_(String(t.title)):x,W=t.description?_(String(t.description)):"";!W&&n&&(W=X(n.replace(/^#+.*$/gm,"").replace(/\[([^\]]+)\]\([^\)]+\)/g,"$1").replace(/[_*`]/g,"").replace(/\s+/g," ")).trim().slice(0,160));let Rt=t.badge?_(String(t.badge)):void 0,et=t.icon?String(t.icon):void 0,Bt=Tt(n);return{route:{path:g,componentPath:o,filePath:u,title:kt,description:W,sidebarPosition:h,headings:tt,locale:a,version:f,badge:Rt,icon:et,tab:v,_content:Bt,_rawContent:n},relativeDir:S,isGroupIndex:L,inferredTab:v,groupMeta:L?{title:t.groupTitle||t.title||(S?j(S):""),position:t.groupPosition??t.sidebarPosition??(w?H(w):void 0),icon:et}:void 0,inferredGroupPosition:w?H(w):void 0}}function Tt(o){let r=o.replace(/^#+.*$/gm,"").replace(/\[([^\]]+)\]\([^\)]+\)/g,"$1").replace(/\{[^\}]+\}/g,"").replace(/[_*`]/g,"").replace(/\s+/g," ");return X(r).trim()}function dt(o){return o.sort((r,i)=>!r.group&&!i.group?ct(r,i):r.group?i.group?r.group!==i.group?_t(r,i):ct(r,i):1:-1)}function ct(o,r){return o.sidebarPosition!==void 0&&r.sidebarPosition!==void 0?o.sidebarPosition-r.sidebarPosition:o.sidebarPosition!==void 0?-1:r.sidebarPosition!==void 0?1:o.title.localeCompare(r.title)}function _t(o,r){return o.groupPosition!==void 0&&r.groupPosition!==void 0?o.groupPosition-r.groupPosition:o.groupPosition!==void 0?-1:r.groupPosition!==void 0?1:(o.groupTitle||o.group).localeCompare(r.groupTitle||r.group)}var E=new Map;async function I(o,r,i="/docs"){let p=performance.now();R.load(),E.clear(),(process.env.BOLTDOCS_FORCE_REPARSE==="true"||r?.i18n)&&R.invalidateAll();let e=await jt(["**/*.md","**/*.mdx"],{cwd:o,absolute:!0,suppressErrors:!0,followSymbolicLinks:!1});R.pruneStale(new Set(e));let c=50,l=[],u=0;for(let d=0;d<e.length;d+=c){let m=e.slice(d,d+c),g=await Promise.all(m.map(async y=>{let k=R.get(y);if(k)return u++,k;let x=lt(y,o,i,r);return R.set(y,x),x}));l.push(...g),d+c<e.length&&await new Promise(y=>setImmediate(y))}R.save();let t=new Map,n=[];for(let d of l)if(d.isGroupIndex&&d.relativeDir&&n.push(d),d.relativeDir){let m=t.get(d.relativeDir);m?(m.position===void 0&&d.inferredGroupPosition!==void 0&&(m.position=d.inferredGroupPosition),!m.icon&&d.route.icon&&(m.icon=d.route.icon)):(m={title:j(d.relativeDir),position:d.inferredGroupPosition,icon:d.route.icon},t.set(d.relativeDir,m))}for(let d of n){let m=t.get(d.relativeDir);d.groupMeta&&(m.title=d.groupMeta.title,d.groupMeta.position!==void 0&&(m.position=d.groupMeta.position),d.groupMeta.icon&&(m.icon=d.groupMeta.icon))}let s=new Array(l.length);for(let d=0;d<l.length;d++){let m=l[d],g=m.relativeDir,y=g?t.get(g):void 0;s[d]={...m.route,group:g,groupTitle:y?.title||(g?j(g):void 0),groupPosition:y?.position,groupIcon:y?.icon}}let a=s;if(r?.i18n){let d=Ft(s,r,i);a=[...s,...d]}let f=dt(a),v=performance.now()-p;return console.log(`[boltdocs] Route generation: ${v.toFixed(2)}ms (${e.length} files, ${u} cache hits)`),f}function Ft(o,r,i){let p=r.i18n.defaultLocale,e=Object.keys(r.i18n.locales),c=[],l=new Map,u=[];for(let t of o){let n=t.locale||p;l.has(n)||l.set(n,new Set),l.get(n).add(t.path),n===p&&u.push(t)}for(let t of e){if(t===p)continue;let n=l.get(t)||new Set;for(let s of u){let a=Et(s.path,p,t,i);n.has(a)||c.push({...s,path:a,locale:t})}}return c}function Et(o,r,i,p){let e=`${o}:${i}`,c=E.get(e);if(c)return c;let l=p,u=o.match(new RegExp(`^${p}/(v[0-9]+)`));u&&(l+="/"+u[1]);let t=o.substring(l.length),n=`/${r}`;if(t.startsWith(n+"/"))t="/"+i+"/"+t.substring(n.length+1);else if(t===n)t="/"+i;else if(t==="/"||t==="")t="/"+i;else{let a=t.startsWith("/")?"":"/";t="/"+i+a+t}let s=l+t;return E.size>2e3&&E.clear(),E.set(e,s),s}import{ViteImageOptimizer as Ut}from"vite-plugin-image-optimizer";import Q from"path";import It from"fs";import{loadConfigFromFile as Ot}from"vite";var N=["boltdocs.config.js","boltdocs.config.mjs","boltdocs.config.ts"];async function z(o,r=process.cwd()){let i=r,p={docsDir:Q.resolve(o),themeConfig:{title:"Boltdocs",description:"A Vite documentation framework",navbar:[{label:"Home",href:"/"},{label:"Documentation",href:"/docs"}],codeTheme:{light:"github-light",dark:"github-dark"},poweredBy:!0,breadcrumbs:!0}},e={};for(let t of N){let n=Q.resolve(i,t);if(It.existsSync(n))try{let s=await Ot({command:"serve",mode:"development"},n,i);if(s){e=s.config;break}}catch(s){console.warn(`[boltdocs] Failed to load config from ${t}:`,s)}}let l={...{title:e.title,description:e.description,logo:e.logo,navbar:e.navbar,sidebar:e.sidebar,socialLinks:e.socialLinks,footer:e.footer,githubRepo:e.githubRepo,tabs:e.tabs},...e.themeConfig||{}},u=Object.fromEntries(Object.entries(l).filter(([t,n])=>n!==void 0));return u.navbar&&(u.navbar=u.navbar.map(t=>({label:t.label||t.text||"",href:t.href||t.link||t.to||"",items:t.items?.map(n=>({label:n.label||n.text||"",href:n.href||n.link||n.to||""}))}))),{docsDir:Q.resolve(o),themeConfig:{...p.themeConfig,...u,codeTheme:u.codeTheme||(e.themeConfig||e).codeTheme||p.themeConfig?.codeTheme},i18n:e.i18n,versions:e.versions,siteUrl:e.siteUrl,plugins:e.plugins||[],external:e.external,integrations:e.integrations}}import T from"fs";import M from"path";import{fileURLToPath as Lt}from"url";import{createRequire as Gt}from"module";function pt(o,r){let i=D(r.title),p=D(r.description);return o.replace(/<title>.*?<\/title>/,`<title>${i}</title>`).replace(/(<meta name="description" content=")[^"]*(")/,`$1${p}$2`).replace(/(<meta property="og:title" content=")[^"]*(")/,`$1${i}$2`).replace(/(<meta property="og:description" content=")[^"]*(")/,`$1${p}$2`).replace(/(<meta name="twitter:title" content=")[^"]*(")/,`$1${i}$2`).replace(/(<meta name="twitter:description" content=")[^"]*(")/,`$1${p}$2`)}function mt(o,r){let i=r?.siteUrl?.replace(/\/$/,"")||"https://example.com",p=new Date().toISOString().split("T")[0],e=[{url:"/",priority:"1.0",changefreq:"daily"}];if(r?.i18n){let l=r.i18n.defaultLocale;for(let u of Object.keys(r.i18n.locales))u!==l&&e.push({url:`/${u}/`,priority:"1.0",changefreq:"daily"})}return`<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${[...e,...o.map(l=>({url:l,priority:"0.8",changefreq:"weekly"}))].map(l=>`  <url>
+    <loc>${J(i)}${J(l.url)}</loc>
+    <lastmod>${p}</lastmod>
+    <changefreq>${l.changefreq}</changefreq>
+    <priority>${l.priority}</priority>
+  </url>`).join(`
+`)}
+</urlset>`}var Ht=Lt(import.meta.url),ut=M.dirname(Ht),gt=Gt(import.meta.url);async function Y(o){let{docsDir:r,docsDirName:i,outDir:p,config:e}=o,c=await I(r,e),l=e?.themeConfig?.title||"Boltdocs",u=e?.themeConfig?.description||"",t=M.resolve(ut,"../client/ssr.js");if(!T.existsSync(t)){console.error("[boltdocs] SSR module not found at",t,"- Did you build the core package?");return}let n=gt("module"),s=n.prototype.require;n.prototype.require=function(g,...y){return g==="virtual:boltdocs-layout"?{__esModule:!0,default:function(x){try{let w=s.apply(this,[M.resolve(ut,"../client/index.js")]).DefaultLayout||(({children:L})=>L);return s.apply(this,["react"]).createElement(w,x)}catch{return x.children}}}:s.apply(this,[g,...y])};let{render:a}=gt(t);n.prototype.require=s;let f=M.join(p,"index.html");if(!T.existsSync(f)){console.warn("[boltdocs] No index.html found in outDir, skipping SSG.");return}let v=T.readFileSync(f,"utf-8");await Promise.all(c.map(async g=>{let y=`${g.title} | ${l}`,k=g.description||u,x={};x[`/${i}/${g.filePath}`]={default:()=>null};try{let h=await a({path:g.path,routes:c,config:e||{},docsDirName:i,modules:x,homePage:void 0}),w=pt(v,{title:D(y),description:D(k)}).replace("<!--app-html-->",h).replace('<div id="root"></div>',`<div id="root">${h}</div>`),S=M.join(p,g.path);await T.promises.mkdir(S,{recursive:!0}),await T.promises.writeFile(M.join(S,"index.html"),w,"utf-8")}catch(h){console.error(`[boltdocs] Error SSR rendering route ${g.path}:`,h&&(h.stack||h))}}));let d=mt(c.map(g=>g.path),e);T.writeFileSync(M.join(p,"sitemap.xml"),d,"utf-8"),console.log(`[boltdocs] Generated ${c.length} static pages + sitemap.xml`);let{flushCache:m}=await import("../cache-7G6D532T.mjs");await m()}import B from"path";import Nt from"path";function ft(o,r){let i=o.homePage?`import HomePage from '${$(o.homePage)}';`:"",p=o.homePage?"homePage: HomePage,":"",e=r?.plugins?.flatMap(a=>Object.entries(a.components||{}))||[],c=e.map(([a,f])=>`import * as _comp_${a} from '${$(f)}';
+const ${a} = _comp_${a}.default || _comp_${a}['${a}'] || _comp_${a};`).join(`
+`),l=e.map(([a])=>a).join(", "),u=Nt.basename(o.docsDir||"docs"),t=Object.entries(r?.external||{}),n=t.map(([a,f],v)=>`import _ext_${v} from '${$(f)}';`).join(`
+`),s=t.length>0?`externalPages: { ${t.map(([a],f)=>`"${a}": _ext_${f}`).join(", ")} },`:"";return`
+import { createBoltdocsApp as _createApp } from 'boltdocs/client';
+import _routes from 'virtual:boltdocs-routes';
+import _config from 'virtual:boltdocs-config';
+import _user_mdx_components from 'virtual:boltdocs-mdx-components';
+${i}
+${c}
+${n}
+
+_createApp({
+  target: '#root',
+  routes: _routes,
+  docsDirName: '${u}',
+  config: _config,
+  modules: import.meta.glob('/${u}/**/*.{md,mdx}'),
+  hot: import.meta.hot,
+  ${p}
+  ${s}
+  components: { ${l}${l?", ":""} ...(_user_mdx_components || {}) },
+});
+`}function ht(o,r){let i=r.themeConfig?.title||"Boltdocs",p=r.themeConfig?.description||"",e=[`<meta name="description" content="${p}">`,`<meta property="og:title" content="${i}">`,`<meta property="og:description" content="${p}">`,'<meta property="og:type" content="website">','<meta name="twitter:card" content="summary">',`<meta name="twitter:title" content="${i}">`,`<meta name="twitter:description" content="${p}">`,'<meta name="generator" content="Boltdocs">'].join(`
+    `),c=`
+    <script>
+      (function() {
+        try {
+          var stored = localStorage.getItem("boltdocs-theme");
+          var theme = stored || (window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light");
+          if (theme === "light") {
+            document.documentElement.classList.add("theme-light");
+            document.documentElement.dataset.theme = "light";
+          } else {
+            document.documentElement.classList.remove("theme-light");
+            document.documentElement.dataset.theme = "dark";
+          }
+        } catch (e) {}
+      })();
+    </script>
+  `;return o=o.replace(/<title>.*?<\/title>/,`<title>${i}</title>`),o=o.replace("</head>",`    ${e}
+${c}  </head>`),o.includes("src/main")||(o=o.replace("</body>",`  <script type="module">import "virtual:boltdocs-entry";</script>
+  </body>`)),o}import yt from"fs";function xt(o={},r){let i=B.resolve(process.cwd(),o.docsDir||"docs"),p=$(i),e=r,c,l=!1,u=e?.plugins?.flatMap(t=>t.vitePlugins||[])||[];return[{name:"vite-plugin-boltdocs",enforce:"pre",async config(t,n){l=n.command==="build";let s=t.envDir||process.cwd(),a=zt(n.mode,s,"");return Object.assign(process.env,a),e||(e=await z(i)),{optimizeDeps:{include:["react","react-dom"]}}},configResolved(t){c=t},configureServer(t){let n=N.map(m=>B.resolve(process.cwd(),m)),s=["tsx","jsx"],a=s.map(m=>B.resolve(i,`layout.${m}`)),f=["tsx","ts","jsx","js"],v=f.map(m=>B.resolve(i,`mdx-components.${m}`));t.watcher.add([...n,...v,...a]);let d=async(m,g)=>{let y=$(m);if(N.some(h=>y.endsWith(h))){t.restart();return}if(f.some(h=>y.endsWith(`mdx-components.${h}`))){let h=t.moduleGraph.getModuleById("\0virtual:boltdocs-mdx-components");h&&t.moduleGraph.invalidateModule(h),t.ws.send({type:"full-reload"});return}if(s.some(h=>y.endsWith(`layout.${h}`))){let h=t.moduleGraph.getModuleById("\0virtual:boltdocs-layout");h&&t.moduleGraph.invalidateModule(h),t.ws.send({type:"full-reload"});return}if(!y.startsWith(p)||!it(y))return;g==="add"||g==="unlink"?K():Z(m);let k=await I(i,e),x=t.moduleGraph.getModuleById("\0virtual:boltdocs-routes");x&&t.moduleGraph.invalidateModule(x),t.ws.send({type:"custom",event:"boltdocs:routes-update",data:k})};t.watcher.on("add",m=>d(m,"add")),t.watcher.on("unlink",m=>d(m,"unlink")),t.watcher.on("change",m=>d(m,"change"))},resolveId(t){if(t==="virtual:boltdocs-routes"||t==="virtual:boltdocs-config"||t==="virtual:boltdocs-entry"||t==="virtual:boltdocs-mdx-components"||t==="virtual:boltdocs-layout")return"\0"+t},async load(t){if(t==="\0virtual:boltdocs-routes"){let n=await I(i,e);return`export default ${JSON.stringify(n,null,2)};`}if(t==="\0virtual:boltdocs-config"){let n={themeConfig:e?.themeConfig,integrations:e?.integrations,i18n:e?.i18n,versions:e?.versions,siteUrl:e?.siteUrl};return`export default ${JSON.stringify(n,null,2)};`}if(t==="\0virtual:boltdocs-entry")return ft(o,e);if(t==="\0virtual:boltdocs-mdx-components"){let n=["tsx","ts","jsx","js"],s=null;for(let a of n){let f=B.resolve(i,`mdx-components.${a}`);if(yt.existsSync(f)){s=f;break}}if(s){let a=$(s);return`import * as components from '${a}';
+const mdxComponents = components.default || components;
+export default mdxComponents;
+export * from '${a}';`}return"export default {};"}if(t==="\0virtual:boltdocs-layout"){let n=["tsx","jsx"],s=null;for(let a of n){let f=B.resolve(i,`layout.${a}`);if(yt.existsSync(f)){s=f;break}}return s?`import UserLayout from '${$(s)}';
+export default UserLayout;`:`import { DefaultLayout } from 'boltdocs/client';
+export default DefaultLayout;`}},transformIndexHtml:{order:"pre",handler(t){return ht(t,e)}},async closeBundle(){if(!l)return;let t=c?.build?.outDir?B.resolve(c.root,c.build.outDir):B.resolve(process.cwd(),"dist"),n=B.basename(i||"docs");await Y({docsDir:i,docsDirName:n,outDir:t,config:e});let{flushCache:s}=await import("../cache-7G6D532T.mjs");await s()}},Ut({includePublic:!0,png:{quality:80},jpeg:{quality:80},jpg:{quality:80},webp:{quality:80},avif:{quality:80},svg:{multipass:!0,plugins:[{name:"preset-default"}]}}),...u.filter(t=>!!t)]}import qt from"@mdx-js/rollup";import At from"remark-gfm";import Vt from"remark-frontmatter";import Wt from"rehype-slug";import Jt from"crypto";import{visit as Pt}from"unist-util-visit";import{createHighlighter as Xt}from"shiki";var U=null;async function vt(o){if(U)return U;let r=typeof o=="object"?[o.light,o.dark]:[o??"github-dark"];return["github-light","github-dark"].forEach(i=>{r.includes(i)||r.push(i)}),U=await Xt({themes:r,langs:["tsx","jsx","ts","js","json","md","mdx","css","html","bash","sh","yaml","yml"]}),U}function Kt(o){return async r=>{let i=o?.themeConfig?.codeTheme??{light:"github-light",dark:"github-dark"},p=await vt(i);Pt(r,["mdxJsxFlowElement","mdxJsxTextElement"],e=>{if(e.name!=="ComponentPreview")return;let c=e.attributes?.find(n=>n.name==="code"),l="";if(c){if(typeof c.value=="string")l=c.value;else if(c.value?.type==="mdxJsxAttributeValueExpression"){let n=c.value.value??"";l=n.match(/^[`'"](.+)[`'"]$/)?.[1]??n}}if(!l)return;let u=typeof i=="object"?{themes:{light:i.light,dark:i.dark},lang:"tsx"}:{theme:i,lang:"tsx"},t=p.codeToHtml(l,u);e.attributes=(e.attributes??[]).filter(n=>n.name!=="highlightedHtml"),e.attributes.push({type:"mdxJsxAttribute",name:"highlightedHtml",value:t})})}}function Zt(o){return async r=>{let i=o?.themeConfig?.codeTheme||{light:"github-light",dark:"github-dark"},p=await vt(i);Pt(r,"element",e=>{if(e.tagName==="pre"&&e.children?.[0]?.tagName==="code"){let c=e.children[0],u=(c.properties?.className||[]).find(f=>f.startsWith("language-")),t=u?u.slice(9):"text",n=c.children[0]?.value||"",s={lang:t};typeof i=="object"?s.themes={light:i.light,dark:i.dark}:s.theme=i;let a=p.codeToHtml(n,s);e.properties.dataHighlighted="true",e.properties.highlightedHtml=a,e.children=[]}})}}var Qt="v3",O=new at("mdx"),bt=!1;function Ct(o,r=qt){let i=o?.plugins?.flatMap(c=>c.remarkPlugins||[])||[],p=o?.plugins?.flatMap(c=>c.rehypePlugins||[])||[],e=r({remarkPlugins:[At,Vt,[Kt,o],...i],rehypePlugins:[Wt,[Zt,o],...p],jsxRuntime:"automatic",providerImportSource:"@mdx-js/react"});return e.isMock&&console.log("MDX PLUGIN IS MOCKED"),{...e,name:"vite-plugin-boltdocs-mdx",async buildStart(){q=0,A=0,bt||(O.load(),bt=!0),e.buildStart&&await e.buildStart.call(this)},async transform(c,l,u){if(!l.endsWith(".md")&&!l.endsWith(".mdx"))return e.transform?.call(this,c,l,u);console.log(`[boltdocs] Transforming MDX: ${l}`),A++;let t=Jt.createHash("md5").update(c).digest("hex"),n=`${l}:${t}:${Qt}`,s=O.get(n);if(s)return q++,{code:s,map:null};let a=await e.transform.call(this,c,l,u);return a&&typeof a=="object"&&a.code&&O.set(n,a.code),a},async buildEnd(){console.log(`[boltdocs] MDX Cache Performance: ${q}/${A} hits (${Math.round(q/A*100)||0}%)`),O.save(),await O.flush(),e.buildEnd&&await e.buildEnd.call(this)}}}var q=0,A=0;async function Yt(o){let r=o?.docsDir||"docs",i=await z(r);return[...xt(o,i),Ct(i)]}export{Yt as default,Y as generateStaticPages};

package/dist/search-dialog-EB3N4TYM.mjs

@@ -0,0 +1 @@
+import{a as f}from"./chunk-H63UMKYF.mjs";import{h as g,i as h,j as u,k as m,l as S,m as d,n as p,o as y,p as D}from"./chunk-BQCD3DWG.mjs";import"./chunk-XEAPSFMB.mjs";import"./chunk-JZXLCA2E.mjs";import{useEffect as K,useCallback as M}from"react";import{useNavigate as R}from"react-router-dom";import{Fragment as T,jsx as o,jsxs as n}from"react/jsx-runtime";function N({routes:v}){let{isOpen:I,setIsOpen:a,query:w,setQuery:k,list:E}=f(v),r=R();K(()=>{let e=t=>{(/Mac/.test(navigator.userAgent)?t.metaKey:t.ctrlKey)&&(t.key==="k"||t.key==="j")&&(t.preventDefault(),a(i=>!i))};return window.addEventListener("keydown",e),()=>window.removeEventListener("keydown",e)},[a]);let l=M(e=>{let t=String(e);if(a(!1),t.includes("#")){let[s,c]=t.split("#");r(s),setTimeout(()=>{let i=document.getElementById(c);i&&i.scrollIntoView({behavior:"smooth"})},100)}else r(t)},[r,a]);return n(T,{children:[o(g.SearchTrigger,{onPress:()=>a(!0)}),o(h,{isOpen:I,onOpenChange:a,children:n(u,{onSelectionChange:l,children:[o(m,{value:w,onChange:e=>k(e.target.value)}),o(S,{items:E,children:e=>n(d,{onPress:()=>l(e.id),textValue:e.title,children:[o(p,{isHeading:e.isHeading}),n("div",{className:"flex flex-col justify-center gap-0.5",children:[o(y,{children:e.title}),o(D,{children:e.groupTitle})]})]},e.id)})]})})]})}export{N as SearchDialog};

package/dist/types-BuZWFT7r.d.ts

@@ -0,0 +1,159 @@
+import React__default from 'react';
+import { B as BoltdocsConfig } from './config-CX4l-ZNp.js';
+
+/**
+ * Metadata provided by the server for a specific route.
+ * Maps closely to the `RouteMeta` type in the Node environment.
+ */
+interface ComponentRoute {
+    /** The final URL path */
+    path: string;
+    /** The absolute filesystem path of the source file */
+    componentPath: string;
+    /** The page title */
+    title: string;
+    /** Explicit order in the sidebar */
+    sidebarPosition?: number;
+    /** The relative path from the docs directory */
+    filePath: string;
+    /** The group directory name */
+    group?: string;
+    /** The display title of the group */
+    groupTitle?: string;
+    /** Explicit order of the group in the sidebar */
+    groupPosition?: number;
+    /** Extracted markdown headings for search indexing */
+    headings?: {
+        level: number;
+        text: string;
+        id: string;
+    }[];
+    /** The page summary or description */
+    description?: string;
+    /** The locale this route belongs to, if i18n is configured */
+    locale?: string;
+    /** The version this route belongs to, if versioning is configured */
+    version?: string;
+    /** Optional icon to display (Lucide icon name or raw SVG) */
+    icon?: string;
+    /** The tab this route belongs to, if tabs are configured */
+    tab?: string;
+    /** Optional badge to display next to the sidebar item */
+    badge?: string | {
+        text: 'updated' | 'new' | 'deprecated';
+        expires?: string;
+    };
+    /** Optional icon for the route's group */
+    groupIcon?: string;
+    /** The extracted plain-text content of the page for search indexing */
+    _content?: string;
+    /** The raw markdown content of the page */
+    _rawContent?: string;
+}
+/**
+ * Site configuration provided by the server.
+ */
+type SiteConfig = BoltdocsConfig;
+/**
+ * Configuration options for initializing the Boltdocs client app.
+ */
+interface CreateBoltdocsAppOptions {
+    /** CSS selector for the DOM element where the app should mount (e.g. '#root') */
+    target: string;
+    /** Initial routes generated by the Vite plugin (`virtual:boltdocs-routes`) */
+    routes: ComponentRoute[];
+    /** The name of the documentation directory (e.g. 'docs') */
+    docsDirName: string;
+    /** Site configuration (`virtual:boltdocs-config`) */
+    config: SiteConfig;
+    /** Dynamic import mapping from `import.meta.glob` for the documentation pages */
+    modules: Record<string, () => Promise<{
+        default: React__default.ComponentType<any>;
+    }>>;
+    /** The `import.meta.hot` instance necessary for fast refresh/HMR updates */
+    hot?: {
+        accept: (cb?: (mod: any) => void) => void;
+        dispose: (cb: (data: any) => void) => void;
+        on: (event: string, cb: (data: any) => void) => void;
+        data: any;
+    };
+    /** Optional custom React component to render when visiting the root path ('/') */
+    homePage?: React__default.ComponentType;
+    /** Custom external pages mapped by their route path */
+    externalPages?: Record<string, React__default.ComponentType>;
+    /** Optional custom MDX components provided by plugins */
+    components?: Record<string, React__default.ComponentType>;
+}
+/**
+ * Types for CodeSandbox integration.
+ */
+interface SandboxFile {
+    content: string | object;
+    isBinary?: boolean;
+}
+type SandboxFiles = Record<string, SandboxFile>;
+interface SandboxOptions {
+    files?: SandboxFiles;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    title?: string;
+    description?: string;
+    template?: string;
+    /** The file path to open by default in the editor (e.g. `"src/App.tsx"`). */
+    entry?: string;
+    /** Options for the embedded iframe view, used by `embedSandbox()`. */
+    embed?: SandboxEmbedOptions;
+    /** Custom scripts for the package.json (e.g. `{ "start": "vite" }`). */
+    scripts?: Record<string, string>;
+    /** Optional default theme configuration for the sandbox project. */
+    themeConfig?: Record<string, unknown>;
+}
+interface SandboxEmbedOptions {
+    /** Which panel to display: `"editor"`, `"preview"`, or `"split"`. */
+    view?: 'editor' | 'preview' | 'split';
+    /** Color theme: `"dark"` or `"light"`. */
+    theme?: 'dark' | 'light';
+    /** Whether to hide the navigation bar in the embed. */
+    hideNavigation?: boolean;
+}
+/**
+ * Tab configuration for the documentation site.
+ */
+interface BoltdocsTab {
+    id: string;
+    text: string;
+    icon?: string;
+}
+/**
+ * Props for the OnThisPage (TOC) component.
+ */
+interface OnThisPageProps {
+    headings?: {
+        level: number;
+        text: string;
+        id: string;
+    }[];
+    editLink?: string;
+    communityHelp?: string;
+    filePath?: string;
+}
+/**
+ * Props for user-defined layout components (layout.tsx).
+ */
+interface LayoutProps {
+    children: React__default.ReactNode;
+}
+/**
+ * Unified type for navbar links.
+ */
+interface NavbarLink {
+    label: string;
+    href: string;
+    active: boolean;
+    /** Optional icon or string for external link indication */
+    to?: string;
+    /** Nested items for NavigationMenu */
+    items?: NavbarLink[];
+}
+
+export type { BoltdocsTab as B, ComponentRoute as C, LayoutProps as L, NavbarLink as N, OnThisPageProps as O, SandboxOptions as S, CreateBoltdocsAppOptions as a, SandboxEmbedOptions as b, SandboxFile as c, SandboxFiles as d };

package/dist/types-CvT-SGbK.d.mts

@@ -0,0 +1,159 @@
+import React__default from 'react';
+import { B as BoltdocsConfig } from './config-CX4l-ZNp.mjs';
+
+/**
+ * Metadata provided by the server for a specific route.
+ * Maps closely to the `RouteMeta` type in the Node environment.
+ */
+interface ComponentRoute {
+    /** The final URL path */
+    path: string;
+    /** The absolute filesystem path of the source file */
+    componentPath: string;
+    /** The page title */
+    title: string;
+    /** Explicit order in the sidebar */
+    sidebarPosition?: number;
+    /** The relative path from the docs directory */
+    filePath: string;
+    /** The group directory name */
+    group?: string;
+    /** The display title of the group */
+    groupTitle?: string;
+    /** Explicit order of the group in the sidebar */
+    groupPosition?: number;
+    /** Extracted markdown headings for search indexing */
+    headings?: {
+        level: number;
+        text: string;
+        id: string;
+    }[];
+    /** The page summary or description */
+    description?: string;
+    /** The locale this route belongs to, if i18n is configured */
+    locale?: string;
+    /** The version this route belongs to, if versioning is configured */
+    version?: string;
+    /** Optional icon to display (Lucide icon name or raw SVG) */
+    icon?: string;
+    /** The tab this route belongs to, if tabs are configured */
+    tab?: string;
+    /** Optional badge to display next to the sidebar item */
+    badge?: string | {
+        text: 'updated' | 'new' | 'deprecated';
+        expires?: string;
+    };
+    /** Optional icon for the route's group */
+    groupIcon?: string;
+    /** The extracted plain-text content of the page for search indexing */
+    _content?: string;
+    /** The raw markdown content of the page */
+    _rawContent?: string;
+}
+/**
+ * Site configuration provided by the server.
+ */
+type SiteConfig = BoltdocsConfig;
+/**
+ * Configuration options for initializing the Boltdocs client app.
+ */
+interface CreateBoltdocsAppOptions {
+    /** CSS selector for the DOM element where the app should mount (e.g. '#root') */
+    target: string;
+    /** Initial routes generated by the Vite plugin (`virtual:boltdocs-routes`) */
+    routes: ComponentRoute[];
+    /** The name of the documentation directory (e.g. 'docs') */
+    docsDirName: string;
+    /** Site configuration (`virtual:boltdocs-config`) */
+    config: SiteConfig;
+    /** Dynamic import mapping from `import.meta.glob` for the documentation pages */
+    modules: Record<string, () => Promise<{
+        default: React__default.ComponentType<any>;
+    }>>;
+    /** The `import.meta.hot` instance necessary for fast refresh/HMR updates */
+    hot?: {
+        accept: (cb?: (mod: any) => void) => void;
+        dispose: (cb: (data: any) => void) => void;
+        on: (event: string, cb: (data: any) => void) => void;
+        data: any;
+    };
+    /** Optional custom React component to render when visiting the root path ('/') */
+    homePage?: React__default.ComponentType;
+    /** Custom external pages mapped by their route path */
+    externalPages?: Record<string, React__default.ComponentType>;
+    /** Optional custom MDX components provided by plugins */
+    components?: Record<string, React__default.ComponentType>;
+}
+/**
+ * Types for CodeSandbox integration.
+ */
+interface SandboxFile {
+    content: string | object;
+    isBinary?: boolean;
+}
+type SandboxFiles = Record<string, SandboxFile>;
+interface SandboxOptions {
+    files?: SandboxFiles;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    title?: string;
+    description?: string;
+    template?: string;
+    /** The file path to open by default in the editor (e.g. `"src/App.tsx"`). */
+    entry?: string;
+    /** Options for the embedded iframe view, used by `embedSandbox()`. */
+    embed?: SandboxEmbedOptions;
+    /** Custom scripts for the package.json (e.g. `{ "start": "vite" }`). */
+    scripts?: Record<string, string>;
+    /** Optional default theme configuration for the sandbox project. */
+    themeConfig?: Record<string, unknown>;
+}
+interface SandboxEmbedOptions {
+    /** Which panel to display: `"editor"`, `"preview"`, or `"split"`. */
+    view?: 'editor' | 'preview' | 'split';
+    /** Color theme: `"dark"` or `"light"`. */
+    theme?: 'dark' | 'light';
+    /** Whether to hide the navigation bar in the embed. */
+    hideNavigation?: boolean;
+}
+/**
+ * Tab configuration for the documentation site.
+ */
+interface BoltdocsTab {
+    id: string;
+    text: string;
+    icon?: string;
+}
+/**
+ * Props for the OnThisPage (TOC) component.
+ */
+interface OnThisPageProps {
+    headings?: {
+        level: number;
+        text: string;
+        id: string;
+    }[];
+    editLink?: string;
+    communityHelp?: string;
+    filePath?: string;
+}
+/**
+ * Props for user-defined layout components (layout.tsx).
+ */
+interface LayoutProps {
+    children: React__default.ReactNode;
+}
+/**
+ * Unified type for navbar links.
+ */
+interface NavbarLink {
+    label: string;
+    href: string;
+    active: boolean;
+    /** Optional icon or string for external link indication */
+    to?: string;
+    /** Nested items for NavigationMenu */
+    items?: NavbarLink[];
+}
+
+export type { BoltdocsTab as B, ComponentRoute as C, LayoutProps as L, NavbarLink as N, OnThisPageProps as O, SandboxOptions as S, CreateBoltdocsAppOptions as a, SandboxEmbedOptions as b, SandboxFile as c, SandboxFiles as d };

package/dist/use-routes-5bAtAAYX.d.mts

@@ -0,0 +1,30 @@
+import { B as BoltdocsConfig } from './config-CX4l-ZNp.mjs';
+import { C as ComponentRoute } from './types-CvT-SGbK.mjs';
+
+/**
+ * Hook to access the framework's routing state.
+ * Returns both the complete set of routes and a filtered list based on the current
+ * version and locale.
+ */
+declare function useRoutes(): {
+    routes: ComponentRoute[];
+    allRoutes: ComponentRoute[];
+    currentRoute: ComponentRoute | undefined;
+    currentLocale: string | undefined;
+    currentLocaleLabel: string | undefined;
+    availableLocales: {
+        key: string;
+        label: string;
+        isCurrent: boolean;
+    }[];
+    currentVersion: string | undefined;
+    currentVersionLabel: string | undefined;
+    availableVersions: {
+        key: string;
+        label: string;
+        isCurrent: boolean;
+    }[];
+    config: BoltdocsConfig;
+};
+
+export { useRoutes as u };

package/dist/use-routes-BefRXY3v.d.ts

@@ -0,0 +1,30 @@
+import { B as BoltdocsConfig } from './config-CX4l-ZNp.js';
+import { C as ComponentRoute } from './types-BuZWFT7r.js';
+
+/**
+ * Hook to access the framework's routing state.
+ * Returns both the complete set of routes and a filtered list based on the current
+ * version and locale.
+ */
+declare function useRoutes(): {
+    routes: ComponentRoute[];
+    allRoutes: ComponentRoute[];
+    currentRoute: ComponentRoute | undefined;
+    currentLocale: string | undefined;
+    currentLocaleLabel: string | undefined;
+    availableLocales: {
+        key: string;
+        label: string;
+        isCurrent: boolean;
+    }[];
+    currentVersion: string | undefined;
+    currentVersionLabel: string | undefined;
+    availableVersions: {
+        key: string;
+        label: string;
+        isCurrent: boolean;
+    }[];
+    config: BoltdocsConfig;
+};
+
+export { useRoutes as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "boltdocs",
-  "version": "1.11.0",
+  "version": "2.0.0",
   "description": "A lightweight documentation generator for React projects.",
   "main": "dist/node/index.js",
   "module": "dist/node/index.mjs",
@@ -36,13 +36,6 @@
     },
     "./theme/neutral.css": "./src/client/theme/neutral.css"
   },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "format": "pnpm exec biome format --write",
-    "lint": "pnpm exec biome lint --write",
-    "check": "pnpm exec biome check --write"
-  },
   "keywords": [
     "docs",
     "documentation",
@@ -66,6 +59,7 @@
     "fast-glob": "^3.3.3",
     "github-slugger": "^2.0.0",
     "gray-matter": "^4.0.3",
+    "isomorphic-dompurify": "^3.7.1",
     "lucide-react": "^0.575.0",
     "react-aria-components": "^1.16.0",
     "react-router-dom": "^6.30.3",
@@ -85,7 +79,6 @@
     "react": "^19.1.0",
     "react-dom": "^19.1.0"
   },
-  "packageManager": "pnpm@10.30.2",
   "devDependencies": {
     "@types/node": "^25.3.2",
     "@types/react": "^19.2.14",
@@ -93,5 +86,12 @@
     "@types/react-router-dom": "^5.3.3",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "format": "pnpm exec biome format --write",
+    "lint": "pnpm exec biome lint --write",
+    "check": "pnpm exec biome check --write"
   }
-}
+}

package/src/client/app/index.tsx

@@ -31,7 +31,7 @@ export function AppShell({
   initialRoutes: ComponentRoute[]
   initialConfig: BoltdocsConfig
   docsDirName: string
-  modules: Record<string, () => Promise<{ default: React.ComponentType }>>
+  modules: Record<string, () => Promise<{ default: React.ComponentType<any> }>>
   hot?: CreateBoltdocsAppOptions['hot']
   homePage?: React.ComponentType
   externalPages?: Record<string, React.ComponentType>
@@ -50,15 +50,19 @@ export function AppShell({
       )
       .map((route) => {
         const loaderKey = Object.keys(modules).find(
-          (k) => k === `/${docsDirName}/${route.filePath}`,
+          (k) =>
+            k === `/${docsDirName}/${route.filePath}` || // Vite dev/build relative path
+            k.endsWith(`/${docsDirName}/${route.filePath}`) || // SSG absolute path fallback
+            k.endsWith(`/${docsDirName}\\${route.filePath.replace(/\\/g, '/')}`), // Windows fallback
         )
         const loader = loaderKey ? modules[loaderKey] : null
 
         return {
           ...route,
-          Component: React.lazy(() => {
-            if (!loader) return Promise.resolve({ default: NotFound })
-            return loader() as any
+          Component: React.lazy<React.ComponentType<any>>(async () => {
+            if (!loader) return { default: NotFound as React.ComponentType<any> }
+            const mod = await loader()
+            return mod
           }),
         }
       })
@@ -113,7 +117,6 @@ export function AppShell({
                   ),
                 )}
 
-                {/* Documentation pages WITH sidebar + TOC layout */}
                 <Route key="docs-layout" element={<DocsLayout />}>
                   {resolvedRoutes.map((route) => (
                     <Route

package/src/client/types.ts

@@ -62,7 +62,7 @@ export interface CreateBoltdocsAppOptions {
   /** Site configuration (`virtual:boltdocs-config`) */
   config: SiteConfig
   /** Dynamic import mapping from `import.meta.glob` for the documentation pages */
-  modules: Record<string, () => Promise<{ default: React.ComponentType }>>
+  modules: Record<string, () => Promise<{ default: React.ComponentType<any> }>>
   /** The `import.meta.hot` instance necessary for fast refresh/HMR updates */
   hot?: {
     accept: (cb?: (mod: any) => void) => void

package/src/node/plugin/index.ts

@@ -262,7 +262,6 @@ export default DefaultLayout;`
         plugins: [
           {
             name: 'preset-default',
-            params: { overrides: { removeViewBox: false } },
           },
         ] as any,
       },