/* API reference page. Loads on top of styles.css, which owns the tokens and shell. */

.docs-layout {
  display: grid;
  grid-template-columns: 13rem minmax(0, 1fr);
  gap: 2.5rem;
  align-items: start;
  padding-bottom: 2rem;
}

/* Grid items default to `min-width: auto`, so one wide code sample or table would
   stretch the column past the viewport instead of scrolling inside itself. */
.docs-layout > * { min-width: 0; }

.docs-nav {
  position: sticky;
  top: 5rem;
  font-size: 0.86rem;
  max-height: calc(100vh - 7rem);
  overflow-y: auto;
}

.docs-nav h2 {
  margin: 1.2rem 0 0.45rem;
  font-size: 0.7rem;
  letter-spacing: 0.09em;
  text-transform: uppercase;
  color: var(--faint);
  font-weight: 600;
}
.docs-nav h2:first-child { margin-top: 0; }

.docs-nav ul { list-style: none; margin: 0; padding: 0; }

.docs-nav a {
  display: block;
  padding: 0.22rem 0.55rem;
  border-left: 2px solid transparent;
  color: var(--muted);
  text-decoration: none;
  border-radius: 0 4px 4px 0;
}
.docs-nav a:hover { color: var(--fg); background: var(--bg-tint); }
.docs-nav a.active {
  color: var(--accent-ink);
  border-left-color: var(--accent);
  background: var(--accent-soft);
}
.docs-nav code { font-size: 0.94em; }

.docs h1 {
  margin: 2.5rem 0 0;
  font: 600 2.1rem/1.15 var(--serif);
  letter-spacing: -0.02em;
}
.docs .lede { margin: 0.7rem 0 0; color: var(--muted); max-width: 42rem; }

.docs section { scroll-margin-top: 4.5rem; }

.docs h2 {
  margin: 3rem 0 0.6rem;
  padding-top: 1.5rem;
  border-top: 1px solid var(--line);
  font: 600 1.35rem/1.3 var(--serif);
  letter-spacing: -0.01em;
}

.docs h3 {
  margin: 1.8rem 0 0.5rem;
  font-size: 0.95rem;
  font-weight: 600;
  color: var(--muted);
  letter-spacing: 0.01em;
}

.docs p { margin: 0.7rem 0; }
.docs ul, .docs ol { margin: 0.7rem 0; padding-left: 1.2rem; }
.docs li { margin: 0.3rem 0; }
.docs p, .docs li { max-width: 46rem; }

.docs :not(pre) > code {
  font: 0.86em/1.4 var(--mono);
  background: var(--bg-tint);
  border: 1px solid var(--line-soft);
  border-radius: 4px;
  padding: 0.08em 0.32em;
  word-break: break-word;
}

/* endpoint header line: METHOD /path */

.endpoint {
  display: flex;
  align-items: center;
  gap: 0.6rem;
  flex-wrap: wrap;
  margin: 1.2rem 0 0.2rem;
  padding: 0.55rem 0.75rem;
  border: 1px solid var(--line);
  border-radius: var(--radius-sm);
  background: var(--surface);
  font: 0.88rem/1.4 var(--mono);
  overflow-wrap: anywhere;
}

.method {
  font-size: 0.7rem;
  font-weight: 700;
  letter-spacing: 0.06em;
  padding: 0.15rem 0.45rem;
  border-radius: 4px;
  background: var(--accent-soft);
  color: var(--accent-ink);
}
.method.post { background: var(--warn-soft); color: var(--warn); }

.tier {
  margin-left: auto;
  font: 0.7rem/1 var(--sans);
  letter-spacing: 0.04em;
  text-transform: uppercase;
  color: var(--faint);
}

/* tables */

.docs table {
  width: 100%;
  margin: 0.9rem 0;
  border-collapse: collapse;
  font-size: 0.88rem;
}
.docs th, .docs td {
  text-align: left;
  vertical-align: top;
  padding: 0.5rem 0.7rem 0.5rem 0;
  border-bottom: 1px solid var(--line-soft);
}
.docs th {
  font-size: 0.72rem;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--faint);
  font-weight: 600;
  border-bottom-color: var(--line);
}
.docs td:first-child { white-space: nowrap; font-family: var(--mono); font-size: 0.85rem; }
.docs td em { color: var(--faint); font-style: normal; font-size: 0.85em; }

.table-scroll { overflow-x: auto; }

/* code blocks */

.code {
  position: relative;
  margin: 0.9rem 0;
  border: 1px solid var(--line);
  border-radius: var(--radius-sm);
  background: var(--bg-tint);
}
.code pre {
  margin: 0;
  padding: 0.85rem 4.5rem 0.85rem 0.9rem;
  overflow-x: auto;
  font: 0.82rem/1.6 var(--mono);
  tab-size: 2;
}
.code .copy {
  position: absolute;
  top: 0.45rem;
  right: 0.45rem;
  font-size: 0.72rem;
  padding: 0.18rem 0.55rem;
  border-radius: 999px;
  opacity: 0;
  transition: opacity 0.12s ease;
}
.code:hover .copy, .code .copy:focus-visible { opacity: 1; }
@media (hover: none) {
  .code .copy { opacity: 1; }
}

.note {
  margin: 1rem 0;
  padding: 0.7rem 0.9rem;
  border-left: 3px solid var(--accent);
  border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
  background: var(--accent-soft);
  font-size: 0.89rem;
  color: var(--accent-ink);
}
.note.warn { border-left-color: var(--warn); background: var(--warn-soft); color: var(--warn); }
.note p { margin: 0.35rem 0; max-width: none; }
.note :first-child { margin-top: 0; }
.note :last-child { margin-bottom: 0; }

.status-list { list-style: none; padding-left: 0; }
.status-list li { display: flex; gap: 0.7rem; }
.status-list code { flex: 0 0 3rem; }

@media (max-width: 52rem) {
  .docs-layout { grid-template-columns: 1fr; gap: 1rem; }
  .docs-nav {
    position: static;
    max-height: none;
    padding-bottom: 1rem;
    border-bottom: 1px solid var(--line);
  }
  .docs-nav ul { display: flex; flex-wrap: wrap; gap: 0.2rem; }
  .docs-nav a { border-left: 0; border-radius: 999px; padding: 0.2rem 0.6rem; }
  .docs-nav a.active { border-left: 0; }
  .docs h1 { margin-top: 1.5rem; }
}