boltdocs 2.6.1 → 2.7.0

package/dist/mdx-hpErbRUe.cjs

@@ -0,0 +1,7 @@
+/**
+ * Boltdocs - https://boltdocs.vercel.app
+ * Copyright (c) 2026 Jesus Alcala
+ * Licensed under the MIT License.
+ */
+const e=require(`./icons-dev-rzdz6Lf3.cjs`),t=require(`./image-DIGjCPe6.cjs`);let n=require(`react`),r=require(`react/jsx-runtime`),i=require(`lucide-react`),a=require(`react-aria-components`);const o={note:{container:`bg-slate-500/5 dark:bg-slate-500/10 border-slate-500/40 text-slate-800 dark:text-slate-200`,titleText:`text-slate-900 dark:text-slate-100`,iconColor:`text-slate-500`,icon:i.Info,defaultTitle:`Note`},info:{container:`bg-indigo-500/5 dark:bg-indigo-500/10 border-indigo-500/40 text-indigo-800 dark:text-indigo-200`,titleText:`text-indigo-900 dark:text-indigo-100`,iconColor:`text-indigo-500`,icon:i.Info,defaultTitle:`Info`},tip:{container:`bg-green-500/5 dark:bg-green-500/10 border-green-500/40 text-green-800 dark:text-green-200`,titleText:`text-green-900 dark:text-green-100`,iconColor:`text-green-500`,icon:i.Lightbulb,defaultTitle:`Tip`},warning:{container:`bg-amber-500/5 dark:bg-amber-500/10 border-amber-500/40 text-amber-800 dark:text-amber-200`,titleText:`text-amber-900 dark:text-amber-100`,iconColor:`text-amber-500`,icon:i.AlertTriangle,defaultTitle:`Warning`},danger:{container:`bg-rose-500/5 dark:bg-rose-500/10 border-rose-500/40 text-rose-800 dark:text-rose-200`,titleText:`text-rose-900 dark:text-rose-100`,iconColor:`text-rose-500`,icon:i.AlertCircle,defaultTitle:`Danger`}};function s({children:t,className:n=``,variant:i=`note`,title:a,...s}){let c=o[i]||o.note,l=c.icon;return(0,r.jsxs)(`div`,{className:e.y(`my-6 flex gap-4 p-4 rounded-xl border-2`,c.container,n),...s,children:[(0,r.jsx)(`div`,{className:e.y(`shrink-0 pt-0.5`,c.iconColor),children:(0,r.jsx)(l,{className:`w-5 h-5 stroke-[2]`})}),(0,r.jsxs)(`div`,{className:`flex-1 text-[0.875rem] leading-[1.6]`,children:[(0,r.jsx)(`div`,{className:e.y(`font-bold text-sm mb-1`,c.titleText),children:a||c.defaultTitle}),(0,r.jsx)(`div`,{className:`prose prose-neutral dark:prose-invert max-w-none [&>p]:m-0 [&>p+p]:mt-2`,children:t})]})]})}const c=({children:e,name:t,type:n,description:i,required:a})=>(0,r.jsxs)(`div`,{className:`my-4 border border-subtle bg-surface/50 p-4 rounded-xl flex flex-col gap-1 text-sm select-none`,children:[(0,r.jsxs)(`div`,{className:`flex items-center gap-2`,children:[(0,r.jsx)(`span`,{className:`font-mono font-bold text-primary-500`,children:t}),n&&(0,r.jsx)(`span`,{className:`text-xs text-muted font-mono bg-soft px-1.5 py-0.5 rounded-md`,children:n}),a&&(0,r.jsx)(`span`,{className:`text-xs text-rose-500 font-semibold`,children:`required`})]}),i&&(0,r.jsx)(`div`,{className:`text-muted text-xs mt-1`,children:i}),e&&(0,r.jsx)(`div`,{className:`mt-2`,children:e})]}),l=({href:t,children:n,className:i,...a})=>(0,r.jsx)(e._,{href:t||``,className:e.y(`text-primary-500 hover:text-primary-400 dark:text-primary-500 hover:underline font-medium transition-colors duration-200`,i),...a,children:n}),u={1:`text-3xl sm:text-[2.5rem] font-extrabold tracking-tight text-body mb-4 leading-tight`,2:`text-2xl sm:text-[1.75rem] font-bold tracking-tight text-body mt-14 mb-5 pb-2 border-b border-subtle scroll-mt-24`,3:`text-lg sm:text-[1.4rem] font-semibold tracking-tight text-body mt-10 mb-4 scroll-mt-24`,4:`text-base sm:text-[1.1rem] font-semibold tracking-tight text-body mt-8 mb-3 scroll-mt-24`,5:`text-sm sm:text-[0.9rem] font-semibold tracking-tight text-body mt-6 mb-2 scroll-mt-24`,6:`text-xs sm:text-[0.75rem] font-semibold tracking-tight text-body mt-6 mb-2 scroll-mt-24`},d=({level:n,className:i,...a})=>(0,r.jsx)(t.s,{level:n,className:e.y(u[n]||``,i),...a}),f={a:l,h1:e=>(0,r.jsx)(d,{level:1,...e}),h2:e=>(0,r.jsx)(d,{level:2,...e}),h3:e=>(0,r.jsx)(d,{level:3,...e}),h4:e=>(0,r.jsx)(d,{level:4,...e}),h5:e=>(0,r.jsx)(d,{level:5,...e}),h6:e=>(0,r.jsx)(d,{level:6,...e}),p:({className:t,...n})=>(0,r.jsx)(`p`,{className:e.y(`text-paragraph leading-relaxed my-5`,t),...n}),strong:({className:t,...n})=>(0,r.jsx)(`strong`,{className:e.y(`font-semibold text-body`,t),...n}),mark:({className:t,...n})=>(0,r.jsx)(`mark`,{className:e.y(`bg-primary-500/10 text-primary-500 font-semibold px-1.5 py-0.5 rounded-md`,t),...n}),blockquote:({className:t,...n})=>(0,r.jsx)(`blockquote`,{className:e.y(`border-l-4 border-primary-500 bg-soft/30 pl-4 py-2 my-6 italic text-muted rounded-r-lg`,t),...n}),hr:({className:t,...n})=>(0,r.jsx)(`hr`,{className:e.y(`my-8 border-t border-subtle`,t),...n}),ul:({className:t,...n})=>(0,r.jsx)(`ul`,{className:e.y(`list-disc pl-6 my-5 space-y-2 text-paragraph`,t),...n}),ol:({className:t,...n})=>(0,r.jsx)(`ol`,{className:e.y(`list-decimal pl-6 my-5 space-y-2 text-paragraph`,t),...n}),li:({className:t,...n})=>(0,r.jsx)(`li`,{className:e.y(`pl-1`,t),...n})},p={table:e=>(0,r.jsx)(`div`,{className:`my-6 w-full overflow-x-auto rounded-xl border border-subtle bg-surface/30`,children:(0,r.jsx)(`table`,{className:`w-full border-collapse text-left text-sm`,...e})}),thead:t=>(0,r.jsx)(`thead`,{className:e.y(`border-b border-subtle bg-soft/50`,t.className),...t}),tbody:e=>(0,r.jsx)(`tbody`,{...e}),tr:t=>(0,r.jsx)(`tr`,{className:e.y(`border-b border-subtle last:border-0 even:bg-soft/10 hover:bg-soft/20 transition-colors`,t.className),...t}),th:t=>(0,r.jsx)(`th`,{className:e.y(`px-4 py-3 font-semibold text-body text-xs font-mono`,t.className),...t}),td:t=>(0,r.jsx)(`td`,{className:e.y(`px-4 py-3 text-paragraph leading-relaxed`,t.className),...t})},m=(e,t)=>{if(e==null||typeof e==`boolean`)return``;if(typeof e==`string`||typeof e==`number`)return String(e);if(Array.isArray(e))return e.map(e=>m(e,t)).join(``);if((0,n.isValidElement)(e)){let n=t?.get(e.type);return n?n(e.props):m(e.props.children,t)}return``},h=async e=>{try{return await navigator.clipboard.writeText(e),!0}catch{let t=document.createElement(`textarea`);return t.value=e,t.style.position=`fixed`,t.style.opacity=`0`,document.body.appendChild(t),t.select(),document.execCommand(`copy`),document.body.removeChild(t),!0}};function g(e){let[t,r]=(0,n.useState)(!1),[i,a]=(0,n.useState)(!1),[o,s]=(0,n.useState)(!1),c=(0,n.useRef)(null),l=(0,n.useCallback)(async()=>{h(c.current?.textContent??``),r(!0),setTimeout(()=>r(!1),2e3)},[]);return(0,n.useEffect)(()=>{let e=(c.current?.textContent??``).trim().split(`
+`).length;s(e>6)},[e.children,e.highlightedHtml]),{copied:t,isExpanded:i,setIsExpanded:a,isExpandable:o,preRef:c,handleCopy:l,shouldTruncate:o&&!i}}const _={ts:e.m,tsx:e.d,js:e.c,jsx:e.d,json:e.l,css:e.i,html:e.n,md:e.u,mdx:e.u,bash:e.p,sh:e.p,yaml:e.g,yml:e.g,rs:e.f,rust:e.f,toml:e.r,csv:e.a},v=({copied:n,handleCopy:o})=>(0,r.jsx)(t.n,{content:n?`Copied!`:`Copy code`,children:(0,r.jsx)(a.Button,{onPress:o,className:e.y(`grid place-items-center size-8 bg-transparent outline-none cursor-pointer transition-all duration-200 hover:scale-110 active:scale-95 [&>svg]:size-4 [&>svg]:stroke-2 z-10`,n?`text-emerald-400`:`text-muted hover:text-body`),"aria-label":`Copy code`,children:n?(0,r.jsx)(i.Check,{size:20}):(0,r.jsx)(i.Copy,{size:20})})});function y(n){let{children:o,hideCopy:s=!1,highlightedHtml:c,"data-highlighted-html":l,title:u,"data-title":d,"data-lang":f,plain:p=!1,...h}=n,y=c||l,b=typeof y==`string`?y.replace(/<span class="line">\s*(?:<span[^>]*>\s*<\/span>)?\s*<\/span>\s*(<\/code>\s*<\/pre>)/g,`$1`):y,x=u||d,S=n.lang||f||``,{copied:C,isExpanded:w,setIsExpanded:T,isExpandable:E,preRef:D,handleCopy:O,shouldTruncate:k}=g(n),A=_[S];return(0,r.jsxs)(t.r,{plain:p,className:n.className,children:[(x||!s)&&(0,r.jsxs)(t.o,{className:e.y({"absolute top-2 left-0 w-full":!x}),children:[(0,r.jsx)(t.a,{children:x&&(0,r.jsxs)(r.Fragment,{children:[A?(0,r.jsx)(A,{size:14}):(0,r.jsx)(i.File,{size:14,className:`opacity-60`}),(0,r.jsx)(`span`,{children:x})]})}),(0,r.jsx)(`div`,{className:`flex items-center gap-1`,children:!s&&(0,r.jsx)(v,{copied:C,handleCopy:O})})]}),(0,r.jsxs)(t.i,{shouldTruncate:k,children:[b?(0,r.jsx)(`div`,{ref:D,className:`shiki-wrapper overflow-x-auto [&>pre]:m-0! [&>pre]:rounded-none! [&>pre]:border-none! [&>pre]:bg-inherit! [&>pre>code]:grid! [&>pre>code]:p-5! [&>pre>code]:text-[0.875rem]! [&>pre>code]:leading-[1.6]! [&>.shiki.shiki-themes]:bg-transparent!`,dangerouslySetInnerHTML:{__html:b}}):(0,r.jsx)(`pre`,{ref:D,className:`m-0! p-5! rounded-none! border-none! bg-inherit! font-mono text-[0.875rem] leading-[1.6] overflow-x-auto`,...h,children:m(o).trimEnd()}),E&&(0,r.jsx)(`div`,{className:e.y(k?`absolute bottom-0 inset-x-0 h-24 bg-linear-to-t from-(--color-code-bg) to-transparent flex items-end justify-center pb-4 z-10`:`relative flex justify-center pb-4 pt-1 -mt-4`),children:(0,r.jsx)(a.Button,{onPress:()=>T(!w),className:`rounded-full bg-surface border border-subtle px-5 py-2 text-[0.8125rem] font-medium text-body outline-none cursor-pointer transition-all hover:bg-soft hover:-translate-y-px backdrop-blur-md`,children:w?`Show less`:`Expand code`})})]})]})}const b=({src:n,alt:i,title:a,theme:o,className:s,...c})=>{let{theme:l}=t.l();if(!n||o!==l)return null;let u=a||i;return(0,r.jsxs)(`figure`,{className:`my-6 sm:my-8 flex flex-col items-center justify-center group not-prose`,children:[(0,r.jsx)(`div`,{className:`relative w-full overflow-hidden rounded-lg sm:rounded-2xl border border-subtle bg-soft/30 transition-all duration-300 sm:max-w-[85%] lg:max-w-full`,children:(0,r.jsx)(t.t,{src:n,alt:i||``,theme:o,loading:`lazy`,decoding:`async`,className:e.y(`w-full h-auto object-contain transition-transform duration-500 group-hover:scale-[1.01] my-0 rounded-md sm:rounded-xl block`,s),...c})}),u&&(0,r.jsx)(`figcaption`,{className:`mt-2 sm:mt-3 text-center text-xs sm:text-sm text-muted font-medium select-none tracking-wide opacity-90 sm:opacity-80 group-hover:opacity-100 transition-opacity duration-300 px-2`,children:u})]})},x={img:b,Image:b};function S({className:t,title:i,icon:a,href:o,children:s,...c}){let[l,u]=(0,n.useState)({x:0,y:0}),[d,f]=(0,n.useState)(0),p=(0,n.useRef)(null),m=e=>{if(!p.current)return;let t=p.current.getBoundingClientRect();u({x:e.clientX-t.left,y:e.clientY-t.top})},h=()=>f(1),g=()=>f(0),_=o?`a`:`div`,v=`var(--color-primary-500, #eb5828)`;return(0,r.jsxs)(_,{ref:p,href:o,onMouseMove:m,onMouseEnter:h,onMouseLeave:g,className:e.y(`group relative flex flex-col gap-3 rounded-2xl border p-6 overflow-hidden transition-all duration-300`,`hover:shadow-lg dark:hover:shadow-none hover:-translate-y-0.5`,`bg-surface border-subtle text-paragraph`,o&&`cursor-pointer`,t),...c,children:[(0,r.jsx)(`div`,{className:`pointer-events-none absolute inset-0 transition-opacity duration-300`,style:{opacity:d,background:`radial-gradient(600px circle at ${l.x}px ${l.y}px, color-mix(in srgb, ${v} 8%, transparent), transparent 40%)`}}),(0,r.jsx)(`div`,{className:`pointer-events-none absolute inset-0 rounded-2xl transition-opacity duration-300`,style:{opacity:d,padding:`1px`,background:`radial-gradient(400px circle at ${l.x}px ${l.y}px, color-mix(in srgb, ${v} 50%, transparent), transparent 40%)`,WebkitMask:`linear-gradient(#fff 0 0) content-box, linear-gradient(#fff 0 0)`,WebkitMaskComposite:`xor`,maskComposite:`exclude`}}),(0,r.jsxs)(`div`,{className:`relative z-10 flex items-center gap-3`,children:[a&&(0,r.jsx)(`div`,{className:e.y(`shrink-0 transition-transform duration-500 group-hover:rotate-[15deg] group-hover:scale-110 flex items-center justify-center text-muted group-hover:text-primary-500`,`[&>svg]:w-6 [&>svg]:h-6 [&>svg]:stroke-[1.5]`),children:a}),i&&(0,r.jsx)(`h3`,{className:`font-semibold text-base m-0 leading-none text-body`,children:i})]}),(0,r.jsx)(`div`,{className:`relative z-10 text-[0.875rem] leading-[1.6] opacity-90 prose prose-neutral dark:prose-invert max-w-none [&>p]:m-0 [&>p+p]:mt-2`,children:s})]})}function C({children:t,className:n,cols:i=2,...a}){return(0,r.jsx)(`div`,{className:e.y(`grid gap-4 my-6`,{"grid-cols-1":i===1,"grid-cols-1 sm:grid-cols-2":i===2,"grid-cols-1 sm:grid-cols-2 md:grid-cols-3":i===3,"grid-cols-1 sm:grid-cols-2 lg:grid-cols-4":i===4},n),...a,children:t})}const w={...f,...p,...x,pre:y,Field:c,Callout:s,Card:S,Cards:C};Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return m}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return C}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return S}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return w}});

