components.css

/* ====================================================================
   COMPONENTS.CSS — Material Design 3 Component Styles
   Liquid Galaxy Docs · References tokens from tokens.css
   ==================================================================== */


/* ─────────────────────────────────────────────────────────────────────
   RESET
   ───────────────────────────────────────────────────────────────────── */
*, *::before, *::after {
  box-sizing: border-box;
}

body {
  margin: 0;
  font-family: var(--md-sys-typescale-font-family-plain);
  font-size:   var(--md-sys-typescale-body-large-size);
  line-height: 1.65;
  font-weight: var(--md-sys-typescale-body-large-weight);
  background:  var(--md-sys-color-background);
  color:       var(--md-sys-color-on-background);
}

a {
  color: var(--md-sys-color-primary);
  text-decoration: none;
}
a:hover {
  text-decoration: underline;
}
a:focus-visible {
  outline: 2px solid var(--md-sys-color-primary);
  outline-offset: 2px;
  border-radius: var(--md-sys-shape-corner-extra-small);
}


/* ─────────────────────────────────────────────────────────────────────
   HEADER / TOP APP BAR
   ───────────────────────────────────────────────────────────────────── */
/* Floating glass toolbar; content scrolls beneath it */
.app-bar {
  position: fixed;
  top: 0;
  left: 0;
  right: 0;
  z-index: 200;
  height: var(--topbar-h);
  display: flex;
  align-items: center;
  gap: var(--space-3);
  padding: 0 var(--space-5);
  background: color-mix(in srgb, var(--md-sys-color-surface) 70%, transparent);
  backdrop-filter: blur(20px) saturate(180%);
  -webkit-backdrop-filter: blur(20px) saturate(180%);
  border-bottom: none;
  box-shadow: none;
  transition:
    box-shadow var(--md-sys-motion-duration-short-4) var(--md-sys-motion-easing-standard),
    background var(--md-sys-motion-duration-short-4) var(--md-sys-motion-easing-standard);
  flex-shrink: 0;
}

/* Hairline appears only once content passes underneath */
.app-bar.scrolled {
  background: color-mix(in srgb, var(--md-sys-color-surface) 82%, transparent);
  box-shadow:
    0 1px 0 color-mix(in srgb, var(--md-sys-color-outline-variant) 55%, transparent),
    0 8px 24px -16px rgba(0, 0, 0, 0.35);
}

@media (prefers-reduced-transparency: reduce) {
  .app-bar {
    backdrop-filter: none;
    -webkit-backdrop-filter: none;
    background: var(--md-sys-color-surface);
  }
}

/* Brand */
.brand {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  min-width: 200px;
  text-decoration: none;
}

.brand-logo {
  width: 70px;
  height: 36px;
  border-radius: var(--md-sys-shape-corner-small);
  /* background: var(--md-sys-color-primary); */
  display: flex;
  align-items: center;
  justify-content: center;
  overflow: hidden;
  flex-shrink: 0;
  transition: background var(--md-sys-motion-duration-short-4) var(--md-sys-motion-easing-standard);
}
.brand-logo img {
  width: 64px;
  height: 28px;
  object-fit: contain;
}
.brand-logo .brand-abbr {
  color: var(--md-sys-color-on-primary);
  font-size: 15px;
  font-weight: 700;
  font-family: var(--md-sys-typescale-font-family-brand);
  letter-spacing: -0.5px;
}

/* Wordmark — same typeface as the hero; weight carries the hierarchy */
.brand h1 {
  margin: 0;
  font-family: var(--md-sys-typescale-font-family-brand);
  font-size: clamp(1.15rem, 2vw, 1.45rem);
  font-weight: 600;
  line-height: 1.1;
  letter-spacing: -0.015em;
  color: var(--md-sys-color-on-surface);
  white-space: nowrap;
  font-optical-sizing: auto;
}

/* 700 is the heaviest Inter cut loaded (see the font link in index.html) */
.brand h1 span {
  color: var(--md-sys-color-primary);
  font-weight: 700;
}

a.brand:hover h1 {
  text-decoration: none;
}

a.brand:active {
  transform: scale(0.98);
  transition: transform 0.08s ease-out;
}

/* Search (MDN Style) */
.search-container {
  flex: 1;
  max-width: 600px;
  margin: 0 var(--space-4);
  display: flex;
  justify-content: center;
}

.mdn-search-field {
  width: 100%;
  border-radius: 8px; /* For the custom outline focus ring below */
  
  /* MDN-style 8px rounded corners instead of top-rounded Material field */
  --md-filled-text-field-container-shape: 8px;
  
  /* Filled background */
  --md-filled-text-field-container-color: var(--md-sys-color-surface-container-high);
  
  /* Hide the Material bottom line (active indicator) entirely */
  --md-filled-text-field-active-indicator-color: transparent;
  --md-filled-text-field-focus-active-indicator-color: transparent;
  --md-filled-text-field-hover-active-indicator-color: transparent;
  --md-filled-text-field-active-indicator-height: 0px;
  --md-filled-text-field-focus-active-indicator-height: 0px;
  --md-filled-text-field-hover-active-indicator-height: 0px;
  
  /* Text and Icon Colors */
  --md-filled-text-field-input-text-color: var(--md-sys-color-on-surface);
  --md-filled-text-field-input-text-placeholder-color: var(--md-sys-color-on-surface-variant);
  --md-filled-text-field-icon-color: var(--md-sys-color-on-surface-variant);
  
  /* Custom outline transition to mimic MDN search */
  outline: 1px solid transparent;
  transition: background-color 0.2s, outline-color 0.2s, box-shadow 0.2s;
}

.mdn-search-field:hover {
  --md-filled-text-field-container-color: var(--md-sys-color-surface-container-highest);
}

.mdn-search-field:focus-within {
  --md-filled-text-field-container-color: var(--md-sys-color-surface);
  outline: 2px solid var(--md-sys-color-primary);
  outline-offset: 2px; /* Moved outside to preserve breathing room */
  box-shadow: none;
}

.search-shortcut {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  min-width: 24px;
  height: 24px;
  border-radius: 4px;
  background-color: var(--md-sys-color-surface-container);
  border: 1px solid var(--md-sys-color-outline-variant);
  color: var(--md-sys-color-on-surface-variant);
  font-size: 12px;
  font-weight: 600;
  user-select: none;
  pointer-events: none;
}

/* Header actions (right side) */
.actions {
  margin-left: auto;
  display: flex;
  gap: var(--space-1);
  align-items: center;
}

/* Theme toggle button */
#theme-toggle {
  --md-icon-button-icon-color: var(--md-sys-color-on-surface-variant);
  --md-icon-button-hover-state-layer-color: var(--md-sys-color-on-surface-variant);
}
/* Hide in iframe mode */
html.iframe-mode #theme-toggle,
.iframe-mode #theme-toggle {
  display: none !important;
}
#theme-toggle:focus-visible {
  outline: 2px solid var(--md-sys-color-primary);
  outline-offset: 2px;
  border-radius: var(--md-sys-shape-corner-full);
}
/* Smooth icon swap — opacity fade prevents layout-flash on sun↔moon toggle */
#theme-toggle .material-icons {
  transition: opacity var(--md-sys-motion-duration-short-3) var(--md-sys-motion-easing-standard);
}

/* Filled buttons (dialog submit, etc.) */
md-filled-button {
  --md-filled-button-container-shape:           var(--md-sys-shape-corner-full);
  --md-filled-button-container-color:           var(--md-sys-color-primary);
  --md-filled-button-label-text-color:          var(--md-sys-color-on-primary);
  --md-filled-button-hover-container-elevation: 2;
  font-weight: 600;
  font-size: var(--md-sys-typescale-label-large-size);
}

/* Menu toggle (hamburger) */
#menu-toggle {
  --md-icon-button-icon-color: var(--md-sys-color-on-surface-variant);
}
#menu-toggle:focus-visible {
  outline: 2px solid var(--md-sys-color-primary);
  outline-offset: 2px;
  border-radius: var(--md-sys-shape-corner-full);
}


/* ─────────────────────────────────────────────────────────────────────
   SIDEBAR / NAVIGATION DRAWER
   ───────────────────────────────────────────────────────────────────── */
/* The nav owns the scroll, not the drawer, so the footer stays pinned */
.drawer {
  width: var(--sidebar-w);
  height: calc(100dvh - var(--topbar-h, 72px));
  max-height: calc(100dvh - var(--topbar-h, 72px));
  position: sticky;
  top: var(--topbar-h, 72px);
  flex-shrink: 0;
  display: flex;
  flex-direction: column;
  background: var(--md-sys-color-surface-container-low);
  /* No right-side divider line — tonal surface differentiation only */
  border-right: none;
  overflow: hidden;
  transition:
    transform   var(--md-sys-motion-duration-medium-2) var(--md-sys-motion-easing-emphasized),
    width       var(--md-sys-motion-duration-medium-2) var(--md-sys-motion-easing-emphasized),
    box-shadow  var(--md-sys-motion-duration-short-4) var(--md-sys-motion-easing-standard);
  will-change: transform;
}

