/* ============================================================================
   COMPONENTS — buttons, nav, cards, badges, code, tables, forms, footer
   Every component lists its states. Plain HTML/CSS/JS buildable.
   ============================================================================ */

/* ===========================================================================
   BUTTONS
   variants: .btn-primary .btn-secondary .btn-ghost   sizes: .btn-sm .btn-lg
   states: hover / focus-visible / active / disabled
   =========================================================================== */
.btn {
  --btn-h: 42px;
  display: inline-flex;
  align-items: center;
  justify-content: center;
  gap: var(--space-2);
  height: var(--btn-h);
  padding-inline: var(--space-5);
  font-size: var(--fs-sm);
  font-weight: var(--fw-medium);
  letter-spacing: var(--tracking-snug);
  line-height: 1;
  border-radius: var(--radius-md);
  border: 1px solid transparent;
  white-space: nowrap;
  text-decoration: none;
  transition: background var(--dur) var(--ease), border-color var(--dur) var(--ease),
    color var(--dur) var(--ease), box-shadow var(--dur) var(--ease), transform var(--dur-fast) var(--ease);
}
.btn:hover { text-decoration: none; }
.btn:active { transform: translateY(0.5px) scale(0.994); }
.btn[aria-disabled="true"], .btn:disabled {
  opacity: 0.5; pointer-events: none; cursor: not-allowed;
}
.btn svg { width: 16px; height: 16px; flex: none; }

.btn-sm { --btn-h: 34px; padding-inline: var(--space-4); font-size: var(--fs-xs); }
.btn-lg { --btn-h: 50px; padding-inline: var(--space-6); font-size: var(--fs-base); }

.btn-primary {
  background: var(--accent);
  color: #fff;
  box-shadow: var(--shadow-xs), inset 0 1px 0 rgba(255, 255, 255, 0.14);
}
.btn-primary:hover { background: var(--accent-hover); }
.btn-primary:active { background: var(--accent-press); }

.btn-secondary {
  background: var(--surface);
  color: var(--ink);
  border-color: var(--line-2);
  box-shadow: var(--shadow-xs);
}
.btn-secondary:hover { border-color: var(--line-3); background: var(--surface-2); }
.btn-secondary:active { background: var(--surface-3); }

.btn-ghost {
  background: transparent;
  color: var(--ink-2);
  padding-inline: var(--space-3);
}
.btn-ghost:hover { background: var(--surface-2); color: var(--ink); }

.btn-block { display: flex; width: 100%; }

/* arrow nudge on hover */
.btn .arrow { transition: transform var(--dur) var(--ease); }
.btn:hover .arrow { transform: translateX(3px); }

/* ===========================================================================
   BADGES / PILLS / TAGS
   =========================================================================== */
.badge {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  height: 24px;
  padding-inline: 10px;
  font-size: var(--fs-xs);
  font-weight: var(--fw-medium);
  border-radius: var(--radius-pill);
  border: 1px solid var(--line-2);
  background: var(--surface);
  color: var(--ink-2);
  white-space: nowrap;
}
.badge-mono { font-family: var(--font-mono); font-size: var(--fs-mono-xs); }
.badge-accent { background: var(--accent-wash); border-color: var(--accent-border); color: var(--accent-text); }
.badge-success { background: var(--success-wash); border-color: var(--success-border); color: var(--success); }
.badge-warn { background: var(--warn-wash); border-color: var(--warn-border); color: var(--warn); }
.badge-danger { background: var(--danger-wash); border-color: var(--danger-border); color: var(--danger); }
.badge-dot::before {
  content: ""; width: 6px; height: 6px; border-radius: 50%;
  background: currentColor; flex: none;
}

.tag {
  font-family: var(--font-mono);
  font-size: var(--fs-mono-xs);
  padding: 3px 8px;
  border-radius: var(--radius-sm);
  background: var(--surface-2);
  border: 1px solid var(--line);
  color: var(--ink-2);
}

/* HTTP method chips for endpoint tables */
.method {
  font-family: var(--font-mono);
  font-size: var(--fs-mono-xs);
  font-weight: var(--fw-semibold);
  letter-spacing: 0.04em;
  padding: 2px 7px;
  border-radius: var(--radius-sm);
  border: 1px solid currentColor;
}
.method-get { color: var(--success); }
.method-post { color: var(--accent-text); }

/* ===========================================================================
   CARDS
   =========================================================================== */
.card {
  display: block;
  background: var(--surface);
  border: 1px solid var(--line);
  border-radius: var(--radius-lg);
  padding: var(--space-6);
  box-shadow: var(--shadow-xs);
  transition: border-color var(--dur) var(--ease), box-shadow var(--dur) var(--ease), transform var(--dur) var(--ease);
}
.card-hover:hover { border-color: var(--line-3); box-shadow: var(--shadow-md); transform: translateY(-2px); }
.card-pad-lg { padding: var(--space-7); }
.card-flush { padding: 0; overflow: hidden; }
.card-quiet { background: var(--surface-2); box-shadow: none; }

