/* Docs page: a sticky, searchable contents rail beside the text on a
   desktop; above it, folded, on a phone. */

.docs {
  display: grid;
  grid-template-columns: 15rem minmax(0, 1fr);
  gap: var(--space-10);
  align-items: start;
}

/* ── Contents rail ────────────────────────────────────────────────────── */

.docs-nav {
  position: sticky;
  top: calc(var(--header-h) + var(--space-4));
  display: flex;
  flex-direction: column;
  gap: var(--space-4);
  max-height: calc(100dvh - var(--header-h) - var(--space-8));
  overflow-y: auto;
  padding-bottom: var(--space-4);
  font-size: var(--text-13);
}

.docs-search {
  position: relative;
  display: flex;
  align-items: center;
  color: var(--text-faint);
}

.docs-search svg {
  position: absolute;
  left: var(--space-3);
  pointer-events: none;
}

.docs-search input {
  width: 100%;
  height: var(--control-md);
  padding: 0 var(--space-3) 0 calc(var(--space-3) + 16px + var(--space-2));
  border: 1px solid var(--line-strong);
  border-radius: var(--radius-md);
  background: var(--bg);
  color: var(--text);
  font: inherit;
}

.docs-search input::placeholder {
  color: var(--text-faint);
}

.docs-search input:focus-visible {
  outline: none;
  border-color: var(--accent-line);
  box-shadow: var(--focus-ring);
}

.docs-toc summary {
  display: none;
}

.docs-toc__group + .docs-toc__group {
  margin-top: var(--space-4);
}

.docs-toc__heading {
  margin: 0 0 var(--space-1);
  padding: 0 var(--space-3);
  color: var(--text-faint);
  font-size: var(--text-11);
  font-weight: var(--weight-semibold);
  letter-spacing: 0.06em;
  text-transform: uppercase;
}

.docs-toc ol {
  list-style: none;
  margin: 0;
  padding: 0;
  border-left: 1px solid var(--line);
}

.docs-toc a {
  display: block;
  margin-left: -1px;
  padding: 5px var(--space-3);
  border-left: 2px solid transparent;
  color: var(--text-dim);
  text-decoration: none;
  transition: color var(--duration-fast) var(--ease-out), border-color var(--duration-fast) var(--ease-out);
}

.docs-toc a:hover {
  color: var(--text);
  border-left-color: var(--line-strong);
}

.docs-toc a.docs-toc__link--active {
  border-left-color: var(--accent);
  color: var(--accent-text);
  font-weight: var(--weight-medium);
}

.docs-toc__empty {
  margin: var(--space-2) var(--space-3) 0;
  color: var(--text-faint);
}

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

.docs-main {
  display: flex;
  flex-direction: column;
  gap: var(--space-10);
  min-width: 0;
  max-width: 52rem;
}

/* Quick start */
.docs-start {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(12rem, 1fr));
  gap: var(--space-3);
}

.docs-start__card {
  display: flex;
  flex-direction: column;
  gap: var(--space-2);
  padding: var(--space-4);
  border: 1px solid var(--line);
  border-radius: var(--radius-lg);
  background: var(--bg-raised);
  color: var(--text);
  text-decoration: none;
  transition: border-color var(--duration-fast) var(--ease-out), background var(--duration-fast) var(--ease-out);
}

.docs-start__card:hover {
  border-color: var(--accent-line);
  background: var(--bg-hover);
}

.docs-start__icon {
  display: inline-grid;
  place-items: center;
  width: 32px;
  height: 32px;
  border-radius: var(--radius-md);
  background: var(--accent-soft);
  color: var(--accent-text);
}

.docs-start__title {
  display: inline-flex;
  align-items: center;
  gap: var(--space-1);
  font-weight: var(--weight-semibold);
}

.docs-start__title svg {
  color: var(--text-faint);
  transition: transform var(--duration-fast) var(--ease-out);
}

.docs-start__card:hover .docs-start__title svg {
  color: var(--accent-text);
  transform: translateX(2px);
}

.docs-start__text {
  color: var(--text-dim);
  font-size: var(--text-13);
  line-height: var(--leading-snug);
}

/* ── Sections ─────────────────────────────────────────────────────────── */

.docs-body {
  display: flex;
  flex-direction: column;
  min-width: 0;
  font-size: var(--text-14);
  line-height: var(--leading-normal);
}

.docs-section {
  display: flex;
  flex-direction: column;
  gap: var(--space-4);
  padding: var(--space-10) 0;
  border-top: 1px solid var(--line);
  scroll-margin-top: calc(var(--header-h) + var(--space-2));
}

