/*
 * The docs theme, dressed in the design tokens.
 *
 * This file is the only place that knows about the theme's own class names and variables
 * (.md-*, --md-*). It maps the tokens onto the theme, then restyles the theme's chrome: header,
 * navigation, table of contents, search and footer. Page content is styled in components.css.
 *
 * Rules: no raw colour, size or duration here. Every value is a token from tokens.css.
 */

/* ---- The theme's units and colours ------------------------------------------------------- */

:root {
  /* The theme sets the root font size to 125%, so 0.8rem is one design rem (16px). */
  --ao-rem: 0.8rem;
}

body,
[data-md-color-scheme="default"] {
  color-scheme: light dark;

  --md-text-font-family: var(--ao-font-sans);
  --md-code-font-family: var(--ao-font-mono);

  --md-default-fg-color: var(--ao-color-foreground);
  --md-default-fg-color--light: var(--ao-color-muted-foreground);
  --md-default-fg-color--lighter: var(--ao-color-border-strong);
  --md-default-fg-color--lightest: var(--ao-color-border);
  --md-default-bg-color: var(--ao-color-background);
  --md-default-bg-color--light: var(--ao-color-background);
  --md-default-bg-color--lighter: var(--ao-color-surface);
  --md-default-bg-color--lightest: var(--ao-color-surface);

  /* Interactive states use the primary colour. The logo's red is never a state. */
  --md-primary-fg-color: var(--ao-color-primary);
  --md-primary-fg-color--light: var(--ao-color-primary);
  --md-primary-fg-color--dark: var(--ao-color-primary-hover);
  --md-primary-bg-color: var(--ao-color-primary-foreground);
  --md-accent-fg-color: var(--ao-color-primary-hover);
  --md-accent-fg-color--transparent: var(--ao-color-primary-subtle);
  --md-accent-bg-color: var(--ao-color-primary-foreground);

  --md-typeset-color: var(--ao-color-foreground);
  --md-typeset-a-color: var(--ao-color-primary);
  --md-typeset-table-color: var(--ao-color-border);
  --md-typeset-table-color--light: var(--ao-color-surface);
  --md-typeset-kbd-color: var(--ao-color-surface);
  --md-typeset-kbd-accent-color: var(--ao-color-background);
  --md-typeset-kbd-border-color: var(--ao-color-border-strong);

  --md-code-fg-color: var(--ao-color-code);
  --md-code-bg-color: var(--ao-color-code-surface);

  --md-admonition-fg-color: var(--ao-color-foreground);
  --md-admonition-bg-color: var(--ao-color-primary-subtle);

  --md-shadow-z1: var(--ao-shadow-sm);
  --md-shadow-z2: var(--ao-shadow-md);
  --md-shadow-z3: var(--ao-shadow-md);

  /* The theme's search dialog takes its colours as RGB triplets under these names. */
  --color-foreground: 20 27 34;
  --color-background: 255 255 255;
  --color-background-subtle: 246 248 250;
  --color-backdrop: 255 255 255;
}

@media screen and (prefers-color-scheme: dark) {
  body,
  [data-md-color-scheme="default"] {
    --color-foreground: 228 234 239;
    --color-background: 21 30 38;
    --color-background-subtle: 26 37 46;
    --color-backdrop: 14 21 27;
  }
}

body {
  font-family: var(--ao-font-sans);
  color: var(--ao-color-foreground);
  background-color: var(--ao-color-background);
}

/* ---- Focus ------------------------------------------------------------------------------ */

/* One focus ring for every control, shown for keyboard focus only. */
.md-skip:focus-visible,
.md-header__button:focus-visible,
.md-search__button:focus-visible,
.md-nav__link:focus-visible,
.md-footer__link:focus-visible,
.md-top:focus-visible,
.md-typeset a:focus-visible,
.md-typeset .headerlink:focus-visible,
.md-typeset code:focus-visible {
  outline: var(--ao-focus-width) solid var(--ao-color-ring);
  outline-offset: var(--ao-focus-offset);
  border-radius: var(--ao-radius-sm);
}

.md-skip {
  padding: var(--ao-space-3) var(--ao-space-4);
  margin: var(--ao-space-2);
  font-size: var(--ao-text-sm);
  font-weight: var(--ao-weight-semibold);
  color: var(--ao-color-primary-foreground);
  background-color: var(--ao-color-primary);
  border-radius: var(--ao-radius-md);
}

