boltdocs 2.5.4 → 2.5.6

package/dist/client/theme/neutral.css

@@ -0,0 +1,388 @@
+@theme {
+  --font-display: "Inter", "ui-sans-serif", "system-ui", sans-serif;
+  --font-sans: "Inter", "ui-sans-serif", "system-ui", sans-serif;
+  --font-mono:
+    "JetBrains Mono", "ui-monospace", "SFMono-Regular", Menlo, Monaco, Consolas,
+    "liberation mono", "courier new", monospace;
+
+  --breakpoint-3xl: 120rem;
+
+  --color-primary-50: oklch(0.985 0.012 265.8);
+  --color-primary-100: oklch(0.92 0.045 265.8);
+  --color-primary-200: oklch(0.84 0.085 265.8);
+  --color-primary-300: oklch(0.74 0.125 265.8);
+  --color-primary-400: oklch(0.64 0.165 265.8);
+  --color-primary-500: oklch(0.54 0.195 265.8);
+  --color-primary-600: oklch(0.45 0.165 265.8);
+  --color-primary-700: oklch(0.36 0.135 265.8);
+  --color-primary-800: oklch(0.27 0.095 265.8);
+  --color-primary-900: oklch(0.15 0.045 265.8);
+
+  /* Neutral Gray Palette */
+  --color-neutral-50: oklch(0.98 0 0);
+  --color-neutral-100: oklch(0.96 0 0);
+  --color-neutral-200: oklch(0.92 0 0);
+  --color-neutral-300: oklch(0.84 0 0);
+  --color-neutral-400: oklch(0.7 0 0);
+  --color-neutral-500: oklch(0.55 0 0);
+  --color-neutral-600: oklch(0.4 0 0);
+  --color-neutral-700: oklch(0.25 0 0);
+  --color-neutral-800: oklch(0.15 0 0);
+  --color-neutral-900: oklch(0.1 0 0);
+  --color-neutral-950: oklch(0.05 0 0);
+
+  /* Semantic Status Colors */
+  --color-danger-500: oklch(0.63 0.24 27);
+  --color-success-500: oklch(0.72 0.19 150);
+  --color-warning-500: oklch(0.78 0.17 75);
+  --color-info-500: oklch(0.62 0.19 260);
+
+  /* Shared Properties */
+  --radius-sm: 0.375rem;
+  --radius-md: 0.5rem;
+  --radius-lg: 0.75rem;
+  --radius-xl: 1rem;
+  --radius-2xl: 1.5rem;
+  --radius-full: 99999rem;
+
+  --ease-fluid: cubic-bezier(0.3, 0, 0, 1);
+  --ease-snappy: cubic-bezier(0.2, 0, 0, 1);
+
+  /* Semantic Colors - Default (Light) */
+  --color-bg-main: var(--color-neutral-50);
+  --color-bg-surface: var(--color-neutral-100);
+  --color-bg-muted: var(--color-neutral-200);
+  --color-text-main: var(--color-neutral-900);
+  --color-text-muted: var(--color-neutral-500);
+  --color-text-dim: var(--color-neutral-400);
+  --color-border-subtle: var(--color-neutral-200);
+  --color-border-strong: var(--color-neutral-300);
+  --color-code-bg: var(--color-neutral-100);
+  --color-code-text: var(--color-neutral-800);
+
+  /* Semantic Colors - Dark Override (handled via standard CSS overrides below the @theme block) */
+
+  /* Spacing and Dimensions */
+  --spacing-navbar: 3.5rem;
+  --spacing-sidebar: 16rem;
+  --spacing-toc: 14rem;
+  --spacing-content-max: 54rem;
+
+  @keyframes pulse {
+    0%,
+    100% {
+      opacity: 1;
+    }
+    50% {
+      opacity: 0.5;
+    }
+  }
+
+  @keyframes fade-in {
+    from {
+      opacity: 0;
+      transform: translateY(10px);
+    }
+    to {
+      opacity: 1;
+      transform: translateY(0);
+    }
+  }
+}
+
+.animate-pulse {
+  animation: pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite;
+}
+
+.animate-fade-in {
+  animation: fade-in 0.5s ease-out forwards;
+}
+
+:root[data-theme="dark"],
+:root:not(.theme-light) {
+  --color-bg-main: var(--color-neutral-950);
+  --color-bg-surface: var(--color-neutral-900);
+  --color-bg-muted: var(--color-neutral-800);
+  --color-text-main: var(--color-neutral-50);
+  --color-text-muted: var(--color-neutral-400);
+  --color-text-dim: var(--color-neutral-500);
+  --color-border-subtle: var(--color-neutral-800);
+  --color-border-strong: var(--color-neutral-700);
+  --color-code-bg: var(--color-neutral-900);
+  --color-code-text: var(--color-neutral-200);
+}
+
+@layer base {
+  *,
+  *::before,
+  *::after {
+    box-sizing: border-box;
+  }
+
+  html,
+  body {
+    margin: 0;
+    padding: 0;
+    min-height: 100%;
+    overflow-x: hidden;
+  }
+
+  body {
+    @apply bg-bg-main text-text-main antialiased;
+    font-family: var(--font-sans);
+    line-height: 1.7;
+  }
+
+  a {
+    text-decoration: none;
+  }
+
+  /* Scroll-margin-top for anchor scrolling */
+  h1,
+  h2,
+  h3,
+  h4,
+  h5,
+  h6 {
+    scroll-margin-top: 6rem;
+  }
+
+  /* Scrollbar */
+  ::-webkit-scrollbar {
+    width: 6px;
+    height: 6px;
+  }
+  ::-webkit-scrollbar-track {
+    background: transparent;
+  }
+  ::-webkit-scrollbar-thumb {
+    @apply bg-neutral-300 dark:bg-neutral-700 rounded-full;
+  }
+  ::-webkit-scrollbar-thumb:hover {
+    @apply bg-neutral-400 dark:bg-neutral-600;
+  }
+
+  /* ═══ Content Area ═══ */
+  .boltdocs-content {
+    scrollbar-width: none;
+    scroll-behavior: smooth;
+  }
+  .boltdocs-content::-webkit-scrollbar {
+    display: none;
+  }
+
+  /* ═══ Markdown Typography ═══ */
+  .boltdocs-page {
+    position: relative;
+    padding-top: 1rem;
+    padding-bottom: 8rem;
+  }
+
+  .boltdocs-page h1 {
+    font-size: 2.5rem;
+    margin: 0 0 1rem;
+    font-weight: 800;
+    letter-spacing: -0.04em;
+    color: var(--color-text-main);
+    line-height: 1.2;
+  }
+  .boltdocs-page h1 + p {
+    color: var(--color-text-muted);
+    font-size: 1.125rem;
+    margin-bottom: 2.5rem;
+    line-height: 1.6;
+  }
+  .boltdocs-page h2 {
+    font-size: 1.75rem;
+    margin-top: 3.5rem;
+    margin-bottom: 1.25rem;
+    font-weight: 700;
+    color: var(--color-text-main);
+    padding-bottom: 0.5rem;
+    border-bottom: 1px solid var(--color-border-subtle);
+    scroll-margin-top: 6rem;
+    letter-spacing: -0.02em;
+  }
+  .boltdocs-page h3 {
+    font-size: 1.25rem;
+    margin-top: 2.5rem;
+    margin-bottom: 1rem;
+    font-weight: 600;
+    color: var(--color-text-main);
+    scroll-margin-top: 6rem;
+    letter-spacing: -0.01em;
+  }
+  .boltdocs-page p {
+    margin-top: 0;
+    margin-bottom: 1.25rem;
+    color: var(--color-text-muted);
+    line-height: 1.8;
+  }
+  .boltdocs-page a {
+    color: var(--color-primary-500);
+    text-decoration: none;
+    transition: color 0.2s;
+    font-weight: 500;
+  }
+  .boltdocs-page a:hover {
+    color: var(--color-primary-400);
+    text-decoration: underline;
+  }
+  .boltdocs-page ul,
+  .boltdocs-page ol {
+    margin-top: 0;
+    margin-bottom: 1.5rem;
+    padding-left: 1.5rem;
+    color: var(--color-text-muted);
+  }
+  .boltdocs-page li {
+    margin-bottom: 0.5rem;
+    line-height: 1.8;
+  }
+  .boltdocs-page strong {
+    color: var(--color-text-main);
+    font-weight: 700;
+  }
+  .boltdocs-page blockquote {
+    margin: 2rem 0;
+    padding: 1rem 1.5rem;
+    border-left: 4px solid var(--color-primary-500);
+    background-color: var(--color-primary-500);
+    background-color: color-mix(
+      in oklch,
+      var(--color-primary-500),
+      transparent 93%
+    );
+    border-radius: 0 var(--radius-lg) var(--radius-lg) 0;
+    color: var(--color-text-muted);
+    font-style: italic;
+  }
+  .boltdocs-page blockquote p {
+    margin: 0;
+  }
+  .boltdocs-page hr {
+    border: none;
+    border-top: 1px solid var(--color-border-subtle);
+    margin: 3rem 0;
+  }
+  .boltdocs-page img {
+    max-width: 100%;
+    height: auto;
+    border-radius: var(--radius-lg);
+    margin: 2rem 0;
+    display: block;
+    box-shadow: 0 10px 30px -10px rgba(0, 0, 0, 0.1);
+  }
+  .boltdocs-page table {
+    width: 100%;
+    border-collapse: collapse;
+    margin: 2rem 0;
+    font-size: 0.875rem;
+  }
+  .boltdocs-page th {
+    text-align: left;
+    padding: 0.75rem 1rem;
+    border-bottom: 2px solid var(--color-border-subtle);
+    color: var(--color-text-main);
+    font-weight: 700;
+  }
+  .boltdocs-page td {
+    padding: 0.75rem 1rem;
+    border-bottom: 1px solid var(--color-border-subtle);
+    color: var(--color-text-muted);
+  }
+  .boltdocs-page tr:hover td {
+    background-color: var(--color-bg-surface);
+  }
+  .boltdocs-page :not(pre) > code {
+    background-color: var(--color-bg-surface);
+    padding: 0.15rem 0.45rem;
+    border-radius: 5px;
+    font-family: var(--font-mono);
+    font-size: 0.85em;
+    color: var(--color-primary-400);
+    border: 1px solid var(--color-border-subtle);
+  }
+  .boltdocs-page pre {
+    margin: 1.5rem 0;
+    border-radius: var(--radius-md);
+    overflow-x: auto;
+    font-family: var(--font-mono);
+    font-size: 0.8125rem;
+    line-height: 1.7;
+    background-color: var(--color-code-bg);
+    color: var(--color-code-text);
+    border: 1px solid var(--color-border-subtle);
+  }
+  .boltdocs-page pre > code {
+    display: grid;
+    padding: 1rem;
+    background-color: transparent;
+    border: none;
+    color: inherit;
+    font-size: inherit;
+  }
+  .boltdocs-page pre > code .line {
+    padding: 0 1.25rem;
+  }
+  .boltdocs-page pre > code .line.highlighted {
+    background-color: oklch(0.6 0.22 280 / 10%);
+    border-left: 2px solid var(--color-primary-500);
+  }
+
+  @media (max-width: 768px) {
+    .boltdocs-page h1 {
+      font-size: 1.75rem;
+    }
+  }
+
+  /* ═══ Header Anchors ═══ */
+  .header-anchor {
+    margin-left: 0.5rem;
+    color: var(--color-text-dim);
+    opacity: 0;
+    transition: opacity 0.2s;
+    text-decoration: none;
+    font-weight: 400;
+  }
+  .boltdocs-page h2:hover .header-anchor,
+  .boltdocs-page h3:hover .header-anchor {
+    opacity: 1;
+  }
+  .header-anchor:hover {
+    color: var(--color-primary-500);
+  }
+  .boltdocs-heading {
+    display: flex;
+    align-items: center;
+  }
+  .boltdocs-heading .header-anchor {
+    display: inline-flex;
+    align-items: center;
+    margin-left: 0.5rem;
+    color: var(--color-text-dim);
+    opacity: 0;
+    transition: opacity 0.2s;
+    text-decoration: none;
+  }
+  .boltdocs-heading:hover .header-anchor {
+    opacity: 1;
+  }
+
+  /* ═══ Shiki Dual Theme ═══ */
+  .shiki-wrapper .shiki.shiki-themes {
+    background-color: transparent !important;
+    color: var(--shiki-light) !important;
+  }
+  .shiki-wrapper .shiki.shiki-themes span {
+    color: var(--shiki-light);
+  }
+  :root[data-theme="dark"] .shiki-wrapper .shiki.shiki-themes,
+  :root:not(.theme-light) .shiki-wrapper .shiki.shiki-themes {
+    color: var(--shiki-dark) !important;
+  }
+  :root[data-theme="dark"] .shiki-wrapper .shiki.shiki-themes span,
+  :root:not(.theme-light) .shiki-wrapper .shiki.shiki-themes span {
+    color: var(--shiki-dark) !important;
+  }
+}

