/* SlowAPI documentation theme.
 *
 * Three values: black, white, and one yellow. Light is black on white, dark is
 * white on black, and the grey scale between them is untinted -- so hierarchy
 * is carried by weight and size, and yellow is spent only where it means
 * something.
 *
 * One rule governs the yellow, and it is not a matter of taste. #ffd400 scores
 * 14.67:1 against black and 1.43:1 against white, so:
 *
 *   yellow is a SURFACE in light mode -- a button ground, a mark, a rule, a
 *   selection -- and never text on white;
 *   black is the text that sits ON yellow, in both themes.
 *
 * Anything that breaks that rule is unreadable rather than merely ugly.
 */

/* ------------------------------------------------------------- palette */

:root,
[data-md-color-scheme="default"] {
  --sa-bg:        #ffffff;
  --sa-fg:        #000000;
  --sa-subtle:    #fafafa;  /* code and card grounds */
  --sa-border:    #eaeaea;
  --sa-muted:     #666666;  /* secondary text, 5.74:1 on white */
  --sa-faint:     #767676;  /* tertiary text, 4.54:1 -- still AA for body */
  --sa-yellow:    #ffd400;  /* 14.67:1 against black, 1.43:1 against white */
  --sa-on-yellow: #000000;

  --md-default-bg-color:            var(--sa-bg);
  --md-default-fg-color:            var(--sa-fg);
  --md-default-fg-color--light:     var(--sa-muted);
  --md-default-fg-color--lighter:   var(--sa-faint);
  --md-default-fg-color--lightest:  var(--sa-border);
  --md-typeset-color:               var(--sa-fg);

  /* The header takes the page ground, not an accent, so the chrome recedes. */
  --md-primary-fg-color:            var(--sa-bg);
  --md-primary-fg-color--light:     var(--sa-subtle);
  --md-primary-fg-color--dark:      var(--sa-bg);
  --md-primary-bg-color:            var(--sa-fg);
  --md-primary-bg-color--light:     var(--sa-muted);

  --md-accent-fg-color:             var(--sa-fg);
  --md-accent-fg-color--transparent: rgba(0, 0, 0, 0.06);

  --md-typeset-a-color:             var(--sa-fg);
  --md-code-bg-color:               var(--sa-subtle);
  --md-code-fg-color:               var(--sa-fg);
  --md-typeset-mark-color:          var(--sa-yellow);

  --md-footer-bg-color:             var(--sa-bg);
  --md-footer-bg-color--dark:       var(--sa-bg);
  --md-footer-fg-color:             var(--sa-fg);
  --md-footer-fg-color--light:      var(--sa-muted);
  --md-footer-fg-color--lighter:    var(--sa-faint);
}

[data-md-color-scheme="slate"] {
  --sa-bg:        #000000;
  --sa-fg:        #ffffff;
  --sa-subtle:    #0a0a0a;
  --sa-border:    #2e2e2e;
  --sa-muted:     #a1a1a1;  /* 8.13:1 on black */
  --sa-faint:     #7d7d7d;  /* 5.10:1 on black */
  --sa-yellow:    #ffd400;  /* the one value that does not change between themes */
  --sa-on-yellow: #000000;

  --md-default-bg-color:            var(--sa-bg);
  --md-default-fg-color:            var(--sa-fg);
  --md-default-fg-color--light:     var(--sa-muted);
  --md-default-fg-color--lighter:   var(--sa-faint);
  --md-default-fg-color--lightest:  var(--sa-border);
  --md-typeset-color:               var(--sa-fg);

  --md-primary-fg-color:            var(--sa-bg);
  --md-primary-fg-color--light:     var(--sa-subtle);
  --md-primary-fg-color--dark:      var(--sa-bg);
  --md-primary-bg-color:            var(--sa-fg);
  --md-primary-bg-color--light:     var(--sa-muted);

  --md-accent-fg-color:             var(--sa-fg);
  --md-accent-fg-color--transparent: rgba(255, 255, 255, 0.08);

  --md-typeset-a-color:             var(--sa-fg);
  --md-code-bg-color:               var(--sa-subtle);
  --md-code-fg-color:               var(--sa-fg);
  --md-typeset-mark-color:          var(--sa-yellow);

  --md-footer-bg-color:             var(--sa-bg);
  --md-footer-bg-color--dark:       var(--sa-bg);
  --md-footer-fg-color:             var(--sa-fg);
  --md-footer-fg-color--light:      var(--sa-muted);
  --md-footer-fg-color--lighter:    var(--sa-faint);
}

