custom.css

/**
 * Erigon brand colors — light and dark theme.
 * Primary: #1F9D3E (Zilkworm Green), Hover: #1C8E38
 * The green body theme is Zilkworm-specific — a deliberate deviation from
 * the shared Erigon palette introduced in PRs #12 / #16. In the footer, green
 * drives the link and legal hovers; only the brand lockup hovers Erigon
 * Orange, via the footer-scoped --footer-accent. See design spec §6.2 for this
 * site's terminal footer variant.
 * Light bg: #FFFFFF, Dark bg: #0A0A0A
 * Fonts: Montserrat ExtraBold (headings), Nunito Sans (body),
 *        Quantify 700 (brand wordmark — navbar title + footer brand, see
 *        docusaurus-design-spec.md §7 Font Roles)
 */

/* Self-hosted fonts — no Google Fonts or CDN. See docusaurus-design-spec.md §7. */
@font-face {
  font-family: 'Montserrat';
  src: url('/fonts/Montserrat-ExtraBold.woff2') format('woff2');
  font-weight: 800;
  font-style: normal;
  font-display: swap;
}
@font-face {
  font-family: 'Nunito Sans';
  src: url('/fonts/NunitoSans-Regular.woff2') format('woff2');
  font-weight: 400;
  font-style: normal;
  font-display: swap;
}
@font-face {
  font-family: 'Nunito Sans';
  src: url('/fonts/NunitoSans-Bold.woff2') format('woff2');
  font-weight: 700;
  font-style: normal;
  font-display: swap;
}
@font-face {
  font-family: 'Nunito Sans';
  src: url('/fonts/NunitoSans-ExtraBold.woff2') format('woff2');
  font-weight: 800;
  font-style: normal;
  font-display: swap;
}
@font-face {
  font-family: 'Quantify';
  src: url('/fonts/Quantify.woff2') format('woff2');
  font-weight: 700;
  font-style: normal;
  font-display: swap;
}

:root {
  /* Brand fonts */
  --ifm-font-family-base: 'Nunito Sans', sans-serif;
  --ifm-heading-font-family: 'Montserrat', sans-serif;
  --ifm-heading-font-weight: 800;
  /* Zilkworm Green scale */
  --ifm-color-primary: #1F9D3E;
  --ifm-color-primary-dark: #1C8E38;
  --ifm-color-primary-darker: #1A8534;
  --ifm-color-primary-darkest: #156C2B;
  --ifm-color-primary-light: #29AE4A;
  --ifm-color-primary-lighter: #35B855;
  --ifm-color-primary-lightest: #57C873;

  --ifm-code-font-size: 95%;
  --docusaurus-highlighted-code-line-bg: rgba(31, 157, 62, 0.1);

  /* Light mode */
  --ifm-background-color: #FFFFFF;
  --ifm-font-color-base: #000000;

  /* Navbar — light mode */
  --ifm-navbar-background-color: #FFFFFF;
  --ifm-navbar-link-color: #111111;
  --ifm-navbar-link-hover-color: #1F9D3E;
  --ifm-navbar-shadow: 0 1px 0 rgba(0,0,0,0.08);

  /* Navbar button tokens — light mode */
  --navbar-btn-color: #111111;
  --navbar-btn-border: rgba(0,0,0,0.25);
  --navbar-btn-color-muted: rgba(0,0,0,0.55);

  /* Active sidebar item */
  --ifm-menu-color-active: #1F9D3E;
}