.card-icon {
  width: 40px; height: 40px;
  display: inline-flex; align-items: center; justify-content: center;
  border-radius: var(--radius-md);
  background: var(--accent-wash);
  color: var(--accent-text);
  border: 1px solid var(--accent-border);
  margin-bottom: var(--space-4);
}
.card-icon svg { width: 20px; height: 20px; }
.card h3 { font-size: var(--fs-lg); margin-bottom: var(--space-2); }
.card p { color: var(--ink-2); font-size: var(--fs-sm); line-height: var(--lh-relaxed); }

/* ===========================================================================
   SITE HEADER / NAV
   =========================================================================== */
.site-header {
  position: sticky;
  top: 0;
  z-index: 100;
  background: color-mix(in srgb, var(--paper) 82%, transparent);
  backdrop-filter: saturate(1.4) blur(12px);
  -webkit-backdrop-filter: saturate(1.4) blur(12px);
  border-bottom: 1px solid var(--line);
}
.nav {
  height: var(--nav-h);
  display: flex;
  align-items: center;
  gap: var(--space-6);
}
.nav-brand { display: inline-flex; align-items: center; gap: 10px; flex: none; }
.nav-brand:hover { text-decoration: none; }
.nav-brand img, .nav-brand svg.brandmark { height: 30px; width: auto; }

.nav-links {
  display: flex;
  align-items: center;
  gap: var(--space-1);
  margin-left: var(--space-2);
}
.nav-link {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  height: 36px;
  padding-inline: var(--space-3);
  border-radius: var(--radius-sm);
  font-size: var(--fs-sm);
  font-weight: var(--fw-medium);
  color: var(--ink-2);
  transition: color var(--dur) var(--ease), background var(--dur) var(--ease);
}
.nav-link:hover { color: var(--ink); background: var(--surface-2); text-decoration: none; }
.nav-link[aria-current="page"] { color: var(--ink); }
.nav-actions { display: flex; align-items: center; gap: var(--space-3); margin-left: auto; }

/* language switcher */
.lang-switch {
  display: inline-flex;
  align-items: center;
  padding: 3px;
  gap: 2px;
  background: var(--surface-2);
  border: 1px solid var(--line);
  border-radius: var(--radius-md);
}
.lang-switch button {
  font-family: var(--font-mono);
  font-size: var(--fs-mono-xs);
  font-weight: var(--fw-medium);
  letter-spacing: 0.04em;
  padding: 4px 9px;
  border-radius: var(--radius-sm);
  color: var(--ink-3);
  transition: color var(--dur) var(--ease), background var(--dur) var(--ease);
}
.lang-switch button[aria-pressed="true"] {
  background: var(--surface);
  color: var(--ink);
  box-shadow: var(--shadow-xs);
}
.lang-switch button:hover { color: var(--ink); }

/* mobile menu toggle */
.nav-toggle {
  display: none;
  width: 40px; height: 40px;
  align-items: center; justify-content: center;
  border-radius: var(--radius-sm);
  color: var(--ink);
  border: 1px solid var(--line);
  background: var(--surface);
}
.nav-toggle:hover { background: var(--surface-2); }

@media (max-width: 900px) {
  .nav-links {
    position: fixed;
    inset: var(--nav-h) 0 auto 0;
    flex-direction: column;
    align-items: stretch;
    gap: 2px;
    padding: var(--space-4) var(--gutter) var(--space-6);
    background: var(--paper);
    border-bottom: 1px solid var(--line);
    box-shadow: var(--shadow-lg);
    transform: translateY(-12px);
    opacity: 0;
    pointer-events: none;
    transition: opacity var(--dur) var(--ease), transform var(--dur) var(--ease);
  }
  .nav-links.is-open { opacity: 1; transform: none; pointer-events: auto; }
  .nav-link { height: 44px; font-size: var(--fs-base); padding-inline: var(--space-3); }
  .nav-toggle { display: inline-flex; }
}

/* ===========================================================================
   CODE BLOCKS — always dark, with header bar + copy button
   accessible: <pre> is focusable & scrollable; copy has aria-live feedback
   =========================================================================== */
