/* =========================================================================
   docs.css — API reference page
   Sticky TOC sidebar + readable prose column + tabbed code blocks + callouts.
   Content sits in double-bezel frosted panels so text stays crisp over the sky.
   ========================================================================= */

.doc-hero {
  padding-top: clamp(7rem, 16vw, 9rem);
  padding-bottom: clamp(2rem, 5vw, 3rem);
  text-align: center;
}
.doc-hero h1 {
  font-size: var(--step-hero);
  margin-bottom: 0.6rem;
}
.doc-hero p {
  max-width: 52ch;
  margin-inline: auto;
  color: var(--ink-soft);
  font-size: 1.1rem;
}

/* layout: sticky sidebar TOC + content */
.doc-layout {
  display: grid;
  grid-template-columns: 230px minmax(0, 1fr);
  gap: clamp(1.5rem, 4vw, 3.5rem);
  align-items: start;
  padding-bottom: var(--space-section);
}

.doc-toc {
  position: sticky;
  top: 6rem;
  align-self: start;
  background: var(--panel);
  backdrop-filter: blur(14px);
  -webkit-backdrop-filter: blur(14px);
  border: 1px solid var(--panel-border);
  border-radius: var(--radius-card);
  padding: 1.2rem 1rem;
  box-shadow: 0 12px 30px rgba(157, 170, 242, 0.14);
}
.doc-toc h2 {
  font-family: var(--font-display);
  font-size: 0.72rem;
  letter-spacing: 0.14em;
  text-transform: uppercase;
  color: var(--rose-deep);
  margin-bottom: 0.7rem;
}
.doc-toc ul { list-style: none; }
.doc-toc li { margin-bottom: 0.15rem; }
.doc-toc a {
  display: block;
  padding: 0.4em 0.7em;
  border-radius: 10px;
  font-size: 0.92rem;
  color: var(--ink-soft);
  font-weight: 600;
}
.doc-toc a:hover { background: rgba(255, 143, 171, 0.12); color: var(--ink); }
.doc-toc a[aria-current="true"] {
  color: var(--rose-deep);
  background: rgba(255, 143, 171, 0.16);
}

/* the readable content column */
.doc-content { min-width: 0; }
.doc-content section {
  scroll-margin-top: 6rem;          /* offset for the floating nav on anchor jump */
}
.doc-content h2 {
  font-size: var(--step-h2);
  margin-top: clamp(2.5rem, 6vw, 3.5rem);
  margin-bottom: 0.8rem;
}
.doc-content h2:first-child { margin-top: 0; }
.doc-content h3 {
  font-size: var(--step-h3);
  margin-top: 1.8rem;
  margin-bottom: 0.5rem;
}
.doc-content p, .doc-content li {
  color: var(--ink);
  line-height: 1.7;
}
.doc-content ul { padding-left: 1.3em; margin-bottom: 1rem; }
.doc-content li { margin-bottom: 0.3rem; }
.doc-content code {
  font-family: 'JetBrains Mono', monospace;
  font-size: 0.86em;
  background: rgba(255, 143, 171, 0.14);
  color: var(--rose-deep);
  padding: 0.12em 0.4em;
  border-radius: 6px;
}

/* double-bezel panel wrapper for code + tables */
.bezel {
  background: rgba(255, 245, 248, 0.5);
  border: 1px solid var(--panel-border);
  border-radius: 24px;
  padding: 5px;
  box-shadow: 0 14px 36px rgba(157, 170, 242, 0.16);
  margin: 1rem 0 1.5rem;
}
.bezel > * { border-radius: 19px; }

/* tabbed code blocks */
.code-tabs {
  display: flex;
  gap: 0.2rem;
  padding: 0.5rem 0.6rem 0;
  background: transparent;
}
.code-tabs button {
  border: none;
  background: transparent;
  color: var(--ink-soft);
  font-family: var(--font-display);
  font-weight: 700;
  font-size: 0.82rem;
  padding: 0.5em 0.9em;
  border-radius: 12px 12px 0 0;
  cursor: pointer;
  transition: background var(--dur-fast) var(--ease-gentle), color var(--dur-fast) var(--ease-gentle);
}
.code-tabs button:hover { color: var(--ink); }
.code-tabs button[aria-selected="true"] {
  color: #fff;
  background: var(--ink);
}
.code-panel {
  display: none;
  margin: 0;
  padding: 1.1rem 1.3rem;
  background: var(--ink);
  color: #F4ECFF;
  font-family: 'JetBrains Mono', monospace;
  font-size: 0.84rem;
  line-height: 1.65;
  overflow-x: auto;
  white-space: pre;
}
.code-panel[data-active="true"] { display: block; }
.code-panel .tok-key { color: #FFB3C8; }      /* rose for keys      */
.code-panel .tok-str { color: #B9F5C8; }      /* mint for strings   */
.code-panel .tok-com { color: #9D8AB8; }      /* muted for comments */
.code-panel .tok-num { color: #FFE94D; }      /* yellow for numbers */

/* inline copy on code panels */
.code-wrap { position: relative; }
.code-copy {
  position: absolute;
  top: 0.6rem;
  right: 0.6rem;
  background: rgba(255, 255, 255, 0.12);
  color: #fff;
  border: 1px solid rgba(255, 255, 255, 0.18);
  border-radius: 8px;
  padding: 0.3em 0.7em;
  font-family: var(--font-display);
  font-weight: 700;
  font-size: 0.74rem;
  cursor: pointer;
  opacity: 0;
  transition: opacity var(--dur-fast) var(--ease-soft), background var(--dur-fast);
}
.code-wrap:hover .code-copy { opacity: 1; }
.code-copy:hover { background: rgba(255, 255, 255, 0.22); }

/* callouts */
.callout {
  display: flex;
  gap: 0.8rem;
  align-items: flex-start;
  padding: 1rem 1.2rem;
  border-radius: 16px;
  margin: 1.2rem 0;
  font-size: 0.96rem;
  border: 1px solid transparent;
}
.callout .ico {
  flex-shrink: 0;
  width: 24px; height: 24px;
  border-radius: 50%;
  display: grid; place-items: center;
  font-family: var(--font-display);
  font-weight: 700;
  font-size: 0.85rem;
  color: #fff;
}
.callout.note  { background: rgba(157, 170, 242, 0.14); border-color: rgba(157, 170, 242, 0.3); }
.callout.note .ico { background: var(--whale); }
.callout.warn  { background: rgba(255, 201, 60, 0.14); border-color: rgba(255, 201, 60, 0.4); }
.callout.warn .ico { background: #FFC93C; color: var(--ink); }

/* endpoint + error tables */
.doc-table {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.92rem;
  margin: 1rem 0 1.5rem;
}
.doc-table th, .doc-table td {
  text-align: left;
  padding: 0.7em 0.9em;
  border-bottom: 1px solid rgba(255, 143, 171, 0.16);
}
.doc-table th {
  font-family: var(--font-display);
  font-size: 0.74rem;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--rose-deep);
}
.doc-table code { font-size: 0.82em; }

@media (max-width: 880px) {
  .doc-layout { grid-template-columns: 1fr; }
  .doc-toc { position: static; }
}