[data-theme='dark'] {
  /* Same green scale, readable on dark */
  --ifm-color-primary: #1F9D3E;
  --ifm-color-primary-dark: #1C8E38;
  --ifm-color-primary-darker: #1A8534;
  --ifm-color-primary-darkest: #156C2B;
  --ifm-color-primary-light: #29AE4A;
  --ifm-color-primary-lighter: #35B855;
  --ifm-color-primary-lightest: #57C873;

  --docusaurus-highlighted-code-line-bg: rgba(31, 157, 62, 0.2);

  /* Dark mode */
  --ifm-background-color: #0A0A0A;
  --ifm-background-surface-color: #141414;
  --ifm-font-color-base: #FFFFFF;

  /* Navbar — dark mode */
  --ifm-navbar-background-color: #000000;
  --ifm-navbar-link-color: #FFFFFF;
  --ifm-navbar-link-hover-color: #1F9D3E;
  --ifm-navbar-shadow: none;

  /* Navbar button tokens — dark mode */
  --navbar-btn-color: #FFFFFF;
  --navbar-btn-border: rgba(255,255,255,0.35);
  --navbar-btn-color-muted: rgba(255,255,255,0.75);

  /* Active sidebar item */
  --ifm-menu-color-active: #1F9D3E;
}

/* ─── Brand typography enforcement ──────────────────────────────────────── */

h1, h2, h3, h4, h5, h6 {
  font-family: 'Montserrat', sans-serif;
  font-weight: 800;
}

h1 { letter-spacing: -0.015em; }
h2 { letter-spacing: -0.01em; }

h6 {
  text-transform: uppercase;
  letter-spacing: 0.06em;
  font-size: 0.85rem;
  color: var(--ifm-color-emphasis-700);
}

/* ─── Typography rhythm ─────────────────────────────────────────────────── */

html {
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  text-rendering: optimizeLegibility;
}

:root {
  --ifm-heading-line-height: 1.2;
}

.markdown h2 {
  margin-top: 2.5rem;
}
.markdown h3 {
  margin-top: 1.75rem;
}

.markdown h1, .markdown h2, .markdown h3, .markdown h4, .markdown h5, .markdown h6 {
  scroll-margin-top: calc(var(--ifm-navbar-height) + 1rem);
}

/* ─── Navbar ──────────────────────────────────────────────────────────────── */

.navbar__logo img {
  height: 42px;
  width: auto;
}
.navbar__brand {
  min-width: calc(var(--doc-sidebar-width, 300px) - 40px);
}
.navbar__title {
  color: var(--ifm-navbar-link-color);
  font-family: 'Quantify', sans-serif;
  font-weight: 700;
  letter-spacing: 0.04em;
}
.navbar .clean-btn {
  color: var(--ifm-navbar-link-color);
}
.navbar__link--active {
  color: #1F9D3E !important;
}
.navbar__items--left .navbar__item {
  font-family: 'Montserrat', sans-serif !important;
  font-weight: 800 !important;
  font-size: 0.9rem !important;
}

/* ─── Navbar right-side items ─────────────────────────────────────────────── */

.navbar-github-icon {
  display: flex;
  align-items: center;
  padding: 0 0.5rem;
  color: var(--navbar-btn-color-muted);
  transition: color 0.15s;
}
.navbar-github-icon:hover {
  color: #1F9D3E !important;
}

/* ─── Navbar GitHub icon link ────────────────────────────────────────────── */

.navbar-github-icon {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  padding: 0.3rem;
  margin-left: 0.25rem;
  color: var(--navbar-btn-color);
  border-radius: 0;
  transition: color 0.2s ease, background-color 0.2s ease;
}

.navbar-github-icon:hover {
  color: #1F9D3E;
  background-color: rgba(31, 157, 62, 0.08);
}

.navbar-github-icon svg {
  display: block;
}

/* ─── Table of contents (right sidebar) ──────────────────────────────────── */

.table-of-contents__link {
  font-size: var(--ifm-font-size-base);
}

/* ─── Pagination nav cards (prev/next) ───────────────────────────────────── */

.pagination-nav__link {
  box-shadow: none;
  transition: border-color 0.2s ease !important;
}
.pagination-nav__link:hover {
  border-color: #1F9D3E !important;
}

/* ─── Details / collapsible sections ─────────────────────────────────────── */

