/*
  Docs-specific layout and components. Loaded only by layouts/docs.php.
  Design tokens come from tokens.css; base typography from base.css.
*/

/* ---------- Two-column docs shell ---------- */

.docs-shell {
  display: flex;
  min-height: calc(100vh - 64px); /* subtract site-header height */
}

.docs-sidebar {
  width: 240px;
  flex-shrink: 0;
  border-right: 1px solid var(--color-border);
  padding: var(--space-8) 0;
  position: sticky;
  top: 64px;         /* site-header height */
  height: calc(100vh - 64px);
  overflow-y: auto;
}

.docs-content {
  flex: 1;
  min-width: 0;
  padding: var(--space-10) var(--space-12);
}

@media (max-width: 1023px) {
  .docs-shell {
    flex-direction: column;
  }

  .docs-sidebar {
    width: 100%;
    position: static;
    height: auto;
    border-right: none;
    border-bottom: 1px solid var(--color-border);
    padding: var(--space-4) var(--space-6);
  }
}

@media (max-width: 639px) {
  .docs-content {
    padding: var(--space-6) var(--space-4);
  }
}

/* ---------- Sidebar navigation ---------- */

.docs-nav {
  padding: 0 var(--space-4);
}

.docs-nav__group {
  margin-bottom: var(--space-6);
}

.docs-nav__label {
  font-size: 11px;
  font-weight: 600;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--color-text-muted);
  padding: 0 var(--space-3);
  margin-bottom: var(--space-1);
}

.docs-nav__link {
  display: block;
  font-size: 14px;
  color: var(--color-text-secondary);
  padding: 6px var(--space-3);
  border-radius: var(--radius-sm);
  transition: background-color var(--transition-base), color var(--transition-base);
}

.docs-nav__link:hover {
  color: var(--color-text);
  background: var(--color-surface-subtle);
  text-decoration: none;
}

.docs-nav__link--active {
  color: var(--color-primary);
  background: var(--color-primary-subtle);
  font-weight: 500;
}

.docs-nav__link--active:hover {
  color: var(--color-primary);
  background: var(--color-primary-subtle);
}

/* Mobile: inline nav */
@media (max-width: 1023px) {
  .docs-nav {
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-1);
    padding: 0;
  }

  .docs-nav__group {
    margin-bottom: 0;
  }

  .docs-nav__label {
    display: none;
  }

  .docs-nav__link {
    font-size: 13px;
    padding: 4px var(--space-3);
  }
}

/* ---------- Docs prose ---------- */

.docs-prose {
  max-width: 720px;
}

.docs-prose h1 {
  font-size: 32px;
  font-weight: 600;
  letter-spacing: -0.01em;
  color: var(--color-text);
  margin-bottom: var(--space-3);
}

.docs-prose h2 {
  font-size: 22px;
  font-weight: 600;
  color: var(--color-text);
  margin-top: var(--space-12);
  margin-bottom: var(--space-4);
  padding-top: var(--space-6);
  border-top: 1px solid var(--color-border);
}

.docs-prose h2:first-of-type {
  border-top: none;
  padding-top: 0;
}

.docs-prose h3 {
  font-size: 16px;
  font-weight: 600;
  color: var(--color-text);
  margin-top: var(--space-8);
  margin-bottom: var(--space-3);
}

.docs-prose p {
  color: var(--color-text-secondary);
  line-height: 1.7;
  margin-bottom: var(--space-4);
}

.docs-prose p:last-child {
  margin-bottom: 0;
}

.docs-prose ul,
.docs-prose ol {
  color: var(--color-text-secondary);
  line-height: 1.7;
  padding-left: var(--space-6);
  margin-bottom: var(--space-4);
}

.docs-prose li {
  margin-bottom: var(--space-1);
}

.docs-prose code {
  font-family: var(--font-mono);
  font-size: 13px;
  background: var(--color-surface-subtle);
  border: 1px solid var(--color-border);
  padding: 1px 5px;
  border-radius: 4px;
  color: var(--color-text);
}

