/* ============================================
   DOCS — extends /styles.css
   ============================================ */

/* Article layout */
.docs-main {
  max-width: 820px;
  margin: 0 auto;
  padding: 140px 48px 120px;
}

/* Docs index */
.docs-hero { margin-bottom: 64px; }
.docs-hero h1 {
  font-family: var(--font-display);
  font-size: clamp(28px, 4vw, 42px);
  line-height: 1.2; margin-bottom: 16px;
  color: var(--text-bright);
}
.docs-hero p { color: var(--muted); font-size: 17px; line-height: 1.6; max-width: 560px; }

.docs-list {
  display: flex; flex-direction: column; gap: 24px;
}
.docs-list-item {
  display: block; padding: 32px;
  background: var(--bg-glass); border: 1px solid var(--stroke);
  border-top-color: var(--specular);
  border-radius: var(--radius-lg); backdrop-filter: blur(20px);
  box-shadow: 0 12px 36px rgba(0, 0, 0, 0.35);
  transition: border-color 0.25s ease, box-shadow 0.25s ease;
}
.docs-list-item:hover {
  border-color: rgba(86, 210, 193, 0.30);
  border-top-color: rgba(86, 210, 193, 0.45);
  box-shadow: 0 12px 36px rgba(0, 0, 0, 0.35), 0 0 24px rgba(86, 210, 193, 0.06);
}
.docs-list-label {
  font-family: var(--font-mono); font-size: 11px;
  text-transform: uppercase; letter-spacing: 2px;
  color: var(--accent-2); margin-bottom: 8px;
}
.docs-list-item h2 {
  font-family: var(--font-display); font-size: 22px;
  margin-bottom: 8px; color: var(--text-bright);
}
.docs-list-item p { color: var(--muted); font-size: 15px; line-height: 1.6; }

/* Article */
.article-header { margin-bottom: 56px; }
.article-back {
  display: inline-flex; align-items: center; gap: 6px;
  font-family: var(--font-mono); font-size: 13px;
  color: var(--muted); letter-spacing: 1px;
  margin-bottom: 24px; transition: color 0.2s ease;
}
.article-back:hover { color: var(--text); }
.article-header h1 {
  font-family: var(--font-display);
  font-size: clamp(28px, 5vw, 44px);
  line-height: 1.15; margin-bottom: 16px;
  color: var(--text-bright);
}
.article-summary {
  font-size: 19px; color: var(--muted);
  line-height: 1.6; max-width: 640px;
}
.article-meta {
  display: flex; gap: 16px; margin-top: 20px;
  font-family: var(--font-mono); font-size: 12px;
  color: var(--dim); letter-spacing: 1px;
}

/* Article body */
.article-body h2 {
  font-family: var(--font-display);
  font-size: clamp(22px, 3vw, 30px);
  line-height: 1.25; margin: 64px 0 20px;
  color: var(--text-bright);
}
.article-body h3 {
  font-family: var(--font-display);
  font-size: 18px; margin: 40px 0 12px;
  color: var(--text-bright);
}
.article-body p {
  font-size: 16px; color: var(--muted);
  line-height: 1.75; margin-bottom: 20px;
}
.article-body strong { color: var(--text-bright); }
.article-body ul, .article-body ol {
  margin: 0 0 20px 24px; color: var(--muted);
  font-size: 16px; line-height: 1.75;
}
.article-body li { margin-bottom: 6px; }

