/* ═══════════════════════════════════════════════════════════════════════════
   pages/documentation.css — Documentation Page Styles
   ═══════════════════════════════════════════════════════════════════════════ */

/* ── Docs Hero ────────────────────────────────────────────────────────────── */

.docs-hero::before {
  content: '';
  position: absolute;
  inset: 0;
  background-image: url("data:image/svg+xml,%3Csvg width='40' height='40' viewBox='0 0 40 40' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M20 5 L35 20 L20 35 L5 20 Z' fill='none' stroke='rgba(255,255,255,0.04)' stroke-width='1'/%3E%3C/svg%3E");
  background-size: 40px 40px;
  pointer-events: none;
}




/* ── Docs Layout (sidebar + content) ─────────────────────────────────────── */
.docs-layout {
  display: grid;
  grid-template-columns: 260px 1fr;
  gap: var(--space-12);
  padding-block: var(--space-12);
  align-items: start;
}

/* ── Sidebar ──────────────────────────────────────────────────────────────── */
.docs-sidebar {
  position: sticky;
  top: calc(64px + var(--space-6)); /* nav height + offset */
  max-height: calc(100vh - 80px);
  overflow-y: auto;
}

.docs-sidebar__nav {}

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

.docs-sidebar__heading {
  font-size: var(--font-size-xs);
  font-weight: var(--font-weight-semibold);
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--color-text-primary);
  margin-bottom: var(--space-3);
  padding-bottom: var(--space-2);
  border-bottom: 1px solid var(--color-border);
}

.docs-sidebar__links {
  list-style: none;
  display: flex;
  flex-direction: column;
  gap: var(--space-1);
}

.docs-sidebar__links a {
  display: block;
  padding: var(--space-2) var(--space-3);
  font-size: var(--font-size-sm);
  color: var(--color-text-primary);
  text-decoration: none;
  border-radius: var(--radius-md);
  border-left: 2px solid transparent;
  transition: background-color var(--transition-fast),
              color var(--transition-fast),
              border-color var(--transition-fast);
}

.docs-sidebar__links a:hover {
  background-color: var(--color-bg-light);
  color: var(--color-text-primary);
}

.docs-sidebar__links a.active {
  background-color: var(--color-primary-light);
  color: var(--color-primary);
  border-left-color: var(--color-primary);
  font-weight: var(--font-weight-medium);
}

/* ── Docs Content ─────────────────────────────────────────────────────────── */
.docs-content {
  min-width: 0; /* prevent grid overflow */
}

.docs-section {
  padding-bottom: var(--space-16);
  margin-bottom: var(--space-16);
  border-bottom: 1px solid var(--color-border);
}

.docs-section:last-child {
  border-bottom: none;
}


.docs-section__subtitle {
  font-size: var(--font-size-xl);
  font-weight: var(--font-weight-semibold);
  color: var(--color-text-primary);
  margin-top: var(--space-8);
  margin-bottom: var(--space-4);
  scroll-margin-top: calc(64px + var(--space-8));
}

.docs-section p {
  font-size: var(--font-size-base);
  color: var(--color-text-secondary);
  line-height: var(--line-height-relaxed);
  margin-bottom: var(--space-4);
}

/* Inline call-out note */
.docs-note {
  display: flex;
  gap: var(--space-3);
  padding: var(--space-4) var(--space-5);
  background-color: var(--color-primary-light);
  border-left: 3px solid var(--color-primary);
  border-radius: 0 var(--radius-md) var(--radius-md) 0;
  margin-block: var(--space-6);
  font-size: var(--font-size-sm);
  color: var(--color-primary-dark);
  line-height: var(--line-height-relaxed);
}

.docs-note__icon {
  flex-shrink: 0;
  width: 18px;
  height: 18px;
  color: var(--color-primary);
  margin-top: 1px;
}

/* YAML/code block container with filename header */
.code-block {
  margin-block: var(--space-6);
  border-radius: var(--radius-md);
  overflow: hidden;
  border: 1px solid rgba(255, 255, 255, 0.08);
}

