/* ============================================================================
   ATM documentation - stylesheet
   "The Amber Workshop": warm amber on warm stone, built like an instrument manual.
   Palette is the committed ATM brand; type is Bricolage Grotesque
   (display) + Hanken Grotesk (body) + Roboto Mono (code).
   ========================================================================== */

/* ----------------------------------------------------------------------------
   1. Design tokens
   -------------------------------------------------------------------------- */
:root {
  /* surfaces */
  --bg:            #fdf6ec;
  --surface:       #ffffff;
  --surface-2:     #faf7f2;
  --surface-3:     #f4eede;
  --sidebar-bg:    #fbf5ea;

  /* ink */
  --ink:           #1c1917;
  --ink-2:         #57534e;   /* muted body text, 7:1 on cream */
  --ink-3:         #78716c;   /* labels / decoration only */

  /* amber accent */
  --accent:        #d97706;
  --accent-deep:   #b45309;   /* inline links / text, 4.7:1 on cream */
  --accent-hover:  #9a4a08;
  --accent-tint:   #fef3c7;
  --accent-wash:   rgba(217, 119, 6, 0.08);

  /* lines */
  --border:        #e7e5e4;
  --border-strong: #d6d3d1;
  --divider:       #f0ebe1;

  /* signals */
  --success:       #15803d;  --success-bg: rgba(22, 163, 74, 0.12);
  --error:         #b91c1c;  --error-bg:   rgba(220, 38, 38, 0.10);
  --info:          #1d4ed8;  --info-bg:    rgba(37, 99, 235, 0.09);
  --warn:          #b45309;  --warn-bg:    rgba(217, 119, 6, 0.12);

  /* permission states (color is never the sole signal; labels always accompany) */
  --st-grey:   #78716c;  --st-grey-bg:   rgba(120, 113, 108, 0.14);
  --st-yellow: #a16207;  --st-yellow-bg: rgba(202, 138, 4, 0.16);
  --st-green:  #15803d;  --st-green-bg:  rgba(22, 163, 74, 0.14);
  --st-red:    #b91c1c;  --st-red-bg:    rgba(220, 38, 38, 0.12);

  /* deep warm "oak" for the drenched hero */
  --oak:         #2a1a0b;
  --oak-2:       #3a2611;
  --oak-ink:     #fdf3e3;
  --oak-ink-2:   #d9c3a3;

  /* elevation - warm-tinted in light mode */
  --shadow-sm: 0 1px 3px rgba(120, 80, 0, 0.08), 0 1px 2px rgba(120, 80, 0, 0.05);
  --shadow-md: 0 6px 22px rgba(120, 80, 0, 0.10), 0 2px 6px rgba(120, 80, 0, 0.06);
  --shadow-lg: 0 18px 50px rgba(90, 55, 0, 0.18);
  --ring:      0 0 0 3px rgba(217, 119, 6, 0.30);

  /* geometry */
  --radius-xs: 6px;
  --radius-sm: 9px;
  --radius:    13px;
  --radius-lg: 20px;

  /* type */
  --font-display: "Bricolage Grotesque", "Hanken Grotesk", system-ui, sans-serif;
  --font-body:    "Hanken Grotesk", system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
  --font-mono:    "Roboto Mono", ui-monospace, SFMono-Regular, Menlo, monospace;

  --step--1: 0.875rem;
  --step-0:  1.0625rem;
  --step-1:  1.1875rem;
  --step-2:  clamp(1.4rem, 1.25rem + 0.6vw, 1.7rem);
  --step-3:  clamp(1.7rem, 1.45rem + 1.1vw, 2.2rem);
  --step-4:  clamp(2.1rem, 1.7rem + 1.9vw, 2.9rem);
  --step-5:  clamp(2.45rem, 1.7rem + 3.4vw, 4.3rem);

  /* layout metrics */
  --header-h: 60px;
  --sidebar-w: 270px;
  --toc-w: 220px;
  --reading: 70ch;

  --ease-out: cubic-bezier(0.22, 1, 0.36, 1);

  color-scheme: light;
}

/* dark - auto unless forced light */
@media (prefers-color-scheme: dark) {
  :root:not([data-theme="light"]) { color-scheme: dark; }
}
:root[data-theme="dark"] { color-scheme: dark; }

@media (prefers-color-scheme: dark) {
  :root:not([data-theme="light"]) {
    --bg:            #1c1917;
    --surface:       #292524;
    --surface-2:     #211f1d;
    --surface-3:     #322c25;
    --sidebar-bg:    #211d19;

    --ink:           #fafaf9;
    --ink-2:         #b3aaa1;
    --ink-3:         #8a8279;

    --accent:        #f59e0b;
    --accent-deep:   #fbbf24;
    --accent-hover:  #fcd34d;
    --accent-tint:   #3d2806;
    --accent-wash:   rgba(245, 158, 11, 0.12);

    --border:        #44403c;
    --border-strong: #57534e;
    --divider:       #312c27;

    --success:       #4ade80;  --success-bg: rgba(74, 222, 128, 0.14);
    --error:         #f87171;  --error-bg:   rgba(248, 113, 113, 0.14);
    --info:          #60a5fa;  --info-bg:    rgba(96, 165, 250, 0.14);
    --warn:          #fbbf24;  --warn-bg:    rgba(251, 191, 36, 0.14);

    --st-grey:   #a8a29e;  --st-grey-bg:   rgba(168, 162, 158, 0.16);
    --st-yellow: #eab308;  --st-yellow-bg: rgba(234, 179, 8, 0.16);
    --st-green:  #4ade80;  --st-green-bg:  rgba(74, 222, 128, 0.15);
    --st-red:    #f87171;  --st-red-bg:    rgba(248, 113, 113, 0.15);

    --oak:       #14100a;
    --oak-2:     #221912;
    --oak-ink:   #fdf3e3;
    --oak-ink-2: #cdb89a;

    --shadow-sm: 0 1px 3px rgba(0, 0, 0, 0.4), 0 1px 2px rgba(0, 0, 0, 0.3);
    --shadow-md: 0 6px 22px rgba(0, 0, 0, 0.5), 0 2px 6px rgba(0, 0, 0, 0.4);
    --shadow-lg: 0 18px 50px rgba(0, 0, 0, 0.6);
    --ring:      0 0 0 3px rgba(245, 158, 11, 0.40);
  }
}

