boltdocs 1.11.0 → 2.1.0

package/dist/node/index.js

@@ -0,0 +1,74 @@
+"use strict";var we=Object.create;var Q=Object.defineProperty;var $e=Object.getOwnPropertyDescriptor;var Se=Object.getOwnPropertyNames;var De=Object.getPrototypeOf,Be=Object.prototype.hasOwnProperty;var gt=(o,t)=>()=>(o&&(t=o(o=0)),t);var Ft=(o,t)=>{for(var e in t)Q(o,e,{get:t[e],enumerable:!0})},It=(o,t,e,s)=>{if(t&&typeof t=="object"||typeof t=="function")for(let i of Se(t))!Be.call(o,i)&&i!==e&&Q(o,i,{get:()=>t[i],enumerable:!(s=$e(t,i))||s.enumerable});return o};var y=(o,t,e)=>(e=o!=null?we(De(o)):{},It(t||!o||!o.__esModule?Q(e,"default",{value:o,enumerable:!0}):e,o)),Re=o=>It(Q({},"__esModule",{value:!0}),o);var Me,C,g=gt(()=>{"use strict";Me=()=>typeof document>"u"?new URL(`file:${__filename}`).href:document.currentScript&&document.currentScript.tagName.toUpperCase()==="SCRIPT"?document.currentScript.src:new URL("main.js",document.baseURI).href,C=Me()});function R(o){return o.replace(/\\/g,"/")}function U(o){return o.replace(/^\d+\./,"")}function Y(o){let t=o.match(/^(\d+)\./);return t?parseInt(t[1],10):void 0}function jt(o){return/\.mdx?$/.test(o)}function tt(o){try{return ft.default.statSync(o).mtimeMs}catch{return 0}}function Ht(o){let t=ft.default.readFileSync(o,"utf-8"),{data:e,content:s}=(0,Et.default)(t);return{data:e,content:s}}function E(o){return o.replace(/&/g,"&amp;").replace(/"/g,"&quot;").replace(/'/g,"&apos;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}function yt(o){return E(o)}function Lt(o){let e=o.split("/").map(U).join("/").replace(/\/$/,"");return e=e.replace(/\.mdx?$/,""),(e==="index"||e.endsWith("/index"))&&(e=e.replace(/index$/,"")),e.startsWith("/")||(e="/"+e),e.length>1&&e.endsWith("/")&&(e=e.slice(0,-1)),e}function G(o){return ht.default.sanitize(o)}function xt(o){return ht.default.sanitize(o,{ALLOWED_TAGS:[],KEEP_CONTENT:!0})}function q(o){return o.charAt(0).toUpperCase()+o.slice(1)}var ft,Et,ht,k=gt(()=>{"use strict";g();ft=y(require("fs")),Et=y(require("gray-matter")),ht=y(require("isomorphic-dompurify"))});var $t={};Ft($t,{AssetCache:()=>Pt,FileCache:()=>V,TransformCache:()=>W,flushCache:()=>Ie});async function Ie(){await O.flush()}var w,S,z,L,A,et,ke,ot,Ct,Ze,wt,Te,_e,Oe,Fe,bt,vt,O,V,W,Pt,K=gt(()=>{"use strict";g();w=y(require("fs")),S=y(require("path")),z=y(require("crypto")),L=y(require("zlib")),A=require("util");k();et=(0,A.promisify)(w.default.writeFile),ke=(0,A.promisify)(w.default.readFile),ot=(0,A.promisify)(w.default.mkdir),Ct=(0,A.promisify)(w.default.rename),Ze=(0,A.promisify)(w.default.unlink),wt=process.env.BOLTDOCS_CACHE_DIR||".boltdocs",Te="assets",_e="shards",Oe=parseInt(process.env.BOLTDOCS_CACHE_LRU_LIMIT||"2000",10),Fe=process.env.BOLTDOCS_CACHE_COMPRESS!=="0",bt=class{constructor(t){this.limit=t}cache=new Map;get(t){let e=this.cache.get(t);return e!==void 0&&(this.cache.delete(t),this.cache.set(t,e)),e}set(t,e){if(this.cache.has(t))this.cache.delete(t);else if(this.cache.size>=this.limit){let s=this.cache.keys().next().value;s!==void 0&&this.cache.delete(s)}this.cache.set(t,e)}get size(){return this.cache.size}clear(){this.cache.clear()}},vt=class{queue=Promise.resolve();pendingCount=0;add(t){this.pendingCount++,this.queue=this.queue.then(t).finally(()=>{this.pendingCount--})}async flush(){await this.queue}get pending(){return this.pendingCount}},O=new vt,V=class{entries=new Map;cachePath=null;compress;constructor(t={}){if(this.compress=t.compress!==void 0?t.compress:Fe,t.name){let e=t.root||process.cwd(),s=this.compress?"json.gz":"json";this.cachePath=S.default.resolve(e,wt,`${t.name}.${s}`)}}load(){if(process.env.BOLTDOCS_NO_CACHE!=="1"&&!(!this.cachePath||!w.default.existsSync(this.cachePath)))try{let t=w.default.readFileSync(this.cachePath);this.cachePath.endsWith(".gz")&&(t=L.default.gunzipSync(t));let e=JSON.parse(t.toString("utf-8"));this.entries=new Map(Object.entries(e))}catch{}}save(){if(process.env.BOLTDOCS_NO_CACHE==="1"||!this.cachePath)return;let t=Object.fromEntries(this.entries),e=JSON.stringify(t),s=this.cachePath,i=this.compress;O.add(async()=>{try{await ot(S.default.dirname(s),{recursive:!0});let r=Buffer.from(e);i&&(r=L.default.gzipSync(r));let a=`${s}.${z.default.randomBytes(4).toString("hex")}.tmp`;await et(a,r),await Ct(a,s)}catch{}})}get(t){let e=this.entries.get(t);return!e||tt(t)!==e.mtime?null:e.data}set(t,e){this.entries.set(t,{data:e,mtime:tt(t)})}isValid(t){let e=this.entries.get(t);return e?tt(t)===e.mtime:!1}invalidate(t){this.entries.delete(t)}invalidateAll(){this.entries.clear()}pruneStale(t){for(let e of this.entries.keys())t.has(e)||this.entries.delete(e)}get size(){return this.entries.size}async flush(){await O.flush()}},W=class{index=new Map;memoryCache=new bt(Oe);baseDir;shardsDir;indexPath;constructor(t,e=process.cwd()){this.baseDir=S.default.resolve(e,wt,`transform-${t}`),this.shardsDir=S.default.resolve(this.baseDir,_e),this.indexPath=S.default.resolve(this.baseDir,"index.json")}load(){if(process.env.BOLTDOCS_NO_CACHE!=="1"&&w.default.existsSync(this.indexPath))try{let t=w.default.readFileSync(this.indexPath,"utf-8");this.index=new Map(Object.entries(JSON.parse(t)))}catch{}}save(){if(process.env.BOLTDOCS_NO_CACHE==="1")return;let t=JSON.stringify(Object.fromEntries(this.index)),e=this.indexPath;O.add(async()=>{await ot(S.default.dirname(e),{recursive:!0}),await et(e,t)})}async getMany(t){let e=new Map,s=[];for(let i of t){let r=this.memoryCache.get(i);r?e.set(i,r):this.index.has(i)&&s.push(i)}if(s.length>0){let i=await Promise.all(s.map(async r=>{let a=this.index.get(r),p=S.default.resolve(this.shardsDir,`${a}.gz`);try{let n=await ke(p),c=L.default.gunzipSync(n).toString("utf-8");return this.memoryCache.set(r,c),{key:r,val:c}}catch{return null}}));for(let r of i)r&&e.set(r.key,r.val)}return e}get(t){let e=this.memoryCache.get(t);if(e)return e;let s=this.index.get(t);if(!s)return null;let i=S.default.resolve(this.shardsDir,`${s}.gz`);if(!w.default.existsSync(i))return null;try{let r=w.default.readFileSync(i),a=L.default.gunzipSync(r).toString("utf-8");return this.memoryCache.set(t,a),a}catch{return null}}set(t,e){let s=z.default.createHash("md5").update(e).digest("hex");this.index.set(t,s),this.memoryCache.set(t,e);let i=S.default.resolve(this.shardsDir,`${s}.gz`);O.add(async()=>{if(w.default.existsSync(i))return;await ot(this.shardsDir,{recursive:!0});let r=L.default.gzipSync(Buffer.from(e)),a=`${i}.${z.default.randomBytes(4).toString("hex")}.tmp`;await et(a,r),await Ct(a,i)})}get size(){return this.index.size}async flush(){await O.flush()}},Pt=class{assetsDir;constructor(t=process.cwd()){this.assetsDir=S.default.resolve(t,wt,Te)}getFileHash(t){return z.default.createHash("md5").update(w.default.readFileSync(t)).digest("hex")}get(t,e){if(!w.default.existsSync(t))return null;let s=this.getFileHash(t),i=this.getCachedPath(t,`${e}-${s}`);return w.default.existsSync(i)?i:null}set(t,e,s){let i=this.getFileHash(t),r=this.getCachedPath(t,`${e}-${i}`);O.add(async()=>{await ot(this.assetsDir,{recursive:!0});let a=`${r}.${z.default.randomBytes(4).toString("hex")}.tmp`;await et(a,s),await Ct(a,r)})}getCachedPath(t,e){let s=S.default.extname(t),i=S.default.basename(t,s),r=e.replace(/[^a-z0-9]/gi,"-").toLowerCase();return S.default.join(this.assetsDir,`${i}.${r}${s}`)}clear(){w.default.existsSync(this.assetsDir)&&w.default.rmSync(this.assetsDir,{recursive:!0,force:!0})}async flush(){await O.flush()}}});var qe={};Ft(qe,{createViteConfig:()=>Ge,default:()=>kt,defineConfig:()=>Wt,generateStaticPages:()=>st,resolveConfig:()=>j});module.exports=Re(qe);g();var fe=y(require("@vitejs/plugin-react")),he=y(require("@tailwindcss/vite"));g();var ie=require("vite");g();var Gt=y(require("fast-glob"));k();g();K();var T=new V({name:"routes"});function St(){T.invalidateAll()}function Dt(o){T.invalidate(o)}g();var N=y(require("path")),zt=y(require("github-slugger"));k();function At(o,t,e,s){let i=decodeURIComponent(o),r=N.default.resolve(i),a=N.default.resolve(t),p=R(N.default.relative(a,r));if(p.startsWith("../")||p===".."||r.includes("\0"))throw new Error(`Security breach: File is outside of docs directory or contains null bytes: ${o}`);let{data:n,content:c}=Ht(o),l=p.split("/"),u,b;if(s?.versions&&l.length>0){let B=l[0];s.versions.versions[B]&&(b=B,l=l.slice(1))}if(s?.i18n&&l.length>0){let B=l[0];s.i18n.locales[B]&&(u=B,l=l.slice(1))}let x;if(l.length>0){let B=l[0].match(/^\((.+)\)$/);B&&(x=B[1].toLowerCase(),l=l.slice(1))}let d=l.join("/"),m;n.permalink?m=n.permalink.startsWith("/")?n.permalink:`/${n.permalink}`:m=Lt(d||"index.md");let h=e;b&&(h+="/"+b),u&&(h+="/"+u),h+=m==="/"?"":m,(!h||h==="")&&(h="/");let f=l[l.length-1],$=U(f),D=U(N.default.basename(o,N.default.extname(o))),P=n.sidebarPosition??Y(f),v=l.length>=2?l[0]:void 0,I=v?U(v):void 0,H=l.length>=2&&/^index\.mdx?$/.test($),mt=new zt.default,Tt=[],ye=/^(#{2,4})\s+(.+)$/gm,pt;for(;(pt=ye.exec(c))!==null;){let B=pt[1].length,Pe=pt[2].replace(/\[([^\]]+)\]\([^\)]+\)/g,"$1").replace(/[_*`]/g,"").trim(),Ot=G(Pe).trim(),Ce=mt.slug(Ot);Tt.push({level:B,text:Ot,id:Ce})}let xe=n.title?G(String(n.title)):D,ut=n.description?G(String(n.description)):"";!ut&&c&&(ut=xt(c.replace(/^#+.*$/gm,"").replace(/\[([^\]]+)\]\([^\)]+\)/g,"$1").replace(/[_*`]/g,"").replace(/\s+/g," ")).trim().slice(0,160));let be=n.badge?G(String(n.badge)):void 0,_t=n.icon?String(n.icon):void 0,ve=Ee(c);return{route:{path:h,componentPath:o,filePath:p,title:xe,description:ut,sidebarPosition:P,headings:Tt,locale:u,version:b,badge:be,icon:_t,tab:x,_content:ve,_rawContent:c},relativeDir:I,isGroupIndex:H,inferredTab:x,groupMeta:H?{title:n.groupTitle||n.title||(I?q(I):""),position:n.groupPosition??n.sidebarPosition??(v?Y(v):void 0),icon:_t}:void 0,inferredGroupPosition:v?Y(v):void 0}}function Ee(o){let t=o.replace(/^#+.*$/gm,"").replace(/\[([^\]]+)\]\([^\)]+\)/g,"$1").replace(/\{[^\}]+\}/g,"").replace(/[_*`]/g,"").replace(/\s+/g," ");return xt(t).trim()}g();function Ut(o){return o.sort((t,e)=>!t.group&&!e.group?Nt(t,e):t.group?e.group?t.group!==e.group?je(t,e):Nt(t,e):1:-1)}function Nt(o,t){return o.sidebarPosition!==void 0&&t.sidebarPosition!==void 0?o.sidebarPosition-t.sidebarPosition:o.sidebarPosition!==void 0?-1:t.sidebarPosition!==void 0?1:o.title.localeCompare(t.title)}function je(o,t){return o.groupPosition!==void 0&&t.groupPosition!==void 0?o.groupPosition-t.groupPosition:o.groupPosition!==void 0?-1:t.groupPosition!==void 0?1:(o.groupTitle||o.group).localeCompare(t.groupTitle||t.group)}var J=new Map;async function X(o,t,e="/docs"){let s=performance.now();T.load(),J.clear(),(process.env.BOLTDOCS_FORCE_REPARSE==="true"||t?.i18n)&&T.invalidateAll();let i=await(0,Gt.default)(["**/*.md","**/*.mdx"],{cwd:o,absolute:!0,suppressErrors:!0,followSymbolicLinks:!1});T.pruneStale(new Set(i));let r=50,a=[],p=0;for(let d=0;d<i.length;d+=r){let m=i.slice(d,d+r),h=await Promise.all(m.map(async f=>{let $=T.get(f);if($)return p++,$;let D=At(f,o,e,t);return T.set(f,D),D}));a.push(...h),d+r<i.length&&await new Promise(f=>setImmediate(f))}T.save();let n=new Map,c=[];for(let d of a)if(d.isGroupIndex&&d.relativeDir&&c.push(d),d.relativeDir){let m=n.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:q(d.relativeDir),position:d.inferredGroupPosition,icon:d.route.icon},n.set(d.relativeDir,m))}for(let d of c){let m=n.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 l=new Array(a.length);for(let d=0;d<a.length;d++){let m=a[d],h=m.relativeDir,f=h?n.get(h):void 0;l[d]={...m.route,group:h,groupTitle:f?.title||(h?q(h):void 0),groupPosition:f?.position,groupIcon:f?.icon}}let u=l;if(t?.i18n){let d=He(l,t,e);u=[...l,...d]}let b=Ut(u),x=performance.now()-s;return console.log(`[boltdocs] Route generation: ${x.toFixed(2)}ms (${i.length} files, ${p} cache hits)`),b}function He(o,t,e){let s=t.i18n.defaultLocale,i=Object.keys(t.i18n.locales),r=[],a=new Map,p=[];for(let n of o){let c=n.locale||s;a.has(c)||a.set(c,new Set),a.get(c).add(n.path),c===s&&p.push(n)}for(let n of i){if(n===s)continue;let c=a.get(n)||new Set;for(let l of p){let u=Le(l.path,s,n,e);c.has(u)||r.push({...l,path:u,locale:n})}}return r}function Le(o,t,e,s){let i=`${o}:${e}`,r=J.get(i);if(r)return r;let a=s,p=o.match(new RegExp(`^${s}/(v[0-9]+)`));p&&(a+="/"+p[1]);let n=o.substring(a.length),c=`/${t}`;if(n.startsWith(c+"/"))n="/"+e+"/"+n.substring(c.length+1);else if(n===c)n="/"+e;else if(n==="/"||n==="")n="/"+e;else{let u=n.startsWith("/")?"":"/";n="/"+e+u+n}let l=a+n;return J.size>2e3&&J.clear(),J.set(i,l),l}var ne=require("vite-plugin-image-optimizer");g();var it=y(require("path")),qt=y(require("fs")),Vt=require("vite");function Wt(o){return o}var nt=["boltdocs.config.js","boltdocs.config.mjs","boltdocs.config.ts"];async function j(o,t=process.cwd()){let e=t,s={docsDir:it.default.resolve(o),theme:{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}},i={};for(let n of nt){let c=it.default.resolve(e,n);if(qt.default.existsSync(c))try{let l=await(0,Vt.loadConfigFromFile)({command:"serve",mode:"development"},c,e);if(l){i=l.config;break}}catch(l){console.warn(`[boltdocs] Failed to load config from ${n}:`,l)}}let a={...{title:i.title,description:i.description,logo:i.logo,favicon:i.favicon,ogImage:i.ogImage,navbar:i.navbar,sidebar:i.sidebar,socialLinks:i.socialLinks,footer:i.footer,githubRepo:i.githubRepo,tabs:i.tabs,codeTheme:i.codeTheme,copyMarkdown:i.copyMarkdown,breadcrumbs:i.breadcrumbs,poweredBy:i.poweredBy,communityHelp:i.communityHelp,version:i.version,editLink:i.editLink},...i.themeConfig||{},...i.theme||{}},p=Object.fromEntries(Object.entries(a).filter(([n,c])=>c!==void 0));return p.navbar&&(p.navbar=p.navbar.map(n=>({label:n.label||n.text||"",href:n.href||n.link||n.to||"",items:n.items?.map(c=>({label:c.label||c.text||"",href:c.href||c.link||c.to||""}))}))),{docsDir:it.default.resolve(o),homePage:i.homePage,theme:{...s.theme,...p},i18n:i.i18n,versions:i.versions,siteUrl:i.siteUrl,plugins:i.plugins||[],external:i.external,integrations:i.integrations,robots:i.robots,vite:i.vite}}g();var F=y(require("fs")),_=y(require("path"));k();var Qt=require("url"),Yt=require("module");g();k();function Kt(o,t){let e=E(t.title),s=E(t.description);return o.replace(/<title>.*?<\/title>/,`<title>${e}</title>`).replace(/(<meta name="description" content=")[^"]*(")/,`$1${s}$2`).replace(/(<meta property="og:title" content=")[^"]*(")/,`$1${e}$2`).replace(/(<meta property="og:description" content=")[^"]*(")/,`$1${s}$2`).replace(/(<meta name="twitter:title" content=")[^"]*(")/,`$1${e}$2`).replace(/(<meta name="twitter:description" content=")[^"]*(")/,`$1${s}$2`)}g();k();function Jt(o,t){let e=t?.siteUrl?.replace(/\/$/,"")||"https://example.com",s=new Date().toISOString().split("T")[0],i=[{url:"/",priority:"1.0",changefreq:"daily"}];if(t?.i18n){let a=t.i18n.defaultLocale;for(let p of Object.keys(t.i18n.locales))p!==a&&i.push({url:`/${p}/`,priority:"1.0",changefreq:"daily"})}return`<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${[...i,...o.map(a=>({url:a,priority:"0.8",changefreq:"weekly"}))].map(a=>`  <url>
+    <loc>${yt(e)}${yt(a.url)}</loc>
+    <lastmod>${s}</lastmod>
+    <changefreq>${a.changefreq}</changefreq>
+    <priority>${a.priority}</priority>
+  </url>`).join(`
+`)}
+</urlset>`}g();function rt(o){if(typeof o.robots=="string")return o.robots;let t=o.siteUrl?.replace(/\/$/,"")||"",e=o.robots||{},s=e.rules||[{userAgent:"*",allow:"/"}],i=e.sitemaps||(t?[`${t}/sitemap.xml`]:[]),r="";for(let a of s){if(r+=`User-agent: ${a.userAgent}
+`,a.disallow){let p=Array.isArray(a.disallow)?a.disallow:[a.disallow];for(let n of p)r+=`Disallow: ${n}
+`}if(a.allow){let p=Array.isArray(a.allow)?a.allow:[a.allow];for(let n of p)r+=`Allow: ${n}
+`}r+=`
+`}for(let a of i)r+=`Sitemap: ${a}
+`;return r.trim()}var ze=(0,Qt.fileURLToPath)(C),Xt=_.default.dirname(ze),Zt=(0,Yt.createRequire)(C);async function st(o){let{docsDir:t,docsDirName:e,outDir:s,config:i}=o,r=await X(t,i),a=i?.themeConfig?.title||"Boltdocs",p=i?.themeConfig?.description||"",n=_.default.resolve(Xt,"../client/ssr.js");if(!F.default.existsSync(n)){console.error("[boltdocs] SSR module not found at",n,"- Did you build the core package?");return}let c=Zt("module"),l=c.prototype.require;c.prototype.require=function(f,...$){return f==="virtual:boltdocs-layout"?{__esModule:!0,default:function(P){try{let I=l.apply(this,[_.default.resolve(Xt,"../client/index.js")]).DefaultLayout||(({children:mt})=>mt);return l.apply(this,["react"]).createElement(I,P)}catch{return P.children}}}:l.apply(this,[f,...$])};let{render:u}=Zt(n);c.prototype.require=l;let b=_.default.join(s,"index.html");if(!F.default.existsSync(b)){console.warn("[boltdocs] No index.html found in outDir, skipping SSG.");return}let x=F.default.readFileSync(b,"utf-8");await Promise.all(r.map(async f=>{let $=`${f.title} | ${a}`,D=f.description||p,P={};P[`/${e}/${f.filePath}`]={default:()=>null};try{let v=await u({path:f.path,routes:r,config:i||{},docsDirName:e,modules:P,homePage:void 0}),I=Kt(x,{title:E($),description:E(D)}).replace("<!--app-html-->",v).replace('<div id="root"></div>',`<div id="root">${v}</div>`),H=_.default.join(s,f.path);await F.default.promises.mkdir(H,{recursive:!0}),await F.default.promises.writeFile(_.default.join(H,"index.html"),I,"utf-8")}catch(v){console.error(`[boltdocs] Error SSR rendering route ${f.path}:`,v&&(v.stack||v))}}));let d=Jt(r.map(f=>f.path),i);F.default.writeFileSync(_.default.join(s,"sitemap.xml"),d,"utf-8");let m=rt(i);F.default.writeFileSync(_.default.join(s,"robots.txt"),m,"utf-8"),console.log(`[boltdocs] Generated ${r.length} static pages + sitemap.xml + robots.txt`);let{flushCache:h}=await Promise.resolve().then(()=>(K(),$t));await h()}k();var M=y(require("path"));g();k();var Bt=y(require("path")),te=y(require("fs"));function ee(o,t){let e=o.homePage?`import HomePage from '${R(o.homePage)}';`:"",s=Bt.default.resolve(process.cwd(),"index.css"),i=te.default.existsSync(s)?"import './index.css';":"",r=o.homePage?"homePage: HomePage,":"",a=t?.plugins?.flatMap(x=>Object.entries(x.components||{}))||[],p=a.map(([x,d])=>`import * as _comp_${x} from '${R(d)}';
+const ${x} = _comp_${x}.default || _comp_${x}['${x}'] || _comp_${x};`).join(`
+`),n=a.map(([x])=>x).join(", "),c=Bt.default.basename(o.docsDir||"docs"),l=Object.entries(t?.external||{}),u=l.map(([x,d],m)=>`import _ext_${m} from '${R(d)}';`).join(`
+`),b=l.length>0?`externalPages: { ${l.map(([x],d)=>`"${x}": _ext_${d}`).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}
+${e}
+${p}
+${u}
+
+_createApp({
+  target: '#root',
+  routes: _routes,
+  docsDirName: '${c}',
+  config: _config,
+  modules: import.meta.glob('/${c}/**/*.{md,mdx}'),
+  hot: import.meta.hot,
+  ${r}
+  ${b}
+  components: { ${n}${n?", ":""} ...(_user_mdx_components || {}) },
+});
+`}g();function oe(o){return`<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>${o.theme?.title||o.themeConfig?.title||"Boltdocs"}</title>
+</head>
+<body>
+  <div id="root"></div>
+</body>
+</html>`}function Rt(o,t){let e=t.theme||t.themeConfig,s=e?.title||"Boltdocs",i=e?.description||"",r=e?.favicon;!r&&e?.logo&&(typeof e.logo=="string"?r=e.logo:r=e.logo.light||e.logo.dark);let a=[r?`<link rel="icon" href="${r}">`:"",`<meta name="description" content="${i}">`,`<meta property="og:title" content="${s}">`,`<meta property="og:description" content="${i}">`,e?.ogImage?`<meta property="og:image" content="${e.ogImage}">`:"",'<meta property="og:type" content="website">','<meta name="twitter:card" content="summary_large_image">',`<meta name="twitter:title" content="${s}">`,`<meta name="twitter:description" content="${i}">`,e?.ogImage?`<meta name="twitter:image" content="${e.ogImage}">`:"",'<meta name="generator" content="Boltdocs">'].filter(Boolean).join(`
+    `),p=`
+    <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.includes("<title>")?o=o.replace(/<title>.*?<\/title>/,`<title>${s}</title>`):o=o.replace("</head>",`  <title>${s}</title>
+  </head>`),o=o.replace("</head>",`    ${a}
+${p}  </head>`),!o.includes("src/main")&&!o.includes("virtual:boltdocs-entry")&&(o=o.replace("</body>",`  <script type="module">import "virtual:boltdocs-entry";</script>
+  </body>`)),o}var at=y(require("fs"));g();function re(o={},t){let e=M.default.resolve(process.cwd(),o.docsDir||"docs"),s=R(e),i=t,r,a=!1,p=i?.plugins?.flatMap(n=>n.vitePlugins||[])||[];return[{name:"vite-plugin-boltdocs",enforce:"pre",async config(n,c){a=c.command==="build";let l=n.envDir||process.cwd(),u=(0,ie.loadEnv)(c.mode,l,"");return Object.assign(process.env,u),i||(i=await j(e)),{optimizeDeps:{include:["react","react-dom"]}}},configResolved(n){r=n},configureServer(n){n.middlewares.use((m,h,f)=>{if(m.url==="/robots.txt"){let $=rt(i);h.statusCode=200,h.setHeader("Content-Type","text/plain"),h.end($);return}f()}),n.middlewares.use(async(m,h,f)=>{let $=m.url?.split("?")[0]||"/";if((m.headers.accept||"").includes("text/html")&&!$.includes(".")){let P=M.default.resolve(process.cwd(),"index.html");if(!at.default.existsSync(P)){let v=oe(i);v=Rt(v,i),v=await n.transformIndexHtml(m.url||"/",v),h.statusCode=200,h.setHeader("Content-Type","text/html"),h.end(v);return}}f()});let c=nt.map(m=>M.default.resolve(process.cwd(),m)),l=["tsx","jsx"],u=l.map(m=>M.default.resolve(e,`layout.${m}`)),b=["tsx","ts","jsx","js"],x=b.map(m=>M.default.resolve(e,`mdx-components.${m}`));n.watcher.add([...c,...x,...u]);let d=async(m,h)=>{let f=R(m);if(nt.some(P=>f.endsWith(P))){n.restart();return}if(b.some(P=>f.endsWith(`mdx-components.${P}`))){let P=n.moduleGraph.getModuleById("\0virtual:boltdocs-mdx-components");P&&n.moduleGraph.invalidateModule(P),n.ws.send({type:"full-reload"});return}if(l.some(P=>f.endsWith(`layout.${P}`))){let P=n.moduleGraph.getModuleById("\0virtual:boltdocs-layout");P&&n.moduleGraph.invalidateModule(P),n.ws.send({type:"full-reload"});return}if(!f.startsWith(s)||!jt(f))return;h==="add"||h==="unlink"?St():Dt(m);let $=await X(e,i),D=n.moduleGraph.getModuleById("\0virtual:boltdocs-routes");D&&n.moduleGraph.invalidateModule(D),n.ws.send({type:"custom",event:"boltdocs:routes-update",data:$})};n.watcher.on("add",m=>d(m,"add")),n.watcher.on("unlink",m=>d(m,"unlink")),n.watcher.on("change",m=>d(m,"change"))},resolveId(n){if(n==="virtual:boltdocs-routes"||n==="virtual:boltdocs-config"||n==="virtual:boltdocs-entry"||n==="virtual:boltdocs-mdx-components"||n==="virtual:boltdocs-layout")return"\0"+n},async load(n){if(n==="\0virtual:boltdocs-routes"){let c=await X(e,i);return`export default ${JSON.stringify(c,null,2)};`}if(n==="\0virtual:boltdocs-config"){let c={theme:i?.theme,themeConfig:i?.themeConfig,integrations:i?.integrations,i18n:i?.i18n,versions:i?.versions,siteUrl:i?.siteUrl};return`export default ${JSON.stringify(c,null,2)};`}if(n==="\0virtual:boltdocs-entry")return ee(o,i);if(n==="\0virtual:boltdocs-mdx-components"){let c=["tsx","ts","jsx","js"],l=null;for(let u of c){let b=M.default.resolve(e,`mdx-components.${u}`);if(at.default.existsSync(b)){l=b;break}}if(l){let u=R(l);return`import * as components from '${u}';
+const mdxComponents = components.default || components;
+export default mdxComponents;
+export * from '${u}';`}return"export default {};"}if(n==="\0virtual:boltdocs-layout"){let c=["tsx","jsx"],l=null;for(let u of c){let b=M.default.resolve(e,`layout.${u}`);if(at.default.existsSync(b)){l=b;break}}return l?`import UserLayout from '${R(l)}';
+export default UserLayout;`:`import { DefaultLayout } from 'boltdocs/client';
+export default DefaultLayout;`}},transformIndexHtml:{order:"pre",handler(n){return Rt(n,i)}},async closeBundle(){if(!a)return;let n=r?.build?.outDir?M.default.resolve(r.root,r.build.outDir):M.default.resolve(process.cwd(),"dist"),c=M.default.basename(e||"docs");await st({docsDir:e,docsDirName:c,outDir:n,config:i});let{flushCache:l}=await Promise.resolve().then(()=>(K(),$t));await l()}},(0,ne.ViteImageOptimizer)({includePublic:!0,png:{quality:80},jpeg:{quality:80},jpg:{quality:80},webp:{quality:80},avif:{quality:80},svg:{multipass:!0,plugins:[{name:"preset-default"}]}}),...p.filter(n=>!!n)]}g();var ae=y(require("@mdx-js/rollup")),ce=y(require("remark-gfm")),le=y(require("remark-frontmatter")),de=y(require("rehype-slug")),me=y(require("crypto")),Mt=require("unist-util-visit"),pe=require("shiki");K();var ct=null;async function ue(o){if(ct)return ct;let t=typeof o=="object"?[o.light,o.dark]:[o??"github-dark"];return["github-light","github-dark"].forEach(e=>{t.includes(e)||t.push(e)}),ct=await(0,pe.createHighlighter)({themes:t,langs:["tsx","jsx","ts","js","json","md","mdx","css","html","bash","sh","yaml","yml"]}),ct}function Ae(o){return async t=>{let e=o?.themeConfig?.codeTheme??{light:"github-light",dark:"github-dark"},s=await ue(e);(0,Mt.visit)(t,["mdxJsxFlowElement","mdxJsxTextElement"],i=>{if(i.name!=="ComponentPreview")return;let r=i.attributes?.find(c=>c.name==="code"),a="";if(r){if(typeof r.value=="string")a=r.value;else if(r.value?.type==="mdxJsxAttributeValueExpression"){let c=r.value.value??"";a=c.match(/^[`'"](.+)[`'"]$/)?.[1]??c}}if(!a)return;let p=typeof e=="object"?{themes:{light:e.light,dark:e.dark},lang:"tsx"}:{theme:e,lang:"tsx"},n=s.codeToHtml(a,p);i.attributes=(i.attributes??[]).filter(c=>c.name!=="highlightedHtml"),i.attributes.push({type:"mdxJsxAttribute",name:"highlightedHtml",value:n})})}}function Ne(o){return async t=>{let e=o?.themeConfig?.codeTheme||{light:"github-light",dark:"github-dark"},s=await ue(e);(0,Mt.visit)(t,"element",i=>{if(i.tagName==="pre"&&i.children?.[0]?.tagName==="code"){let r=i.children[0],p=(r.properties?.className||[]).find(b=>b.startsWith("language-")),n=p?p.slice(9):"text",c=r.children[0]?.value||"",l={lang:n};typeof e=="object"?l.themes={light:e.light,dark:e.dark}:l.theme=e;let u=s.codeToHtml(c,l);i.properties.dataHighlighted="true",i.properties.highlightedHtml=u,i.children=[]}})}}var Ue="v3",Z=new W("mdx"),se=!1;function ge(o,t=ae.default){let e=o?.plugins?.flatMap(r=>r.remarkPlugins||[])||[],s=o?.plugins?.flatMap(r=>r.rehypePlugins||[])||[],i=t({remarkPlugins:[ce.default,le.default,[Ae,o],...e],rehypePlugins:[de.default,[Ne,o],...s],jsxRuntime:"automatic",providerImportSource:"@mdx-js/react"});return i.isMock&&console.log("MDX PLUGIN IS MOCKED"),{...i,name:"vite-plugin-boltdocs-mdx",async buildStart(){lt=0,dt=0,se||(Z.load(),se=!0),i.buildStart&&await i.buildStart.call(this)},async transform(r,a,p){if(!a.endsWith(".md")&&!a.endsWith(".mdx"))return i.transform?.call(this,r,a,p);console.log(`[boltdocs] Transforming MDX: ${a}`),dt++;let n=me.default.createHash("md5").update(r).digest("hex"),c=`${a}:${n}:${Ue}`,l=Z.get(c);if(l)return lt++,{code:l,map:null};let u=await i.transform.call(this,r,a,p);return u&&typeof u=="object"&&u.code&&Z.set(c,u.code),u},async buildEnd(){console.log(`[boltdocs] MDX Cache Performance: ${lt}/${dt} hits (${Math.round(lt/dt*100)||0}%)`),Z.save(),await Z.flush(),i.buildEnd&&await i.buildEnd.call(this)}}}var lt=0,dt=0;async function kt(o){let t=o?.docsDir||"docs",e=await j(t),s={...o,homePage:o?.homePage||e.homePage};return[...re(s,e),ge(e)]}async function Ge(o,t="development"){let e=await j("docs",o);return{root:o,mode:t,plugins:[(0,fe.default)(),(0,he.default)(),await kt({docsDir:e.docsDir,homePage:e.homePage})],...e.vite}}0&&(module.exports={createViteConfig,defineConfig,generateStaticPages,resolveConfig});

package/dist/node/index.mjs

@@ -0,0 +1 @@
+import{a,b,c,f as d,g as e,h as f}from"../chunk-V2ZHKQSP.mjs";import"../chunk-PNXZMUCO.mjs";f();export{e as createViteConfig,d as default,a as defineConfig,c as generateStaticPages,b as resolveConfig};

package/dist/search-dialog-TWGYKF2D.mjs

@@ -0,0 +1 @@
+import{a as f}from"./chunk-ISPX45DF.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-BVWWKXJH.mjs";import"./chunk-52MVMZWS.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 A({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{A as SearchDialog};

package/dist/types-Cp21DHI6.d.mts

@@ -0,0 +1,355 @@
+import React__default from 'react';
+import * as vite from 'vite';
+import { Plugin } from 'vite';
+
+/**
+ * Represents a single social link in the configuration.
+ */
+interface BoltdocsSocialLink {
+    /** Identifier for the icon (e.g., 'github') */
+    icon: 'discord' | 'x' | 'github' | 'bluesky' | string;
+    /** The URL the social link points to */
+    link: string;
+}
+/**
+ * Configuration for the site footer.
+ */
+interface BoltdocsFooterConfig {
+    /** Text to display in the footer (HTML is supported) */
+    text?: string;
+}
+/**
+ * Theme-specific configuration options governing the appearance and navigation of the site.
+ */
+interface BoltdocsThemeConfig {
+    /** The global title of the documentation site */
+    title?: string;
+    /** The global description of the site (used for SEO) */
+    description?: string;
+    /** URL path to the site logo or an object for light/dark versions */
+    logo?: string | {
+        dark: string;
+        light: string;
+        alt?: string;
+        width?: number;
+        height?: number;
+    };
+    /** Items to display in the top navigation bar */
+    navbar?: Array<{
+        /** Text to display */
+        label: string;
+        /** URL path or external link */
+        href: string;
+        /** Nested items for NavigationMenu */
+        items?: Array<{
+            label: string;
+            href: string;
+        }>;
+    }>;
+    /** Items to display in the sidebar, organized optionally by group URLs */
+    sidebar?: Record<string, Array<{
+        text: string;
+        link: string;
+    }>>;
+    /** Social links to display in the navigation bar */
+    socialLinks?: BoltdocsSocialLink[];
+    /** Site footer configuration */
+    footer?: BoltdocsFooterConfig;
+    /** Whether to show breadcrumbs navigation (default: true) */
+    breadcrumbs?: boolean;
+    /** URL template for 'Edit this page'. Use :path as a placeholder. */
+    editLink?: string;
+    /** URL for the 'Community help' link. */
+    communityHelp?: string;
+    /** The current version of the project (e.g., 'v2.8.9'). Displayed in the Navbar. */
+    version?: string;
+    /** The GitHub repository in the format 'owner/repo' to fetch and display star count. */
+    githubRepo?: string;
+    /**
+     * URL path to the site favicon.
+     * If not specified, the logo will be used if available.
+     */
+    favicon?: string;
+    /**
+     * The Open Graph image URL to display when the site is shared on social media.
+     */
+    ogImage?: string;
+    /** Whether to show the 'Powered by LiteDocs' badge in the sidebar (default: true) */
+    poweredBy?: boolean;
+    /**
+     * Top-level tabs for organizing documentation groups.
+     * Tab discovery uses the (tab-id) directory syntax.
+     */
+    tabs?: Array<{
+        id: string;
+        text: string;
+        icon?: string;
+    }>;
+    /**
+     * The syntax highlighting theme for code blocks.
+     * Supports any Shiki theme name (e.g., 'github-dark', 'one-dark-pro', 'aurora-x').
+     * Can also be an object for multiple themes (e.g., { light: 'github-light', dark: 'github-dark' }).
+     * Default: { light: 'github-light', dark: 'one-dark-pro' }
+     */
+    codeTheme?: string | {
+        light: string;
+        dark: string;
+    };
+    /**
+     * Configuration for the 'Copy Markdown' button.
+     * Can be a boolean or an object with text and icon.
+     * Default: true
+     */
+    copyMarkdown?: boolean | {
+        text?: string;
+        icon?: string;
+    };
+}
+/**
+ * Configuration for the robots.txt file.
+ */
+type BoltdocsRobotsConfig = string | {
+    /** User-agent rules */
+    rules?: Array<{
+        userAgent: string;
+        /** Paths allowed to be crawled */
+        allow?: string | string[];
+        /** Paths disallowed to be crawled */
+        disallow?: string | string[];
+    }>;
+    /** Sitemaps to include in the robots.txt */
+    sitemaps?: string[];
+};
+/**
+ * Configuration for internationalization (i18n).
+ */
+interface BoltdocsI18nConfig {
+    /** The default locale (e.g., 'en') */
+    defaultLocale: string;
+    /** Available locales and their display names (e.g., { en: 'English', es: 'Español' }) */
+    locales: Record<string, string>;
+}
+/**
+ * Configuration for documentation versioning.
+ */
+interface BoltdocsVersionsConfig {
+    /** The default version (e.g., 'v2') */
+    defaultVersion: string;
+    /** Available versions and their display names (e.g., { v1: 'Version 1.x', v2: 'Version 2.x' }) */
+    versions: Record<string, string>;
+}
+/**
+ * Defines a Boltdocs plugin that can extend the build process and client-side functionality.
+ */
+interface BoltdocsPlugin {
+    /** A unique name for the plugin */
+    name: string;
+    /** Whether to run this plugin before or after default ones (optional) */
+    enforce?: 'pre' | 'post';
+    /** Optional remark plugins to add to the MDX pipeline */
+    remarkPlugins?: unknown[];
+    /** Optional rehype plugins to add to the MDX pipeline */
+    rehypePlugins?: unknown[];
+    /** Optional Vite plugins to inject into the build process */
+    vitePlugins?: Plugin[];
+    /** Optional custom React components to register in MDX. Map of Name -> Module Path. */
+    components?: Record<string, string>;
+}
+/**
+ * Configuration for external integrations (e.g., CodeSandbox).
+ */
+interface BoltdocsIntegrationsConfig {
+    /** CodeSandbox integration settings */
+    sandbox?: {
+        /** Whether to enable the "Open in Sandbox" button in CodeBlocks */
+        enable?: boolean;
+        /** Default options for the sandbox (files, dependencies, etc.) */
+        config?: Record<string, unknown>;
+    };
+}
+/**
+ * The root configuration object for Boltdocs.
+ */
+interface BoltdocsConfig {
+    /** The base URL of the site, used for generating the sitemap */
+    siteUrl?: string;
+    /** The root directory containing markdown documentation files (default: 'docs') */
+    docsDir?: string;
+    /** Path to a custom HomePage component */
+    homePage?: string;
+    /** Configuration pertaining to the UI and appearance */
+    theme?: BoltdocsThemeConfig;
+    /** Configuration for internationalization */
+    i18n?: BoltdocsI18nConfig;
+    /** Configuration for documentation versioning */
+    versions?: BoltdocsVersionsConfig;
+    /** Custom plugins for extending functionality */
+    plugins?: BoltdocsPlugin[];
+    /** Map of custom external route paths to component file paths */
+    external?: Record<string, string>;
+    /** External integrations configuration */
+    integrations?: BoltdocsIntegrationsConfig;
+    /** Configuration for the robots.txt file */
+    robots?: BoltdocsRobotsConfig;
+    /** Low-level Vite configuration overrides */
+    vite?: vite.InlineConfig;
+    /** @deprecated Use theme instead */
+    themeConfig?: BoltdocsThemeConfig;
+}
+
+/**
+ * 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 { BoltdocsConfig as B, ComponentRoute as C, LayoutProps as L, NavbarLink as N, OnThisPageProps as O, SandboxOptions as S, BoltdocsSocialLink as a, BoltdocsTab as b, CreateBoltdocsAppOptions as c, BoltdocsThemeConfig as d, SandboxEmbedOptions as e, SandboxFile as f, SandboxFiles as g };