/* Docs: an introduction page, and one page per section with its
   subsections beside it on a wide screen. The shell's sidebar and ⌘K are
   the contents and the search. */

/* ── Section page ─────────────────────────────────────────────────────── */

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

.docs-article {
  display: flex;
  flex-direction: column;
  gap: var(--space-8);
  min-width: 0;
}

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

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

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

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

.docs-sub {
  margin: var(--space-6) 0 calc(-1 * var(--space-1));
  font-size: var(--text-16);
  font-weight: var(--weight-semibold);
  scroll-margin-top: calc(var(--header-h) + var(--space-4));
}

.docs-body > .docs-sub:first-child {
  margin-top: 0;
}

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

.docs-anchor__mark {
  color: var(--text-faint);
  font-weight: var(--weight-regular);
  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-body p,
.docs-body ul,
.docs-body ol,
.docs-body dl {
  margin: 0;
}

.docs-body 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-body .ui-code code {
  padding: 0;
  border: 0;
  background: none;
  font-size: inherit;
}

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

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

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

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

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

.docs-body 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-body 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(min(100%, 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);
}

/* ── 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);
}

/* ── On this page ─────────────────────────────────────────────────────── */

/* Beside the text only where both fit; the sidebar lists the sections. */
.docs-toc {
  display: block;
  grid-row: 1;
  padding: var(--space-4);
  border: 1px solid var(--line);
  border-radius: var(--radius-lg);
  background: var(--bg-subtle);
  font-size: var(--text-13);
}

@container main (min-width: 1000px) {
  .docs-layout {
    grid-template-columns: minmax(0, 52rem) 14rem;
  }

  .docs-toc {
    grid-row: auto;
    grid-column: 2;
    position: sticky;
    top: calc(var(--header-h) + var(--space-8));
    display: block;
    max-height: calc(100dvh - var(--header-h) - var(--space-12));
    overflow-y: auto;
    font-size: var(--text-13);
    padding: 0;
    border: 0;
    background: none;
  }
}

.docs-toc__heading {
  margin: 0 0 var(--space-2);
  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);
}

/* ── Previous and next ───────────────────────────────────────────────── */

.docs-pager {
  display: grid;
  grid-template-columns: repeat(2, minmax(0, 1fr));
  gap: var(--space-3);
  padding-top: var(--space-6);
  border-top: 1px solid var(--line);
}

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

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

.docs-pager__link--next {
  grid-column: 2;
  align-items: flex-end;
  text-align: right;
}

.docs-pager__dir {
  display: inline-flex;
  align-items: center;
  gap: var(--space-1);
  color: var(--text-faint);
  font-size: var(--text-12);
}

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

/* ── Introduction ─────────────────────────────────────────────────────── */

/* Quick start */
.docs-start {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(min(100%, 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);
}


/* Every section, by group */
.docs-index {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(min(100%, 22rem), 1fr));
  gap: var(--space-8) var(--space-6);
}

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

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

.docs-index__link {
  display: grid;
  grid-template-columns: 16px minmax(0, 1fr);
  column-gap: var(--space-3);
  padding: var(--space-2) var(--space-3);
  margin-inline: calc(-1 * var(--space-3));
  border-radius: var(--radius-md);
  color: var(--text);
  text-decoration: none;
}

.docs-index__link:hover {
  background: var(--bg-hover);
}

.docs-index__icon {
  grid-row: span 2;
  padding-top: 2px;
  color: var(--text-faint);
}

.docs-index__title {
  font-weight: var(--weight-medium);
}

.docs-index__hint {
  color: var(--text-dim);
  font-size: var(--text-13);
}

.docs-breadcrumb, .docs-overview-links {
  display: flex;
  align-items: center;
  flex-wrap: wrap;
  gap: var(--space-3);
  color: var(--text-dim);
  font-size: var(--text-13);
}
.docs-breadcrumb a { color: var(--accent-text); text-decoration: none; }
.docs-find { display: grid; gap: var(--space-2); max-width: 38rem; }
.docs-find .docs-index__heading { margin: 0; }
.docs-find [role="status"] { font-size: var(--text-12); color: var(--text-dim); }
.docs-index__group[hidden], .docs-index li[hidden] { display: none; }
.docs-diagram { overflow-x: auto; }
.docs-diagram svg { min-width: 560px; }

@media print {
  .docs-toc, .docs-pager, .docs-overview-links, .docs-find { display: none; }
  .docs-layout { display: block; }
  .docs-diagram { overflow: visible; break-inside: avoid; }
  .docs-diagram svg { min-width: 0 !important; }
}

/* ── Narrow ───────────────────────────────────────────────────────────── */
@container main (max-width: 900px) {
  .docs-diagram::before {
    content: "Scroll horizontally to explore →";
    display: block;
    margin-bottom: var(--space-2);
    color: var(--text-dim);
    font-size: var(--text-12);
    font-weight: var(--weight-regular);
  }
  .docs-terms {
    grid-template-columns: minmax(0, 1fr);
  }

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