/* Fold documentation — extends the Gazette site's design tokens (../styles.css).
   Same restraint as the rest of the brand: ink/paper/hairline everywhere, signal-red
   reserved for things that actually require the reader's attention. */

:root {
  --docs-sidebar-w: 240px;
  --docs-toc-w: 200px;
  --docs-content-max: 42rem;
}

.docs-topbar {
  border-bottom: 1px solid var(--hairline);
  background: var(--paper-raised);
}
.docs-topbar-row {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--sp-md);
  padding: var(--sp-sm) 0;
}
.docs-crumb {
  font-family: var(--font-label);
  font-size: 0.75rem;
  font-weight: 600;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--muted);
  text-decoration: none;
}
.docs-crumb strong { color: var(--ink); }
.docs-topbar-actions { display: flex; align-items: center; gap: var(--sp-md); }
.docs-version {
  font-family: var(--font-dispatch);
  font-size: 0.75rem;
  color: var(--muted);
}

.docs-shell {
  display: grid;
  grid-template-columns: var(--docs-sidebar-w) minmax(0, 1fr) var(--docs-toc-w);
  gap: var(--sp-xl);
  align-items: start;
  padding: var(--sp-xl) 0 var(--sp-xxl);
}

/* Sidebar */
.docs-sidebar {
  position: sticky;
  top: var(--sp-lg);
  align-self: start;
}
.docs-search { position: relative; margin-bottom: var(--sp-lg); }
.docs-search input {
  width: 100%;
  font-family: var(--font-body);
  font-size: 0.9375rem;
  background: var(--paper-raised);
  border: 1px solid var(--hairline);
  border-radius: 2px;
  padding: 9px 12px;
  color: var(--ink);
}
.docs-search input:focus { outline: none; border-color: var(--ink); }
.docs-search input::placeholder { color: var(--muted); }
.docs-search-results {
  position: absolute;
  z-index: 20;
  top: calc(100% + 6px);
  left: 0;
  right: 0;
  background: var(--paper-raised);
  border: 1px solid var(--hairline);
  border-radius: 2px;
  box-shadow: 0 4px 16px rgba(22, 24, 28, 0.08);
  max-height: 320px;
  overflow-y: auto;
}
.docs-search-results a {
  display: block;
  padding: 10px 12px;
  text-decoration: none;
  border-bottom: 1px solid var(--hairline);
}
.docs-search-results a:last-child { border-bottom: none; }
.docs-search-results a:hover,
.docs-search-results a.is-active { background: var(--paper); }
.docs-search-result-title { font-size: 0.875rem; color: var(--ink); display: block; }
.docs-search-result-page {
  font-family: var(--font-label);
  font-size: 0.6875rem;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--muted);
}
.docs-search-empty { padding: 10px 12px; font-size: 0.875rem; color: var(--muted); }

.docs-nav-group { margin-bottom: var(--sp-lg); }
.docs-nav-label {
  font-family: var(--font-label);
  font-size: 0.6875rem;
  font-weight: 600;
  letter-spacing: 0.09em;
  text-transform: uppercase;
  color: var(--muted);
  margin: 0 0 var(--sp-xs);
}
.docs-nav-link {
  display: block;
  font-size: 0.9375rem;
  text-decoration: none;
  color: var(--muted);
  padding: 6px 0 6px 11px;
  border-left: 2px solid transparent;
  line-height: 1.35;
}
.docs-nav-link:hover { color: var(--ink); }
.docs-nav-link.is-active {
  color: var(--ink);
  font-weight: 600;
  border-left-color: var(--ink);
}
.docs-nav-toggle {
  display: none;
  width: 100%;
  font-family: var(--font-label);
  font-size: 0.75rem;
  font-weight: 600;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  background: var(--paper-raised);
  border: 1px solid var(--hairline);
  border-radius: 2px;
  padding: 12px;
  margin-bottom: var(--sp-md);
  color: var(--ink);
}

/* Content */
.docs-content { min-width: 0; max-width: var(--docs-content-max); }
.docs-content > article > .docs-eyebrow { margin-bottom: var(--sp-xs); }
.docs-content h1 { margin-bottom: var(--sp-sm); }
.docs-content .lede { max-width: none; margin-bottom: var(--sp-lg); }
.docs-content h2 {
  font-size: 1.375rem;
  margin-top: var(--sp-xl);
  padding-top: var(--sp-lg);
  border-top: 1px solid var(--hairline);
  scroll-margin-top: var(--sp-lg);
}
.docs-content article > h2:first-of-type { margin-top: var(--sp-lg); }
.docs-content h3 {
  font-family: var(--font-display);
  font-size: 1.0625rem;
  font-weight: 600;
  margin: var(--sp-lg) 0 var(--sp-xs);
  scroll-margin-top: var(--sp-lg);
}
.docs-content p { margin: 0 0 var(--sp-sm); }
.docs-content ul, .docs-content ol { margin: 0 0 var(--sp-md); padding-left: 1.3em; }
.docs-content li { margin-bottom: 6px; }
.docs-content li > ul, .docs-content li > ol { margin-top: 6px; }
.docs-content strong { font-weight: 600; }
.docs-content code {
  font-family: var(--font-dispatch);
  font-size: 0.875em;
  background: var(--paper);
  border: 1px solid var(--hairline);
  border-radius: 2px;
  padding: 0.05em 0.35em;
}
.docs-content a:not(.docs-nav-link):not(.btn) {
  color: var(--signal-red-deep);
  text-decoration: underline;
  text-decoration-color: var(--hairline);
  text-underline-offset: 2px;
}
.docs-content a:not(.docs-nav-link):not(.btn):hover { text-decoration-color: currentColor; }