.drawer nav {
  flex: 1 1 auto;
  min-height: 0; /* flex children refuse to shrink without this */
  overflow-y: auto;
  overflow-x: hidden;
  scrollbar-width: thin;
  scrollbar-color: var(--md-sys-color-outline-variant) transparent;
}

.drawer-footer {
  flex-shrink: 0;
  padding: var(--space-2) var(--space-2);
  border-top: 1px solid color-mix(in srgb, var(--md-sys-color-outline-variant) 60%, transparent);
}

.drawer-contribute {
  display: flex;
  align-items: center;
  gap: var(--space-3);
  width: 100%;
  min-height: 48px;
  padding: 10px var(--space-4);
  border: none;
  border-radius: var(--md-sys-shape-corner-small);
  background: transparent;
  color: var(--md-sys-color-on-surface-variant);
  font-family: inherit;
  font-size: var(--md-sys-typescale-body-medium-size);
  font-weight: 500;
  cursor: pointer;
  transition:
    background var(--md-sys-motion-duration-short-3) var(--md-sys-motion-easing-standard),
    color      var(--md-sys-motion-duration-short-3) var(--md-sys-motion-easing-standard),
    transform  var(--md-sys-motion-duration-short-2) var(--md-sys-motion-easing-standard);
}

.drawer-contribute .material-icons {
  font-size: 20px;
  color: var(--md-sys-color-primary);
}

.drawer-contribute:hover {
  background: var(--md-sys-color-surface-container-highest);
  color: var(--md-sys-color-on-surface);
}

.drawer-contribute:active {
  transform: scale(0.97);
  transition-duration: 80ms;
}

.drawer-contribute:focus-visible {
  outline: 2px solid var(--md-sys-color-primary);
  outline-offset: -2px;
}

.drawer-contribute.active {
  background: var(--md-sys-color-secondary-container);
  color: var(--md-sys-color-on-secondary-container);
}

/* Drawer section label — label-small, all-caps, muted */
.drawer-header {
  padding: var(--space-5) var(--space-4) var(--space-2) var(--space-5);
  font-size:      var(--md-sys-typescale-label-small-size);
  font-weight:    var(--md-sys-typescale-label-small-weight);
  line-height:    var(--md-sys-typescale-label-small-line-height);
  letter-spacing: 0.10em;
  text-transform: uppercase;
  color: var(--md-sys-color-on-surface-variant);
  user-select: none;
}

/* Navigation list container */
md-list {
  --md-list-container-color: transparent;
  padding: 0 var(--space-2) var(--space-4);
}

/* Individual nav items */
md-list-item {
  --md-list-item-label-text-color:          var(--md-sys-color-on-surface-variant);
  --md-list-item-label-text-weight:         var(--md-sys-typescale-body-medium-weight);
  --md-list-item-label-text-size:           var(--md-sys-typescale-body-medium-size);
  --md-list-item-container-shape:           var(--md-sys-shape-corner-small);
  /* M3 minimum 48px touch target */
  --md-list-item-one-line-container-height: 48px;
  --md-list-item-container-color:           transparent;
  border-radius: var(--md-sys-shape-corner-small);
  /* 16px horizontal padding per M3 nav-drawer spec */
  padding-left:  var(--space-4);
  padding-right: var(--space-4);
  /* Slightly increased gap between items for breath */
  margin-bottom: 4px;
  position: relative;
  transition:
    background var(--md-sys-motion-duration-short-3) var(--md-sys-motion-easing-standard);
}

/* Hover — subtle surface shift, no border */
md-list-item:hover {
  --md-list-item-container-color: var(--md-sys-color-surface-container-highest);
  --md-list-item-label-text-color: var(--md-sys-color-on-surface);
}

md-list-item:active {
  transform: scale(0.985);
  transition: transform 80ms var(--md-sys-motion-easing-standard);
}

/* Active (current page) — full-width rounded fill, no left accent bar */
md-list-item.active {
  --md-list-item-container-color: color-mix(in srgb, var(--md-sys-color-primary-container) 55%, var(--md-sys-color-surface-container-low));
  --md-list-item-label-text-color: var(--md-sys-color-on-surface);
  --md-list-item-label-text-weight: 600;
}

/* NO left-accent bar pseudo-element (removed per spec) */

/* Focus ring on list items */
md-list-item:focus-visible {
  outline: 2px solid var(--md-sys-color-primary);
  outline-offset: -2px;
  border-radius: var(--md-sys-shape-corner-small);
}

/* Mobile: drawer becomes overlay */
.drawer-scrim {
  display: none;
  position: fixed;
  inset: 0;
  background: var(--md-sys-color-scrim);
  opacity: 0;
  z-index: 150;
  transition: opacity var(--md-sys-motion-duration-medium-2) var(--md-sys-motion-easing-standard);
}
.drawer-scrim.visible {
  display: block;
  opacity: 0.4;
}


/* ─────────────────────────────────────────────────────────────────────
   MARKDOWN / ARTICLE CONTENT
   ───────────────────────────────────────────────────────────────────── */
/* ── CUSTOM SVG LOADER ANIMATION ── */
:root {
  --p: 0.10;
  --eps: 0.06;
}

/* Zero out article padding & force 100% width & height centering when loader is present */
.content-wrapper:has(.custom-loader-wrapper) {
  max-width: 100% !important;
  width: 100% !important;
  margin: 0 auto !important;
  justify-content: center !important;
  min-height: calc(100dvh - var(--topbar-h, 72px)) !important;
}

.markdown-body:has(.custom-loader-wrapper) {
  padding-top: 0 !important;
  padding-bottom: 0 !important;
  margin: 0 auto !important;
  max-width: 100% !important;
  width: 100% !important;
  min-height: calc(100dvh - var(--topbar-h, 72px)) !important;
  display: flex !important;
  flex-direction: column !important;
  justify-content: center !important;
  align-items: center !important;
}

.custom-loader-wrapper {
  display: flex;
  flex-direction: column;
  align-items: center;
  justify-content: center;
  min-height: calc(100dvh - var(--topbar-h, 72px));
  width: 100%;
  margin: 0 auto;
  padding: 0;
  box-sizing: border-box;
}

html.iframe-mode .custom-loader-wrapper,
.iframe-mode .custom-loader-wrapper {
  min-height: calc(100dvh - var(--topbar-h, 72px)) !important;
}

.visually-hidden {
  clip-path: inset(50%);
  height: 1px;
  width: 1px;
  overflow: hidden;
  position: absolute;
  white-space: nowrap;
}

.custom-loader-section {
  display: inline-block;
  animation: loader-rotation 1.5s ease-in-out infinite;
}

.custom-loader-section svg {
  display: block;
  position: relative;
  width: 120px;
  height: 120px;
}