package/dist/meta-loader-0gJ4PtBC.cjs

@@ -0,0 +1,6 @@
+/**
+ * Boltdocs - https://boltdocs.vercel.app
+ * Copyright (c) 2026 Jesus Alcala
+ * Licensed under the MIT License.
+ */
+const e=require(`./chunk-Ds5LZdWN.cjs`);let t=require(`node:path`);t=e.n(t);let n=require(`fdir`),r=require(`node:fs/promises`);r=e.n(r);async function i(e){let i={};try{let a=(await new n.fdir().withFullPaths().filter(e=>e.endsWith(`meta.json`)).crawl(e).withPromise()).filter(e=>{let n=t.default.basename(e);return n===`meta.json`||n===`_meta.json`}),o=await Promise.allSettled(a.map(async n=>{let i=await r.default.readFile(n,`utf-8`),a=t.default.relative(e,t.default.dirname(n)).replace(/\\/g,`/`);return{key:a===``?`.`:a,content:JSON.parse(i)}}));for(let e of o)e.status===`fulfilled`?i[e.value.key]=e.value.content:console.warn(`[Boltdocs] Failed to read meta.json:`,e.reason)}catch(e){console.error(`[Boltdocs] Error loading directory metadata:`,e)}return i}exports.loadDirectoryMeta=i;

