/*
 * WRL Documentation Styles
 * All values reference design system tokens from design-system.css.
 */

/* ------------------------------------------------------------------ */
/* Accessible color overrides                                          */
/* ------------------------------------------------------------------ */

:root {
  /*
   * --color-text-muted (#6e6a66) achieves ~3.8:1 on --color-bg (#f7f6f5),
   * which fails WCAG AA (4.5:1 required for normal text). Use this override
   * for all muted text in documentation context.
   */
  --color-text-muted-docs: #5a5650;

  /*
   * --color-accent (#3d7c9a) achieves ~4.1:1 on --color-bg, failing WCAG AA.
   * This darker shade achieves ~5.2:1.
   */
  --color-link-docs: #2f6a85;
}

/* ------------------------------------------------------------------ */
/* Screen reader only                                                  */
/* ------------------------------------------------------------------ */

.sr-only {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
  border: 0;
}

/* ------------------------------------------------------------------ */
/* Skip link                                                           */
/* ------------------------------------------------------------------ */

.skip-link:focus {
  position: fixed;
  top: var(--space-2);
  left: var(--space-2);
  z-index: 9999;
  padding: var(--space-2) var(--space-4);
  background: var(--color-primary);
  color: var(--color-primary-text);
  border-radius: var(--radius-md);
  font-size: var(--text-base);
  text-decoration: none;
  clip: auto;
  width: auto;
  height: auto;
  overflow: visible;
  white-space: nowrap;
}

/* ------------------------------------------------------------------ */
/* Layout                                                              */
/* ------------------------------------------------------------------ */

body {
  margin: 0;
  background: var(--color-bg);
  color: var(--color-text);
  font-family: var(--font-sans);
  font-size: var(--text-base);
  line-height: var(--leading-normal);
}

.docs-layout {
  display: grid;
  grid-template-columns: 240px 1fr;
  min-height: 100vh;
}

@media (max-width: 767px) {
  .docs-layout {
    grid-template-columns: 1fr;
  }
}

/* ------------------------------------------------------------------ */
/* Sidebar                                                             */
/* ------------------------------------------------------------------ */

.docs-sidebar {
  background: var(--color-surface);
  border-right: 1px solid var(--color-border);
  position: sticky;
  top: 0;
  height: 100vh;
  overflow-y: auto;
  display: flex;
  flex-direction: column;
}

@media (max-width: 767px) {
  .docs-sidebar {
    position: static;
    height: auto;
    border-right: none;
    border-bottom: 1px solid var(--color-border);
  }
}

.docs-sidebar-header {
  padding: var(--space-4) var(--space-4) var(--space-3);
  border-bottom: 1px solid var(--color-border-subtle);
}

.docs-logo {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  text-decoration: none;
  color: var(--color-text);
  font-weight: var(--weight-medium);
  font-size: var(--text-base);
}

.docs-logo:hover {
  color: var(--color-link-docs);
}

.docs-logo:focus-visible {
  outline: 2px solid var(--color-primary);
  outline-offset: 2px;
  border-radius: var(--radius-sm);
}

.docs-logo img {
  flex-shrink: 0;
}

/* Nav list shared by both mobile and desktop */

.docs-nav-list {
  list-style: none;
  margin: 0;
  padding: var(--space-3) 0;
}

.docs-nav-list li {
  margin: 0;
}

.docs-nav-link {
  display: block;
  padding: var(--space-2) var(--space-4);
  color: var(--color-text);
  text-decoration: none;
  font-size: var(--text-base);
  border-left: 3px solid transparent;
  transition: background 0.1s, color 0.1s, border-color 0.1s;
}

.docs-nav-link:hover {
  background: var(--color-surface-muted);
  color: var(--color-link-docs);
}

.docs-nav-link:focus-visible {
  outline: 2px solid var(--color-primary);
  outline-offset: -2px;
}

