/* discern.sh document routes — shared manual and public-Map consumer styles.
   Composition only: every design value is a design-system token from
   /assets/design-system/discern.css, and no component-owned .discern-* selector is
   redefined here. The vocabulary: serif headlines, mono wayfinding, hairline
   rules, hard-offset shadows. */

/* ── Page scaffold ─────────────────────────────────────────────────────── */

body {
  --docs-page-max: 100rem;

  margin: 0;
}

@media (prefers-reduced-motion: no-preference) {
  html {
    scroll-behavior: smooth;
  }
}

/* The package layout owns the columns, their sticky rails, and the drawer;
   the shell runs wider than the package's article measure. */
.docs-layout {
  --discern-docs-layout-max: var(--docs-page-max);
  --docs-content-width: 46rem;
}

.docs-layout a:focus-visible,
.docs-top a:focus-visible,
.docs-top button:focus-visible {
  border-radius: var(--discern-radius-xs);
  outline: 2px solid var(--discern-color-accent-500);
  outline-offset: 2px;
}

.docs-no-scroll {
  overflow: hidden;
}

/* ── Top bar ───────────────────────────────────────────────────────────── */

/* The shell's three columns run wider than an article, so the bar's inner
   row follows them rather than the page maximum. */
.docs-top {
  --discern-docs-header-max: var(--docs-page-max);
}

.docs-brand-lockup {
  display: inline-flex;
  align-items: center;
  gap: var(--discern-space-2);
}

.docs-brand {
  display: inline-flex;
  align-items: center;
  color: var(--discern-color-ink);
  text-decoration: none;
}

.docs-brand-docs {
  display: inline-flex;
  align-items: center;
  color: var(--discern-color-ink-faint);
  font-size: var(--discern-font-size-xs);
  line-height: 1;
  text-decoration: none;
}

.docs-brand-docs:hover {
  color: var(--discern-color-accent-600);
}

.docs-search-btn {
  display: inline-flex;
  align-items: center;
  gap: 9px;
  block-size: 2.25rem;
  min-block-size: 2.25rem;
  padding-inline: 11px 8px;
  border: 1px solid var(--discern-color-border);
  border-radius: var(--discern-radius-sm);
  background: var(--discern-color-surface);
  color: var(--discern-color-ink-faint);
  cursor: pointer;
  font: 500 0.8125rem var(--discern-font-ui);
  font-feature-settings: var(--discern-font-features-ui);
  transition:
    border-color var(--discern-duration-fast),
    color var(--discern-duration-fast);
}

.docs-search-btn:hover {
  border-color: var(--discern-color-border-strong);
  color: var(--discern-color-ink);
}

.docs-search-icon {
  font-size: 0.875rem;
}

.docs-theme-icon {
  font-size: 1rem;
}

/* ── Chapter nav (left rail) ───────────────────────────────────────────── */

.docs-nav-chapter-title {
  display: inline-flex;
  gap: var(--discern-space-2);
  align-items: baseline;
}

.docs-nav-section-index {
  color: var(--discern-color-accent-600);
  font-family: var(--discern-font-mono);
  font-size: 0.6875rem;
}

.docs-page-kind {
  max-width: var(--docs-content-width);
  margin: 0 0 var(--discern-space-2);
}

.docs-nav-foot {
  display: flex;
  flex-wrap: wrap;
  gap: var(--discern-space-4);
  margin-top: var(--discern-space-6);
  padding-top: var(--discern-space-4);
  border-top: 1px solid var(--discern-color-border);
  font-size: 0.6875rem;
}

.docs-nav-foot a {
  color: var(--discern-color-ink-muted);
  text-decoration: none;
}

.docs-nav-foot a:hover {
  color: var(--discern-color-accent-600);
}

/* ── Main column ───────────────────────────────────────────────────────── */

/* Mono glyphs run optically smaller than the text face. Keep inline code just
   below the surrounding type across every docs composition, while leaving
   code sheets to their own fixed scale. */
.docs-layout :not(pre) > code {
  font-size: 0.9em;
}

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

