/* ===========================================================
   The docs site in Clarity, the Shyft Solutions design system.

   Token values are copied from Clarity's token layer (the copy in
   wxchange-frontend, src/styles/clarity-tokens.css); only the tokens
   this site uses are here. The rest of the file maps them onto the
   theme's variables for both schemes: "default" (light) and "slate"
   (dark), chosen by the palette toggle in site/mkdocs.yml.

   Two deliberate departures from Clarity's semantic set, both for
   WCAG AA (4.5:1) on text: in light mode, links and active navigation
   use --blue-700 (5.3:1 or better on every light surface) instead of
   --accent (#329af0, 2.8:1); brand blue stays on borders and focus.
   In dark mode --accent (#4eaff5) already passes (5.3:1 or better).

   Fonts are the three Clarity families, self-hosted (SIL OFL 1.1),
   so the site makes no third-party font requests.
   =========================================================== */

@font-face {
  font-family: "Inter";
  font-style: normal;
  font-weight: 100 900;
  font-display: swap;
  src: url("fonts/inter-variable-latin.woff2") format("woff2");
}
@font-face {
  font-family: "Sora";
  font-style: normal;
  font-weight: 100 800;
  font-display: swap;
  src: url("fonts/sora-latin.woff2") format("woff2");
}
@font-face {
  font-family: "JetBrains Mono";
  font-style: normal;
  font-weight: 100 800;
  font-display: swap;
  src: url("fonts/jetbrains-mono-latin.woff2") format("woff2");
}

/* Tokens ---------------------------------------------------- */

:root,
[data-md-color-scheme="default"] {
  --blue-300: #72c3fc;
  --blue-400: #4eaff5;
  --blue-500: #329af0;
  --blue-600: #1c7cd6;
  --blue-700: #1565b1;
  --charcoal-25: #f8f9fa;
  --charcoal-50: #f1f3f5;
  --charcoal-100: #e9ecef;
  --charcoal-200: #dde1e6;
  --charcoal-400: #adb5bd;
  --charcoal-500: #868e96;
  --charcoal-600: #5c636a;
  --charcoal-700: #404750;
  --charcoal-800: #2d333b;
  --charcoal-900: #212529;
  --charcoal-950: #15181c;
  --green-700: #37b24d;
  --orange-500: #ff922b;
  --pink-700: #de0f80;
  --purple-500: #a551cf;

  /* Semantic, light */
  --bg: var(--charcoal-25);
  --bg-elev: #ffffff;
  --bg-subtle: var(--charcoal-50);
  --border: var(--charcoal-100);
  --border-strong: var(--charcoal-200);
  --text: var(--charcoal-900);
  --text-muted: var(--charcoal-600);
  --text-subtle: var(--charcoal-500);
  --accent: var(--blue-500);
  --accent-strong: var(--blue-600);
  --accent-soft: #e8f4ff;
  --on-accent: #ffffff;
  --ring: rgba(50, 154, 240, 0.22);
  --success: var(--green-700);
  --success-soft: #e8f7eb;
  --warn: var(--orange-500);
  --warn-soft: #fff1e2;
  --danger: var(--pink-700);
  --danger-soft: #fde6f1;
  --info: var(--blue-500);
  --info-soft: #e8f4ff;
  --example: var(--purple-500);
  --example-soft: #f3e8fa;

  /* Text-safe link colours (see the note at the top) */
  --link: var(--blue-700);
  --link-hover: var(--blue-600);

  --r-sm: 6px;
  --r-md: 8px;
  --r-lg: 10px;

  --font-ui: "Inter", ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
  --font-display: "Sora", "Inter", ui-sans-serif, system-ui, sans-serif;
  --font-mono: "JetBrains Mono", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
}

[data-md-color-scheme="slate"] {
  /* Semantic, dark (Clarity's [data-theme="dark"]) */
  --bg: var(--charcoal-950);
  --bg-elev: var(--charcoal-900);
  --bg-subtle: var(--charcoal-800);
  --border: var(--charcoal-800);
  --border-strong: var(--charcoal-700);
  --text: #f3f5f7;
  --text-muted: var(--charcoal-400);
  --text-subtle: var(--charcoal-500);
  --accent: var(--blue-400);
  --accent-strong: var(--blue-300);
  --accent-soft: rgba(50, 154, 240, 0.15);
  --on-accent: var(--charcoal-950);
  --success-soft: rgba(81, 207, 102, 0.14);
  --warn-soft: rgba(255, 146, 43, 0.15);
  --danger-soft: rgba(240, 50, 154, 0.15);
  --info-soft: rgba(50, 154, 240, 0.15);
  --example-soft: rgba(165, 81, 207, 0.15);

  --link: var(--blue-400);
  --link-hover: var(--blue-300);
}

/* Tokens onto the theme, both schemes ------------------------ */