package/dist/meta-loader-9IpAHWDS.mjs

@@ -0,0 +1,6 @@
+/**
+ * Boltdocs - https://boltdocs.vercel.app
+ * Copyright (c) 2026 Jesus Alcala
+ * Licensed under the MIT License.
+ */
+import e from"node:path";import{fdir as t}from"fdir";import n from"node:fs/promises";async function r(r){let i={};try{let a=(await new t().withFullPaths().filter(e=>e.endsWith(`meta.json`)).crawl(r).withPromise()).filter(t=>{let n=e.basename(t);return n===`meta.json`||n===`_meta.json`}),o=await Promise.allSettled(a.map(async t=>{let i=await n.readFile(t,`utf-8`),a=e.relative(r,e.dirname(t)).replace(/\\/g,`/`);return{key:a===``?`.`:a,content:JSON.parse(i)}}));for(let e of o)e.status===`fulfilled`?i[e.value.key]=e.value.content:console.warn(`[Boltdocs] Failed to read meta.json:`,e.reason)}catch(e){console.error(`[Boltdocs] Error loading directory metadata:`,e)}return i}export{r as loadDirectoryMeta};

package/dist/node/cli-entry.cjs

@@ -4,5 +4,4 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-const e=require(`../node-D5iosYXv.cjs`);let t=require(`vite`),n=require(`fast-glob`);n=e.S(n);let r=require(`fs`);r=e.S(r);let i=require(`path`);i=e.S(i);let a=require(`cac`);a=e.S(a);let o=require(`@bdocs/ssg/node`);var s=e.x({colors:()=>c,error:()=>d,formatLog:()=>l,info:()=>u,success:()=>f});const c={reset:`\x1B[0m`,bold:`\x1B[1m`,red:`\x1B[31m`,green:`\x1B[32m`,yellow:`\x1B[33m`,blue:`\x1B[34m`,cyan:`\x1B[36m`,gray:`\x1B[90m`};function l(e,t=``){return`${t}${c.bold}[boltdocs]${c.reset} ${e}${c.reset}`}function u(e){console.log(l(e))}function d(e,t){console.error(l(e,c.red)),t&&console.error(t)}function f(e){console.log(l(e,c.green))}async function p(t=process.cwd()){try{let n=await(0,o.createServer)(await e.n(t,`development`));await n.listen(),n.printUrls(),n.bindCLIShortcuts({print:!0})}catch(e){d(`Failed to start dev server:`,e),process.exit(1)}}async function m(t=process.cwd()){try{await(0,o.build)({entry:`boltdocs/entry`},await e.n(t,`production`)),f(`SSG build completed successfully!`)}catch(e){d(`Build failed:`,e),process.exit(1)}}async function h(n=process.cwd()){try{(await(0,t.preview)(await e.n(n,`production`))).printUrls()}catch(e){d(`Failed to start preview server:`,e),process.exit(1)}}async function g(t=process.cwd()){let{colors:a}=s;u(`${a.bold}Running documentation health check...${a.reset}\n`);let o=performance.now();try{let s=await e.g(`docs`,t),c=i.default.resolve(t,`docs`);r.default.existsSync(c)||(d(`Documentation directory not found at ${c}`),process.exit(1));let l=await(0,n.default)([`**/*.md`,`**/*.mdx`],{cwd:c,absolute:!0,suppressErrors:!0}),p=0,m=0,h=0,g=new Map,_=(e,t)=>{let n=i.default.relative(c,e),r=g.get(n);r||(r=[],g.set(n,r)),r.push(t),t.level===`high`?p++:t.level===`warning`?m++:t.level===`low`&&h++},v=`/docs`;for(let t of l){let{data:n,content:a}=e.y(t);n.title||_(t,{level:`warning`,message:`Missing "title" in frontmatter.`,suggestion:"Add `title: Your Title` to the YAML frontmatter at the top of the file."}),n.description||_(t,{level:`low`,message:`Missing "description" in frontmatter.`,suggestion:`Adding a description helps with SEO and search previews.`});let o=/\[.*?\]\((.*?)\)/g,s=/<a\s+[^>]*href=["']([^"']+)["'][^>]*>/g,l=[...a.matchAll(o),...a.matchAll(s)];for(let e of l){let n=e[1];if(!n||n.startsWith(`http`)||n.startsWith(`https`)||n.startsWith(`#`)||n.startsWith(`mailto:`)||n.startsWith(`tel:`)||(n=n.split(`#`)[0],!n))continue;let a;if(n.startsWith(`/`)){let e=n;(n.startsWith(v+`/`)||n===v)&&(e=n.substring(5)),a=i.default.join(c,e)}else a=i.default.resolve(i.default.dirname(t),n);let o=[``,`.md`,`.mdx`,`/index.md`,`/index.mdx`],s=!1;for(let e of o){let t=a+e;if(r.default.existsSync(t)&&r.default.statSync(t).isFile()){s=!0;break}}s||_(t,{level:`high`,message:`Broken internal link: "${n}"`,suggestion:`Ensure the file exists at "${a}". If it's a directory, ensure it has an "index.md" or "index.mdx".`})}}if(s.i18n){let{defaultLocale:t,locales:n}=s.i18n,a=Object.keys(n).filter(e=>e!==t);for(let n of l){let o=e.v(i.default.relative(c,n)).split(`/`);if(o[0]===t){let e=o.slice(1).join(`/`);for(let t of a){let a=[t,...o.slice(1)],s=i.default.join(c,...a);r.default.existsSync(s)||_(n,{level:`warning`,message:`Missing translation for locale "${t}"`,suggestion:`Create a translated version of this file at "${t}/${e}".`})}}}}if(g.size===0)f(`All documentation files are healthy!
-`);else{for(let[e,t]of g.entries()){console.log(`📄 ${a.bold}${e}${a.reset}`);let n=t.sort((e,t)=>{let n={high:1,warning:2,low:3};return n[e.level]-n[t.level]});for(let e of n){let t=``,n=``;e.level===`high`?(t=`❌`,n=a.red):e.level===`warning`?(t=`⚠️`,n=a.yellow):(t=`ℹ️`,n=a.cyan),console.log(`   ${n}${t} ${e.level.toUpperCase()}:${a.reset} ${e.message}`),e.suggestion&&console.log(`      ${a.gray}💡 Suggestion: ${e.suggestion}${a.reset}`)}console.log(``)}console.log(`${a.bold}Summary:${a.reset}`),console.log(`   ${a.red}${p} high-level errors${a.reset}`),console.log(`   ${a.yellow}${m} warnings${a.reset}`),console.log(`   ${a.cyan}${h} minor improvements${a.reset}\n`),p>0&&d(`HIGH ERROR: Fix these to ensure your documentation builds correctly.`),(m>0||h>0)&&u(`TIP: Address warnings and suggestions for premium quality docs.`),console.log(``)}u(`Finished in ${(performance.now()-o).toFixed(2)}ms\n`),p>0&&process.exit(1)}catch(e){d(`Failed to run doctor check:`,e),process.exit(1)}}const _=(0,a.default)(`boltdocs`);_.command(`[root]`,`Start development server`).alias(`dev`).action(p),_.command(`build [root]`,`Build for production`).action(m),_.command(`preview [root]`,`Preview production build`).action(h),_.command(`doctor [root]`,`Check documentation health`).action(g),_.help(),_.version(`2.0.0`),_.parse();
+const e=require(`../chunk-Ds5LZdWN.cjs`),t=require(`../routes-Co1mRM58.cjs`),n=require(`../node-CinkUtxV.cjs`),r=require(`../doctor-COpf35L2.cjs`);let i=require(`vite`),a=require(`node:path`);a=e.n(a);let o=require(`cac`);o=e.n(o);let s=require(`@bdocs/ssg/node`);async function c(e=process.cwd()){try{let t=await(0,s.createServer)(await n.n(e,`development`));await t.listen(),t.printUrls(),t.bindCLIShortcuts({print:!0})}catch(e){r.u(`Failed to start dev server:`,e),process.exit(1)}}async function l(e=process.cwd()){try{let i=await n.n(e,`production`),o=await r.p(`docs`,e),c=await t.t(a.default.resolve(e,`docs`),o,i.base),l={};for(let e of c)if(e.path&&e.componentPath){l[e.path]=e.componentPath;let t=e.path.replace(/\/$/,``);l[t]=e.componentPath}await(0,s.build)({entry:`boltdocs/entry`,routeToSourceFileMap:l,cacheDir:a.default.resolve(e,`.boltdocs`)},i),r.d(`SSG build completed successfully!`)}catch(e){r.u(`Build failed:`,e),process.exit(1)}}async function u(e=process.cwd()){try{(await(0,i.preview)(await n.n(e,`production`))).printUrls()}catch(e){r.u(`Failed to start preview server:`,e),process.exit(1)}}const d=(0,o.default)(`boltdocs`);d.command(`[root]`,`Start development server`).alias(`dev`).action(c),d.command(`build [root]`,`Build for production`).action(l),d.command(`preview [root]`,`Preview production build`).action(u),d.command(`doctor [root]`,`Check the health of your documentation`).option(`--fix`,`Automatically fix broken internal links and sync translations`).option(`--check-external`,`Verify external links (slower)`).option(`--init`,`Initialize doctor.json with default configuration`).action(async(e,t)=>{let{doctorAction:n}=await Promise.resolve().then(()=>require(`../doctor-BQiQhCTl.cjs`));await n(e,t)}),d.command(`generate-changelog <file>`,`Generate changelog documentation from CHANGELOG.md`).option(`-o, --output <path>`,`Output folder (default: docs/changelog)`,{default:`docs/changelog`}).option(`-t, --title <text>`,`Title for changelog pages`,{default:`Changelog`}).option(`--infer-tab`,`Infer tab from folder name (default: true)`,{default:!0}).option(`-l, --limit <number>`,`Limit number of versions to generate`).action(async(e,t)=>{let{generateChangelog:n}=await Promise.resolve().then(()=>require(`../generator-DGW6pkCC.cjs`));await n(e,{output:t.output,title:t.title,inferTab:t.inferTab,limit:t.limit?parseInt(String(t.limit),10):void 0})}),d.help(),d.version(`2.0.0`),d.parse();