details.alert.alert--info {
  --ifm-alert-background-color: rgba(0, 0, 0, 0.05);
  --ifm-alert-border-color: rgba(0, 0, 0, 0.1);
  background-color: rgba(0, 0, 0, 0.05) !important;
  border-color: rgba(0, 0, 0, 0.1) !important;
  border-radius: 0 !important;
  scroll-margin-top: calc(var(--ifm-navbar-height) + 1rem);
}
[data-theme='dark'] details.alert.alert--info {
  --ifm-alert-background-color: rgba(255, 255, 255, 0.04);
  --ifm-alert-border-color: rgba(255, 255, 255, 0.1);
  background-color: rgba(255, 255, 255, 0.04) !important;
  border-color: rgba(255, 255, 255, 0.1) !important;
}
details.alert.alert--info {
  --docusaurus-details-decoration-color: #1F9D3E;
}
details.alert.alert--info summary {
  font-weight: 700;
  color: #555555;
}
[data-theme='dark'] details.alert.alert--info summary {
  color: rgba(255, 255, 255, 0.75);
}

/* ─── 404 page buttons ────────────────────────────────────────────────────── */

.button-404-primary {
  background: #1F9D3E;
  color: #ffffff !important;
  padding: 0.65rem 1.6rem;
  border-radius: 0;
  font-weight: 700;
  font-size: 0.95rem;
  text-decoration: none !important;
  transition: background 0.15s;
}
.button-404-primary:hover {
  background: #1C8E38;
  color: #ffffff !important;
}
.button-404-secondary {
  border: 1px solid var(--ifm-color-emphasis-300);
  color: var(--ifm-font-color-base) !important;
  padding: 0.65rem 1.6rem;
  border-radius: 0;
  font-weight: 600;
  font-size: 0.95rem;
  text-decoration: none !important;
  transition: border-color 0.15s;
}
.button-404-secondary:hover {
  border-color: #1F9D3E;
  color: var(--ifm-font-color-base) !important;
}

/* Footer background matches dark brand */
.footer {
  background-color: #000000;
}

/* ─── Footer accent + interactive states ─────────────────────────────────── */
/* Corporate orange for the footer's brand-lockup hover. Declared on `footer`,
   not :root, so it is genuinely scoped to the footer rather than merely named
   that way — --brand-accent is the site-wide Zilkworm Green and must not be
   touched. Flat across colour modes: #EF7716 reads on both footer surfaces. */
/* Surface matches the other docs sites (design spec §6.1): white in light mode,
   black in dark — not the Infima surface grey. Declared on `footer` alongside
   the accent so the whole footer palette stays scoped to it. */
footer {
  --footer-accent: #EF7716;
  --footer-bg: #FFFFFF;
  --footer-fg: #000000;
}
[data-theme='dark'] footer {
  --footer-bg: #000000;
  --footer-fg: #FFFFFF;
}

/* Interactive states live here, not in React onMouseEnter/onMouseLeave. Those
   only fire for a mouse, so keyboard users tabbing the footer got no accent
   state and no focus indicator. Footer and legal links hover Zilkworm Green
   (the terminal identity); only the brand lockup hovers corporate orange. */
.footer-brand {
  display: flex;
  align-items: center;
  gap: 0.6rem;
  color: inherit;
  text-decoration: none;
  transition: color 0.15s;
}
.footer-brand:hover,
.footer-brand:focus-visible {
  color: var(--footer-accent);
  /* Infima's `a:hover` sets text-decoration: underline and outranks the base
     class on specificity, so it has to be cleared on the state too. */
  text-decoration: none;
}

.footer-socials {
  display: flex;
  flex-direction: row;
  gap: 0.6rem;
  flex-wrap: wrap;
  margin-left: auto;
}