.docs-nav-link[aria-current="page"] {
  color: var(--color-primary);
  border-left-color: var(--color-primary);
  background: var(--color-surface-muted);
  font-weight: var(--weight-medium);
}

/* Desktop nav: always visible */

.docs-nav-desktop {
  display: block;
}

/* Mobile nav: hidden at >= 768px, shown below via details */

.docs-nav-mobile {
  display: none;
}

@media (max-width: 767px) {
  .docs-nav-desktop {
    display: none;
  }

  .docs-nav-mobile {
    display: block;
  }

  .docs-nav-mobile summary {
    padding: var(--space-3) var(--space-4);
    cursor: pointer;
    font-weight: var(--weight-medium);
    font-size: var(--text-base);
    list-style: none;
    color: var(--color-text);
    background: var(--color-surface);
    user-select: none;
  }

  .docs-nav-mobile summary:focus-visible {
    outline: 2px solid var(--color-primary);
    outline-offset: 2px;
  }

  .docs-nav-mobile summary::marker,
  .docs-nav-mobile summary::-webkit-details-marker {
    display: none;
  }

  .docs-nav-mobile summary::after {
    content: " +";
    color: var(--color-text-muted-docs);
  }

  .docs-nav-mobile[open] summary::after {
    content: " -";
  }

  .docs-nav-mobile nav {
    border-top: 1px solid var(--color-border-subtle);
  }
}

/* ------------------------------------------------------------------ */
/* Main content area                                                   */
/* ------------------------------------------------------------------ */

.docs-main {
  min-width: 0; /* prevent grid blowout */
  display: flex;
  flex-direction: column;
}

.docs-content {
  flex: 1;
  max-width: 42rem;
  padding: var(--space-8) var(--space-6);
  width: 100%;
  box-sizing: border-box;
}

@media (max-width: 767px) {
  .docs-content {
    padding: var(--space-4) var(--space-4);
  }
}

/* ------------------------------------------------------------------ */
/* Prose typography                                                    */
/* ------------------------------------------------------------------ */

.docs-prose {
  color: var(--color-text);
}

.docs-prose h1 {
  font-size: var(--text-2xl);
  font-weight: var(--weight-bold);
  line-height: var(--leading-tight);
  margin: 0 0 var(--space-6);
  color: var(--color-text);
}

.docs-prose h2 {
  font-size: var(--text-xl);
  font-weight: var(--weight-bold);
  line-height: var(--leading-tight);
  margin: var(--space-8) 0 var(--space-4);
  color: var(--color-text);
  padding-bottom: var(--space-2);
  border-bottom: 1px solid var(--color-border-subtle);
}

.docs-prose h3 {
  font-size: var(--text-lg);
  font-weight: var(--weight-medium);
  line-height: var(--leading-tight);
  margin: var(--space-6) 0 var(--space-3);
  color: var(--color-text);
}

.docs-prose p {
  margin: 0 0 var(--space-4);
  line-height: var(--leading-relaxed);
}

.docs-prose ul,
.docs-prose ol {
  margin: 0 0 var(--space-4);
  padding-left: var(--space-6);
}

.docs-prose li {
  margin-bottom: var(--space-2);
  line-height: var(--leading-relaxed);
}

.docs-prose a {
  color: var(--color-link-docs);
  text-decoration: underline;
  text-underline-offset: 2px;
}

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

.docs-prose a:focus-visible {
  outline: 2px solid var(--color-primary);
  outline-offset: 2px;
  border-radius: var(--radius-sm);
}

/* Inline code */
.docs-prose code {
  font-family: var(--font-mono);
  font-size: var(--text-sm);
  background: var(--color-surface-muted);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-sm);
  padding: 0.1em 0.35em;
}

/* Code blocks — must break out of 42rem prose column */
.docs-prose pre,
.docs-prose .code-block {
  max-width: calc(100vw - 2rem);
  overflow-x: auto;
  white-space: pre;
  font-family: var(--font-mono);
  font-size: var(--text-sm);
  background: var(--color-surface-muted);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-md);
  padding: var(--space-3) var(--space-4);
  margin: 0 0 var(--space-4);
  line-height: var(--leading-normal);
}