/* Numbered steps */
.docs-steps { list-style: none; margin: var(--sp-lg) 0; padding: 0; counter-reset: docs-step; }
.docs-steps > li {
  counter-increment: docs-step;
  position: relative;
  padding: var(--sp-md) 0 var(--sp-md) 44px;
  border-bottom: 1px solid var(--hairline);
}
.docs-steps > li::before {
  content: counter(docs-step, decimal-leading-zero);
  position: absolute;
  left: 0;
  top: var(--sp-md);
  font-family: var(--font-dispatch);
  font-size: 0.8125rem;
  color: var(--muted);
}
.docs-steps > li:last-child { border-bottom: none; }
.docs-steps h3 { margin-top: 0; }
.docs-steps p:last-child { margin-bottom: 0; }

/* Code blocks */
.code-block {
  position: relative;
  margin: var(--sp-md) 0 var(--sp-lg);
  border-radius: 2px;
  overflow: hidden;
  background: var(--ink);
}
.code-block-label {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 8px 12px;
  border-bottom: 1px solid #2c2f35;
  font-family: var(--font-dispatch);
  font-size: 0.75rem;
  color: #b8bcc4;
}
.code-copy-btn {
  font-family: var(--font-label);
  font-size: 0.6875rem;
  font-weight: 600;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  background: transparent;
  border: 1px solid #3a3d42;
  color: #dcdcd6;
  border-radius: 2px;
  padding: 4px 9px;
  cursor: pointer;
}
.code-copy-btn:hover { border-color: #dcdcd6; color: var(--paper); }
.code-copy-btn.is-copied { border-color: var(--signal-red); color: var(--signal-red); }
.code-block pre {
  margin: 0;
  padding: var(--sp-sm) var(--sp-md);
  overflow-x: auto;
  font-family: var(--font-dispatch);
  font-size: 0.8125rem;
  line-height: 1.6;
  color: #f0f0ee;
}
.docs-content .code-block code {
  background: none;
  border: none;
  padding: 0;
  color: inherit;
  font-size: 1em;
}

/* Tables */
.docs-table-wrap { overflow-x: auto; margin: var(--sp-md) 0 var(--sp-lg); }
.docs-table { width: 100%; border-collapse: collapse; font-size: 0.9375rem; }
.docs-table th, .docs-table td {
  text-align: left;
  padding: 10px 14px;
  border-bottom: 1px solid var(--hairline);
  vertical-align: top;
}
.docs-table th {
  font-family: var(--font-label);
  font-size: 0.6875rem;
  font-weight: 600;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--muted);
  border-bottom: 1px solid var(--ink);
  white-space: nowrap;
}
.docs-table td:first-child code { white-space: nowrap; }

/* Callouts */
.callout {
  margin: var(--sp-md) 0 var(--sp-lg);
  padding: var(--sp-sm) var(--sp-md);
  border-left: 3px solid var(--ink);
  background: var(--paper-raised);
}
.callout p:last-child { margin-bottom: 0; }
.callout-label {
  display: block;
  font-family: var(--font-label);
  font-size: 0.6875rem;
  font-weight: 600;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  margin-bottom: 6px;
}
.callout-note { border-left-color: var(--ink); }
.callout-tip { border-left-color: var(--hairline); background: var(--paper); }
.callout-tip .callout-label { color: var(--muted); }
.callout-required { border-left-color: var(--signal-red); }
.callout-required .callout-label { color: var(--signal-red-deep); }

/* Pagination */
.docs-pagination {
  display: flex;
  justify-content: space-between;
  gap: var(--sp-md);
  margin-top: var(--sp-xxl);
  padding-top: var(--sp-lg);
  border-top: 1px solid var(--hairline);
}
.docs-pagination a {
  text-decoration: none !important;
  color: var(--ink) !important;
  max-width: 48%;
}
.docs-pagination-dir {
  display: block;
  font-family: var(--font-label);
  font-size: 0.6875rem;
  font-weight: 600;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--muted);
  margin-bottom: 4px;
}
.docs-pagination-next { text-align: right; margin-left: auto; }

/* TOC */
.docs-toc { position: sticky; top: var(--sp-lg); align-self: start; }
.docs-toc-label {
  font-family: var(--font-label);
  font-size: 0.6875rem;
  font-weight: 600;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--muted);
  margin: 0 0 var(--sp-xs);
}
.docs-toc a {
  display: block;
  font-size: 0.8125rem;
  color: var(--muted);
  text-decoration: none;
  padding: 4px 0 4px 10px;
  border-left: 2px solid var(--hairline);
  line-height: 1.3;
}
.docs-toc a:hover { color: var(--ink); }
.docs-toc a.is-active { color: var(--ink); border-left-color: var(--ink); font-weight: 600; }

@media (max-width: 1050px) {
  .docs-shell { grid-template-columns: var(--docs-sidebar-w) minmax(0, 1fr); }
  .docs-toc { display: none; }
}

@media (max-width: 800px) {
  .docs-shell { display: block; padding-top: var(--sp-md); }
  .docs-nav-toggle { display: block; }
  .docs-sidebar {
    position: static;
    display: none;
    border: 1px solid var(--hairline);
    border-radius: 2px;
    padding: var(--sp-md);
    margin-bottom: var(--sp-lg);
    background: var(--paper-raised);
  }
  .docs-sidebar.is-open { display: block; }
  .docs-content { max-width: none; }
}