/* ═══════════════════════════════════════════════════════════════════════
   extra.css — the "Refined" direction for the docs surface.

   Loads after tokens.css and theme.css, so it re-tokens the --c-* brand
   variables to the refined values (deeper canvas, half-chroma neutrals,
   near-white text) and restyles the Material element vocabulary on top of
   theme.css's --md-* mapping. Accent policy: azure (#3DA9E8) survives only
   on links-on-hover, focus rings, and code accents; every active state is
   white-on-neutral, every hover is a neutral step — no hue shifts.

   Reference: design handoff panel 3p (six paired docs pages) +
   RECOMMENDATIONS item 9. Do not fork the theme; everything here rides on
   Material's public class names and --md-* custom properties.
   ═══════════════════════════════════════════════════════════════════════ */

/* Fonts: mkdocs.yml sets `font: false`, so Material loads nothing. This is
   the same Google-hosted URL the webapp loads, minus DM Sans (retired). */
@import url('https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@300;400;500;600;700&family=Space+Grotesk:wght@300;400;500;600;700&display=swap');

:root {
  --md-text-font: "Space Grotesk";
  --md-code-font: "JetBrains Mono";
}

/* ── Refined tokens — dark ──────────────────────────────────────────── */
[data-md-color-scheme="slate"] {
  --c-base:          #101114;   /* canvas                       */
  --c-base-card:     #191b21;   /* borderless panels            */
  --c-base-elevated: #1e2026;   /* wells, active-nav surface    */
  --c-base-raised:   #24272e;   /* overlays only                */
  --c-base-deep:     #0b0c0f;   /* code floor                   */

  --c-rosewater:     #d6dae3;   /* text primary                 */
  --c-text:          #9196a2;   /* text secondary               */
  --c-highlight1:    #6a6f7b;   /* text tertiary                */
  --c-text-faint:    #6a6f7b;   /* eyebrows, table headers      */

  --c-border:        rgba(233,235,239,0.07);   /* region seams      */
  --c-border-light:  rgba(233,235,239,0.12);   /* inputs, hairlines */
  --c-border-strong: rgba(233,235,239,0.25);   /* hover hairlines   */
  --c-border-row:    rgba(233,235,239,0.05);   /* table rows        */

  --c-surface1:      #1e2026;
  --c-surface2:      #24272e;
  --c-surface3:      #2e323a;

  /* Material remaps that differ from theme.css under the refined policy */
  --md-primary-fg-color:        var(--c-base);       /* header on canvas  */
  --md-footer-bg-color:         var(--c-base);
  --md-footer-bg-color--dark:   var(--c-base);
  --md-code-bg-color:           var(--c-base-deep);  /* code on the floor */
}

/* ── Refined tokens — light (ramp flipped: canvas lightest) ─────────── */
[data-md-color-scheme="default"] {
  --c-base:          #fafafb;
  --c-base-card:     #f1f2f4;
  --c-base-elevated: #e9eaee;
  --c-base-raised:   #ffffff;
  --c-base-deep:     #eceef1;

  --c-rosewater:     #17181c;
  --c-text:          #555a64;
  --c-highlight1:    #8b8f99;
  --c-text-faint:    #8b8f99;

  --c-border:        rgba(23,24,28,0.08);
  --c-border-light:  rgba(23,24,28,0.12);
  --c-border-strong: rgba(23,24,28,0.22);
  --c-border-row:    rgba(23,24,28,0.05);

  --c-surface1:      #e9eaee;
  --c-surface2:      #dfe1e6;
  --c-surface3:      #d4d7dd;

  --md-primary-fg-color:        var(--c-base);
  --md-footer-bg-color:         var(--c-base);
  --md-footer-bg-color--dark:   var(--c-base);
  --md-code-bg-color:           var(--c-base-deep);
}

/* ── Type scale — 15px body, sentence-case near-white headlines ─────── */
.md-typeset {
  font-size: 0.75rem;
  line-height: 1.7;
}
.md-typeset h1 {
  font-size: 1.9rem;
  font-weight: 600;
  letter-spacing: -0.02em;
  color: var(--c-rosewater);
}
.md-typeset h2 {
  font-size: 1.2rem;
  font-weight: 600;
  letter-spacing: -0.01em;
  color: var(--c-rosewater);
}
.md-typeset h3 {
  font-size: 0.9rem;
  font-weight: 600;
  color: var(--c-rosewater);
}
.md-typeset h4 {
  font-size: 0.75rem;
  font-weight: 600;
  color: var(--c-rosewater);
}

/* Links rest neutral; azure is the hover/focus voice (Material's own
   a:hover rule supplies --md-accent-fg-color, which stays azure). */