.code {
  background: var(--code-bg);
  border: 1px solid var(--code-line);
  border-radius: var(--radius-lg);
  overflow: hidden;
  box-shadow: var(--shadow-sm);
  --tab: 1; /* for spacing */
}
.code-head {
  display: flex;
  align-items: center;
  gap: var(--space-3);
  padding: 10px 12px 10px 16px;
  background: var(--code-bg-header);
  border-bottom: 1px solid var(--code-line);
}
.code-lang {
  font-family: var(--font-mono);
  font-size: var(--fs-mono-xs);
  font-weight: var(--fw-medium);
  letter-spacing: 0.04em;
  color: var(--code-comment);
  text-transform: uppercase;
}
.code-file {
  font-family: var(--font-mono);
  font-size: var(--fs-mono-xs);
  color: var(--code-fg);
}
.code-copy {
  margin-left: auto;
  display: inline-flex;
  align-items: center;
  gap: 6px;
  font-family: var(--font-mono);
  font-size: var(--fs-mono-xs);
  color: var(--code-comment);
  padding: 4px 8px;
  border-radius: var(--radius-sm);
  border: 1px solid transparent;
  transition: color var(--dur) var(--ease), background var(--dur) var(--ease), border-color var(--dur) var(--ease);
}
.code-copy:hover { color: var(--code-fg); background: rgba(255, 255, 255, 0.05); border-color: var(--code-line); }
.code-copy svg { width: 13px; height: 13px; }
.code-copy.copied { color: var(--code-str); }

.code pre {
  margin: 0;
  padding: var(--space-5) var(--space-5);
  overflow-x: auto;
  font-size: var(--fs-sm);
  line-height: 1.7;
  color: var(--code-fg);
  -webkit-overflow-scrolling: touch;
  tab-size: 4;
}
.code pre:focus-visible { outline: 2px solid var(--accent); outline-offset: -2px; }
.code code { font-family: var(--font-mono); font-size: inherit; white-space: pre; }

/* syntax token classes (applied by hand in markup or a tiny highlighter) */
.t-c { color: var(--code-comment); font-style: italic; }
.t-k { color: var(--code-kw); }
.t-f { color: var(--code-fn); }
.t-s { color: var(--code-str); }
.t-n { color: var(--code-num); }
.t-v { color: var(--code-var); }
.t-t { color: var(--code-tag); }
.t-a { color: var(--code-attr); }
.t-p { color: var(--code-prop); }
.t-pu { color: var(--code-punc); }
.t-m { color: var(--code-fg); }

/* inline code chips that sit inside dark code headers/legends */
.kbd {
  font-family: var(--font-mono);
  font-size: 0.85em;
  padding: 1px 6px;
  border-radius: var(--radius-xs);
  border: 1px solid var(--line-2);
  background: var(--surface-2);
  color: var(--ink-2);
}

/* ===========================================================================
   TABLES — reference tables, scannable
   =========================================================================== */
.table-wrap {
  border: 1px solid var(--line);
  border-radius: var(--radius-lg);
  overflow: auto;
  background: var(--surface);
  -webkit-overflow-scrolling: touch;
}
table.ref {
  width: 100%;
  border-collapse: collapse;
  font-size: var(--fs-sm);
  min-width: 520px;
}
table.ref caption {
  text-align: left;
  padding: var(--space-4) var(--space-5);
  font-weight: var(--fw-semibold);
  color: var(--ink);
  border-bottom: 1px solid var(--line);
}
table.ref th, table.ref td {
  text-align: left;
  padding: 12px var(--space-5);
  border-bottom: 1px solid var(--line);
  vertical-align: top;
}
table.ref thead th {
  font-size: var(--fs-xs);
  font-weight: var(--fw-semibold);
  letter-spacing: var(--tracking-wide);
  text-transform: uppercase;
  color: var(--ink-3);
  background: var(--surface-2);
  position: sticky;
  top: 0;
}
table.ref tbody tr:last-child td { border-bottom: none; }
table.ref tbody tr:hover { background: var(--surface-2); }
table.ref td.mono, table.ref th.mono { font-family: var(--font-mono); font-size: var(--fs-mono-xs); }
table.ref td .tag { white-space: nowrap; }
.code-cell { font-family: var(--font-mono); font-size: var(--fs-mono-xs); color: var(--accent-text); white-space: nowrap; }

/* ===========================================================================
   FORMS / INPUTS
   =========================================================================== */
.field { display: flex; flex-direction: column; gap: 6px; }
.field label { font-size: var(--fs-sm); font-weight: var(--fw-medium); color: var(--ink); }
.input, .select, .textarea {
  height: 42px;
  padding: 0 var(--space-4);
  background: var(--surface);
  border: 1px solid var(--line-2);
  border-radius: var(--radius-md);
  font-size: var(--fs-sm);
  color: var(--ink);
  transition: border-color var(--dur) var(--ease), box-shadow var(--dur) var(--ease);
}
.textarea { height: auto; padding: var(--space-3) var(--space-4); resize: vertical; }
.input::placeholder, .textarea::placeholder { color: var(--ink-4); }
.input:hover, .select:hover, .textarea:hover { border-color: var(--line-3); }
.input:focus-visible, .select:focus-visible, .textarea:focus-visible {
  border-color: var(--accent);
  box-shadow: var(--focus-ring);
}