.docs-section:first-of-type {
  padding-top: 0;
  border-top: 0;
}

.docs-section__head {
  display: flex;
  flex-direction: column;
  gap: var(--space-1);
}

.docs-section__group {
  margin: 0;
  color: var(--accent-text);
  font-size: var(--text-12);
  font-weight: var(--weight-semibold);
  letter-spacing: 0.04em;
  text-transform: uppercase;
}

.docs-section__title-row {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  justify-content: space-between;
  gap: var(--space-3);
}

.docs-section h2 {
  margin: 0;
  font-size: var(--text-24);
  font-weight: var(--weight-semibold);
  letter-spacing: var(--tracking-title);
  line-height: var(--leading-tight);
}

.docs-anchor {
  display: inline-flex;
  align-items: center;
  gap: var(--space-2);
  color: inherit;
  text-decoration: none;
}

.docs-anchor__mark {
  display: inline-flex;
  color: var(--text-faint);
  opacity: 0;
  transition: opacity var(--duration-fast) var(--ease-out);
}

.docs-anchor:hover .docs-anchor__mark,
.docs-anchor:focus-visible .docs-anchor__mark {
  opacity: 1;
}

.docs-section__body {
  display: flex;
  flex-direction: column;
  gap: var(--space-4);
}

/* The opening paragraph is the section's lead. */
.docs-section__body > p:first-child {
  color: var(--text-dim);
  font-size: var(--text-16);
  line-height: var(--leading-normal);
}

.docs-section h3 {
  margin: var(--space-4) 0 calc(-1 * var(--space-1));
  font-size: var(--text-16);
  font-weight: var(--weight-semibold);
}

.docs-section p,
.docs-section ul,
.docs-section ol,
.docs-section dl {
  margin: 0;
}

.docs-section code {
  padding: 1px 5px;
  border: 1px solid var(--line);
  border-radius: var(--radius-sm);
  background: var(--bg-subtle);
  font-family: var(--font-mono);
  font-size: 0.9em;
  overflow-wrap: anywhere;
}

.docs-section .ui-code code {
  padding: 0;
  border: 0;
  background: none;
  font-size: inherit;
}

/* Bullets */
.docs-section ul {
  display: flex;
  flex-direction: column;
  gap: var(--space-2);
  padding-left: var(--space-5);
}

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

/* Steps: numbered badges joined by a rail. */
.docs-section ol {
  counter-reset: docs-step;
  display: flex;
  flex-direction: column;
  list-style: none;
  padding: 0;
}

.docs-section ol > li {
  counter-increment: docs-step;
  position: relative;
  padding: 0 0 var(--space-4) calc(24px + var(--space-3));
}

.docs-section ol > li:last-child {
  padding-bottom: 0;
}

.docs-section ol > li::before {
  content: counter(docs-step);
  position: absolute;
  top: 0;
  left: 0;
  display: grid;
  place-items: center;
  width: 24px;
  height: 24px;
  border: 1px solid var(--accent-line);
  border-radius: var(--radius-full);
  background: var(--accent-soft);
  color: var(--accent-text);
  font-size: var(--text-12);
  font-weight: var(--weight-semibold);
  font-variant-numeric: tabular-nums;
}

.docs-section ol > li:not(:last-child)::after {
  content: "";
  position: absolute;
  top: 28px;
  bottom: 4px;
  left: 11.5px;
  width: 1px;
  background: var(--line);
}

/* Definitions: term beside its meaning. */
.docs-terms {
  display: grid;
  grid-template-columns: minmax(9rem, 13rem) minmax(0, 1fr);
  border: 1px solid var(--line);
  border-radius: var(--radius-lg);
  overflow: hidden;
}

.docs-terms dt,
.docs-terms dd {
  margin: 0;
  padding: var(--space-3) var(--space-4);
}

.docs-terms dt {
  background: var(--bg-subtle);
  color: var(--text);
  font-weight: var(--weight-semibold);
}

.docs-terms dd {
  color: var(--text-dim);
}

.docs-terms dt:not(:first-of-type),
.docs-terms dd:not(:first-of-type) {
  border-top: 1px solid var(--line);
}

/* Glossary */
.docs-glossary {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(17rem, 1fr));
  gap: var(--space-3);
}

.docs-glossary__item {
  padding: var(--space-3) var(--space-4);
  border: 1px solid var(--line);
  border-radius: var(--radius-lg);
  background: var(--bg-raised);
}

