base site: claude design plus some tweaks

3 files changed, 447 insertions, 0 deletions

diff --git a/_shared/components.css b/_shared/components.css
new file mode 100644
index 0000000..2b50d99
--- /dev/null
+++ b/_shared/components.css
@@ -0,0 +1,160 @@
+/* ============================================================
+   panto docs — static component styles.
+   Extracted from the Pantograph design system's React components
+   (Badge, Tag, Terminal, CodeBlock, Callout) so the docs render
+   identically as plain HTML, with no JavaScript and no React.
+   These mirror the styles those components inject at runtime.
+   ============================================================ */
+
+/* ---- Badge ----------------------------------------------------------- */
+.pg-badge {
+  display: inline-flex; align-items: center; gap: 5px;
+  font-family: var(--font-display); font-weight: var(--weight-semibold);
+  font-size: var(--text-2xs); letter-spacing: var(--tracking-label);
+  text-transform: uppercase; line-height: 1; white-space: nowrap;
+  padding: 4px 7px; border-radius: var(--radius-xs);
+  border: var(--border-thin) solid transparent;
+}
+.pg-badge__dot { width: 6px; height: 6px; border-radius: var(--radius-pill); background: currentColor; }
+.pg-badge--neutral { color: var(--ink-2); background: var(--paper-2); border-color: var(--paper-3); }
+.pg-badge--danger  { color: var(--red-deep); background: var(--red-wash); border-color: var(--red-soft); }
+.pg-badge--success { color: var(--green-deep); background: var(--green-wash); border-color: var(--green-soft); }
+.pg-badge--ink     { color: var(--paper-0); background: var(--ink-1); border-color: var(--ink-1); }
+.pg-badge--outline { color: var(--ink-2); background: transparent; border-color: var(--border-default); }
+
+/* ---- Tag ------------------------------------------------------------- */
+.pg-tag {
+  display: inline-flex; align-items: center; gap: 6px;
+  font-family: var(--font-mono); font-weight: var(--weight-medium);
+  font-size: var(--text-xs); line-height: 1; white-space: nowrap;
+  color: var(--ink-1); background: var(--paper-0);
+  padding: 5px 9px; border-radius: var(--radius-pill);
+  border: var(--border-thin) solid var(--border-default);
+}
+.pg-tag__dot { width: 7px; height: 7px; border-radius: var(--radius-pill); flex: none; background: var(--ink-3); }
+
+/* ---- Callout (admonition) -------------------------------------------- */
+.pg-callout {
+  display: flex; gap: 12px;
+  padding: 13px 15px;
+  background: var(--paper-0);
+  border: var(--border-thin) solid var(--border-hairline);
+  border-left: var(--border-thick) solid var(--ink-3);
+  border-radius: var(--radius-sm);
+}
+.pg-callout__icon { flex: none; width: 18px; height: 18px; margin-top: 1px; color: var(--ink-3); }
+.pg-callout__icon svg { width: 100%; height: 100%; }
+.pg-callout__body { font: var(--weight-regular) var(--text-sm)/1.55 var(--font-sans); color: var(--ink-1); }
+.pg-callout__title {
+  font: var(--weight-semibold) var(--text-2xs)/1 var(--font-display);
+  letter-spacing: var(--tracking-label); text-transform: uppercase;
+  margin: 0 0 5px; color: var(--ink-2);
+}
+.pg-callout__body p { margin: 0 0 var(--space-2); }
+.pg-callout__body :last-child { margin-bottom: 0; }
+.pg-callout--note    { border-left-color: var(--ink-3); }
+.pg-callout--tip     { border-left-color: var(--green); background: var(--green-wash); }
+.pg-callout--tip .pg-callout__icon, .pg-callout--tip .pg-callout__title { color: var(--green-deep); }
+.pg-callout--warn    { border-left-color: var(--brass); background: #F0E7D0; }
+.pg-callout--warn .pg-callout__icon, .pg-callout--warn .pg-callout__title { color: #7A5E20; }
+.pg-callout--danger  { border-left-color: var(--red); background: var(--red-wash); }
+.pg-callout--danger .pg-callout__icon, .pg-callout--danger .pg-callout__title { color: var(--red-deep); }
+
+/* ---- CodeBlock ------------------------------------------------------- */
+.pg-code {
+  background: var(--surface-code);
+  border: var(--border-thin) solid var(--border-default);
+  border-radius: var(--radius-md);
+  overflow: hidden;
+  font-family: var(--font-mono);
+}
+.pg-code__bar {
+  display: flex; align-items: center; gap: 10px;
+  padding: 8px 12px; background: var(--paper-2);
+  border-bottom: var(--border-thin) solid var(--border-hairline);
+}
+.pg-code__name { font: var(--weight-medium) var(--text-xs)/1 var(--font-mono); color: var(--ink-2); }
+.pg-code__lang {
+  font: var(--weight-semibold) var(--text-2xs)/1 var(--font-display);
+  letter-spacing: var(--tracking-label); text-transform: uppercase; color: var(--ink-3);
+  margin-left: auto; padding-right: 4px;
+}
+.pg-code__copy {
+  display: inline-flex; align-items: center; gap: 5px;
+  font: var(--weight-medium) var(--text-2xs)/1 var(--font-display);
+  letter-spacing: 0.1em; text-transform: uppercase;
+  color: var(--ink-3); background: none; border: 0; cursor: pointer;
+  padding: 4px 6px; border-radius: var(--radius-xs);
+  transition: color var(--dur-fast) var(--ease-out), background var(--dur-fast) var(--ease-out);
+}
+.pg-code__copy:hover { color: var(--ink-0); background: var(--paper-1); }
+.pg-code__copy--done { color: var(--green-deep); }
+.pg-code__copy svg { width: 13px; height: 13px; }
+.pg-code__copy .pg-code__check { display: none; }
+.pg-code__copy--done .pg-code__check { display: inline; }
+.pg-code__copy--done .pg-code__copyglyph { display: none; }
+.pg-code__scroll { overflow-x: auto; padding: 14px 16px; }
+.pg-code pre { font-size: var(--text-sm); line-height: var(--leading-mono); color: var(--ink-1); margin: 0; }
+.pg-code code { font-family: inherit; background: none; border: 0; padding: 0; color: inherit; }
+/* token colors for hand-marked spans */
+.pg-code .tok-kw { color: var(--green-deep); }
+.pg-code .tok-str { color: var(--red-deep); }
+.pg-code .tok-com { color: var(--ink-4); font-style: italic; }
+.pg-code .tok-fn { color: var(--ink-0); font-weight: 500; }
+.pg-code .tok-num { color: var(--brass); }
+
+/* ---- Terminal -------------------------------------------------------- */
+.pg-term {
+  background: var(--ink-1);
+  border: var(--border-thin) solid var(--ink-0);
+  border-radius: var(--radius-md);
+  overflow: hidden;
+  box-shadow: var(--shadow-md);
+  font-family: var(--font-mono);
+}
+.pg-term__bar {
+  display: flex; align-items: center; gap: 8px;
+  padding: 9px 12px; background: #232B3B;
+  border-bottom: var(--border-thin) solid #2E3749;
+}
+.pg-term__dot { width: 9px; height: 9px; border-radius: var(--radius-pill); }
+.pg-term__title {
+  margin-left: 6px;
+  font: var(--weight-semibold) var(--text-2xs)/1 var(--font-display);
+  letter-spacing: var(--tracking-label); text-transform: uppercase; color: var(--paper-4);
+}
+.pg-term__body { padding: 14px 16px; overflow-x: auto; font-size: var(--text-sm); line-height: 1.65; }
+.pg-term__line { white-space: pre; color: var(--paper-2); }
+.pg-term__line .pg-term__prompt { color: var(--green-soft); user-select: none; }
+.pg-term__line .pg-term__panto { color: var(--red-soft); user-select: none; }
+.pg-term__line--cmd { color: var(--paper-0); }
+.pg-term__line--out { color: var(--paper-4); }
+.pg-term__line--ok { color: var(--green-soft); }
+.pg-term__line--err { color: var(--red-soft); }
+.pg-term__line--com { color: #6E7689; font-style: italic; }
+.pg-term__cursor {
+  display: inline-block; width: 8px; height: 1.05em; vertical-align: text-bottom;
+  background: var(--red); margin-left: 2px;
+  animation: pg-term-blink 1.1s steps(1) infinite;
+}
+@keyframes pg-term-blink { 50% { opacity: 0; } }
+@media (prefers-reduced-motion: reduce) { .pg-term__cursor { animation: none; } }
+/* panto TUI mock: welcome banner, user block, tool boxes, footer, input frame */
+.pg-term__line--accent { color: var(--red-soft); }
+.pg-term__line--dim { color: #6E7689; }
+.pg-term__user {
+  white-space: pre-wrap; color: var(--paper-0);
+  background: rgba(178,58,46,0.16); padding: 5px 10px; margin: 3px 0;
+}
+.pg-term__tool { margin: 3px 0; }
+.pg-term__tool-head { white-space: pre; color: var(--paper-0); padding-left: 1ch; }
+.pg-term__tool-body {
+  white-space: pre; color: var(--paper-4);
+  padding: 3px 0 0 calc(1ch + 8px); margin-left: 1ch;
+  border-left: 2px solid #2E3749;
+}
+.pg-term__add { color: var(--green-soft); }
+.pg-term__del { color: var(--red-soft); }
+.pg-term .pg-term__rule { border: 0; border-top: 1px solid #2E3749; margin: 7px 0; }
+.pg-term code { background: none; border: 0; padding: 0; color: var(--green-soft); font: inherit; }
+.pg-term__user code { color: inherit; }
diff --git a/_shared/docs.css b/_shared/docs.css
new file mode 100644
index 0000000..bfa1e44
--- /dev/null
+++ b/_shared/docs.css
@@ -0,0 +1,202 @@
+/* ============================================================
+   panto docs — shared documentation chrome.
+   Built on the Pantograph design system tokens. Class prefix: pd-
+   ============================================================ */
+
+body { margin: 0; background: var(--surface-page); }
+html { scroll-behavior: smooth; }
+@media (prefers-reduced-motion: reduce) { html { scroll-behavior: auto; } }
+
+.pd-app { min-height: 100vh; }
+
+/* ---- Header ---------------------------------------------------------- */
+.pd-header {
+  position: sticky; top: 0; z-index: 30;
+  display: flex; align-items: center; gap: var(--space-5);
+  height: 60px; padding: 0 var(--space-6);
+  background: color-mix(in srgb, var(--paper-1) 88%, transparent);
+  backdrop-filter: blur(8px);
+  border-bottom: var(--border-thin) solid var(--border-hairline);
+}
+.pd-header__left { display: flex; align-items: center; gap: var(--space-3); }
+.pd-menu { display: none; background: none; border: 0; cursor: pointer; color: var(--ink-2); font-size: 20px; padding: 4px; }
+.pd-brand { display: flex; align-items: center; gap: 9px; text-decoration: none; }
+.pd-brand:hover { text-decoration: none; }
+.pd-brand__word { font: 700 20px var(--font-display); letter-spacing: -0.01em; color: var(--ink-0); }
+.pd-brand__div { color: var(--paper-4); font: 400 18px var(--font-display); }
+.pd-brand__sub { font: 600 18px var(--font-display); color: var(--ink-3); }
+.pd-nav { display: flex; gap: 2px; margin-left: var(--space-4); }
+.pd-nav__link {
+  font: 500 var(--text-sm)/1 var(--font-sans); color: var(--ink-3);
+  padding: 8px 11px; border-radius: var(--radius-xs); text-decoration: none;
+  transition: color var(--dur-fast), background var(--dur-fast);
+}
+.pd-nav__link:hover { color: var(--ink-1); background: var(--paper-2); text-decoration: none; }
+.pd-nav__link--active { color: var(--ink-0); font-weight: 600; }
+.pd-header__right { display: flex; align-items: center; gap: var(--space-3); margin-left: auto; }
+.pd-ghlink { display: inline-flex; align-items: center; gap: 7px; font: 500 var(--text-sm) var(--font-mono); color: var(--ink-2); text-decoration: none; }
+.pd-ghlink:hover { color: var(--ink-0); text-decoration: none; }
+.pd-ghlink svg { font-size: 16px; }
+
+/* ---- Shell grid ------------------------------------------------------ */
+.pd-shell {
+  display: grid;
+  grid-template-columns: var(--sidebar-width) minmax(0, 1fr) 220px;
+  max-width: 1340px; margin: 0 auto;
+  align-items: start;
+}
+.pd-sidebar {
+  position: sticky; top: 60px; align-self: start;
+  height: calc(100vh - 60px); overflow: hidden;
+  border-right: var(--border-thin) solid var(--border-hairline);
+}
+.pd-sidebar__scroll { height: 100%; overflow-y: auto; padding: var(--space-5) var(--space-4) var(--space-8); }
+.pd-navsec { margin-bottom: var(--space-5); }
+.pd-navsec__title {
+  display: flex; align-items: center; gap: 7px;
+  font: 600 var(--text-2xs) var(--font-display); letter-spacing: var(--tracking-label);
+  text-transform: uppercase; color: var(--ink-4); margin: 0 0 var(--space-2); padding-left: 10px;
+}
+.pd-navsec__title svg { font-size: 13px; }
+.pd-navsec--current .pd-navsec__title { color: var(--red-deep); }
+.pd-navsec__list { list-style: none; margin: 0; padding: 0; }
+.pd-navsec__link {
+  display: block; font: 400 var(--text-sm)/1.2 var(--font-sans); color: var(--ink-2);
+  text-decoration: none; padding: 7px 10px; border-radius: var(--radius-xs);
+  border-left: 2px solid transparent; transition: color var(--dur-fast), background var(--dur-fast), border-color var(--dur-fast);
+}
+.pd-navsec__link:hover { color: var(--ink-0); background: var(--paper-2); text-decoration: none; }
+.pd-navsec__link--active {
+  color: var(--red-deep); font-weight: 600; background: var(--paper-0);
+  border-left-color: var(--red);
+}
+.pd-navsec__link code { background: none; border: 0; padding: 0; color: inherit; font-size: 0.92em; }
+
+/* ---- Main ------------------------------------------------------------ */
+.pd-main { padding: var(--space-6) var(--space-7) var(--space-9); min-width: 0; }
+.pd-doc { max-width: 800px; }
+.pd-eyebrow { display: block; margin-bottom: var(--space-2); }
+.pd-doc__h1 { font: 700 var(--text-3xl) var(--font-display); color: var(--ink-0); letter-spacing: -0.01em; margin: 0 0 var(--space-4); }
+.pd-doc__meta { display: flex; flex-wrap: wrap; align-items: center; gap: var(--space-2); margin-bottom: var(--space-5); }
+.pd-lead { font: 400 var(--text-md)/1.6 var(--font-serif); color: var(--ink-1); margin: 0 0 var(--space-6); max-width: 66ch; }
+
+.pd-h2 {
+  font: 600 var(--text-xl) var(--font-sans); color: var(--ink-0);
+  margin: var(--space-8) 0 var(--space-4); padding-bottom: var(--space-2);
+  border-bottom: var(--border-thin) solid var(--border-hairline);
+  scroll-margin-top: 76px;
+}
+.pd-h3 { font: 600 var(--text-lg) var(--font-sans); color: var(--ink-0); margin: var(--space-6) 0 var(--space-3); scroll-margin-top: 76px; }
+.pd-body { font: 400 var(--text-base)/1.65 var(--font-sans); color: var(--ink-1); max-width: 66ch; }
+.pd-body + .pd-body { margin-top: var(--space-4); }
+.pd-doc a { text-decoration-thickness: 1px; }
+.pd-doc > .pg-callout, .pd-doc .pd-callout { margin: var(--space-5) 0; }
+.pd-doc .pg-code, .pd-doc .pg-term { margin: var(--space-4) 0; max-width: 800px; }
+.pd-section { margin-bottom: var(--space-2); }
+
+/* ---- Command signature header --------------------------------------- */
+.pd-cmd {
+  display: flex; flex-wrap: wrap; align-items: baseline; gap: var(--space-3);
+  margin: var(--space-6) 0 var(--space-2); scroll-margin-top: 76px;
+}
+.pd-cmd__sig {
+  font: 600 var(--text-md) var(--font-mono); color: var(--ink-0);
+  background: var(--surface-code); border: var(--border-thin) solid var(--border-default);
+  border-radius: var(--radius-sm); padding: 5px 10px;
+}
+.pd-cmd__sig .opt { color: var(--ink-3); }
+.pd-cmd__note { font: 400 var(--text-sm) var(--font-sans); color: var(--ink-3); }
+
+/* ---- Option / parameter list ---------------------------------------- */
+.pd-opts { display: flex; flex-direction: column; gap: 0; margin: var(--space-4) 0; border-top: var(--border-thin) solid var(--border-hairline); }
+.pd-opt {
+  display: grid; grid-template-columns: minmax(160px, 240px) 1fr; gap: var(--space-4);
+  padding: var(--space-4) var(--space-2); border-bottom: var(--border-thin) solid var(--border-hairline);
+}
+.pd-opt__key { display: flex; flex-direction: column; gap: 6px; align-items: flex-start; }
+.pd-opt__name { font: 500 var(--text-sm) var(--font-mono); color: var(--ink-0); }
+.pd-opt__type { font: 400 var(--text-xs) var(--font-mono); color: var(--green-deep); }
+.pd-opt__desc { font: 400 var(--text-sm)/1.6 var(--font-sans); color: var(--ink-1); }
+.pd-opt__desc code { font-size: 0.9em; }
+.pd-opt__desc p { margin: 0 0 var(--space-2); }
+.pd-opt__desc p:last-child { margin: 0; }
+@media (max-width: 640px) { .pd-opt { grid-template-columns: 1fr; gap: var(--space-2); } }
+
+/* ---- Table ----------------------------------------------------------- */
+.pd-table-wrap { border: var(--border-thin) solid var(--border-hairline); border-radius: var(--radius-md); overflow: hidden; margin: var(--space-4) 0; }
+.pd-table { width: 100%; border-collapse: collapse; font: 400 var(--text-sm) var(--font-sans); }
+.pd-table th {
+  text-align: left; font: 600 var(--text-2xs) var(--font-display); letter-spacing: var(--tracking-label);
+  text-transform: uppercase; color: var(--ink-3); background: var(--paper-2);
+  padding: 10px 14px; border-bottom: var(--border-thin) solid var(--border-hairline);
+}
+.pd-table td { padding: 11px 14px; border-bottom: var(--border-thin) solid var(--paper-2); color: var(--ink-1); vertical-align: top; }
+.pd-table tr:last-child td { border-bottom: 0; }
+.pd-table tr:nth-child(even) td { background: color-mix(in srgb, var(--paper-2) 40%, transparent); }
+.pd-table td code { font-size: 0.9em; }
+.pd-table .mono { font-family: var(--font-mono); }
+.pd-table .t-type { font: 400 var(--text-xs) var(--font-mono); color: var(--green-deep); }
+.pd-table .t-def { font: 400 var(--text-xs) var(--font-mono); color: var(--ink-3); }
+
+/* ---- Keycaps --------------------------------------------------------- */
+.pd-kbd {
+  display: inline-flex; align-items: center; gap: 4px;
+  font: 600 var(--text-xs) var(--font-mono); color: var(--ink-1);
+  background: var(--paper-0); border: var(--border-thin) solid var(--paper-4);
+  border-bottom-width: 2px; border-radius: var(--radius-sm);
+  padding: 3px 7px; white-space: nowrap;
+}
+.pd-keytable .pd-kbd { font-size: var(--text-sm); }
+
+/* ---- Inline tick rule ------------------------------------------------ */
+.pd-rule { margin: var(--space-7) 0; }
+
+/* ---- TOC ------------------------------------------------------------- */
+.pd-toc { position: sticky; top: 60px; padding: var(--space-6) var(--space-4); align-self: start; max-height: calc(100vh - 60px); overflow-y: auto; }
+.pd-toc__title { font: 600 var(--text-2xs) var(--font-display); letter-spacing: var(--tracking-label); text-transform: uppercase; color: var(--ink-4); margin: 0 0 var(--space-3); }
+.pd-toc__list { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 2px; }
+.pd-toc__link { display: block; font: 400 var(--text-sm)/1.3 var(--font-sans); color: var(--ink-3); text-decoration: none; padding: 5px 10px; border-left: 2px solid var(--paper-3); transition: color var(--dur-fast), border-color var(--dur-fast); }
+.pd-toc__link:hover { color: var(--ink-0); border-left-color: var(--ink-3); text-decoration: none; }
+.pd-toc__link--active { color: var(--red-deep); border-left-color: var(--red); font-weight: 600; }
+
+/* ---- Prev / next footer --------------------------------------------- */
+.pd-prevnext {
+  display: flex; gap: var(--space-4); margin-top: var(--space-8);
+  padding-top: var(--space-5); border-top: var(--border-thin) solid var(--border-hairline);
+}
+.pd-pn {
+  flex: 1; display: flex; flex-direction: column; gap: 4px; text-decoration: none;
+  padding: var(--space-4); border: var(--border-thin) solid var(--border-hairline);
+  border-radius: var(--radius-md); background: var(--surface-card); box-shadow: var(--shadow-xs);
+  transition: box-shadow var(--dur-fast), border-color var(--dur-fast);
+}
+.pd-pn:hover { box-shadow: var(--shadow-sm); border-color: var(--border-default); text-decoration: none; }
+.pd-pn--next { text-align: right; }
+.pd-pn__dir { font: 600 var(--text-2xs) var(--font-display); letter-spacing: var(--tracking-label); text-transform: uppercase; color: var(--ink-4); }
+.pd-pn__title { font: 600 var(--text-base) var(--font-sans); color: var(--ink-0); }
+
+/* ---- Footnote / source line ----------------------------------------- */
+.pd-srcnote { font: 400 var(--text-xs)/1.6 var(--font-sans); color: var(--ink-3); margin-top: var(--space-6); }
+.pd-srcnote code { font-size: 0.92em; }
+
+.pd-scrim { display: none; position: fixed; inset: 60px 0 0; z-index: 35; background: rgba(22,27,39,0.28); }
+
+/* ---- Responsive ------------------------------------------------------ */
+@media (max-width: 1120px) {
+  .pd-shell { grid-template-columns: var(--sidebar-width) minmax(0, 1fr); }
+  .pd-toc { display: none; }
+}
+@media (max-width: 860px) {
+  .pd-shell { grid-template-columns: minmax(0, 1fr); }
+  .pd-nav { display: none; }
+  .pd-menu { display: inline-flex; }
+  .pd-sidebar {
+    position: fixed; top: 60px; left: 0; z-index: 40; width: var(--sidebar-width);
+    background: var(--paper-1); transform: translateX(-105%);
+    transition: transform var(--dur-base) var(--ease-slide);
+  }
+  .pd-sidebar--open { transform: translateX(0); box-shadow: var(--shadow-lg); }
+  .pd-sidebar--open ~ .pd-scrim { display: block; }
+  .pd-main { padding: var(--space-5) var(--space-5) var(--space-8); }
+  .pd-prevnext { flex-direction: column; }
+}
diff --git a/_shared/docs.js b/_shared/docs.js
new file mode 100644
index 0000000..7e07310
--- /dev/null
+++ b/_shared/docs.js
@@ -0,0 +1,85 @@
+/* panto docs — progressive enhancement only.
+   The site is fully functional with this file absent or JS disabled:
+   every nav item is a real link, all content is in the HTML. This adds
+   the mobile sidebar toggle, code copy buttons, and TOC scroll-spy. */
+(function () {
+  'use strict';
+
+  /* ---- Mobile sidebar toggle ---------------------------------------- */
+  var menuBtn = document.querySelector('[data-menu-toggle]');
+  var sidebar = document.querySelector('.pd-sidebar');
+  var scrim = document.querySelector('.pd-scrim');
+  function closeMenu() {
+    if (sidebar) sidebar.classList.remove('pd-sidebar--open');
+  }
+  if (menuBtn && sidebar) {
+    menuBtn.addEventListener('click', function () {
+      sidebar.classList.toggle('pd-sidebar--open');
+    });
+  }
+  if (scrim) scrim.addEventListener('click', closeMenu);
+  if (sidebar) {
+    sidebar.addEventListener('click', function (e) {
+      if (e.target.closest('a')) closeMenu();
+    });
+  }
+
+  /* ---- Code copy buttons -------------------------------------------- */
+  document.querySelectorAll('.pg-code__copy').forEach(function (btn) {
+    btn.addEventListener('click', function () {
+      var block = btn.closest('.pg-code');
+      var pre = block && block.querySelector('pre');
+      if (!pre) return;
+      var text = pre.innerText;
+      var done = function () {
+        btn.classList.add('pg-code__copy--done');
+        var label = btn.querySelector('.pg-code__label');
+        if (label) label.textContent = 'Copied';
+        setTimeout(function () {
+          btn.classList.remove('pg-code__copy--done');
+          if (label) label.textContent = 'Copy';
+        }, 1400);
+      };
+      if (navigator.clipboard) navigator.clipboard.writeText(text).then(done, done);
+      else done();
+    });
+  });
+
+  /* ---- Scroll-spy: highlight the active section in TOC + sidebar ---- */
+  var tocLinks = Array.prototype.slice.call(document.querySelectorAll('.pd-toc__link'));
+  var sideLinks = Array.prototype.slice.call(
+    document.querySelectorAll('.pd-navsec--current .pd-navsec__link')
+  );
+  if (!tocLinks.length || !('IntersectionObserver' in window)) return;
+
+  var ids = tocLinks.map(function (a) {
+    var href = a.getAttribute('href') || '';
+    return href.charAt(0) === '#' ? href.slice(1) : href.split('#')[1];
+  }).filter(Boolean);
+
+  function setActive(id) {
+    tocLinks.forEach(function (a) {
+      var h = a.getAttribute('href') || '';
+      a.classList.toggle('pd-toc__link--active', h === '#' + id);
+    });
+    sideLinks.forEach(function (a) {
+      var h = a.getAttribute('href') || '';
+      a.classList.toggle('pd-navsec__link--active', h.split('#')[1] === id);
+    });
+  }
+
+  var visible = new Set();
+  var obs = new IntersectionObserver(function (entries) {
+    entries.forEach(function (e) {
+      if (e.isIntersecting) visible.add(e.target.id);
+      else visible.delete(e.target.id);
+    });
+    var first = ids.find(function (id) { return visible.has(id); });
+    if (first) setActive(first);
+  }, { rootMargin: '-72px 0px -68% 0px', threshold: 0 });
+
+  ids.forEach(function (id) {
+    var el = document.getElementById(id);
+    if (el) obs.observe(el);
+  });
+})();