// _docs.scss — Developer platform docs pages (.devdocs-* prefix)

// ── Layout ───────────────────────────────────────────────────────────────────

.devdocs {
  display: flex;
  flex-direction: column;
  min-height: 100vh;
  padding: 0;
}

.devdocs-hero {
  border-bottom: 1px solid var(--border-default);
  padding: var(--space-10) 0 var(--space-8);
}

.devdocs-hero-inner {
  max-width: 900px;
  margin: 0 auto;
  padding: 0 var(--space-6);
}

.devdocs-eyebrow {
  font-size: 11px;
  font-weight: 600;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--color-accent);
  margin-bottom: var(--space-2);
  display: block;
}

.devdocs-hero-title {
  font-size: clamp(28px, 5vw, 44px);
  font-weight: 800;
  color: var(--text-primary);
  letter-spacing: -0.02em;
  line-height: 1.1;
  margin: 0 0 var(--space-4);
}

.devdocs-hero-lead {
  font-size: var(--font-size-md);
  color: var(--text-secondary);
  line-height: 1.65;
  max-width: 640px;
  margin: 0 0 var(--space-6);
}

// ── Phase index cards ─────────────────────────────────────────────────────────

.devdocs-phase-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(260px, 1fr));
  gap: var(--space-4);
  padding: var(--space-8) 0;
}

.devdocs-phase-card {
  display: flex;
  flex-direction: column;
  gap: var(--space-3);
  padding: var(--space-5);
  border-radius: 10px;
  border: 1px solid var(--border-default);
  background: var(--bg-surface);
  text-decoration: none;
  transition: border-color 0.15s, background 0.15s;
  border-left: 3px solid color-mix(in srgb, var(--color-accent) 35%, transparent);

  &:hover {
    border-color: var(--color-accent);
    background: var(--bg-overlay);
    text-decoration: none;
  }

  &--active {
    border-left-color: var(--color-accent);
    background: color-mix(in srgb, var(--color-accent) 5%, var(--bg-surface));
  }
}

.devdocs-phase-card__num {
  font-size: 11px;
  font-family: var(--font-mono);
  font-weight: 700;
  color: var(--color-accent);
  opacity: 0.6;
}

.devdocs-phase-card__title {
  font-size: 15px;
  font-weight: 600;
  color: var(--text-primary);
  margin: 0;
}

.devdocs-phase-card__desc {
  font-size: 13px;
  color: var(--text-muted);
  margin: 0;
  line-height: 1.5;
}

.devdocs-phase-card__tags {
  display: flex;
  flex-wrap: wrap;
  gap: 4px;
  margin-top: auto;
  padding-top: var(--space-2);
}

.devdocs-tag {
  font-size: 11px;
  font-family: var(--font-mono);
  padding: 1px 6px;
  border-radius: 4px;
  background: var(--bg-overlay);
  color: var(--text-muted);
  border: 1px solid var(--border-subtle);
}

// ── Two-column docs layout (phase pages) ─────────────────────────────────────

.devdocs-layout {
  display: grid;
  grid-template-columns: 220px 1fr;
  gap: 0;
  max-width: 1100px;
  margin: 0 auto;
  width: 100%;
  padding: 0 var(--space-6);
  align-items: start;

  @media (max-width: 768px) {
    grid-template-columns: 1fr;
  }
}

// ── Sidebar nav ───────────────────────────────────────────────────────────────

.devdocs-sidebar {
  position: sticky;
  top: 56px; // below the global nav
  max-height: calc(100vh - 72px);
  overflow-y: auto;
  padding: var(--space-8) var(--space-5) var(--space-8) 0;

  @media (max-width: 768px) { display: none; }
}

.devdocs-nav-group {
  margin-bottom: var(--space-5);
}

.devdocs-nav-group-label {
  font-size: 10px;
  font-weight: 700;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--text-muted);
  margin-bottom: var(--space-2);
  padding: 0 var(--space-2);
}

.devdocs-nav-link {
  display: block;
  font-size: 13px;
  color: var(--text-secondary);
  text-decoration: none;
  padding: 4px var(--space-2);
  border-radius: 5px;
  border-left: 2px solid transparent;
  transition: color 0.1s, background 0.1s;
  line-height: 1.4;

  &:hover {
    color: var(--text-primary);
    background: var(--bg-overlay);
    text-decoration: none;
  }

  &--active {
    color: var(--color-accent-link);
    border-left-color: var(--color-accent);
    background: color-mix(in srgb, var(--color-accent) 8%, transparent);
  }

  &--phase {
    font-weight: 500;
  }

  &--sub {
    font-size: 12px;
    color: var(--text-muted);
    padding-left: var(--space-4);
  }
}