/* ── Prose ─────────────────────────────────────────────────────────────── */

.doc-body {
  max-width: var(--docs-content-width);
  counter-reset: docs-h2;
  overflow-wrap: anywhere;
}

.doc-body :is(h1, h2, h3, h4)[id] {
  scroll-margin-top: calc(
    var(--discern-docs-layout-sticky-offset) + var(--discern-space-4)
  );
}

.doc-body h1 {
  margin-bottom: var(--discern-space-5);
  font-size: var(--discern-font-size-display-lg);
}

/* The dek: a doc's italic lead paragraph, set as an editorial standfirst. */
.doc-body h1 + p {
  max-width: none;
  padding-bottom: var(--discern-space-6);
  border-bottom: 1px solid var(--discern-color-border);
  margin-bottom: var(--discern-space-6);
  color: var(--discern-color-ink-muted);
  font-family: var(--discern-font-display);
  font-size: 1.3125rem;
  line-height: var(--discern-leading-snug);
}

.doc-body h2 {
  counter-increment: docs-h2;
  margin: var(--discern-space-12) 0 var(--discern-space-4);
  padding-bottom: var(--discern-space-3);
  border-bottom: 1px solid var(--discern-color-border);
  font-size: var(--discern-font-size-display-md);
}

/* Chapter-section numerals, straight from the reading order. */
.doc-body h2::before {
  content: counter(docs-h2, decimal-leading-zero);
  display: block;
  margin-bottom: var(--discern-space-2);
  color: var(--discern-color-accent-600);
  font: 600 0.625rem var(--discern-font-mono);
  letter-spacing: 0.11em;
}

.doc-body.docs-authored-heading-numbers h2,
.docs-manual-index h2 {
  counter-increment: none;
}

.doc-body.docs-authored-heading-numbers h2::before,
.docs-manual-index h2::before {
  content: none;
}

.doc-body h3 {
  margin: var(--discern-space-8) 0 var(--discern-space-3);
  font-size: var(--discern-font-size-display-sm);
}

.doc-body h4 {
  margin: var(--discern-space-6) 0 var(--discern-space-2);
  font-family: var(--discern-font-ui);
  font-feature-settings: var(--discern-font-features-ui);
  font-size: var(--discern-font-size-md);
  font-weight: 600;
  letter-spacing: normal;
}

.doc-body a {
  color: var(--discern-color-accent-700);
  text-decoration: underline;
  text-decoration-color: color-mix(
    in oklab,
    var(--discern-color-accent-500) 42%,
    transparent
  );
  text-decoration-thickness: 1px;
  text-underline-offset: 3px;
  transition: color var(--discern-duration-fast);
}

.doc-body a:hover {
  color: var(--discern-color-accent-600);
  text-decoration-color: var(--discern-color-accent-500);
}

.doc-body strong {
  font-weight: var(--discern-font-weight-strong);
}

.doc-body :is(ul, ol) {
  margin: 0 0 var(--discern-space-4);
  padding-left: 1.375rem;
}

.doc-body li {
  margin-bottom: var(--discern-space-2);
}

.doc-body li :is(ul, ol) {
  margin-top: var(--discern-space-2);
}

.doc-body ul li::marker {
  color: var(--discern-color-accent-500);
}

.doc-body ol li::marker {
  color: var(--discern-color-ink-faint);
  font-family: var(--discern-font-mono);
  font-size: 0.875em;
}

.doc-body :not(pre) > code {
  padding: 0.08em 0.38em;
  border: 1px solid var(--discern-color-border);
  border-radius: var(--discern-radius-xs);
  background: var(--discern-color-surface-sunken);
  font-family: var(--discern-font-mono);
  overflow-wrap: break-word;
}

/* Code sheets wear window chrome: dots, a hairline bar, a hard shadow.
   Monochrome ink on purpose — in this family, color belongs to verdicts. */
