botdocs 0.3.0 → 0.4.0

package/dist-client/assets/rag-engine-CU9vjCAg.js

@@ -0,0 +1 @@
+var t=Object.defineProperty,e=(e,n,o)=>((e,n,o)=>n in e?t(e,n,{enumerable:!0,configurable:!0,writable:!0,value:o}):e[n]=o)(e,"symbol"!=typeof n?n+"":n,o);import{g as n}from"./chatbox-P1j6YP1y.js";import"../bundle.js";function o(t,e){if(t.length!==e.length)throw new Error("Vectors must have the same length");let n=0,o=0,r=0;for(let i=0;i<t.length;i++)n+=t[i]*e[i],o+=t[i]*t[i],r+=e[i]*e[i];return o=Math.sqrt(o),r=Math.sqrt(r),0===o||0===r?0:n/(o*r)}class r{constructor(){e(this,"vectorDB",null),e(this,"isLoading",!1)}async loadVectorDB(){if(!this.vectorDB)if(this.isLoading)for(;this.isLoading;)await new Promise(t=>setTimeout(t,100));else{this.isLoading=!0;try{console.log("Loading vector database...");const t=await fetch("/vector-db.json");this.vectorDB=await t.json(),console.log(`Loaded ${this.vectorDB.chunks.length} chunks`)}finally{this.isLoading=!1}}}async search(t,e=5){this.vectorDB||await this.loadVectorDB();const n=this.vectorDB.chunks.map(e=>({chunk:e,score:o(t,e.embedding)}));return n.sort((t,e)=>e.score-t.score),n.slice(0,e)}isReady(){return null!==this.vectorDB}getInfo(){return this.vectorDB?{chunkCount:this.vectorDB.chunks.length,dimension:this.vectorDB.dimension,model:this.vectorDB.model}:null}}let i=null;function s(){return i||(i=new r),i}function a(t){const e=[],n=t.split("\n");let o=[],r=null;const i=()=>{if(0===o.length)return;const t=o.join(" ").trim();if(o=[],t)for(const n of function(t){const e=[],n=t.replace(/`[^`]*`/g,t=>(e.push(t),`\0${e.length-1}\0`));return(n.match(/[^.!?]+[.!?]*(?:\s+|$)/g)||[n]).map(t=>t.replace(/\0(\d+)\0/g,(t,n)=>e[Number(n)])).map(t=>t.trim()).filter(Boolean)}(t))n&&e.push({text:n,kind:"prose"})};let s=0;for(;s<n.length;){const t=n[s];if(t.trim().startsWith("```")){i(),r=null;const o=[t];for(s++;s<n.length&&!n[s].trim().startsWith("```");)o.push(n[s]),s++;s<n.length&&o.push(n[s]),e.push({text:o.join("\n"),kind:"code"}),s++;continue}if(/^#{1,6}\s+/.test(t.trim()))i(),r=null,s++;else{if(/^\s*([-*+]|\d+\.)\s+/.test(t)){i();const n=t.trim();n&&(e.push({text:n,kind:"list"}),r=e.length-1),s++;continue}""!==t.trim()?null===r?(o.push(t.trim()),s++):(e[r].text+=" "+t.trim(),s++):(i(),r=null,s++)}}return i(),e}let c=!1,l=5;const h=.7;async function u(){return n().isModelCached()}async function d(t){if(!c)try{const e=s();await e.loadVectorDB(),t&&t(5);const o=n();await o.initialize(e=>{t&&t(5+.95*e)}),c=!0,t&&t(100)}catch(e){throw console.error("Search initialization failed:",e),e}}async function m(t,e={}){if(!c)throw new Error("Search system not initialized");const r=e.topK||l;try{const e=n(),i=await e.embed(t),c=s(),l=await c.search(i,r),u=l.slice(0,3),d=await Promise.all(u.map(t=>async function(t,e,n,r=3){const i=t.trim(),s=a(i);if(0===s.length)return{snippet:i,topSegment:i,topScore:0};const c=await n(s.map(t=>t.text)),l=s.map((t,n)=>({...t,index:n,score:o(e,c[n])})).sort((t,e)=>e.score-t.score);return{snippet:l.slice(0,Math.min(r,l.length)).sort((t,e)=>t.index-e.index).map(t=>t.text).join("\n\n"),topSegment:l[0].text,topScore:l[0].score}}(t.chunk.text,i,t=>e.embedBatch(t)))),m=function(t,e,n,o){if(0===e.length)return"I couldn't find anything about that in the documentation. Try rephrasing your question or browse the navigation menu to explore available topics.";const r=/^how (to|do|can)/i.test(t),i=/^what (is|are)/i.test(t),s=/^why/i.test(t);let a="";const c=n.map((t,e)=>({result:t,extract:o[e]})).filter(({result:t,extract:e})=>t.score>h&&e.topScore>h);if(c.length>1){a+="**Quick answer:**\n\n";for(const{result:t,extract:e}of c){const n=f(t.chunk.metadata);a+=`- ${e.topSegment} ([${g(t.chunk.metadata)}](${n}))\n`}a+="\n---\n\n"}r?a+="Here's how you can do that:\n\n":i?a+="Let me explain:\n\n":s?a+="Here's what the docs say about that:\n\n":1===e.length?a+="I found this relevant section:\n\n":a+=`I found ${n.length} relevant sections:\n\n`;if(n.forEach((t,e)=>{const{chunk:n,score:r}=t,i=n.metadata.heading||n.metadata.title,s=f(n.metadata),c=o[e].snippet;e>0&&(a+="\n\n---\n\n"),a+=`**${i}**\n\n`,a+=c,a+=`\n\n→ [View full section](${s})`,r>h&&(a+=" *(highly relevant)*")}),e.length>3){const t=e.length-3;a+=`\n\n---\n\n💡 **Found ${t} more related section${t>1?"s":""}** — check the sources below for more details.`}else 1===e.length&&(a+="\n\n*Have a follow-up question? Just ask!*");return a}(t,l,u,d),p=l.map(t=>({title:g(t.chunk.metadata),url:f(t.chunk.metadata)}));return{answer:m,sources:Array.from(new Map(p.map(t=>[t.url,t])).values())}}catch(i){throw console.error("Search query error:",i),i}}function f(t){let e=t.url;return t.headingId&&(e+=`#${t.headingId}`),e}function g(t){return t.heading?`${t.title} → ${t.heading}`:t.title}function p(){return c}function w(t){l=t}export{d as initializeRAG,u as isModelCached,p as isRAGReady,m as queryRAG,w as setTopK};

package/dist-client/bundle.js

@@ -1 +1 @@
-const e={},t=function(t,n,o){let r=Promise.resolve();if(n&&n.length>0){let t=function(e){return Promise.all(e.map(e=>Promise.resolve(e).then(e=>({status:"fulfilled",value:e}),e=>({status:"rejected",reason:e}))))};document.getElementsByTagName("link");const o=document.querySelector("meta[property=csp-nonce]"),c=(null==o?void 0:o.nonce)||(null==o?void 0:o.getAttribute("nonce"));r=t(n.map(t=>{if((t=function(e){return"/"+e}(t))in e)return;e[t]=!0;const n=t.endsWith(".css"),o=n?'[rel="stylesheet"]':"";if(document.querySelector(`link[href="${t}"]${o}`))return;const r=document.createElement("link");return r.rel=n?"stylesheet":"modulepreload",n||(r.as="script"),r.crossOrigin="",r.href=t,c&&r.setAttribute("nonce",c),document.head.appendChild(r),n?new Promise((e,n)=>{r.addEventListener("load",e),r.addEventListener("error",()=>n(new Error(`Unable to preload CSS for ${t}`)))}):void 0}))}function c(e){const t=new Event("vite:preloadError",{cancelable:!0});if(t.payload=e,window.dispatchEvent(t),!t.defaultPrevented)throw e}return r.then(e=>{for(const t of e||[])"rejected"===t.status&&c(t.reason);return t().catch(c)})},n="botdocs-theme";function o(){const e="dark"===document.documentElement.getAttribute("data-theme")?"light":"dark";r(e),localStorage.setItem(n,e)}function r(e){document.documentElement.setAttribute("data-theme",e)}document.addEventListener("DOMContentLoaded",()=>{!function(){const e=localStorage.getItem(n),t=window.matchMedia("(prefers-color-scheme: dark)").matches;r(e||(t?"dark":"light"));const c=document.querySelector(".theme-toggle");c&&c.addEventListener("click",o),window.matchMedia("(prefers-color-scheme: dark)").addEventListener("change",e=>{localStorage.getItem(n)||r(e.matches?"dark":"light")})}(),function(){const e=window.location.pathname;document.querySelectorAll(".sidebar-nav a").forEach(t=>{const n=t.getAttribute("href");(n===e||"/"===e&&"/index.html"===n)&&t.classList.add("active")}),document.querySelectorAll('a[href^="#"]').forEach(e=>{e.addEventListener("click",t=>{t.preventDefault();const n=e.getAttribute("href");if(n&&n.length>1){const e=document.querySelector(n);e&&e.scrollIntoView({behavior:"smooth"})}})})}();document.getElementById("chat-widget")&&t(async()=>{const{initChat:e}=await import("./assets/chatbox-CmTTiB2Z.js");return{initChat:e}},[]).then(({initChat:e})=>{e()})});export{t as _};
+const e={},t=function(t,n,o){let r=Promise.resolve();if(n&&n.length>0){let t=function(e){return Promise.all(e.map(e=>Promise.resolve(e).then(e=>({status:"fulfilled",value:e}),e=>({status:"rejected",reason:e}))))};document.getElementsByTagName("link");const o=document.querySelector("meta[property=csp-nonce]"),c=(null==o?void 0:o.nonce)||(null==o?void 0:o.getAttribute("nonce"));r=t(n.map(t=>{if((t=function(e){return"/"+e}(t))in e)return;e[t]=!0;const n=t.endsWith(".css"),o=n?'[rel="stylesheet"]':"";if(document.querySelector(`link[href="${t}"]${o}`))return;const r=document.createElement("link");return r.rel=n?"stylesheet":"modulepreload",n||(r.as="script"),r.crossOrigin="",r.href=t,c&&r.setAttribute("nonce",c),document.head.appendChild(r),n?new Promise((e,n)=>{r.addEventListener("load",e),r.addEventListener("error",()=>n(new Error(`Unable to preload CSS for ${t}`)))}):void 0}))}function c(e){const t=new Event("vite:preloadError",{cancelable:!0});if(t.payload=e,window.dispatchEvent(t),!t.defaultPrevented)throw e}return r.then(e=>{for(const t of e||[])"rejected"===t.status&&c(t.reason);return t().catch(c)})},n="botdocs-theme";function o(){const e="dark"===document.documentElement.getAttribute("data-theme")?"light":"dark";r(e),localStorage.setItem(n,e)}function r(e){document.documentElement.setAttribute("data-theme",e)}document.addEventListener("DOMContentLoaded",()=>{!function(){const e=localStorage.getItem(n),t=window.matchMedia("(prefers-color-scheme: dark)").matches;r(e||(t?"dark":"light"));const c=document.querySelector(".theme-toggle");c&&c.addEventListener("click",o),window.matchMedia("(prefers-color-scheme: dark)").addEventListener("change",e=>{localStorage.getItem(n)||r(e.matches?"dark":"light")})}(),function(){const e=window.location.pathname;document.querySelectorAll(".sidebar-nav a").forEach(t=>{const n=t.getAttribute("href");(n===e||"/"===e&&"/index.html"===n)&&t.classList.add("active")}),document.querySelectorAll('a[href^="#"]').forEach(e=>{e.addEventListener("click",t=>{t.preventDefault();const n=e.getAttribute("href");if(n&&n.length>1){const e=document.querySelector(n);e&&e.scrollIntoView({behavior:"smooth"})}})})}();document.getElementById("chat-widget")&&t(async()=>{const{initChat:e}=await import("./assets/chatbox-P1j6YP1y.js").then(e=>e.c);return{initChat:e}},[]).then(({initChat:e})=>{e()})});export{t as _};

package/man/botdocs.1

@@ -0,0 +1,122 @@
+.TH BOTDOCS 1 "2026-03-28" "botdocs 0.3.0" "User Commands"
+.SH NAME
+botdocs \- convert markdown documentation into a static website with AI chatbot
+.SH SYNOPSIS
+.B botdocs
+.RI [ options ]
+.I input
+.SH DESCRIPTION
+.B botdocs
+converts a directory of markdown files into a fully static documentation website.
+An optional client-side semantic search chatbot is included by default, powered by
+Transformers.js running entirely in the browser with no backend required.
+.PP
+The build pipeline scans markdown files, parses front matter, converts to HTML,
+generates vector embeddings for semantic search, and bundles everything into a
+self-contained static site.
+.SH ARGUMENTS
+.TP
+.I input
+Input directory containing markdown files. Required.
+.SH OPTIONS
+.TP
+.BR \-o ", " \-\-output " " \fIdir\fR
+Output directory for the generated site. Defaults to
+.BR output .
+.TP
+.B \-\-no\-chat
+Disable the AI chatbot functionality. The generated site will not include
+semantic search or the chat interface.
+.TP
+.BR \-c ", " \-\-config " " \fIfile\fR
+Path to a configuration file. If not specified, botdocs looks for
+.B botdocs.config.json
+in the input directory.
+.TP
+.BR \-t ", " \-\-theme " " \fItheme\fR
+Theme to use for the generated site. Available themes:
+.BR classic " (default), " material ", " minimal ", " slate ", " modern .
+.TP
+.BR \-v ", " \-\-verbose
+Enable verbose logging during the build process.
+.TP
+.BR \-V ", " \-\-version
+Output the version number.
+.TP
+.BR \-h ", " \-\-help
+Display help information.
+.SH CONFIGURATION
+A
+.B botdocs.config.json
+file can be placed in the input directory to configure the build:
+.PP
+.RS 4
+.nf
+{
+  "title": "My Documentation",
+  "chat": { "enabled": true },
+  "build": {
+    "chunkSize": 500,
+    "chunkOverlap": 50,
+    "topK": 5
+  }
+}
+.fi
+.RE
+.PP
+CLI options override configuration file settings.
+.SH EXAMPLES
+Build a documentation site from a directory:
+.PP
+.RS 4
+.nf
+botdocs ./docs
+.fi
+.RE
+.PP
+Build with a custom output directory and verbose logging:
+.PP
+.RS 4
+.nf
+botdocs ./docs -o ./site -v
+.fi
+.RE
+.PP
+Build without the chatbot:
+.PP
+.RS 4
+.nf
+botdocs ./docs --no-chat
+.fi
+.RE
+.PP
+Use the material theme:
+.PP
+.RS 4
+.nf
+botdocs ./docs -t material
+.fi
+.RE
+.SH EXIT STATUS
+.TP
+.B 0
+Successful build.
+.TP
+.B 1
+Build failed.
+.SH FILES
+.TP
+.I botdocs.config.json
+Optional configuration file in the input directory.
+.TP
+.I output/
+Default output directory containing the generated static site.
+.TP
+.I output/assets/vector\-db.json
+Vector database used by the client-side semantic search.
+.SH AUTHORS
+usr-wwelsh <https://wwel.sh>
+.SH BUGS
+Report bugs at:
+.UR https://github.com/usr-wwelsh/botdocs/issues
+.UE

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "botdocs",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "CLI tool that converts markdown documentation into a static website with an optional client-side AI chatbot",
   "author": "usr-wwelsh <https://wwel.sh>",
   "license": "MIT",
   "bin": {
     "botdocs": "./bin/botdocs.js"
   },
+  "man": "./man/botdocs.1",
   "main": "./dist/src/cli/index.js",
   "type": "module",
   "files": [
@@ -15,6 +16,7 @@
     "bin/",
     "src/templates/",
     "src/styles/",
+    "man/",
     "README.md",
     "LICENSE"
   ],
@@ -35,8 +37,8 @@
     "cli"
   ],
   "dependencies": {
+    "@huggingface/transformers": "^4.2.0",
     "@shikijs/markdown-it": "^1.0.0",
-    "@xenova/transformers": "^2.17.0",
     "commander": "^12.0.0",
     "gray-matter": "^4.0.3",
     "markdown-it": "^14.0.0",
@@ -57,6 +59,11 @@
     "typescript": "^5.3.0",
     "vite": "^6.0.0"
   },
+  "overrides": {
+    "onnxruntime-node": "^1.27.0",
+    "adm-zip": "^0.6.0",
+    "sharp": "^0.35.3"
+  },
   "engines": {
     "node": ">=18.0.0"
   },

package/src/styles/chat.css

@@ -68,6 +68,7 @@
   align-items: center;
 }
 
+.chat-info,
 .chat-clear,
 .chat-close {
   background: none;
@@ -89,11 +90,50 @@
   font-size: 1.5rem;
 }
 
+.chat-info:hover,
 .chat-clear:hover,
 .chat-close:hover {
   background: rgba(255, 255, 255, 0.2);
 }
 
+.chat-disclosure {
+  padding: 1rem 1.25rem;
+  background: var(--bg-tertiary);
+  color: var(--text-secondary);
+  font-size: 0.8125rem;
+  line-height: 1.5;
+  border-bottom: 1px solid var(--border-color);
+}
+
+.chat-disclosure p {
+  margin: 0 0 0.5rem 0;
+  color: var(--text-primary);
+}
+
+.chat-disclosure ul {
+  margin: 0 0 0.75rem 0;
+  padding-left: 1.25rem;
+}
+
+.chat-disclosure li {
+  margin-bottom: 0.375rem;
+}
+
+.chat-disclosure-close {
+  padding: 0.375rem 0.875rem;
+  background: var(--link-color);
+  color: white;
+  border: none;
+  border-radius: 0.375rem;
+  cursor: pointer;
+  font-size: 0.8125rem;
+  font-weight: 500;
+}
+
+.chat-disclosure-close:hover {
+  background: var(--link-hover);
+}
+
 .chat-messages {
   flex: 1;
   overflow-y: auto;
@@ -398,6 +438,92 @@
   transition: width 0.3s ease;
 }
 
+.chat-consent p {
+  margin: 0 0 0.75rem 0;
+}
+
+.chat-consent-actions {
+  display: flex;
+  gap: 0.5rem;
+  justify-content: center;
+}
+
+.chat-consent-download,
+.chat-consent-retry {
+  padding: 0.5rem 1rem;
+  background: var(--link-color);
+  color: white;
+  border: none;
+  border-radius: 0.375rem;
+  cursor: pointer;
+  font-size: 0.8125rem;
+  font-weight: 500;
+}
+
+.chat-consent-download:hover,
+.chat-consent-retry:hover {
+  background: var(--link-hover);
+}
+
+.chat-consent-retry {
+  margin-left: 0.5rem;
+}
+
+.chat-consent-decline {
+  padding: 0.5rem 1rem;
+  background: none;
+  color: var(--text-secondary);
+  border: 1px solid var(--border-color);
+  border-radius: 0.375rem;
+  cursor: pointer;
+  font-size: 0.8125rem;
+}
+
+.chat-consent-decline:hover {
+  background: var(--bg-secondary);
+}
+
+/* AI Use Disclosure Banner (full-bleed, breaks out of .main-content padding) */
+.ai-disclosure {
+  margin: 3rem -3rem 0 -3rem;
+  padding: 1rem 3rem;
+  background: var(--link-color);
+  color: white;
+  text-align: center;
+  font-size: 0.875rem;
+  font-weight: 500;
+  line-height: 1.5;
+}
+
+/* Footer Attribution */
+.botdocs-attribution {
+  margin-top: 4rem;
+  padding-top: 2rem;
+  border-top: 1px solid var(--border-color);
+  text-align: center;
+  font-size: 0.875rem;
+  color: var(--text-secondary);
+  opacity: 0.8;
+}
+
+.ai-disclosure + .botdocs-attribution {
+  margin-top: 1.5rem;
+  padding-top: 0;
+  border-top: none;
+}
+
+.botdocs-attribution a {
+  color: var(--text-secondary);
+  text-decoration: none;
+  font-weight: 500;
+  transition: color 0.2s;
+}
+
+.botdocs-attribution a:hover {
+  color: var(--link-color);
+  text-decoration: none;
+}
+
 /* Mobile responsiveness */
 @media (max-width: 768px) {
   .chat-widget {
@@ -417,4 +543,9 @@
     height: 3.5rem;
     font-size: 1.5rem;
   }
+
+  .ai-disclosure {
+    margin: 2rem -1.5rem 0 -1.5rem;
+    padding: 0.875rem 1.5rem;
+  }
 }

package/src/styles/themes/classic.css

@@ -96,6 +96,35 @@ body {
   font-weight: 500;
 }
 
+.nav-list li.nav-group > a {
+  font-weight: 600;
+  position: relative;
+  padding-right: 1.75rem;
+}
+
+.nav-list li.nav-group > a::after {
+  content: '›';
+  position: absolute;
+  right: 0.75rem;
+  transition: transform 0.2s;
+}
+
+.nav-list li.nav-group:has(> .nav-list) > a::after {
+  transform: rotate(90deg);
+}
+
+.nav-list .nav-list {
+  margin-top: 0.375rem;
+  padding-left: 0.75rem;
+  border-left: 1px solid var(--border-color);
+}
+
+.nav-list .nav-list a {
+  font-weight: 400;
+  font-size: 0.9rem;
+  padding: 0.375rem 0.75rem;
+}
+
 /* Main Content */
 .main-content {
   margin-left: var(--sidebar-width);

package/src/styles/themes/material.css

@@ -105,6 +105,35 @@ body {
   box-shadow: var(--shadow-1);
 }
 
+.nav-list li.nav-group > a {
+  font-weight: 700;
+  position: relative;
+  padding-right: 1.75rem;
+}
+
+.nav-list li.nav-group > a::after {
+  content: '›';
+  position: absolute;
+  right: 1rem;
+  transition: transform 0.2s;
+}
+
+.nav-list li.nav-group:has(> .nav-list) > a::after {
+  transform: rotate(90deg);
+}
+
+.nav-list .nav-list {
+  margin-top: 0.25rem;
+  padding-left: 0.75rem;
+  border-left: 2px solid var(--bg-tertiary);
+}
+
+.nav-list .nav-list a {
+  font-weight: 400;
+  font-size: 0.85rem;
+  padding: 0.5rem 0.75rem;
+}
+
 /* Main Content */
 .main-content {
   margin-left: var(--sidebar-width);

package/src/styles/themes/minimal.css

@@ -109,6 +109,40 @@ body {
   border-bottom-color: var(--text-primary);
 }
 
+.nav-list li.nav-group {
+  flex-basis: 100%;
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: center;
+  align-items: baseline;
+  gap: 0.375rem 1rem;
+}
+
+.nav-list li.nav-group > a {
+  color: var(--text-primary);
+  font-weight: 600;
+}
+
+.nav-list li.nav-group > a::after {
+  content: '›';
+  margin-left: 0.25rem;
+  display: inline-block;
+  transition: transform 0.2s;
+}
+
+.nav-list li.nav-group:has(> .nav-list) > a::after {
+  transform: rotate(90deg);
+}
+
+.nav-list .nav-list {
+  margin: 0;
+  gap: 0.375rem 1rem;
+}
+
+.nav-list .nav-list a {
+  font-size: 0.8rem;
+}
+
 /* Main Content - centered, no sidebar offset */
 .main-content {
   margin-left: 0;

package/src/styles/themes/modern.css

@@ -122,6 +122,40 @@ body {
   box-shadow: 0 4px 12px rgba(100, 108, 255, 0.3);
 }
 
+.nav-list li.nav-group {
+  flex-basis: 100%;
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.nav-list li.nav-group > a {
+  font-weight: 700;
+}
+
+.nav-list li.nav-group > a::after {
+  content: '›';
+  margin-left: 0.375rem;
+  display: inline-block;
+  transition: transform 0.2s;
+}
+
+.nav-list li.nav-group:has(> .nav-list) > a::after {
+  transform: rotate(90deg);
+}
+
+.nav-list .nav-list {
+  margin: 0;
+  gap: 0.375rem;
+}
+
+.nav-list .nav-list a {
+  padding: 0.375rem 0.875rem;
+  font-size: 0.85rem;
+  font-weight: 400;
+}
+
 /* Main Content - full width, no sidebar offset */
 .main-content {
   margin-left: 0;

package/src/styles/themes/slate.css

@@ -112,47 +112,49 @@ body {
   font-weight: 600;
 }
 
+.nav-list li.nav-group > a {
+  color: var(--sidebar-text);
+  font-weight: 600;
+  position: relative;
+  padding-right: 1.75rem;
+}
+
+.nav-list li.nav-group > a::after {
+  content: '›';
+  position: absolute;
+  right: 1rem;
+  transition: transform 0.2s;
+}
+
+.nav-list li.nav-group:has(> .nav-list) > a::after {
+  transform: rotate(90deg);
+}
+
+.nav-list .nav-list {
+  margin-top: 0.125rem;
+  padding-left: 1rem;
+}
+
+.nav-list .nav-list a {
+  font-weight: 400;
+  font-size: 0.85rem;
+}
+
 /* Main Content - Split screen with code examples */
 .main-content {
   margin-left: var(--sidebar-width);
   flex: 1;
   padding: 0;
   background: var(--bg-primary);
-  display: flex;
-  gap: 0;
 }
 
 .content-wrapper {
-  flex: 1;
   max-width: none;
   padding: 3rem 2.5rem;
   background: var(--bg-primary);
   min-width: 0;
 }
 
-/* Code blocks stick to right side for split-screen effect */
-.content-wrapper pre {
-  position: relative;
-  margin-left: calc(-50vw + 50%);
-  margin-right: -2.5rem;
-  margin-top: -3rem;
-  margin-bottom: 2rem;
-  width: calc(100% + 50vw - 50% + 2.5rem);
-  max-width: 800px;
-  float: right;
-  clear: right;
-}
-
-/* Adjust paragraph spacing when followed by code */
-.content-wrapper p + pre {
-  margin-top: -2rem;
-}
-
-.content-wrapper h3 + pre,
-.content-wrapper h4 + pre {
-  margin-top: 1rem;
-}
-
 /* Typography - clean and technical */
 h1, h2, h3, h4, h5, h6 {
   margin-top: 2.5rem;
@@ -228,8 +230,10 @@ code {
 }
 
 pre {
-  background: var(--code-bg);
-  color: var(--code-text);
+  /* Shiki inlines a light-theme background/color on the element itself;
+     override it so slate's dark code style actually wins. */
+  background: var(--code-bg) !important;
+  color: var(--code-text) !important;
   padding: 1.5rem;
   border-radius: 6px;
   overflow-x: auto;
@@ -692,14 +696,6 @@ img {
     padding: 2rem 1.5rem;
   }
 
-  .content-wrapper pre {
-    margin-left: 0;
-    margin-right: 0;
-    width: 100%;
-    float: none;
-    clear: both;
-  }
-
   .layout {
     flex-direction: column;
   }

package/src/templates/layout.html

@@ -35,6 +35,13 @@
         {{content}}
       </div>
 
+      {{#if chatEnabled}}
+      <p class="ai-disclosure">
+        🔒 This site's search assistant runs a local AI model in your browser — no cloud AI,
+        no tracking. See the ℹ️ in the chat panel for details.
+      </p>
+      {{/if}}
+
       {{#if attribution}}
       <!-- Footer Attribution -->
       <footer class="botdocs-attribution">

package/dist-client/assets/chatbox-CmTTiB2Z.js

@@ -1 +0,0 @@
-import{_ as t}from"../bundle.js";function e(t){let e=t;return e=function(t){const e=document.createElement("div");return e.textContent=t,e.innerHTML}(e),e=e.replace(/```(\w+)?\n([\s\S]*?)```/g,(t,e,n)=>`<pre><code${e?` class="language-${e}"`:""}>${n.trim()}</code></pre>`),e=e.replace(/`([^`]+)`/g,"<code>$1</code>"),e=e.replace(/\*\*(.+?)\*\*/g,"<strong>$1</strong>"),e=e.replace(/__(.+?)__/g,"<strong>$1</strong>"),e=e.replace(/\*(.+?)\*/g,"<em>$1</em>"),e=e.replace(/_(.+?)_/g,"<em>$1</em>"),e=e.replace(/\[([^\]]+)\]\(([^)]+)\)/g,'<a href="$2" target="_blank">$1</a>'),e=e.replace(/^### (.+)$/gm,"<h3>$1</h3>"),e=e.replace(/^## (.+)$/gm,"<h2>$1</h2>"),e=e.replace(/^# (.+)$/gm,"<h1>$1</h1>"),e=e.replace(/^---$/gm,"<hr />"),e=e.replace(/\n\n/g,"</p><p>"),e=e.replace(/\n/g,"<br />"),e=`<p>${e}</p>`,e=e.replace(/<p><\/p>/g,""),e=e.replace(/<p>(<pre>)/g,"$1"),e=e.replace(/(<\/pre>)<\/p>/g,"$1"),e=e.replace(/<p>(<h[1-3]>)/g,"$1"),e=e.replace(/(<\/h[1-3]>)<\/p>/g,"$1"),e=e.replace(/<p>(<hr \/>)<\/p>/g,"$1"),e}let n=!1,a=[],s=!1;const c="botdocs_chat_history",o="botdocs_chat_open",i="botdocs_chat_timestamp",r=6e5;function l(){const t=document.getElementById("chat-toggle"),e=document.getElementById("chat-container");t&&e?(!function(){try{const t=localStorage.getItem(i),e=Date.now();if(t){if(e-parseInt(t,10)>r)return void I()}const s=localStorage.getItem(c);s&&(a=JSON.parse(s));const l=localStorage.getItem(o);l&&(n=JSON.parse(l))}catch(t){console.error("Failed to load chat state:",t),a=[],n=!1}}(),t.addEventListener("click",()=>{d()}),h(e),a.length>0&&function(){const t=document.getElementById("chat-messages");if(!t)return;t.innerHTML="";for(const e of a)y(e,t)}(),n&&(e.style.display="flex",s||g().then(()=>{s=!0}))):console.error("Chat elements not found")}async function d(){n=!n;const t=document.getElementById("chat-container");t&&(t.style.display=n?"flex":"none"),n&&!s&&(await g(),s=!0),function(){try{localStorage.setItem(o,JSON.stringify(n))}catch(t){console.error("Failed to save chat state:",t)}}()}function h(t){t.innerHTML='\n    <div class="chat-header">\n      <h3>Ask me anything</h3>\n      <div class="chat-header-actions">\n        <button class="chat-clear" id="chat-clear" title="Clear chat history">🗑️</button>\n        <button class="chat-close" id="chat-close">×</button>\n      </div>\n    </div>\n    <div class="chat-status" id="chat-status" style="display: none;">\n      Initializing chat...\n    </div>\n    <div class="chat-messages" id="chat-messages">\n      <div class="chat-message assistant">\n        <div class="message-content">\n          👋 Hi! I\'m your documentation assistant. Ask me anything about these docs!\n        </div>\n      </div>\n    </div>\n    <div class="chat-input-container">\n      <div class="chat-input-wrapper">\n        <textarea\n          class="chat-input"\n          id="chat-input"\n          placeholder="Ask a question..."\n          rows="1"\n        ></textarea>\n        <button class="chat-send" id="chat-send">Send</button>\n      </div>\n    </div>\n  ';const e=document.getElementById("chat-close"),n=document.getElementById("chat-clear"),a=document.getElementById("chat-send"),c=document.getElementById("chat-input");if(e&&e.addEventListener("click",d),n&&n.addEventListener("click",m),a&&c&&(a.addEventListener("click",()=>u(c)),c.addEventListener("keypress",t=>{"Enter"!==t.key||t.shiftKey||(t.preventDefault(),u(c))}),c.addEventListener("input",()=>{c.style.height="auto",c.style.height=c.scrollHeight+"px"})),s){const t=document.getElementById("chat-status");t&&(t.style.display="none")}}async function g(){const e=document.getElementById("chat-status");if(e)try{e.style.display="block",e.textContent="Loading AI models...";const{initializeRAG:n,isRAGReady:a}=await t(async()=>{const{initializeRAG:t,isRAGReady:e}=await import("./rag-engine-L2vj3Y0G.js");return{initializeRAG:t,isRAGReady:e}},[]);await n(t=>{e.innerHTML=`\n        Loading models... ${Math.round(t)}%\n        <div class="progress-bar">\n          <div class="progress-fill" style="width: ${t}%"></div>\n        </div>\n      `}),a()&&(e.style.display="none")}catch(n){console.error("Failed to initialize RAG:",n),e.textContent="⚠️ Chat unavailable"}}function m(){if(confirm("Clear chat history?")){I();const t=document.getElementById("chat-messages");t&&(t.innerHTML='\n        <div class="chat-message assistant">\n          <div class="message-content">\n            👋 Hi! I\'m your documentation assistant. Ask me anything about these docs!\n          </div>\n        </div>\n      ')}}async function u(e){const n=e.value.trim();if(!n)return;p({role:"user",content:n}),e.value="",e.style.height="auto";const a=document.getElementById("chat-send");a&&(a.disabled=!0),e.disabled=!0,function(){const t=document.getElementById("chat-messages");if(!t)return;const e=document.createElement("div");e.id="loading-indicator",e.className="chat-message assistant",e.innerHTML='\n    <div class="loading-indicator">\n      <div class="loading-dot"></div>\n      <div class="loading-dot"></div>\n      <div class="loading-dot"></div>\n    </div>\n  ',t.appendChild(e),t.scrollTop=t.scrollHeight}();try{const{queryRAG:e}=await t(async()=>{const{queryRAG:t}=await import("./rag-engine-L2vj3Y0G.js");return{queryRAG:t}},[]),a=await e(n);v(),p({role:"assistant",content:a.answer,citations:a.sources})}catch(s){console.error("Chat error:",s),v(),p({role:"assistant",content:"Sorry, I encountered an error. Please try again."})}finally{a&&(a.disabled=!1),e.disabled=!1,e.focus()}}function p(t){a.push(t),function(){try{localStorage.setItem(c,JSON.stringify(a)),localStorage.setItem(i,Date.now().toString())}catch(t){console.error("Failed to save chat history:",t)}}();const e=document.getElementById("chat-messages");e&&y(t,e)}function y(t,n){const a=document.createElement("div");a.className=`chat-message ${t.role}`;let s="";s="user"===t.role?f(t.content):e(t.content);let c=`<div class="message-content">${s}</div>`;if(t.citations&&t.citations.length>0){c+='<div class="message-citations">',c+='<div class="citations-label">📚 Sources:</div>';for(const e of t.citations)c+=`<a href="${f(e.url)}" class="citation-link">${f(e.title)}</a>`;c+="</div>"}a.innerHTML=c,n.appendChild(a),n.scrollTo({top:n.scrollHeight,behavior:"smooth"})}function v(){const t=document.getElementById("loading-indicator");t&&t.remove()}function f(t){const e=document.createElement("div");return e.textContent=t,e.innerHTML}function I(){try{localStorage.removeItem(c),localStorage.removeItem(i),a=[]}catch(t){console.error("Failed to clear chat history:",t)}}export{p as addMessage,l as initChat,h as renderChatUI,d as toggleChat};