/* dark - forced */
:root[data-theme="dark"] {
  --bg:            #1c1917;
  --surface:       #292524;
  --surface-2:     #211f1d;
  --surface-3:     #322c25;
  --sidebar-bg:    #211d19;

  --ink:           #fafaf9;
  --ink-2:         #b3aaa1;
  --ink-3:         #8a8279;

  --accent:        #f59e0b;
  --accent-deep:   #fbbf24;
  --accent-hover:  #fcd34d;
  --accent-tint:   #3d2806;
  --accent-wash:   rgba(245, 158, 11, 0.12);

  --border:        #44403c;
  --border-strong: #57534e;
  --divider:       #312c27;

  --success:       #4ade80;  --success-bg: rgba(74, 222, 128, 0.14);
  --error:         #f87171;  --error-bg:   rgba(248, 113, 113, 0.14);
  --info:          #60a5fa;  --info-bg:    rgba(96, 165, 250, 0.14);
  --warn:          #fbbf24;  --warn-bg:    rgba(251, 191, 36, 0.14);

  --st-grey:   #a8a29e;  --st-grey-bg:   rgba(168, 162, 158, 0.16);
  --st-yellow: #eab308;  --st-yellow-bg: rgba(234, 179, 8, 0.16);
  --st-green:  #4ade80;  --st-green-bg:  rgba(74, 222, 128, 0.15);
  --st-red:    #f87171;  --st-red-bg:    rgba(248, 113, 113, 0.15);

  --oak:       #14100a;
  --oak-2:     #221912;
  --oak-ink:   #fdf3e3;
  --oak-ink-2: #cdb89a;

  --shadow-sm: 0 1px 3px rgba(0, 0, 0, 0.4), 0 1px 2px rgba(0, 0, 0, 0.3);
  --shadow-md: 0 6px 22px rgba(0, 0, 0, 0.5), 0 2px 6px rgba(0, 0, 0, 0.4);
  --shadow-lg: 0 18px 50px rgba(0, 0, 0, 0.6);
  --ring:      0 0 0 3px rgba(245, 158, 11, 0.40);
}

/* ----------------------------------------------------------------------------
   2. Reset & base
   -------------------------------------------------------------------------- */
*, *::before, *::after { box-sizing: border-box; }

html {
  -webkit-text-size-adjust: 100%;
  scroll-behavior: smooth;
  scroll-padding-top: calc(var(--header-h) + 18px);
}

body {
  margin: 0;
  background: var(--bg);
  color: var(--ink);
  font-family: var(--font-body);
  font-size: var(--step-0);
  line-height: 1.65;
  font-weight: 400;
  -webkit-font-smoothing: antialiased;
  text-rendering: optimizeLegibility;
  font-feature-settings: "ss01", "cv01";
}

img, svg { max-width: 100%; }
svg { display: block; }

a {
  color: var(--accent-deep);
  text-decoration-color: color-mix(in srgb, var(--accent-deep) 40%, transparent);
  text-underline-offset: 0.16em;
  transition: color 0.14s ease, text-decoration-color 0.14s ease;
}
a:hover { color: var(--accent-hover); text-decoration-color: currentColor; }

:focus-visible {
  outline: none;
  box-shadow: var(--ring);
  border-radius: var(--radius-xs);
}

::selection { background: color-mix(in srgb, var(--accent) 40%, transparent); color: var(--ink); }