.code-block__header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: var(--space-2) var(--space-4);
  background-color: #252525;
  border-bottom: 1px solid rgba(255, 255, 255, 0.06);
}

.code-block__filename {
  font-family: var(--font-mono);
  font-size: var(--font-size-xs);
  color: rgba(255, 255, 255, 0.5);
}

.code-block__lang {
  font-size: var(--font-size-xs);
  color: rgba(255, 255, 255, 0.3);
  text-transform: uppercase;
  letter-spacing: 0.06em;
}

.code-block pre {
  border-radius: 0;
  margin: 0;
  border: none;
}

/* Env var table */
.env-table-wrap {
  overflow-x: auto;
  margin-block: var(--space-6);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
}

.env-table-wrap table {
  min-width: 700px;
}

.env-table-wrap th:first-child,
.env-table-wrap td:first-child {
  font-family: var(--font-mono);
  font-size: var(--font-size-xs);
  white-space: nowrap;
}

/* Exit code table */
.exit-table {
  margin-block: var(--space-6);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
  overflow: hidden;
}

.exit-code-badge {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 28px;
  height: 28px;
  border-radius: var(--radius-full);
  font-family: var(--font-mono);
  font-size: var(--font-size-sm);
  font-weight: var(--font-weight-bold);
}

.exit-code-badge--pass  { background-color: #dcfce7; color: #166534; }
.exit-code-badge--fail  { background-color: var(--color-primary-light); color: var(--color-primary-dark); }
.exit-code-badge--timeout { background-color: #fef9c3; color: #713f12; }

/* Ecosystem grid */
.ecosystem-docs-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
  gap: var(--space-3);
  margin-block: var(--space-6);
}

.ecosystem-doc-card {
  border: 1px solid var(--color-border);
  border-radius: var(--radius-md);
  padding: var(--space-4);
  background-color: var(--color-bg-light);
}

.ecosystem-doc-card__name {
  font-size: var(--font-size-sm);
  font-weight: var(--font-weight-semibold);
  color: var(--color-text-primary);
  margin-bottom: var(--space-2);
}

.ecosystem-doc-card__files {
  font-size: var(--font-size-xs);
  font-family: var(--font-mono);
  color: var(--color-text-primary);
  line-height: var(--line-height-relaxed);
}

/* API endpoint table */
.api-table-wrap {
  overflow-x: auto;
  margin-block: var(--space-6);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
}

.api-table-wrap table {
  min-width: 640px;
}

.method-badge {
  display: inline-block;
  padding: 0.15rem 0.5rem;
  font-family: var(--font-mono);
  font-size: var(--font-size-xs);
  font-weight: var(--font-weight-bold);
  border-radius: var(--radius-sm);
  text-transform: uppercase;
}

.method-badge--get    { background-color: #dbeafe; color: #1e40af; }
.method-badge--post   { background-color: #dcfce7; color: #166534; }
.method-badge--put    { background-color: #fef9c3; color: #713f12; }
.method-badge--delete { background-color: #fee2e2; color: #991b1b; }

.auth-badge {
  display: inline-block;
  padding: 0.15rem 0.5rem;
  font-size: var(--font-size-xs);
  font-weight: var(--font-weight-semibold);
  border-radius: var(--radius-full);
}

.auth-badge--required { background-color: var(--color-primary-light); color: var(--color-primary-dark); }
.auth-badge--admin    { background-color: #ede9fe; color: #5b21b6; }
.auth-badge--public   { background-color: var(--color-bg-light); color: var(--color-text-primary); }
.auth-badge--secret   { background-color: #fef9c3; color: #713f12; }

/* ── Responsive ───────────────────────────────────────────────────────────── */
@media (max-width: 1024px) {
  .docs-layout {
    grid-template-columns: 1fr;
  }

  .docs-sidebar {
    position: static;
    max-height: none;
    overflow: visible;
    border: 1px solid var(--color-border);
    border-radius: var(--radius-lg);
    padding: var(--space-5);
    background-color: var(--color-bg-light);
  }
}
.docs-main .section-title {
  scroll-margin-top: calc(64px + var(--space-8));
}