/* ---- Header ----------------------------------------------------------------------------- */

.md-header {
  color: var(--ao-color-foreground);
  background-color: var(--ao-color-background);
  border-bottom: var(--ao-border-width) solid var(--ao-color-border);
  box-shadow: none;
}

.md-header--shadow {
  box-shadow: var(--ao-shadow-sm);
}

.md-header__inner {
  gap: var(--ao-space-2);
  padding: var(--ao-space-2) var(--ao-space-4);
}

.md-header__button {
  padding: var(--ao-space-2);
  margin: 0;
  border-radius: var(--ao-radius-md);
  transition: background-color var(--ao-duration-fast) var(--ao-ease);
}

.md-header__button:hover {
  background-color: var(--ao-color-surface);
  opacity: 1;
}

.md-header__button.md-logo {
  padding: var(--ao-space-1) var(--ao-space-2);
  margin: 0;
}

.md-header__button.md-logo:hover {
  background-color: transparent;
}

.md-header__button.md-logo img {
  width: auto;
  height: var(--ao-space-8);
}

.md-header__title {
  height: var(--ao-space-10);
  margin: 0 var(--ao-space-2);
  font-size: var(--ao-text-base);
  line-height: var(--ao-space-10);
  letter-spacing: var(--ao-tracking-tight);
}

.md-header__topic:first-child {
  font-weight: var(--ao-weight-semibold);
}

/*
 * The header follows the page's columns. The theme keeps room for a repository link the site
 * doesn't have, which left the search box short of the edge.
 */
.md-header {
  --ao-docs-sidebar-width: 12.1rem; /* the theme's width for both sidebars */
}

.md-header__source {
  display: none;
}

/*
 * Where the table of contents shows, the search box sits over it, edge to edge with its links
 * (the box's width is with the search button, below).
 */
@media screen and (min-width: 60em) {
  .md-header__inner {
    padding-right: var(--ao-space-3);
  }
}

/*
 * Where the navigation shows too, the logo sits over it, starting where its labels start, and
 * the site's name starts where the page's text does.
 */
@media screen and (min-width: 76.25em) {
  .md-header__inner {
    display: grid;
    grid-template-columns: var(--ao-docs-sidebar-width) 1fr auto;
    gap: 0;
    align-items: center;
    padding-left: 0;
  }

  .md-header__button.md-logo {
    justify-self: start;
    margin-left: var(--ao-space-2);
  }

  .md-header__title {
    margin-left: var(--ao-space-6);
  }
}

@media screen and (max-width: 44.984375em) {
  .md-header__inner {
    padding: var(--ao-space-1) var(--ao-space-2);
  }

  .md-header__title {
    font-size: var(--ao-text-sm);
  }

  /* 44px touch targets for the menu and search buttons. */
  .md-header__button.md-icon {
    display: inline-grid;
    place-items: center;
    width: var(--ao-target-min);
    height: var(--ao-target-min);
    padding: 0;
  }
}

/*
 * The theme's colour scheme switch. The site follows the reader's system setting instead, so the
 * switch has no options to show. Hidden, it also leaves the keyboard's tab order.
 */
.md-header__option[data-md-component="palette"] {
  display: none;
}

/* ---- Search button ---------------------------------------------------------------------- */

.md-search__button {
  font-family: var(--ao-font-sans);
  font-size: var(--ao-text-sm);
  color: var(--ao-color-muted-foreground);
}

@media screen and (min-width: 45em) {
  .md-search__button {
    width: calc(var(--ao-docs-sidebar-width) - 2 * var(--ao-space-3));
    height: calc(2.25 * var(--ao-rem));
    color: var(--ao-color-muted-foreground);
    background-color: var(--ao-color-surface);
    border: var(--ao-border-width) solid var(--ao-color-border);
    border-radius: var(--ao-radius-md);
    transition:
      border-color var(--ao-duration-fast) var(--ao-ease),
      background-color var(--ao-duration-fast) var(--ao-ease);
  }

  .md-search__button:hover,
  .md-search__button:focus {
    color: var(--ao-color-foreground);
    background-color: var(--ao-color-surface);
    border-color: var(--ao-color-border-strong);
  }
}

.md-search__button::before {
  top: 50%;
  width: var(--ao-space-4);
  height: var(--ao-space-4);
  background-color: var(--ao-color-subtle-foreground);
  transform: translateY(-50%);
}

