/* Documentation reading layout, in the tokens styles.css sets. @see ./spec.md */

.docs-shell {
  display: grid;
  grid-template-columns: 12rem minmax(0, 1fr);
  gap: clamp(var(--space-6), 6vw, 4rem);
  align-items: start;
  inline-size: min(100% - 2 * var(--gutter), var(--page));
  margin-inline: auto;
  padding-block: var(--space-6) 0;
}

.docs-side {
  position: sticky;
  inset-block-start: var(--space-5);
  max-block-size: calc(100dvh - var(--space-6));
  overflow-y: auto;
  padding-block-end: var(--space-5);
}

.docs-nav {
  display: grid;
  gap: var(--space-5);
}

.docs-group ul {
  display: grid;
  gap: 1px;
}

.docs-group-label {
  margin-block-end: var(--space-2);
  padding-inline: var(--space-2);
  color: var(--ink-faint);
  font: var(--text-label);
  letter-spacing: var(--track-caps);
  text-transform: uppercase;
}

.docs-nav a {
  display: flex;
  align-items: center;
  min-block-size: 1.75rem;
  padding: var(--space-1) var(--space-2);
  border-radius: var(--radius);
  color: var(--ink-muted);
  font: var(--text-control);
  font-weight: 400;
  transition: background-color var(--motion) var(--ease), color var(--motion) var(--ease);
}

.docs-nav a:hover {
  color: var(--ink-strong);
  background: var(--surface-hover);
}

.docs-nav a[aria-current="page"] {
  color: var(--ink-strong);
  background: var(--surface-active);
  font-weight: 500;
}

.docs-menu {
  display: none;
  min-inline-size: 0;
  border-block-end: 1px solid var(--stroke-subtle);
}

.docs-menu summary {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  min-block-size: 2.75rem;
  padding-block: var(--space-2);
  color: var(--ink-muted);
  font: var(--text-control);
  cursor: pointer;
  list-style: none;
  -webkit-tap-highlight-color: transparent;
}

.docs-menu summary::-webkit-details-marker {
  display: none;
}

.docs-menu summary::before {
  content: "";
  inline-size: 0.4rem;
  block-size: 0.4rem;
  flex: none;
  border-inline-end: 1.5px solid currentColor;
  border-block-end: 1.5px solid currentColor;
  transform: translateY(-25%) rotate(45deg);
  transition: transform var(--motion) var(--ease);
}

.docs-menu[open] summary::before {
  transform: translateY(25%) rotate(225deg);
}

.docs-menu .docs-nav {
  padding-block-end: var(--space-4);
}

.docs-article {
  min-inline-size: 0;
  max-inline-size: var(--measure-prose);
  padding-block-end: var(--rhythm);
}

.docs-article > * {
  min-inline-size: 0;
}

.docs-article > * + * {
  margin-block-start: var(--space-4);
}

.docs-article h1 {
  max-inline-size: none;
  color: var(--ink-strong);
  font: var(--text-display);
  letter-spacing: -0.015em;
  text-wrap: balance;
}

.docs-lede {
  color: var(--ink-subtle);
  font: var(--text-lede);
  text-wrap: pretty;
}

.docs-article h2 {
  margin-block-start: var(--space-7);
  color: var(--ink-strong);
  font: var(--text-title);
  letter-spacing: -0.01em;
  scroll-margin-block-start: var(--space-5);
  text-wrap: balance;
}

.docs-lede + h2 {
  margin-block-start: var(--space-6);
}

.docs-article p {
  text-wrap: pretty;
}

.docs-article ul,
.docs-article ol {
  display: grid;
  gap: var(--space-2);
  padding-inline-start: var(--space-5);
}

.docs-article ul {
  list-style: disc;
}

.docs-article ol {
  list-style: decimal;
}

.docs-article li::marker {
  color: var(--ink-faint);
}

.docs-article strong {
  color: var(--ink-strong);
  font-weight: 500;
}

.docs-article a {
  color: var(--ink-link);
  text-decoration: underline;
  text-decoration-color: color-mix(in oklab, currentColor 40%, transparent);
  text-decoration-thickness: 1px;
  text-underline-offset: 0.15em;
  transition: color var(--motion) var(--ease);
}

.docs-article a:hover {
  text-decoration-color: currentColor;
}

.docs-article code {
  padding: 0.05em 0.3em;
  border-radius: var(--radius);
  color: var(--ink-strong);
  background: var(--surface-active);
  font: var(--text-code);
  font-size: 0.9em;
  white-space: nowrap;
}

.docs-article pre code {
  padding: 0;
  border-radius: 0;
  background: none;
}

.docs-table {
  max-inline-size: 100%;
  overflow-x: auto;
  overscroll-behavior-inline: contain;
}

.docs-table table {
  inline-size: 100%;
  min-inline-size: 36rem;
  border-collapse: collapse;
  font: var(--text-caption);
  font-size: 0.8125rem;
}

.docs-table th,
.docs-table td {
  padding: var(--space-2) var(--space-4) var(--space-2) 0;
  border-block-start: 1px solid var(--stroke-subtle);
  text-align: start;
  vertical-align: top;
}

.docs-table th {
  color: var(--ink-strong);
  font-weight: 500;
}

.docs-table thead th {
  border-block-start: 0;
  border-block-end: 1px solid var(--stroke);
}

.docs-table tbody th {
  white-space: nowrap;
}

.docs-pager {
  display: grid;
  grid-template-columns: repeat(2, minmax(0, 1fr));
  gap: var(--space-3);
  margin-block-start: var(--space-7);
  padding-block-start: var(--space-5);
  border-block-start: 1px solid var(--stroke-subtle);
}

/* Two plain rows, not two links in running text: the surface answers the
   hover, so neither the caption nor the title carries an underline. */
.docs-article .docs-pager a {
  display: grid;
  gap: var(--space-1);
  min-block-size: 2.75rem;
  padding: var(--space-2);
  margin-inline: calc(-1 * var(--space-2));
  border-radius: var(--radius);
  text-decoration: none;
  transition: background-color var(--motion) var(--ease);
}

.docs-pager a:hover {
  background: var(--surface-hover);
}

.docs-pager .pager-next {
  grid-column: 2;
  text-align: end;
}

.docs-pager span {
  color: var(--ink-faint);
  font: var(--text-caption);
}

.docs-pager strong {
  color: var(--ink-strong);
  font: var(--text-control);
}

@media (max-width: 52rem) {
  .docs-shell {
    grid-template-columns: minmax(0, 1fr);
    gap: 0;
    padding-block-start: 0;
  }

  .docs-side {
    display: none;
  }

  .docs-menu {
    display: block;
  }

  .docs-article {
    padding-block-start: var(--space-6);
  }
}

@media (max-width: 32rem) {
  .docs-pager {
    grid-template-columns: minmax(0, 1fr);
  }

  .docs-pager .pager-next {
    grid-column: 1;
    text-align: start;
  }

  .docs-pager .pager-prev {
    grid-column: 1;
  }
}