.doc-body pre {
  position: relative;
  margin: var(--discern-space-6) 0;
  padding: 44px 0 0;
  overflow: hidden;
  border: 1px solid var(--discern-color-border-strong);
  border-radius: var(--discern-radius-lg);
  background: var(--discern-color-surface);
  box-shadow: var(--discern-shadow-card);
}

.doc-body pre::before {
  content: "";
  position: absolute;
  inset: 0 0 auto;
  height: 32px;
  border-bottom: 1px solid var(--discern-color-border);
  background:
    radial-gradient(
    circle at 17px 16px,
    var(--discern-color-stripe) 0 3.5px,
    transparent 4px
  ),
    radial-gradient(
    circle at 33px 16px,
    var(--discern-color-stripe) 0 3.5px,
    transparent 4px
  ),
    radial-gradient(
    circle at 49px 16px,
    var(--discern-color-stripe) 0 3.5px,
    transparent 4px
  ),
    color-mix(in oklab, var(--discern-color-canvas) 55%,
    var(--discern-color-surface));
}

/* The language chip docs.js reads off the fence, set like a window title. */
.doc-body pre[data-lang]::after {
  content: attr(data-lang);
  position: absolute;
  top: 10px;
  left: 50%;
  translate: -50%;
  color: var(--discern-color-ink-faint);
  font: 500 0.625rem var(--discern-font-mono);
  letter-spacing: 0.08em;
}

.doc-body pre > code {
  display: block;
  overflow-x: auto;
  padding: var(--discern-space-4) var(--discern-space-5);
  font: 400 0.8125rem/1.7 var(--discern-font-mono);
  tab-size: 2;
}

.docs-copy {
  position: absolute;
  top: 5px;
  right: 8px;
  font: 600 0.625rem var(--discern-font-mono);
  letter-spacing: 0.08em;
  opacity: 0;
  transition: opacity var(--discern-duration-fast);
}

.doc-body pre:hover .docs-copy,
.docs-copy:focus-visible,
.docs-copy[data-discern-copied],
.docs-copy.is-copy-failed {
  opacity: 1;
}

.docs-copy.is-copy-failed,
.docs-command-copy.is-copy-failed {
  border-color: var(--discern-color-danger);
  color: var(--discern-color-danger);
}

.doc-body blockquote {
  margin: var(--discern-space-6) 0;
  padding: var(--discern-space-4) var(--discern-space-5);
  border-left: 3px solid var(--discern-color-accent-400);
  border-radius: 0 var(--discern-radius-sm) var(--discern-radius-sm) 0;
  background: color-mix(in oklab, var(--discern-color-accent-100) 60%,
    transparent);
}

.doc-body blockquote > :last-child {
  margin-bottom: 0;
}

.doc-body blockquote :not(pre) > code {
  background: color-mix(in oklab, var(--discern-color-surface) 70%,
    transparent);
}

.docs-table {
  margin: var(--discern-space-6) 0;
  border: 1px solid var(--discern-color-border);
  border-radius: var(--discern-radius-md);
}

.docs-table table {
  min-inline-size: 100%;
}

.docs-table :is(th, td) {
  min-inline-size: 7rem;
  overflow-wrap: normal;
  word-break: normal;
}

.doc-body tbody tr:last-child :is(td, th) {
  border-block-end: 0;
}

.doc-body hr {
  position: relative;
  height: 24px;
  margin: var(--discern-space-10) 0;
  overflow: visible;
  border: 0;
  background-image: linear-gradient(to right, transparent,
    var(--discern-color-border-strong) 22% 78%, transparent);
  background-position: center;
  background-repeat: no-repeat;
  background-size: 100% 1px;
}

.doc-body hr::after {
  position: absolute;
  inset: 50% auto auto 50%;
  display: grid;
  place-items: center;
  inline-size: 32px;
  block-size: 24px;
  background: var(--discern-color-canvas);
  color: var(--discern-color-ink-faint);
  content: "◮";
  font-family: var(--discern-font-mono);
  font-size: 1rem;
  font-weight: 600;
  line-height: 1;
  transform: translate(-50%, -60%);
}