.skip-link {
  position: fixed;
  top: 10px; left: 10px;
  z-index: 200;
  background: var(--accent);
  color: #fff;
  padding: 10px 16px;
  border-radius: var(--radius-sm);
  font-weight: 600;
  transform: translateY(-150%);
  transition: transform 0.2s var(--ease-out);
}
.skip-link:focus { transform: translateY(0); color: #fff; }

.sr-only {
  position: absolute; width: 1px; height: 1px;
  padding: 0; margin: -1px; overflow: hidden;
  clip: rect(0, 0, 0, 0); white-space: nowrap; border: 0;
}

/* ----------------------------------------------------------------------------
   3. Typography
   -------------------------------------------------------------------------- */
h1, h2, h3, h4 {
  font-family: var(--font-display);
  color: var(--ink);
  line-height: 1.1;
  margin: 0;
  font-weight: 700;
  letter-spacing: -0.02em;
  text-wrap: balance;
}
h1 { font-size: var(--step-4); letter-spacing: -0.03em; }
h2 { font-size: var(--step-3); letter-spacing: -0.025em; }
h3 { font-size: var(--step-2); font-weight: 600; }
h4 { font-size: var(--step-1); font-weight: 700; font-family: var(--font-body); letter-spacing: -0.01em; }

p { margin: 0 0 1.1em; max-width: var(--reading); text-wrap: pretty; }
.prose > * { max-width: var(--reading); }
.prose > .full, .prose > figure, .prose > .table-wrap,
.prose > .callout, .prose > .diagram, .prose > .grid-2, .prose > .grid-3,
.prose > .tool, .prose > .steps, .prose > pre { max-width: none; }

strong { font-weight: 700; color: var(--ink); }

.lede {
  font-size: clamp(1.15rem, 1.05rem + 0.5vw, 1.4rem);
  line-height: 1.5;
  color: var(--ink-2);
  font-weight: 400;
  max-width: 60ch;
}

.eyebrow {
  font-family: var(--font-mono);
  font-size: 0.74rem;
  font-weight: 500;
  letter-spacing: 0.18em;
  text-transform: uppercase;
  color: var(--accent-deep);
}

/* prose rhythm */
.prose h2 { margin-top: 3.4rem; padding-top: 0.4rem; }
.prose h3 { margin-top: 2.4rem; }
.prose h2 + p, .prose h3 + p, .prose h2 + .lede { margin-top: 0.8rem; }
.prose ul, .prose ol { margin: 0 0 1.1em; padding-left: 1.3em; max-width: var(--reading); }
.prose li { margin-bottom: 0.45em; }
.prose li::marker { color: var(--accent); }
.prose hr {
  border: none; height: 1px; background: var(--divider);
  margin: 3rem 0;
}

/* anchored heading link */
.anchor {
  scroll-margin-top: calc(var(--header-h) + 20px);
}
.anchor-link {
  opacity: 0;
  margin-left: 0.4em;
  color: var(--ink-3);
  font-weight: 400;
  text-decoration: none;
  transition: opacity 0.14s ease;
}
.anchor:hover .anchor-link, .anchor-link:focus-visible { opacity: 1; }

/* inline code */
:not(pre) > code {
  font-family: var(--font-mono);
  font-size: 0.86em;
  background: var(--surface-3);
  color: var(--ink);
  padding: 0.12em 0.42em;
  border-radius: var(--radius-xs);
  border: 1px solid var(--border);
  white-space: nowrap;
}
.prose a > code { color: inherit; }

/* ----------------------------------------------------------------------------
   4. App shell - header / sidebar / main / toc
   -------------------------------------------------------------------------- */
.site-header {
  position: sticky;
  top: 0;
  z-index: 60;
  height: var(--header-h);
  display: flex;
  align-items: center;
  gap: 16px;
  padding: 0 clamp(14px, 3vw, 26px);
  background: color-mix(in srgb, var(--surface) 86%, transparent);
  backdrop-filter: saturate(1.4) blur(10px);
  -webkit-backdrop-filter: saturate(1.4) blur(10px);
  border-bottom: 1px solid var(--border);
}

.brand {
  display: inline-flex;
  align-items: center;
  gap: 10px;
  font-family: var(--font-display);
  font-weight: 700;
  font-size: 1.12rem;
  letter-spacing: -0.02em;
  color: var(--ink);
  text-decoration: none;
}
.brand:hover { color: var(--ink); }
.brand .mark { width: 30px; height: 30px; flex: none; display: block; object-fit: contain; }
.brand .brand-sub {
  font-family: var(--font-mono);
  font-size: 0.62rem;
  font-weight: 500;
  letter-spacing: 0.14em;
  text-transform: uppercase;
  color: var(--ink-3);
  margin-top: 2px;
}
.brand-text { display: flex; flex-direction: column; line-height: 1; gap: 2px; }

.header-spacer { flex: 1; }

.header-actions { display: flex; align-items: center; gap: 6px; }

.icon-btn {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 38px; height: 38px;
  border-radius: var(--radius-sm);
  border: 1px solid transparent;
  background: transparent;
  color: var(--ink-2);
  cursor: pointer;
  transition: background 0.14s ease, color 0.14s ease, border-color 0.14s ease;
}
.icon-btn:hover { background: var(--accent-wash); color: var(--accent-deep); }
.icon-btn svg { width: 19px; height: 19px; }

.header-link {
  display: inline-flex; align-items: center; gap: 7px;
  padding: 8px 13px;
  border-radius: var(--radius-sm);
  color: var(--ink-2);
  font-size: 0.92rem;
  font-weight: 600;
  text-decoration: none;
}
.header-link:hover { background: var(--accent-wash); color: var(--accent-deep); }
.header-link svg { width: 17px; height: 17px; }

.menu-btn { display: none; }

/* layout grid */
.layout {
  display: grid;
  grid-template-columns: var(--sidebar-w) minmax(0, 1fr);
  align-items: start;
}
@media (min-width: 1200px) {
  .layout.has-toc {
    grid-template-columns: var(--sidebar-w) minmax(0, 1fr) var(--toc-w);
  }
}

/* sidebar */
.sidebar {
  position: sticky;
  top: var(--header-h);
  height: calc(100vh - var(--header-h));
  overflow-y: auto;
  overscroll-behavior: contain;
  background: var(--sidebar-bg);
  border-right: 1px solid var(--border);
  padding: 26px 14px 60px 22px;
  scrollbar-width: thin;
}
.nav-group { margin-bottom: 26px; }
.nav-group-title {
  font-family: var(--font-mono);
  font-size: 0.68rem;
  font-weight: 600;
  letter-spacing: 0.14em;
  text-transform: uppercase;
  color: var(--ink-3);
  padding: 0 10px;
  margin-bottom: 9px;
}
.nav-list { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 2px; }
.nav-link {
  display: flex;
  align-items: center;
  gap: 10px;
  padding: 8px 11px;
  border-radius: var(--radius-sm);
  color: var(--ink-2);
  font-weight: 500;
  font-size: 0.95rem;
  text-decoration: none;
  transition: background 0.14s ease, color 0.14s ease;
}
.nav-link .ix {
  font-family: var(--font-mono);
  font-size: 0.7rem;
  color: var(--ink-3);
  width: 1.4em; text-align: center; flex: none;
}
.nav-link:hover { background: var(--accent-wash); color: var(--accent-deep); }
.nav-link[aria-current="page"] {
  background: var(--accent-tint);
  color: var(--accent-deep);
  font-weight: 700;
}
.nav-link[aria-current="page"] .ix { color: var(--accent-deep); }

/* in-page subnav under active page (mobile/sidebar) */
.nav-sub { list-style: none; margin: 4px 0 0 0; padding: 0 0 0 22px; display: flex; flex-direction: column; }
.nav-sub a {
  display: block; padding: 5px 11px;
  font-size: 0.88rem; color: var(--ink-2);
  border-left: 1px solid var(--border-strong);
  text-decoration: none;
}
.nav-sub a:hover { color: var(--accent-deep); border-color: var(--accent); }

/* main */
.main { min-width: 0; }
.content {
  padding: clamp(28px, 4vw, 60px) clamp(20px, 5vw, 72px) 120px;
  max-width: 920px;
  margin: 0 auto;
}
.content.wide { max-width: 1080px; }

.page-head { margin-bottom: 2.2rem; }
.page-head .eyebrow { margin-bottom: 14px; display: block; }
.breadcrumb {
  font-family: var(--font-mono);
  font-size: 0.74rem;
  letter-spacing: 0.04em;
  color: var(--ink-3);
  margin-bottom: 14px;
}
.breadcrumb a { color: var(--ink-3); text-decoration: none; }
.breadcrumb a:hover { color: var(--accent-deep); }

/* on-this-page toc */
.toc {
  position: sticky;
  top: var(--header-h);
  height: calc(100vh - var(--header-h));
  overflow-y: auto;
  padding: 40px 22px 60px 6px;
  display: none;
}
@media (min-width: 1200px) { .layout.has-toc .toc { display: block; } }
.toc-title {
  font-family: var(--font-mono);
  font-size: 0.68rem; font-weight: 600;
  letter-spacing: 0.14em; text-transform: uppercase;
  color: var(--ink-3); margin-bottom: 12px;
}
.toc ul { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 1px; }
.toc a {
  display: block;
  padding: 5px 12px;
  font-size: 0.84rem;
  line-height: 1.4;
  color: var(--ink-2);
  text-decoration: none;
  border-left: 2px solid var(--border);
  transition: color 0.14s ease, border-color 0.14s ease;
}
.toc a:hover { color: var(--accent-deep); }
.toc a.h3 { padding-left: 24px; font-size: 0.8rem; }
.toc a.active { color: var(--accent-deep); border-color: var(--accent); font-weight: 600; }

/* home: drop the persistent sidebar, hero bleeds full width */
.hide-sm { display: inline; }
@media (max-width: 460px) { .hide-sm { display: none; } }

body[data-home] .layout { grid-template-columns: 1fr; }
@media (min-width: 1001px) {
  body[data-home] .menu-btn { display: inline-flex; }
  body[data-home] .sidebar {
    position: fixed; top: 0; left: 0; bottom: 0;
    width: min(82vw, 320px); height: 100%;
    z-index: 120;
    transform: translateX(-100%);
    transition: transform 0.28s var(--ease-out);
    box-shadow: var(--shadow-lg);
    border-right: 1px solid var(--border);
  }
  body[data-home].nav-open .sidebar { transform: translateX(0); }
  body[data-home].nav-open .sidebar-backdrop {
    display: block; position: fixed; inset: 0; z-index: 110;
    background: rgba(0, 0, 0, 0.45); backdrop-filter: blur(2px);
  }
}
body[data-home] .content { max-width: 1120px; }

/* ----------------------------------------------------------------------------
   5. Hero (home)
   -------------------------------------------------------------------------- */
.hero {
  position: relative;
  overflow: hidden;
  background:
    radial-gradient(120% 120% at 85% -10%, var(--oak-2) 0%, var(--oak) 55%);
  color: var(--oak-ink);
  isolation: isolate;
}
.hero::before {
  content: "";
  position: absolute; inset: 0;
  background-image:
    linear-gradient(color-mix(in srgb, var(--oak-ink) 7%, transparent) 1px, transparent 1px),
    linear-gradient(90deg, color-mix(in srgb, var(--oak-ink) 7%, transparent) 1px, transparent 1px);
  background-size: 30px 30px;
  -webkit-mask-image: radial-gradient(120% 90% at 80% 0%, #000 0%, transparent 70%);
  mask-image: radial-gradient(120% 90% at 80% 0%, #000 0%, transparent 70%);
  opacity: 0.5;
  z-index: -1;
}
.hero-inner {
  max-width: 1180px;
  margin: 0 auto;
  padding: clamp(46px, 8vw, 104px) clamp(20px, 5vw, 72px) clamp(54px, 8vw, 96px);
  display: grid;
  grid-template-columns: minmax(0, 1.05fr) minmax(0, 0.95fr);
  gap: clamp(32px, 5vw, 64px);
  align-items: center;
}
.hero .eyebrow { color: var(--accent); }
.hero h1 {
  color: var(--oak-ink);
  font-size: var(--step-5);
  letter-spacing: -0.035em;
  margin: 18px 0 0;
}
.hero h1 .amber { color: var(--accent); }
.hero-lede {
  color: var(--oak-ink-2);
  font-size: clamp(1.1rem, 1rem + 0.6vw, 1.4rem);
  line-height: 1.55;
  margin: 22px 0 0;
  max-width: 40ch;
}
.hero-cta { display: flex; flex-wrap: wrap; gap: 12px; margin-top: 32px; }
.hero-meta {
  margin-top: 34px;
  display: flex; flex-wrap: wrap; gap: 8px 22px;
  font-family: var(--font-mono);
  font-size: 0.8rem;
  color: var(--oak-ink-2);
}
.hero-meta span { display: inline-flex; align-items: center; gap: 7px; }
.hero-meta .dot { width: 7px; height: 7px; border-radius: 50%; background: var(--accent); }

@media (max-width: 900px) {
  .hero-inner { grid-template-columns: 1fr; gap: 36px; }
  .hero-figure { order: -1; }
}

/* ----------------------------------------------------------------------------
   6. Buttons
   -------------------------------------------------------------------------- */
.btn {
  display: inline-flex;
  align-items: center;
  gap: 8px;
  padding: 11px 20px;
  border-radius: var(--radius-sm);
  font-family: var(--font-body);
  font-size: 0.96rem;
  font-weight: 600;
  text-decoration: none;
  border: 1px solid transparent;
  cursor: pointer;
  transition: transform 0.16s var(--ease-out), background 0.16s ease,
              box-shadow 0.16s ease, color 0.16s ease, border-color 0.16s ease;
}
.btn svg { width: 17px; height: 17px; }
.btn-primary { background: var(--accent); color: #fff; box-shadow: var(--shadow-sm); }
.btn-primary:hover { background: var(--accent-hover); color: #fff; transform: translateY(-1px); box-shadow: var(--shadow-md); }
.btn-ghost {
  background: color-mix(in srgb, var(--oak-ink) 8%, transparent);
  color: var(--oak-ink);
  border-color: color-mix(in srgb, var(--oak-ink) 22%, transparent);
}
.btn-ghost:hover { background: color-mix(in srgb, var(--oak-ink) 14%, transparent); color: var(--oak-ink); transform: translateY(-1px); }
.btn-outline {
  background: var(--surface);
  color: var(--accent-deep);
  border-color: var(--border-strong);
}
.btn-outline:hover { border-color: var(--accent); color: var(--accent-deep); transform: translateY(-1px); box-shadow: var(--shadow-sm); }

/* ----------------------------------------------------------------------------
   7. Cards & feature blocks (used sparingly, never nested)
   -------------------------------------------------------------------------- */
.grid-2, .grid-3 { display: grid; gap: 18px; margin: 1.8rem 0; }
.grid-2 { grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); }
.grid-3 { grid-template-columns: repeat(auto-fit, minmax(230px, 1fr)); }

.card {
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: var(--radius);
  padding: 22px;
  box-shadow: var(--shadow-sm);
}
.card-link { text-decoration: none; color: inherit; display: block; transition: transform 0.18s var(--ease-out), box-shadow 0.18s ease, border-color 0.18s ease; }
.card-link:hover { transform: translateY(-3px); box-shadow: var(--shadow-md); border-color: var(--border-strong); color: inherit; }
.card h3 { font-size: 1.12rem; margin-top: 0; margin-bottom: 7px; }
.card p { color: var(--ink-2); font-size: 0.95rem; margin: 0; max-width: none; }
.card .card-ix {
  font-family: var(--font-mono);
  font-size: 0.74rem;
  color: var(--accent-deep);
  display: inline-flex; align-items: center; gap: 8px;
  margin-bottom: 12px;
}
.card .card-go {
  margin-top: 14px; display: inline-flex; align-items: center; gap: 6px;
  color: var(--accent-deep); font-weight: 600; font-size: 0.9rem;
}
.card-link:hover .card-go { gap: 10px; }
.card-icon {
  width: 40px; height: 40px;
  display: grid; place-items: center;
  border-radius: 10px;
  background: var(--accent-wash);
  color: var(--accent-deep);
  margin-bottom: 14px;
}
.card-icon svg { width: 22px; height: 22px; }
/* Provider brand marks: a neutral chip so brand colours read in both themes, and
   currentColor (used by the monochrome marks) follows the page ink colour. */
.card-icon.provider { background: var(--surface); border: 1px solid var(--border); color: var(--ink); }
.card-icon.provider svg { width: 24px; height: 24px; }

/* ----------------------------------------------------------------------------
   8. Callouts (note / tip / warning / danger) - full border, no side stripe
   -------------------------------------------------------------------------- */
.callout {
  display: grid;
  grid-template-columns: auto 1fr;
  gap: 14px;
  margin: 1.6rem 0;
  padding: 16px 18px;
  border: 1px solid var(--border);
  border-radius: var(--radius);
  background: var(--surface-2);
}
.callout-icon { width: 22px; height: 22px; margin-top: 1px; color: var(--ink-2); }
.callout-body { min-width: 0; }
.callout-body > :last-child { margin-bottom: 0; }
.callout-title {
  font-weight: 700; font-family: var(--font-body);
  letter-spacing: -0.01em; margin-bottom: 4px; color: var(--ink);
}
.callout p, .callout li { font-size: 0.96rem; max-width: none; }
.callout.note   { background: var(--info-bg);    border-color: color-mix(in srgb, var(--info) 32%, transparent); }
.callout.note   .callout-icon { color: var(--info); }
.callout.tip    { background: var(--success-bg); border-color: color-mix(in srgb, var(--success) 32%, transparent); }
.callout.tip    .callout-icon { color: var(--success); }
.callout.warn   { background: var(--warn-bg);    border-color: color-mix(in srgb, var(--warn) 40%, transparent); }
.callout.warn   .callout-icon { color: var(--warn); }
.callout.danger { background: var(--error-bg);   border-color: color-mix(in srgb, var(--error) 40%, transparent); }
.callout.danger .callout-icon { color: var(--error); }

/* ----------------------------------------------------------------------------
   9. Code blocks
   -------------------------------------------------------------------------- */
.codeblock {
  position: relative;
  margin: 1.5rem 0;
  border: 1px solid var(--border);
  border-radius: var(--radius);
  background: var(--surface-3);
  overflow: hidden;
}
.codeblock-head {
  display: flex; align-items: center; gap: 10px;
  padding: 9px 14px;
  border-bottom: 1px solid var(--border);
  background: color-mix(in srgb, var(--surface-3) 60%, var(--bg));
}
.codeblock-lang {
  font-family: var(--font-mono);
  font-size: 0.7rem; font-weight: 500;
  letter-spacing: 0.1em; text-transform: uppercase;
  color: var(--ink-3);
}
.codeblock-head .spacer { flex: 1; }
.copy-btn {
  display: inline-flex; align-items: center; gap: 6px;
  font-family: var(--font-body);
  font-size: 0.76rem; font-weight: 600;
  color: var(--ink-2);
  background: transparent;
  border: 1px solid var(--border);
  border-radius: var(--radius-xs);
  padding: 4px 9px;
  cursor: pointer;
  transition: all 0.14s ease;
}
.copy-btn:hover { color: var(--accent-deep); border-color: var(--accent); background: var(--accent-wash); }
.copy-btn svg { width: 13px; height: 13px; }
.copy-btn.copied { color: var(--success); border-color: var(--success); }

.codeblock pre, pre.codeblock-plain {
  margin: 0;
  padding: 16px 18px;
  overflow-x: auto;
  font-family: var(--font-mono);
  font-size: 0.86rem;
  line-height: 1.7;
  color: var(--ink);
  tab-size: 2;
}
pre.codeblock-plain {
  border: 1px solid var(--border);
  border-radius: var(--radius);
  background: var(--surface-3);
  margin: 1.5rem 0;
}
pre code { font: inherit; background: none; border: none; padding: 0; white-space: pre; color: inherit; }

/* lightweight token coloring (applied by site.js) */
.tok-comment { color: var(--ink-3); font-style: italic; }
.tok-key     { color: var(--accent-deep); }
.tok-str     { color: var(--success); }
.tok-punct   { color: var(--ink-2); }
.tok-flag    { color: var(--info); }

/* ----------------------------------------------------------------------------
   10. Tables
   -------------------------------------------------------------------------- */
.table-wrap {
  margin: 1.6rem 0;
  border: 1px solid var(--border);
  border-radius: var(--radius);
  overflow: hidden;
  overflow-x: auto;
  box-shadow: var(--shadow-sm);
}
table { border-collapse: collapse; width: 100%; font-size: 0.93rem; }
thead th {
  font-family: var(--font-mono);
  font-size: 0.68rem; font-weight: 600;
  letter-spacing: 0.08em; text-transform: uppercase;
  color: var(--ink-3);
  text-align: left;
  padding: 12px 16px;
  background: var(--surface-2);
  border-bottom: 1px solid var(--border);
  white-space: nowrap;
}
tbody td {
  padding: 12px 16px;
  border-bottom: 1px solid var(--divider);
  vertical-align: top;
  color: var(--ink-2);
}
tbody td:first-child { color: var(--ink); }
tbody tr:last-child td { border-bottom: none; }
tbody tr { background: var(--surface); transition: background 0.12s ease; }
tbody tr:hover { background: var(--surface-2); }
table code { white-space: nowrap; }
.table-wrap.compare td:first-child { font-weight: 600; color: var(--ink); }
td .yes { color: var(--success); font-weight: 600; }
td .no  { color: var(--ink-3); }

/* ----------------------------------------------------------------------------
   11. Badges & chips
   -------------------------------------------------------------------------- */
.badge {
  display: inline-flex; align-items: center; gap: 6px;
  font-family: var(--font-mono);
  font-size: 0.7rem; font-weight: 500;
  letter-spacing: 0.03em;
  padding: 3px 9px;
  border-radius: 20px;
  white-space: nowrap;
  border: 1px solid transparent;
}
.badge .swatch { width: 8px; height: 8px; border-radius: 2px; flex: none; }
.badge-cap { background: var(--accent-wash); color: var(--accent-deep); border-color: color-mix(in srgb, var(--accent) 28%, transparent); }
.badge-info { background: var(--info-bg); color: var(--info); }
.badge-success { background: var(--success-bg); color: var(--success); }
.badge-error { background: var(--error-bg); color: var(--error); }
.badge-neutral { background: var(--st-grey-bg); color: var(--ink-2); }
/* Secondary API-field id shown under a capability's friendly name in the flags table. */
.cap-slug { display: inline-block; margin-top: 5px; font-size: 0.72rem; color: var(--ink-3); }

/* permission state pills */
.state {
  display: inline-flex; align-items: center; gap: 7px;
  font-weight: 600; font-size: 0.82rem;
  padding: 3px 11px 3px 9px;
  border-radius: 20px;
  border: 1px solid transparent;
  white-space: nowrap;
}
.state .swatch { width: 11px; height: 11px; border-radius: 3px; flex: none; box-shadow: inset 0 0 0 1px rgba(0,0,0,0.12); }
.state.grey   { background: var(--st-grey-bg);   color: var(--ink-2);    border-color: color-mix(in srgb, var(--st-grey) 30%, transparent); }
.state.grey   .swatch { background: var(--st-grey); }
.state.yellow { background: var(--st-yellow-bg); color: var(--st-yellow); border-color: color-mix(in srgb, var(--st-yellow) 38%, transparent); }
.state.yellow .swatch { background: var(--st-yellow); }
.state.green  { background: var(--st-green-bg);  color: var(--st-green);  border-color: color-mix(in srgb, var(--st-green) 38%, transparent); }
.state.green  .swatch { background: var(--st-green); }
.state.red    { background: var(--st-red-bg);    color: var(--st-red);    border-color: color-mix(in srgb, var(--st-red) 40%, transparent); }
.state.red    .swatch { background: var(--st-red); }

/* ----------------------------------------------------------------------------
   12. Steps (genuine sequences only)
   -------------------------------------------------------------------------- */
.steps { margin: 2rem 0; counter-reset: step; }
.step {
  counter-increment: step;
  position: relative;
  display: grid;
  grid-template-columns: 40px minmax(0, 1fr);
  column-gap: 18px;
  padding-bottom: 30px;
}
.step:last-child { padding-bottom: 4px; }
.step::before {
  content: counter(step);
  grid-column: 1; grid-row: 1;
  align-self: start;
  width: 38px; height: 38px;
  display: grid; place-items: center;
  font-family: var(--font-mono);
  font-weight: 600; font-size: 0.95rem;
  color: var(--accent-deep);
  background: var(--surface);
  border: 1.5px solid var(--accent);
  border-radius: 50%;
  position: relative; z-index: 1;
}
.step::after {
  content: "";
  position: absolute;
  left: 19px; top: 42px; bottom: -4px;
  width: 1.5px;
  background: var(--border-strong);
  z-index: 0;
}
.step:last-child::after { display: none; }
.step-body { grid-column: 2; grid-row: 1; padding-top: 4px; min-width: 0; }
.step-body h3 { font-size: 1.18rem; margin-bottom: 8px; }
.step-body > :last-child { margin-bottom: 0; }

/* ----------------------------------------------------------------------------
   13. Tool reference entries (definition layout, not identical cards)
   -------------------------------------------------------------------------- */
.tool-toolbar {
  position: sticky;
  top: var(--header-h);
  z-index: 30;
  display: flex; flex-wrap: wrap; gap: 10px; align-items: center;
  padding: 14px 0;
  margin-bottom: 8px;
  background: color-mix(in srgb, var(--bg) 90%, transparent);
  backdrop-filter: blur(8px);
}
.tool-search {
  flex: 1 1 100%; min-width: 200px;
  display: flex; align-items: center; gap: 9px;
  padding: 9px 14px;
  background: var(--surface);
  border: 1px solid var(--border-strong);
  border-radius: var(--radius-sm);
}
.tool-search:focus-within { border-color: var(--accent); box-shadow: var(--ring); }
.tool-search svg { width: 17px; height: 17px; color: var(--ink-3); flex: none; }
.tool-search input {
  flex: 1; border: none; background: none; outline: none;
  font-family: var(--font-body); font-size: 0.95rem; color: var(--ink);
}
.filter-chip {
  font-family: var(--font-mono);
  font-size: 0.74rem; font-weight: 500;
  padding: 7px 12px;
  border-radius: 20px;
  border: 1px solid var(--border-strong);
  background: var(--surface);
  color: var(--ink-2);
  cursor: pointer;
  transition: all 0.14s ease;
}
.filter-chip:hover { border-color: var(--accent); color: var(--accent-deep); }
.filter-chip[aria-pressed="true"] { background: var(--accent); color: #fff; border-color: var(--accent); }

.tool-group { margin-top: 2.6rem; }
.tool-group-head { margin-bottom: 0.4rem; }
.tool-group-head h2 { scroll-margin-top: calc(var(--header-h) + 70px); }

.tool {
  border-top: 1px solid var(--border);
  padding: 22px 0;
}
.tool-head {
  display: flex; flex-wrap: wrap; align-items: center; gap: 10px;
  margin-bottom: 8px;
}
.tool-name {
  font-family: var(--font-mono);
  font-size: 1.02rem; font-weight: 500;
  color: var(--ink);
}
.tool-desc { color: var(--ink-2); margin: 0 0 12px; max-width: var(--reading); }
.tool dl { margin: 10px 0 0; display: grid; grid-template-columns: auto 1fr; gap: 4px 16px; max-width: var(--reading); }
.tool dt {
  font-family: var(--font-mono);
  font-size: 0.78rem; font-weight: 600;
  letter-spacing: 0.06em; text-transform: uppercase;
  color: var(--ink-3);
  padding-top: 2px;
}
.tool dd { margin: 0; color: var(--ink-2); font-size: 0.95rem; }
.tool dd code { font-size: 0.85em; }
.params { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 6px; }
.params li { margin: 0; }
.param-name { font-family: var(--font-mono); font-size: 0.85em; color: var(--ink); }
.param-meta { font-family: var(--font-mono); font-size: 0.72rem; color: var(--ink-3); }
.is-hidden { display: none !important; }
.no-results { padding: 40px 0; color: var(--ink-3); text-align: center; }

/* ----------------------------------------------------------------------------
   14. Diagrams (custom SVG figures)
   -------------------------------------------------------------------------- */
.diagram {
  margin: 2rem 0;
  padding: clamp(18px, 3vw, 34px);
  background:
    radial-gradient(120% 120% at 100% 0%, var(--surface-2), var(--surface));
  border: 1px solid var(--border);
  border-radius: var(--radius-lg);
  box-shadow: var(--shadow-sm);
}
.diagram svg { width: 100%; height: auto; }
.diagram figcaption {
  margin-top: 16px;
  font-size: 0.88rem;
  color: var(--ink-2);
  text-align: center;
  font-family: var(--font-body);
}
.diagram figcaption b { color: var(--ink); }

/* Screenshot placeholders: empty, clearly-marked slots for real captures later.
   Kept understated (neutral tokens, no amber wash) so they read as TODO, not chrome. */
.screenshot-placeholder { margin: 1.9rem 0; }
.screenshot-placeholder .shot-box {
  display: flex;
  flex-direction: column;
  align-items: center;
  justify-content: center;
  gap: 10px;
  min-height: 190px;
  padding: clamp(20px, 4vw, 40px);
  text-align: center;
  background:
    repeating-linear-gradient(135deg, var(--surface-2), var(--surface-2) 12px, var(--surface) 12px, var(--surface) 24px);
  border: 2px dashed var(--border-strong);
  border-radius: var(--radius-lg);
  color: var(--ink-3);
}
.screenshot-placeholder .shot-box svg { width: 30px; height: 30px; opacity: 0.65; }
.screenshot-placeholder .shot-label {
  font-family: var(--font-mono);
  font-size: var(--step--1);
  color: var(--ink-2);
  letter-spacing: 0.01em;
}
.screenshot-placeholder figcaption {
  margin-top: 12px;
  font-size: 0.88rem;
  color: var(--ink-2);
  text-align: center;
  font-family: var(--font-body);
}
/* Real screenshots (replacing the placeholders above). */
.screenshot { margin: 1.9rem 0; }
.screenshot img {
  display: block;
  width: 100%;
  height: auto;
  border: 1px solid var(--border);
  border-radius: var(--radius-lg);
}
.screenshot figcaption {
  margin-top: 12px;
  font-size: 0.88rem;
  color: var(--ink-2);
  text-align: center;
  font-family: var(--font-body);
}

/* svg theming hooks */
.dgm-surface { fill: var(--surface); }
.dgm-surface-2 { fill: var(--surface-2); }
.dgm-stroke { stroke: var(--border-strong); }
.dgm-stroke-soft { stroke: var(--border); }
.dgm-ink { fill: var(--ink); }
.dgm-ink-2 { fill: var(--ink-2); }
.dgm-ink-3 { fill: var(--ink-3); }
.dgm-accent { fill: var(--accent); }
.dgm-accent-stroke { stroke: var(--accent); }
.dgm-grey { fill: var(--st-grey); }
.dgm-yellow { fill: var(--st-yellow); }
.dgm-green { fill: var(--st-green); }
.dgm-red { fill: var(--st-red); }
.dgm-mono { font-family: var(--font-mono); }
.dgm-body { font-family: var(--font-body); }

/* small inline legend */
.legend { display: flex; flex-wrap: wrap; gap: 10px 18px; margin: 1.4rem 0; }
.legend-item { display: inline-flex; align-items: center; gap: 8px; font-size: 0.9rem; color: var(--ink-2); }

/* permission tree mini-replica */
.perm-tree {
  margin: 1.6rem 0;
  border: 1px solid var(--border);
  border-radius: var(--radius);
  overflow: hidden;
  background: var(--surface);
  box-shadow: var(--shadow-sm);
}
.pt-row {
  display: flex; align-items: center; gap: 12px;
  padding: 11px 16px;
  border-bottom: 1px solid var(--divider);
}
.pt-row:last-child { border-bottom: none; }
.pt-row.child { padding-left: 40px; background: var(--surface-2); }
.pt-id { font-family: var(--font-mono); font-size: 0.85rem; color: var(--ink); flex: 1; min-width: 0; }
.pt-id .tw { color: var(--ink-3); }
.pt-arrow { font-size: 0.8rem; color: var(--ink-3); white-space: nowrap; }
.pt-out { font-family: var(--font-mono); font-size: 0.8rem; font-weight: 600; white-space: nowrap; min-width: 78px; text-align: right; }
.pt-out.write { color: var(--st-green); }
.pt-out.read  { color: var(--st-yellow); }
.pt-out.deny  { color: var(--st-red); }
.pt-out.none  { color: var(--ink-3); }
.pt-row .state { flex: none; min-width: 92px; justify-content: flex-start; }
@media (max-width: 620px) {
  .pt-row { flex-wrap: wrap; gap: 6px 10px; }
  .pt-arrow { order: 3; } .pt-out { order: 4; margin-left: auto; }
}

/* token format strip */
.token-strip {
  display: flex; flex-wrap: wrap; align-items: stretch;
  font-family: var(--font-mono);
  border-radius: var(--radius-sm);
  overflow: hidden;
  border: 1px solid var(--border-strong);
  box-shadow: var(--shadow-sm);
  margin: 0 auto;
  max-width: max-content;
}
.token-strip .seg { padding: 16px 22px; display: flex; flex-direction: column; gap: 6px; }
.token-strip .seg .val { font-size: 1.05rem; color: var(--ink); font-weight: 500; }
.token-strip .seg .lbl { font-size: 0.64rem; letter-spacing: 0.12em; text-transform: uppercase; color: var(--ink-3); }
.token-strip .seg.prefix { background: var(--accent-tint); }
.token-strip .seg.prefix .val { color: var(--accent-deep); }
.token-strip .seg.body { background: var(--surface); flex: 1; min-width: 140px; border-left: 1px solid var(--border); }
.token-strip .seg.total { background: var(--surface-2); border-left: 1px solid var(--border); }
.token-strip .seg.total .val { color: var(--accent-deep); font-weight: 700; }

/* key/value definition rows */
.kv { margin: 1.4rem 0; display: grid; gap: 0; border: 1px solid var(--border); border-radius: var(--radius); overflow: hidden; }
.kv-row { display: grid; grid-template-columns: minmax(140px, 0.3fr) 1fr; gap: 16px; padding: 13px 18px; border-bottom: 1px solid var(--divider); background: var(--surface); }
.kv-row:last-child { border-bottom: none; }
.kv-row dt { font-weight: 600; color: var(--ink); font-family: var(--font-mono); font-size: 0.86rem; }
.kv-row dd { margin: 0; color: var(--ink-2); }

/* ----------------------------------------------------------------------------
   15. Footer & "next" pager
   -------------------------------------------------------------------------- */
.pager { display: flex; flex-wrap: wrap; gap: 16px; margin-top: 4rem; padding-top: 2rem; border-top: 1px solid var(--border); }
.pager a {
  flex: 1; min-width: 220px;
  display: flex; flex-direction: column; gap: 4px;
  padding: 16px 20px;
  border: 1px solid var(--border);
  border-radius: var(--radius);
  text-decoration: none;
  background: var(--surface);
  transition: transform 0.16s var(--ease-out), box-shadow 0.16s ease, border-color 0.16s ease;
}
.pager a:hover { transform: translateY(-2px); box-shadow: var(--shadow-md); border-color: var(--border-strong); }
.pager .dir { font-family: var(--font-mono); font-size: 0.72rem; letter-spacing: 0.08em; text-transform: uppercase; color: var(--ink-3); }
.pager .pg-title { font-weight: 700; color: var(--accent-deep); font-family: var(--font-display); font-size: 1.1rem; }
.pager .next { text-align: right; align-items: flex-end; }

.site-footer {
  border-top: 1px solid var(--border);
  background: var(--surface-2);
  padding: 40px clamp(20px, 5vw, 72px);
}
.footer-inner { max-width: 1080px; margin: 0 auto; display: flex; flex-wrap: wrap; gap: 24px; justify-content: space-between; align-items: center; }
.footer-inner p { margin: 0; color: var(--ink-2); font-size: 0.9rem; max-width: none; }
.footer-links { display: flex; flex-wrap: wrap; gap: 18px; }
.footer-links a { color: var(--ink-2); text-decoration: none; font-size: 0.9rem; font-weight: 500; }
.footer-links a:hover { color: var(--accent-deep); }

/* ----------------------------------------------------------------------------
   16. Reveal motion (enhances an already-visible default)
   -------------------------------------------------------------------------- */
.reveal { opacity: 1; }
.js .reveal { opacity: 0; transform: translateY(14px); }
.js .reveal.in { opacity: 1; transform: none; transition: opacity 0.6s var(--ease-out), transform 0.6s var(--ease-out); }
.js .reveal.d1 { transition-delay: 0.06s; }
.js .reveal.d2 { transition-delay: 0.12s; }
.js .reveal.d3 { transition-delay: 0.18s; }
.js .reveal.d4 { transition-delay: 0.24s; }

/* ----------------------------------------------------------------------------
   17. Mobile / responsive
   -------------------------------------------------------------------------- */
.sidebar-backdrop { display: none; }

@media (max-width: 1000px) {
  :root { --sidebar-w: 0px; }
  .menu-btn { display: inline-flex; }
  .layout, .layout.has-toc { grid-template-columns: 1fr; }
  .sidebar {
    position: fixed;
    top: 0; left: 0; bottom: 0;
    width: min(82vw, 320px);
    height: 100%;
    z-index: 120;
    padding-top: 22px;
    transform: translateX(-100%);
    transition: transform 0.28s var(--ease-out);
    box-shadow: var(--shadow-lg);
  }
  body.nav-open .sidebar { transform: translateX(0); }
  body.nav-open .sidebar-backdrop {
    display: block;
    position: fixed; inset: 0; z-index: 110;
    background: rgba(0, 0, 0, 0.45);
    backdrop-filter: blur(2px);
  }
  .toc { display: none !important; }
}

@media (max-width: 600px) {
  .hero-meta { flex-direction: column; gap: 8px; }
  .step { grid-template-columns: 34px minmax(0, 1fr); column-gap: 12px; }
  .step::before { width: 32px; height: 32px; font-size: 0.85rem; }
  .step::after { left: 16px; top: 38px; }
  .content { padding-bottom: 80px; }
  .kv-row { grid-template-columns: 1fr; gap: 4px; }
}

/* reduced motion */
@media (prefers-reduced-motion: reduce) {
  html { scroll-behavior: auto; }
  *, *::before, *::after {
    animation-duration: 0.001ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.001ms !important;
  }
  .js .reveal { opacity: 1 !important; transform: none !important; }
}

/* print */
@media print {
  .site-header, .sidebar, .toc, .pager, .menu-btn, .copy-btn { display: none !important; }
  .layout { grid-template-columns: 1fr; }
  body { background: #fff; color: #000; }
  .js .reveal { opacity: 1 !important; transform: none !important; }
}