.docs-prose a {
  color: var(--color-primary);
  text-decoration: underline;
  text-underline-offset: 2px;
}

.docs-prose a:hover {
  color: var(--color-primary-hover);
}

/* ---------- Section divider ---------- */

.docs-section {
  margin-bottom: var(--space-12);
}

/* ---------- Endpoint display ---------- */

.endpoint {
  display: flex;
  align-items: center;
  gap: var(--space-3);
  background: var(--color-code-bg);
  border-radius: var(--radius-md);
  padding: var(--space-3) var(--space-4);
  margin-bottom: var(--space-6);
}

.endpoint__method {
  font-family: var(--font-mono);
  font-size: 12px;
  font-weight: 700;
  letter-spacing: 0.04em;
  color: #10b981;   /* green — GET method only for MVP */
  background: rgba(16, 185, 129, 0.12);
  padding: 3px 8px;
  border-radius: 4px;
  flex-shrink: 0;
}

.endpoint__path {
  font-family: var(--font-mono);
  font-size: 14px;
  color: var(--color-code-text);
  word-break: break-all;
}

/* ---------- Parameter tables ---------- */

.param-table {
  width: 100%;
  border-collapse: collapse;
  font-size: 14px;
  margin-bottom: var(--space-6);
}

.param-table th {
  text-align: left;
  font-size: 12px;
  font-weight: 600;
  letter-spacing: 0.04em;
  text-transform: uppercase;
  color: var(--color-text-muted);
  border-bottom: 1px solid var(--color-border);
  padding: var(--space-2) var(--space-3);
}

.param-table td {
  vertical-align: top;
  padding: var(--space-3);
  border-bottom: 1px solid var(--color-border);
  color: var(--color-text-secondary);
  line-height: 1.5;
}

.param-table tr:last-child td {
  border-bottom: none;
}

.param-table td:first-child {
  font-family: var(--font-mono);
  font-size: 13px;
  color: var(--color-text);
  white-space: nowrap;
}

.param-table td:nth-child(2) {
  color: var(--color-text-muted);
  font-size: 12px;
  white-space: nowrap;
}

.param__required {
  color: var(--color-danger);
  font-size: 11px;
  font-weight: 600;
}

/* ---------- Code tabs (language switcher) ---------- */

.code-tabs {
  border-radius: var(--radius-md);
  overflow: hidden;
  border: 1px solid rgba(255, 255, 255, 0.06);
  margin-bottom: var(--space-6);
}

.code-tabs__nav {
  display: flex;
  background: #1e293b;
  border-bottom: 1px solid rgba(255, 255, 255, 0.06);
  padding: 0 var(--space-3);
}

.code-tab {
  font-size: 12px;
  font-weight: 500;
  color: #94a3b8;
  padding: var(--space-2) var(--space-3);
  border: none;
  background: none;
  cursor: pointer;
  border-bottom: 2px solid transparent;
  transition: color var(--transition-base), border-color var(--transition-base);
  margin-bottom: -1px;
}

.code-tab:hover {
  color: #e2e8f0;
}

.code-tab.active {
  color: #e2e8f0;
  border-bottom-color: var(--color-primary);
}

.code-panel {
  background: var(--color-code-bg);
}

.code-panel pre {
  margin: 0;
  padding: var(--space-4);
  overflow-x: auto;
  font-family: var(--font-mono);
  font-size: 13px;
  line-height: 1.6;
  color: var(--color-code-text);
}

/* ---------- Callout / note boxes ---------- */

.docs-note {
  display: flex;
  gap: var(--space-3);
  background: var(--color-primary-subtle);
  border-left: 3px solid var(--color-primary);
  border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
  padding: var(--space-4);
  margin-bottom: var(--space-6);
  font-size: 14px;
  color: var(--color-text-secondary);
  line-height: 1.6;
}

.docs-note--warning {
  background: #fffbeb;
  border-left-color: var(--color-warning);
}

/* ---------- Response field reference ---------- */

.field-table {
  width: 100%;
  border-collapse: collapse;
  font-size: 14px;
  margin-bottom: var(--space-6);
}