/* ── Derived page indexes and decision context ─────────────────────────── */

.docs-section-index {
  margin-top: var(--discern-space-12);
  padding-top: var(--discern-space-2);
  border-top: 1px solid var(--discern-color-border);
}

.docs-section-index ol {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(15rem, 1fr));
  gap: var(--discern-space-4) var(--discern-space-6);
  margin: 0;
  padding: 0;
  list-style: none;
}

.docs-section-index li {
  margin: 0;
}

.docs-section-index li > a {
  font-family: var(--discern-font-ui);
  font-feature-settings: var(--discern-font-features-ui);
  font-size: var(--discern-font-size-sm);
  font-weight: 600;
  text-decoration: none;
}

.docs-related-decisions {
  max-width: var(--docs-content-width);
  margin-top: var(--discern-space-10);
  padding: var(--discern-space-5);
  border: 1px solid var(--discern-color-border);
  border-left: 3px solid var(--discern-color-accent-400);
  border-radius: var(--discern-radius-md);
  background: color-mix(in oklab, var(--discern-color-accent-100) 45%,
    transparent);
}

.docs-related-decisions h2 {
  margin: 0 0 var(--discern-space-3);
  font-family: var(--discern-font-display);
  font-size: var(--discern-font-size-display-sm);
}

.docs-related-decisions ul {
  margin: 0;
  padding-left: 1.25rem;
}

.docs-related-decisions li {
  margin-top: var(--discern-space-2);
}

.docs-related-decisions a {
  color: var(--discern-color-accent-700);
  font-family: var(--discern-font-ui);
  font-feature-settings: var(--discern-font-features-ui);
  font-size: var(--discern-font-size-sm);
  text-underline-offset: 3px;
}

.docs-related-decision-detail {
  color: var(--discern-color-ink-muted);
  font-family: var(--discern-font-ui);
  font-feature-settings: var(--discern-font-features-ui);
  font-size: var(--discern-font-size-sm);
}

.docs-glossary-heading {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--discern-space-3);
}

.docs-glossary-link {
  display: inline-grid;
  flex: none;
  place-items: center;
  inline-size: 1.5rem;
  block-size: 1.5rem;
  border: 1px solid var(--discern-color-border);
  border-radius: var(--discern-radius-sm);
  color: var(--discern-color-ink-muted);
  font-family: var(--discern-font-ui);
  font-size: var(--discern-font-size-xs);
  line-height: 1;
  text-decoration: none;
}

.docs-glossary-link:hover,
.docs-glossary-link:focus-visible {
  border-color: var(--discern-color-accent-500);
  color: var(--discern-color-accent-600);
}

.docs-history-label {
  max-width: var(--docs-content-width);
  margin-bottom: var(--discern-space-8);
  padding: var(--discern-space-4) var(--discern-space-5);
  border: 1px solid var(--discern-color-border-strong);
  border-radius: var(--discern-radius-md);
  background: var(--discern-color-surface-sunken);
}

.docs-history-label p {
  margin: var(--discern-space-2) 0 0;
  color: var(--discern-color-ink-muted);
  font: 400 var(--discern-font-size-sm)/1.6 var(--discern-font-ui);
  font-feature-settings: var(--discern-font-features-ui);
}

.docs-history-label a {
  color: var(--discern-color-accent-700);
}

.docs-history-status {
  color: var(--discern-color-ink);
}

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

.docs-decision-list li {
  display: flex;
  gap: var(--discern-space-3);
  justify-content: space-between;
  align-items: baseline;
  margin: 0;
  padding-block: var(--discern-space-3);
  border-bottom: 1px solid var(--discern-color-border);
}

.docs-decision-list a {
  font-family: var(--discern-font-ui);
  font-feature-settings: var(--discern-font-features-ui);
  font-size: var(--discern-font-size-sm);
  text-decoration: none;
}

.docs-decision-status {
  flex: none;
  color: var(--discern-color-ink-muted);
  font-family: var(--discern-font-ui);
  font-size: var(--discern-font-size-xs);
  font-weight: 600;
  letter-spacing: 0.05em;
  text-transform: uppercase;
}