:root,
[data-md-color-scheme="default"],
[data-md-color-scheme="slate"] {
  --md-text-font: "Inter";
  --md-code-font: "JetBrains Mono";

  --md-default-fg-color: var(--text);
  --md-default-fg-color--light: var(--text-muted);
  --md-default-fg-color--lighter: var(--text-subtle);
  --md-default-fg-color--lightest: var(--border);
  --md-default-bg-color: var(--bg);

  --md-primary-fg-color: var(--link);
  --md-primary-fg-color--light: var(--accent);
  --md-primary-fg-color--dark: var(--link);
  --md-primary-bg-color: var(--on-accent);
  --md-accent-fg-color: var(--link-hover);
  --md-accent-fg-color--transparent: var(--accent-soft);
  --md-accent-bg-color: var(--on-accent);

  --md-typeset-color: var(--text);
  --md-typeset-a-color: var(--link);
  --md-typeset-table-color: var(--border-strong);
  --md-typeset-table-color--light: var(--bg-subtle);

  --md-code-fg-color: var(--text);
  --md-code-bg-color: var(--bg-subtle);
  --md-code-bg-color--light: var(--bg-subtle);
  --md-code-bg-color--lighter: var(--bg-subtle);

  --md-admonition-fg-color: var(--text);
}

/* The theme sets slate headings to pure white; Clarity's text colour instead. */
[data-md-color-scheme="slate"] .md-header__title,
[data-md-color-scheme="slate"] .md-typeset h1,
[data-md-color-scheme="slate"] .md-typeset h2,
[data-md-color-scheme="slate"] .md-typeset h3,
[data-md-color-scheme="slate"] .md-typeset h4,
[data-md-color-scheme="slate"] .md-typeset h5,
[data-md-color-scheme="slate"] .md-typeset h6 {
  color: var(--text);
}

/* Type ------------------------------------------------------- */

.md-header__title,
.md-typeset h1,
.md-typeset h2,
.md-typeset h3 {
  font-family: var(--font-display);
  letter-spacing: -0.02em;
}
.md-typeset h1 { font-weight: 600; }
.md-typeset h2,
.md-typeset h3 { font-weight: 600; }

/* Header: Clarity's top bar, an elevated surface with a hairline. */
.md-header {
  background-color: var(--bg-elev);
  border-bottom: 1px solid var(--border);
  -webkit-backdrop-filter: none;
  backdrop-filter: none;
}
/* The mark's "S" is charcoal: in dark mode it sits on a light tile. */
.md-header__button.md-logo img {
  height: 1.3rem;
}
[data-md-color-scheme="slate"] .md-header__button.md-logo img {
  background: #ffffff;
  border-radius: var(--r-sm);
  padding: 0.15rem 0.25rem;
}

/* Sidebar navigation */
.md-nav__link--active,
.md-nav__item .md-nav__link--active code {
  color: var(--link);
}
.md-nav__link:hover,
.md-nav__link:focus {
  color: var(--link-hover);
}

/* Links */
.md-typeset a:focus,
.md-typeset a:hover {
  color: var(--link-hover);
}
:focus-visible {
  outline-color: var(--accent);
}

/* Code */
.md-typeset code,
.md-typeset pre > code {
  border: 1px solid var(--border);
}
.md-typeset pre > code {
  border-radius: var(--r-md);
}

/* Tables */
.md-typeset table:not([class]) {
  background-color: var(--bg-elev);
  border: 1px solid var(--border-strong);
  border-radius: var(--r-md);
}
.md-typeset table:not([class]) th {
  background-color: var(--bg-subtle);
  color: var(--text);
}
.md-typeset table:not([class]) td {
  border-top: 1px solid var(--border);
}

/* Admonitions: Clarity's semantic soft fills, strong edges. */
.md-typeset .admonition,
.md-typeset details {
  background-color: var(--info-soft);
  border: 1px solid var(--border);
  border-left: 3px solid var(--info);
  border-radius: var(--r-md);
}
.md-typeset :is(.note, .info, .abstract, .question) {
  background-color: var(--info-soft);
  border-left-color: var(--info);
}
.md-typeset :is(.tip, .success) {
  background-color: var(--success-soft);
  border-left-color: var(--success);
}
.md-typeset .warning {
  background-color: var(--warn-soft);
  border-left-color: var(--warn);
}
.md-typeset :is(.danger, .failure, .bug) {
  background-color: var(--danger-soft);
  border-left-color: var(--danger);
}
.md-typeset .example {
  background-color: var(--example-soft);
  border-left-color: var(--example);
}
.md-typeset :is(.note, .info, .abstract, .question) > :is(.admonition-title, summary)::before { background-color: var(--info); }
.md-typeset :is(.tip, .success) > :is(.admonition-title, summary)::before { background-color: var(--success); }
.md-typeset .warning > :is(.admonition-title, summary)::before { background-color: var(--warn); }
.md-typeset :is(.danger, .failure, .bug) > :is(.admonition-title, summary)::before { background-color: var(--danger); }
.md-typeset .example > :is(.admonition-title, summary)::before { background-color: var(--example); }

/* Charts: the Python SDK's figures are drawn with plotly's light template
   when the site is built, so they cannot follow the scheme. Each sits on a
   light card with Clarity's radius and border; in dark mode the card is a
   deliberate light panel rather than a stray white box. */
.md-typeset .plotly-graph-div {
  background: #ffffff;
  border: 1px solid var(--border-strong);
  border-radius: var(--r-md);
  overflow: hidden;
}
