birdclaw 0.5.0 → 0.6.0

package/scripts/docs-site-assets.mjs

@@ -0,0 +1,311 @@
+export function css() {
+	return `
+:root{
+  --ink:#0f1419;
+  --text:#0f1419;
+  --muted:#536471;
+  --subtle:#8b98a5;
+  --bg:#ffffff;
+  --paper:#f7f9f9;
+  --paper-2:#eff3f4;
+  --accent:#1d9bf0;
+  --accent-soft:rgba(29,155,240,.10);
+  --accent-strong:#1a8cd8;
+  --bird-blue:#1d9bf0;
+  --bird-sky:#71c9f8;
+  --bird-coral:#f4212e;
+  --bird-gold:#ffd400;
+  --line:#eff3f4;
+  --line-strong:#cfd9de;
+  --line-soft:#f7f9f9;
+  --code-bg:#0b1622;
+  --code-fg:#e7eef6;
+  --code-inline-bg:#eff3f4;
+  --code-inline-fg:#0f1419;
+  --code-border:#13283f;
+  --pill-border:#cfd9de;
+  --shadow-card:0 4px 14px rgba(15,20,25,.05);
+  --scrollbar:#cfd9de;
+  --hl-keyword:#1d9bf0;
+  --hl-string:#0a8a4e;
+  --hl-number:#a35200;
+  --hl-comment:#8b98a5;
+  --hl-flag:#7856ff;
+  --hl-meta:#f4212e;
+  --hl-prompt:#71c9f8;
+}
+:root[data-theme="dark"]{
+  --ink:#e7e9ea;
+  --text:#e7e9ea;
+  --muted:#8b98a5;
+  --subtle:#71767b;
+  --bg:#000000;
+  --paper:#16181c;
+  --paper-2:#1d2125;
+  --accent:#1d9bf0;
+  --accent-soft:rgba(29,155,240,.18);
+  --accent-strong:#4fb1f3;
+  --line:#2f3336;
+  --line-strong:#3e4144;
+  --line-soft:#1c1f23;
+  --code-bg:#04090f;
+  --code-fg:#e7eef6;
+  --code-inline-bg:#1d2125;
+  --code-inline-fg:#e7e9ea;
+  --code-border:#1c2a3a;
+  --pill-border:#2f3336;
+  --shadow-card:0 4px 18px rgba(0,0,0,.55);
+  --scrollbar:#3e4144;
+  --hl-keyword:#4fb1f3;
+  --hl-string:#5fd29a;
+  --hl-number:#f0a868;
+  --hl-comment:#71767b;
+  --hl-flag:#a48cff;
+  --hl-meta:#ff6e7a;
+  --hl-prompt:#71c9f8;
+}
+:root{color-scheme:light}
+:root[data-theme="dark"]{color-scheme:dark}
+*{box-sizing:border-box}
+html{scroll-behavior:smooth;scroll-padding-top:24px}
+body{margin:0;background:var(--bg);color:var(--text);font-family:"Inter","Chirp","Twitter Chirp",ui-sans-serif,system-ui,-apple-system,Segoe UI,sans-serif;line-height:1.6;overflow-x:hidden;-webkit-font-smoothing:antialiased;font-feature-settings:"cv02","cv03","cv04","cv11";transition:background-color .18s,color .18s}
+::selection{background:var(--accent);color:#fff}
+a{color:var(--accent);text-decoration:none;transition:color .12s}
+a:hover{text-decoration:underline;text-underline-offset:.2em;color:var(--accent-strong)}
+.shell{display:grid;grid-template-columns:272px minmax(0,1fr);min-height:100vh}
+.sidebar{position:sticky;top:0;height:100vh;overflow:auto;padding:22px 20px;background:var(--paper);border-right:1px solid var(--line);scrollbar-width:thin;scrollbar-color:var(--line-strong) transparent;transition:background-color .18s,border-color .18s}
+.sidebar::-webkit-scrollbar{width:6px}
+.sidebar::-webkit-scrollbar-thumb{background:var(--line-strong);border-radius:6px}
+.sidebar-head{display:flex;align-items:center;gap:10px;margin-bottom:22px}
+.brand{display:flex;align-items:center;gap:11px;color:var(--ink);text-decoration:none;flex:1;min-width:0}
+.brand:hover{text-decoration:none}
+.brand .mark{display:inline-flex;align-items:center;justify-content:center;flex:0 0 36px;width:36px;height:36px;border-radius:10px;background:#020507;box-shadow:0 6px 16px rgba(29,155,240,.24);overflow:hidden}
+.brand .mark img{width:30px;height:30px;display:block;object-fit:contain}
+.brand strong{display:block;font-size:1.08rem;line-height:1.1;font-weight:700;letter-spacing:-.01em;color:var(--ink)}
+.brand small{display:block;color:var(--muted);font-size:.74rem;margin-top:3px;font-weight:400}
+.theme-toggle{display:inline-flex;align-items:center;justify-content:center;flex:0 0 auto;width:34px;height:34px;border-radius:999px;border:1px solid var(--line-strong);background:var(--paper);color:var(--muted);cursor:pointer;padding:0;transition:border-color .15s,color .15s,background-color .15s,transform .12s}
+.theme-toggle:hover{border-color:var(--accent);color:var(--accent)}
+.theme-toggle:active{transform:scale(.94)}
+.theme-toggle svg{width:16px;height:16px;display:block}
+.theme-icon-sun{display:none}
+:root[data-theme="dark"] .theme-icon-sun{display:block}
+:root[data-theme="dark"] .theme-icon-moon{display:none}
+.search{display:block;margin:0 0 22px}
+.search span{display:block;color:var(--muted);font-size:.7rem;font-weight:600;text-transform:uppercase;letter-spacing:.04em;margin-bottom:7px}
+.search input{width:100%;border:1px solid var(--line-strong);background:var(--bg);border-radius:999px;padding:9px 14px;font:inherit;font-size:.9rem;color:var(--text);outline:none;transition:border-color .15s,box-shadow .15s,background-color .18s}
+.search input:focus{border-color:var(--accent);box-shadow:0 0 0 3px var(--accent-soft)}
+nav section{margin:0 0 18px}
+nav h2{font-size:.66rem;color:var(--muted);text-transform:uppercase;letter-spacing:.06em;margin:0 0 6px;font-weight:700}
+.nav-link{display:block;color:var(--text);text-decoration:none;border-radius:999px;padding:6px 12px;margin:1px 0;font-size:.9rem;line-height:1.4;transition:background .12s,color .12s}
+.nav-link:hover{background:var(--paper-2);color:var(--ink);text-decoration:none}
+.nav-link.active{background:var(--accent);color:#fff;font-weight:600}
+:root[data-theme="dark"] .nav-link.active{background:var(--accent-soft);color:var(--accent-strong)}
+main{min-width:0;padding:32px clamp(20px,4.5vw,56px) 80px;max-width:1180px;margin:0 auto;width:100%}
+.hero{display:flex;align-items:flex-end;justify-content:space-between;gap:22px;border-bottom:1px solid var(--line);padding:8px 0 22px;margin-bottom:8px;flex-wrap:wrap}
+.hero-text{min-width:0;flex:1 1 320px}
+.eyebrow{margin:0 0 8px;color:var(--accent);font-weight:700;text-transform:uppercase;letter-spacing:.06em;font-size:.7rem}
+.hero h1{font-size:2.25rem;line-height:1.1;letter-spacing:-.02em;margin:0;font-weight:800;color:var(--ink)}
+.hero-meta{display:flex;gap:8px;flex:0 0 auto;flex-wrap:wrap}
+.repo,.edit,.btn-ghost{border:1px solid var(--line-strong);color:var(--text);text-decoration:none;border-radius:999px;padding:7px 14px;font-weight:600;font-size:.83rem;background:var(--bg);transition:border-color .15s,color .15s,background .15s}
+.repo:hover,.edit:hover,.btn-ghost:hover{border-color:var(--accent);color:var(--accent);text-decoration:none}
+.edit{color:var(--muted)}
+.home-hero{padding:18px 0 32px;margin-bottom:8px;border-bottom:1px solid var(--line);position:relative;overflow:hidden}
+.home-hero .home-mark{position:absolute;right:-24px;top:-12px;width:310px;height:310px;object-fit:contain;opacity:.08;pointer-events:none;filter:drop-shadow(0 18px 32px rgba(29,155,240,.18))}
+:root[data-theme="dark"] .home-hero .home-mark{opacity:.16}
+.home-hero h1{font-size:3.4rem;line-height:1.02;letter-spacing:-.03em;margin:0 0 .35em;font-weight:800;color:var(--ink)}
+.home-hero h1 .accent{color:var(--accent)}
+.home-hero .lede{font-size:1.16rem;line-height:1.55;color:var(--text);margin:0 0 1.3em;max-width:60ch}
+.home-cta{display:flex;flex-wrap:wrap;gap:10px;align-items:center;margin:0 0 18px}
+.home-cta .btn{display:inline-flex;align-items:center;gap:7px;border-radius:999px;padding:11px 20px;font-weight:700;font-size:.92rem;text-decoration:none;transition:background .15s,border-color .15s,color .15s,transform .12s}
+.home-cta .btn-primary{background:var(--accent);color:#fff;border:1px solid var(--accent)}
+.home-cta .btn-primary:hover{background:var(--accent-strong);border-color:var(--accent-strong);text-decoration:none}
+.home-cta .btn-ghost{padding:11px 20px}
+.home-install{display:flex;align-items:center;gap:12px;background:var(--code-bg);color:var(--code-fg);border-radius:14px;padding:11px 11px 11px 17px;font:500 .9rem/1.2 "JetBrains Mono","SF Mono",ui-monospace,monospace;max-width:34em;border:1px solid var(--code-border)}
+.home-install .prompt{color:var(--hl-prompt);user-select:none;flex:0 0 auto}
+.home-install code{flex:1;background:transparent;border:0;color:var(--code-fg);font:inherit;padding:0;white-space:pre;overflow:hidden;text-overflow:ellipsis}
+.home-install .copy{flex:0 0 auto;background:rgba(255,255,255,.08);color:var(--code-fg);border:1px solid rgba(255,255,255,.16);border-radius:999px;padding:5px 13px;font:600 .72rem/1 "Inter",sans-serif;cursor:pointer;transition:background .15s,border-color .15s}
+.home-install .copy:hover{background:rgba(255,255,255,.16)}
+.home-install .copy.copied{background:var(--accent);border-color:var(--accent)}
+.home-services{display:flex;flex-wrap:wrap;gap:6px;margin:6px 0 18px}
+.home-services span{display:inline-block;padding:4px 11px;border:1px solid var(--line-strong);border-radius:999px;font-size:.78rem;color:var(--muted);background:var(--paper);font-weight:500}
+.feature-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:14px;margin:24px 0 8px}
+.feature-grid .card{border:1px solid var(--line);background:var(--paper);border-radius:14px;padding:16px 18px;transition:border-color .15s,transform .12s}
+.feature-grid .card:hover{border-color:var(--accent);transform:translateY(-1px)}
+.feature-grid .card h3{margin:0 0 6px;font-size:1rem;font-weight:700;color:var(--ink);letter-spacing:-.01em}
+.feature-grid .card p{margin:0;color:var(--muted);font-size:.9rem;line-height:1.5}
+.doc-grid{display:grid;grid-template-columns:minmax(0,1fr);gap:48px;margin-top:24px}
+.doc-grid-home{margin-top:8px}
+@media(min-width:1180px){.doc-grid{grid-template-columns:minmax(0,72ch) 200px;justify-content:start}.doc-grid-home{grid-template-columns:minmax(0,76ch);justify-content:start}}
+.doc{min-width:0;max-width:72ch;overflow-wrap:break-word}
+.doc-home{max-width:76ch}
+.doc h1{font-size:2.5rem;line-height:1.08;letter-spacing:-.02em;margin:0 0 .4em;font-weight:800;color:var(--ink)}
+body:not(.home) .doc>h1:first-child{display:none}
+.doc h2{font-size:1.45rem;line-height:1.2;margin:2em 0 .5em;font-weight:700;letter-spacing:-.01em;color:var(--ink);position:relative}
+.doc h3{font-size:1.1rem;margin:1.7em 0 .35em;position:relative;font-weight:700;color:var(--ink);letter-spacing:-.005em}
+.doc h4{font-size:.98rem;margin:1.4em 0 .25em;color:var(--ink);position:relative;font-weight:600}
+.doc h2:first-child,.doc h3:first-child,.doc h4:first-child{margin-top:.2em}
+.doc :is(h2,h3,h4) .anchor{position:absolute;left:-1.05em;top:0;color:var(--subtle);opacity:0;text-decoration:none;font-weight:400;padding-right:.3em;transition:opacity .12s,color .12s}
+.doc :is(h2,h3,h4):hover .anchor{opacity:.7}
+.doc :is(h2,h3,h4) .anchor:hover{opacity:1;color:var(--accent);text-decoration:none}
+.doc p{margin:0 0 1.05em}
+.doc ul,.doc ol{padding-left:1.3rem;margin:0 0 1.15em}
+.doc li{margin:.25em 0}
+.doc li>p{margin:0 0 .4em}
+.doc strong{font-weight:700;color:var(--ink)}
+.doc em{font-style:italic}
+.doc code{font-family:"JetBrains Mono","SF Mono",ui-monospace,monospace;font-size:.84em;background:var(--code-inline-bg);border:1px solid var(--line);border-radius:6px;padding:.08em .42em;color:var(--code-inline-fg)}
+.doc pre{position:relative;overflow:auto;background:var(--code-bg);color:var(--code-fg);border-radius:12px;padding:14px 18px;margin:1.3em 0;font-size:.85em;line-height:1.6;scrollbar-width:thin;scrollbar-color:#334155 transparent;border:1px solid var(--code-border)}
+.doc pre::-webkit-scrollbar{height:8px;width:8px}
+.doc pre::-webkit-scrollbar-thumb{background:#334155;border-radius:8px}
+.doc pre code{display:block;background:transparent;border:0;color:inherit;padding:0;font-size:1em;white-space:pre}
+.doc pre .copy{position:absolute;top:8px;right:8px;background:rgba(255,255,255,.06);color:var(--code-fg);border:1px solid rgba(255,255,255,.16);border-radius:999px;padding:3px 11px;font:600 .7rem/1 "Inter",sans-serif;cursor:pointer;opacity:0;transition:opacity .15s,background .15s,border-color .15s}
+.doc pre:hover .copy,.doc pre .copy:focus{opacity:1}
+.doc pre .copy:hover{background:rgba(255,255,255,.12)}
+.doc pre .copy.copied{background:var(--accent);border-color:var(--accent);opacity:1}
+.doc pre .hl-c{color:var(--hl-comment);font-style:italic}
+.doc pre .hl-s{color:var(--hl-string)}
+.doc pre .hl-n{color:var(--hl-number)}
+.doc pre .hl-k{color:var(--hl-keyword);font-weight:600}
+.doc pre .hl-f{color:var(--hl-flag)}
+.doc pre .hl-m{color:var(--hl-meta);font-weight:600}
+.doc pre .hl-p{color:var(--hl-prompt);user-select:none}
+.doc pre .hl-cmd{color:var(--hl-keyword);font-weight:600}
+.doc blockquote{margin:1.4em 0;padding:12px 18px;border-left:3px solid var(--accent);background:var(--accent-soft);border-radius:0 12px 12px 0;color:var(--text)}
+.doc blockquote p:last-child{margin-bottom:0}
+.doc table{width:100%;border-collapse:collapse;margin:1.2em 0;font-size:.92em}
+.doc th,.doc td{border-bottom:1px solid var(--line);padding:9px 10px;text-align:left;vertical-align:top}
+.doc th{font-weight:700;color:var(--ink);background:var(--paper);border-bottom:1px solid var(--line-strong)}
+.doc hr{border:0;border-top:1px solid var(--line);margin:2.2em 0}
+.toc{position:sticky;top:24px;align-self:start;font-size:.84rem;padding-left:14px;border-left:1px solid var(--line);max-height:calc(100vh - 48px);overflow:auto;scrollbar-width:thin;scrollbar-color:var(--line-strong) transparent}
+.toc::-webkit-scrollbar{width:5px}
+.toc::-webkit-scrollbar-thumb{background:var(--line-strong);border-radius:5px}
+.toc h2{font-size:.66rem;color:var(--muted);text-transform:uppercase;letter-spacing:.06em;margin:0 0 10px;font-weight:700}
+.toc a{display:block;color:var(--muted);text-decoration:none;padding:4px 0 4px 10px;line-height:1.35;border-left:2px solid transparent;margin-left:-12px;transition:color .12s,border-color .12s}
+.toc a:hover{color:var(--ink);text-decoration:none}
+.toc a.active{color:var(--accent);border-left-color:var(--accent);font-weight:600}
+.toc-l3{padding-left:22px!important;font-size:.94em}
+@media(max-width:1179px){.toc{display:none}}
+.page-nav{display:grid;grid-template-columns:1fr 1fr;gap:14px;margin-top:48px;border-top:1px solid var(--line);padding-top:20px}
+.page-nav>a{display:block;border:1px solid var(--line);background:var(--paper);border-radius:14px;padding:14px 18px;text-decoration:none;color:var(--text);transition:border-color .15s,transform .15s,box-shadow .15s,background-color .18s}
+.page-nav>a:hover{border-color:var(--accent);text-decoration:none;color:var(--ink)}
+.page-nav small{display:block;color:var(--muted);font-size:.7rem;text-transform:uppercase;letter-spacing:.06em;margin-bottom:5px;font-weight:700}
+.page-nav span{display:block;font-weight:700;line-height:1.3;color:var(--ink)}
+.page-nav-prev{text-align:left}
+.page-nav-next{text-align:right;grid-column:2}
+.page-nav-prev:only-child{grid-column:1}
+.nav-toggle{display:none;position:fixed;top:14px;right:14px;top:calc(14px + env(safe-area-inset-top, 0px));right:calc(14px + env(safe-area-inset-right, 0px));z-index:20;width:40px;height:40px;border-radius:999px;background:var(--paper);border:1px solid var(--line-strong);color:var(--ink);cursor:pointer;padding:10px 9px;flex-direction:column;align-items:stretch;justify-content:space-between;box-shadow:var(--shadow-card)}
+.nav-toggle span{display:block;width:100%;height:2px;flex:0 0 2px;background:currentColor;border-radius:2px;transition:transform .2s,opacity .2s}
+.nav-toggle[aria-expanded="true"] span:nth-child(1){transform:translateY(8px) rotate(45deg)}
+.nav-toggle[aria-expanded="true"] span:nth-child(2){opacity:0}
+.nav-toggle[aria-expanded="true"] span:nth-child(3){transform:translateY(-8px) rotate(-45deg)}
+@media(max-width:900px){
+  .shell{display:block}
+  .sidebar{position:fixed;inset:0 30% 0 0;max-width:320px;height:100vh;z-index:15;transform:translateX(-100%);transition:transform .25s ease,background-color .18s,border-color .18s;box-shadow:0 18px 40px rgba(0,0,0,.18);background:var(--paper);pointer-events:none}
+  .sidebar.open{transform:translateX(0);pointer-events:auto}
+  .nav-toggle{display:flex}
+  main{padding:64px 18px 56px}
+  .hero{padding-top:6px}
+  .hero h1{font-size:1.8rem}
+  .home-hero h1{font-size:2.4rem}
+  .doc h1{font-size:2.05rem}
+  .hero-meta{width:100%;justify-content:flex-start}
+  .home-hero{padding-top:8px}
+  .home-hero .home-mark{width:230px;height:230px;right:-64px;top:-34px}
+  .doc{padding:0}
+  .doc-grid{margin-top:18px;gap:24px}
+  .doc :is(h2,h3,h4) .anchor{display:none}
+}
+@media(max-width:520px){
+  main{padding:60px 14px 48px}
+  .doc pre{margin-left:-14px;margin-right:-14px;border-radius:0;border-left:0;border-right:0}
+  .home-install{flex-wrap:wrap}
+}
+`;
+}
+
+export function js() {
+	return `
+const themeRoot=document.documentElement;
+function applyTheme(mode){themeRoot.dataset.theme=mode;document.querySelectorAll('[data-theme-toggle]').forEach(b=>b.setAttribute('aria-pressed',mode==='dark'?'true':'false'))}
+function storedTheme(){try{return localStorage.getItem('theme')}catch(e){return null}}
+function persistTheme(mode){try{localStorage.setItem('theme',mode)}catch(e){}}
+applyTheme(themeRoot.dataset.theme==='dark'?'dark':'light');
+document.querySelectorAll('[data-theme-toggle]').forEach(btn=>{btn.addEventListener('click',()=>{const next=themeRoot.dataset.theme==='dark'?'light':'dark';applyTheme(next);persistTheme(next)})});
+const systemDark=window.matchMedia&&matchMedia('(prefers-color-scheme: dark)');
+function onSystemChange(e){if(storedTheme())return;applyTheme(e.matches?'dark':'light')}
+if(systemDark){if(systemDark.addEventListener)systemDark.addEventListener('change',onSystemChange);else if(systemDark.addListener)systemDark.addListener(onSystemChange)}
+const sidebar=document.querySelector('.sidebar');
+const toggle=document.querySelector('.nav-toggle');
+const mobileNav=window.matchMedia('(max-width: 900px)');
+const sidebarFocusable='a[href],button,input,select,textarea,[tabindex]';
+function setSidebarFocusable(enabled){
+  sidebar?.querySelectorAll(sidebarFocusable).forEach((el)=>{
+    if(enabled){
+      if(el.dataset.sidebarTabindex!==undefined){
+        if(el.dataset.sidebarTabindex)el.setAttribute('tabindex',el.dataset.sidebarTabindex);
+        else el.removeAttribute('tabindex');
+        delete el.dataset.sidebarTabindex;
+      }
+    }else if(el.dataset.sidebarTabindex===undefined){
+      el.dataset.sidebarTabindex=el.getAttribute('tabindex')??'';
+      el.setAttribute('tabindex','-1');
+    }
+  });
+}
+function setSidebarOpen(open){
+  if(!sidebar||!toggle)return;
+  sidebar.classList.toggle('open',open);
+  toggle.setAttribute('aria-expanded',open?'true':'false');
+  if(mobileNav.matches){
+    sidebar.inert=!open;
+    if(open)sidebar.removeAttribute('aria-hidden');
+    else sidebar.setAttribute('aria-hidden','true');
+    setSidebarFocusable(open);
+  }else{
+    sidebar.inert=false;
+    sidebar.removeAttribute('aria-hidden');
+    setSidebarFocusable(true);
+  }
+}
+setSidebarOpen(false);
+toggle?.addEventListener('click',()=>setSidebarOpen(!sidebar?.classList.contains('open')));
+document.addEventListener('click',(e)=>{if(!sidebar?.classList.contains('open'))return;if(sidebar.contains(e.target)||toggle?.contains(e.target))return;setSidebarOpen(false)});
+document.addEventListener('keydown',(e)=>{if(e.key==='Escape')setSidebarOpen(false)});
+const syncSidebarForViewport=()=>setSidebarOpen(sidebar?.classList.contains('open')??false);
+if(mobileNav.addEventListener)mobileNav.addEventListener('change',syncSidebarForViewport);
+else mobileNav.addListener?.(syncSidebarForViewport);
+const input=document.getElementById('doc-search');
+input?.addEventListener('input',()=>{const q=input.value.trim().toLowerCase();document.querySelectorAll('nav section').forEach(sec=>{let any=false;sec.querySelectorAll('.nav-link').forEach(a=>{const m=!q||a.textContent.toLowerCase().includes(q);a.style.display=m?'block':'none';if(m)any=true});sec.style.display=any?'block':'none'})});
+function attachCopy(target,getText){const btn=document.createElement('button');btn.type='button';btn.className='copy';btn.textContent='Copy';btn.addEventListener('click',async()=>{try{await navigator.clipboard.writeText(getText());btn.textContent='Copied';btn.classList.add('copied');setTimeout(()=>{btn.textContent='Copy';btn.classList.remove('copied')},1400)}catch{btn.textContent='Failed';setTimeout(()=>{btn.textContent='Copy'},1400)}});target.appendChild(btn)}
+document.querySelectorAll('.doc pre').forEach(pre=>attachCopy(pre,()=>pre.querySelector('code')?.textContent??''));
+document.querySelectorAll('.home-install').forEach(el=>attachCopy(el,()=>el.querySelector('code')?.textContent??''));
+const tocLinks=document.querySelectorAll('.toc a');
+if(tocLinks.length){const map=new Map();tocLinks.forEach(a=>{const id=a.getAttribute('href').slice(1);const el=document.getElementById(id);if(el)map.set(el,a)});const setActive=l=>{tocLinks.forEach(x=>x.classList.remove('active'));l.classList.add('active')};const obs=new IntersectionObserver(entries=>{const visible=entries.filter(e=>e.isIntersecting).sort((a,b)=>a.boundingClientRect.top-b.boundingClientRect.top);if(visible.length){const link=map.get(visible[0].target);if(link)setActive(link)}},{rootMargin:'-15% 0px -65% 0px',threshold:0});map.forEach((_,el)=>obs.observe(el))}
+`;
+}
+
+export function preThemeScript() {
+	return `(function(){var s;try{s=localStorage.getItem('theme')}catch(e){}var d=window.matchMedia&&matchMedia('(prefers-color-scheme: dark)').matches;document.documentElement.dataset.theme=s||(d?'dark':'light')})();`;
+}
+
+export function themeToggleHtml() {
+	return `<button class="theme-toggle" type="button" aria-label="Toggle dark mode" aria-pressed="false" data-theme-toggle>
+    <svg class="theme-icon-moon" viewBox="0 0 20 20" aria-hidden="true"><path d="M14.6 12.1A6.5 6.5 0 0 1 7.4 2.7a6.5 6.5 0 1 0 7.2 9.4z" fill="currentColor"/></svg>
+    <svg class="theme-icon-sun" viewBox="0 0 20 20" aria-hidden="true"><circle cx="10" cy="10" r="3.4" fill="currentColor"/><g stroke="currentColor" stroke-width="1.6" stroke-linecap="round"><line x1="10" y1="2" x2="10" y2="4"/><line x1="10" y1="16" x2="10" y2="18"/><line x1="2" y1="10" x2="4" y2="10"/><line x1="16" y1="10" x2="18" y2="10"/><line x1="4.2" y1="4.2" x2="5.6" y2="5.6"/><line x1="14.4" y1="14.4" x2="15.8" y2="15.8"/><line x1="4.2" y1="15.8" x2="5.6" y2="14.4"/><line x1="14.4" y1="5.6" x2="15.8" y2="4.2"/></g></svg>
+  </button>`;
+}
+
+export function brandIconSvg() {
+	return `<svg viewBox="2 1 20 20" aria-hidden="true" xmlns="http://www.w3.org/2000/svg"><path fill="currentColor" d="M21.3 4.2c-.7.3-1.5.5-2.3.6.8-.5 1.5-1.3 1.8-2.2-.8.5-1.7.8-2.6 1A4.1 4.1 0 0 0 11.1 7c0 .3 0 .6.1.9A11.7 11.7 0 0 1 2.7 3.6c-.4.7-.6 1.5-.6 2.3 0 1.4.7 2.7 1.8 3.4-.7 0-1.3-.2-1.9-.5v.1c0 2 1.4 3.7 3.3 4.1-.4.1-.7.1-1.1.1-.3 0-.5 0-.8-.1.5 1.6 2 2.8 3.8 2.8a8.3 8.3 0 0 1-5.1 1.7c-.3 0-.7 0-1-.1A11.7 11.7 0 0 0 7.5 19c7.6 0 11.7-6.3 11.7-11.7v-.5c.8-.6 1.5-1.3 2.1-2.1z"/></svg>`;
+}
+
+export function featherSvg() {
+	return `<svg viewBox="0 0 200 200" aria-hidden="true" xmlns="http://www.w3.org/2000/svg"><path fill="currentColor" d="M163 22c-30 4-58 19-78 41C53 88 41 117 47 144l-21 21c-3 3-3 7 0 10s7 3 10 0l21-21c27 6 56-6 81-32 22-22 36-49 41-79 1-9-7-15-16-21zM84 130c-1 0-2 0-3-1-1-2-1-4 1-5l60-60c1-1 4-1 5 1 1 2 1 4-1 5l-60 60c-1 1-2 1-2 0z"/></svg>`;
+}
+
+export function faviconSvg() {
+	return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="birdclaw">
+<rect width="64" height="64" rx="14" fill="#1d9bf0"/>
+<path fill="#ffffff" d="M50 18c-2 1-4 1.5-6 1.7 2.2-1.3 3.8-3.4 4.6-5.8-2 1.2-4.3 2-6.6 2.5a10.4 10.4 0 0 0-17.7 9.5c-8.6-.4-16.2-4.5-21.3-10.8-3 5.2-1.5 12 3.6 15.4-1.7 0-3.3-.5-4.7-1.2v.1c0 5 3.6 9.3 8.4 10.3-1 .3-1.9.4-2.9.4-.7 0-1.4-.1-2.1-.2 1.4 4.2 5.3 7.2 10 7.3a20.9 20.9 0 0 1-13 4.4c-.8 0-1.7 0-2.6-.1A29.5 29.5 0 0 0 16 56c19.2 0 29.7-15.9 29.7-29.7v-1.4C48 23.4 50 21 50 18z"/>
+</svg>`;
+}

package/scripts/run-vitest.mjs

@@ -0,0 +1,21 @@
+import path from "node:path";
+import { spawn } from "node:child_process";
+import { withSanitizedNodeOptions } from "./sanitize-node-options.mjs";
+
+const cwd = process.cwd();
+const vitestBin = path.join(cwd, "node_modules", "vitest", "vitest.mjs");
+
+const child = spawn(process.execPath, [vitestBin, ...process.argv.slice(2)], {
+	cwd,
+	stdio: "inherit",
+	env: withSanitizedNodeOptions(process.env),
+});
+
+child.on("exit", (code, signal) => {
+	if (signal) {
+		process.kill(process.pid, signal);
+		return;
+	}
+
+	process.exit(code ?? 0);
+});

package/scripts/sanitize-node-options.mjs

@@ -0,0 +1,23 @@
+export function sanitizeNodeOptions(value) {
+	if (!value?.trim()) {
+		return undefined;
+	}
+
+	const sanitized = value
+		.split(/\s+/)
+		.filter((part) => part && !part.startsWith("--localstorage-file"))
+		.join(" ")
+		.trim();
+
+	return sanitized || undefined;
+}
+
+export function withSanitizedNodeOptions(env = process.env) {
+	const nodeOptions = sanitizeNodeOptions(env.NODE_OPTIONS);
+	return {
+		...env,
+		...(nodeOptions
+			? { NODE_OPTIONS: nodeOptions }
+			: { NODE_OPTIONS: undefined }),
+	};
+}

package/scripts/start-test-server.mjs

@@ -0,0 +1,42 @@
+import { rmSync } from "node:fs";
+import path from "node:path";
+import { spawn } from "node:child_process";
+import { withSanitizedNodeOptions } from "./sanitize-node-options.mjs";
+
+const cwd = process.cwd();
+const home = path.join(cwd, ".playwright-home");
+const port = process.env.BIRDCLAW_PLAYWRIGHT_PORT || "3000";
+const viteBin = path.join(cwd, "node_modules", "vite", "bin", "vite.js");
+const resolvedHome = path.resolve(home);
+const resolvedCwd = path.resolve(cwd);
+
+if (
+	!resolvedHome.startsWith(`${resolvedCwd}${path.sep}`) ||
+	path.basename(resolvedHome) !== ".playwright-home"
+) {
+	throw new Error(`Refusing to delete unsafe test home: ${resolvedHome}`);
+}
+
+rmSync(resolvedHome, { recursive: true, force: true });
+
+const child = spawn(
+	process.execPath,
+	[viteBin, "dev", "--port", port, "--host", "127.0.0.1"],
+	{
+		cwd,
+		stdio: "inherit",
+		env: {
+			...withSanitizedNodeOptions(process.env),
+			BIRDCLAW_HOME: resolvedHome,
+			BIRDCLAW_E2E: "1",
+			BIRDCLAW_E2E_FAKE_LIVE_WRITES: "1",
+			BIRDCLAW_DISABLE_LIVE_WRITES: "1",
+			BIRDCLAW_LOCAL_WEB: "1",
+			BIRDCLAW_WEB_TOKEN: "birdclaw-e2e-token",
+		},
+	},
+);
+
+child.on("exit", (code) => {
+	process.exit(code ?? 0);
+});