.field-table th {
  text-align: left;
  font-size: 12px;
  font-weight: 600;
  letter-spacing: 0.04em;
  text-transform: uppercase;
  color: var(--color-text-muted);
  border-bottom: 1px solid var(--color-border);
  padding: var(--space-2) var(--space-3);
}

.field-table td {
  vertical-align: top;
  padding: var(--space-3);
  border-bottom: 1px solid var(--color-border);
  color: var(--color-text-secondary);
  line-height: 1.5;
}

.field-table tr:last-child td {
  border-bottom: none;
}

.field-table td:first-child {
  font-family: var(--font-mono);
  font-size: 13px;
  color: var(--color-text);
  white-space: nowrap;
}

.field-table td:nth-child(2) {
  color: var(--color-primary);
  font-size: 12px;
  font-family: var(--font-mono);
  white-space: nowrap;
}

/* ---------- Error code table ---------- */

.error-table {
  width: 100%;
  border-collapse: collapse;
  font-size: 14px;
  margin-bottom: var(--space-6);
}

.error-table th {
  text-align: left;
  font-size: 12px;
  font-weight: 600;
  letter-spacing: 0.04em;
  text-transform: uppercase;
  color: var(--color-text-muted);
  border-bottom: 1px solid var(--color-border);
  padding: var(--space-2) var(--space-3);
}

.error-table td {
  vertical-align: top;
  padding: var(--space-3);
  border-bottom: 1px solid var(--color-border);
  color: var(--color-text-secondary);
  line-height: 1.5;
}

.error-table tr:last-child td {
  border-bottom: none;
}

.error-table td:first-child {
  font-family: var(--font-mono);
  font-size: 12px;
  color: var(--color-text);
  white-space: nowrap;
}

.http-status {
  display: inline-block;
  font-family: var(--font-mono);
  font-size: 12px;
  font-weight: 600;
  padding: 2px 6px;
  border-radius: 4px;
}

.http-status--200 { background: #dcfce7; color: #15803d; }
.http-status--400 { background: #fef9c3; color: #854d0e; }
.http-status--401 { background: #fee2e2; color: #991b1b; }
.http-status--404 { background: #f3f4f6; color: #374151; }
.http-status--422 { background: #fef9c3; color: #854d0e; }
.http-status--429 { background: #fce7f3; color: #9d174d; }
.http-status--500 { background: #fee2e2; color: #991b1b; }

/* ---------- Plan tier table ---------- */

.plan-table {
  width: 100%;
  border-collapse: collapse;
  font-size: 14px;
  margin-bottom: var(--space-6);
}

.plan-table th {
  text-align: left;
  font-size: 12px;
  font-weight: 600;
  letter-spacing: 0.04em;
  text-transform: uppercase;
  color: var(--color-text-muted);
  border-bottom: 1px solid var(--color-border);
  padding: var(--space-2) var(--space-3);
}

.plan-table td {
  padding: var(--space-3);
  border-bottom: 1px solid var(--color-border);
  color: var(--color-text-secondary);
}

.plan-table tr:last-child td {
  border-bottom: none;
}

.plan-table td:first-child {
  font-weight: 500;
  color: var(--color-text);
}

/* ---------- Quickstart steps ---------- */

.quickstart-steps {
  counter-reset: step;
  list-style: none;
  padding: 0;
  margin-bottom: var(--space-8);
}

.quickstart-steps li {
  display: flex;
  gap: var(--space-4);
  margin-bottom: var(--space-6);
  counter-increment: step;
}

.quickstart-steps li::before {
  content: counter(step);
  display: flex;
  align-items: center;
  justify-content: center;
  width: 28px;
  height: 28px;
  border-radius: 50%;
  background: var(--color-primary-subtle);
  color: var(--color-primary);
  font-size: 13px;
  font-weight: 600;
  flex-shrink: 0;
  margin-top: 1px;
}

.quickstart-steps li > div {
  flex: 1;
}

.quickstart-steps li strong {
  display: block;
  color: var(--color-text);
  margin-bottom: var(--space-2);
}