// ── Content area ──────────────────────────────────────────────────────────────

.devdocs-content {
  min-width: 0;
  padding: var(--space-8) 0 var(--space-12) var(--space-8);
  border-left: 1px solid var(--border-subtle);

  @media (max-width: 768px) { padding-left: 0; border-left: none; }
}

.devdocs-phase-header {
  margin-bottom: var(--space-8);
  padding-bottom: var(--space-6);
  border-bottom: 1px solid var(--border-default);
}

.devdocs-phase-num {
  font-size: 11px;
  font-family: var(--font-mono);
  font-weight: 700;
  color: var(--color-accent);
  letter-spacing: 0.06em;
  margin-bottom: var(--space-2);
  display: block;
}

.devdocs-phase-title {
  font-size: clamp(24px, 4vw, 34px);
  font-weight: 800;
  color: var(--text-primary);
  letter-spacing: -0.02em;
  margin: 0 0 var(--space-3);
  line-height: 1.15;
}

.devdocs-phase-desc {
  font-size: var(--font-size-base);
  color: var(--text-secondary);
  line-height: 1.7;
  max-width: 600px;
  margin: 0;
}

// ── Section ───────────────────────────────────────────────────────────────────

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

.devdocs-section-title {
  font-size: 20px;
  font-weight: 700;
  color: var(--text-primary);
  margin: 0 0 var(--space-2);
  letter-spacing: -0.01em;
  scroll-margin-top: 72px;

  a {
    color: inherit;
    text-decoration: none;
    &:hover { color: var(--color-accent-link); }
  }
}

.devdocs-subsection-title {
  font-size: 15px;
  font-weight: 600;
  color: var(--text-primary);
  margin: var(--space-6) 0 var(--space-2);
  scroll-margin-top: 72px;

  a {
    color: inherit;
    text-decoration: none;
    &:hover { color: var(--color-accent-link); }
  }
}

.devdocs-content p {
  font-size: var(--font-size-base);
  color: var(--text-secondary);
  line-height: 1.7;
  margin: 0 0 var(--space-4);

  code {
    font-size: 13px;
    background: var(--bg-overlay);
    border: 1px solid var(--border-default);
    border-radius: 4px;
    padding: 1px 5px;
    color: var(--color-purple);
    font-family: var(--font-mono);
  }

  a {
    color: var(--color-accent-link);
    text-decoration: none;
    &:hover { text-decoration: underline; }
  }
}

// ── Code blocks ───────────────────────────────────────────────────────────────

.devdocs-code-block {
  margin: var(--space-4) 0;
  border-radius: 8px;
  border: 1px solid var(--border-default);
  overflow: hidden;
  background: #0d1117;
}

.devdocs-code-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 6px 12px;
  background: var(--bg-overlay);
  border-bottom: 1px solid var(--border-default);
}

.devdocs-code-lang {
  font-size: 11px;
  font-weight: 600;
  font-family: var(--font-mono);
  color: var(--text-muted);
  letter-spacing: 0.04em;
  text-transform: uppercase;
}

.devdocs-code-label {
  font-size: 11px;
  color: var(--text-muted);
  font-style: italic;
}

.devdocs-code-block pre {
  margin: 0;
  padding: var(--space-4) var(--space-5);
  font-size: 13px;
  font-family: var(--font-mono);
  line-height: 1.65;
  color: #abb2bf;
  overflow-x: auto;
  background: transparent;
  border: none;
  border-radius: 0;
}