/* Prism wraps content in <code> inside <pre> — reset inline code styles */
.docs-prose pre code {
  background: none;
  border: none;
  padding: 0;
  font-size: inherit;
  border-radius: 0;
}

/* ------------------------------------------------------------------ */
/* API reference components                                            */
/* ------------------------------------------------------------------ */

/* HTTP method badges */
.method-badge {
  display: inline-block;
  padding: var(--space-1) var(--space-2);
  font-family: var(--font-mono);
  font-size: var(--text-xs);
  font-weight: var(--weight-medium);
  border-radius: var(--radius-sm);
  line-height: var(--leading-tight);
  border: 1px solid transparent;
  text-transform: uppercase;
  letter-spacing: 0.04em;
}

.method-badge--get {
  background: var(--color-info-bg);
  color: var(--color-info-text);
  border-color: var(--color-info);
}

.method-badge--post {
  background: var(--color-success-bg);
  color: var(--color-success-text);
  border-color: var(--color-success);
}

.method-badge--delete {
  background: var(--color-error-bg);
  color: var(--color-error-text);
  border-color: var(--color-error);
}

.method-badge--options {
  background: var(--color-surface-muted);
  color: var(--color-text-muted-docs);
  border-color: var(--color-border);
}

/* API endpoint card */
.docs-endpoint {
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
  padding: var(--space-4);
  margin: 0 0 var(--space-6);
}

.docs-endpoint-header {
  display: flex;
  align-items: center;
  gap: var(--space-3);
  margin-bottom: var(--space-3);
  flex-wrap: wrap;
}

.docs-endpoint-path {
  font-family: var(--font-mono);
  font-size: var(--text-sm);
  color: var(--color-text);
  word-break: break-all;
}

/* ------------------------------------------------------------------ */
/* Badge override for accessible muted text                           */
/* ------------------------------------------------------------------ */

.badge--skip {
  color: var(--color-text-muted-docs);
}

/* ------------------------------------------------------------------ */
/* Footer                                                              */
/* ------------------------------------------------------------------ */

.docs-footer {
  padding: var(--space-6) var(--space-6);
  border-top: 1px solid var(--color-border-subtle);
  font-size: var(--text-sm);
  color: var(--color-text-muted-docs);
  max-width: 42rem;
}

.docs-footer a {
  color: var(--color-link-docs);
  text-decoration: underline;
  text-underline-offset: 2px;
}

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

/* ------------------------------------------------------------------ */
/* Content details/summary (no .disclosure class in markdown)         */
/* ------------------------------------------------------------------ */

.docs-prose details summary:focus-visible {
  outline: 2px solid var(--color-primary);
  outline-offset: 2px;
}

/* ------------------------------------------------------------------ */
/* Copy-to-clipboard button (progressive enhancement)                 */
/* ------------------------------------------------------------------ */

.copy-btn {
  position: absolute;
  top: var(--space-2);
  right: var(--space-2);
  padding: var(--space-1) var(--space-2);
  background: var(--color-surface);
  color: var(--color-text);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-sm);
  font-family: var(--font-sans);
  font-size: var(--text-xs);
  cursor: pointer;
  line-height: var(--leading-tight);
  opacity: 0;
  transition: opacity 0.15s;
}

pre:hover .copy-btn,
pre:focus-within .copy-btn {
  opacity: 1;
}

.copy-btn:focus-visible {
  outline: 2px solid var(--color-primary);
  outline-offset: 2px;
  opacity: 1;
}

/* ------------------------------------------------------------------ */
/* Card grid (What's next section on Getting Started)                  */
/* ------------------------------------------------------------------ */

.card-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(14rem, 1fr));
  gap: var(--space-4);
  margin: var(--space-4) 0;
}

.card-grid p {
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-md);
  padding: var(--space-4);
  margin: 0;
}