/* ==========================================================================
   Cloaked Docs — site shell
   Layered on top of colors_and_type.css. Adds site chrome only.
   ========================================================================== */

*, *::before, *::after { box-sizing: border-box; }
html, body { margin: 0; padding: 0; }
body {
  font: var(--body);
  color: var(--fg-default);
  background: var(--bg-canvas);
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  text-rendering: optimizeLegibility;
}
a { color: inherit; text-decoration: none; }
img { max-width: 100%; display: block; }
button { font: inherit; cursor: pointer; border: none; background: none; color: inherit; }

/* ----- Layout primitives --------------------------------------------- */
.site {
  --sidebar-w: 260px;
  --nav-h: 0px;
  min-height: 100vh;
}
/* Top nav merged into sidebar; hide host element if still in DOM. */
#site-topnav { display: none; }
.site-inner { max-width: 1440px; margin: 0 auto; }

/* ----- Top nav ------------------------------------------------------- */
.topnav {
  position: sticky; top: 0; z-index: 20;
  background: color-mix(in oklab, var(--bg-canvas) 88%, transparent);
  backdrop-filter: saturate(140%) blur(12px);
  -webkit-backdrop-filter: saturate(140%) blur(12px);
  border-bottom: 1px solid var(--border-default);
  height: var(--nav-h);
}
.topnav-inner {
  max-width: 1440px; margin: 0 auto; height: 100%;
  padding: 0 32px;
  display: flex; align-items: center; gap: 40px;
}
.topnav-brand {
  display: flex; align-items: center; gap: 10px;
  font: 700 17px/1 var(--font-brand);
  letter-spacing: -0.01em;
}
.topnav-brand svg { width: 22px; height: 22px; }
.topnav-brand .pill {
  font: 600 10px var(--font-mono);
  background: var(--bg-muted); color: var(--fg-subtle);
  padding: 3px 8px; border-radius: 999px;
  letter-spacing: 0.04em; text-transform: uppercase;
}
.topnav-links { display: flex; gap: 28px; flex: 1; }
.topnav-link {
  font: 500 14px/1 var(--font-brand);
  color: var(--fg-subtle);
  padding: 8px 0;
  border-bottom: 2px solid transparent;
  transition: color 120ms var(--ease-out);
}
.topnav-link:hover { color: var(--fg-default); }
.topnav-link.active { color: var(--fg-default); border-bottom-color: var(--accent-primary); }
.topnav-right { display: flex; gap: 10px; align-items: center; }
.topnav-search {
  display: flex; align-items: center; gap: 8px;
  background: var(--bg-muted);
  border-radius: var(--radius-md);
  padding: 7px 10px 7px 12px;
  font: var(--mono-sm);
  color: var(--fg-subtle);
  min-width: 220px;
}
.topnav-search .kbd {
  margin-left: auto;
  font: 500 10px var(--font-mono);
  background: var(--bg-canvas);
  border: 1px solid var(--border-default);
  padding: 1px 6px; border-radius: 4px;
}

/* ----- Page shell ----------------------------------------------------- */
.page {
  --sidebar-w: 280px;
  display: grid;
  grid-template-columns: var(--sidebar-w) 1fr;
  gap: 0;
  max-width: 1440px; margin: 0 auto;
  min-height: 100vh;
}
.page--wide { grid-template-columns: 1fr; }

/* ----- Sidebar -------------------------------------------------------- */
/* Keep the sidebar column reserved before site.js injects the real nav.
   Without this, streamed dev servers can briefly place <main> in column 1. */
#site-sidebar {
  display: block;
  min-width: 0;
}
.sidebar {
  position: sticky; top: 0;
  align-self: start;
  height: 100vh;
  width: 100%;
  overflow-y: auto;
  padding: 24px 20px 40px;
  border-right: 1px solid var(--border-default);
  background: var(--bg-canvas);
}

/* Brand block at top of sidebar */
.sidebar-brand {
  display: flex; align-items: center; gap: 12px;
  padding: 8px 10px;
  margin-bottom: 32px;
}
.sidebar-brand-mark {
  flex: 0 0 auto;
  width: 40px; height: 40px;
  border-radius: 10px;
  background: var(--bg-muted);
  display: flex; align-items: center; justify-content: center;
}
.sidebar-brand-mark img,
.sidebar-brand-mark svg { width: 28px; height: 28px; display: block; }
.sidebar-brand-label {
  display: flex; flex-direction: column; gap: 2px;
  min-width: 0;
}
.sidebar-brand-name {
  font: 700 16px/1.1 var(--font-brand);
  letter-spacing: -0.01em;
  color: var(--fg-default);
}
.sidebar-brand-sub {
  font: 500 10px/1 var(--font-mono);
  color: var(--fg-subtle);
  letter-spacing: 0.08em;
  text-transform: uppercase;
}