[data-md-color-scheme="slate"],
[data-md-color-scheme="default"] {
  --md-typeset-a-color: var(--c-rosewater);
}

/* Preset-palette guard. A returning visitor's stored palette (the old
   implicit indigo default) re-attaches data-md-color-primary=..., whose
   two-attribute preset selectors out-specify the scheme-only blocks
   above — pin the vars at the same specificity, later in the cascade. */
[data-md-color-scheme="slate"][data-md-color-primary],
[data-md-color-scheme="default"][data-md-color-primary] {
  --md-typeset-a-color: var(--c-rosewater);
  --md-accent-fg-color: var(--c-accent);
  --md-accent-fg-color--transparent: var(--c-accent-dim);
  --md-primary-fg-color: var(--c-base);
  --md-primary-bg-color: var(--c-rosewater);
  --md-primary-bg-color--light: var(--c-text);
}

/* ── Header — canvas surface, hairline seam, no shadow ──────────────── */
.md-header {
  background-color: var(--md-primary-fg-color);
  border-bottom: 1px solid var(--c-border);
  box-shadow: none;
}
.md-header--shadow {
  box-shadow: none;
}
.md-header__inner {
  height: 3rem;
  align-items: center;
}
.md-header__title {
  font-weight: 600;
  font-size: 0.7rem;
}

/* Version selector (mike) — mono chip, neutral; the list is an overlay
   so its default shadow stays. */
.md-version__current {
  font-family: var(--md-code-font-family);
  font-size: 0.5rem;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--c-text);
}
.md-version__list {
  background-color: var(--c-base-raised);
  color: var(--c-text);
}

/* ── Nav tabs — mono uppercase, active = white underline, no hue ────── */
.md-tabs {
  background-color: var(--md-primary-fg-color);
  border-bottom: 1px solid var(--c-border);
}
.md-tabs__link {
  font-family: var(--md-code-font-family);
  font-size: 0.525rem;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--c-highlight1);
  opacity: 1;
}
.md-tabs__link:is(:focus, :hover) {
  color: var(--c-rosewater);
  opacity: 1;
}
.md-tabs__link--active {
  color: var(--c-rosewater);
  box-shadow: inset 0 -2px 0 var(--c-rosewater);
}

/* ── Search — neutral well, mono voice; dropdown is an overlay ──────── */
.md-search__form {
  background-color: var(--c-base-elevated);
  border-radius: var(--radius-sm);
}
.md-search__form:hover {
  background-color: var(--c-surface2);
}
.md-search__input {
  font-family: var(--md-code-font-family);
  font-size: 0.575rem;
  color: var(--c-text);
}
.md-search__input::placeholder {
  color: var(--c-highlight1);
}
[data-md-toggle="search"]:checked ~ .md-header .md-search__form {
  background-color: var(--c-base-elevated);
}
.md-search__output {
  border-radius: 0 0 var(--radius-md) var(--radius-md);
}

/* ── Sidebar nav rail — eyebrow sections, white-on-neutral active ───── */
.md-sidebar--primary {
  width: 14rem;
  border-right: 1px solid var(--c-border);
}
.md-sidebar--secondary {
  border-left: 1px solid var(--c-border);
}
.md-nav {
  font-size: 0.65rem;
}
.md-sidebar--primary .md-nav__title,
.md-nav--secondary .md-nav__title {
  font-family: var(--md-code-font-family);
  font-size: 0.475rem;
  font-weight: 600;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--c-text-faint);
  background: transparent;
  box-shadow: none;
}
.md-nav__item--section > .md-nav__link {
  font-family: var(--md-code-font-family);
  font-size: 0.475rem;
  font-weight: 600;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--c-text-faint);
}
.md-nav__link {
  color: var(--c-highlight1);
  border-radius: 6px;
  padding: 0.3rem 0.7rem;
  margin-top: 0.1rem;
}
.md-nav__link:is(:focus, :hover) {
  color: var(--c-rosewater);
}
.md-nav__item .md-nav__link--active,
.md-nav__item .md-nav__link--active code {
  color: var(--c-rosewater);
}
.md-nav--primary .md-nav__link--active {
  background-color: var(--c-base-elevated);
}

/* ── TOC rail — neutral list, text-primary active bar ───────────────── */
.md-nav--secondary .md-nav__link {
  font-size: 0.625rem;
  border-left: 2px solid transparent;
  border-radius: 0;
  padding: 0.25rem 0 0.25rem 0.6rem;
  margin-top: 0;
}
.md-nav--secondary .md-nav__link--active {
  border-left-color: var(--c-rosewater);
  background-color: transparent;
}

