/*
 * The docs layout, on top of the website's stylesheet (assets/styles.css supplies the
 * tokens, the fonts and the base). Tokens only: no colour, size or spacing value is
 * written here that the website's tokens do not already carry. No url(), no @import.
 */

.docs-body {
  background: var(--ground);
  color: var(--ink);
}

.docs-top {
  background: var(--navy);
  color: var(--on-dark);
}

.docs-top__inner {
  display: flex;
  align-items: center;
  gap: var(--space-4, 1rem);
  width: min(100% - 2rem, 76rem);
  min-height: 4rem;
  margin: 0 auto;
}

.docs-top__mark {
  color: var(--on-dark);
  text-decoration: none;
}

.docs-top__label {
  margin: 0;
  padding-left: 1rem;
  border-left: 1px solid var(--on-dark-rule);
  color: var(--on-dark-muted);
  font-size: var(--fs-label);
  letter-spacing: 0.08em;
  text-transform: uppercase;
}

.docs-frame {
  display: grid;
  gap: 2rem;
  width: min(100% - 2rem, 76rem);
  margin: 0 auto;
  padding: 2rem 0 4rem;
}

@media (min-width: 1000px) {
  .docs-frame {
    grid-template-columns: 16rem minmax(0, 1fr);
    align-items: start;
  }

  .docs-nav {
    position: sticky;
    top: 1.5rem;
  }
}

.docs-nav {
  padding: 1rem;
  background: var(--paper);
  border: 1px solid var(--rule);
  border-radius: 0.5rem;
}

.docs-nav__menu > summary {
  color: var(--brand-deep);
  font-weight: 650;
  cursor: pointer;
}

.docs-nav__list {
  display: none;
}

@media (min-width: 1000px) {
  .docs-nav__menu {
    display: none;
  }

  .docs-nav__list {
    display: block;
  }

  .docs-nav__list .docs-nav__group:first-child {
    margin-top: 0;
  }
}

.docs-nav__group {
  margin-top: 1rem;
}

.docs-nav__title {
  margin: 0 0 0.25rem;
  color: var(--slate);
  font-size: var(--fs-xs);
  font-weight: 650;
  letter-spacing: 0.08em;
  text-transform: uppercase;
}

.docs-nav ul,
.docs-toc ul {
  margin: 0;
  padding: 0;
  list-style: none;
}

.docs-nav a {
  display: block;
  padding: 0.3rem 0.5rem;
  border-radius: 0.25rem;
  color: var(--ink-2);
  font-size: var(--fs-sm);
  text-decoration: none;
}

.docs-nav a:hover {
  background: var(--card);
}

.docs-nav a[aria-current="page"] {
  background: var(--brand-tint);
  color: var(--brand-deep);
  font-weight: 650;
}

.docs-main {
  min-width: 0;
}

.docs-main h1 {
  margin: 0;
  font-size: var(--fs-display);
  line-height: var(--lh-display);
  letter-spacing: var(--track-display);
}

.docs-lede {
  max-width: 44rem;
  margin: 1rem 0 0;
  color: var(--slate);
  font-size: var(--fs-lead);
  line-height: var(--lh-lead);
}

.docs-crumbs {
  margin-bottom: 1rem;
  color: var(--slate);
  font-size: var(--fs-label);
}

.docs-crumbs a {
  color: var(--slate);
}

.docs-article {
  display: grid;
  gap: 0;
}

@media (min-width: 1280px) {
  .docs-article {
    grid-template-columns: minmax(0, 44rem) 13rem;
    column-gap: 3rem;
    align-items: start;
  }

  .docs-article > h1,
  .docs-article > .docs-lede {
    grid-column: 1;
  }

  .docs-article > .docs-prose {
    grid-column: 1;
  }

  .docs-toc {
    position: sticky;
    top: 1.5rem;
    grid-column: 2;
    grid-row: 1 / span 3;
  }
}

.docs-prose {
  max-width: 44rem;
  margin-top: 2rem;
}

.docs-prose > * + * {
  margin-top: 1.25rem;
}

.docs-prose h2 {
  margin-top: 2.5rem;
  font-size: var(--fs-h2);
  line-height: var(--lh-heading);
  letter-spacing: var(--track-heading);
}