/* Code blocks */
.code-block {
  position: relative;
  background: rgba(2, 3, 6, 0.85);
  border: 1px solid var(--stroke);
  border-top-color: var(--specular);
  border-radius: var(--radius-md);
  padding: 24px 28px;
  margin: 24px 0 28px;
  overflow-x: auto;
  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.4);
}
.code-block-label {
  position: absolute; top: 12px; right: 16px;
  font-family: var(--font-mono); font-size: 10px;
  text-transform: uppercase; letter-spacing: 2px;
  color: rgba(255, 255, 255, 0.25);
}
.code-block pre {
  font-family: var(--font-mono); font-size: 13px;
  line-height: 1.7; color: var(--muted);
  white-space: pre; margin: 0;
}
.code-block .kw { color: var(--accent-2); }
.code-block .type { color: var(--accent-3); }
.code-block .str { color: var(--accent); }
.code-block .comment { color: rgba(255, 255, 255, 0.30); font-style: italic; }
.code-block .fn { color: #c9a0ff; }
.code-block .op { color: rgba(255, 255, 255, 0.5); }

/* Flow diagrams */
.flow-diagram {
  display: flex; align-items: center; justify-content: center;
  gap: 16px; flex-wrap: wrap;
  margin: 32px 0 36px; padding: 32px 24px;
  background: var(--bg-glass); border: 1px solid var(--stroke);
  border-top-color: var(--specular);
  border-radius: var(--radius-lg); backdrop-filter: blur(16px);
  box-shadow: 0 12px 36px rgba(0, 0, 0, 0.35);
}
.flow-node {
  display: flex; flex-direction: column; align-items: center; gap: 6px;
  padding: 16px 24px; border-radius: var(--radius-md);
  background: rgba(255, 255, 255, 0.05); border: 1px solid rgba(255, 255, 255, 0.10);
  border-top-color: rgba(255, 255, 255, 0.16);
  min-width: 100px;
}
.flow-node code {
  font-size: 14px; font-weight: 600; color: var(--accent-2);
  background: none; border: none; padding: 0;
}
.flow-node span {
  font-size: 11px; color: var(--muted); text-transform: uppercase;
  letter-spacing: 1.5px; font-family: var(--font-mono);
}
.flow-arrow { font-size: 20px; color: var(--stroke); flex-shrink: 0; }

/* Callout */
.callout {
  background: rgba(86, 210, 193, 0.06);
  border: 1px solid rgba(86, 210, 193, 0.2);
  border-radius: var(--radius-md);
  padding: 24px 28px; margin: 28px 0;
}
.callout p { margin-bottom: 0; color: var(--text); font-size: 15px; }
.callout strong { color: var(--accent-2); }

.callout-gold {
  background: rgba(246, 196, 108, 0.06);
  border-color: rgba(246, 196, 108, 0.2);
}
.callout-gold strong { color: var(--accent); }

/* Table */
.doc-table {
  width: 100%; margin: 24px 0 28px;
  border-collapse: collapse;
  font-size: 14px;
}
.doc-table th, .doc-table td {
  text-align: left; padding: 12px 16px;
  border-bottom: 1px solid var(--stroke);
}
.doc-table th {
  font-family: var(--font-mono); font-size: 12px;
  text-transform: uppercase; letter-spacing: 1.5px;
  color: var(--muted);
}
.doc-table td { color: var(--muted); line-height: 1.5; }
.doc-table td code { font-size: 12px; }

/* Article footer nav */
.article-nav {
  display: flex; justify-content: space-between; gap: 24px;
  margin-top: 80px; padding-top: 40px;
  border-top: 1px solid var(--stroke);
}
.article-nav a {
  display: flex; flex-direction: column; gap: 4px;
  padding: 20px 24px; border-radius: var(--radius-md);
  background: var(--bg-glass); border: 1px solid var(--stroke);
  border-top-color: var(--specular);
  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.3);
  transition: border-color 0.2s ease; flex: 1;
}
.article-nav a:hover { border-color: rgba(86, 210, 193, 0.35); }
.article-nav-label {
  font-family: var(--font-mono); font-size: 11px;
  text-transform: uppercase; letter-spacing: 2px; color: var(--muted);
}
.article-nav-title {
  font-family: var(--font-display); font-size: 16px; color: var(--text-bright);
}
.article-nav .next { text-align: right; }

/* Responsive */
@media (max-width: 768px) {
  .docs-main { padding: 120px 20px 60px; }
  .flow-diagram { flex-direction: column; }
  .flow-arrow { transform: rotate(90deg); }
  .article-nav { flex-direction: column; }
  .article-nav .next { text-align: left; }
}