/* Syntax highlighting, in one hue. Meaning is carried by weight and grey
 * level: keywords are the heaviest thing on the line, comments the lightest,
 * literals sit in between. */
:root,
[data-md-color-scheme="default"],
[data-md-color-scheme="slate"] {
  --md-code-hl-keyword-color:      var(--sa-fg);
  --md-code-hl-operator-color:     var(--sa-muted);
  --md-code-hl-punctuation-color:  var(--sa-muted);
  --md-code-hl-name-color:         var(--sa-fg);
  --md-code-hl-function-color:     var(--sa-fg);
  --md-code-hl-constant-color:     var(--sa-fg);
  --md-code-hl-string-color:       var(--sa-muted);
  --md-code-hl-number-color:       var(--sa-muted);
  --md-code-hl-special-color:      var(--sa-muted);
  --md-code-hl-variable-color:     var(--sa-fg);
  --md-code-hl-comment-color:      var(--sa-faint);
  --md-code-hl-generic-color:      var(--sa-muted);
}

.highlight .k,
.highlight .kn,
.highlight .kd,
.highlight .kc,
.highlight .nd,
.highlight .ow {
  font-weight: 600;
}

.highlight .c,
.highlight .c1,
.highlight .cm,
.highlight .cs {
  font-style: italic;
}

/* --------------------------------------------------------------- chrome */

.md-header {
  border-bottom: 1px solid var(--sa-border);
  box-shadow: none;
}

.md-header--shadow {
  box-shadow: none;
}

.md-tabs {
  border-bottom: 1px solid var(--sa-border);
}

.md-search__form {
  background-color: var(--sa-subtle);
  border: 1px solid var(--sa-border);
  border-radius: 6px;
  box-shadow: none;
}

.md-search__form:hover {
  background-color: var(--sa-subtle);
  border-color: var(--sa-muted);
}

[data-md-toggle="search"]:checked ~ .md-header .md-search__form {
  border-radius: 6px 6px 0 0;
}

.md-footer {
  border-top: 1px solid var(--sa-border);
}

.md-footer-meta {
  background-color: var(--sa-bg);
}

/* Links earn their underline instead of a colour. */
/* Links keep full-contrast text and spend the yellow on the underline, which
 * has no contrast requirement of its own. */
.md-typeset a {
  text-decoration: underline;
  text-decoration-color: var(--sa-yellow);
  text-decoration-thickness: 1px;
  text-underline-offset: 0.18em;
  transition: text-decoration-thickness 120ms;
}

.md-typeset a:hover,
.md-typeset a:focus {
  text-decoration-color: var(--sa-yellow);
  text-decoration-thickness: 2px;
}

/* Navigation and headerlinks are not prose links; leave them undecorated. */
.md-typeset .headerlink,
.md-typeset .md-button,
.md-typeset .grid.cards a,
.md-nav a,
.md-typeset .md-nav a {
  text-decoration: none;
}

.md-nav__link--active,
.md-nav__item--active > .md-nav__link {
  font-weight: 600;
}

/* Where you are, marked by the accent rather than by a colour the text would
 * have to survive. */
.md-nav--secondary .md-nav__link--active,
.md-sidebar--primary .md-nav__item--active > .md-nav__link {
  box-shadow: inset 2px 0 0 var(--sa-yellow);
  padding-left: 0.5rem;
}

.md-progress {
  background-color: var(--sa-yellow);
}

::selection {
  background-color: var(--sa-yellow);
  color: var(--sa-on-yellow);
}

.md-typeset mark,
.md-search-result mark {
  background-color: var(--sa-yellow);
  color: var(--sa-on-yellow);
}

/* ----------------------------------------------------------------- hero */

.sa-hero {
  margin: 0 0 3.5rem;
  padding: 2rem 0 2.5rem;
  border-bottom: 2px solid var(--sa-yellow);
}

.md-typeset .sa-hero h1 {
  margin: 0;
  font-size: 2.9rem;
  line-height: 1.05;
  font-weight: 650;
  letter-spacing: -0.045em;
  color: var(--sa-fg);
}

.sa-hero .sa-tagline {
  margin: 0.5rem 0 0;
  font-size: 1.15rem;
  font-weight: 500;
  letter-spacing: -0.02em;
  color: var(--sa-muted);
}

