/* =============================================================================
   docs.css — docs-specific layout that LAYERS ON the shared marketing system.
   Requires /assets/marketing/tokens.css + site.css to be loaded first.
   Redefines NO token. Adds only the 3-pane docs chrome + reference components.
   ============================================================================= */

/* ---- 3-pane layout: sticky left nav · prose (720) · right on-this-page ---- */
.docs-layout{
  display:grid;
  grid-template-columns:248px minmax(0,1fr) 200px;
  gap:var(--s-10);
  max-width:1280px;
  margin-inline:auto;
  padding-inline:max(20px,4vw);
  padding-block:var(--s-10) var(--s-24);
  align-items:start;
}
.docs-nav{ position:sticky; top:88px; max-height:calc(100vh - 110px); overflow-y:auto;
  padding-right:8px; }
.docs-nav h5{ font-family:var(--font-brand); font-size:10px; text-transform:uppercase;
  letter-spacing:.14em; color:var(--ink-mute); margin:18px 0 8px; }
.docs-nav h5:first-child{ margin-top:0; }
.docs-nav a{ display:block; padding:6px 10px; border-radius:var(--r-sm); color:var(--ink-dim);
  font-size:13.5px; line-height:1.4; transition:background var(--dur-1),color var(--dur-1); }
.docs-nav a:hover{ background:var(--accent-soft); color:var(--ink); }
.docs-nav a[aria-current="page"]{ color:var(--accent); background:var(--accent-soft);
  box-shadow:inset 2px 0 0 var(--accent); }

.docs-main{ min-width:0; max-width:760px; }
.docs-main > p{ color:var(--ink-dim); }
.docs-main h2{ font-size:var(--t-h2); margin:var(--s-12) 0 var(--s-4); scroll-margin-top:84px; }
.docs-main h2:first-of-type{ margin-top:var(--s-6); }
.docs-main h3{ font-size:var(--t-h3); margin:var(--s-8) 0 var(--s-3); scroll-margin-top:84px; }
.docs-main h4{ font-size:var(--t-h4); margin:var(--s-6) 0 var(--s-2); }
.docs-main ul,.docs-main ol{ color:var(--ink-dim); padding-left:1.2em; }
.docs-main li{ margin:6px 0; }
.docs-main code:not(.code code):not(pre code){ font-family:var(--font-mono); font-size:.86em;
  background:var(--elev-2); border:1px solid var(--line); border-radius:var(--r-xs);
  padding:1px 6px; color:var(--ink); }
.docs-main a:not(.btn):not(.pill){ text-decoration:none; border-bottom:1px solid var(--accent-soft); }
.docs-main a:not(.btn):not(.pill):hover{ border-bottom-color:var(--accent); }

.docs-toc{ position:sticky; top:88px; font-size:13px; }
.docs-toc h6{ font-family:var(--font-brand); font-size:10px; text-transform:uppercase;
  letter-spacing:.12em; color:var(--ink-mute); margin:0 0 10px; }
.docs-toc a{ display:block; padding:4px 0; color:var(--ink-mute); border-left:2px solid var(--line);
  padding-left:12px; transition:color var(--dur-1),border-color var(--dur-1); }
.docs-toc a:hover,.docs-toc a.is-active{ color:var(--ink); border-left-color:var(--accent); }

@media (max-width:1100px){
  .docs-layout{ grid-template-columns:240px minmax(0,1fr); }
  .docs-toc{ display:none; }
}
@media (max-width:860px){
  .docs-layout{ grid-template-columns:1fr; gap:var(--s-6); padding-block:var(--s-6) var(--s-16); }
  .docs-nav{ position:static; max-height:none; border:1px solid var(--line); border-radius:var(--r);
    padding:14px 12px; background:var(--surface); }
}

/* ---- breadcrumb ---- */
.docs-crumb{ font-size:12px; color:var(--ink-mute); margin-bottom:14px; }
.docs-crumb a{ color:var(--ink-mute); }
.docs-crumb a:hover{ color:var(--ink); }

/* ---- endpoint block (REST reference) ---- */
.endpoint{ border:1px solid var(--line); border-radius:var(--r); background:var(--surface);
  padding:var(--s-5); margin:var(--s-5) 0; box-shadow:var(--sh-1); }
