// ─────────────────────────────────────────────────────────────────────────────
// Component: Developer docs (muse docs pages, /muse/*)
// File:      src/scss/components/_devdocs.scss
//
// Visual rules for all devdocs-* classes. Structural layout lives in
// pages/_muse-docs.scss.
//
// Tokens:    --color-accent, --color-accent-link, --color-purple, --color-warning
//            --color-danger, --color-success, --text-primary/secondary/muted
//            --bg-base, --bg-surface, --bg-overlay, --bg-hover, --bg-void
//            --border-default, --border-subtle, --font-mono, --font-sans
// Usage:     /muse and /muse/* developer documentation pages
// ─────────────────────────────────────────────────────────────────────────────

// ── Hero / index ──────────────────────────────────────────────────────────────

.devdocs-hero {
  border-bottom: 1px solid var(--border-default);
}

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

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

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

.devdocs-h2 {
  font-size: 18px;
  font-weight: 700;
  color: var(--text-primary);
  margin: var(--space-8) 0 var(--space-2);
  letter-spacing: -0.01em;
}

// ── Stat cluster ──────────────────────────────────────────────────────────────

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

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

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

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

.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;

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

  &--active {
    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-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);
}

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

.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;
  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);
    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 {
  border-left: 1px solid var(--border-subtle);
  @media (max-width: 768px) { border-left: none; }
}

// ── Phase header ──────────────────────────────────────────────────────────────

.devdocs-phase-header {
  border-bottom: 1px solid var(--border-default);
}

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

.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(--text-base);
  color: var(--text-secondary);
  line-height: 1.7;
  max-width: 600px;
  margin: 0;
}

// ── Sections ──────────────────────────────────────────────────────────────────

.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(--text-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 {
  border-radius: 8px;
  border: 1px solid var(--border-default);
  overflow: hidden;
  background: var(--bg-base);

  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;
  }

  .tok-kw  { color: #c678dd; }
  .tok-str { color: #98c379; }
  .tok-num { color: #d19a66; }
  .tok-cmt { color: #5c6370; font-style: italic; }
  .tok-key { color: #e06c75; }
  .tok-fn  { color: #61afef; }
  .tok-type{ color: #e5c07b; }
  .tok-var { color: #abb2bf; }
  .tok-punc{ color: #abb2bf; }
  .tok-acc { color: #56b6c2; }

  &--output {
    background: var(--bg-void);
    border-color: var(--border-subtle);
    margin-top: -1px;
    border-top-left-radius: 0;
    border-top-right-radius: 0;

    pre { color: #7a8394; }

    .tok-key { color: #c97575; }
    .tok-str { color: #7aaa6a; }
    .tok-num { color: #b5824d; }
    .tok-kw  { color: #a05cb5; }
  }
}

.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;
}

// ── Tables ────────────────────────────────────────────────────────────────────

.devdocs-table {
  width: 100%;
  font-size: 13px;
  border-collapse: collapse;
  margin: var(--space-4) 0;
  display: block;
  overflow-x: auto;
  -webkit-overflow-scrolling: touch;

  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);
  }
}

// ── 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); }
}

// ── 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); }
}

// ── Phase prev/next nav ───────────────────────────────────────────────────────

.devdocs-phase-nav {
  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;
  }
}

// ── Index intro divider ───────────────────────────────────────────────────────

.devdocs-index-intro {
  border-bottom: 1px solid var(--border-default);
}