.sidebar-group { margin-bottom: 28px; }
.sidebar-group-title {
  font: 600 11px/1 var(--font-brand);
  color: var(--fg-subtle);
  letter-spacing: 0.12em;
  text-transform: uppercase;
  margin-bottom: 10px;
  padding-left: 12px;
}
.sidebar-link {
  display: flex; align-items: center; gap: 10px;
  padding: 7px 12px;
  border-radius: 8px;
  font: 500 14px/1.2 var(--font-brand);
  color: var(--fg-muted);
  transition: background 100ms, color 100ms;
}
.sidebar-link-dot {
  flex: 0 0 auto;
  width: 5px; height: 5px; border-radius: 999px;
  background: var(--border-strong);
  transition: background 100ms, transform 100ms;
}
.sidebar-link:hover { color: var(--fg-default); }
.sidebar-link:hover .sidebar-link-dot { background: var(--fg-muted); }
.sidebar-link.active {
  background: var(--bg-inverse);
  color: var(--fg-inverse);
}
.sidebar-link.active .sidebar-link-dot {
  background: var(--accent-primary);
}

/* Sidebar footer — reserved for future use. */
.sidebar-footer { display: none; }

/* Theme toggle — floating top-right of viewport. */
#site-theme-toggle {
  position: fixed;
  top: 20px;
  right: 24px;
  z-index: 50;
}
.theme-toggle {
  display: grid;
  grid-template-columns: repeat(3, 1fr);
  gap: 2px;
  background: var(--bg-muted);
  border-radius: 10px;
  padding: 3px;
}
.theme-toggle--floating {
  background: color-mix(in oklab, var(--bg-muted) 92%, transparent);
  backdrop-filter: saturate(140%) blur(10px);
  -webkit-backdrop-filter: saturate(140%) blur(10px);
  box-shadow: 0 1px 2px rgba(0,0,0,0.04), 0 4px 16px rgba(0,0,0,0.06), 0 0 0 1px var(--border-default);
  min-width: 220px;
}
:root[data-theme="dark"] .theme-toggle--floating {
  box-shadow: 0 1px 2px rgba(0,0,0,0.4), 0 8px 24px rgba(0,0,0,0.35), 0 0 0 1px var(--border-default);
}
.theme-toggle .tt-btn {
  display: inline-flex;
  flex-direction: column;
  align-items: center;
  justify-content: center;
  gap: 4px;
  padding: 8px 4px;
  border-radius: 7px;
  font: 500 11px/1 var(--font-brand);
  color: var(--fg-subtle);
  letter-spacing: 0.01em;
  transition: background 120ms, color 120ms, box-shadow 120ms;
}
.theme-toggle .tt-btn svg { width: 15px; height: 15px; }
.theme-toggle .tt-btn:hover { color: var(--fg-default); }
.theme-toggle .tt-btn.active {
  background: var(--bg-canvas);
  color: var(--fg-default);
  box-shadow: 0 1px 2px rgba(0,0,0,0.08), 0 0 0 1px var(--border-default);
}
:root[data-theme="dark"] .theme-toggle .tt-btn.active {
  box-shadow: 0 1px 2px rgba(0,0,0,0.5), 0 0 0 1px var(--border-default);
}

/* ----- Main content --------------------------------------------------- */
.main {
  padding: 56px 64px 96px;
  max-width: 920px;
  width: 100%;
}
.main--wide { max-width: none; padding: 0; }

.breadcrumb {
  font: var(--mono-sm);
  color: var(--fg-subtle);
  margin-bottom: 16px;
  display: flex; gap: 8px; align-items: center;
}
.breadcrumb .sep { color: var(--border-strong); }

.page-title {
  font: 700 56px/1.02 var(--font-brand);
  letter-spacing: -0.025em;
  margin: 0 0 16px;
  color: var(--fg-default);
}
.page-lede {
  font: 400 20px/1.45 var(--font-brand);
  color: var(--fg-subtle);
  max-width: 640px;
  margin: 0 0 48px;
  letter-spacing: -0.01em;
}

/* ----- Section & blocks ----------------------------------------------- */
.section { margin: 48px 0; }
.section-eyebrow {
  font: var(--overline);
  color: var(--accent-primary);
  letter-spacing: var(--tracking-caps);
  text-transform: uppercase;
  margin-bottom: 8px;
}
.section-title {
  font: 700 28px/1.15 var(--font-brand);
  letter-spacing: -0.015em;
  margin: 0 0 8px;
}
.section-desc {
  font: var(--body-lg);
  color: var(--fg-subtle);
  margin: 0 0 24px;
  max-width: 640px;
}

.subsection-title {
  font: 600 16px/1.2 var(--font-brand);
  margin: 32px 0 12px;
  letter-spacing: -0.005em;
}

/* Canvas: a framed demo area around live component specimens */
.canvas {
  background: var(--bg-subtle);
  border: 1px solid var(--border-default);
  border-radius: var(--radius-xl);
  padding: 48px;
  margin: 16px 0;
  position: relative;
}
.canvas--cream { background: var(--bg-cream); }
.canvas--ink { background: var(--bg-inverse); color: var(--fg-inverse); }
.canvas-label {
  position: absolute; top: 12px; left: 16px;
  font: var(--mono-sm); font-size: 10px;
  color: var(--fg-subtle);
  letter-spacing: 0.04em; text-transform: uppercase;
}
.canvas-row { display: flex; gap: 16px; flex-wrap: wrap; align-items: center; }
.canvas-grid { display: grid; gap: 16px; }