.sa-hero .sa-sub {
  margin: 1rem 0 0;
  max-width: 34rem;
  font-size: 0.8rem;
  line-height: 1.7;
  color: var(--sa-muted);
}

.sa-cta {
  margin-top: 1.75rem;
  display: flex;
  gap: 0.55rem;
  flex-wrap: wrap;
}

.md-typeset .sa-cta .md-button {
  margin: 0;
  padding: 0.42rem 1.05rem;
  border-radius: 6px;
  border: 1px solid var(--sa-border);
  background-color: transparent;
  color: var(--sa-fg);
  font-size: 0.72rem;
  font-weight: 500;
  transition: background-color 120ms, border-color 120ms, color 120ms;
}

.md-typeset .sa-cta .md-button:hover {
  border-color: var(--sa-fg);
  background-color: transparent;
  color: var(--sa-fg);
}

/* The only saturated element on the page, so it is unmistakably the way in.
 * Black on yellow reads at 14.67:1 in either theme. */
.md-typeset .sa-cta .md-button--primary {
  background-color: var(--sa-yellow);
  border-color: var(--sa-yellow);
  color: var(--sa-on-yellow);
  font-weight: 600;
}

.md-typeset .sa-cta .md-button--primary:hover {
  background-color: var(--sa-yellow);
  border-color: var(--sa-on-yellow);
  color: var(--sa-on-yellow);
}

.md-typeset .sa-cta .md-button:not(.md-button--primary):hover {
  box-shadow: inset 0 -2px 0 var(--sa-yellow);
}

/* ---------------------------------------------------------------- blocks */

.md-typeset .grid.cards > ul > li,
.md-typeset .grid > .card {
  border: 1px solid var(--sa-border);
  border-radius: 8px;
  box-shadow: none;
  transition: border-color 120ms;
}

.md-typeset .grid.cards > ul > li:hover {
  border-color: var(--sa-fg);
  box-shadow: none;
}

.md-typeset pre > code,
.md-typeset .highlight > pre {
  border: 1px solid var(--sa-border);
  border-radius: 8px;
}

.md-typeset code {
  border-radius: 4px;
}

.md-typeset table:not([class]) {
  border: 1px solid var(--sa-border);
  border-radius: 8px;
  box-shadow: none;
}

.md-typeset table:not([class]) th {
  background-color: var(--sa-subtle);
  font-weight: 600;
  border-bottom: 1px solid var(--sa-border);
}

.md-typeset table:not([class]) td {
  border-top: 1px solid var(--sa-border);
}

.md-typeset hr {
  border-bottom: 1px solid var(--sa-border);
}

.md-typeset blockquote {
  border-left: 2px solid var(--sa-border);
  color: var(--sa-muted);
}

/* Admonitions keep their icons but lose their colours. */
.md-typeset .admonition,
.md-typeset details {
  border: 1px solid var(--sa-border);
  border-left: 3px solid var(--sa-yellow);
  border-radius: 8px;
  box-shadow: none;
  font-size: 0.72rem;
}

.md-typeset .admonition > .admonition-title,
.md-typeset details > summary {
  background-color: var(--sa-subtle);
  border: none;
}

.md-typeset .admonition > .admonition-title::before,
.md-typeset details > summary::before {
  background-color: var(--sa-fg);
}

.md-typeset .admonition > .admonition-title::after,
.md-typeset details > summary::after {
  color: var(--sa-fg);
}

/* Tighter headings, the way a monochrome page needs to signal hierarchy. */
.md-typeset h1,
.md-typeset h2,
.md-typeset h3 {
  letter-spacing: -0.02em;
  font-weight: 600;
  color: var(--sa-fg);
}

.md-typeset h2 {
  margin-top: 2.2rem;
  padding-top: 1.4rem;
  border-top: 1px solid var(--sa-border);
}

.sa-hero + h2,
.md-typeset .sa-hero + h2 {
  border-top: none;
  padding-top: 0;
  margin-top: 0;
}

/* ----------------------------------------------------------------- misc */

/* Numbers deserve to be scannable, not read left to right. */
.sa-figure,
.sa-figure table {
  font-variant-numeric: tabular-nums;
}

.md-typeset .sa-note {
  font-size: 0.7rem;
  line-height: 1.6;
  color: var(--sa-faint);
}

/* Long tables scroll inside themselves, never the page. */
.md-typeset__table {
  min-width: 0;
}

@media screen and (max-width: 44.98em) {
  .md-typeset .sa-hero h1 {
    font-size: 2.1rem;
  }
}