/* ── Pager ─────────────────────────────────────────────────────────────── */

.docs-pager {
  max-width: var(--docs-content-width);
  margin-top: var(--discern-space-12);
}

/* ── Colophon ──────────────────────────────────────────────────────────── */

.docs-colophon {
  display: flex;
  flex-wrap: wrap;
  gap: var(--discern-space-2) var(--discern-space-6);
  justify-content: space-between;
  align-items: baseline;
  max-width: var(--docs-content-width);
  margin-top: var(--discern-space-10);
  padding-top: var(--discern-space-5);
  border-top: 1px solid var(--discern-color-border);
  color: var(--discern-color-ink-faint);
  font-family: var(--discern-font-ui);
  font-feature-settings: var(--discern-font-features-ui);
  font-size: var(--discern-font-size-xs);
}

.docs-colophon > * {
  min-width: 0;
}

.docs-colophon :is(a, code) {
  overflow-wrap: anywhere;
  word-break: break-word;
}

.docs-colophon a {
  color: var(--discern-color-ink-muted);
  text-decoration-color: color-mix(
    in oklab,
    var(--discern-color-ink-faint) 45%,
    transparent
  );
  text-underline-offset: 3px;
}

.docs-colophon a:hover {
  color: var(--discern-color-accent-600);
}

.docs-colophon-links {
  display: inline-flex;
  flex-wrap: wrap;
  gap: var(--discern-space-4);
}

/* ── The cover (/docs index) ───────────────────────────────────────────── */

.docs-cover {
  max-width: var(--docs-content-width);
  padding-top: var(--discern-space-6);
}

.docs-cover h1 {
  max-width: 18ch;
  margin: var(--discern-space-5) 0;
  font-size: var(--discern-font-size-display-xl);
}

.docs-front-doors {
  margin-top: var(--discern-space-10);
  padding: var(--discern-space-7);
  border: 1px solid var(--discern-color-border);
  border-radius: var(--discern-radius-lg);
  background: color-mix(
    in oklab,
    var(--discern-color-surface-sunken) 62%,
    transparent
  );
}

.docs-front-doors h2 {
  margin: 0 0 var(--discern-space-5);
  font-size: var(--discern-font-size-display-sm);
}

.docs-front-doors .docs-chapter-leaves {
  grid-template-columns: repeat(auto-fit, minmax(15rem, 1fr));
}

.docs-chapters {
  max-width: var(--docs-content-width);
  margin-top: var(--discern-space-10);
}

.docs-complete-browse {
  max-width: var(--docs-content-width);
  margin-top: var(--discern-space-10);
  border-top: 1px solid var(--discern-color-border);
}

.docs-search-all:focus-visible {
  border-radius: var(--discern-radius-xs);
  outline: 2px solid var(--discern-color-accent-500);
  outline-offset: 2px;
}

.docs-complete-browse .docs-chapters {
  margin-top: 0;
}

.docs-complete-browse--expanded {
  margin-top: var(--discern-space-12);
}

.docs-manual-details {
  margin-top: var(--discern-space-12);
  padding-top: var(--discern-space-3);
  border-top: 1px solid var(--discern-color-border);
}

.docs-chapter {
  display: grid;
  grid-template-columns: 4.5rem minmax(0, 1fr);
  gap: var(--discern-space-6);
  padding-block: var(--discern-space-8);
}

.docs-chapter + .docs-chapter {
  border-top: 1px solid var(--discern-color-border);
}

/* Tier numerals as chapter watermarks — the map's own reading order. */
.docs-chapter-index {
  color: var(--discern-color-accent-300);
  font: italic var(--discern-font-weight-display) 2.5rem
    var(--discern-font-display);
  letter-spacing: -0.02em;
  line-height: 1;
}

.docs-chapter-body h2 {
  margin: 0 0 var(--discern-space-2);
  font-size: var(--discern-font-size-display-sm);
}

