/* JustineLonglaT-Lane Docs — minimal base styles (no frameworks) */

/* ===== CSS Variables (Light by default) =================================== */
:root {
  /* base */
  --bg: #ffffff;
  --fg: #0f172a;           /* slate-900 */
  --muted: #475569;        /* slate-600 */

  /* links & accents */
  --link: #2563eb;         /* blue-600 */
  --link-visited: #7c3aed; /* violet-600 */
  --accent: #2563eb;
  --accent-ink: #ffffff;

  /* surfaces & borders */
  --border: #e2e8f0;       /* slate-200 */
  --surface: #f8fafc;      /* slate-50 */
  --card-bg: #ffffff;
  --card-border: #e2e8f0;
  --header-bg: #ffffffc0;  /* translucent for blur */
  --footer-bg: #f8fafc;

  /* buttons */
  --btn-bg: #1e3a8a;       /* blue-900 */
  --btn-fg: #ffffff;

  /* code */
  --code-bg: #0b1020;
  --code-fg: #e6edf3;
}

/* Dark theme overrides */
html[data-theme="dark"] {
  --bg: #0b1220;
  --fg: #e5e7eb;
  --muted: #94a3b8;

  --link: #93c5fd;
  --link-visited: #c4b5fd;
  --accent: #93c5fd;
  --accent-ink: #0b1220;

  --border: #1f2937;
  --surface: #0f172a;
  --card-bg: #0f172a;
  --card-border: #1f2937;
  --header-bg: #0f172acc;
  --footer-bg: #0f172a;

  --btn-bg: #334155;
  --btn-fg: #e5e7eb;

  --code-bg: #0e1628;
  --code-fg: #e5e7eb;
}

/* ===== Base =============================================================== */
* { box-sizing: border-box; }
html, body { height: 100%; }
html { scroll-behavior: smooth; }
body {
  margin: 0;
  font-family: ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, "Helvetica Neue", Arial, "Noto Sans", "Liberation Sans", sans-serif;
  color: var(--fg);
  background: var(--bg);
  line-height: 1.6;
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
}
.container { max-width: 980px; padding: 0 1rem; margin: 0 auto; }

/* Skip link */
.skip-link {
  position: absolute;
  left: -9999px;
  top: 0;
}
.skip-link:focus {
  left: 0;
  z-index: 9999;
  background: #fff;
  color: #111827;
  padding: .5rem .75rem;
  border-radius: .5rem;
  box-shadow: 0 2px 8px rgba(0,0,0,.15);
}

/* ===== Header / Nav ======================================================= */
.site-header {
  position: sticky;
  top: 0;
  z-index: 50;
  background: var(--header-bg);
  backdrop-filter: saturate(150%) blur(8px);
  border-bottom: 1px solid var(--border);
}
.navbar {
  display: flex;
  align-items: center;
  gap: .75rem;
  padding: .75rem 0;
}
.brand {
  display: inline-flex;
  align-items: center;
  gap: .5rem;
  font-weight: 700;
  letter-spacing: -0.01em;
  font-size: 1.05rem;
  color: var(--fg);
  text-decoration: none;
}
.brand-mark {
  display: block;
  width: 28px;
  height: 28px;
  vertical-align: middle;
  object-fit: contain;
  opacity: .95;
}
.brand-pill {
  font-size: 0.75rem;
  padding: 0.12rem 0.5rem;
  border-radius: 999px;
  margin-left: 0.25rem;
  border: 1px solid rgba(37, 99, 235, 0.4);
  background: rgba(37, 99, 235, 0.08);
  color: var(--link);
  text-transform: uppercase;
  letter-spacing: 0.06em;
}