/* ── Tables — hairline rows only, mono uppercase headers ────────────── */
.md-typeset table:not([class]) {
  border: 0;
  border-radius: 0;
  box-shadow: none;
  background: transparent;
  font-size: 0.65rem;
}
.md-typeset table:not([class]) th {
  font-family: var(--md-code-font-family);
  font-size: 0.5rem;
  font-weight: 600;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--c-text-faint);
  background: transparent;
  border-bottom: 1px solid var(--c-border-light);
  padding: 0.5em 0.75em;
  vertical-align: bottom;
}
.md-typeset table:not([class]) td {
  color: var(--c-text);
  border-top: 0;
  border-bottom: 1px solid var(--c-border-row);
  padding: 0.6em 0.75em;
}
.md-typeset table:not([class]) td:first-child {
  font-family: var(--md-code-font-family);
  font-size: 0.6rem;
  font-variant-numeric: tabular-nums;
  color: var(--md-default-fg-color);
}

/* ── Code — blocks and inline chips on the deep floor ───────────────── */
.md-typeset pre > code {
  border-left: 0;                          /* retires the azure spine    */
  border-radius: var(--radius-md);
  padding: 0.8rem 1rem;
  font-size: 0.6rem;
  line-height: 1.9;
  font-variant-numeric: tabular-nums;
}
/* :not(.focus-visible) out-specifies Material's blanket `outline: none`
   on code elements; focus keeps the azure ring. */
.md-typeset pre > code:not(.focus-visible) {
  outline: 1px solid var(--c-border);
  outline-offset: -1px;
}
.md-typeset code {
  border-radius: var(--radius-sm);
}
/* Inline chip — a raised neutral well with a hairline edge. Scoped off the
   fenced blocks above (:not(pre) > code), which keep the deep floor. */
.md-typeset :not(pre) > code {
  background-color: var(--c-surface3);
  color: var(--c-rosewater);
  border: 1px solid var(--c-border-strong);
}
/* Code in a heading is mono text in the heading's ink, never a box. */
.md-typeset :is(h1, h2, h3, h4, h5, h6) code {
  background-color: transparent;
  border: 0;
  color: inherit;
}
.md-typeset .highlight span.filename {
  font-family: var(--md-code-font-family);
  font-size: 0.55rem;
  letter-spacing: 0.08em;
  background-color: var(--c-base-elevated);
  color: var(--c-text);
  border-bottom: 0;
  border-radius: var(--radius-md) var(--radius-md) 0 0;
}
.md-typeset .highlight span.filename + pre > code {
  border-radius: 0 0 var(--radius-md) var(--radius-md);
}

/* ── Admonitions — neutral card, status hue on spine + title only ───── */
.md-typeset .admonition,
.md-typeset details {
  background-color: var(--c-base-card);
  border-width: 0 0 0 2px;
  border-left-style: solid;
  border-left-color: var(--c-blue);
  border-radius: var(--radius-md);
  box-shadow: none;
  font-size: 0.65rem;
  color: var(--c-text);
  padding: 0.1rem 1rem 0.4rem;
}
.md-typeset .admonition > .admonition-title,
.md-typeset details > summary {
  background-color: transparent;
  font-family: var(--md-code-font-family);
  font-size: 0.5rem;
  font-weight: 600;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--c-blue);
  margin: 0 -1rem;
  padding: 0.7rem 1rem 0.1rem 2.1rem;
}
.md-typeset .admonition > .admonition-title::before,
.md-typeset details > summary::before {
  left: 0.9rem;
  top: 0.65rem;
  width: 0.7rem;
  height: 0.7rem;
}
.md-typeset details > summary::after {
  top: 0.6rem;
}
.md-typeset :is(.admonition, details):is(.tip, .success, .hint, .check, .done) {
  border-left-color: var(--c-accent-text);
}
.md-typeset :is(.tip, .success, .hint, .check, .done) > :is(.admonition-title, summary) {
  color: var(--c-accent-text);
}
.md-typeset :is(.tip, .success, .hint, .check, .done) > :is(.admonition-title, summary)::before {
  background-color: var(--c-accent-text);
}
.md-typeset :is(.admonition, details):is(.warning, .caution, .attention, .question, .help, .faq) {
  border-left-color: var(--c-yellow);
}
.md-typeset :is(.warning, .caution, .attention, .question, .help, .faq) > :is(.admonition-title, summary) {
  color: var(--c-yellow);
}
.md-typeset :is(.warning, .caution, .attention, .question, .help, .faq) > :is(.admonition-title, summary)::before {
  background-color: var(--c-yellow);
}
.md-typeset :is(.admonition, details):is(.danger, .failure, .bug, .error, .missing, .fail) {
  border-left-color: var(--c-red);
}
.md-typeset :is(.danger, .failure, .bug, .error, .missing, .fail) > :is(.admonition-title, summary) {
  color: var(--c-red);
}
.md-typeset :is(.danger, .failure, .bug, .error, .missing, .fail) > :is(.admonition-title, summary)::before {
  background-color: var(--c-red);
}
.md-typeset :is(.admonition, details).example {
  border-left-color: var(--c-blue);
}
.md-typeset .example > :is(.admonition-title, summary) {
  color: var(--c-blue);
}
.md-typeset .example > :is(.admonition-title, summary)::before {
  background-color: var(--c-blue);
}
.md-typeset :is(.note, .info, .abstract, .summary, .tldr, .quote, .cite) > :is(.admonition-title, summary)::before {
  background-color: var(--c-blue);
}