.md-search__button::after {
  top: 50%;
  padding: 0 var(--ao-space-1);
  font-family: var(--ao-font-sans);
  font-size: var(--ao-text-xs);
  line-height: var(--ao-leading-normal);
  color: var(--ao-color-subtle-foreground);
  background: var(--ao-color-background);
  border: var(--ao-border-width) solid var(--ao-color-border);
  border-radius: var(--ao-radius-sm);
  transform: translateY(-50%);
}

/* ---- Layout ----------------------------------------------------------------------------- */

.md-main__inner {
  margin-top: var(--ao-space-8);
}

.md-content__inner {
  padding-top: 0;
  margin-bottom: var(--ao-space-16);
}

.md-content__inner::before {
  display: none;
}

/* The navigation and the table of contents start level with the page title. */
@media screen and (min-width: 60em) {
  .md-sidebar {
    padding-top: 0;
  }
}

@media screen and (max-width: 44.984375em) {
  .md-main__inner {
    margin-top: var(--ao-space-6);
  }

  .md-content__inner {
    margin: 0 var(--ao-space-4) var(--ao-space-12);
  }
}

/* ---- Navigation (left) ------------------------------------------------------------------ */

.md-nav {
  font-size: var(--ao-text-sm);
  line-height: var(--ao-leading-snug);
}

.md-nav__link {
  gap: var(--ao-space-2);
  align-items: center;
  padding: var(--ao-space-2) var(--ao-space-3);
  margin: 0 var(--ao-space-1);
  color: var(--ao-color-muted-foreground);
  border-radius: var(--ao-radius-md);
  transition:
    color var(--ao-duration-fast) var(--ao-ease),
    background-color var(--ao-duration-fast) var(--ao-ease);
}

.md-nav--primary .md-nav__link[href]:hover:not(.md-nav__link--active),
.md-nav--primary .md-nav__link[href]:focus:not(.md-nav__link--active) {
  color: var(--ao-color-foreground);
  background-color: var(--ao-color-surface);
}

/* The current page: tinted, bold and marked with aria-current by the theme. */
.md-nav--primary .md-nav__item .md-nav__link--active {
  font-weight: var(--ao-weight-semibold);
  color: var(--ao-color-primary);
  background: var(--ao-color-primary-subtle);
}

/* The drawer, below the width where the left navigation is always visible. */
@media screen and (max-width: 76.234375em) {
  .md-sidebar--primary {
    background-color: var(--ao-color-background);
    border: var(--ao-border-width) solid var(--ao-color-border);
    border-radius: var(--ao-radius-lg);
    backdrop-filter: none;
  }

  .md-overlay {
    background-color: var(--ao-color-overlay);
    backdrop-filter: none;
  }

  .md-nav .md-nav__title[for="__drawer"] {
    gap: var(--ao-space-3);
    padding: var(--ao-space-4);
    font-size: var(--ao-text-sm);
    font-weight: var(--ao-weight-semibold);
    line-height: var(--ao-leading-snug);
    color: var(--ao-color-foreground);
    border-bottom: var(--ao-border-width) solid var(--ao-color-border);
  }

  .md-nav .md-nav__title[for="__drawer"] .md-logo {
    flex-shrink: 0;
    width: auto;
    height: var(--ao-space-6);
  }

  .md-nav--primary > .md-nav__list {
    padding-top: var(--ao-space-2);
  }

  /* 44px rows: the drawer is used by touch. */
  .md-nav--primary .md-nav__link {
    min-height: var(--ao-target-min);
    font-size: var(--ao-text-base);
  }
}

/* ---- Table of contents (right) ---------------------------------------------------------- */

.md-nav--secondary .md-nav__title {
  padding: 0 var(--ao-space-3) var(--ao-space-2);
  margin: 0;
  font-size: var(--ao-text-xs);
  font-weight: var(--ao-weight-semibold);
  color: var(--ao-color-subtle-foreground);
  text-transform: uppercase;
  letter-spacing: var(--ao-tracking-wide);
  background: var(--ao-color-background);
}

.md-nav--secondary .md-nav__list {
  margin-left: var(--ao-space-3);
  border-left: var(--ao-border-width) solid var(--ao-color-border);
}

.md-nav--secondary .md-nav .md-nav__list {
  margin-left: var(--ao-space-3);
  border-left: 0;
}