package/dist/node/cli-entry.mjs

@@ -4,5 +4,4 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-import{g as e,n as t,v as n,y as r}from"../node-CWN8U_p8.mjs";import{preview as i}from"vite";import a from"fast-glob";import o from"fs";import s from"path";import c from"cac";import{build as l,createServer as u}from"@bdocs/ssg/node";var d=Object.defineProperty,f=((e,t)=>{let n={};for(var r in e)d(n,r,{get:e[r],enumerable:!0});return t||d(n,Symbol.toStringTag,{value:`Module`}),n})({colors:()=>p,error:()=>g,formatLog:()=>m,info:()=>h,success:()=>_});const p={reset:`\x1B[0m`,bold:`\x1B[1m`,red:`\x1B[31m`,green:`\x1B[32m`,yellow:`\x1B[33m`,blue:`\x1B[34m`,cyan:`\x1B[36m`,gray:`\x1B[90m`};function m(e,t=``){return`${t}${p.bold}[boltdocs]${p.reset} ${e}${p.reset}`}function h(e){console.log(m(e))}function g(e,t){console.error(m(e,p.red)),t&&console.error(t)}function _(e){console.log(m(e,p.green))}async function v(e=process.cwd()){try{let n=await u(await t(e,`development`));await n.listen(),n.printUrls(),n.bindCLIShortcuts({print:!0})}catch(e){g(`Failed to start dev server:`,e),process.exit(1)}}async function y(e=process.cwd()){try{await l({entry:`boltdocs/entry`},await t(e,`production`)),_(`SSG build completed successfully!`)}catch(e){g(`Build failed:`,e),process.exit(1)}}async function b(e=process.cwd()){try{(await i(await t(e,`production`))).printUrls()}catch(e){g(`Failed to start preview server:`,e),process.exit(1)}}async function x(t=process.cwd()){let{colors:i}=f;h(`${i.bold}Running documentation health check...${i.reset}\n`);let c=performance.now();try{let l=await e(`docs`,t),u=s.resolve(t,`docs`);o.existsSync(u)||(g(`Documentation directory not found at ${u}`),process.exit(1));let d=await a([`**/*.md`,`**/*.mdx`],{cwd:u,absolute:!0,suppressErrors:!0}),f=0,p=0,m=0,v=new Map,y=(e,t)=>{let n=s.relative(u,e),r=v.get(n);r||(r=[],v.set(n,r)),r.push(t),t.level===`high`?f++:t.level===`warning`?p++:t.level===`low`&&m++},b=`/docs`;for(let e of d){let{data:t,content:n}=r(e);t.title||y(e,{level:`warning`,message:`Missing "title" in frontmatter.`,suggestion:"Add `title: Your Title` to the YAML frontmatter at the top of the file."}),t.description||y(e,{level:`low`,message:`Missing "description" in frontmatter.`,suggestion:`Adding a description helps with SEO and search previews.`});let i=/\[.*?\]\((.*?)\)/g,a=/<a\s+[^>]*href=["']([^"']+)["'][^>]*>/g,c=[...n.matchAll(i),...n.matchAll(a)];for(let t of c){let n=t[1];if(!n||n.startsWith(`http`)||n.startsWith(`https`)||n.startsWith(`#`)||n.startsWith(`mailto:`)||n.startsWith(`tel:`)||(n=n.split(`#`)[0],!n))continue;let r;if(n.startsWith(`/`)){let e=n;(n.startsWith(b+`/`)||n===b)&&(e=n.substring(5)),r=s.join(u,e)}else r=s.resolve(s.dirname(e),n);let i=[``,`.md`,`.mdx`,`/index.md`,`/index.mdx`],a=!1;for(let e of i){let t=r+e;if(o.existsSync(t)&&o.statSync(t).isFile()){a=!0;break}}a||y(e,{level:`high`,message:`Broken internal link: "${n}"`,suggestion:`Ensure the file exists at "${r}". If it's a directory, ensure it has an "index.md" or "index.mdx".`})}}if(l.i18n){let{defaultLocale:e,locales:t}=l.i18n,r=Object.keys(t).filter(t=>t!==e);for(let t of d){let i=n(s.relative(u,t)).split(`/`);if(i[0]===e){let e=i.slice(1).join(`/`);for(let n of r){let r=[n,...i.slice(1)],a=s.join(u,...r);o.existsSync(a)||y(t,{level:`warning`,message:`Missing translation for locale "${n}"`,suggestion:`Create a translated version of this file at "${n}/${e}".`})}}}}if(v.size===0)_(`All documentation files are healthy!
-`);else{for(let[e,t]of v.entries()){console.log(`📄 ${i.bold}${e}${i.reset}`);let n=t.sort((e,t)=>{let n={high:1,warning:2,low:3};return n[e.level]-n[t.level]});for(let e of n){let t=``,n=``;e.level===`high`?(t=`❌`,n=i.red):e.level===`warning`?(t=`⚠️`,n=i.yellow):(t=`ℹ️`,n=i.cyan),console.log(`   ${n}${t} ${e.level.toUpperCase()}:${i.reset} ${e.message}`),e.suggestion&&console.log(`      ${i.gray}💡 Suggestion: ${e.suggestion}${i.reset}`)}console.log(``)}console.log(`${i.bold}Summary:${i.reset}`),console.log(`   ${i.red}${f} high-level errors${i.reset}`),console.log(`   ${i.yellow}${p} warnings${i.reset}`),console.log(`   ${i.cyan}${m} minor improvements${i.reset}\n`),f>0&&g(`HIGH ERROR: Fix these to ensure your documentation builds correctly.`),(p>0||m>0)&&h(`TIP: Address warnings and suggestions for premium quality docs.`),console.log(``)}h(`Finished in ${(performance.now()-c).toFixed(2)}ms\n`),f>0&&process.exit(1)}catch(e){g(`Failed to run doctor check:`,e),process.exit(1)}}const S=c(`boltdocs`);S.command(`[root]`,`Start development server`).alias(`dev`).action(v),S.command(`build [root]`,`Build for production`).action(y),S.command(`preview [root]`,`Preview production build`).action(b),S.command(`doctor [root]`,`Check documentation health`).action(x),S.help(),S.version(`2.0.0`),S.parse();export{};
+import{i as e,o as t,r as n}from"../doctor-Dh1XP7Pz.mjs";import{t as r}from"../routes-CMUZGI6T.mjs";import{n as i}from"../node-C2nWXElP.mjs";import{preview as a}from"vite";import o from"node:path";import s from"cac";import{build as c,createServer as l}from"@bdocs/ssg/node";async function u(e=process.cwd()){try{let t=await l(await i(e,`development`));await t.listen(),t.printUrls(),t.bindCLIShortcuts({print:!0})}catch(e){n(`Failed to start dev server:`,e),process.exit(1)}}async function d(a=process.cwd()){try{let n=await i(a,`production`),s=await t(`docs`,a),l=await r(o.resolve(a,`docs`),s,n.base),u={};for(let e of l)if(e.path&&e.componentPath){u[e.path]=e.componentPath;let t=e.path.replace(/\/$/,``);u[t]=e.componentPath}await c({entry:`boltdocs/entry`,routeToSourceFileMap:u,cacheDir:o.resolve(a,`.boltdocs`)},n),e(`SSG build completed successfully!`)}catch(e){n(`Build failed:`,e),process.exit(1)}}async function f(e=process.cwd()){try{(await a(await i(e,`production`))).printUrls()}catch(e){n(`Failed to start preview server:`,e),process.exit(1)}}const p=s(`boltdocs`);p.command(`[root]`,`Start development server`).alias(`dev`).action(u),p.command(`build [root]`,`Build for production`).action(d),p.command(`preview [root]`,`Preview production build`).action(f),p.command(`doctor [root]`,`Check the health of your documentation`).option(`--fix`,`Automatically fix broken internal links and sync translations`).option(`--check-external`,`Verify external links (slower)`).option(`--init`,`Initialize doctor.json with default configuration`).action(async(e,t)=>{let{doctorAction:n}=await import(`../doctor-Dh1XP7Pz.mjs`).then(e=>e.t);await n(e,t)}),p.command(`generate-changelog <file>`,`Generate changelog documentation from CHANGELOG.md`).option(`-o, --output <path>`,`Output folder (default: docs/changelog)`,{default:`docs/changelog`}).option(`-t, --title <text>`,`Title for changelog pages`,{default:`Changelog`}).option(`--infer-tab`,`Infer tab from folder name (default: true)`,{default:!0}).option(`-l, --limit <number>`,`Limit number of versions to generate`).action(async(e,t)=>{let{generateChangelog:n}=await import(`../generator-Dv3wEmhZ.mjs`);await n(e,{output:t.output,title:t.title,inferTab:t.inferTab,limit:t.limit?parseInt(String(t.limit),10):void 0})}),p.help(),p.version(`2.0.0`),p.parse();export{};