.endpoint-head{ display:flex; align-items:center; gap:10px; flex-wrap:wrap; }
.method{ font-family:var(--font-mono); font-size:11px; font-weight:700; letter-spacing:.04em;
  padding:3px 9px; border-radius:var(--r-xs); text-transform:uppercase; }
.method.get{ color:var(--success); background:color-mix(in srgb,var(--success) 14%,transparent);
  border:1px solid color-mix(in srgb,var(--success) 38%,transparent); }
.method.post{ color:var(--accent); background:color-mix(in srgb,var(--accent) 14%,transparent);
  border:1px solid color-mix(in srgb,var(--accent) 38%,transparent); }
.method.patch{ color:var(--warn); background:color-mix(in srgb,var(--warn) 14%,transparent);
  border:1px solid color-mix(in srgb,var(--warn) 38%,transparent); }
.method.delete{ color:var(--danger); background:color-mix(in srgb,var(--danger) 14%,transparent);
  border:1px solid color-mix(in srgb,var(--danger) 38%,transparent); }
.endpoint-path{ font-family:var(--font-mono); font-size:14px; color:var(--ink); word-break:break-all; }
.endpoint-desc{ color:var(--ink-dim); font-size:var(--t-sm); margin:10px 0 0; }
.endpoint .gate{ margin-left:auto; }

/* ---- param table ---- */
.param-table{ width:100%; border-collapse:collapse; font-size:var(--t-sm); margin:var(--s-3) 0; }
.param-table th{ text-align:left; font-family:var(--font-brand); font-size:10px; text-transform:uppercase;
  letter-spacing:.08em; color:var(--ink-mute); font-weight:700; padding:9px 12px;
  border-bottom:1px solid var(--line); background:var(--elev-2); }
.param-table td{ padding:9px 12px; border-bottom:1px solid var(--line); vertical-align:top; color:var(--ink-dim); }
.param-table tr:last-child td{ border-bottom:0; }
.param-table .pname{ font-family:var(--font-mono); color:var(--ink); white-space:nowrap; }
.param-table .ptype{ font-family:var(--font-mono); color:var(--info); font-size:12px; white-space:nowrap; }
.param-table .req{ color:var(--accent); font-size:11px; font-family:var(--font-brand); text-transform:uppercase; }

/* ---- callout / note box ---- */
.callout{ border:1px solid var(--line); border-left:3px solid var(--accent); border-radius:var(--r-sm);
  background:var(--accent-soft); padding:14px 16px; margin:var(--s-5) 0; font-size:var(--t-sm); color:var(--ink-dim); }
.callout.warn{ border-left-color:var(--warn); background:color-mix(in srgb,var(--warn) 8%,transparent); }
.callout.danger{ border-left-color:var(--danger); background:color-mix(in srgb,var(--danger) 8%,transparent); }
.callout.success{ border-left-color:var(--success); background:color-mix(in srgb,var(--success) 8%,transparent); }
.callout strong{ color:var(--ink); }

/* ---- definition rows for the schema page ---- */
.schema-grid{ width:100%; border-collapse:collapse; font-size:var(--t-sm); }
.schema-grid th{ position:sticky; top:64px; text-align:left; font-family:var(--font-brand); font-size:10px;
  text-transform:uppercase; letter-spacing:.08em; color:var(--ink-mute); font-weight:700;
  padding:10px 12px; border-bottom:1px solid var(--line); background:var(--elev-2); z-index:1; }
.schema-grid td{ padding:10px 12px; border-bottom:1px solid var(--line); vertical-align:top; color:var(--ink-dim); }
.schema-grid .fname{ font-family:var(--font-mono); color:var(--ink); white-space:nowrap; }
.schema-grid .ftype{ font-family:var(--font-mono); color:var(--info); font-size:12px; }
.schema-grid tr:hover td{ background:rgba(255,255,255,.02); }
[data-theme="light"] .schema-grid tr:hover td{ background:rgba(20,21,40,.03); }

/* ---- the "verify yourself" live box on docs pages ---- */
.docs-verify{ margin:var(--s-6) 0; }

/* prose code block helper (single language, no tabs) */
.code-1{ margin:var(--s-4) 0; }
.code-1 .code-head{ justify-content:space-between; }
.code-1 .code-lang{ font-family:var(--font-brand); font-size:11px; text-transform:uppercase;
  letter-spacing:.08em; color:var(--ink-mute); padding-inline:8px; }