/* =========================================
   Docs — Apple HIG Design System
   Scoped to .docs, duplicated from sizing-v2
   ========================================= */

.docs {
  --d-font: -apple-system, BlinkMacSystemFont, 'SF Pro Text', 'Plus Jakarta Sans', system-ui, sans-serif;
  --d-font-display: -apple-system, BlinkMacSystemFont, 'SF Pro Display', 'Plus Jakarta Sans', system-ui, sans-serif;
  --d-font-mono: 'SF Mono', ui-monospace, 'Menlo', 'Consolas', monospace;

  --d-text: #1c1c1e;
  --d-text-secondary: rgba(60, 60, 67, 0.72);
  --d-text-tertiary: rgba(60, 60, 67, 0.5);
  --d-accent: #007aff;
  --d-accent-hover: #0062cc;
  --d-bg: #ffffff;
  --d-bg-subtle: #f5f5f7;
  --d-surface: #ffffff;
  --d-separator: rgba(60, 60, 67, 0.12);
  --d-separator-light: rgba(60, 60, 67, 0.06);

  --d-radius: 10px;
  --d-radius-sm: 6px;
  --d-transition: 150ms ease;

  --d-space-xs: 0.25rem;
  --d-space-sm: 0.5rem;
  --d-space-md: 1rem;
  --d-space-lg: 1.5rem;
  --d-space-xl: 2rem;
  --d-space-2xl: 3rem;

  font-family: var(--d-font);
  color: var(--d-text);
  line-height: 1.6;
  -webkit-font-smoothing: antialiased;
  background: var(--d-bg);
}

.docs *, .docs *::before, .docs *::after { box-sizing: border-box; }

/* === Layout (mobile-first) === */
.docs-grid {
  max-width: 1280px;
  margin: 0 auto;
  padding: var(--d-space-lg) var(--d-space-md);
  display: grid;
  grid-template-columns: minmax(0, 1fr);
  gap: var(--d-space-xl);
}

/* === Left nav (default: static, flows above article) === */
.docs-nav {
  font-size: 0.875rem;
  border-bottom: 1px solid var(--d-separator);
  padding-bottom: var(--d-space-lg);
  margin-bottom: var(--d-space-sm);
}

.docs-toc { display: none; }

/* === Desktop: three-column with sticky rails === */
@media (min-width: 1024px) {
  .docs-grid {
    grid-template-columns: 240px minmax(0, 1fr) 200px;
    gap: var(--d-space-2xl);
    padding: var(--d-space-xl) var(--d-space-lg);
  }

  .docs-nav {
    position: sticky;
    top: var(--d-space-xl);
    align-self: start;
    max-height: calc(100vh - var(--d-space-xl) * 2);
    overflow-y: auto;
    border-bottom: none;
    padding-bottom: 0;
    margin-bottom: 0;
  }

  .docs-toc { display: block; }
  .docs-article { max-width: 720px; }
}

.docs-nav-home {
  display: block;
  font-family: var(--d-font-display);
  font-size: 0.9375rem;
  font-weight: 600;
  color: var(--d-text);
  text-decoration: none;
  padding: var(--d-space-sm) 0;
  margin-bottom: var(--d-space-lg);
  letter-spacing: -0.01em;
}

.docs-nav-home:hover { color: var(--d-accent); }

.docs-nav-section { margin-bottom: var(--d-space-xl); }

.docs-nav-label {
  font-size: 0.6875rem;
  font-weight: 600;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--d-text-tertiary);
  margin-bottom: var(--d-space-sm);
  padding: 0 var(--d-space-sm);
}

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

.docs-nav li { margin: 0; }

.docs-nav a {
  display: block;
  padding: 0.375rem var(--d-space-sm);
  color: var(--d-text-secondary);
  text-decoration: none;
  border-radius: var(--d-radius-sm);
  transition: color var(--d-transition), background var(--d-transition);
  font-size: 0.875rem;
  line-height: 1.4;
}

.docs-nav a:hover {
  color: var(--d-text);
  background: var(--d-separator-light);
}

.docs-nav a.is-active {
  color: var(--d-accent);
  font-weight: 500;
  background: rgba(0, 122, 255, 0.08);
}

/* === Article === */
.docs-article {
  min-width: 0;
  max-width: 720px;
  font-size: 1rem;
}

.docs-breadcrumb {
  font-size: 0.8125rem;
  color: var(--d-text-tertiary);
  margin-bottom: var(--d-space-md);
  display: flex;
  gap: var(--d-space-xs);
  align-items: center;
}

.docs-breadcrumb a {
  color: var(--d-text-tertiary);
  text-decoration: none;
}

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

