/* ============================================================================
   Docs Site Styles - extends the "Control Plane" system (CertWatch)
   Loaded after variables/base/components/sections/animations.
   ============================================================================ */

/* ========================================================================
 * HEADER - docs suffix on logo
 * ======================================================================== */

.nav-logo-suffix {
  font-family: var(--font-mono);
  font-size: var(--text-xs);
  font-weight: var(--font-normal);
  letter-spacing: var(--tracking-wider);
  text-transform: uppercase;
  color: var(--text-muted);
}

/* ========================================================================
 * DOCS HOME
 * ======================================================================== */

.docs-home {
  background-color: var(--bg);
  padding-top: calc(64px + clamp(2.5rem, 6vw, 5rem));
  padding-bottom: clamp(3rem, 8vw, 6rem);
  min-height: 70vh;
}

.docs-home__eyebrow {
  display: block;
  font-family: var(--font-mono);
  font-size: var(--text-2xs);
  font-weight: var(--font-medium);
  text-transform: uppercase;
  letter-spacing: var(--tracking-widest);
  color: var(--text-faint);
  margin-bottom: var(--space-6);
}

.docs-home__eyebrow-index {
  color: var(--accent);
  margin-right: var(--space-2);
}

.docs-home__title {
  font-family: var(--font-mono);
  font-size: clamp(var(--text-2xl), 4vw, var(--text-4xl));
  font-weight: var(--font-medium);
  letter-spacing: var(--tracking-tight);
  color: var(--text-heading);
  margin-bottom: var(--space-4);
}

.docs-home__intro {
  max-width: 640px;
  font-size: var(--text-lg);
  color: var(--text-muted);
  margin-bottom: var(--space-12);
}

.docs-home__cards {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(260px, 1fr));
  gap: var(--space-4);
}

.docs-card {
  display: block;
  padding: var(--space-6);
  background-color: var(--bg-raised);
  border: 1px solid var(--line);
  transition:
    border-color var(--duration-fast) var(--ease-out),
    background-color var(--duration-fast) var(--ease-out);
}

.docs-card:hover {
  border-color: var(--accent);
}

.docs-card__index {
  display: block;
  font-family: var(--font-mono);
  font-size: var(--text-2xs);
  letter-spacing: var(--tracking-widest);
  color: var(--accent);
  margin-bottom: var(--space-3);
}

.docs-card__title {
  font-family: var(--font-mono);
  font-size: var(--text-base);
  font-weight: var(--font-medium);
  letter-spacing: var(--tracking-wide);
  color: var(--text-heading);
  margin-bottom: var(--space-2);
}

.docs-card__text {
  font-size: var(--text-sm);
  color: var(--text-muted);
  line-height: var(--leading-relaxed);
}

/* ========================================================================
 * DOCS CONTENT LAYOUT - left sidebar + article
 * ======================================================================== */

.docs-layout {
  display: grid;
  grid-template-columns: 220px minmax(0, 1fr);
  gap: var(--space-12);
  padding-top: calc(64px + var(--space-10));
  padding-bottom: var(--space-20);
  background-color: var(--bg);
  align-items: start;
}

.docs-sidebar {
  position: sticky;
  top: calc(64px + var(--space-6));
}

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

.docs-sidebar__heading {
  font-family: var(--font-mono);
  font-size: var(--text-2xs);
  font-weight: var(--font-medium);
  text-transform: uppercase;
  letter-spacing: var(--tracking-widest);
  color: var(--text-faint);
  margin-bottom: var(--space-3);
}

.docs-sidebar ul {
  list-style: none;
  padding: 0;
  margin: 0;
}

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

.docs-sidebar a {
  display: block;
  padding: var(--space-1) var(--space-2);
  font-size: var(--text-sm);
  color: var(--text-muted);
  border-left: 1px solid var(--line);
  transition: color var(--duration-fast) var(--ease-out),
    border-color var(--duration-fast) var(--ease-out);
}

.docs-sidebar a:hover {
  color: var(--accent);
}

.docs-sidebar a.is-active {
  color: var(--text-heading);
  border-left-color: var(--accent);
}

/* Article typography */

.docs-article {
  max-width: 760px;
  min-height: 50vh;
}