.md-nav--secondary .md-nav {
  margin-top: 0;
}

.md-nav--secondary .md-nav__link {
  padding: var(--ao-space-1) var(--ao-space-3);
  margin: 0 0 0 calc(-1 * var(--ao-border-width));
  color: var(--ao-color-muted-foreground);
  border-left: var(--ao-focus-width) solid transparent;
  border-radius: 0;
}

.md-nav--secondary .md-nav .md-nav__link {
  border-left: 0;
}

.md-nav--secondary .md-nav__link[href]:hover,
.md-nav--secondary .md-nav__link[href]:focus {
  color: var(--ao-color-foreground);
  background-color: transparent;
}

.md-nav--secondary .md-nav__item .md-nav__link--active {
  font-weight: var(--ao-weight-medium);
  color: var(--ao-color-primary);
  border-left-color: var(--ao-color-primary);
}

.md-nav__link .md-typeset {
  font-size: inherit;
  line-height: inherit;
  color: inherit;
}

/* ---- Footer ----------------------------------------------------------------------------- */

.md-footer {
  color: var(--ao-color-foreground);
  background-color: var(--ao-color-background);
  border-top: var(--ao-border-width) solid var(--ao-color-border);
}

.md-footer__inner {
  gap: var(--ao-space-4);
  padding: var(--ao-space-6) var(--ao-space-4);
}

/* Previous and next page: two equal cards. */
.md-footer__link {
  flex: 1 1 0;
  align-items: center;
  max-width: calc(20 * var(--ao-rem));
  min-height: var(--ao-target-min);
  padding: var(--ao-space-3) var(--ao-space-4);
  margin: 0;
  border: var(--ao-border-width) solid var(--ao-color-border);
  border-radius: var(--ao-radius-lg);
  transition:
    border-color var(--ao-duration-fast) var(--ao-ease),
    background-color var(--ao-duration-fast) var(--ao-ease);
}

.md-footer__link:hover,
.md-footer__link:focus {
  background-color: var(--ao-color-surface);
  border-color: var(--ao-color-border-strong);
  opacity: 1;
}

.md-footer__button {
  padding: 0;
  margin: 0;
  color: var(--ao-color-subtle-foreground);
}

.md-footer__title {
  max-width: none;
  padding: 0 var(--ao-space-3);
  margin: 0;
  font-size: var(--ao-text-base);
  font-weight: var(--ao-weight-semibold);
  line-height: var(--ao-leading-snug);
  color: var(--ao-color-primary);
}

.md-footer__direction {
  display: block;
  font-size: var(--ao-text-xs);
  font-weight: var(--ao-weight-regular);
  color: var(--ao-color-subtle-foreground);
  opacity: 1;
}

@media screen and (max-width: 44.984375em) {
  .md-footer__link--prev {
    flex: 0 0 auto;
  }
}

.md-footer-meta {
  background-color: var(--ao-color-surface);
  border-top: var(--ao-border-width) solid var(--ao-color-border);
}

.md-footer-meta__inner {
  padding: var(--ao-space-4);
}

.md-copyright {
  padding: 0;
  margin: 0;
  font-size: var(--ao-text-xs);
  line-height: var(--ao-leading-relaxed);
  color: var(--ao-color-muted-foreground);
}

.md-copyright__highlight {
  color: var(--ao-color-muted-foreground);
}

html .md-footer-meta.md-typeset a,
html .md-footer-meta.md-typeset a:not(:focus, :hover) {
  color: var(--ao-color-foreground);
}

/* ---- Back to top ------------------------------------------------------------------------ */

.md-top {
  font-family: var(--ao-font-sans);
  font-size: var(--ao-text-sm);
  color: var(--ao-color-muted-foreground);
  background-color: var(--ao-color-card);
  border: var(--ao-border-width) solid var(--ao-color-border);
  border-radius: var(--ao-radius-full);
  box-shadow: var(--ao-shadow-md);
  backdrop-filter: none;
}

.md-top:hover,
.md-top:focus {
  color: var(--ao-color-primary-foreground);
  background-color: var(--ao-color-primary);
}

/* ---- Print ------------------------------------------------------------------------------ */

/* A printed page is the content alone: the checklist is meant to be printed or saved as PDF. */
/* The theme already hides its header, navigation and footer in print. */
@media print {
  .md-main__inner,
  .md-content__inner {
    margin: 0;
  }
}
