1 files changed, 36 insertions, 8 deletions
diff --git a/docs/prototypes/panel-widget-gallery.html b/docs/prototypes/panel-widget-gallery.html
index 87c23c5..fbf2e0a 100644
--- a/docs/prototypes/panel-widget-gallery.html
+++ b/docs/prototypes/panel-widget-gallery.html
@@ -54,6 +54,21 @@ h1{color:var(--gold);font-size:1.5rem;margin:.35rem 0 .4rem}
 .masthead p b{color:var(--silver)}
 .szbar{display:flex;align-items:center;gap:8px;margin-top:.8rem}
 .szbar .lab{color:var(--steel);font-size:.68rem;letter-spacing:.22em;text-transform:uppercase;margin-right:4px}
+
+/* masthead row: description left, index panel right */
+.mastrow{display:flex;gap:28px;align-items:flex-start;justify-content:space-between;flex-wrap:wrap}
+.toc{position:relative;flex:0 0 auto;min-width:220px;padding:14px 20px 13px;border-radius:12px;
+  background:linear-gradient(180deg,var(--raise),var(--panel));border:1px solid #262320;
+  box-shadow:inset 0 1px 0 rgba(255,255,255,.05),0 6px 14px rgba(0,0,0,.4)}
+.toc .tt{color:var(--steel);font-size:.66rem;letter-spacing:.26em;text-transform:uppercase;
+  margin-bottom:7px;display:flex;align-items:center;gap:10px}
+.toc .tt::after{content:"";height:1px;background:var(--wash);flex:1;min-width:24px}
+.toc a{display:block;color:var(--dim);text-decoration:none;font-size:.8rem;letter-spacing:.04em;padding:3.5px 0}
+.toc a::before{content:"▸ ";color:var(--steel);font-size:.72em}
+.toc a:hover{color:var(--gold-hi)}
+.toc .scr{position:absolute;width:5px;height:5px;border-radius:50%;
+  background:radial-gradient(circle at 35% 30%,#524d43,#161310);box-shadow:0 .5px 0 rgba(255,255,255,.08)}
+html{scroll-behavior:smooth}
 /* size toggle scales the widget stage only; card text stays at its own (slightly raised) size */
 body[data-size="2"] .stagew{zoom:1.7}
 body[data-size="3"] .stagew{zoom:2.4}
@@ -621,6 +636,8 @@ h2::after{content:"";height:1px;background:var(--wash);flex:1}
 <header class="masthead">
   <div class="eyebrow">archsetup · dupre panel family · live kit</div>
   <h1>Widget gallery — the instrument-console kit, fully driveable</h1>
+  <div class="mastrow">
+  <div>
   <p>Every control + display idiom in the dupre faceplate language, merged into one live console — the base kit,
      the candidate batch, and the growing reference batch (R: modeled on period hardware), all rendering from
      the same tokens the net / bt / sound panels use.
@@ -628,23 +645,34 @@ h2::after{content:"";height:1px;background:var(--wash);flex:1}
      readouts</b> show state or a number. Every widget is operable: drag the faders, knobs and gauges; click the
      switches, keys and lamps. Each card carries a live readout that tracks what you do. The trace displays run
      a live signal; the pointer types drive from your drag.</p>
-  <div class="szbar"><span class="lab">widget size</span>
-    <button class="key" data-sz="1">S</button>
-    <button class="key on" data-sz="2">M</button>
-    <button class="key" data-sz="3">L</button>
+    <div class="szbar"><span class="lab">widget size</span>
+      <button class="key" data-sz="1">S</button>
+      <button class="key on" data-sz="2">M</button>
+      <button class="key" data-sz="3">L</button>
+    </div>
+  </div>
+  <nav class="toc">
+    <span class="scr" style="top:6px;left:6px"></span><span class="scr" style="top:6px;right:6px"></span>
+    <span class="scr" style="bottom:6px;left:6px"></span><span class="scr" style="bottom:6px;right:6px"></span>
+    <div class="tt">Index</div>
+    <a href="#sec-controls">Controls</a>
+    <a href="#sec-meters">Meters &amp; gauges</a>
+    <a href="#sec-indicators">Indicators &amp; readouts</a>
+    <a href="#sec-palette">Palette</a>
+  </nav>
   </div>
 </header>
 
-<h2>Controls — take input</h2>
+<h2 id="sec-controls">Controls — take input</h2>
 <div class="grid" id="controls"></div>
 
-<h2>Meters &amp; gauges — live analog value</h2>
+<h2 id="sec-meters">Meters &amp; gauges — live analog value</h2>
 <div class="grid" id="meters"></div>
 
-<h2>Indicators &amp; readouts — state or number</h2>
+<h2 id="sec-indicators">Indicators &amp; readouts — state or number</h2>
 <div class="grid" id="indicators"></div>
 
-<h2>Palette — the instrument colors</h2>
+<h2 id="sec-palette">Palette — the instrument colors</h2>
 <p class="secnote">Every named color the instruments are built from — markers, hands, faces, lamps, phosphors,
    materials — with where it appears. Page chrome (background, body text) is deliberately absent.</p>
 <div class="palgrid" id="palette"></div>