.footer-social {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 38px;
  height: 38px;
  border: 1px solid var(--ifm-toc-border-color);
  border-radius: 0;
  color: var(--ifm-font-color-base);
  text-decoration: none;
  background: transparent;
  transition: color 0.15s, border-color 0.15s, background-color 0.15s;
}
.footer-social:hover,
.footer-social:focus-visible {
  color: var(--brand-accent);
  border-color: var(--brand-accent);
  /* Fallback first: color-mix() is Chrome/Edge 111+, Firefox 113+, Safari 16.2+.
     Older engines keep the flat green tint instead of losing it silently. */
  background-color: rgba(31, 157, 62, 0.12);
  background-color: color-mix(in srgb, var(--brand-accent) 12%, transparent);
}

.footer-legal {
  font-size: 0.8rem;
  /* emphasis-700, not -600: on the white light-mode surface -600 measures
     3.06:1, below WCAG AA's 4.5:1 for this 0.8rem text. -700 gives 5.72:1. */
  color: var(--ifm-color-emphasis-700);
  font-family: var(--ifm-font-family-monospace);
  text-decoration: none;
  transition: color 0.15s;
}
.footer-legal:hover,
.footer-legal:focus-visible {
  color: var(--brand-accent);
  text-decoration: none;
}

.footer-brand:focus-visible,
.footer-social:focus-visible,
.footer-legal:focus-visible {
  outline: 2px solid var(--brand-accent);
  outline-offset: 2px;
}

/* ─── Footer responsive (mobile) ────────────────────────────────────────── */

@media (max-width: 768px) {
  /* The footer top row is flex, not a grid — stack it. grid-template-columns
     here was a no-op left over from the five-column footer, so the row never
     actually stacked on mobile. */
  .footer-top-grid {
    flex-direction: column !important;
    align-items: flex-start !important;
    padding: 1.5rem 1.5rem 1rem !important;
    gap: 1rem !important;
  }

  .footer-socials {
    margin-left: 0;
  }

  .footer-bottom-bar {
    flex-direction: column !important;
    align-items: flex-start !important;
    padding: 1.25rem 1.5rem !important;
    gap: 1rem !important;
  }

  .footer-bottom-bar > div {
    flex-direction: column !important;
    align-items: flex-start !important;
    gap: 0.6rem !important;
  }
}

/* ===================================================================
   Boxy + terminal-ish UI (palette-agnostic: uses vars / 0 only)
   =================================================================== */
:root,
[data-theme='dark'] {
  --ifm-global-radius: 0px;
  --ifm-button-border-radius: 0px;
  --ifm-card-border-radius: 0px;
  --ifm-code-border-radius: 0px;
  --ifm-alert-border-radius: 0px;
}

/* Square the common components (covers hardcoded radii too) */
.button,
.card,
.alert,
.navbar__search-input,
.dropdown__menu,
.pagination-nav__link,
.tabs__item,
.theme-code-block,
.breadcrumbs__link {
  border-radius: 0 !important;
}

/* --- Sidebar: terminal menu (boxed, [+/-] sections) --- */
/* dark mode uses a lighter shade of the brand green */
:root { --brand-accent: var(--ifm-color-primary); }
[data-theme='dark'] { --brand-accent: var(--ifm-color-primary-light); }