html[data-theme="dark"] .brand-pill {
  border-color: rgba(148, 163, 184, 0.5);
  background: rgba(148, 163, 184, 0.16);
  color: var(--accent);
}
/* Shared top bar look */
.site-header {
  position: sticky;
  top: 0;
  z-index: 50;
  background: var(--header-bg, #ffffffc0);
  backdrop-filter: saturate(150%) blur(8px);
  border-bottom: 1px solid var(--border, #e2e8f0);
}

.navbar {
  display: flex;
  align-items: center;
  gap: 0.75rem;
  padding: 0.75rem 0;
}

.brand {
  display: inline-flex;
  align-items: center;
  gap: 0.5rem;
  font-weight: 700;
  letter-spacing: -0.01em;
  font-size: 1.05rem;
  color: var(--fg, #0f172a);
  text-decoration: none;
}

.brand img {
  display: block;
  width: 28px;
  height: 28px;
  object-fit: contain;
  opacity: 0.95;
}

/* Pill (Docs / Blog / Projects) */
.brand-pill {
  font-size: 0.75rem;
  padding: 0.12rem 0.5rem;
  border-radius: 999px;
  margin-left: 0.1rem;
  border: 1px solid rgba(37, 99, 235, 0.4);
  background: rgba(37, 99, 235, 0.08);
  color: var(--link, #2563eb);
  text-transform: uppercase;
  letter-spacing: 0.06em;
}

html[data-theme="dark"] .brand-pill {
  border-color: rgba(148, 163, 184, 0.5);
  background: rgba(148, 163, 184, 0.16);
  color: var(--accent, #93c5fd);
}

/* Right-side nav */
.nav-right {
  margin-left: auto;
  display: inline-flex;
  align-items: center;
  gap: 1rem;
  flex-wrap: wrap;
}

.nav-right a {
  position: relative;
  color: var(--muted, #475569);
  padding: 0.35rem 0.55rem;
  border-radius: 0.5rem;
  text-decoration: none;
  transition: color 0.25s ease;
}

.nav-right a::after {
  content: "";
  position: absolute;
  left: 0;
  bottom: 0;
  width: 100%;
  height: 2px;
  background: var(--link, #2563eb);
  transform: scaleX(0);
  transform-origin: left;
  transition: transform 0.25s ease;
}

.nav-right a:hover::after,
.nav-right a[aria-current="page"]::after {
  transform: scaleX(1);
}

.nav-right a:hover,
.nav-right a[aria-current="page"] {
  color: var(--fg, #0f172a);
}

/* Optional theme toggle (Docs mainly) */
#themeToggle {
  padding: 0.35rem 0.6rem;
  border-radius: 0.6rem;
  border: 1px solid var(--card-border, #e2e8f0);
  background: var(--btn-bg, #1e3a8a);
  color: var(--btn-fg, #ffffff);
  cursor: pointer;
  line-height: 1;
  transition: background 0.25s ease, color 0.25s ease;
}

#themeToggle:hover {
  background: var(--surface, #f8fafc);
  color: var(--fg, #0f172a);
}
/* Layout shell for header */
.navbar {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 1.25rem;
  padding: 0.7rem 0;
}

/* Brand block */
.brand {
  display: inline-flex;
  align-items: center;
  gap: 0.6rem;
  text-decoration: none;
}

.brand:link,
.brand:visited {
  color: var(--fg);            /* keep brand dark, not purple */
}

.brand-logo {
  width: 32px;
  height: 32px;
  object-fit: contain;
}

.brand-text {
  display: flex;
  flex-direction: column;
}

.brand-title {
  font-weight: 700;
  letter-spacing: -0.01em;
  font-size: 1rem;
}

.brand-subtitle {
  font-size: 0.75rem;
  color: var(--muted);
}

/* Center nav links */
.nav-main {
  display: inline-flex;
  align-items: center;
  gap: 1.1rem;
  font-size: 0.95rem;
  flex-wrap: wrap;
  justify-content: center;
}

.nav-main a {
  position: relative;
  color: var(--muted);
  padding: 0.3rem 0.4rem;
  border-radius: 0.5rem;
}

.nav-main a::after {
  content: "";
  position: absolute;
  left: 0;
  bottom: 0;
  width: 100%;
  height: 2px;
  background: var(--link);
  transform: scaleX(0);
  transform-origin: left;
  transition: transform 0.2s ease;
}

.nav-main a:hover::after {
  transform: scaleX(1);
}

.nav-main a:hover {
  color: var(--fg);
}

/* Right side: profile chip + theme button */
.nav-meta {
  display: inline-flex;
  align-items: center;
  gap: 0.75rem;
}

/* You already have most of these; keep or adjust as needed */
.nav-profile {
  display: flex;
  align-items: center;
  gap: 0.6rem;
  padding: 0.3rem 0.7rem;
  border-radius: 999px;
  background: rgba(255, 255, 255, 0.96);
  box-shadow: 0 6px 18px rgba(15, 23, 42, 0.12);
  border: 1px solid rgba(148, 163, 184, 0.4);
  white-space: nowrap;
}

.nav-profile-avatar {
  width: 28px;
  height: 28px;
  border-radius: 999px;
  object-fit: cover;
  box-shadow: 0 0 0 2px #ffffff;
}

.nav-profile-text {
  display: flex;
  flex-direction: column;
  line-height: 1.1;
}

.nav-profile-eyebrow {
  font-size: 0.65rem;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: #64748b;
}

.nav-profile-name {
  font-size: 0.8rem;
  font-weight: 600;
  color: #0f172a;
}

/* Theme button in the nav */
.nav-theme-toggle {
  padding: 0.35rem 0.6rem;
  border-radius: 0.6rem;
  border: 1px solid var(--card-border);
  background: var(--btn-bg);
  color: var(--btn-fg);
  cursor: pointer;
}

/* Mobile: keep things airy */
@media (max-width: 900px) {
  .navbar {
    flex-wrap: wrap;
    justify-content: center;
  }

  .nav-main {
    order: 3;
    width: 100%;
    justify-content: center;
  }

  .nav-profile-text {
    display: none; /* avatar only */
  }

  .nav-profile {
    padding: 0;
    background: transparent;
    box-shadow: none;
    border: none;
  }

  .nav-profile-avatar {
    width: 26px;
    height: 26px;
  }
}

/* Right-aligned nav */
.nav-right {
  margin-left: auto;
  display: flex;
  align-items: center;
  gap: 1rem;
  flex-wrap: wrap;
}
.nav-right a {
  position: relative;
  color: var(--muted);
  text-decoration: none;
  padding: .35rem .55rem;
  border-radius: .5rem;
  transition: color .25s ease;
}
.nav-right a::after {
  content: "";
  position: absolute;
  left: 0;
  bottom: 0;
  width: 100%;
  height: 2px;
  background: var(--link);
  transform: scaleX(0);
  transform-origin: left;
  transition: transform .25s ease;
}
.nav-right a:hover::after,
.nav-right a[aria-current="page"]::after { transform: scaleX(1); }
.nav-right a:hover,
.nav-right a[aria-current="page"] { color: var(--fg); }

/* Theme toggle button */
#themeToggle {
  padding: .35rem .6rem;
  border-radius: .6rem;
  border: 1px solid var(--card-border);
  background: var(--btn-bg);
  color: var(--btn-fg);
  cursor: pointer;
  line-height: 1;
  transition: background .25s ease, color .25s ease;
}
#themeToggle:hover { background: var(--surface); color: var(--fg); }

/* ===== Main =============================================================== */
main { padding: 2.25rem 0 3rem; }
h1, h2, h3 { line-height: 1.25; margin: 1.25rem 0 0.5rem; }
h1 { font-size: clamp(1.75rem, 2.4vw + 1rem, 2.25rem); }
h2 { font-size: clamp(1.25rem, 1.2vw + 1rem, 1.5rem); }
h3 { font-size: 1.125rem; }
.lead {
  color: var(--muted);
  font-size: 1.05rem;
  margin-top: 0.5rem;
  max-width: 72ch;
}
.card {
  border: 1px solid var(--card-border);
  background: var(--card-bg);
  border-radius: 0.75rem;
  padding: 1rem;
}
.grid { display: grid; gap: 0.75rem; }
.grid.cols-2 { grid-template-columns: repeat(1, minmax(0, 1fr)); }
@media (min-width: 768px) {
  .grid.cols-2 { grid-template-columns: repeat(2, minmax(0, 1fr)); }
}

/* ===== Links & Buttons ==================================================== */
a { color: var(--link); }
a:visited { color: var(--link-visited); }

.btn {
  display: inline-block;
  background: var(--btn-bg);
  color: var(--btn-fg);
  padding: 0.55rem 0.8rem;
  border-radius: 0.6rem;
  text-decoration: none;
  font-weight: 600;
  transition: transform .06s ease;
  border: 1px solid transparent;
}
.btn:hover { transform: translateY(-1px); }

/* Primary gradient CTA */
.btn-gradient {
  color: #fff;
  background-image: linear-gradient(90deg, #2563eb 0%, #06b6d4 55%, #14b8a6 100%);
  border-radius: 0.75rem;
  padding: 0.75rem 1.25rem;
  font-weight: 700;
  display: inline-flex;
  align-items: center;
  justify-content: center;
  box-shadow: 0 6px 14px rgba(0,0,0,.12);
  transition: transform .2s ease, box-shadow .2s ease;
}
.btn-gradient:hover {
  transform: translateY(-2px);
  box-shadow: 0 10px 22px rgba(0,0,0,.16);
}

/* Outline CTA (README) */
.btn-outline {
  display: inline-block;
  padding: 0.7rem 1.25rem;
  border-radius: 0.75rem;
  font-weight: 700;
  font-size: 1.05rem;
  text-decoration: none;
  background: transparent;
  color: var(--link);
  border: 2px solid var(--link);
  transition: transform .2s ease, box-shadow .2s ease, background .2s ease, color .2s ease;
}
.btn-outline:hover {
  background: var(--link);
  color: #fff;
  transform: translateY(-2px);
  box-shadow: 0 8px 18px rgba(0,0,0,.14);
}
.btn-outline:focus-visible {
  outline: 3px solid color-mix(in srgb, var(--link) 60%, transparent);
  outline-offset: 2px;
  border-radius: 0.85rem;
}
.cta-footer {
  margin-top: 3rem;
  padding-top: 2rem;
  border-top: 1px solid var(--muted, #d1d5db);
  text-align: left;
}

.cta-footer h2 {
  font-size: 1.4rem;
  margin-bottom: 0.5rem;
}

.cta-footer p {
  margin: 0.4rem 0;
  font-size: 1rem;
}

/* Keep contrast in dark mode */
html[data-theme="dark"] .btn-outline { color: var(--accent); border-color: var(--accent); }
html[data-theme="dark"] .btn-outline:hover { background: var(--accent); color: #0b1220; }

/* Secondary button (optional usage) */
.btn-secondary {
  display: inline-block;
  padding: 0.75rem 1.5rem;
  border-radius: 0.75rem;
  font-weight: 600;
  font-size: 1.1rem;
  text-decoration: none;
  background: transparent;
  color: var(--accent);
  border: 2px solid var(--accent);
  transition: all 0.2s ease-in-out;
}
.btn-secondary:hover { background: var(--accent); color: white; transform: translateY(-2px); }

/* CTA row (side-by-side, wraps on small screens) */
.cta-row {
  display: flex;
  gap: 0.9rem;
  justify-content: center;
  align-items: center;
  flex-wrap: wrap;
  margin-top: 0.75rem;
}
.btn-icon {
  display: inline-flex;
  align-items: center;
  margin-right: .45rem;
  line-height: 0;
}
@media (max-width: 640px) {
  .cta-row a { width: 100%; text-align: center; }
}

/* ===== Hero (centered) ==================================================== */
.logo-banner {
  display: flex;
  flex-direction: column;
  align-items: center;
  text-align: center;
  gap: 0.9rem;
  padding: 2.75rem 1rem 2rem;
  max-width: 980px;
  margin: 0 auto;
}
.logo-banner__img {
  width: clamp(200px, 26vw, 300px);
  height: auto;
  opacity: .98;
  user-select: none;
  animation: fadeUp .5s ease-out .05s both;
}
.logo-banner__tagline {
  font-size: clamp(1.25rem, 1.4vw + 1rem, 2rem);
  line-height: 1.2;
  font-weight: 700;
  letter-spacing: -0.01em;
  color: var(--fg);
  margin: 0.25rem 0 0.25rem;
}
.logo-banner__cta { margin-top: 0.35rem; }

/* Hero entrance animations */
@keyframes fadeUp {
  from { opacity: 0; transform: translateY(10px) }
  to   { opacity: 1; transform: translateY(0)   }
}
.hero-logo  { animation: fadeUp .5s ease-out .05s both; }
.hero-title { animation: fadeUp .6s ease-out .15s both; }
.hero-ctas  { animation: fadeUp .6s ease-out .25s both; }
.hero-ctas {
  margin-top: 0.75rem;
}

.hero-ctas .logo-banner__cta {
  min-width: 10.5rem;
  text-align: center;
  justify-content: center;
}
/* Ultra-wide screens: soften hero image dominance */
@media (min-width: 1280px) {
  .docs-hero img,
  .hero img,
  .author-portrait {
    max-height: 420px;
    object-fit: cover;
  }
}
.docs-hero-divider {
  margin: 2.5rem 0 2rem;
  height: 1px;
  background: linear-gradient(
    to right,
    transparent,
    rgba(148, 163, 184, 0.35),
    transparent
  );
}
/* Balance author portrait size on docs homepage */
.docs-hero img,
.author-portrait {
  max-height: 360px;
  width: auto;
  object-fit: contain;
  margin-inline: auto;
}
/* Clamp author portrait height on docs homepage */
.docs-hero-portrait {
  display: block;
  margin: 1.25rem auto 0.75rem;
  max-height: 260px;   /* main clamp */
  max-width: 220px;    /* so it never stretches too wide */
  width: 100%;
  object-fit: cover;
  border-radius: 1rem;
}

/* On larger screens, make it a bit smaller */
@media (min-width: 1024px) {
  .docs-hero-portrait {
    max-height: 220px;
    max-width: 200px;
  }
}

/* Stack nicely on small screens */
@media (max-width: 640px) {
  .hero-ctas {
    flex-direction: column;
    align-items: stretch;
  }

  .hero-ctas .logo-banner__cta {
    width: 100%;
  }
}
@media (min-width: 1280px) {
  .docs-hero img,
  .author-portrait {
    max-height: 320px;
  }
}
/* ===== Footer ============================================================= */
.site-footer {
  border-top: 1px solid var(--border);
  padding: 1.25rem 0 2rem;
  color: var(--muted);
  background: var(--footer-bg);
  font-size: 0.95rem;
  text-align: center;
}
.site-footer a {
  position: relative;
  color: var(--link);
  text-decoration: none;
  padding-bottom: 2px;
  transition: color .25s ease;
}
.site-footer a::after {
  content: "";
  position: absolute;
  left: 0;
  bottom: 0;
  width: 100%;
  height: 1.5px;
  background: var(--link);
  transform: scaleX(0);
  transform-origin: left;
  transition: transform .25s ease;
}
.site-footer a:hover::after { transform: scaleX(1); }
.site-footer a:hover { color: var(--fg); }
.small { font-size: 0.9rem; }
.footer-simple {
  display: flex;
  flex-direction: column;
  gap: 0.5rem;
  padding: 1.25rem 0 2rem;
  font-size: 0.9rem;
}
.site-footer {
  margin-top: 3rem;
  padding: 1.75rem 0 1.5rem;
  border-top: 1px solid rgba(148, 163, 184, 0.35);
  background: radial-gradient(circle at top, rgba(15, 23, 42, 0.06), transparent);
  font-size: 0.78rem;
}
.footer-copy span {
  font-weight: 600;
}

.footer-links {
  display: flex;
  flex-wrap: wrap;
  gap: 0.75rem 1.25rem;
}

.footer-links a {
  position: relative;
  padding-bottom: 2px;
}

.footer-links a::after {
  content: "";
  position: absolute;
  left: 0;
  bottom: 0;
  width: 100%;
  height: 1.5px;
  background: var(--link);
  transform: scaleX(0);
  transform-origin: left;
  transition: transform 0.25s ease;
}

.footer-links a:hover::after {
  transform: scaleX(1);
}

@media (min-width: 640px) {
  .footer-simple {
    flex-direction: row;
    align-items: center;
    justify-content: space-between;
  }
}
.footer-simple {
  display: flex;
  flex-direction: column;
  gap: 0.5rem;
  padding: 1.25rem 0 2rem;
  font-size: 0.9rem;
}

.footer-copy span {
  font-weight: 600;
}

.footer-links {
  display: flex;
  flex-wrap: wrap;
  gap: 0.75rem 1.25rem;
}

.footer-links a {
  position: relative;
  padding-bottom: 2px;
}

.footer-links a::after {
  content: "";
  position: absolute;
  left: 0;
  bottom: 0;
  width: 100%;
  height: 1.5px;
  background: var(--link);
  transform: scaleX(0);
  transform-origin: left;
  transition: transform 0.25s ease;
}

.footer-links a:hover::after {
  transform: scaleX(1);
}

@media (min-width: 640px) {
  .footer-simple {
    flex-direction: row;
    align-items: center;
    justify-content: space-between;
  }
}
/* ===== Code blocks ======================================================== */
pre, code { font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
pre {
  background: var(--code-bg);
  color: var(--code-fg);
  padding: 1rem;
  border-radius: 0.6rem;
  overflow-x: auto;
  border: 1px solid var(--card-border);
}

/* ===== Utilities ========================================================== */
.mt-0 { margin-top: 0; }
.mt-1 { margin-top: 0.25rem; }
.mt-2 { margin-top: 0.5rem; }
.mt-3 { margin-top: 0.75rem; }
.mt-4 { margin-top: 1rem; }
.mb-0 { margin-bottom: 0; }
.mb-1 { margin-bottom: 0.25rem; }
.mb-2 { margin-bottom: 0.5rem; }
.center { text-align: center; }

/* AUTO-DOCS-HOMEPAGE-STYLES */
.docs-hero {
  padding: 3.5rem 0 2.5rem;
  display: flex;
  flex-direction: column;
  gap: 1.25rem;
  max-width: 64rem;
}

.docs-hero-eyebrow {
  font-size: 0.9rem;
  text-transform: uppercase;
  letter-spacing: 0.16em;
  font-weight: 600;
  opacity: 0.8;
}

.docs-hero-title {
  font-size: clamp(2.25rem, 3vw + 1rem, 3.25rem);
  line-height: 1.1;
  margin: 0;
}

.docs-hero-tagline {
  margin: 0;
  max-width: 46rem;
  font-size: 1rem;
  line-height: 1.6;
  opacity: 0.9;
}

.docs-hero-meta {
  display: flex;
  flex-wrap: wrap;
  gap: 0.5rem;
  align-items: center;
}

.pill {
  display: inline-flex;
  align-items: center;
  padding: 0.25rem 0.75rem;
  border-radius: 999px;
  font-size: 0.75rem;
  font-weight: 600;
  border: 1px solid rgba(255, 255, 255, 0.08);
}

.pill-success {
  color: #16a34a;
}

.pill-accent {
  color: #0ea5e9;
}

/* Grid of entry cards */
.docs-grid {
  display: grid;
  gap: 1.25rem;
  margin-top: 2rem;
  margin-bottom: 1rem;
}

@media (min-width: 768px) {
  .docs-grid {
    grid-template-columns: repeat(3, minmax(0, 1fr));
  }
}

.doc-card {
  padding: 1.15rem;
  border-radius: 0.9rem;
  border: 1px solid rgba(148, 163, 184, 0.35);
  transition: transform 150ms ease-out, box-shadow 150ms ease-out;
}

.doc-card:hover {
  transform: translateY(-3px);
}

.doc-card-title {
  margin: 0 0 0.35rem;
  font-size: 1rem;
}

.doc-card-body {
  margin: 0 0 0.75rem;
  font-size: 0.92rem;
  line-height: 1.5;
  opacity: 0.92;
}

.doc-card-links {
  list-style: none;
  padding: 0;
  margin: 0;
  display: flex;
  flex-direction: column;
  gap: 0.25rem;
}
.doc-card {
  position: relative;
  padding: 1.15rem 1.15rem 1.1rem;
  border-radius: 0.9rem;
  border: 1px solid rgba(148, 163, 184, 0.35);
  background: radial-gradient(circle at top left, rgba(148, 163, 184, 0.14), rgba(15, 23, 42, 1));
  box-shadow:
    0 18px 30px rgba(15, 23, 42, 0.6),
    0 0 0 1px rgba(15, 23, 42, 1) inset;
  transform: translateY(8px);
  opacity: 0;
  transition:
    opacity 200ms ease-out,
    transform 200ms ease-out,
    box-shadow 200ms ease-out,
    border-color 200ms ease-out,
    background 200ms ease-out;
}

.doc-card:hover {
  transform: translateY(0) scale(1.01);
  border-color: rgba(56, 189, 248, 0.8);
  box-shadow:
    0 20px 35px rgba(15, 23, 42, 0.8),
    0 0 0 1px rgba(8, 47, 73, 0.9) inset;
}

/* When revealed via JS */
.doc-card.is-visible {
  opacity: 1;
  transform: translateY(0);
}
/* Reusable docs hero shell */
.docs-hero-shell {
  max-width: 720px;
  margin: 0 auto 2.5rem;
}

/* Clamp author portrait height */
.docs-hero-portrait {
  display: block;
  margin: 1.25rem auto 0.75rem;
  max-height: 240px;
  max-width: 200px;
  width: 100%;
  object-fit: cover;
  border-radius: 1rem;
}

/* On larger screens, make it a bit smaller */
@media (min-width: 1024px) {
  .docs-hero-portrait {
    max-height: 220px;
    max-width: 190px;
  }
}

/* Divider under hero */
.docs-hero-divider {
  margin: 2.5rem auto 2rem;
  max-width: 720px;
  height: 1px;
  background: linear-gradient(
    to right,
    transparent,
    rgba(148, 163, 184, 0.35),
    transparent
  );
}

/* Scroll reveal base for cards */
.doc-card {
  position: relative;
  padding: 1rem 1.1rem 0.9rem;  /* slightly tighter */
  border-radius: 0.9rem;
  border: 1px solid rgba(148, 163, 184, 0.35);
  background: radial-gradient(circle at top left, rgba(148, 163, 184, 0.14), rgba(15, 23, 42, 1));
  box-shadow:
    0 18px 30px rgba(15, 23, 42, 0.6),
    0 0 0 1px rgba(15, 23, 42, 1) inset;
  transform: translateY(8px);
  opacity: 0;
  transition:
    opacity 200ms ease-out,
    transform 200ms ease-out,
    box-shadow 200ms ease-out,
    border-color 200ms ease-out,
    background 200ms ease-out;
}

.doc-card:hover {
  transform: translateY(0) scale(1.01);
  border-color: rgba(56, 189, 248, 0.8);
  box-shadow:
    0 20px 35px rgba(15, 23, 42, 0.8),
    0 0 0 1px rgba(8, 47, 73, 0.9) inset;
}
/* Grid of entry cards */
.docs-grid {
  display: grid;
  gap: 1.5rem;
  margin: 2rem auto;
  max-width: 72rem;      /* 🔹 keeps cards from stretching full-page */
  padding: 0 1rem;       /* small side breathing room */
}

/* Featured homepage grid gets a bit more separation */
.docs-grid-featured {
  margin-bottom: 2.5rem;
}

/* 1 column by default (mobile) */
/* 2 columns on small/medium screens */
@media (min-width: 640px) {
  .docs-grid {
    grid-template-columns: repeat(2, minmax(0, 1fr));
  }
}

/* 3 columns on desktop */
@media (min-width: 1024px) {
  .docs-grid {
    grid-template-columns: repeat(3, minmax(0, 1fr));
  }
}

/* When scroll-reveal marks them visible */
.doc-card.is-visible {
  opacity: 1;
  transform: translateY(0);
}
/* Buttons planted under the hero logo */
.hero-logo-actions {
  margin-top: 1.25rem;
  display: flex;
  flex-direction: column;
  gap: 0.65rem;
  align-items: center;
}

/* Base button */
.hero-btn {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  padding: 0.55rem 1.25rem;
  border-radius: 999px;
  font-size: 0.9rem;
  font-weight: 600;
  text-decoration: none;
  border: 1px solid transparent;
  transition: all 0.15s ease;
}

/* Primary blue button */
.hero-btn-primary {
  background: #2563eb;
  color: #ffffff;
  box-shadow: 0 4px 20px rgba(37, 99, 235, 0.35);
}

.hero-btn-primary:hover {
  background: #1e4ed8;
  transform: translateY(-1px);
}

/* Outline buttons */
.hero-btn-outline {
  background: #ffffff;
  color: #1e293b;
  border: 1px solid #cbd5f5;
}

.hero-btn-outline:hover {
  border-color: #2563eb;
  background: #f0f5ff;
}

/* Chip button */
.hero-btn-chip {
  background: #ecfdf5;
  color: #065f46;
  border: 1px solid #a7f3d0;
  padding: 0.45rem 1rem;
}

.hero-btn-chip:hover {
  background: #d1fae5;
  border-color: #34d399;
}

/* Mobile layout */
@media (max-width: 640px) {
  .hero-logo-actions {
    width: 100%;
  }
}
/* =========================
   Hero logo card polish
   ========================= */
.logo-banner-visual {
  position: relative;
  text-align: center;
  max-width: 420px;
  margin: 0 auto 2.5rem;
  padding: 2.4rem 1.6rem 2rem;
  border-radius: 1.75rem;
  background: radial-gradient(circle at top, #eff6ff 0, #ffffff 55%, #eef2ff 100%);
  box-shadow:
    0 22px 55px rgba(15, 23, 42, 0.18),
    0 0 0 1px rgba(148, 163, 184, 0.28);
  overflow: hidden;
}

/* Soft glow ring behind everything */
.logo-banner-visual::before {
  content: "";
  position: absolute;
  inset: -40%;
  background: radial-gradient(circle at 50% 0%, rgba(59, 130, 246, 0.25), transparent 60%);
  opacity: 0.75;
  pointer-events: none;
}

/* Subtle top highlight */
.logo-banner-visual::after {
  content: "";
  position: absolute;
  inset-inline: 10%;
  top: 0;
  height: 28%;
  background: linear-gradient(to bottom, rgba(255, 255, 255, 0.9), transparent);
  pointer-events: none;
}
/* Logo halo & float */
.logo-banner__img {
  position: relative;
  z-index: 1;
  width: 132px;
  height: auto;
  border-radius: 999px;
  padding: 0.8rem;
  background: radial-gradient(circle at 30% 0%, #dbeafe, #eff6ff 45%, #e0f2fe 100%);
  box-shadow:
    0 18px 40px rgba(15, 23, 42, 0.25),
    0 0 0 1px rgba(148, 163, 184, 0.4);
  animation: floatLogo 6s ease-in-out infinite;
}

/* Gentle float motion */
@keyframes floatLogo {
  0%,
  100% {
    transform: translateY(0);
  }
  50% {
    transform: translateY(-6px);
  }
}
/* Staggered fade-up for the whole button group */
.hero-logo-actions {
  margin-top: 1.6rem;
  display: flex;
  flex-direction: column;
  gap: 0.65rem;
  align-items: center;
  position: relative;
  z-index: 1;
  animation: heroButtonsIn 0.7s ease-out 0.15s both;
}

@keyframes heroButtonsIn {
  from {
    opacity: 0;
    transform: translateY(10px);
    filter: blur(2px);
  }
  to {
    opacity: 1;
    transform: translateY(0);
    filter: blur(0);
  }
}
/* Base button – small lift + focus ring */
.hero-btn {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  padding: 0.55rem 1.3rem;
  border-radius: 999px;
  font-size: 0.9rem;
  font-weight: 600;
  text-decoration: none;
  border: 1px solid transparent;
  transition: transform 0.15s ease, box-shadow 0.15s ease, background 0.15s ease, border-color 0.15s ease;
  cursor: pointer;
  outline: none;
}

.hero-btn:focus-visible {
  box-shadow: 0 0 0 2px #eff6ff, 0 0 0 4px #2563eb;
}

/* Primary (blue) */
.hero-btn-primary {
  background: #2563eb;
  color: #ffffff;
  box-shadow: 0 10px 30px rgba(37, 99, 235, 0.45);
}

.hero-btn-primary:hover {
  background: #1e4ed8;
  transform: translateY(-1px);
}

/* Outline */
.hero-btn-outline {
  background: #ffffff;
  color: #0f172a;
  border: 1px solid #cbd5f5;
}

.hero-btn-outline:hover {
  border-color: #2563eb;
  background: #eff6ff;
  transform: translateY(-1px);
}

/* Chip */
.hero-btn-chip {
  background: #ecfdf5;
  color: #065f46;
  border: 1px solid #a7f3d0;
  padding: 0.45rem 1.1rem;
  font-size: 0.85rem;
  gap: 0.4rem;
}

.hero-btn-chip:hover {
  background: #d1fae5;
  border-color: #34d399;
  transform: translateY(-1px);
}
@media (max-width: 640px) {
  .logo-banner-visual {
    margin-inline: 1rem;
    padding-inline: 1.2rem;
  }

  .hero-logo-actions {
    width: 100%;
  }

  .hero-btn {
    width: 100%;
    max-width: 320px;
  }
}