// Minimal token colors (One Dark-ish)
.devdocs-code-block .tok-kw  { color: #c678dd; }
.devdocs-code-block .tok-str { color: #98c379; }
.devdocs-code-block .tok-num { color: #d19a66; }
.devdocs-code-block .tok-cmt { color: #5c6370; font-style: italic; }
.devdocs-code-block .tok-key { color: #e06c75; }  // JSON keys
.devdocs-code-block .tok-fn  { color: #61afef; }
.devdocs-code-block .tok-type{ color: #e5c07b; }
.devdocs-code-block .tok-var { color: #abb2bf; }
.devdocs-code-block .tok-punc{ color: #abb2bf; }
.devdocs-code-block .tok-acc { color: #56b6c2; }  // accent (sha256 prefix etc.)

// ── Field reference tables ────────────────────────────────────────────────────

.devdocs-table {
  width: 100%;
  font-size: 13px;
  border-collapse: collapse;
  margin: var(--space-4) 0;

  th {
    text-align: left;
    font-size: 11px;
    font-weight: 700;
    letter-spacing: 0.06em;
    text-transform: uppercase;
    color: var(--text-muted);
    padding: 6px 10px;
    border-bottom: 1px solid var(--border-default);
  }

  td {
    padding: 7px 10px;
    border-bottom: 1px solid var(--border-subtle);
    color: var(--text-secondary);
    vertical-align: top;
    line-height: 1.5;
  }

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

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

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

// ── Callouts ──────────────────────────────────────────────────────────────────

.devdocs-callout {
  display: flex;
  gap: var(--space-3);
  padding: var(--space-4);
  border-radius: 8px;
  border: 1px solid color-mix(in srgb, var(--color-accent) 25%, transparent);
  background: color-mix(in srgb, var(--color-accent) 6%, transparent);
  margin: var(--space-4) 0;
  font-size: 13px;
  color: var(--text-secondary);
  line-height: 1.6;

  &--warn {
    border-color: color-mix(in srgb, var(--color-warning) 30%, transparent);
    background: color-mix(in srgb, var(--color-warning) 6%, transparent);
  }

  code {
    font-family: var(--font-mono);
    font-size: 12px;
    background: var(--bg-overlay);
    border: 1px solid var(--border-default);
    border-radius: 3px;
    padding: 1px 5px;
    color: var(--color-purple);
  }
}

.devdocs-callout-icon {
  flex-shrink: 0;
  width: 16px;
  height: 16px;
  margin-top: 1px;
  color: var(--color-accent);
  .devdocs-callout--warn & { color: var(--color-warning); }
}

// ── Inline badges ─────────────────────────────────────────────────────────────

.devdocs-badge {
  display: inline-block;
  font-size: 10px;
  font-weight: 700;
  font-family: var(--font-mono);
  padding: 1px 6px;
  border-radius: 4px;
  vertical-align: middle;
  letter-spacing: 0.04em;

  &--hard { background: color-mix(in srgb, var(--color-danger) 15%, transparent); color: var(--color-danger); border: 1px solid color-mix(in srgb, var(--color-danger) 25%, transparent); }
  &--warn { background: color-mix(in srgb, var(--color-warning) 15%, transparent); color: var(--color-warning); border: 1px solid color-mix(in srgb, var(--color-warning) 25%, transparent); }
  &--ok   { background: color-mix(in srgb, var(--color-success) 15%, transparent); color: var(--color-success); border: 1px solid color-mix(in srgb, var(--color-success) 25%, transparent); }
  &--info { background: color-mix(in srgb, var(--color-accent) 15%, transparent); color: var(--color-accent); border: 1px solid color-mix(in srgb, var(--color-accent) 25%, transparent); }
}

// ── Phase nav breadcrumb ──────────────────────────────────────────────────────

.devdocs-breadcrumb {
  display: flex;
  align-items: center;
  gap: 6px;
  font-size: 12px;
  color: var(--text-muted);
  margin-bottom: var(--space-6);

  a {
    color: var(--color-accent-link);
    text-decoration: none;
    &:hover { text-decoration: underline; }
  }

  span { color: var(--text-muted); }
}

.devdocs-phase-nav {
  display: flex;
  justify-content: space-between;
  align-items: center;
  margin-top: var(--space-10);
  padding-top: var(--space-6);
  border-top: 1px solid var(--border-default);
}

.devdocs-phase-nav-btn {
  display: flex;
  align-items: center;
  gap: 6px;
  font-size: 13px;
  font-weight: 500;
  color: var(--text-secondary);
  text-decoration: none;
  padding: 6px 12px;
  border-radius: 6px;
  border: 1px solid var(--border-default);
  transition: border-color 0.15s, color 0.15s;

  &:hover {
    border-color: var(--color-accent);
    color: var(--color-accent-link);
    text-decoration: none;
  }

  &--next { flex-direction: row-reverse; }
}

// ── Landing index ─────────────────────────────────────────────────────────────

.devdocs-index {
  max-width: 900px;
  margin: 0 auto;
  padding: var(--space-8) var(--space-6) var(--space-12);
}

.devdocs-index-intro {
  display: grid;
  grid-template-columns: 1fr auto;
  gap: var(--space-8);
  align-items: start;
  margin-bottom: var(--space-10);
  padding-bottom: var(--space-8);
  border-bottom: 1px solid var(--border-default);
}

.devdocs-stat-cluster {
  display: flex;
  flex-direction: column;
  gap: var(--space-3);
  flex-shrink: 0;
}

.devdocs-stat {
  text-align: right;
}

.devdocs-stat-num {
  font-size: 24px;
  font-weight: 800;
  color: var(--text-primary);
  font-family: var(--font-mono);
  display: block;
  line-height: 1;
}

.devdocs-stat-label {
  font-size: 11px;
  color: var(--text-muted);
  letter-spacing: 0.04em;
}