.custom-loader-section path.loader {
  stroke: var(--md-sys-color-primary, #8fa5d4);
  stroke-dasharray: 1;
  stroke-dashoffset: calc(1 - var(--p));
  transition: stroke-dashoffset 2s linear;
}

.custom-loader-section path.circle {
  stroke: var(--md-sys-color-outline-variant, #353A49);
  display: block;
  stroke-dasharray: 1;
  stroke-dashoffset: calc(var(--p) + var(--eps));
  rotate: 160deg;
  scale: 1 -1;
  transform-origin: 50% 50%;
  transition: stroke-dashoffset 2s linear;
}

@keyframes loader-rotation {
  to {
    rotate: 360deg;
  }
}

.markdown-body {
  color: var(--md-sys-color-on-surface);
  font-size:   var(--md-sys-typescale-body-large-size);
  /* Target line-height 1.65 for comfortable reading rhythm */
  line-height: 1.65;
  font-family: var(--md-sys-typescale-font-family-plain);
}

/* Page Title (dynamically injected at top) */
.dynamic-title {
  font-size: clamp(2rem, 3.5vw, 3rem);
  font-weight: 700;
  letter-spacing: -0.02em;
  line-height: 1.12;
  text-wrap: balance;
  color: var(--md-sys-color-on-surface);
  padding: var(--space-4) 0 0;
  margin-bottom: var(--space-2);
}

.doc-byline {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  color: var(--md-sys-color-on-surface-variant);
  font-size: 0.9rem;
  font-weight: 500;
  letter-spacing: 0.01em;
  padding-bottom: var(--space-4);
  margin-bottom: var(--space-8);
  border-bottom: 1px solid color-mix(in srgb, var(--md-sys-color-outline-variant) 60%, transparent);
}

.doc-byline .material-icons {
  font-size: 18px;
  color: var(--md-sys-color-primary);
}

/* H1 — display-small, ~24px top space, 16px below before first paragraph */
.markdown-body h1 {
  font-size:      var(--md-sys-typescale-display-small-size);
  line-height:    var(--md-sys-typescale-display-small-line-height);
  font-weight:    600;
  letter-spacing: -0.5px;
  color:          var(--md-sys-color-on-surface);
  margin:         var(--space-6) 0 var(--space-4);
  padding:        0;
  /* No border-bottom — spacing leads separation, not a line */
  border:         none;
}

/* Anchors must clear the fixed app bar */
.markdown-body h1,
.markdown-body h2,
.markdown-body h3,
.markdown-body h4 {
  scroll-margin-top: calc(var(--topbar-h) + var(--space-6));
}

/* H2 — headline-small, ~32px above, spacing-led section separation */
.markdown-body h2 {
  font-size:      var(--md-sys-typescale-headline-small-size);
  line-height:    var(--md-sys-typescale-headline-small-line-height);
  font-weight:    600;
  letter-spacing: var(--md-sys-typescale-headline-small-tracking);
  color:          var(--md-sys-color-on-surface);
  margin-top:     var(--space-10);
  margin-bottom:  var(--space-4);
  padding:        0;
  /* Very faint hairline at low opacity — barely visible tonal separation */
  border-bottom:  1px solid color-mix(in srgb, var(--md-sys-color-outline-variant) 40%, transparent);
  padding-bottom: var(--space-3);
}

/* H3 — title-large, single-blue accent only (never use lg-accent-* here) */
.markdown-body h3 {
  font-size:      var(--md-sys-typescale-title-large-size);
  line-height:    var(--md-sys-typescale-title-large-line-height);
  font-weight:    600;
  letter-spacing: 0;
  color:          var(--md-sys-color-primary);
  margin-top:     var(--space-8);
  margin-bottom:  var(--space-2);
}

/* H4 */
.markdown-body h4 {
  font-size:     var(--md-sys-typescale-title-medium-size);
  line-height:   var(--md-sys-typescale-title-medium-line-height);
  font-weight:   var(--md-sys-typescale-title-medium-weight);
  color:         var(--md-sys-color-on-surface);
  margin-top:    var(--space-6);
  margin-bottom: var(--space-1);
}

/* Paragraphs */
.markdown-body p {
  margin: 0 0 var(--space-6);
  letter-spacing: var(--md-sys-typescale-body-large-tracking);
}

/* Lists */
.markdown-body ul,
.markdown-body ol {
  margin: 0 0 var(--space-4);
  padding-left: var(--space-6);
}
.markdown-body li {
  margin-bottom: var(--space-1);
  letter-spacing: var(--md-sys-typescale-body-large-tracking);
}
.markdown-body li + li {
  margin-top: var(--space-1);
}

/* Inline code */
.markdown-body code {
  font-family: var(--md-sys-typescale-font-family-mono);
  font-size: 0.875em;
  background: var(--md-sys-color-surface-container-high);
  color: var(--md-sys-color-primary);
  border: 1px solid var(--md-sys-color-outline-variant);
  border-radius: var(--md-sys-shape-corner-extra-small);
  padding: 2px 6px;
}

/* Code blocks (Always dark to support vs2015 syntax theme) */
.markdown-body pre {
  background-color: #2f3232;
  border: none;
  border-radius: 10px; /* Matched to visualdark preference */
  padding: var(--space-5);
  overflow-x: auto;
  margin: var(--space-4) 0 var(--space-6);
  position: relative;
}
.markdown-body pre code {
  background: none;
  border: none;
  padding: 0;
  color: #e2e2e2;
  font-size: var(--md-sys-typescale-body-medium-size);
  line-height: 1.65;
}

/* Blockquote */
.markdown-body blockquote {
  border-left: 4px solid var(--md-sys-color-primary);
  margin: var(--space-6) 0;
  padding: 10px 14px 10px;
  background: color-mix(in srgb, var(--md-sys-color-primary-container) 50%, transparent);
  border-radius: 0 var(--md-sys-shape-corner-medium) var(--md-sys-shape-corner-medium) 0;
  color: var(--md-sys-color-on-surface-variant);
  font-style: normal;
}

/* ── Legacy "visualdark" overrides for Dark Mode ── */
html[data-theme="dark"] .markdown-body code {
  background-color: #2f3232;
  color: #e2e2e2;
  border: none;
}

/* Tables */
.markdown-body table {
  width: 100%;
  border-collapse: collapse;
  font-size: var(--md-sys-typescale-body-medium-size);
  margin: var(--space-6) 0;
  border-radius: var(--md-sys-shape-corner-small);
  overflow: hidden;
  border: 1px solid var(--md-sys-color-outline-variant);
}
.markdown-body th {
  background: var(--md-sys-color-surface-container);
  font-weight: 600;
  font-size: var(--md-sys-typescale-label-large-size);
  letter-spacing: var(--md-sys-typescale-label-large-tracking);
  padding: var(--space-3) var(--space-4);
  border-bottom: 1px solid var(--md-sys-color-outline-variant);
  text-align: left;
  color: var(--md-sys-color-on-surface);
}
.markdown-body td {
  padding: var(--space-3) var(--space-4);
  border-bottom: 1px solid var(--md-sys-color-outline-variant);
  color: var(--md-sys-color-on-surface);
}
.markdown-body tr:last-child td {
  border-bottom: none;
}
.markdown-body tr:hover td {
  background: color-mix(in srgb, var(--md-sys-color-primary) 4%, transparent);
}

/* Images */
.markdown-body img {
  max-width: 100%;
  border: 1px solid var(--md-sys-color-outline-variant);
  /* border-radius: var(--md-sys-shape-corner-medium); */
  margin: var(--space-4) 0;
  display: block;
}

/* Horizontal rule — very subtle, spacing-led */
.markdown-body hr {
  border: none;
  border-top: 1px solid color-mix(in srgb, var(--md-sys-color-outline-variant) 50%, transparent);
  margin: var(--space-8) 0;
}

/* Strong / emphasis */
.markdown-body strong { color: var(--md-sys-color-on-surface); font-weight: 600; }
.markdown-body em     { font-style: italic; }


/* ─────────────────────────────────────────────────────────────────────
   HOME PAGE (Developer Portal Redesign)
   ───────────────────────────────────────────────────────────────────── */
/* ── Article entrance ── */
@keyframes articleEnter {
  from { opacity: 0; transform: translateY(8px); }
  to   { opacity: 1; transform: none; }
}

.markdown-body.article-enter {
  animation: articleEnter var(--md-sys-motion-duration-medium-1)
             var(--md-sys-motion-easing-standard-decel) backwards;
}

/* ── Theme cross-fade ── */
::view-transition-old(root),
::view-transition-new(root) {
  animation-duration: var(--md-sys-motion-duration-short-3);
  animation-timing-function: var(--md-sys-motion-easing-standard);
}

@media (prefers-reduced-motion: reduce) {
  ::view-transition-old(root),
  ::view-transition-new(root) {
    animation: none;
  }
  .markdown-body.article-enter {
    animation: none;
  }
  .copy-code-btn .material-icons {
    animation: none;
  }
  .mdn-search-content,
  .mdn-search-modal.active .mdn-search-content {
    transform: none;
    transition: none;
  }
}

/* ── Cosmic hero — night sky in dark, day sky in light; nebula uses the Google palette ── */
.home-hero {
  position: relative;
  isolation: isolate;
  overflow: hidden;
  display: flex;
  flex-direction: column;
  align-items: center;
  justify-content: center;
  min-height: clamp(540px, 74vh, 800px);
  padding: calc(var(--topbar-h) + var(--space-6)) var(--space-4) 96px var(--space-4);
  text-align: center;
  background: radial-gradient(120% 90% at 50% -10%, #111a3a 0%, #0a0e20 45%, #05070f 100%);
  color: #e8edf8;
}

/* Glow bleeding up from the stripe */
.home-hero::before {
  content: '';
  position: absolute;
  bottom: 0;
  left: 0;
  right: 0;
  height: 6px;
  background: linear-gradient(
    90deg,
    #4285F4 0% 25%,
    #EA4335 25% 50%,
    #FBBC05 50% 75%,
    #34A853 75% 100%
  );
  filter: blur(14px);
  opacity: 0.55;
}

/* LOCKED BRAND: 4-color Google/LG stripe at the bottom of the hero */
.home-hero::after {
  content: '';
  position: absolute;
  bottom: 0;
  left: 0;
  right: 0;
  height: 4px;
  z-index: 1;
  background: linear-gradient(
    90deg,
    #4285F4 0% 25%,
    #EA4335 25% 50%,
    #FBBC05 50% 75%,
    #34A853 75% 100%
  );
  opacity: 0.9;
}

/* ── Cosmos backdrop layers (decorative, aria-hidden) ── */
.home-hero .cosmos {
  position: absolute;
  inset: 0;
  z-index: -1;
  pointer-events: none;
}

/* Two tiled starfields at different densities */
.cosmos-stars {
  position: absolute;
  inset: 0;
  background-image:
    radial-gradient(1px 1px at 12% 22%, rgba(255,255,255,0.8) 50%, transparent 51%),
    radial-gradient(1.5px 1.5px at 38% 64%, rgba(255,255,255,0.55) 50%, transparent 51%),
    radial-gradient(1px 1px at 56% 12%, rgba(255,255,255,0.7) 50%, transparent 51%),
    radial-gradient(1px 1px at 73% 41%, rgba(255,255,255,0.5) 50%, transparent 51%),
    radial-gradient(1.5px 1.5px at 89% 74%, rgba(255,255,255,0.65) 50%, transparent 51%),
    radial-gradient(1px 1px at 25% 86%, rgba(255,255,255,0.45) 50%, transparent 51%),
    radial-gradient(1px 1px at 64% 92%, rgba(255,255,255,0.6) 50%, transparent 51%);
  background-size: 300px 300px;
}

.cosmos-stars--far {
  background-image:
    radial-gradient(2px 2px at 18% 34%, rgba(190,210,255,0.9) 50%, transparent 51%),
    radial-gradient(1.5px 1.5px at 47% 79%, rgba(255,255,255,0.8) 50%, transparent 51%),
    radial-gradient(2px 2px at 82% 18%, rgba(255,240,210,0.85) 50%, transparent 51%),
    radial-gradient(1.5px 1.5px at 68% 55%, rgba(200,255,220,0.7) 50%, transparent 51%);
  background-size: 520px 520px;
  animation: cosmosTwinkle 7s ease-in-out infinite alternate;
}

@keyframes cosmosTwinkle {
  from { opacity: 0.55; }
  to   { opacity: 1; }
}

/* Blobs sit toward the edges so the centre stays clear for the headline */
.cosmos-nebula {
  position: absolute;
  inset: -10%;
  /* %-sized so the blobs scale with the hero */
  background:
    radial-gradient(34% 48% at 16% 28%, rgba(66,133,244,0.30), transparent 70%),
    radial-gradient(30% 44% at 85% 24%, rgba(234,67,53,0.18), transparent 70%),
    radial-gradient(28% 40% at 74% 80%, rgba(251,188,5,0.14), transparent 70%),
    radial-gradient(32% 46% at 26% 84%, rgba(52,168,83,0.18), transparent 70%);
  filter: blur(48px) saturate(120%);
  will-change: transform;
  animation: nebulaDrift 90s ease-in-out infinite alternate;
}

@keyframes nebulaDrift {
  from { transform: translate3d(-1.5%, -1%, 0) scale(1); }
  to   { transform: translate3d(1.5%, 1%, 0) scale(1.06); }
}

/* Planet horizon arc, rises behind the stripe */
.cosmos-planet {
  position: absolute;
  left: 50%;
  bottom: -482px;
  transform: translateX(-50%);
  width: max(160%, 900px);
  height: 520px;
  border-radius: 50%;
  background: #060912;
  border: 1px solid rgba(154, 190, 255, 0.28);
  box-shadow:
    0 -30px 90px -10px rgba(66, 133, 244, 0.35),
    inset 0 40px 80px -40px rgba(138, 180, 248, 0.45);
}

/* ── Hero content ── */
@keyframes heroRise {
  from { opacity: 0; transform: translateY(14px); }
  to   { opacity: 1; transform: translateY(0); }
}

.home-hero .lg-badge        { animation: heroRise 0.55s cubic-bezier(0.2, 0.65, 0.25, 1) 0.05s backwards; }
.home-hero h1               { animation: heroRise 0.55s cubic-bezier(0.2, 0.65, 0.25, 1) 0.12s backwards; }
.home-hero p                { animation: heroRise 0.55s cubic-bezier(0.2, 0.65, 0.25, 1) 0.19s backwards; }
.home-hero .hero-search-container { animation: heroRise 0.55s cubic-bezier(0.2, 0.65, 0.25, 1) 0.26s backwards; }

.hero-search-container {
  width: 100%;
  max-width: 680px;
  margin: var(--space-6) auto 0 auto;
  padding: 0 var(--space-4);
}

/* Glass search bar over the moving sky */
.hero-search-btn {
  display: flex;
  align-items: center;
  width: 100%;
  padding: 18px 22px;
  background: rgba(255, 255, 255, 0.08);
  backdrop-filter: blur(20px) saturate(160%);
  -webkit-backdrop-filter: blur(20px) saturate(160%);
  border: 1px solid rgba(255, 255, 255, 0.16);
  border-top-color: rgba(255, 255, 255, 0.28);
  border-radius: 30px;
  color: rgba(255, 255, 255, 0.85);
  cursor: pointer;
  transition: background 0.16s ease-out, border-color 0.16s ease-out,
              box-shadow 0.16s ease-out, transform 0.16s ease-out;
}

.hero-search-btn:hover,
.hero-search-btn:focus-visible {
  background: rgba(255, 255, 255, 0.12);
  border-color: rgba(255, 255, 255, 0.3);
  transform: translateY(-1px);
  box-shadow:
    0 -4px 28px -6px rgba(66, 133, 244, 0.35),
    -18px 6px 28px -12px rgba(234, 67, 53, 0.28),
    18px 6px 28px -12px rgba(52, 168, 83, 0.28),
    0 10px 28px -10px rgba(251, 188, 5, 0.30);
}

.hero-search-btn:active {
  transform: scale(0.985);
  transition-duration: 0.08s;
}

.hero-search-btn:focus-visible {
  outline: 2px solid #8ab4f8;
  outline-offset: 3px;
}

/* Overrides .markdown-body img, whose border/margin is meant for article images */
.hero-search-btn .search-icon {
  width: 22px;
  height: 22px;
  margin: 0 var(--space-3) 0 0;
  border: none;
  background: none;
  display: inline-block;
  transition: transform 0.25s ease;
}

.hero-search-btn:hover .search-icon {
  transform: scale(1.1);
}

.hero-search-btn .search-placeholder {
  font-size: 1.1rem;
  font-weight: 400;
  flex: 1;
  text-align: left;
  color: rgba(232, 237, 248, 0.72);
  letter-spacing: 0.01em;
}

.hero-search-btn .search-shortcut {
  font-size: 0.85rem;
  font-weight: 600;
  border: 1px solid rgba(255, 255, 255, 0.22);
  border-radius: 6px;
  padding: 2px 8px;
  background: rgba(255, 255, 255, 0.06);
  color: rgba(232, 237, 248, 0.75);
  box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.1);
}

.lg-badge {
  display: inline-flex;
  align-items: center;
  gap: var(--space-2);
  padding: var(--space-1) var(--space-3);
  border-radius: 16px;
  background: rgba(138, 180, 248, 0.1);
  backdrop-filter: blur(12px);
  -webkit-backdrop-filter: blur(12px);
  color: #a8c7fa;
  font-size: 0.85rem;
  font-weight: 600;
  letter-spacing: 0.015em;
  margin-bottom: var(--space-6);
  border: 1px solid rgba(138, 180, 248, 0.28);
  text-decoration: none;
  cursor: pointer;
  transition: background 0.16s ease-out, border-color 0.16s ease-out, transform 0.16s ease-out;
}

.lg-badge:hover {
  background: rgba(138, 180, 248, 0.18);
  border-color: rgba(138, 180, 248, 0.45);
  transform: translateY(-1px);
  text-decoration: none;
}

.lg-badge:active {
  transform: scale(0.97);
  transition-duration: 0.08s;
}

.lg-badge:focus-visible {
  outline: 2px solid #8ab4f8;
  outline-offset: 3px;
}

[data-theme="light"] .lg-badge:hover {
  background: rgba(26, 115, 232, 0.14);
  border-color: rgba(26, 115, 232, 0.45);
}

[data-theme="light"] .lg-badge:focus-visible {
  outline-color: #1a73e8;
}

.home-hero h1 {
  font-size: clamp(2.75rem, 5.5vw, 5.25rem);
  font-weight: 700;
  letter-spacing: -0.025em;
  margin-bottom: var(--space-4);
  line-height: 1.04;
  text-wrap: balance;
  background: linear-gradient(180deg, #ffffff 0%, rgba(255, 255, 255, 0.68) 100%);
  -webkit-background-clip: text;
  background-clip: text;
  -webkit-text-fill-color: transparent;
}

.home-hero p {
  font-size: clamp(1.1rem, 2vw, 1.25rem);
  color: rgba(232, 240, 255, 0.78);
  max-width: 660px;
  margin: 0 auto;
  line-height: 1.6;
  text-wrap: pretty;
}

/* ── Light theme: the same scene by day ── */
[data-theme="light"] .home-hero {
  background: radial-gradient(120% 90% at 50% -10%, #c9dcfb 0%, #e6efff 48%, #f7fafe 100%);
  color: #1b1f27;
}

[data-theme="light"] .cosmos-stars,
[data-theme="light"] .cosmos-stars--far {
  display: none;
}

[data-theme="light"] .cosmos-nebula {
  background:
    radial-gradient(34% 48% at 16% 28%, rgba(66,133,244,0.30), transparent 70%),
    radial-gradient(30% 44% at 85% 24%, rgba(234,67,53,0.20), transparent 70%),
    radial-gradient(28% 40% at 74% 80%, rgba(251,188,5,0.22), transparent 70%),
    radial-gradient(32% 46% at 26% 84%, rgba(52,168,83,0.20), transparent 70%);
}

[data-theme="light"] .cosmos-planet {
  background: #f4f8ff;
  border-color: rgba(66, 133, 244, 0.35);
  box-shadow:
    0 -30px 90px -10px rgba(66, 133, 244, 0.30),
    inset 0 40px 80px -40px rgba(255, 255, 255, 0.9);
}

[data-theme="light"] .home-hero h1 {
  background: linear-gradient(180deg, #1b1f27 0%, rgba(27, 31, 39, 0.72) 100%);
  -webkit-background-clip: text;
  background-clip: text;
}

[data-theme="light"] .home-hero p {
  color: rgba(32, 41, 64, 0.8);
}

[data-theme="light"] .lg-badge {
  background: rgba(26, 115, 232, 0.08);
  color: #1a73e8;
  border-color: rgba(26, 115, 232, 0.28);
}

[data-theme="light"] .hero-search-btn {
  background: rgba(255, 255, 255, 0.55);
  border-color: rgba(13, 25, 50, 0.12);
  border-top-color: rgba(255, 255, 255, 0.95);
  color: #1b1f27;
}

[data-theme="light"] .hero-search-btn:hover,
[data-theme="light"] .hero-search-btn:focus-visible {
  background: rgba(255, 255, 255, 0.75);
  border-color: rgba(13, 25, 50, 0.18);
}

[data-theme="light"] .hero-search-btn:focus-visible {
  outline-color: #1a73e8;
}

[data-theme="light"] .hero-search-btn .search-placeholder {
  color: rgba(32, 41, 64, 0.66);
}

[data-theme="light"] .hero-search-btn .search-shortcut {
  border-color: rgba(13, 25, 50, 0.16);
  background: rgba(255, 255, 255, 0.6);
  color: rgba(32, 41, 64, 0.7);
  box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.8);
}

/* ── Accessibility preferences ── */
@media (prefers-reduced-motion: reduce) {
  .cosmos-nebula,
  .cosmos-stars--far {
    animation: none;
  }
  .home-hero .lg-badge,
  .home-hero h1,
  .home-hero p,
  .home-hero .hero-search-container,
  .recent-doc-item,
  .start-card {
    animation: none;
  }
  .hero-search-btn,
  .hero-search-btn .search-icon,
  .home-doc-grid-wrap,
  .browse-toggle .material-icons,
  .start-card-hint span {
    transition: none;
  }
}

@media (prefers-reduced-transparency: reduce) {
  .hero-search-btn,
  .lg-badge {
    backdrop-filter: none;
    -webkit-backdrop-filter: none;
    background: #10141f;
  }
  [data-theme="light"] .hero-search-btn,
  [data-theme="light"] .lg-badge {
    background: #f4f7fd;
  }
}

@media (prefers-contrast: more) {
  .hero-search-btn {
    background: #0b0e17;
    border-color: rgba(255, 255, 255, 0.6);
  }
  .home-hero p {
    color: #ffffff;
  }
  [data-theme="light"] .hero-search-btn {
    background: #ffffff;
    border-color: rgba(0, 0, 0, 0.65);
  }
  [data-theme="light"] .home-hero p {
    color: #0b0e17;
  }
}

/* Common Section Container */
.home-section {
  padding: var(--space-8) var(--space-4);
  max-width: var(--content-max);
  margin: 0 auto;
}

/* Two classes: must out-rank .markdown-body h2 (0,1,1), which sets a 40px top margin */
.markdown-body .section-title {
  font-size: 1.5rem;
  font-weight: 700;
  margin-top: 0;
  margin-bottom: var(--space-6);
  color: var(--md-sys-color-on-surface);
}

/* Recent Docs */
.recent-docs-grid {
  display: grid;
  gap: var(--space-3);
  grid-template-columns: repeat(auto-fit, minmax(min(280px, 100%), 1fr));
}

.recent-doc-item {
  display: flex;
  align-items: center;
  gap: var(--space-3);
  padding: var(--space-4);
  background: var(--md-sys-color-surface-container-low);
  border: 1px solid var(--md-sys-color-outline-variant);
  border-radius: 14px;
  cursor: pointer;
  transition: background 0.18s ease, border-color 0.18s ease,
              transform 0.18s ease, box-shadow 0.18s ease;
  color: var(--md-sys-color-on-surface);
  font-weight: 500;
  animation: heroRise 0.5s cubic-bezier(0.2, 0.65, 0.25, 1) backwards;
}

.recent-doc-item:nth-child(1) { animation-delay: 0.32s; }
.recent-doc-item:nth-child(2) { animation-delay: 0.38s; }
.recent-doc-item:nth-child(3) { animation-delay: 0.44s; }
.recent-doc-item:nth-child(4) { animation-delay: 0.50s; }
.recent-doc-item:nth-child(5) { animation-delay: 0.56s; }

@media (hover: hover) and (pointer: fine) {
  .recent-doc-item:hover {
    background: var(--md-sys-color-surface-container-high);
    border-color: var(--md-sys-color-primary);
    transform: translateY(-2px);
    box-shadow: 0 8px 24px -12px color-mix(in srgb, var(--md-sys-color-primary) 40%, transparent);
  }
}

.recent-doc-item:focus {
  background: var(--md-sys-color-surface-container-high);
  border-color: var(--md-sys-color-primary);
  outline: none;
}

.recent-doc-item:active {
  transform: translateY(0) scale(0.985);
  transition-duration: 0.06s;
}

.recent-doc-item .material-icons {
  color: var(--md-sys-color-primary);
  opacity: 0.85;
}
.recent-doc-item:nth-child(4n+1) .material-icons { color: #4285F4; }
.recent-doc-item:nth-child(4n+2) .material-icons { color: #EA4335; }
.recent-doc-item:nth-child(4n+3) .material-icons { color: #FBBC05; }
.recent-doc-item:nth-child(4n+4) .material-icons { color: #34A853; }

/* ── Start here cards ── */
/* min() so a track never demands more width than the container has */
.start-grid {
  display: grid;
  gap: var(--space-4);
  grid-template-columns: repeat(auto-fit, minmax(min(240px, 100%), 1fr));
}

.start-card {
  display: flex;
  flex-direction: column;
  gap: var(--space-2);
  padding: var(--space-5);
  background: var(--md-sys-color-surface-container-low);
  border: 1px solid var(--md-sys-color-outline-variant);
  border-radius: 16px;
  cursor: pointer;
  transition: background 0.18s ease, border-color 0.18s ease,
              transform 0.18s ease, box-shadow 0.18s ease;
  animation: heroRise 0.5s cubic-bezier(0.2, 0.65, 0.25, 1) backwards;
}

.start-card:nth-child(1) { border-top: 3px solid #4285F4; animation-delay: 0.30s; }
.start-card:nth-child(2) { border-top: 3px solid #EA4335; animation-delay: 0.36s; }
.start-card:nth-child(3) { border-top: 3px solid #FBBC05; animation-delay: 0.42s; }

/* Pointer-only: on touch, :hover sticks after tap */
@media (hover: hover) and (pointer: fine) {
  .start-card:hover {
    background: var(--md-sys-color-surface-container-high);
    border-color: var(--md-sys-color-primary);
    transform: translateY(-2px);
    box-shadow: 0 8px 24px -12px color-mix(in srgb, var(--md-sys-color-primary) 40%, transparent);
  }
}

.start-card:focus-visible {
  background: var(--md-sys-color-surface-container-high);
  border-color: var(--md-sys-color-primary);
  outline: none;
}

.start-card:active {
  transform: translateY(0) scale(0.985);
  transition-duration: 0.06s;
}

.start-card-num {
  font-family: var(--md-sys-typescale-font-family-mono);
  font-size: 0.8rem;
  letter-spacing: 0.06em;
  color: var(--md-sys-color-on-surface-variant);
}

.start-card-title {
  font-size: 1.05rem;
  font-weight: 600;
  color: var(--md-sys-color-on-surface);
  line-height: 1.3;
}

.start-card-hint {
  margin-top: auto;
  font-size: 0.88rem;
  font-weight: 500;
  color: var(--md-sys-color-primary);
}

.start-card-hint span {
  display: inline-block;
  transition: transform 0.18s ease;
}
.start-card:hover .start-card-hint span {
  transform: translateX(3px);
}

/* ── Browse all guides ── */
/* Rule lives on the header, not the h2, so it spans the full column in a flex row */
.browse-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--space-4);
  flex-wrap: wrap;
  border-bottom: 1px solid color-mix(in srgb, var(--md-sys-color-outline-variant) 40%, transparent);
  padding-bottom: var(--space-3);
  margin-bottom: var(--space-4);
}

.markdown-body .browse-header .section-title {
  margin: 0;
  padding-bottom: 0;
  border-bottom: none;
  line-height: 1.2;
}

.browse-toggle {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  padding: 10px 18px;
  border-radius: 100px;
  background: transparent;
  border: 1px solid var(--md-sys-color-outline);
  color: var(--md-sys-color-on-surface);
  font-family: inherit;
  font-size: 0.95rem;
  font-weight: 500;
  cursor: pointer;
  transition: background 0.16s ease-out, border-color 0.16s ease-out, transform 0.16s ease-out;
}

.browse-toggle:hover {
  background: var(--md-sys-color-surface-container-high);
  border-color: var(--md-sys-color-on-surface);
}

.browse-toggle:active {
  transform: scale(0.96);
  transition-duration: 0.08s;
}

.browse-toggle:focus-visible {
  outline: 2px solid var(--md-sys-color-primary);
  outline-offset: 2px;
}

.browse-toggle .material-icons {
  font-size: 20px;
  transition: transform 0.3s cubic-bezier(0.2, 0.65, 0.25, 1);
}

.browse-toggle.expanded .material-icons {
  transform: rotate(180deg);
}

/* grid-template-rows keeps expand/collapse symmetric and interruptible */
.home-doc-grid-wrap {
  display: grid;
  grid-template-rows: 0fr;
  transition: grid-template-rows 0.35s cubic-bezier(0.2, 0.65, 0.25, 1);
}

.home-doc-grid-wrap.open {
  grid-template-rows: 1fr;
}

.home-doc-grid {
  overflow: hidden;
  min-height: 0;
  visibility: hidden;
  transition: visibility 0s 0.35s;
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(min(220px, 100%), 1fr));
  /* Both needed: a min-height item would otherwise pin the row and overlap the next */
  grid-auto-rows: min-content;
  align-items: start;
  gap: var(--space-2);
  /* No margin or padding: either leaks height while the row is collapsed */
}

.home-doc-grid-wrap.open .home-doc-grid {
  visibility: visible;
  transition: visibility 0s;
  overflow-y: auto;
  max-height: min(60vh, 440px);
  -webkit-overflow-scrolling: touch;
  overscroll-behavior: contain; /* don't scroll-chain the page at the ends */
}

.home-doc-item {
  display: flex;
  align-items: center;
  min-height: 44px;
  padding: 10px 14px;
  border-radius: 10px;
  border: 1px solid transparent;
  cursor: pointer;
  color: var(--md-sys-color-on-surface-variant);
  font-size: 0.95rem;
  line-height: 1.35;
  overflow-wrap: anywhere;
  transition: background 0.15s ease, color 0.15s ease;
}

.home-doc-item:hover,
.home-doc-item:focus-visible {
  background: var(--md-sys-color-surface-container-high);
  color: var(--md-sys-color-on-surface);
  outline: none;
}

.home-doc-item:active {
  transform: scale(0.98);
}

/* ── Homepage footer ── */
.home-footer {
  margin-top: var(--space-8);
  padding-top: var(--space-6);
  padding-bottom: var(--space-10);
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--space-4);
  flex-wrap: wrap;
  border-top: 1px solid color-mix(in srgb, var(--md-sys-color-outline-variant) 60%, transparent);
}

.home-footer p {
  margin: 0;
  font-size: 0.85rem;
  color: var(--md-sys-color-on-surface-variant);
}

.home-footer-links {
  display: flex;
  align-items: center;
  gap: var(--space-5);
  flex-wrap: wrap;
}

.home-footer-links a {
  font-size: 0.9rem;
  font-weight: 500;
  color: var(--md-sys-color-on-surface-variant);
}

.home-footer-links a:hover {
  color: var(--md-sys-color-on-surface);
}

/* LOCKED BRAND: GO Store globe */
.go-store-link {
  display: inline-flex;
  align-items: center;
  gap: 8px;
}

.go-store-link svg {
  height: 20px;
  width: auto;
  transition: transform 0.25s cubic-bezier(0.2, 0.65, 0.25, 1);
}

/* The mark is drawn for dark backgrounds; give it an edge rather than recolouring it */
[data-theme="light"] .go-store-link svg {
  filter:
    drop-shadow(0 0 0.5px rgba(13, 25, 50, 0.55))
    drop-shadow(0 1px 2px rgba(13, 25, 50, 0.22));
}

.go-store-link:hover svg {
  transform: rotate(-8deg) scale(1.08);
}

/* Features Grid */
.features-grid {
  display: grid;
  gap: var(--space-4);
  grid-template-columns: repeat(4, 1fr);
}

.feature-card {
  padding: var(--space-4);
  background: var(--md-sys-color-surface-container-lowest);
  border: 1px solid var(--md-sys-color-outline-variant);
  border-radius: 12px;
  display: flex;
  flex-direction: column;
  align-items: center;
  text-align: center;
  transition: transform 0.2s ease;
}

/* Restored Google/LG colored borders for the feature cards */
.feature-card:nth-child(1) { border-top: 3px solid color-mix(in srgb, #4285F4 80%, transparent); }
.feature-card:nth-child(2) { border-top: 3px solid color-mix(in srgb, #EA4335 80%, transparent); }
.feature-card:nth-child(3) { border-top: 3px solid color-mix(in srgb, #FBBC05 80%, transparent); }
.feature-card:nth-child(4) { border-top: 3px solid color-mix(in srgb, #34A853 80%, transparent); }

.feature-card:hover {
  transform: translateY(-4px);
  box-shadow: 0 4px 12px rgba(0,0,0,0.2);
}

.feature-card img {
  width: 100%;
  max-width: 80px; /* Made compact as requested */
  height: 80px;
  object-fit: contain;
  margin-bottom: var(--space-3);
  filter: drop-shadow(0 4px 8px rgba(0,0,0,0.15));
  mix-blend-mode: screen; /* Removes dark backgrounds from images */
}

.feature-card h3 {
  font-size: 1.1rem;
  font-weight: 600;
  margin-bottom: var(--space-2);
  color: var(--md-sys-color-on-surface);
}

.feature-card p {
  color: var(--md-sys-color-on-surface-variant);
  font-size: 0.9rem;
  line-height: 1.4;
}

/* CTA Section */
.home-cta-section {
  margin: var(--space-4) auto;
  padding: var(--space-8) var(--space-6);
  background: var(--md-sys-color-surface-container-low);
  border: 1px solid var(--md-sys-color-outline-variant);
  border-radius: 12px;
  text-align: center;
  max-width: 800px;
}

.home-cta-section h2 {
  font-size: 2rem;
  font-weight: 700;
  margin-bottom: var(--space-4);
  color: var(--md-sys-color-on-surface);
}

.home-cta-section p {
  font-size: 1.1rem;
  color: var(--md-sys-color-on-surface-variant);
  margin-bottom: var(--space-8);
}

.home-cta-buttons {
  display: flex;
  gap: var(--space-4);
  justify-content: center;
  flex-wrap: wrap;
}

.cta-primary, .cta-secondary {
  display: inline-flex;
  align-items: center;
  gap: var(--space-2);
  padding: 12px 24px;
  border-radius: 100px;
  font-weight: 600;
  font-size: 1rem;
  cursor: pointer;
  text-decoration: none;
  transition: all 0.2s ease;
  font-family: inherit;
  border: none;
}
/* ─────────────────────────────────────────────────────────────────────
   MDN-STYLE SEARCH MODAL
   ───────────────────────────────────────────────────────────────────── */
/* Always laid out so it can animate OUT as well as in; hidden via
   opacity/visibility rather than display (display can't transition). */
.mdn-search-modal {
  display: flex;
  opacity: 0;
  visibility: hidden;
  pointer-events: none;
  transition:
    opacity var(--md-sys-motion-duration-short-3) var(--md-sys-motion-easing-emphasized-accel),
    visibility 0s linear var(--md-sys-motion-duration-short-3);
  position: fixed;
  top: 0; left: 0; right: 0; bottom: 0;
  background: rgba(0, 0, 0, 0.4);
  z-index: 9999;
  backdrop-filter: blur(8px);
  -webkit-backdrop-filter: blur(8px);
  align-items: flex-start;
  justify-content: center;
  padding-top: 10vh;
}

.mdn-search-modal.active {
  opacity: 1;
  visibility: visible;
  pointer-events: auto;
  transition:
    opacity var(--md-sys-motion-duration-short-4) var(--md-sys-motion-easing-emphasized-decel),
    visibility 0s linear 0s;
}

/* The panel grows from whichever control opened it — transform-origin is set
   at runtime in app.js to the trigger's center (hero bar or header pill). */
.mdn-search-content {
  transform: scale(0.96);
  transition: transform var(--md-sys-motion-duration-short-3)
              var(--md-sys-motion-easing-emphasized-accel);
  will-change: transform;
}

.mdn-search-modal.active .mdn-search-content {
  transform: scale(1);
  transition: transform var(--md-sys-motion-duration-short-4)
              var(--md-sys-motion-easing-emphasized-decel);
}

.mdn-search-content {
  width: 100%;
  max-width: 650px;
  background: var(--md-sys-color-surface-container);
  border: none;
  border-radius: 16px;
  box-shadow: 0 24px 48px rgba(0,0,0,0.5);
  display: flex;
  flex-direction: column;
  overflow: hidden;
  margin: 0 var(--space-4);
}

.mdn-search-header {
  position: relative;
  display: flex;
  align-items: center;
  padding: 0 16px;
  border-bottom: 1px solid var(--md-sys-color-outline-variant);
  background: transparent;
}

@property --mixBlueRed {
  syntax: "<percentage>";
  inherits: false;
  initial-value: 25%;
}
@property --mixRedYellow {
  syntax: "<percentage>";
  inherits: false;
  initial-value: 50%;
}
@property --mixYellowGreen {
  syntax: "<percentage>";
  inherits: false;
  initial-value: 75%;
}
@property --mixGreenYellow {
  syntax: "<percentage>";
  inherits: false;
  initial-value: 100%;
}

.mdn-search-header {
  position: relative;
  --blue: oklch(63.04% 0.18 259.96);
  --red: oklch(62.57% 0.2058 29.08);
  --yellow: oklch(83.04% 0.1698 83.99);
  --green: oklch(64.75% 0.1603 148.5);
}

.mdn-search-header .googleVoice {
  position: absolute;
  bottom: 0;
  left: 0;
  right: 0;
  height: 10px;        /* 5px blur row + 5px sharp line row */
  opacity: 0;
  pointer-events: none;
  overflow: visible;
  transition: opacity 0.3s ease;
}

.mdn-search-header.is-typing .googleVoice {
  opacity: 1;
}

/* Shared gradient for both elements */
.mdn-search-header .googleVoice .rect {
  position: absolute;
  left: 0;
  right: 0;
  height: 5px;
  background: linear-gradient(
    to right,
    var(--blue) 0 var(--mixBlueRed),
    var(--red) var(--mixBlueRed) var(--mixRedYellow),
    var(--yellow) var(--mixRedYellow) var(--mixYellowGreen),
    var(--green) var(--mixYellowGreen) 100%
  );
  transition: --mixBlueRed 0.5s, --mixRedYellow 0.5s, --mixYellowGreen 0.5s;
}

/* Sharp line — sits at the very bottom */
.mdn-search-header .googleVoice .rect:not(.blur) {
  bottom: 0;
  top: auto;
}

.mdn-search-header.is-typing .googleVoice .rect {
  animation: googleVoice 2s ease infinite alternate;
}

/* Blur row — sits ABOVE the sharp line, glow bleeds downward over it */
.mdn-search-header .googleVoice .rect.blur {
  top: 0;
  height: 5px;                          /* taller = more color mass for the glow */
  filter: blur(10px) ;        /* tight blur + saturate keeps colors rich & vivid */
}


@keyframes googleVoice {
  0% {
    --mixBlueRed: 80%;  
    --mixRedYellow: 88%;
    --mixYellowGreen: 96%;
    --mixGreenYellow: 100%;
  }
  15% {
    --mixBlueRed: 10%;
    --mixRedYellow: 70%;
    --mixYellowGreen: 96%;
    --mixGreenYellow: 100%;
  }
  30% {
    --mixBlueRed: 10%;
    --mixRedYellow: 80%;
    --mixYellowGreen: 96%;
    --mixGreenYellow: 100%;
  }
  45% {
    --mixBlueRed: 10%;
    --mixRedYellow: 60%;
    --mixYellowGreen: 76%;
    --mixGreenYellow: 50%;
  }
  60% {
    --mixBlueRed: 0%;
    --mixRedYellow: 10%;
    --mixYellowGreen: 90%;
    --mixGreenYellow: 100%;
  }
  75% {
    --mixBlueRed: 0%;
    --mixRedYellow: 10%;
    --mixYellowGreen: 20%;
    --mixGreenYellow: 40%;
  }
  100% {
    --mixBlueRed: 88%;
    --mixRedYellow: 98%;
    --mixYellowGreen: 93%;
    --mixGreenYellow: 100%;
  }
}

.mdn-search-header .search-icon {
  opacity: 0.8;
  transition: opacity 0.3s ease, transform 0.3s ease;
}

.mdn-search-header.is-typing .search-icon {
  opacity: 0;
  transform: scale(0.8);
}

.mdn-search-header input {
  flex: 1;
  background: transparent;
  border: none;
  color: var(--md-sys-color-on-surface);
  font-size: 1.1rem;
  padding: 20px 16px;
  outline: none;
  font-family: inherit;
}

.mdn-search-header input::placeholder {
  color: var(--md-sys-color-on-surface-variant);
}

.mdn-search-close {
  background: transparent;
  border: none;
  color: var(--md-sys-color-on-surface-variant);
  cursor: pointer;
  padding: 8px;
  display: flex;
  align-items: center;
  justify-content: center;
  border-radius: 8px;
  transition: all 0.2s;
}

.mdn-search-close:hover {
  color: var(--md-sys-color-on-surface);
  background: var(--md-sys-color-surface-variant);
}

.mdn-search-results {
  max-height: 60vh;
  overflow-y: auto;
  background: transparent;
}

.search-empty {
  padding: 32px 24px;
  text-align: center;
  color: var(--md-sys-color-on-surface-variant);
}

.mdn-search-result-item {
  padding: 16px 20px;
  border-bottom: 1px solid var(--md-sys-color-outline-variant);
  cursor: pointer;
  display: block;
  text-decoration: none;
  transition: background 0.2s;
}

.mdn-search-result-item:last-child {
  border-bottom: none;
}

.mdn-search-result-item:hover, 
.mdn-search-result-item:focus,
.mdn-search-result-item.active-focus {
  background: var(--md-sys-color-surface-container-highest);
  outline: none;
}

.mdn-search-result-breadcrumb {
  font-size: 11px;
  color: var(--md-sys-color-on-surface-variant);
  margin-bottom: 4px;
  text-transform: uppercase;
  letter-spacing: 0.5px;
}

.mdn-search-result-title {
  font-size: 16px;
  color: var(--md-sys-color-primary);
}

.mdn-search-result-item:hover .mdn-search-result-title, 
.mdn-search-result-item:focus .mdn-search-result-title,
.mdn-search-result-item.active-focus .mdn-search-result-title {
  color: var(--md-sys-color-on-surface);
}

.mdn-search-result-item:hover .mdn-search-result-breadcrumb, 
.mdn-search-result-item:focus .mdn-search-result-breadcrumb,
.mdn-search-result-item.active-focus .mdn-search-result-breadcrumb {
  color: var(--md-sys-color-on-surface-variant);
}

.mdn-search-highlight {
  background: rgba(255, 235, 59, 0.2);
  color: var(--md-sys-color-on-surface);
  border-radius: 2px;
  padding: 0 2px;
}

/* Header Search Trigger Button */
.header-search-trigger {
  display: flex;
  align-items: center;
  gap: 8px;
  background: var(--md-sys-color-surface-container-high);
  border: 1px solid var(--md-sys-color-outline-variant);
  border-radius: 24px;
  padding: 4px 12px 4px 8px;
  color: var(--md-sys-color-on-surface-variant);
  cursor: pointer;
  transition: background 0.2s, border-color 0.2s;
  font-family: inherit;
}

.header-search-trigger:hover {
  background: var(--md-sys-color-surface-container-highest);
  border-color: var(--md-sys-color-outline);
  color: var(--md-sys-color-on-surface);
}

.header-search-trigger:active {
  transform: scale(0.96);
  transition-duration: 0.08s;
}

.header-search-trigger .material-icons {
  font-size: 20px;
}

.header-search-trigger .search-text {
  font-size: 14px;
  font-weight: 500;
  letter-spacing: 0.01em;
}

.header-search-trigger .search-shortcut-key {
  font-family: var(--md-sys-typescale-font-family-mono);
  font-size: 11px;
  font-weight: 600;
  line-height: 1.5;
  border: 1px solid var(--md-sys-color-outline-variant);
  border-radius: 5px;
  padding: 1px 6px;
  background: var(--md-sys-color-surface);
  box-shadow: inset 0 1px 0 color-mix(in srgb, var(--md-sys-color-on-surface) 10%, transparent);
}
.cta-primary {
  background: var(--md-sys-color-primary);
  color: var(--md-sys-color-on-primary);
}

.cta-primary:hover {
  background: color-mix(in srgb, var(--md-sys-color-primary) 85%, black);
  transform: translateY(-2px);
}

.cta-secondary {
  background: transparent;
  color: var(--md-sys-color-on-surface);
  border: 1px solid var(--md-sys-color-outline);
}

.cta-secondary:hover {
  background: var(--md-sys-color-surface-container-high);
  border-color: var(--md-sys-color-on-surface);
}

.cta-primary:active,
.cta-secondary:active {
  transform: translateY(0) scale(0.97);
  transition-duration: 0.08s;
}

@media (prefers-reduced-motion: reduce) {
  .go-store-link svg { transition: none; }
}


/* ─────────────────────────────────────────────────────────────────────
   DOCUMENT NAVIGATION (Prev / Next)
   ───────────────────────────────────────────────────────────────────── */
.doc-navigation {
  display: flex;
  justify-content: space-between;
  gap: var(--space-4);
  margin-top: var(--space-12);
  padding-top: var(--space-8);
  border-top: 1px solid color-mix(in srgb, var(--md-sys-color-outline-variant) 50%, transparent);
  clear: both;
}

.doc-nav-link {
  display: flex;
  flex-direction: column;
  padding: var(--space-4) var(--space-5);
  border-radius: var(--md-sys-shape-corner-medium);
  background: var(--md-sys-color-surface-container-low);
  border: 1px solid var(--md-sys-color-outline-variant);
  text-decoration: none;
  flex: 1;
  transition:
    background   var(--md-sys-motion-duration-short-3) var(--md-sys-motion-easing-standard),
    border-color var(--md-sys-motion-duration-short-3) var(--md-sys-motion-easing-standard);
}

.doc-nav-link:hover {
  background: var(--md-sys-color-surface-container);
  border-color: var(--md-sys-color-outline);
  text-decoration: none;
}

.doc-nav-link:focus-visible {
  outline: 2px solid var(--md-sys-color-primary);
  outline-offset: 2px;
}

.doc-nav-prev {
  align-items: flex-start;
  text-align: left;
}

.doc-nav-next {
  align-items: flex-end;
  text-align: right;
}

.doc-nav-label {
  font-size: var(--md-sys-typescale-label-small-size);
  font-weight: var(--md-sys-typescale-label-small-weight);
  color: var(--md-sys-color-on-surface-variant);
  text-transform: uppercase;
  letter-spacing: 0.10em;
  margin-bottom: var(--space-1);
}

.doc-nav-title {
  font-size: var(--md-sys-typescale-title-medium-size);
  font-weight: 500;
  color: var(--md-sys-color-primary);
  line-height: var(--md-sys-typescale-title-medium-line-height);
}


/* ─────────────────────────────────────────────────────────────────────
   ON THIS PAGE — TOC SIDEBAR
   ───────────────────────────────────────────────────────────────────── */
.toc-sidebar {
  flex-shrink: 0;
  width: var(--toc-w);
}

.toc-nav {
  position: sticky;
  top: calc(var(--topbar-h) + var(--space-6));
  max-height: calc(100vh - var(--topbar-h) - 64px);
  overflow-y: auto;
  padding: 0 var(--space-1);
}

/* A <button> so mobile can collapse it; on desktop it reads as a plain label */
.toc-heading {
  display: block;
  width: 100%;
  background: none;
  border: none;
  text-align: left;
  font-family: inherit;
  font-size:      var(--md-sys-typescale-label-small-size);
  font-weight:    var(--md-sys-typescale-label-small-weight);
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--md-sys-color-on-surface-variant);
  margin: 0 0 var(--space-3) var(--space-3);
  padding: 0;
  cursor: default;
}

.toc-heading .material-icons {
  display: none;
}

.toc-list {
  list-style: none;
  margin: 0;
  padding: 0;
  /* Faint left-border for visual scanning — softened */
  border-left: 1px solid color-mix(in srgb, var(--md-sys-color-outline-variant) 60%, transparent);
}

.toc-item {
  margin: 0;
  line-height: 1;
}

.toc-h3 {
  padding-left: var(--space-4);
}

.toc-link {
  display: block;
  padding: 5px var(--space-3);
  font-size: var(--md-sys-typescale-body-small-size);
  line-height: 1.5;
  color: var(--md-sys-color-on-surface-variant);
  text-decoration: none;
  border-radius: var(--md-sys-shape-corner-extra-small);
  transition:
    color      var(--md-sys-motion-duration-short-3) var(--md-sys-motion-easing-standard),
    background var(--md-sys-motion-duration-short-3) var(--md-sys-motion-easing-standard);
}
.toc-link:hover {
  color: var(--md-sys-color-on-surface);
  background: color-mix(in srgb, var(--md-sys-color-on-surface) 6%, transparent);
  text-decoration: none;
}
/* No font-weight change: it reflows the link width and jitters the TOC while scrolling */
.toc-link.active {
  color: var(--md-sys-color-primary);
  background: color-mix(in srgb, var(--md-sys-color-primary) 8%, transparent);
  box-shadow: inset 2px 0 0 var(--md-sys-color-primary);
}


/* ─────────────────────────────────────────────────────────────────────
   DIALOG
   ───────────────────────────────────────────────────────────────────── */
md-dialog {
  --md-dialog-container-shape:       var(--md-sys-shape-corner-extra-large);
  --md-dialog-container-color:       var(--md-sys-color-surface-container-high);
  --md-dialog-headline-color:        var(--md-sys-color-on-surface);
  --md-dialog-supporting-text-color: var(--md-sys-color-on-surface-variant);
}

md-dialog:not(:defined) { display: none; }

.form-group {
  margin-bottom: var(--space-4);
}

.form-group label {
  font-size:   var(--md-sys-typescale-body-small-size);
  color:       var(--md-sys-color-on-surface-variant);
  font-weight: 500;
  letter-spacing: var(--md-sys-typescale-body-small-tracking);
}

input[type="file"] {
  margin-top: var(--space-2);
  font-size: var(--md-sys-typescale-body-small-size);
  color: var(--md-sys-color-on-surface);
}

md-text-button {
  --md-text-button-label-text-color: var(--md-sys-color-primary);
}


/* ─────────────────────────────────────────────────────────────────────
   SCROLLBARS (thin, themed)
   ───────────────────────────────────────────────────────────────────── */
::-webkit-scrollbar             { width: 6px; height: 6px; }
::-webkit-scrollbar-track       { background: transparent; }
::-webkit-scrollbar-thumb       {
  background: var(--md-sys-color-outline-variant);
  border-radius: var(--md-sys-shape-corner-full);
}
::-webkit-scrollbar-thumb:hover {
  background: var(--md-sys-color-outline);
}

* { scrollbar-width: thin; scrollbar-color: var(--md-sys-color-outline-variant) transparent; }


/* ─────────────────────────────────────────────────────────────────────
   FOCUS RING — Global (accessibility: never suppress)
   ───────────────────────────────────────────────────────────────────── */
:focus-visible {
  outline: 2px solid var(--md-sys-color-primary);
  outline-offset: 2px;
}
:focus:not(:focus-visible) {
  outline: none;
}


/* ─────────────────────────────────────────────────────────────────────
   LOADING STATE
   ───────────────────────────────────────────────────────────────────── */
.content-loading {
  display: flex;
  align-items: center;
  gap: var(--space-3);
  color: var(--md-sys-color-on-surface-variant);
  font-size: var(--md-sys-typescale-body-medium-size);
  padding: var(--space-8) 0;
}

@keyframes spin {
  to { transform: rotate(360deg); }
}
.spinner {
  width: 20px;
  height: 20px;
  border: 2px solid var(--md-sys-color-outline-variant);
  border-top-color: var(--md-sys-color-primary);
  border-radius: 50%;
  animation: spin 800ms linear infinite;
  flex-shrink: 0;
}

/* ─────────────────────────────────────────────────────────────────────
   SIDEBAR NAVIGATION OVERRIDES
   ───────────────────────────────────────────────────────────────────── */
md-list-item.active {
  background: var(--md-sys-color-secondary-container);
  border-radius: var(--md-sys-shape-corner-medium);
  --md-list-item-label-text-color: var(--md-sys-color-on-secondary-container);
  --md-list-item-hover-state-layer-color: transparent;
}