.docs-breadcrumb-sep { color: var(--d-text-tertiary); }

.docs-article h1 {
  font-family: var(--d-font-display);
  font-size: 2.25rem;
  font-weight: 700;
  letter-spacing: -0.02em;
  line-height: 1.15;
  margin: 0 0 var(--d-space-md) 0;
  color: var(--d-text);
}

.docs-article h2 {
  font-family: var(--d-font-display);
  font-size: 1.5rem;
  font-weight: 600;
  letter-spacing: -0.015em;
  line-height: 1.25;
  margin: var(--d-space-2xl) 0 var(--d-space-md) 0;
  padding-top: var(--d-space-lg);
  border-top: 1px solid var(--d-separator);
  color: var(--d-text);
  scroll-margin-top: var(--d-space-xl);
}

.docs-article h2:first-of-type,
.docs-article > h2:first-child {
  border-top: none;
  padding-top: 0;
  margin-top: var(--d-space-xl);
}

.docs-article h3 {
  font-family: var(--d-font-display);
  font-size: 1.125rem;
  font-weight: 600;
  letter-spacing: -0.01em;
  margin: var(--d-space-xl) 0 var(--d-space-sm) 0;
  color: var(--d-text);
  scroll-margin-top: var(--d-space-xl);
}

.docs-article p {
  margin: 0 0 var(--d-space-md) 0;
  color: var(--d-text);
}

.docs-article a {
  color: var(--d-accent);
  text-decoration: none;
  border-bottom: 1px solid rgba(0, 122, 255, 0.3);
  transition: border-color var(--d-transition);
}

.docs-article a:hover { border-bottom-color: var(--d-accent); }

.docs-article ul, .docs-article ol {
  margin: 0 0 var(--d-space-md) 0;
  padding-left: var(--d-space-lg);
}

.docs-article li { margin-bottom: var(--d-space-xs); }

.docs-article code {
  font-family: var(--d-font-mono);
  font-size: 0.875em;
  background: var(--d-bg-subtle);
  padding: 0.125rem 0.375rem;
  border-radius: 4px;
  color: var(--d-text);
}

.docs-article pre {
  background: var(--d-bg-subtle);
  border-radius: var(--d-radius);
  padding: var(--d-space-md) var(--d-space-lg);
  overflow-x: auto;
  margin: var(--d-space-md) 0 var(--d-space-lg) 0;
  font-size: 0.8125rem;
  line-height: 1.55;
}

.docs-article pre code {
  background: transparent;
  padding: 0;
  font-size: inherit;
  color: var(--d-text);
}

/* === Pager (prev / next) === */
.docs-pager {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: var(--d-space-md);
  margin-top: var(--d-space-2xl);
  padding-top: var(--d-space-lg);
  border-top: 1px solid var(--d-separator);
}

.docs-pager a {
  display: block;
  padding: var(--d-space-md) var(--d-space-lg);
  border: 1px solid var(--d-separator);
  border-radius: var(--d-radius);
  text-decoration: none;
  color: var(--d-text);
  transition: border-color var(--d-transition), background var(--d-transition);
}

.docs-pager a:hover {
  border-color: var(--d-accent);
  background: rgba(0, 122, 255, 0.04);
}

.docs-pager-label {
  display: block;
  font-size: 0.6875rem;
  font-weight: 600;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--d-text-tertiary);
  margin-bottom: var(--d-space-xs);
}

.docs-pager-title {
  display: block;
  font-family: var(--d-font-display);
  font-size: 0.9375rem;
  font-weight: 600;
  color: var(--d-text);
}

.docs-pager-next { text-align: right; grid-column: 2; }
.docs-pager-prev { grid-column: 1; }

/* === Right on-page TOC === */
.docs-toc {
  position: sticky;
  top: var(--d-space-xl);
  align-self: start;
  max-height: calc(100vh - var(--d-space-xl) * 2);
  overflow-y: auto;
  font-size: 0.8125rem;
}

.docs-toc-label {
  font-size: 0.6875rem;
  font-weight: 600;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--d-text-tertiary);
  margin-bottom: var(--d-space-sm);
  padding: 0 var(--d-space-sm);
}

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

.docs-toc a {
  display: block;
  padding: 0.25rem var(--d-space-sm);
  color: var(--d-text-secondary);
  text-decoration: none;
  border-left: 2px solid transparent;
  transition: color var(--d-transition), border-color var(--d-transition);
  line-height: 1.4;
}

.docs-toc a:hover { color: var(--d-text); }

.docs-toc a.is-active {
  color: var(--d-accent);
  border-left-color: var(--d-accent);
}

.docs-toc-h3 { padding-left: var(--d-space-md) !important; font-size: 0.75rem; }