.docs-chapter-body h2 a {
  color: inherit;
  text-decoration: none;
  transition: color var(--discern-duration-fast);
}

.docs-chapter-body h2 a:hover {
  color: var(--discern-color-accent-600);
}

.docs-chapter-desc {
  max-width: var(--discern-measure);
  margin: 0 0 var(--discern-space-4);
  color: var(--discern-color-ink-muted);
  font-size: var(--discern-font-size-sm);
}

.docs-chapter-leaves {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(15rem, 1fr));
  gap: var(--discern-space-3) var(--discern-space-6);
  margin: 0;
  padding: 0;
  list-style: none;
}

.docs-chapter-leaves a {
  color: var(--discern-color-accent-700);
  font: 600 0.875rem var(--discern-font-ui);
  font-feature-settings: var(--discern-font-features-ui);
  text-decoration: none;
}

.docs-chapter-leaves a:hover {
  color: var(--discern-color-accent-600);
  text-decoration: underline;
  text-underline-offset: 3px;
}

.docs-leaf-desc {
  display: block;
  margin-top: 2px;
  color: var(--discern-color-ink-faint);
  font-size: var(--discern-font-size-xs);
  line-height: 1.5;
}

/* ── Search palette ────────────────────────────────────────────────────── */

.docs-search-backdrop {
  position: fixed;
  inset: 0;
  z-index: 60;
  background: var(--discern-color-overlay);
  backdrop-filter: blur(2px);
}

.docs-search-backdrop[hidden] {
  display: none;
}

.docs-search[data-dialog-fallback][open] {
  position: fixed;
  inset: 0;
  z-index: 61;
  block-size: fit-content;
}

.docs-search-option {
  cursor: pointer;
}

.docs-search-option[aria-selected="true"] {
  background: color-mix(in oklab, var(--discern-color-accent-100) 80%,
    transparent);
}

.docs-search-path {
  display: block;
  margin-top: 2px;
  color: var(--discern-color-ink-faint);
  font: 400 0.6875rem var(--discern-font-mono);
}

.docs-search-all {
  display: block;
  margin: var(--discern-space-3) auto var(--discern-space-4);
  padding: var(--discern-space-2) var(--discern-space-4);
  border: 1px solid var(--discern-color-border-strong);
  border-radius: var(--discern-radius-sm);
  background: var(--discern-color-surface);
  color: var(--discern-color-accent-700);
  cursor: pointer;
  font: 600 var(--discern-font-size-xs) var(--discern-font-ui);
}

.docs-search-all[hidden] {
  display: none;
}

/* ── Responsive ────────────────────────────────────────────────────────── */

/* Search runs on page-owned script; the package controls carry their own
   inactive state without it. */
html:not(.docs-js) .docs-search-btn {
  display: none;
}

@media (forced-colors: active) {
  .docs-history-label,
  .docs-complete-browse,
  .doc-body pre,
  .docs-search-backdrop,
  .docs-search-all {
    border-color: CanvasText;
  }

  .docs-layout a:focus-visible,
  .docs-top a:focus-visible,
  .docs-top button:focus-visible,
  .docs-search-all:focus-visible {
    outline-color: Highlight;
  }
}

@media (max-width: 40em) {
  .docs-search-btn-word,
  .docs-search-btn kbd {
    display: none;
  }

  .docs-search-btn {
    padding-inline: 9px;
  }

  .docs-chapter {
    grid-template-columns: minmax(0, 1fr);
    gap: var(--discern-space-3);
  }

  .docs-front-doors {
    padding: var(--discern-space-5);
  }
}

/* ── Print ─────────────────────────────────────────────────────────────── */

@media print {
  .docs-top,
  #docs-nav,
  .docs-toc,
  .docs-pager,
  .docs-search,
  .docs-search-backdrop,
  .docs-complete-browse,
  .docs-copy,
  .docs-heading-row > a,
  .docs-skip {
    display: none !important;
  }

  .doc-body {
    max-width: none;
  }

  .doc-body pre {
    box-shadow: none;
  }
}