package/dist/node/index.cjs

@@ -3,4 +3,4 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require(`../node-D5iosYXv.cjs`);exports.BoltdocsPluginStore=e.l,exports.PluginCompatibilityError=e.u,exports.PluginError=e.d,exports.PluginHookError=e.f,exports.PluginLifecycleManager=e.i,exports.PluginPermissionError=e.p,exports.PluginSandbox=e.a,exports.PluginValidationError=e.m,exports.SecurePluginSchema=e.o,exports.createPlugin=e.r,exports.createViteConfig=e.n,exports.default=e.t,exports.defineConfig=e._,exports.generateEntryCode=e.h,exports.hasPermission=e.s,exports.normalizePath=e.v,exports.resolveConfig=e.g,exports.sanitizeFilename=e.b,exports.validatePlugins=e.c;
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require(`../utils-Clzu7jvb.cjs`),t=require(`../node-CinkUtxV.cjs`),n=require(`../doctor-COpf35L2.cjs`);exports.BoltdocsPluginStore=t.u,exports.PluginCompatibilityError=t.d,exports.PluginError=t.f,exports.PluginHookError=t.p,exports.PluginLifecycleManager=t.a,exports.PluginPermissionError=t.m,exports.PluginSandbox=t.o,exports.PluginValidationError=t.h,exports.SecurePluginSchema=t.s,exports.createPlugin=t.i,exports.createViteConfig=t.n,exports.default=t.t,exports.defineConfig=n.h,exports.generateEntryCode=t.r,exports.hasPermission=t.c,exports.normalizePath=e.l,exports.resolveConfig=n.p,exports.sanitizeFilename=e.d,exports.validatePlugins=t.l;

