/*
  The developer docs (docs/api.html) — loaded on that page only, after
  style.css, so it builds on the same header, footer and colour tokens.
*/
:root {
  --font-mono: ui-monospace, 'Cascadia Code', 'SFMono-Regular', Menlo, Consolas, monospace;
  --verb-get: #7fd09a;
  --verb-post: #e8b95a;
  --verb-put: #7fb0ec;
  --verb-delete: #f07a7a;
}

.docs {
  display: grid;
  grid-template-columns: 190px minmax(0, 1fr);
  gap: 56px;
  padding-top: 56px;
  padding-bottom: 24px;
}

/* --- contents --- */

.docs-toc {
  position: sticky;
  top: 24px;
  align-self: start;
  max-height: calc(100vh - 48px);
  overflow-y: auto;
  font-size: 0.85rem;
}

.docs-toc p {
  color: var(--color-dim);
  font-size: 0.7rem;
  text-transform: uppercase;
  letter-spacing: 0.09em;
  margin: 18px 0 6px;
}

.docs-toc p:first-child {
  margin-top: 0;
}

.docs-toc a {
  display: block;
  color: var(--color-dim);
  text-decoration: none;
  padding: 3px 0;
}

.docs-toc a:hover,
.docs-toc a:focus-visible {
  color: #fff;
}

/* --- body text --- */

.docs-body {
  min-width: 0;
}

.docs-body h1 {
  color: #fff;
  font-size: 2rem;
  letter-spacing: -0.01em;
  margin: 0 0 8px;
  text-wrap: balance;
}

.docs-body .lede {
  color: var(--color-dim);
  max-width: 62ch;
  margin: 0 0 8px;
}

.docs-body h2 {
  color: #fff;
  font-size: 1.35rem;
  margin: 56px 0 10px;
  padding-top: 28px;
  border-top: 1px solid var(--color-border);
  scroll-margin-top: 16px;
}

.docs-body h3 {
  color: #fff;
  font-size: 1rem;
  margin: 28px 0 8px;
  scroll-margin-top: 16px;
}

.docs-body p,
.docs-body li {
  color: var(--color-dim);
  font-size: 0.95rem;
  max-width: 70ch;
}

.docs-body ol,
.docs-body ul {
  padding-left: 22px;
}

.docs-body li + li {
  margin-top: 6px;
}

.docs-body strong {
  color: var(--color-muted);
}

.docs-body a {
  color: var(--color-brand);
}

.docs-body code {
  font-family: var(--font-mono);
  font-size: 0.85em;
  color: var(--color-muted);
  background: var(--color-elevated);
  border: 1px solid var(--color-border);
  border-radius: 4px;
  padding: 1px 5px;
}

.docs-body pre {
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  border-radius: 8px;
  padding: 14px 16px;
  overflow-x: auto;
  font-size: 0.84rem;
  line-height: 1.6;
  margin: 12px 0 20px;
}

.docs-body pre code {
  background: none;
  border: 0;
  padding: 0;
  font-size: inherit;
  color: var(--color-muted);
}

.callout {
  border: 1px solid var(--color-border-sub);
  background: var(--color-surface);
  border-radius: 8px;
  padding: 12px 16px;
  margin: 20px 0;
}

.callout p {
  margin: 0;
}

.callout p + p {
  margin-top: 8px;
}

/* --- tables --- */

.table-scroll {
  overflow-x: auto;
  margin: 12px 0 20px;
}

.docs-table {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.88rem;
}

.docs-table th,
.docs-table td {
  text-align: left;
  vertical-align: top;
  padding: 9px 12px 9px 0;
  border-bottom: 1px solid var(--color-border);
}

.docs-table th {
  color: var(--color-muted);
  font-weight: 600;
  font-size: 0.75rem;
  text-transform: uppercase;
  letter-spacing: 0.07em;
}

.docs-table td {
  color: var(--color-dim);
}

.docs-table td:first-child {
  white-space: nowrap;
}

/* --- endpoints --- */

.group-note {
  margin: 0 0 12px;
}

.ep {
  border-top: 1px solid var(--color-border);
  padding: 14px 0 12px;
}

.ep-sig {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: 6px 10px;
}

.verb {
  font-family: var(--font-mono);
  font-size: 0.7rem;
  font-weight: 700;
  letter-spacing: 0.04em;
  min-width: 56px;
  text-align: center;
  border-radius: 4px;
  padding: 3px 6px;
}

.verb.get { color: var(--verb-get); background: rgba(127, 208, 154, 0.1); }
.verb.post { color: var(--verb-post); background: rgba(232, 185, 90, 0.1); }
.verb.put,
.verb.patch { color: var(--verb-put); background: rgba(127, 176, 236, 0.1); }
.verb.delete { color: var(--verb-delete); background: rgba(240, 122, 122, 0.1); }

.docs-body .ep-path {
  font-size: 0.9rem;
  color: #fff;
  background: none;
  border: 0;
  padding: 0;
  overflow-wrap: anywhere;
}

.need {
  margin-left: auto;
  font-size: 0.74rem;
  color: var(--color-dim);
  border: 1px solid var(--color-border-sub);
  border-radius: 999px;
  padding: 1px 10px;
  white-space: nowrap;
  font-variant-numeric: tabular-nums;
}

.need.manage {
  color: var(--color-muted);
  border-color: var(--color-brand-dark);
}

.ep p {
  margin: 8px 0 0;
  font-size: 0.9rem;
}

.ep .args {
  font-size: 0.85rem;
}

.ep .args b {
  color: var(--color-muted);
  font-weight: 600;
  margin-right: 4px;
}

@media (max-width: 860px) {
  .docs {
    grid-template-columns: minmax(0, 1fr);
    gap: 8px;
    padding-top: 32px;
  }
  .docs-toc {
    position: static;
    max-height: none;
    border: 1px solid var(--color-border);
    border-radius: 8px;
    padding: 14px 16px;
    order: -1;
  }
  .docs-toc nav {
    columns: 2;
    column-gap: 20px;
  }
  .need {
    margin-left: 0;
  }
}