/* ── Blockquote — neutral hairline spine ────────────────────────────── */
.md-typeset blockquote {
  border-left: 2px solid var(--c-border-strong);
  color: var(--c-text);
}

/* ── Grid cards — borderless surface step, neutral hover ────────────── */
.md-typeset .grid.cards > :is(ul, ol) > li,
.md-typeset .grid > .card {
  background-color: var(--c-base-card);
  border: 0;
  border-radius: var(--radius-md);
  box-shadow: none;
  padding: 1rem 1.2rem;
  transition: background-color var(--duration-fast) var(--ease-out);
}
.md-typeset .grid.cards > :is(ul, ol) > li:is(:focus-within, :hover),
.md-typeset .grid > .card:is(:focus-within, :hover) {
  background-color: var(--c-base-elevated);
  border: 0;
  box-shadow: none;
}

/* ── Buttons — primary = white fill; secondary keeps its hairline ───── */
.md-typeset .md-button {
  border: 1px solid var(--c-border-light);
  border-radius: var(--radius-md);
  color: var(--c-text);
}
.md-typeset .md-button:is(:focus, :hover) {
  background-color: var(--c-base-elevated);
  border-color: var(--c-border-strong);
  color: var(--c-rosewater);
}
.md-typeset .md-button--primary {
  background-color: var(--c-rosewater);
  border-color: transparent;
  color: var(--c-base-deep);
}
.md-typeset .md-button--primary:is(:focus, :hover) {
  background-color: var(--c-rosewater);
  border-color: transparent;
  color: var(--c-base-deep);
  opacity: 0.9;
}

/* ── Content tabs (pymdownx.tabbed) — white active, no azure ────────── */
.md-typeset .tabbed-labels {
  --md-accent-fg-color: var(--c-rosewater);
}
.md-typeset .tabbed-labels > label {
  font-family: var(--md-code-font-family);
  font-size: 0.525rem;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--c-highlight1);
}
.md-typeset .tabbed-labels > label:hover {
  color: var(--c-rosewater);
}

/* ── Content column — refined measure and breathing room ────────────── */
.md-content__inner {
  max-width: 38rem;
  margin-left: auto;
  margin-right: auto;
  padding-top: 1.2rem;
}
.md-typeset hr {
  border-bottom: 1px solid var(--c-border);
}

/* ── Footer — prev/next as hairline cards on canvas ─────────────────── */
.md-footer {
  background-color: var(--c-base);
  color: var(--c-text);
}
.md-footer__inner {
  gap: 0.6rem;
  padding: 1.2rem 0.8rem;
}
.md-footer__link {
  border: 1px solid var(--c-border-light);
  border-radius: var(--radius-md);
  padding: 0.7rem 0.9rem;
  transition: border-color var(--duration-fast) var(--ease-out);
}
.md-footer__link:is(:focus, :hover) {
  opacity: 1;
  border-color: var(--c-border-strong);
}
.md-footer__direction {
  font-family: var(--md-code-font-family);
  font-size: 0.45rem;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--c-text-faint);
  opacity: 1;
}
.md-footer__title {
  font-size: 0.7rem;
  color: var(--c-text);
}
.md-footer__link--next .md-footer__title {
  color: var(--c-rosewater);
}
.md-footer-meta {
  background-color: var(--c-base);
  border-top: 1px solid var(--c-border);
}

/* ── Back-to-top — floating overlay, neutral surfaces ───────────────── */
.md-top {
  background-color: var(--c-base-elevated);
  color: var(--c-rosewater);
}
.md-top:is(:focus, :hover) {
  background-color: var(--c-surface2);
  color: var(--c-rosewater);
}