/* ===========================================================================
   CALLOUTS / NOTES
   =========================================================================== */
.callout {
  display: flex;
  gap: var(--space-3);
  padding: var(--space-4) var(--space-5);
  border-radius: var(--radius-md);
  border: 1px solid var(--line-2);
  background: var(--surface-2);
  font-size: var(--fs-sm);
  line-height: var(--lh-relaxed);
  color: var(--ink-2);
}
.callout strong { color: var(--ink); font-weight: var(--fw-semibold); }
.callout .callout-mark { flex: none; width: 18px; height: 18px; margin-top: 2px; color: var(--ink-3); }
.callout-accent { background: var(--accent-wash); border-color: var(--accent-border); }
.callout-accent .callout-mark { color: var(--accent); }
.callout-warn { background: var(--warn-wash); border-color: var(--warn-border); }
.callout-warn .callout-mark { color: var(--warn); }
.callout-danger { background: var(--danger-wash); border-color: var(--danger-border); }
.callout-danger .callout-mark { color: var(--danger); }

/* a "frozen contract" emphasis used on the dev page */
.contract-note {
  border-left: 3px solid var(--accent);
  padding-left: var(--space-4);
  color: var(--ink-2);
  font-size: var(--fs-sm);
}

/* ===========================================================================
   PLACEHOLDER SLOTS — for screenshots / imagery the owner supplies later
   striped SVG-ish look with a monospace label; clearly marked, never faked UI
   =========================================================================== */
.placeholder {
  position: relative;
  display: flex;
  flex-direction: column;
  align-items: center;
  justify-content: center;
  gap: 6px;
  text-align: center;
  padding: var(--space-6);
  border: 1px dashed var(--line-3);
  border-radius: var(--radius-lg);
  background-color: var(--surface-2);
  background-image: repeating-linear-gradient(
    -45deg,
    transparent 0 11px,
    color-mix(in srgb, var(--ink) 4%, transparent) 11px 12px
  );
  color: var(--ink-3);
  min-height: 200px;
}
.placeholder .ph-label {
  font-family: var(--font-mono);
  font-size: var(--fs-mono-xs);
  letter-spacing: 0.02em;
  color: var(--ink-2);
  background: var(--surface);
  border: 1px solid var(--line-2);
  padding: 4px 10px;
  border-radius: var(--radius-pill);
}
.placeholder .ph-sub { font-size: var(--fs-xs); color: var(--ink-4); max-width: 32ch; }

/* ===========================================================================
   FOOTER
   =========================================================================== */
.site-footer {
  border-top: 1px solid var(--line);
  background: var(--surface-2);
  padding-block: var(--space-8) var(--space-6);
  margin-top: var(--space-9);
}
.footer-grid {
  display: grid;
  grid-template-columns: 1.4fr repeat(3, 1fr);
  gap: var(--space-6);
}
.footer-col h4 {
  font-size: var(--fs-xs);
  font-weight: var(--fw-semibold);
  letter-spacing: var(--tracking-wide);
  text-transform: uppercase;
  color: var(--ink-3);
  margin-bottom: var(--space-3);
}
.footer-col a { display: block; color: var(--ink-2); font-size: var(--fs-sm); padding: 5px 0; }
.footer-col a:hover { color: var(--ink); text-decoration: none; }
.footer-bottom {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  justify-content: space-between;
  gap: var(--space-4);
  margin-top: var(--space-7);
  padding-top: var(--space-5);
  border-top: 1px solid var(--line);
  color: var(--ink-3);
  font-size: var(--fs-xs);
}
.footer-brand-row { display: flex; align-items: center; gap: 10px; margin-bottom: var(--space-3); }
.footer-note { color: var(--ink-3); font-size: var(--fs-sm); line-height: var(--lh-relaxed); max-width: 36ch; }

@media (max-width: 760px) {
  .footer-grid { grid-template-columns: 1fr 1fr; gap: var(--space-6) var(--space-5); }
  .footer-col.footer-about { grid-column: 1 / -1; }
}

/* ===========================================================================
   SECTION HEADER pattern
   =========================================================================== */
.section-head { max-width: 60ch; margin-bottom: var(--space-7); }
.section-head.center { margin-inline: auto; text-align: center; }
.section-head h2 { margin-top: var(--space-3); }
.section-head p { margin-top: var(--space-4); color: var(--ink-2); font-size: var(--fs-md); line-height: var(--lh-relaxed); }