package/dist/node/cli-entry.cjs

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Boltdocs - https://boltdocs.vercel.app
+ * Copyright (c) 2026 Jesus Alcala
+ * Licensed under the MIT License.
+ */
+const e=require(`../cache-Cr8W2zgZ.cjs`),t=require(`../node-VYfhzGrh.cjs`);let n=require(`vite`),r=require(`fast-glob`);r=e.S(r);let i=require(`fs`);i=e.S(i);let a=require(`path`);a=e.S(a);let o=require(`cac`);o=e.S(o);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(e=process.cwd()){try{let r=await(0,n.createServer)(await t.n(e,`development`));await r.listen(),r.printUrls(),r.bindCLIShortcuts({print:!0})}catch(e){d(`Failed to start dev server:`,e),process.exit(1)}}async function m(e=process.cwd()){let r=!1,o=a.default.resolve(e,`index.html`);try{if(!i.default.existsSync(o)){let n=await t.v(`docs`,e);i.default.writeFileSync(o,t.h(n),`utf-8`),r=!0}await(0,n.build)(await t.n(e,`production`)),f(`Build completed successfully.`)}catch(e){d(`Build failed:`,e),process.exit(1)}finally{r&&i.default.existsSync(o)&&i.default.unlinkSync(o)}}async function h(e=process.cwd()){try{(await(0,n.preview)(await t.n(e,`production`))).printUrls()}catch(e){d(`Failed to start preview server:`,e),process.exit(1)}}async function g(n=process.cwd()){let{colors:o}=s;u(`${o.bold}Running documentation health check...${o.reset}\n`);let c=performance.now();try{let s=await t.v(`docs`,n),l=a.default.resolve(n,`docs`);i.default.existsSync(l)||(d(`Documentation directory not found at ${l}`),process.exit(1));let p=await(0,r.default)([`**/*.md`,`**/*.mdx`],{cwd:l,absolute:!0,suppressErrors:!0}),m=0,h=0,g=0,_=new Map,v=(e,t)=>{let n=a.default.relative(l,e),r=_.get(n);r||(r=[],_.set(n,r)),r.push(t),t.level===`high`?m++:t.level===`warning`?h++:t.level===`low`&&g++},y=`/docs`;for(let t of p){let{data:n,content:r}=e.p(t);n.title||v(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||v(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,c=[...r.matchAll(o),...r.matchAll(s)];for(let e of c){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 r;if(n.startsWith(`/`)){let e=n;(n.startsWith(y+`/`)||n===y)&&(e=n.substring(5)),r=a.default.join(l,e)}else r=a.default.resolve(a.default.dirname(t),n);let o=[``,`.md`,`.mdx`,`/index.md`,`/index.mdx`],s=!1;for(let e of o){let t=r+e;if(i.default.existsSync(t)&&i.default.statSync(t).isFile()){s=!0;break}}s||v(t,{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(s.i18n){let{defaultLocale:t,locales:n}=s.i18n,r=Object.keys(n).filter(e=>e!==t);for(let n of p){let o=e.f(a.default.relative(l,n)).split(`/`);if(o[0]===t){let e=o.slice(1).join(`/`);for(let t of r){let r=[t,...o.slice(1)],s=a.default.join(l,...r);i.default.existsSync(s)||v(n,{level:`warning`,message:`Missing translation for locale "${t}"`,suggestion:`Create a translated version of this file at "${t}/${e}".`})}}}}if(_.size===0)f(`All documentation files are healthy!
+`);else{for(let[e,t]of _.entries()){console.log(`📄 ${o.bold}${e}${o.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=o.red):e.level===`warning`?(t=`⚠️`,n=o.yellow):(t=`ℹ️`,n=o.cyan),console.log(`   ${n}${t} ${e.level.toUpperCase()}:${o.reset} ${e.message}`),e.suggestion&&console.log(`      ${o.gray}💡 Suggestion: ${e.suggestion}${o.reset}`)}console.log(``)}console.log(`${o.bold}Summary:${o.reset}`),console.log(`   ${o.red}${m} high-level errors${o.reset}`),console.log(`   ${o.yellow}${h} warnings${o.reset}`),console.log(`   ${o.cyan}${g} minor improvements${o.reset}\n`),m>0&&d(`HIGH ERROR: Fix these to ensure your documentation builds correctly.`),(h>0||g>0)&&u(`TIP: Address warnings and suggestions for premium quality docs.`),console.log(``)}u(`Finished in ${(performance.now()-c).toFixed(2)}ms\n`),m>0&&process.exit(1)}catch(e){d(`Failed to run doctor check:`,e),process.exit(1)}}const _=(0,o.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();

package/dist/node/cli-entry.d.cts

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

package/dist/node/cli-entry.d.mts

@@ -1 +1,2 @@
-#!/usr/bin/env node
+
+export { };

package/dist/node/cli-entry.mjs

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
-import{b as L,c as ie,e as V,f as re,t as w,u as Y}from"../chunk-IMEKU5U3.mjs";import{a as n,h as D,l as G,u as se}from"../chunk-TP5KMRD3.mjs";import{a as v,b as te,c as oe}from"../chunk-Y4RE5KI7.mjs";var S={};oe(S,{colors:()=>x,error:()=>a,formatLog:()=>W,info:()=>b,success:()=>A});function W(s,e=""){return`${e}${x.bold}[boltdocs]${x.reset} ${s}${x.reset}`}function b(s){console.log(W(s))}function a(s,e){console.error(W(s,x.red)),e&&console.error(e)}function A(s){console.log(W(s,x.green))}var x,C=v(()=>{"use strict";n();x={reset:"\x1B[0m",bold:"\x1B[1m",red:"\x1B[31m",green:"\x1B[32m",yellow:"\x1B[33m",blue:"\x1B[34m",cyan:"\x1B[36m",gray:"\x1B[90m"}});import{createServer as ne}from"vite";async function q(s=process.cwd()){try{let e=await w(s,"development"),l=await ne(e);await l.listen(),l.printUrls(),l.bindCLIShortcuts({print:!0})}catch(e){a("Failed to start dev server:",e),process.exit(1)}}var J=v(()=>{"use strict";n();Y();C()});import{build as le,preview as ce}from"vite";import ae from"path";import M from"fs";async function K(s=process.cwd()){let e=!1,l=ae.resolve(s,"index.html");try{if(!M.existsSync(l)){let f=await L("docs",s);M.writeFileSync(l,V(f),"utf-8"),e=!0}let g=await w(s,"production");await le(g),A("Build completed successfully.")}catch(g){a("Build failed:",g),process.exit(1)}finally{e&&M.existsSync(l)&&M.unlinkSync(l)}}async function N(s=process.cwd()){try{let e=await w(s,"production");(await ce(e)).printUrls()}catch(e){a("Failed to start preview server:",e),process.exit(1)}}var Q=v(()=>{"use strict";n();Y();re();C()});import u from"path";import R from"fs";import fe from"fast-glob";async function X(s=process.cwd()){let{colors:e}=S;b(`${e.bold}Running documentation health check...${e.reset}
-`);let l=performance.now();try{let g=await L("docs",s),f=u.resolve(s,"docs");R.existsSync(f)||(a(`Documentation directory not found at ${f}`),process.exit(1));let T=await fe(["**/*.md","**/*.mdx"],{cwd:f,absolute:!0,suppressErrors:!0}),k=0,B=0,j=0,P=new Map,F=(r,c)=>{let m=u.relative(f,r),t=P.get(m);t||(t=[],P.set(m,t)),t.push(c),c.level==="high"?k++:c.level==="warning"?B++:c.level==="low"&&j++},E="/docs";for(let r of T){let{data:c,content:m}=G(r);c.title||F(r,{level:"warning",message:'Missing "title" in frontmatter.',suggestion:"Add `title: Your Title` to the YAML frontmatter at the top of the file."}),c.description||F(r,{level:"low",message:'Missing "description" in frontmatter.',suggestion:"Adding a description helps with SEO and search previews."});let t=/\[.*?\]\((.*?)\)/g,d=/<a\s+[^>]*href=["']([^"']+)["'][^>]*>/g,i=[...m.matchAll(t),...m.matchAll(d)];for(let H of i){let o=H[1];if(!o||o.startsWith("http")||o.startsWith("https")||o.startsWith("#")||o.startsWith("mailto:")||o.startsWith("tel:")||(o=o.split("#")[0],!o))continue;let h;if(o.startsWith("/")){let I=o;(o.startsWith(E+"/")||o===E)&&(I=o.substring(E.length)),h=u.join(f,I)}else h=u.resolve(u.dirname(r),o);let O=["",".md",".mdx","/index.md","/index.mdx"],U=!1;for(let I of O){let z=h+I;if(R.existsSync(z)&&R.statSync(z).isFile()){U=!0;break}}U||F(r,{level:"high",message:`Broken internal link: "${o}"`,suggestion:`Ensure the file exists at "${h}". If it's a directory, ensure it has an "index.md" or "index.mdx".`})}}if(g.i18n){let{defaultLocale:r,locales:c}=g.i18n,m=Object.keys(c).filter(t=>t!==r);for(let t of T){let i=D(u.relative(f,t)).split("/");if(i[0]===r){let H=i.slice(1).join("/");for(let o of m){let h=[o,...i.slice(1)],O=u.join(f,...h);R.existsSync(O)||F(t,{level:"warning",message:`Missing translation for locale "${o}"`,suggestion:`Create a translated version of this file at "${o}/${H}".`})}}}}if(P.size===0)A(`All documentation files are healthy!
-`);else{for(let[r,c]of P.entries()){console.log(`\u{1F4C4} ${e.bold}${r}${e.reset}`);let m=c.sort((t,d)=>{let i={high:1,warning:2,low:3};return i[t.level]-i[d.level]});for(let t of m){let d="",i="";t.level==="high"?(d="\u274C",i=e.red):t.level==="warning"?(d="\u26A0\uFE0F",i=e.yellow):(d="\u2139\uFE0F",i=e.cyan),console.log(`   ${i}${d} ${t.level.toUpperCase()}:${e.reset} ${t.message}`),t.suggestion&&console.log(`      ${e.gray}\u{1F4A1} Suggestion: ${t.suggestion}${e.reset}`)}console.log("")}console.log(`${e.bold}Summary:${e.reset}`),console.log(`   ${e.red}${k} high-level errors${e.reset}`),console.log(`   ${e.yellow}${B} warnings${e.reset}`),console.log(`   ${e.cyan}${j} minor improvements${e.reset}
-`),k>0&&a("HIGH ERROR: Fix these to ensure your documentation builds correctly."),(B>0||j>0)&&b("TIP: Address warnings and suggestions for premium quality docs."),console.log("")}let ee=performance.now()-l;b(`Finished in ${ee.toFixed(2)}ms
-`),k>0&&process.exit(1)}catch(g){a("Failed to run doctor check:",g),process.exit(1)}}var Z=v(()=>{"use strict";n();ie();se();C()});var _=v(()=>{"use strict";n();J();Q();Z();C()});import me from"cac";var de=te(()=>{n();_();var p=me("boltdocs");p.command("[root]","Start development server").alias("dev").action(q);p.command("build [root]","Build for production").action(K);p.command("preview [root]","Preview production build").action(N);p.command("doctor [root]","Check documentation health").action(X);p.help();p.version("2.0.0");p.parse()});export default de();
+/**
+ * Boltdocs - https://boltdocs.vercel.app
+ * Copyright (c) 2026 Jesus Alcala
+ * Licensed under the MIT License.
+ */
+import{D as e,E as t,T as n,d as r,h as i,m as a}from"../cache-DFdakSmR.mjs";import{_ as o,b as s,g as c,n as l,r as u,x as d}from"../node-CWXme96p.mjs";import{build as f,createServer as p,preview as m}from"vite";import h from"fast-glob";import g from"fs";import _ from"path";import v from"cac";var y=e({colors:()=>w,error:()=>S,formatLog:()=>b,info:()=>x,success:()=>C});function b(e,t=``){return`${t}${w.bold}[boltdocs]${w.reset} ${e}${w.reset}`}function x(e){console.log(b(e))}function S(e,t){console.error(b(e,w.red)),t&&console.error(t)}function C(e){console.log(b(e,w.green))}var w,T=t((()=>{w={reset:`\x1B[0m`,bold:`\x1B[1m`,red:`\x1B[31m`,green:`\x1B[32m`,yellow:`\x1B[33m`,blue:`\x1B[34m`,cyan:`\x1B[36m`,gray:`\x1B[90m`}}));async function E(e=process.cwd()){try{let t=await p(await l(e,`development`));await t.listen(),t.printUrls(),t.bindCLIShortcuts({print:!0})}catch(e){S(`Failed to start dev server:`,e),process.exit(1)}}var D=t((()=>{u(),T()}));async function O(e=process.cwd()){let t=!1,n=_.resolve(e,`index.html`);try{if(!g.existsSync(n)){let r=await d(`docs`,e);g.writeFileSync(n,c(r),`utf-8`),t=!0}await f(await l(e,`production`)),C(`Build completed successfully.`)}catch(e){S(`Build failed:`,e),process.exit(1)}finally{t&&g.existsSync(n)&&g.unlinkSync(n)}}async function k(e=process.cwd()){try{(await m(await l(e,`production`))).printUrls()}catch(e){S(`Failed to start preview server:`,e),process.exit(1)}}var A=t((()=>{u(),o(),T()}));async function j(e=process.cwd()){let{colors:t}=y;x(`${t.bold}Running documentation health check...${t.reset}\n`);let n=performance.now();try{let r=await d(`docs`,e),o=_.resolve(e,`docs`);g.existsSync(o)||(S(`Documentation directory not found at ${o}`),process.exit(1));let s=await h([`**/*.md`,`**/*.mdx`],{cwd:o,absolute:!0,suppressErrors:!0}),c=0,l=0,u=0,f=new Map,p=(e,t)=>{let n=_.relative(o,e),r=f.get(n);r||(r=[],f.set(n,r)),r.push(t),t.level===`high`?c++:t.level===`warning`?l++:t.level===`low`&&u++},m=`/docs`;for(let e of s){let{data:t,content:n}=i(e);t.title||p(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||p(e,{level:`low`,message:`Missing "description" in frontmatter.`,suggestion:`Adding a description helps with SEO and search previews.`});let r=/\[.*?\]\((.*?)\)/g,a=/<a\s+[^>]*href=["']([^"']+)["'][^>]*>/g,s=[...n.matchAll(r),...n.matchAll(a)];for(let t of s){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(m+`/`)||n===m)&&(e=n.substring(5)),r=_.join(o,e)}else r=_.resolve(_.dirname(e),n);let i=[``,`.md`,`.mdx`,`/index.md`,`/index.mdx`],a=!1;for(let e of i){let t=r+e;if(g.existsSync(t)&&g.statSync(t).isFile()){a=!0;break}}a||p(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(r.i18n){let{defaultLocale:e,locales:t}=r.i18n,n=Object.keys(t).filter(t=>t!==e);for(let t of s){let r=a(_.relative(o,t)).split(`/`);if(r[0]===e){let e=r.slice(1).join(`/`);for(let i of n){let n=[i,...r.slice(1)],a=_.join(o,...n);g.existsSync(a)||p(t,{level:`warning`,message:`Missing translation for locale "${i}"`,suggestion:`Create a translated version of this file at "${i}/${e}".`})}}}}if(f.size===0)C(`All documentation files are healthy!
+`);else{for(let[e,n]of f.entries()){console.log(`📄 ${t.bold}${e}${t.reset}`);let r=n.sort((e,t)=>{let n={high:1,warning:2,low:3};return n[e.level]-n[t.level]});for(let e of r){let n=``,r=``;e.level===`high`?(n=`❌`,r=t.red):e.level===`warning`?(n=`⚠️`,r=t.yellow):(n=`ℹ️`,r=t.cyan),console.log(`   ${r}${n} ${e.level.toUpperCase()}:${t.reset} ${e.message}`),e.suggestion&&console.log(`      ${t.gray}💡 Suggestion: ${e.suggestion}${t.reset}`)}console.log(``)}console.log(`${t.bold}Summary:${t.reset}`),console.log(`   ${t.red}${c} high-level errors${t.reset}`),console.log(`   ${t.yellow}${l} warnings${t.reset}`),console.log(`   ${t.cyan}${u} minor improvements${t.reset}\n`),c>0&&S(`HIGH ERROR: Fix these to ensure your documentation builds correctly.`),(l>0||u>0)&&x(`TIP: Address warnings and suggestions for premium quality docs.`),console.log(``)}x(`Finished in ${(performance.now()-n).toFixed(2)}ms\n`),c>0&&process.exit(1)}catch(e){S(`Failed to run doctor check:`,e),process.exit(1)}}var M=t((()=>{s(),r(),T()})),N=t((()=>{D(),A(),M(),T()})),P=n((()=>{N();let e=v(`boltdocs`);e.command(`[root]`,`Start development server`).alias(`dev`).action(E),e.command(`build [root]`,`Build for production`).action(O),e.command(`preview [root]`,`Preview production build`).action(k),e.command(`doctor [root]`,`Check documentation health`).action(j),e.help(),e.version(`2.0.0`),e.parse()}));export default P();export{};

package/dist/node/index.cjs

@@ -0,0 +1,6 @@
+/**
+ * Boltdocs - https://boltdocs.vercel.app
+ * Copyright (c) 2026 Jesus Alcala
+ * Licensed under the MIT License.
+ */
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require(`../node-VYfhzGrh.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.generateStaticPages=e.g,exports.hasPermission=e.s,exports.resolveConfig=e.v,exports.validatePlugins=e.c;