package/dist/node/index.d.cts

@@ -33,24 +33,26 @@ interface BoltdocsThemeConfig {
   navbar?: Array<{
     label: string | Record<string, string>;
     href: string;
+    items?: Array<{
+      label: string | Record<string, string>;
+      href: string;
+    }>;
   }>;
   sidebar?: Record<string, Array<{
     text: string;
     link: string;
   }>>;
   sidebarGroups?: Record<string, {
-    title?: string;
+    title?: string | Record<string, string>;
     icon?: string;
   }>;
   socialLinks?: BoltdocsSocialLink[];
   footer?: BoltdocsFooterConfig;
-  breadcrumbs?: boolean;
   editLink?: string;
   communityHelp?: string;
   version?: string;
   githubRepo?: string;
   favicon?: string;
-  poweredBy?: boolean;
   tabs?: Array<{
     id: string;
     text: string | Record<string, string>;
@@ -60,10 +62,6 @@ interface BoltdocsThemeConfig {
     light: ShikiTheme;
     dark: ShikiTheme;
   };
-  copyMarkdown?: boolean | {
-    text?: string;
-    icon?: string;
-  };
 }
 /**
  * List of supported syntax highlighting themes.
@@ -94,7 +92,7 @@ interface BoltdocsLocaleConfig {
  */
 interface BoltdocsI18nConfig {
   defaultLocale: string;
-  locales: Record<string, string>;
+  locales: string[] | Record<string, string>;
   localeConfigs?: Record<string, BoltdocsLocaleConfig>;
 }
 /**
@@ -145,6 +143,34 @@ interface BoltdocsSeoConfig {
     background?: string;
   };
 }
+/**
+ * Configuration for Google Analytics 4 (GA4).
+ */
+interface BoltdocsGA4Config {
+  measurementId: string;
+  debug?: boolean;
+  anonymizeIp?: boolean;
+  sendPageView?: boolean;
+  cookieFlags?: string;
+  autoTrack?: {
+    pageViews?: boolean;
+    downloads?: boolean;
+    externalLinks?: boolean;
+    search?: boolean;
+  };
+}
+/**
+ * Configuration for Google Tag Manager (GTM).
+ */
+interface BoltdocsGTMConfig {
+  tagId: string;
+  dataLayerName?: string;
+  preview?: string;
+}
+interface BoltdocsIntegrationsConfig {
+  ga4?: BoltdocsGA4Config;
+  gtm?: BoltdocsGTMConfig;
+}
 /**
  * The root configuration object for Boltdocs.
  */
@@ -152,7 +178,6 @@ interface BoltdocsConfig {
   siteUrl?: string;
   docsDir?: string;
   base?: string;
-  homePage?: string;
   theme?: BoltdocsThemeConfig;
   i18n?: BoltdocsI18nConfig;
   versions?: BoltdocsVersionsConfig;
@@ -160,8 +185,20 @@ interface BoltdocsConfig {
   robots?: BoltdocsRobotsConfig;
   security?: BoltdocsSecurityConfig;
   seo?: BoltdocsSeoConfig;
+  integrations?: BoltdocsIntegrationsConfig;
+  /** Aggregated metadata from local meta.json files */
+  directoryMeta?: Record<string, any>;
   vite?: any;
 }
+/**
+ * Global namespace for Boltdocs types that can be augmented by generated code.
+ * This allows for strictly typed locales and versions based on the project configuration.
+ */
+declare global {
+  namespace Boltdocs {
+    interface Types {}
+  }
+}
 //#endregion
 //#region src/shared/config-utils.d.ts
 /**
@@ -191,8 +228,6 @@ declare function resolveConfig(docsDir: string, root?: string): Promise<Boltdocs
 interface BoltdocsPluginOptions {
   /** The root directory containing markdown files (default: 'docs') */
   docsDir?: string;
-  /** Path to a custom home page component (relative to project root) to render at '/' */
-  homePage?: string;
 }
 //#endregion
 //#region src/node/plugin/entry.d.ts
@@ -204,7 +239,7 @@ interface BoltdocsPluginOptions {
  * @param config - The resolved Boltdocs configuration containing custom plugins and components
  * @returns A string of JavaScript code to be evaluated by the browser
  */
-declare function generateEntryCode(options: BoltdocsPluginOptions, config?: BoltdocsConfig): string;
+declare function generateEntryCode(options: BoltdocsPluginOptions, config?: BoltdocsConfig, isBuild?: boolean): string;
 //#endregion
 //#region src/node/routes/types.d.ts
 /**
@@ -259,6 +294,24 @@ interface RouteMeta {
   _rawContent?: string;
   /** Extracted SEO and Open Graph metadata from frontmatter */
   seo?: Record<string, any>;
+  /** The publication date */
+  date?: string | Date;
+  /** The last updated timestamp or date */
+  lastUpdated?: string | number | Date;
+  /** Optional category for the page */
+  category?: string;
+  /** Optional explicit order (alternative to sidebarPosition) */
+  order?: number;
+  /** Optional explicit label for the sidebar */
+  sidebarLabel?: string;
+  /** Whether the page is hidden from the sidebar */
+  sidebarHidden?: boolean;
+  /** Raw extensible frontmatter data for custom components and formatters */
+  frontmatter?: Record<string, any>;
+  /** Optional recursive child routes for deep sidebar hierarchies */
+  subRoutes?: RouteMeta[];
+  /** Clean URL segments stripped of locale/version prefixes */
+  slugParts?: string[];
 }
 //#endregion
 //#region src/node/utils.d.ts
@@ -283,7 +336,7 @@ declare function sanitizeFilename(name: string): string;
 /**
  * Permissions that a plugin can request to access specific Boltdocs capabilities.
  */
-type PluginPermission = 'fs:read' | 'fs:write' | 'vite:config' | 'mdx:remark' | 'mdx:rehype' | 'components' | 'hooks:build' | 'hooks:dev';
+type PluginPermission = 'fs:read' | 'fs:write' | 'vite:config' | 'mdx:remark' | 'mdx:rehype' | 'components' | 'hooks:build' | 'hooks:dev' | 'analytics:track' | 'analytics:config';
 /**
  * Shared context injected into every plugin lifecycle hook.
  */

package/dist/node/index.d.mts

@@ -2,7 +2,6 @@
 import * as _$vite from "vite";
 import { InlineConfig, Plugin } from "vite";
 import { z } from "zod";
-
 //#region src/shared/types.d.ts
 /**
  * Represents a single social link in the configuration.
@@ -33,24 +32,26 @@ interface BoltdocsThemeConfig {
   navbar?: Array<{
     label: string | Record<string, string>;
     href: string;
+    items?: Array<{
+      label: string | Record<string, string>;
+      href: string;
+    }>;
   }>;
   sidebar?: Record<string, Array<{
     text: string;
     link: string;
   }>>;
   sidebarGroups?: Record<string, {
-    title?: string;
+    title?: string | Record<string, string>;
     icon?: string;
   }>;
   socialLinks?: BoltdocsSocialLink[];
   footer?: BoltdocsFooterConfig;
-  breadcrumbs?: boolean;
   editLink?: string;
   communityHelp?: string;
   version?: string;
   githubRepo?: string;
   favicon?: string;
-  poweredBy?: boolean;
   tabs?: Array<{
     id: string;
     text: string | Record<string, string>;
@@ -60,10 +61,6 @@ interface BoltdocsThemeConfig {
     light: ShikiTheme;
     dark: ShikiTheme;
   };
-  copyMarkdown?: boolean | {
-    text?: string;
-    icon?: string;
-  };
 }
 /**
  * List of supported syntax highlighting themes.
@@ -94,7 +91,7 @@ interface BoltdocsLocaleConfig {
  */
 interface BoltdocsI18nConfig {
   defaultLocale: string;
-  locales: Record<string, string>;
+  locales: string[] | Record<string, string>;
   localeConfigs?: Record<string, BoltdocsLocaleConfig>;
 }
 /**
@@ -145,6 +142,34 @@ interface BoltdocsSeoConfig {
     background?: string;
   };
 }
+/**
+ * Configuration for Google Analytics 4 (GA4).
+ */
+interface BoltdocsGA4Config {
+  measurementId: string;
+  debug?: boolean;
+  anonymizeIp?: boolean;
+  sendPageView?: boolean;
+  cookieFlags?: string;
+  autoTrack?: {
+    pageViews?: boolean;
+    downloads?: boolean;
+    externalLinks?: boolean;
+    search?: boolean;
+  };
+}
+/**
+ * Configuration for Google Tag Manager (GTM).
+ */
+interface BoltdocsGTMConfig {
+  tagId: string;
+  dataLayerName?: string;
+  preview?: string;
+}
+interface BoltdocsIntegrationsConfig {
+  ga4?: BoltdocsGA4Config;
+  gtm?: BoltdocsGTMConfig;
+}
 /**
  * The root configuration object for Boltdocs.
  */
@@ -152,7 +177,6 @@ interface BoltdocsConfig {
   siteUrl?: string;
   docsDir?: string;
   base?: string;
-  homePage?: string;
   theme?: BoltdocsThemeConfig;
   i18n?: BoltdocsI18nConfig;
   versions?: BoltdocsVersionsConfig;
@@ -160,8 +184,20 @@ interface BoltdocsConfig {
   robots?: BoltdocsRobotsConfig;
   security?: BoltdocsSecurityConfig;
   seo?: BoltdocsSeoConfig;
+  integrations?: BoltdocsIntegrationsConfig;
+  /** Aggregated metadata from local meta.json files */
+  directoryMeta?: Record<string, any>;
   vite?: any;
 }
+/**
+ * Global namespace for Boltdocs types that can be augmented by generated code.
+ * This allows for strictly typed locales and versions based on the project configuration.
+ */
+declare global {
+  namespace Boltdocs {
+    interface Types {}
+  }
+}
 //#endregion
 //#region src/shared/config-utils.d.ts
 /**
@@ -191,8 +227,6 @@ declare function resolveConfig(docsDir: string, root?: string): Promise<Boltdocs
 interface BoltdocsPluginOptions {
   /** The root directory containing markdown files (default: 'docs') */
   docsDir?: string;
-  /** Path to a custom home page component (relative to project root) to render at '/' */
-  homePage?: string;
 }
 //#endregion
 //#region src/node/plugin/entry.d.ts
@@ -204,7 +238,7 @@ interface BoltdocsPluginOptions {
  * @param config - The resolved Boltdocs configuration containing custom plugins and components
  * @returns A string of JavaScript code to be evaluated by the browser
  */
-declare function generateEntryCode(options: BoltdocsPluginOptions, config?: BoltdocsConfig): string;
+declare function generateEntryCode(options: BoltdocsPluginOptions, config?: BoltdocsConfig, isBuild?: boolean): string;
 //#endregion
 //#region src/node/routes/types.d.ts
 /**
@@ -259,6 +293,24 @@ interface RouteMeta {
   _rawContent?: string;
   /** Extracted SEO and Open Graph metadata from frontmatter */
   seo?: Record<string, any>;
+  /** The publication date */
+  date?: string | Date;
+  /** The last updated timestamp or date */
+  lastUpdated?: string | number | Date;
+  /** Optional category for the page */
+  category?: string;
+  /** Optional explicit order (alternative to sidebarPosition) */
+  order?: number;
+  /** Optional explicit label for the sidebar */
+  sidebarLabel?: string;
+  /** Whether the page is hidden from the sidebar */
+  sidebarHidden?: boolean;
+  /** Raw extensible frontmatter data for custom components and formatters */
+  frontmatter?: Record<string, any>;
+  /** Optional recursive child routes for deep sidebar hierarchies */
+  subRoutes?: RouteMeta[];
+  /** Clean URL segments stripped of locale/version prefixes */
+  slugParts?: string[];
 }
 //#endregion
 //#region src/node/utils.d.ts
@@ -283,7 +335,7 @@ declare function sanitizeFilename(name: string): string;
 /**
  * Permissions that a plugin can request to access specific Boltdocs capabilities.
  */
-type PluginPermission = 'fs:read' | 'fs:write' | 'vite:config' | 'mdx:remark' | 'mdx:rehype' | 'components' | 'hooks:build' | 'hooks:dev';
+type PluginPermission = 'fs:read' | 'fs:write' | 'vite:config' | 'mdx:remark' | 'mdx:rehype' | 'components' | 'hooks:build' | 'hooks:dev' | 'analytics:track' | 'analytics:config';
 /**
  * Shared context injected into every plugin lifecycle hook.
  */

package/dist/node/index.mjs

@@ -3,4 +3,4 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-import{_ as e,a as t,b as n,c as r,d as i,f as a,g as o,h as s,i as c,l,m as u,n as d,o as f,p,r as m,s as h,t as g,u as _,v}from"../node-CWN8U_p8.mjs";export{l as BoltdocsPluginStore,_ as PluginCompatibilityError,i as PluginError,a as PluginHookError,c as PluginLifecycleManager,p as PluginPermissionError,t as PluginSandbox,u as PluginValidationError,f as SecurePluginSchema,m as createPlugin,d as createViteConfig,g as default,e as defineConfig,s as generateEntryCode,h as hasPermission,v as normalizePath,o as resolveConfig,n as sanitizeFilename,r as validatePlugins};
+import{c as e,o as t}from"../doctor-Dh1XP7Pz.mjs";import{d as n,l as r}from"../utils-BxNAXhZZ.mjs";import{a as i,c as a,d as o,f as s,h as c,i as l,l as u,m as d,n as f,o as p,p as m,r as h,s as g,t as _,u as v}from"../node-C2nWXElP.mjs";export{v as BoltdocsPluginStore,o as PluginCompatibilityError,s as PluginError,m as PluginHookError,i as PluginLifecycleManager,d as PluginPermissionError,p as PluginSandbox,c as PluginValidationError,g as SecurePluginSchema,l as createPlugin,f as createViteConfig,_ as default,e as defineConfig,h as generateEntryCode,a as hasPermission,r as normalizePath,t as resolveConfig,n as sanitizeFilename,u as validatePlugins};

package/dist/node/routes/worker.cjs

@@ -0,0 +1,6 @@
+/**
+ * Boltdocs - https://boltdocs.vercel.app
+ * Copyright (c) 2026 Jesus Alcala
+ * Licensed under the MIT License.
+ */
+require(`../../chunk-Ds5LZdWN.cjs`);const e=require(`../../parser-DYRzXWmA.cjs`);let t=require(`node:worker_threads`);if(!t.parentPort)throw Error(`This file must be run as a worker thread.`);t.parentPort.on(`message`,async n=>{if(n.type===`PARSE_FILE`)try{let r=await e.t(n.file,n.docsDir,n.basePath,n.config);t.parentPort?.postMessage({type:`SUCCESS`,file:n.file,result:r})}catch(e){t.parentPort?.postMessage({type:`ERROR`,file:n.file,error:e.message||`Unknown parsing error`})}});

package/dist/node/routes/worker.d.cts

@@ -0,0 +1,2 @@
+
+export { };

package/dist/node/routes/worker.d.mts

@@ -0,0 +1,2 @@
+
+export { };

package/dist/node/routes/worker.mjs

@@ -0,0 +1,6 @@
+/**
+ * Boltdocs - https://boltdocs.vercel.app
+ * Copyright (c) 2026 Jesus Alcala
+ * Licensed under the MIT License.
+ */
+import{n as e}from"../../parser-D8eQvE7N.mjs";import{parentPort as t}from"node:worker_threads";if(!t)throw Error(`This file must be run as a worker thread.`);t.on(`message`,async n=>{if(n.type===`PARSE_FILE`)try{let r=await e(n.file,n.docsDir,n.basePath,n.config);t?.postMessage({type:`SUCCESS`,file:n.file,result:r})}catch(e){t?.postMessage({type:`ERROR`,file:n.file,error:e.message||`Unknown parsing error`})}});export{};