.docs-prose h3 {
  margin-top: 2rem;
  font-size: var(--fs-h3);
  line-height: var(--lh-heading);
}

.docs-prose p,
.docs-prose li {
  font-size: var(--fs-body);
  line-height: var(--lh-body);
}

.docs-prose ul,
.docs-prose ol {
  display: grid;
  gap: 0.5rem;
  padding-left: 1.5rem;
}

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

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

.docs-prose li > ul,
.docs-prose li > ol {
  margin-top: 0.5rem;
}

.docs-prose a {
  color: var(--brand);
}

.docs-prose code {
  padding: 0.05em 0.35em;
  background: var(--card);
  border: 1px solid var(--rule);
  border-radius: 0.25rem;
  font-family: var(--font-mono);
  font-size: 0.875em;
}

.doc-code {
  margin: 0;
  padding: 1rem 1.25rem;
  overflow-x: auto;
  background: var(--artefact);
  border-radius: 0.375rem;
  color: var(--on-dark);
  font-family: var(--font-mono);
  font-size: var(--fs-mono);
  line-height: 1.6;
}

.doc-code code {
  padding: 0;
  background: none;
  border: 0;
  color: inherit;
  font-size: inherit;
}

.doc-table-wrap {
  max-width: 100%;
  overflow-x: auto;
}

.doc-table {
  width: 100%;
  min-width: 34rem;
  border-collapse: collapse;
  font-size: var(--fs-sm);
}

.doc-table th,
.doc-table td {
  padding: 0.625rem 0.875rem;
  overflow-wrap: normal;
  word-break: normal;
  hyphens: none;
  border-bottom: 1px solid var(--rule);
  text-align: left;
  vertical-align: top;
}

.doc-table th {
  background: var(--card);
  color: var(--slate);
  font-size: var(--fs-xs);
  font-weight: 650;
  letter-spacing: 0.08em;
  text-transform: uppercase;
}

.docs-toc {
  margin-top: 2rem;
}

.docs-toc a {
  display: block;
  padding: 0.25rem 0;
  font-size: var(--fs-label);
}

.docs-section {
  margin-top: 2.5rem;
}

.docs-section h2 {
  font-size: var(--fs-h3);
}

.docs-list {
  margin: 0.75rem 0 0;
  padding: 0;
  overflow: hidden;
  background: var(--paper);
  border: 1px solid var(--rule);
  border-radius: 0.5rem;
  list-style: none;
}

.docs-list li {
  display: grid;
  gap: 0.125rem;
  padding: 0.875rem 1.25rem;
}

.docs-list li + li {
  border-top: 1px solid var(--rule);
}

.docs-list a {
  font-weight: 650;
}

.docs-list span {
  color: var(--slate);
  font-size: var(--fs-sm);
}

.docs-pager {
  display: flex;
  justify-content: space-between;
  gap: 1rem;
  margin-top: 3rem;
  padding-top: 1rem;
  border-top: 1px solid var(--rule);
  font-weight: 600;
}

/* Grid items default to their content's width; a wide table must scroll inside its wrapper. */
.docs-frame > *,
.docs-article > *,
.docs-prose {
  min-width: 0;
}

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

@media (min-width: 1280px) {
  .docs-article {
    grid-template-columns: minmax(0, 44rem) 13rem;
  }
}

/* The way back to the product website: a quiet band at the foot of every page, not a link in the
 * header. The button is the website's own on-dark button. */
.docs-foot {
  background: var(--navy);
  color: var(--on-dark);
}

.docs-foot__inner {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  justify-content: space-between;
  gap: 1.5rem;
  width: min(100% - 2rem, 76rem);
  margin: 0 auto;
  padding: 2rem 0;
}

.docs-foot__text {
  display: grid;
  gap: 0.75rem;
}

.docs-foot__mark {
  margin: 0;
  color: var(--on-dark);
}

.docs-foot__note {
  max-width: 34rem;
  margin: 0;
  color: var(--on-dark-muted);
  font-size: var(--fs-sm);
}

.docs-foot__link {
  text-decoration: none;
}

.docs-foot__arrow {
  margin-left: 0.5em;
}