.docs-article h1 {
  font-family: var(--font-mono);
  font-size: clamp(var(--text-xl), 3vw, var(--text-3xl));
  font-weight: var(--font-medium);
  letter-spacing: var(--tracking-tight);
  color: var(--text-heading);
  margin-bottom: var(--space-6);
}

.docs-article h2 {
  font-family: var(--font-mono);
  font-size: var(--text-lg);
  font-weight: var(--font-medium);
  color: var(--text-heading);
  margin-top: var(--space-10);
  margin-bottom: var(--space-3);
  padding-top: var(--space-4);
  border-top: 1px solid var(--line);
}

.docs-article h3 {
  font-family: var(--font-mono);
  font-size: var(--text-base);
  font-weight: var(--font-medium);
  color: var(--text-heading);
  margin-top: var(--space-6);
  margin-bottom: var(--space-2);
}

.docs-article p,
.docs-article li {
  color: var(--text);
  line-height: var(--leading-relaxed);
}

.docs-article p {
  margin-bottom: var(--space-4);
}

.docs-article ul,
.docs-article ol {
  list-style: disc;
  margin-bottom: var(--space-4);
  padding-left: var(--space-5);
}

.docs-article ol {
  list-style: decimal;
}

.docs-article li::marker {
  color: var(--text-faint);
}

.docs-article a {
  color: var(--accent);
}

.docs-article a:hover {
  color: var(--accent-bright);
}

.docs-article code {
  font-family: var(--font-mono);
  font-size: 0.875em;
  background-color: var(--bg-raised);
  border: 1px solid var(--line);
  padding: 0.1em 0.35em;
}

.docs-article pre {
  background-color: var(--bg-raised);
  border: 1px solid var(--line);
  padding: var(--space-4);
  overflow-x: auto;
  margin-bottom: var(--space-4);
}

.docs-article pre code {
  background: none;
  border: none;
  padding: 0;
}

.docs-article table {
  width: 100%;
  border-collapse: collapse;
  margin-bottom: var(--space-6);
  font-size: var(--text-sm);
}

.docs-article th,
.docs-article td {
  text-align: left;
  padding: var(--space-2) var(--space-3);
  border: 1px solid var(--line);
  color: var(--text);
}

.docs-article th {
  font-family: var(--font-mono);
  font-size: var(--text-xs);
  text-transform: uppercase;
  letter-spacing: var(--tracking-wider);
  color: var(--text-muted);
  background-color: var(--bg-raised);
}

/* Section list pages */

.docs-page-list {
  list-style: none;
  padding: 0;
}

.docs-page-list li {
  border-bottom: 1px solid var(--line);
}

.docs-page-list a {
  display: block;
  padding: var(--space-4) 0;
  color: var(--text-heading);
  font-family: var(--font-mono);
  font-size: var(--text-base);
}

.docs-page-list a:hover {
  color: var(--accent);
}

.docs-page-list p {
  color: var(--text-muted);
  font-size: var(--text-sm);
  margin: 0 0 var(--space-4);
}

/* ========================================================================
 * API REFERENCE (Scalar) - full-bleed page
 * ======================================================================== */

.api-reference-wrap {
  padding-top: 64px; /* clear fixed header */
  background-color: var(--bg);
  min-height: 100vh;
}

/* Scalar theme mapping onto Control Plane tokens */
.api-reference-wrap {
  --scalar-background-1: var(--bg);
  --scalar-background-2: var(--bg-raised);
  --scalar-background-3: var(--bg-inset);
  --scalar-color-1: var(--text-heading);
  --scalar-color-2: var(--text);
  --scalar-color-3: var(--text-muted);
  --scalar-color-accent: var(--accent);
  --scalar-border-color: var(--line);
  --scalar-font: var(--font-body);
  --scalar-font-code: var(--font-mono);
  --scalar-radius: 0;
  --scalar-radius-lg: 0;
  --scalar-radius-xl: 0;
}

/* ========================================================================
 * RESPONSIVE
 * ======================================================================== */

@media (max-width: 768px) {
  .docs-layout {
    grid-template-columns: 1fr;
    gap: var(--space-6);
  }

  .docs-sidebar {
    position: static;
  }
}