/* Tables */
.spec-table {
  width: 100%;
  border-collapse: collapse;
  font: var(--body-sm);
  margin: 16px 0;
}
.spec-table th, .spec-table td {
  text-align: left; padding: 12px 16px;
  border-bottom: 1px solid var(--border-default);
  vertical-align: top;
}
.spec-table th {
  font: 600 12px var(--font-brand);
  color: var(--fg-subtle);
  letter-spacing: var(--tracking-caps);
  text-transform: uppercase;
  background: var(--bg-subtle);
}
.spec-table td code, .spec-table .mono {
  font: var(--mono-sm);
  color: var(--fg-muted);
}

/* Code blocks — always dark, stay dark in both themes */
.code {
  background: #0D0D0D;
  color: #F0F0F0;
  border-radius: var(--radius-lg);
  padding: 20px 24px;
  font: var(--mono-sm);
  overflow-x: auto;
  margin: 16px 0;
}
.code .k { color: #F7B06A; }
.code .c { color: #8C8C8C; }
.code .s { color: #A9B7FF; }

/* Callouts */
.callout {
  border-left: 3px solid var(--accent-primary);
  background: var(--bg-subtle);
  padding: 16px 20px;
  border-radius: 0 var(--radius-md) var(--radius-md) 0;
  font: var(--body-sm);
  color: var(--fg-muted);
  margin: 20px 0;
}

/* Next/prev footer */
.page-footer {
  margin-top: 96px;
  padding-top: 32px;
  border-top: 1px solid var(--border-default);
  display: flex; justify-content: space-between; gap: 24px;
}
.page-footer a {
  display: block;
  padding: 16px 20px;
  border-radius: var(--radius-lg);
  background: var(--bg-subtle);
  flex: 0 1 280px;
  transition: background 120ms;
}
.page-footer a:hover { background: var(--bg-muted); }
.page-footer .dir { font: var(--mono-sm); color: var(--fg-subtle); margin-bottom: 4px; }
.page-footer .title { font: 600 17px/1.2 var(--font-brand); letter-spacing: -0.01em; }
.page-footer .prev { text-align: left; }
.page-footer .next { text-align: right; margin-left: auto; }

/* On full-bleed pages, keep prev/next aligned with the hero/section gutter
   instead of sticking to the sidebar edge. */
.main--wide .page-footer {
  max-width: 1440px;
  margin: 0 auto;
  padding: 32px 64px 64px;
}
@media (max-width: 900px) {
  .main--wide .page-footer { padding: 32px 24px 48px; }
}

/* ----- Copyable token chip ------------------------------------------- */
.token {
  display: inline-flex; align-items: center; gap: 6px;
  font: var(--mono-sm);
  background: var(--bg-muted);
  padding: 3px 8px;
  border-radius: var(--radius-xs);
  cursor: copy;
  user-select: all;
}
.token:hover { background: var(--bg-overlay-med); }
.token .copied { color: var(--state-success); margin-left: 4px; }


/* ────────────────────────────────────────────────────────────────────
   Global responsive — applies to every page that uses the shared shell
   ──────────────────────────────────────────────────────────────────── */
@media (max-width: 960px) {
  .page { grid-template-columns: 1fr; }
  .sidebar {
    position: static; max-height: none;
    border-right: 0; border-bottom: 1px solid var(--border-default);
    padding: 16px 20px;
  }
  .sidebar-brand { margin-bottom: 16px; }
  .sidebar-group { margin-bottom: 12px; }
  .main { padding: 32px 24px 64px; max-width: 100%; }
  .main--wide { padding: 0; }

  /* Doc shell used across pages */
  .doc { grid-template-columns: 1fr !important; gap: 32px !important; padding: 24px 20px 48px !important; }
  .doc-rail { display: none !important; }

  /* Common multi-column grids — collapse to single column */
  .vgrid,
  .dd-grid,
  .dd-grid--3,
  .vbox-grid,
  .grid-2,
  .grid-3,
  .grid-4 { grid-template-columns: 1fr !important; }

  /* States matrices — 2 cols on tablet */
  .matrix,
  .sc-matrix { grid-template-columns: repeat(2, 1fr) !important; }

  /* Tables scroll horizontally */
  .doc-section table,
  .doc table { display: block; overflow-x: auto; max-width: 100%; }
  pre, .code-block { max-width: 100%; overflow-x: auto; }
}

@media (max-width: 560px) {
  .main { padding: 24px 16px 48px; }
  .doc { padding: 20px 16px 40px !important; }
  .matrix,
  .sc-matrix { grid-template-columns: 1fr !important; }
  h1 { font-size: clamp(28px, 7vw, 40px) !important; }
  h2 { font-size: clamp(20px, 5vw, 28px) !important; }
}

/* Prevent horizontal page overflow */
html, body { overflow-x: hidden; }
.doc-main, .doc-section { min-width: 0; }