/* drop the full-height divider line */
.theme-doc-sidebar-container {
  border-right: none !important;
}
.menu {
  font-family: var(--ifm-font-family-monospace);
  font-size: 0.86rem;
  border: none;
  padding: 0;
  --ifm-menu-color-background-hover: transparent;
  --ifm-menu-color-background-active: transparent;
}
/* the box hugs the items (content height), with more margin OUTSIDE + padding INSIDE */
.menu > .menu__list {
  border: 1px solid var(--ifm-toc-border-color);
  border-radius: 0;
  margin: 1rem 0.75rem;
  padding: 0;
  height: fit-content;
  overflow: hidden;
}
/* bigger spacing between items */
.menu__list .menu__list-item {
  margin: 0;
}
/* leaf items are their own bordered boxes */
.menu__link:not(.menu__link--sublist) {
  border: none;
  transition: background-color .12s ease, color .12s ease;
}
/* category headers get their own border box, matching the leaf .menu__link */
.menu__list-item-collapsible {
  border: 1px solid var(--ifm-toc-border-color);
  border-radius: 0;
  margin: -1px -1px 0 -1px;
  transition: border-color .12s ease, background-color .12s ease, color .12s ease;
}
/* last top-level option overlaps the outer box bottom border */
.menu > .menu__list > .menu__list-item:last-child > .menu__link,
.menu > .menu__list > .menu__list-item:last-child > .menu__list-item-collapsible {
  margin-bottom: -1px;
}
/* selected / hovered / expanded option border paints on top of neighbours */
.menu__link:hover,
.menu__link--active,
.menu__list-item:not(.menu__list-item--collapsed) > .menu__list-item-collapsible {
  position: relative;
  z-index: 1;
}
.menu__list-item-collapsible:hover {
  background-color: transparent;
}
/* bigger padding inside each item */
.menu__link {
  padding: 0.77rem 0.9rem;
}
.menu__link:hover {
  border-color: var(--brand-accent);
  background-color: color-mix(in srgb, var(--brand-accent) 8%, transparent);
}

/* ---- Collapsible SECTION header: [Name] ......... [+/-] ---- */
.menu__list-item-collapsible {
  position: relative;
}
.menu__list-item-collapsible > .menu__link--sublist {
  border: none;
  border-radius: 0;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  font-size: 0.8rem;
}
/* kill the default chevron; draw a monospace + / - at the right edge */
.menu__caret { display: none !important; }
.menu__link--sublist-caret::after,
.menu__link--sublist::after {
  content: "+";
  background: none !important;
  -webkit-mask: none !important;
  mask: none !important;
  width: auto;
  height: auto;
  min-width: 0;
  transform: none !important;
  margin-left: auto;
  align-self: stretch;
  margin-top: -0.7rem;
  margin-bottom: -0.7rem;
  display: flex;
  align-items: center;
  border-left: 1px solid var(--ifm-toc-border-color);
  padding-left: 0.85rem;
  font-family: var(--ifm-font-family-monospace);
  font-weight: 700;
  font-size: 1.7rem;
  line-height: 1;
  color: var(--brand-accent);
}
/* expanded (NOT collapsed) => solid green fill + white text + "-" */
.menu__list-item:not(.menu__list-item--collapsed) > .menu__list-item-collapsible {
  background-color: var(--brand-accent);
  border-color: var(--brand-accent);
}
.menu__list-item:not(.menu__list-item--collapsed) > .menu__list-item-collapsible > .menu__link--sublist {
  color: #fff;
}
.menu__list-item:not(.menu__list-item--collapsed) > .menu__list-item-collapsible > .menu__link--sublist::after {
  content: "\2212";
  color: #fff;
  border-left-color: rgba(255, 255, 255, 0.5);
}

/* ---- Leaf (page) item: selected = transparent bg + solid square marker ---- */
.menu__link--active:not(.menu__link--sublist) {
  color: var(--brand-accent);
  border-color: var(--brand-accent);
  background-color: transparent;
}
.menu__link--active:not(.menu__link--sublist)::before {
  content: "\25AA"; /* ▪ solid square */
  color: var(--brand-accent);
  font-size: 0.95em;
  margin-right: 0.5rem;
}

/* --- Table of contents (right): terminal-ish --- */
.table-of-contents {
  font-family: var(--ifm-font-family-monospace);
  font-size: 0.8rem;
}
.table-of-contents__link--active {
  color: var(--ifm-color-primary);
  font-weight: 700;
}

/* --- Navbar links + custom buttons: monospace (kept square above) --- */
.navbar__link,
.breadcrumbs__link {
  font-family: var(--ifm-font-family-monospace);
}