/*
 * docs.css - maps the Material theme onto the bb-design tokens (assets/bb-design/bb-design.css must load first).
 * Purpose: brand look of both doc sites: quiet surface header with an underline tab bar, readable text and links, cards, diagrams.
 * Invariants: tokens only, no raw colours, durations or font names (check T of the web-refresh plan). The scheme is chosen by
 * Material's toggle; main.html mirrors it to <html data-theme> so bb-design tokens switch with it.
 */
:root,
[data-md-color-scheme] {
  --md-primary-fg-color: var(--bb-color-primary-fill);
  --md-primary-fg-color--light: var(--bb-color-primary-fill-hover);
  --md-primary-fg-color--dark: var(--bb-color-primary-border);
  --md-primary-bg-color: var(--bb-color-on-primary);
  --md-primary-bg-color--light: var(--bb-color-on-primary);
  --md-accent-fg-color: var(--bb-color-link);
  --md-accent-fg-color--transparent: var(--bb-color-surface-2);
  --md-accent-bg-color: var(--bb-color-on-primary);

  --md-default-bg-color: var(--bb-color-bg);
  --md-default-bg-color--light: var(--bb-color-surface);
  --md-default-fg-color: var(--bb-color-text);
  --md-default-fg-color--light: var(--bb-color-text-muted);
  --md-default-fg-color--lighter: var(--bb-color-border);
  --md-default-fg-color--lightest: var(--bb-color-surface-2);
  --md-typeset-color: var(--bb-color-text);
  --md-typeset-a-color: var(--bb-color-link);
  --md-typeset-mark-color: var(--bb-color-accent);
  --md-typeset-table-color: var(--bb-color-border);
  --md-code-bg-color: var(--bb-color-code-bg);
  --md-code-fg-color: var(--bb-color-text);
  --md-footer-bg-color: var(--bb-color-surface-2);
  --md-footer-bg-color--dark: var(--bb-color-surface);
  --md-footer-fg-color: var(--bb-color-text);
  --md-footer-fg-color--light: var(--bb-color-text-muted);
  --md-footer-fg-color--lighter: var(--bb-color-text-muted);
  --md-shadow-z1: var(--bb-shadow-1);
  --md-shadow-z2: var(--bb-shadow-2);
  --md-shadow-z3: var(--bb-shadow-3);
  --md-text-font: var(--bb-font-sans);
  --md-code-font: var(--bb-font-mono);
  --md-text-font-family: var(--bb-font-sans);
  --md-code-font-family: var(--bb-font-mono);

}

/* Type */
.md-typeset {
  line-height: var(--bb-line-height-normal);
}
.md-typeset h1,
.md-typeset h2 {
  font-family: var(--bb-font-display);
}
.md-typeset h1 {
  color: var(--bb-color-text);
  font-weight: var(--bb-font-weight-bold);
  letter-spacing: -0.02em;
}
.md-typeset h2 {
  font-weight: var(--bb-font-weight-bold);
  margin-top: var(--bb-space-7);
  padding-bottom: var(--bb-space-2);
  border-bottom: 1px solid var(--bb-color-border);
}
.md-typeset a {
  text-underline-offset: 0.2em;
}
.md-typeset mark {
  color: var(--bb-color-on-accent);
  border-radius: var(--bb-radius-sm);
  padding-inline: var(--bb-space-1);
}
.md-typeset :focus-visible {
  outline: 3px solid var(--bb-color-focus);
  outline-offset: 2px;
}
.md-typeset code {
  border-radius: var(--bb-radius-sm);
}
.md-typeset table:not([class]) {
  border-radius: var(--bb-radius-md);
  border: 1px solid var(--bb-color-border);
  box-shadow: none;
}
.md-typeset table:not([class]) th {
  background-color: var(--bb-color-surface-2);
  color: var(--bb-color-text);
}
.md-typeset .admonition,
.md-typeset details {
  border-radius: var(--bb-radius-md);
  box-shadow: none;
  transition:
    background-color var(--bb-motion-duration-fast) var(--bb-motion-ease-standard),
    border-color var(--bb-motion-duration-fast) var(--bb-motion-ease-standard);
}
.md-typeset .tabbed-labels > label {
  transition: color var(--bb-motion-duration-fast) var(--bb-motion-ease-standard);
}

/* Page fade on load and on instant navigation (Material swaps the content node, so the animation replays). Not scroll-driven. */
.md-content__inner {
  animation: bb-fade var(--bb-motion-duration-base) var(--bb-motion-ease-standard) both;
}

/* Cards (home page grid): hover lift, never the only cue. */
.md-typeset .grid.cards > ul > li,
.md-typeset .grid > .card {
  border: 1px solid var(--bb-color-border);
  border-radius: var(--bb-radius-lg);
  background-color: var(--bb-color-surface);
  transition:
    transform var(--bb-motion-duration-base) var(--bb-motion-ease-standard),
    box-shadow var(--bb-motion-duration-base) var(--bb-motion-ease-standard),
    border-color var(--bb-motion-duration-base) var(--bb-motion-ease-standard);
}
.md-typeset .grid.cards > ul > li:hover,
.md-typeset .grid.cards > ul > li:focus-within {
  transform: translateY(calc(var(--bb-space-1) * -1));
  box-shadow: var(--bb-shadow-3);
  border-color: var(--bb-color-primary-border);
}

/* Diagrams are pre-rendered SVG pairs (light and dark, see docs/dev/diagram-style.md). The frame is a keyboard-focusable scroll region:
   the image fills the column up to its natural width (--bb-diagram-w, set per image) and never shrinks below 75% of it, so text stays
   above 12 px; anything wider scrolls sideways instead of being clipped. */
.bb-diagram {
  margin-block: var(--bb-space-5);
  padding: var(--bb-space-4);
  overflow-x: auto;
  border: 1px solid var(--bb-color-border);
  border-radius: var(--bb-radius-lg);
  background-color: var(--bb-color-surface);
}
.bb-diagram img {
  display: block;
  width: clamp(calc(var(--bb-diagram-w) * 0.75), 100%, var(--bb-diagram-w));
  max-width: none;
  height: auto;
  margin-inline: auto;
}
.bb-diagram:focus-visible {
  outline: 3px solid var(--bb-color-focus);
  outline-offset: 2px;
}

/* Phones: 40px navigation targets. Literal px because custom properties do not work in media queries. */
@media (max-width: 767px) {
  .md-nav__link,
  .md-nav--secondary .md-nav__link,
  .md-tabs__link {
    display: flex;
    align-items: center;
    min-height: 40px;
  }
}

/* Print / forced colours keep Material's defaults. */