.docs-glossary dt {
  font-weight: var(--weight-semibold);
}

.docs-glossary dd {
  margin: var(--space-1) 0 0;
  color: var(--text-dim);
  font-size: var(--text-13);
  line-height: var(--leading-snug);
}

/* Callout */
.docs-note {
  display: flex;
  flex-direction: column;
  gap: var(--space-1);
  padding: var(--space-3) var(--space-4);
  border: 1px solid var(--line);
  border-left: 3px solid var(--info);
  border-radius: var(--radius-md);
  background: var(--info-soft);
  color: var(--text);
}

.docs-note::before {
  content: "Note";
  color: var(--info);
  font-size: var(--text-12);
  font-weight: var(--weight-semibold);
  letter-spacing: 0.04em;
  text-transform: uppercase;
}

/* Table */
.docs-table {
  overflow-x: auto;
  border: 1px solid var(--line);
  border-radius: var(--radius-lg);
}

.docs-table table {
  width: 100%;
  border-collapse: collapse;
  font-size: var(--text-13);
}

.docs-table th,
.docs-table td {
  padding: var(--space-3) var(--space-4);
  text-align: left;
  vertical-align: top;
}

.docs-table thead th {
  background: var(--bg-subtle);
  color: var(--text-faint);
  font-size: var(--text-12);
  font-weight: var(--weight-semibold);
  letter-spacing: 0.04em;
  text-transform: uppercase;
}

.docs-table tbody th {
  font-weight: var(--weight-semibold);
  white-space: nowrap;
}

.docs-table td {
  color: var(--text-dim);
}

.docs-table tbody tr {
  border-top: 1px solid var(--line);
}

/* No results, and the page foot */
.docs-empty {
  display: flex;
  flex-direction: column;
  align-items: center;
  gap: var(--space-3);
  padding: var(--space-10) var(--space-4);
  border: 1px dashed var(--line-strong);
  border-radius: var(--radius-lg);
  color: var(--text-dim);
  text-align: center;
}

.docs-foot {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  justify-content: space-between;
  gap: var(--space-3);
  padding-top: var(--space-4);
  border-top: 1px solid var(--line);
  font-size: var(--text-13);
}

/* ── Architecture diagram ─────────────────────────────────────────────── */
.docs-diagram {
  margin: 0;
  padding: var(--space-4);
  border: 1px solid var(--line);
  border-radius: var(--radius-lg);
  background: var(--bg-subtle);
}

.docs-diagram svg {
  display: block;
  width: 100%;
  height: auto;
  font-family: var(--font-sans);
}

.docs-diagram figcaption {
  margin-top: var(--space-3);
  color: var(--text-faint);
  font-size: var(--text-12);
}

.docs-diagram__box {
  fill: var(--bg-raised);
  stroke: var(--line-strong);
}

.docs-diagram__box--accent {
  stroke: var(--accent-line);
}

.docs-diagram__frame {
  fill: none;
  stroke: var(--line-strong);
  stroke-dasharray: 6 4;
}

.docs-diagram__title {
  fill: var(--text);
  font-size: 15px;
  font-weight: var(--weight-semibold);
}

.docs-diagram__sub {
  fill: var(--text-dim);
  font-size: 12px;
}

.docs-diagram__label {
  fill: var(--text-faint);
  font-size: 12px;
}

.docs-diagram__link {
  fill: none;
  stroke: var(--text-faint);
  stroke-width: 1.5;
}

.docs-diagram__head {
  fill: var(--text-faint);
}

/* ── Narrow ───────────────────────────────────────────────────────────── */
@container main (max-width: 900px) {
  .docs {
    grid-template-columns: minmax(0, 1fr);
    gap: var(--space-6);
  }

  .docs-nav {
    position: static;
    max-height: none;
    overflow: visible;
    padding-bottom: 0;
  }

  .docs-toc {
    padding: var(--space-2) var(--space-3) var(--space-3);
    border: 1px solid var(--line);
    border-radius: var(--radius-lg);
  }

  .docs-toc summary {
    display: block;
    cursor: pointer;
    padding: var(--space-1) 0;
    color: var(--text-dim);
    font-weight: var(--weight-medium);
  }

  .docs-toc[open] summary {
    margin-bottom: var(--space-2);
  }

  .docs-terms {
    grid-template-columns: minmax(0, 1fr);
  }

  .docs-terms dd {
    padding-top: 0;
    border-top: 0 !important;
  }

  .docs-section h2 {
    font-size: var(--text-20);
  }
}