/* ==========================================================================
   Apache Wicket Site — Main Stylesheet
   Plain CSS, no preprocessor. Powers the entire Jekyll site.
   ========================================================================== */

/* ==========================================================================
   0. Local Font Faces
   ========================================================================== */

@font-face {
  font-family: 'Fraunces';
  src: url('../fonts/fraunces-latin.woff2') format('woff2');
  font-weight: 100 900;
  font-style: normal;
  font-display: swap;
}

@font-face {
  font-family: 'Fraunces';
  src: url('../fonts/fraunces-italic-latin.woff2') format('woff2');
  font-weight: 100 900;
  font-style: italic;
  font-display: swap;
}

@font-face {
  font-family: 'General Sans';
  src: url('../fonts/general-sans-400.woff2') format('woff2');
  font-weight: 400;
  font-style: normal;
  font-display: swap;
}

@font-face {
  font-family: 'General Sans';
  src: url('../fonts/general-sans-500.woff2') format('woff2');
  font-weight: 500;
  font-style: normal;
  font-display: swap;
}

@font-face {
  font-family: 'General Sans';
  src: url('../fonts/general-sans-600.woff2') format('woff2');
  font-weight: 600;
  font-style: normal;
  font-display: swap;
}

@font-face {
  font-family: 'General Sans';
  src: url('../fonts/general-sans-700.woff2') format('woff2');
  font-weight: 700;
  font-style: normal;
  font-display: swap;
}

@font-face {
  font-family: 'JetBrains Mono';
  src: url('../fonts/jetbrains-mono-latin.woff2') format('woff2');
  font-weight: 100 800;
  font-style: normal;
  font-display: swap;
}

/* ==========================================================================
   1. CSS Custom Properties
   ========================================================================== */

:root {
  /* Colors */
  --color-ink: #0f1419;
  --color-charcoal: #1a1614;
  --color-warm-dark: #2a2320;
  --color-warm-mid: #4a4340;
  --color-warm-light: #8a8280;
  --color-paper: #faf8f5;
  --color-paper-dim: #f2efe9;
  --color-wicket-orange: #E8542E;
  --color-wicket-orange-light: #ff7a52;
  --color-wicket-orange-glow: rgba(232, 84, 46, 0.12);
  --color-asf-purple: #2D1050;

  /* Semantic colors for code syntax highlighting */
  --color-code-bg: #0f1419;
  --color-code-text: #abb2bf;
  --color-code-keyword: #c49a6c;
  --color-code-type: #d4a07a;
  --color-code-builtin: #6db3ce;
  --color-code-string: #8fbc6f;
  --color-code-annotation: #b39ddb;
  --color-code-highlight-bg: rgba(232, 84, 46, 0.12);

  /* Tag badge colors */
  --color-tag-security-bg: rgba(143, 188, 111, 0.15);
  --color-tag-security-text: #5a8a3c;
  --color-tag-community-bg: rgba(109, 179, 206, 0.15);
  --color-tag-community-text: #3a7a9a;

  /* Status badge colors */
  --color-status-current-bg: #dcfce7;
  --color-status-current-text: #166534;
  --color-status-supported-bg: #dbeafe;
  --color-status-supported-text: #1e40af;
  --color-status-security-bg: #fef3c7;
  --color-status-security-text: #92400e;

  /* Fonts */
  --font-display: 'Fraunces', Georgia, serif;
  --font-body: 'General Sans', system-ui, sans-serif;
  --font-mono: 'JetBrains Mono', ui-monospace, monospace;

  /* Spacing scale (Tailwind equivalents) */
  --space-0: 0;
  --space-0-5: 0.125rem;  /* 2px  — py-0.5 */
  --space-1: 0.25rem;     /* 4px  — p-1 */
  --space-1-5: 0.375rem;  /* 6px  — py-1.5 */
  --space-2: 0.5rem;      /* 8px  — p-2 */
  --space-2-5: 0.625rem;  /* 10px — gap-2.5 */
  --space-3: 0.75rem;     /* 12px — mb-3 */
  --space-4: 1rem;        /* 16px — p-4, mb-4 */
  --space-5: 1.25rem;     /* 20px — mb-5 */
  --space-6: 1.5rem;      /* 24px — p-6, gap-6 */
  --space-7: 1.75rem;     /* 28px — gap-7 */
  --space-8: 2rem;        /* 32px — p-8, mb-8, gap-8 */
  --space-10: 2.5rem;     /* 40px — py-10, gap-10 */
  --space-12: 3rem;       /* 48px — px-12, py-12, gap-12 */
  --space-16: 4rem;       /* 64px — py-16, gap-16 */
  --space-20: 5rem;       /* 80px — py-20 */
  --space-24: 6rem;       /* 96px — py-24 */

  /* Border radius (Tailwind equivalents) */
  --radius-sm: 0.25rem;   /* rounded */
  --radius-md: 0.375rem;  /* rounded-md */
  --radius-lg: 0.5rem;    /* rounded-lg */
  --radius-full: 9999px;  /* rounded-full */

  /* Font sizes (Tailwind equivalents) */
  --text-xs: 0.75rem;     /* text-xs — 12px */
  --text-sm: 0.875rem;    /* text-sm — 14px */
  --text-base: 1rem;      /* text-base — 16px */
  --text-lg: 1.125rem;    /* text-lg — 18px */
  --text-xl: 1.25rem;     /* text-xl — 20px */
  --text-2xl: 1.5rem;     /* text-2xl — 24px */
  --text-3xl: 1.875rem;   /* text-3xl — 30px */
  --text-4xl: 2.25rem;    /* text-4xl — 36px */

  /* Max widths */
  --max-w-xl: 36rem;      /* max-w-xl — 576px */
  --max-w-2xl: 42rem;     /* max-w-2xl — 672px */
  --max-w-3xl: 48rem;     /* max-w-3xl — 768px */
  --max-w-4xl: 56rem;     /* max-w-4xl — 896px */
  --max-w-5xl: 64rem;     /* max-w-5xl — 1024px */

  /* Transitions */
  --transition-colors: color 0.2s ease, background-color 0.2s ease, border-color 0.2s ease;
  --transition-all: all 0.2s ease;

  /* Shadows */
  --shadow-card-hover: 0 8px 32px rgba(232, 84, 46, 0.06);
  --shadow-card-subtle: 0 8px 24px rgba(0, 0, 0, 0.04);

  /* Cross-hatch pattern for header bands */
  --pattern-crosshatch: url("data:image/svg+xml,%3Csvg width='60' height='60' viewBox='0 0 60 60' xmlns='http://www.w3.org/2000/svg'%3E%3Cg fill='none' fill-rule='evenodd'%3E%3Cg fill='%23ffffff' fill-opacity='0.015'%3E%3Cpath d='M36 34v-4h-2v4h-4v2h4v4h2v-4h4v-2h-4zm0-30V0h-2v4h-4v2h4v4h2V6h4V4h-4zM6 34v-4H4v4H0v2h4v4h2v-4h4v-2H6zM6 4V0H4v4H0v2h4v4h2V6h4V4H6z'/%3E%3C/g%3E%3C/g%3E%3C/svg%3E");
}


/* ==========================================================================
   2. Reset / Base Styles
   ========================================================================== */

*,
*::before,
*::after {
  box-sizing: border-box;
  margin: 0;
  padding: 0;
}

html {
  font-family: var(--font-body);
  color: var(--color-ink);
  background-color: var(--color-paper);
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  line-height: 1.5;
  -webkit-text-size-adjust: 100%;
}

body {
  min-height: 100vh;
  display: flex;
  flex-direction: column;
}

img,
svg {
  display: block;
  max-width: 100%;
}

a {
  color: inherit;
  text-decoration: underline;
  transition: var(--transition-colors);
}

a.no-underline {
  text-decoration: none;
}

ul, ol {
  list-style: none;
}

button {
  background: none;
  border: none;
  cursor: pointer;
  font: inherit;
  color: inherit;
}

table {
  border-collapse: collapse;
  width: 100%;
}


/* ==========================================================================
   3. Typography
   ========================================================================== */

h1, h2, h3, h4 {
  font-family: var(--font-display);
  line-height: 1.2;
  font-weight: 700;
}

h1 {
  font-size: var(--text-4xl);
}

h2 {
  font-size: var(--text-3xl);
}

h3 {
  font-size: var(--text-2xl);
}

h4 {
  font-size: var(--text-xl);
}

code, pre {
  font-family: var(--font-mono);
}

/* Inline code (outside .prose, .code-showcase, etc.) */
code {
  font-size: 0.875em;
  background: var(--color-paper-dim);
  padding: 0.125rem 0.375rem;
  border-radius: var(--radius-sm);
}

pre code {
  background: none;
  padding: 0;
  border-radius: 0;
  font-size: inherit;
}

/* Small caps utility for section labels */
.section-label {
  font-size: 0.6875rem;         /* 11px */
  letter-spacing: 0.12em;
  text-transform: uppercase;
  font-weight: 600;
  color: var(--color-wicket-orange);
  margin-bottom: var(--space-3);
}

/* Tracking-wider utility */
.tracking-wider {
  letter-spacing: 0.05em;
}


/* ==========================================================================
   4. ASF Bar
   ========================================================================== */

.asf-bar {
  background-color: var(--color-asf-purple);
  font-size: 0.6875rem;         /* 11px */
  color: rgba(255, 255, 255, 0.65);
}

.asf-bar-inner {
  display: flex;
  align-items: center;
  gap: var(--space-1-5);
  padding: var(--space-1-5) var(--space-6);
}

.asf-bar-icon {
  width: 1rem;
  height: 1rem;
  flex-shrink: 0;
}

.asf-bar-link {
  color: rgba(255, 255, 255, 0.65);
  text-decoration: none;
  transition: var(--transition-colors);
}

.asf-bar-link:hover {
  color: #ffffff;
}

@media (min-width: 768px) {
  .asf-bar-inner {
    padding-left: var(--space-12);
    padding-right: var(--space-12);
  }
}


/* ==========================================================================
   5. Navigation
   ========================================================================== */

.site-nav {
  background-color: var(--color-paper);
  border-bottom: 1px solid rgba(0, 0, 0, 0.06);
}

.site-nav-inner {
  display: flex;
  align-items: center;
  padding: var(--space-4) var(--space-6);
}

.site-nav-brand {
  display: flex;
  align-items: center;
  gap: var(--space-2-5);
  text-decoration: none;
}

.site-nav-logo-img {
  width: 1.75rem;              /* 28px — w-7 */
  height: 1.75rem;
  flex-shrink: 0;
  border-radius: var(--radius-sm);
}

.site-nav-title {
  font-family: var(--font-body);
  font-weight: 700;
  font-size: var(--text-lg);
  color: var(--color-ink);
}

.site-nav-links {
  display: none;
  margin-left: auto;
  gap: var(--space-7);
  font-size: var(--text-sm);
  font-weight: 500;
}

.site-nav-link {
  text-decoration: none;
  color: var(--color-warm-mid);
  transition: var(--transition-colors);
}

.site-nav-link:hover,
.site-nav-link.active {
  color: var(--color-wicket-orange);
}

.site-nav-external-icon {
  font-size: var(--text-xs);
  color: var(--color-warm-light);
}

/* Mobile menu toggle */
.site-nav-toggle {
  margin-left: auto;
  padding: var(--space-2);
  color: var(--color-warm-mid);
  display: block;
}

.site-nav-toggle svg {
  width: 1.5rem;               /* 24px — w-6 */
  height: 1.5rem;
}

/* Mobile menu (links shown as column on small screens) */
.site-nav-links.is-open {
  display: flex;
  flex-direction: column;
  position: absolute;
  top: 100%;
  left: 0;
  right: 0;
  background-color: var(--color-paper);
  border-bottom: 1px solid rgba(0, 0, 0, 0.06);
  padding: var(--space-4) var(--space-6);
  gap: 0;
}

.site-nav-links.is-open .site-nav-link {
  display: block;
  padding: var(--space-2) 0;
}

@media (min-width: 768px) {
  .site-nav-inner {
    padding-left: var(--space-12);
    padding-right: var(--space-12);
  }

  .site-nav-links {
    display: flex;
  }

  .site-nav-toggle {
    display: none;
  }
}


/* ==========================================================================
   6. Header Band
   ========================================================================== */

.header-band {
  background-color: var(--color-charcoal);
  position: relative;
  overflow: hidden;
  padding: var(--space-12) var(--space-6);
}

.header-band--hero {
  padding-top: var(--space-20);
  padding-bottom: var(--space-20);
}

/* Photo hero variant — image set via inline style or default */
.header-band--photo {
  background-size: cover;
  background-position: center 40%;
}

.header-band--photo::before {
  /* Override the cross-hatch — the photo is the texture now */
  background-image: none;
}

.hero-photo-credit {
  position: absolute;
  bottom: var(--space-2);
  right: var(--space-4);
  font-size: 0.625rem;
  color: rgba(245, 240, 234, 0.2);
  z-index: 1;
}

.hero-photo-credit a {
  color: rgba(245, 240, 234, 0.3);
  text-decoration: none;
}

.hero-photo-credit a:hover {
  color: rgba(245, 240, 234, 0.5);
}

/* --page modifier removed: all non-hero bands use the same padding */

/* Cross-hatch background overlay */
.header-band::before {
  content: '';
  position: absolute;
  inset: 0;
  background-image: var(--pattern-crosshatch);
  pointer-events: none;
}

.header-band__inner,
.header-band-inner {
  position: relative;
  z-index: 1;
  max-width: var(--max-w-4xl);
  margin-left: auto;
  margin-right: auto;
  padding-left: var(--space-6);
  padding-right: var(--space-6);
}

.header-band__inner--narrow,
.header-band-inner--narrow {
  max-width: var(--max-w-3xl);
}

.header-band__inner--wide,
.header-band-inner--wide {
  max-width: var(--max-w-5xl);
}

.header-band__inner--centered {
  margin-left: auto;
  margin-right: auto;
}

.header-band__subtitle {
  font-size: 0.8125rem;        /* 13px */
  font-weight: 600;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--color-wicket-orange);
  margin-bottom: var(--space-5);
}

/* Hero brand block: logo + label */
.hero-brand {
  display: flex;
  align-items: center;
  gap: var(--space-3);
  margin-bottom: var(--space-5);
}

.hero-brand .header-band__subtitle--hero {
  font-size: 0.9375rem;        /* 15px — slightly larger than default */
  margin-bottom: 0;
}

.hero-logo {
  height: 48px;
  width: auto;
  border-radius: var(--radius-sm);
}

.header-band__title {
  font-family: var(--font-display);
  font-size: var(--text-4xl);
  font-weight: 900;
  line-height: 1.1;
  color: #f5f0ea;
  margin-bottom: var(--space-5);
}

.header-band__title em {
  font-weight: 300;
  font-style: italic;
  color: var(--color-wicket-orange-light);
}

.header-band__description {
  font-size: var(--text-lg);
  color: rgba(245, 240, 234, 0.55);
  line-height: 1.7;
  max-width: var(--max-w-xl);
  margin-bottom: var(--space-8);
}

/* Page-level header band (blog, docs, etc.) */
.header-band h1 {
  color: #f5f0ea;
}

.header-band .page-subtitle,
.header-band .subtitle {
  color: var(--color-wicket-orange);
  font-family: var(--font-display);
  font-size: var(--text-lg);
  font-weight: 300;
  font-style: italic;
  margin-top: var(--space-2);
}

.header-band .page-preamble,
.header-band .preamble {
  color: rgba(245, 240, 234, 0.5);
  line-height: 1.7;
  max-width: var(--max-w-2xl);
  margin-top: var(--space-4);
}

.header-band .page-date {
  font-size: var(--text-sm);
  color: rgba(245, 240, 234, 0.4);
  margin-bottom: var(--space-2);
}

.header-band .page-description {
  color: rgba(245, 240, 234, 0.5);
  margin-top: var(--space-2);
}

/* Hero button group */
.header-band__actions {
  display: flex;
  gap: var(--space-3);
  flex-wrap: wrap;
}

@media (min-width: 768px) {
  .header-band {
    padding: var(--space-16) var(--space-12);
  }

  .header-band--hero {
    padding-top: var(--space-24);
    padding-bottom: var(--space-24);
  }

  .header-band__inner,
  .header-band-inner {
    padding-left: var(--space-12);
    padding-right: var(--space-12);
  }

  .header-band__title {
    font-size: 3.25rem;         /* 52px — text-[52px] */
  }
}


/* ==========================================================================
   7. Content Area
   ========================================================================== */

.content-area {
  background-color: var(--color-paper);
  flex: 1;
}

.content-area__inner,
.content-inner {
  max-width: var(--max-w-4xl);
  margin-left: auto;
  margin-right: auto;
  padding: var(--space-12) var(--space-6);
}

.content-area__inner--wide {
  max-width: var(--max-w-5xl);
}

.content-area__inner--narrow,
.content-inner--narrow {
  max-width: var(--max-w-3xl);
}

@media (min-width: 768px) {
  .content-area__inner,
  .content-inner {
    padding: var(--space-16) var(--space-12);
  }
}


/* ==========================================================================
   8. Prose Styles
   ========================================================================== */

.prose {
  color: var(--color-warm-mid);
  font-size: var(--text-base);
  line-height: 1.75;
}

.prose h1,
.prose h2,
.prose h3,
.prose h4 {
  color: var(--color-ink);
  margin-top: 2em;
  margin-bottom: 0.75em;
}

.prose h1 {
  font-size: var(--text-4xl);
  margin-top: 0;
}

.prose h2 {
  font-size: var(--text-2xl);
}

.prose h3 {
  font-size: var(--text-xl);
}

.prose h4 {
  font-size: var(--text-lg);
}

.prose p {
  margin-bottom: 1.25em;
}

.prose a {
  color: var(--color-wicket-orange);
  text-decoration: underline;
  text-decoration-color: var(--color-wicket-orange);
  text-underline-offset: 2px;
}

.prose a:hover {
  color: var(--color-wicket-orange-light);
}

.prose strong {
  color: var(--color-ink);
  font-weight: 600;
}

.prose ul,
.prose ol {
  margin-bottom: 1.25em;
  padding-left: 1.5em;
}

.prose ul {
  list-style-type: disc;
}

.prose ol {
  list-style-type: decimal;
}

.prose li {
  margin-bottom: 0.5em;
}

.prose li::marker {
  color: var(--color-warm-light);
}

.prose code {
  font-size: 0.875em;
  background: var(--color-paper-dim);
  padding: 0.125rem 0.375rem;
  border-radius: var(--radius-sm);
  color: var(--color-ink);
}

.prose pre {
  background: var(--color-ink);
  border-radius: var(--radius-lg);
  border: 1px solid rgba(255, 255, 255, 0.06);
  padding: 1.5rem;
  overflow-x: auto;
  margin: 1.5rem 0;
  font-size: 0.8125rem;         /* 13px */
  line-height: 1.8;
  color: var(--color-code-text);
}

.prose pre code {
  background: none;
  padding: 0;
  border-radius: 0;
  color: inherit;
  font-size: inherit;
}

.prose blockquote {
  border-left: 3px solid var(--color-wicket-orange);
  padding-left: var(--space-4);
  margin-bottom: 1.25em;
  font-style: italic;
  color: var(--color-warm-mid);
}

.prose hr {
  border: none;
  border-top: 1px solid rgba(0, 0, 0, 0.08);
  margin: 2em 0;
}

.prose img {
  border-radius: var(--radius-lg);
  margin-bottom: 1.5em;
}

/* not-prose: opt out of prose styling for specific blocks */
.prose .not-prose {
  /* Reset prose styles for embedded components */
}

.prose .not-prose h1,
.prose .not-prose h2,
.prose .not-prose h3,
.prose .not-prose h4 {
  margin-top: 0;
  margin-bottom: 0;
}

.prose .not-prose p {
  margin-bottom: 0;
}

.prose .not-prose ul,
.prose .not-prose ol {
  margin-bottom: 0;
  padding-left: 0;
  list-style-type: none;
}

.prose .not-prose a {
  text-decoration: none;
}


/* ==========================================================================
   9. Cards
   ========================================================================== */

.card {
  background: var(--color-paper);
  border: 1px solid rgba(0, 0, 0, 0.08);
  border-radius: var(--radius-lg);
  padding: var(--space-6);
  transition: var(--transition-all);
}

.card:hover {
  border-color: var(--color-wicket-orange);
  box-shadow: var(--shadow-card-hover);
  transform: translateY(-2px);
}

.card-large {
  background: var(--color-paper);
  border: 1px solid rgba(0, 0, 0, 0.08);
  border-radius: var(--radius-lg);
  padding: var(--space-8);
  transition: var(--transition-all);
}

.card-large:hover {
  border-color: var(--color-wicket-orange);
  box-shadow: var(--shadow-card-hover);
  transform: translateY(-2px);
}

/* Card elements */
.card__icon {
  width: 2.5rem;               /* 40px — w-10 */
  height: 2.5rem;
  border-radius: var(--radius-lg);
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: var(--text-lg);
  margin-bottom: var(--space-3);
}

.card-large__icon {
  width: 3rem;                 /* 48px — w-12 */
  height: 3rem;
  border-radius: var(--radius-lg);
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: var(--text-2xl);
  margin-bottom: var(--space-4);
}

/* Icon color variants */
.card__icon--orange {
  background: linear-gradient(135deg, #2a2320, #3a3330);
  color: var(--color-wicket-orange);
}

.card__icon--green {
  background: linear-gradient(135deg, #1a2a1a, #2a3a2a);
  color: #8fbc6f;
}

.card__icon--blue {
  background: linear-gradient(135deg, #1a1a2a, #2a2a3a);
  color: #6db3ce;
}

.card__icon--red {
  background: linear-gradient(135deg, #2a1a1a, #3a2a2a);
  color: #ce6d6d;
}

.card__title {
  font-family: var(--font-display);
  font-size: var(--text-xl);
  font-weight: 700;
  color: var(--color-ink);
  margin-bottom: var(--space-2);
  transition: var(--transition-colors);
}

.card:hover .card__title,
.card-large:hover .card__title {
  color: var(--color-wicket-orange);
}

.card__text {
  font-size: var(--text-sm);
  color: var(--color-warm-mid);
  line-height: 1.7;
}

.card__small-title {
  font-family: var(--font-display);
  font-size: var(--text-base);
  font-weight: 700;
  color: var(--color-ink);
  margin-bottom: var(--space-1);
  transition: var(--transition-colors);
}

.card:hover .card__small-title {
  color: var(--color-wicket-orange);
}

.card__small-text {
  font-size: var(--text-xs);
  color: var(--color-warm-mid);
  line-height: 1.7;
}

/* Card as anchor (full-card link) */
a.card,
a.card-large {
  text-decoration: none;
  display: block;
}


/* ==========================================================================
   10. Feature Cards Grid
   ========================================================================== */

.feature-grid {
  display: grid;
  grid-template-columns: 1fr;
  gap: var(--space-10);
}

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

/* Section wrapper for feature cards */
.feature-section {
  background-color: var(--color-paper);
  padding: var(--space-20) var(--space-6);
}

@media (min-width: 768px) {
  .feature-section {
    padding-left: var(--space-12);
    padding-right: var(--space-12);
  }
}


/* ==========================================================================
   11. Code Showcase
   ========================================================================== */

.code-showcase {
  background-color: var(--color-charcoal);
  border-top: 3px solid var(--color-wicket-orange);
}

.code-showcase__header {
  padding: var(--space-10) var(--space-6) var(--space-6);
}

.code-showcase__header-label {
  font-family: var(--font-mono);
  font-size: 0.6875rem;         /* 11px */
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: rgba(255, 255, 255, 0.4);
  margin-bottom: var(--space-1);
}

.code-showcase__header-text {
  font-size: var(--text-sm);
  color: var(--color-code-text);
}

.code-showcase__panes {
  display: flex;
  flex-direction: column;
  border-top: 1px solid rgba(255, 255, 255, 0.06);
}

.code-showcase__pane {
  flex: 1;
  min-width: 0;
}

.code-showcase__pane:first-child {
  border-bottom: 1px solid rgba(255, 255, 255, 0.06);
}

.code-showcase__file-label {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  padding: var(--space-3) var(--space-6);
  border-bottom: 1px solid rgba(255, 255, 255, 0.06);
  background: rgba(255, 255, 255, 0.02);
}

.code-showcase__file-dot {
  width: 7px;
  height: 7px;
  border-radius: var(--radius-full);
  background-color: var(--color-wicket-orange);
  display: inline-block;
  flex-shrink: 0;
}

.code-showcase__file-name {
  font-family: var(--font-mono);
  font-size: 0.6875rem;         /* 11px */
  color: rgba(255, 255, 255, 0.25);
}

.code-showcase__code {
  padding: var(--space-6);
  overflow-x: auto;
}

.code-showcase__code pre {
  font-family: var(--font-mono);
  font-size: 0.8125rem;         /* 13px */
  line-height: 1.8;
  color: var(--color-code-text);
  margin: 0;
  background: none;
}

.code-showcase__code code {
  background: none;
  padding: 0;
  border-radius: 0;
  font-size: inherit;
}

/* Code syntax colors — applied via spans inside <pre> */
.code-keyword  { color: var(--color-code-keyword); }
.code-type     { color: var(--color-code-type); }
.code-builtin  { color: var(--color-code-builtin); }
.code-string   { color: var(--color-code-string); }
.code-annotation { color: var(--color-code-annotation); }

/* Highlighted line in code showcase */
.code-highlight {
  background: var(--color-code-highlight-bg);
  border-left: 2px solid var(--color-wicket-orange);
  margin-left: -0.75rem;
  padding-left: 0.625rem;
  display: inline-block;
  width: calc(100% + 0.75rem);
}

/* Caption bar */
.code-showcase__caption {
  padding: var(--space-5) var(--space-6);
  border-top: 1px solid rgba(255, 255, 255, 0.06);
  background: rgba(255, 255, 255, 0.02);
}

.code-showcase__caption p {
  font-family: var(--font-mono);
  font-size: var(--text-xs);
  color: rgba(255, 255, 255, 0.3);
  margin: 0;
}

@media (min-width: 768px) {
  .code-showcase__header {
    padding-left: var(--space-12);
    padding-right: var(--space-12);
  }

  .code-showcase__panes {
    flex-direction: row;
  }

  .code-showcase__pane:first-child {
    border-bottom: none;
    border-right: 1px solid rgba(255, 255, 255, 0.06);
  }

  .code-showcase__file-label {
    padding-left: var(--space-8);
    padding-right: var(--space-8);
  }

  .code-showcase__code {
    padding: var(--space-6) var(--space-8);
  }

  .code-showcase__code pre {
    font-size: 0.84375rem;      /* 13.5px */
  }

  .code-showcase__caption {
    padding-left: var(--space-12);
    padding-right: var(--space-12);
  }
}


/* ==========================================================================
   12. Community Stats
   ========================================================================== */

.community-stats {
  background-color: var(--color-paper-dim);
  padding: var(--space-20) var(--space-6);
  text-align: center;
  border-top: 1px solid rgba(0, 0, 0, 0.04);
  border-bottom: 1px solid rgba(0, 0, 0, 0.04);
}

.community-stats__grid {
  display: flex;
  flex-wrap: wrap;
  justify-content: center;
  gap: var(--space-12);
  margin-bottom: var(--space-6);
}

.community-stats__number {
  font-family: var(--font-display);
  font-size: var(--text-4xl);
  font-weight: 900;
  color: var(--color-ink);
}

.community-stats__number--orange {
  color: var(--color-wicket-orange);
}

.community-stats__label {
  font-size: var(--text-xs);
  letter-spacing: 0.05em;
  text-transform: uppercase;
  font-weight: 600;
  color: var(--color-warm-light);
  margin-top: var(--space-1);
}

.community-stats__link {
  font-size: var(--text-sm);
  font-weight: 500;
  color: var(--color-wicket-orange);
  text-decoration: none;
}

.community-stats__link:hover {
  text-decoration: underline;
}

@media (min-width: 768px) {
  .community-stats {
    padding-left: var(--space-12);
    padding-right: var(--space-12);
  }

  .community-stats__grid {
    gap: var(--space-16);
  }
}


/* ==========================================================================
   13. Quickstart Section
   ========================================================================== */

.quickstart {
  background-color: var(--color-paper);
  padding: var(--space-20) var(--space-6);
}

.quickstart__inner {
  display: flex;
  flex-direction: column;
  align-items: center;
  gap: var(--space-12);
  max-width: var(--max-w-5xl);
}

.quickstart__text {
  flex: 1;
}

.quickstart__text h3 {
  font-family: var(--font-display);
  font-size: var(--text-3xl);
  font-weight: 700;
  line-height: 1.3;
  margin-bottom: var(--space-3);
  color: var(--color-ink);
}

.quickstart__text p {
  font-size: 0.9375rem;         /* 15px */
  color: var(--color-warm-mid);
  line-height: 1.7;
  margin-bottom: var(--space-5);
}

.quickstart__terminal {
  flex: 1.2;
  width: 100%;
}

.quickstart__terminal-block {
  background-color: var(--color-ink);
  border-radius: var(--radius-lg);
  padding: var(--space-6);
  font-family: var(--font-mono);
  font-size: 0.8125rem;         /* 13px */
  color: var(--color-code-text);
  line-height: 1.8;
  border: 1px solid rgba(255, 255, 255, 0.06);
  overflow-x: auto;
}

.quickstart__terminal-block .prompt {
  color: var(--color-wicket-orange);
}

.quickstart__terminal-block .string {
  color: var(--color-code-string);
}

.quickstart__terminal-block .value {
  color: var(--color-code-type);
}

@media (min-width: 768px) {
  .quickstart {
    padding-left: var(--space-12);
    padding-right: var(--space-12);
  }

  .quickstart__inner {
    flex-direction: row;
  }
}


/* ==========================================================================
   14. Vitals Bar
   ========================================================================== */

.vitals-bar {
  background-color: var(--color-charcoal);
  padding: var(--space-10) var(--space-6);
  display: flex;
  flex-wrap: wrap;
  justify-content: center;
  gap: var(--space-12);
}

.vitals-bar__item {
  text-align: center;
}

.vitals-bar__value {
  font-family: var(--font-display);
  font-size: var(--text-3xl);
  font-weight: 900;
  color: #f5f0ea;
}

.vitals-bar__value--orange {
  color: var(--color-wicket-orange);
}

.vitals-bar__label {
  font-size: 0.6875rem;         /* 11px */
  letter-spacing: 0.05em;
  text-transform: uppercase;
  font-weight: 600;
  color: rgba(245, 240, 234, 0.35);
  margin-top: var(--space-1);
}

@media (min-width: 768px) {
  .vitals-bar {
    padding-left: var(--space-12);
    padding-right: var(--space-12);
    gap: var(--space-16);
  }
}


/* ==========================================================================
   15. Recent Posts
   ========================================================================== */

.recent-posts {
  background-color: var(--color-paper);
  padding: var(--space-20) var(--space-6);
}

.recent-posts__header {
  display: flex;
  align-items: baseline;
  justify-content: space-between;
  margin-bottom: var(--space-12);
  flex-wrap: wrap;
  gap: var(--space-4);
}

.recent-posts__header a {
  font-size: var(--text-sm);
  font-weight: 500;
  color: var(--color-wicket-orange);
  text-decoration: none;
}

.recent-posts__header a:hover {
  text-decoration: underline;
}

.recent-posts__grid {
  display: grid;
  grid-template-columns: 1fr;
  gap: var(--space-6);
}

/* Post card inside recent-posts */
.post-card {
  border: 1px solid rgba(0, 0, 0, 0.08);
  border-radius: var(--radius-lg);
  padding: var(--space-6);
  background: var(--color-paper);
  transition: var(--transition-all);
}

.post-card:hover {
  border-color: var(--color-wicket-orange);
  transform: translateY(-2px);
  box-shadow: var(--shadow-card-hover);
}

.post-card__date {
  font-size: var(--text-xs);
  color: var(--color-warm-light);
  font-weight: 500;
  margin-bottom: var(--space-2);
}

.post-card__title {
  font-family: var(--font-display);
  font-size: 1.0625rem;         /* 17px */
  font-weight: 700;
  color: var(--color-ink);
  line-height: 1.35;
  margin-bottom: var(--space-2);
}

.post-card__title a {
  color: var(--color-ink);
  text-decoration: none;
}

.post-card__title a:hover {
  color: var(--color-wicket-orange);
}

@media (min-width: 768px) {
  .recent-posts {
    padding-left: var(--space-12);
    padding-right: var(--space-12);
  }

  .recent-posts__grid {
    grid-template-columns: repeat(3, 1fr);
  }
}


/* ==========================================================================
   16. Footer
   ========================================================================== */

.site-footer {
  background-color: var(--color-ink);
  font-size: var(--text-xs);
}

.site-footer-inner {
  padding: var(--space-12) var(--space-6);
}

.site-footer-grid {
  display: flex;
  flex-wrap: wrap;
  justify-content: space-between;
  gap: var(--space-8);
  margin-bottom: var(--space-8);
  padding-bottom: var(--space-8);
  border-bottom: 1px solid rgba(255, 255, 255, 0.06);
}

.site-footer-column {
  min-width: 0;
}

.site-footer-heading {
  font-family: var(--font-display);
  font-size: 0.8125rem;         /* 13px */
  font-weight: 600;
  color: rgba(255, 255, 255, 0.7);
  margin-bottom: var(--space-3);
}

.site-footer-list {
  list-style: none;
  padding: 0;
  margin: 0;
}

.site-footer-list a {
  display: block;
  padding: 0.125rem 0;          /* py-0.5 */
  color: rgba(255, 255, 255, 0.35);
  text-decoration: none;
  transition: var(--transition-colors);
}

.site-footer-list a:hover {
  color: var(--color-wicket-orange);
}

.site-footer-bottom {
  display: flex;
  flex-wrap: wrap;
  align-items: flex-start;
  justify-content: space-between;
  gap: var(--space-6);
}

.site-footer-asf-notice {
  font-size: 0.6875rem;         /* 11px */
  color: rgba(255, 255, 255, 0.25);
  line-height: 1.7;
}

.site-footer-asf-notice a {
  color: rgba(255, 255, 255, 0.25);
  text-decoration: none;
}

.site-footer-event-banner {
  display: inline-block;
  opacity: 0.5;
  transition: opacity 0.2s ease;
}

.site-footer-event-banner:hover {
  opacity: 0.8;
}

.site-footer-event-image {
  height: 2.5rem;               /* h-10 */
}

@media (min-width: 768px) {
  .site-footer-inner {
    padding-left: var(--space-12);
    padding-right: var(--space-12);
  }
}


/* ==========================================================================
   17. Blog Post Layout
   ========================================================================== */

.blog-post-meta {
  margin-bottom: var(--space-4);
}

.blog-post-meta time {
  font-size: var(--text-sm);
  color: rgba(245, 240, 234, 0.4);
  display: block;
  margin-bottom: var(--space-2);
}

.blog-post-tags {
  display: flex;
  gap: var(--space-2);
  flex-wrap: wrap;
}

.blog-post-tag {
  display: inline-block;
  font-size: 0.625rem;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  font-weight: 600;
  padding: 0.125rem 0.5rem;
  border-radius: var(--radius-sm);
  background-color: rgba(232, 84, 46, 0.2);
  color: var(--color-wicket-orange-light);
}

.blog-post-author {
  font-size: var(--text-sm);
  color: rgba(245, 240, 234, 0.5);
  margin-top: var(--space-2);
}

.blog-post-divider {
  border: none;
  border-top: 1px solid rgba(0, 0, 0, 0.08);
  margin: 2em 0;
}

.blog-post-nav {
  display: flex;
  justify-content: space-between;
  gap: var(--space-6);
  flex-wrap: wrap;
}

.blog-post-nav-link {
  text-decoration: none;
  display: flex;
  flex-direction: column;
  gap: var(--space-1);
  transition: var(--transition-colors);
}

.blog-post-nav-link:hover .blog-post-nav-title {
  color: var(--color-wicket-orange);
}

.blog-post-nav-prev {
  text-align: left;
}

.blog-post-nav-next {
  text-align: right;
  margin-left: auto;
}

.blog-post-nav-label {
  font-size: var(--text-xs);
  color: var(--color-warm-light);
  font-weight: 500;
}

.blog-post-nav-title {
  font-size: var(--text-sm);
  font-weight: 600;
  color: var(--color-ink);
  transition: var(--transition-colors);
}

/* Blog index: older posts compact layout */
.blog-index__older-header {
  font-size: 0.6875rem;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  font-weight: 600;
  color: var(--color-warm-light);
  margin-bottom: var(--space-6);
}

.blog-index__compact-grid {
  display: grid;
  grid-template-columns: 1fr;
  gap: var(--space-4);
}

.blog-index__compact-item {
  display: flex;
  align-items: flex-start;
  gap: var(--space-4);
  padding: var(--space-4);
  border-radius: var(--radius-lg);
  transition: var(--transition-colors);
}

.blog-index__compact-item:hover {
  background-color: var(--color-paper-dim);
}

.blog-index__compact-date {
  flex-shrink: 0;
  width: 4rem;
  text-align: right;
  font-size: var(--text-xs);
  color: var(--color-warm-light);
  font-weight: 500;
}

.blog-index__compact-content {
  border-left: 2px solid rgba(0, 0, 0, 0.06);
  padding-left: var(--space-4);
  flex: 1;
}

.blog-index__compact-title {
  font-size: var(--text-sm);
  font-weight: 600;
  line-height: 1.35;
}

.blog-index__compact-title a {
  color: var(--color-ink);
  text-decoration: none;
}

.blog-index__compact-title a:hover {
  color: var(--color-wicket-orange);
}

.blog-index__pagination {
  margin-top: var(--space-8);
  padding-top: var(--space-8);
  border-top: 1px solid rgba(0, 0, 0, 0.06);
  text-align: center;
}

.blog-index__pagination p {
  font-size: var(--text-sm);
  color: var(--color-warm-mid);
}

@media (min-width: 768px) {
  .blog-index__compact-grid {
    grid-template-columns: repeat(2, 1fr);
  }
}


/* ==========================================================================
   18. Docs Layout
   ========================================================================== */

.docs-layout {
  display: flex;
  flex-direction: column;
  background-color: var(--color-paper);
  flex: 1;
}

/* --- Sidebar --- */

.docs-sidebar {
  background-color: var(--color-paper-dim);
  border-bottom: 1px solid rgba(0, 0, 0, 0.06);
  padding: var(--space-6);
  overflow-y: auto;
}

.docs-nav-section {
  margin-bottom: var(--space-5);
}

.docs-nav-section-title {
  font-family: var(--font-display);
  font-size: 0.6875rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--color-wicket-orange);
  margin-bottom: var(--space-2);
}

.docs-nav-list {
  list-style: none;
  padding: 0;
  margin: 0;
}

.docs-nav-group {
  margin-bottom: var(--space-2);
}

.docs-nav-group-title {
  font-size: 0.8125rem;
  font-weight: 600;
  color: var(--color-ink);
  padding: var(--space-1) 0;
  display: block;
}

.docs-nav-sublist {
  list-style: none;
  padding: 0 0 0 var(--space-3);
  margin: 0;
}

.docs-nav-link {
  display: block;
  padding: 0.2rem 0;
  font-size: 0.8125rem;
  color: var(--color-warm-mid);
  text-decoration: none;
  transition: var(--transition-colors);
}

.docs-nav-link:hover {
  color: var(--color-wicket-orange);
}

.docs-nav-link.active {
  color: var(--color-wicket-orange);
  font-weight: 600;
}

/* --- Main content area (header + prose) --- */

.docs-main {
  flex: 1;
  min-width: 0;
}

.docs-header {
  border-bottom: 1px solid rgba(0, 0, 0, 0.06);
  padding: var(--space-8) var(--space-6);
}

.docs-header h1 {
  font-family: var(--font-display);
  font-size: var(--text-3xl);
  font-weight: 700;
  color: var(--color-ink);
  margin: 0;
}

.docs-header-description {
  font-size: var(--text-sm);
  color: var(--color-warm-light);
  margin: var(--space-1) 0 0 0;
}

.docs-body {
  display: flex;
}

.docs-content {
  flex: 1;
  padding: var(--space-8) var(--space-6);
  min-width: 0;
}

/* --- Right-side TOC --- */

.docs-toc {
  display: none;  /* hidden on mobile */
}

.docs-toc-nav {
  position: sticky;
  top: var(--space-8);
}

.docs-toc-title {
  font-size: 0.6875rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--color-warm-light);
  margin: 0 0 var(--space-3) 0;
}

.docs-toc-list {
  list-style: none;
  padding: 0;
  margin: 0;
  border-left: 1px solid rgba(0, 0, 0, 0.06);
}

.docs-toc-item {
  margin: 0;
}

.docs-toc-item--nested {
  padding-left: var(--space-3);
}

.docs-toc-link {
  display: block;
  padding: 0.2rem 0 0.2rem var(--space-3);
  font-size: 0.75rem;
  color: var(--color-warm-light);
  text-decoration: none;
  border-left: 2px solid transparent;
  margin-left: -1px;
  transition: all 0.15s;
}

.docs-toc-link:hover {
  color: var(--color-warm-mid);
}

.docs-toc-link.active {
  color: var(--color-wicket-orange);
  border-left-color: var(--color-wicket-orange);
}

/* Two-column card grids inside docs */
.docs-grid-2 {
  display: grid;
  grid-template-columns: 1fr;
  gap: var(--space-6);
  margin-bottom: var(--space-12);
}

.docs-grid-4 {
  display: grid;
  grid-template-columns: 1fr;
  gap: var(--space-4);
}

@media (min-width: 768px) {
  .docs-header {
    padding: var(--space-10) var(--space-10);
  }

  .docs-content {
    padding: var(--space-8) var(--space-10);
  }
}

@media (min-width: 768px) {
  .docs-toc {
    display: block;
    width: 14rem;
    flex-shrink: 0;
    padding: var(--space-8) var(--space-4) var(--space-8) 0;
  }
}

@media (min-width: 1024px) {
  .docs-layout {
    flex-direction: row;
  }

  .docs-sidebar {
    width: 16rem;
    flex-shrink: 0;
    border-bottom: none;
    border-right: 1px solid rgba(0, 0, 0, 0.06);
    padding: var(--space-6);
    position: sticky;
    top: 0;
    max-height: 100vh;
  }

  /* TOC stays at 1024px+ when sidebar is also visible */

  .docs-grid-2 {
    grid-template-columns: repeat(2, 1fr);
  }

  .docs-grid-4 {
    grid-template-columns: repeat(4, 1fr);
  }
}

@media (min-width: 640px) and (max-width: 767px) {
  .docs-grid-4 {
    grid-template-columns: repeat(2, 1fr);
  }
}


/* ==========================================================================
   19. Tables
   ========================================================================== */

.data-table {
  width: 100%;
  font-size: var(--text-sm);
  overflow-x: auto;
  border: 1px solid rgba(0, 0, 0, 0.06);
  border-radius: var(--radius-lg);
}

.data-table table {
  width: 100%;
}

.data-table thead tr {
  background-color: var(--color-paper-dim);
  border-bottom: 1px solid rgba(0, 0, 0, 0.06);
}

.data-table th {
  padding: var(--space-3) var(--space-4);
  text-align: left;
  font-weight: 700;
  color: var(--color-ink);
}

.data-table tbody {
  background-color: var(--color-paper);
}

.data-table tbody tr {
  border-bottom: 1px solid rgba(0, 0, 0, 0.04);
  transition: var(--transition-colors);
}

.data-table tbody tr:last-child {
  border-bottom: none;
}

.data-table tbody tr:hover {
  background-color: var(--color-paper-dim);
}

.data-table td {
  padding: var(--space-3) var(--space-4);
}

.data-table td.mono {
  font-family: var(--font-mono);
}

.data-table td.orange {
  font-family: var(--font-mono);
  color: var(--color-wicket-orange);
  font-weight: 500;
}

/* Prose tables (for markdown content) */
.prose table {
  width: 100%;
  font-size: var(--text-sm);
  margin-bottom: 1.5em;
  border-collapse: collapse;
}

.prose thead tr {
  border-bottom: 2px solid rgba(0, 0, 0, 0.08);
}

.prose th {
  padding: var(--space-3) var(--space-4);
  text-align: left;
  font-weight: 700;
  color: var(--color-ink);
}

.prose td {
  padding: var(--space-3) var(--space-4);
  border-bottom: 1px solid rgba(0, 0, 0, 0.04);
}

.prose tbody tr:hover {
  background-color: var(--color-paper-dim);
}


/* ==========================================================================
   20. Buttons
   ========================================================================== */

.btn-primary {
  display: inline-block;
  background-color: var(--color-wicket-orange);
  color: #ffffff;
  padding: 0.9375rem 1.75rem;
  border-radius: var(--radius-lg);
  font-size: 0.9375rem;         /* 15px */
  font-weight: 600;
  text-decoration: none;
  transition: var(--transition-all);
  border: none;
  cursor: pointer;
}

.btn-primary:hover {
  background-color: var(--color-wicket-orange-light);
  transform: translateY(-2px);
  color: #ffffff;
}

.btn-secondary {
  display: inline-block;
  background: transparent;
  color: rgba(255, 255, 255, 0.8);
  padding: 0.9375rem 1.75rem;
  border-radius: var(--radius-lg);
  font-size: 0.9375rem;         /* 15px */
  font-weight: 500;
  text-decoration: none;
  transition: var(--transition-all);
  border: 1px solid rgba(255, 255, 255, 0.2);
  cursor: pointer;
}

.btn-secondary:hover {
  border-color: rgba(255, 255, 255, 0.5);
  color: #ffffff;
}

/* Link-style button (for use in content areas) */
.btn-link {
  display: inline-block;
  font-size: var(--text-sm);
  font-weight: 500;
  color: var(--color-wicket-orange);
  text-decoration: none;
}

.btn-link:hover {
  text-decoration: underline;
}


/* ==========================================================================
   21. Tag Badges
   ========================================================================== */

.tag {
  display: inline-block;
  font-size: 0.625rem;          /* 10px */
  text-transform: uppercase;
  letter-spacing: 0.05em;
  font-weight: 600;
  padding: 0.125rem 0.5rem;
  border-radius: var(--radius-sm);
}

.tag-release {
  background-color: var(--color-wicket-orange-glow);
  color: var(--color-wicket-orange);
}

.tag-security {
  background-color: var(--color-tag-security-bg);
  color: var(--color-tag-security-text);
}

.tag-community {
  background-color: var(--color-tag-community-bg);
  color: var(--color-tag-community-text);
}

/* Smaller variant for compact lists */
.tag--small {
  font-size: 0.5625rem;         /* 9px */
  padding: 0.125rem 0.375rem;
}

/* Light-on-dark variants (for header-band contexts) */
.tag-release--dark {
  background-color: rgba(232, 84, 46, 0.2);
  color: var(--color-wicket-orange-light);
}

.tag-security--dark {
  background-color: rgba(143, 188, 111, 0.2);
  color: #a8d88f;
}

.tag-community--dark {
  background-color: rgba(109, 179, 206, 0.2);
  color: #7cc3e0;
}

/* Status badges (for tables) */
.status-badge {
  display: inline-flex;
  align-items: center;
  padding: 0.125rem var(--space-2-5);
  border-radius: var(--radius-full);
  font-size: var(--text-xs);
  font-weight: 500;
}

.status-current {
  background-color: var(--color-status-current-bg);
  color: var(--color-status-current-text);
}

.status-supported {
  background-color: var(--color-status-supported-bg);
  color: var(--color-status-supported-text);
}

.status-security {
  background-color: var(--color-status-security-bg);
  color: var(--color-status-security-text);
}


/* ==========================================================================
   22. Responsive / Mobile
   ========================================================================== */

/* Utility: horizontal scroll container */
.overflow-x-auto {
  overflow-x: auto;
}

/* General grid layouts (2-col, 3-col) */
.grid-2 {
  display: grid;
  grid-template-columns: 1fr;
  gap: var(--space-6);
}

.grid-3 {
  display: grid;
  grid-template-columns: 1fr;
  gap: var(--space-6);
}

.grid-4 {
  display: grid;
  grid-template-columns: 1fr;
  gap: var(--space-4);
}

@media (min-width: 640px) {
  .grid-4 {
    grid-template-columns: repeat(2, 1fr);
  }
}

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

  .grid-3 {
    grid-template-columns: repeat(3, 1fr);
  }

  .grid-4 {
    grid-template-columns: repeat(4, 1fr);
  }
}

/* Stack all flex rows on mobile */
@media (max-width: 767px) {
  .vitals-bar {
    gap: var(--space-6);
    padding-top: var(--space-8);
    padding-bottom: var(--space-8);
  }

  .community-stats__grid {
    gap: var(--space-8);
  }

  /* Prevent hero title from being too large on small screens */
  .header-band__title {
    font-size: var(--text-4xl);
  }

  /* Make footer columns stack more gracefully */
  .site-footer-grid {
    flex-direction: column;
    gap: var(--space-6);
  }
}


/* ==========================================================================
   23. Utility Classes
   ========================================================================== */

/* Visually hidden (for accessibility) */
.sr-only {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
  border-width: 0;
}

/* Text alignment */
.text-center { text-align: center; }
.text-right  { text-align: right; }

/* Text colors */
.text-ink          { color: var(--color-ink); }
.text-warm-mid     { color: var(--color-warm-mid); }
.text-warm-light   { color: var(--color-warm-light); }
.text-orange       { color: var(--color-wicket-orange); }
.text-orange-light { color: var(--color-wicket-orange-light); }
.text-white        { color: #ffffff; }

/* Font families */
.font-display { font-family: var(--font-display); }
.font-mono    { font-family: var(--font-mono); }

/* Font weights */
.font-medium    { font-weight: 500; }
.font-semibold  { font-weight: 600; }
.font-bold      { font-weight: 700; }
.font-black     { font-weight: 900; }

/* Font sizes */
.text-xs  { font-size: var(--text-xs); }
.text-sm  { font-size: var(--text-sm); }
.text-lg  { font-size: var(--text-lg); }
.text-xl  { font-size: var(--text-xl); }
.text-2xl { font-size: var(--text-2xl); }
.text-3xl { font-size: var(--text-3xl); }
.text-4xl { font-size: var(--text-4xl); }

/* Spacing helpers */
.mt-1  { margin-top: var(--space-1); }
.mt-2  { margin-top: var(--space-2); }
.mt-3  { margin-top: var(--space-3); }
.mt-4  { margin-top: var(--space-4); }
.mt-8  { margin-top: var(--space-8); }
.mb-1  { margin-bottom: var(--space-1); }
.mb-2  { margin-bottom: var(--space-2); }
.mb-3  { margin-bottom: var(--space-3); }
.mb-4  { margin-bottom: var(--space-4); }
.mb-5  { margin-bottom: var(--space-5); }
.mb-6  { margin-bottom: var(--space-6); }
.mb-8  { margin-bottom: var(--space-8); }
.mb-12 { margin-bottom: var(--space-12); }

/* Space between children (vertical) */
.space-y-4 > * + * { margin-top: var(--space-4); }
.space-y-6 > * + * { margin-top: var(--space-6); }

/* Flex utilities */
.flex         { display: flex; }
.flex-wrap    { flex-wrap: wrap; }
.items-center { align-items: center; }
.items-start  { align-items: flex-start; }
.justify-between { justify-content: space-between; }
.justify-center  { justify-content: center; }
.gap-2 { gap: var(--space-2); }
.gap-3 { gap: var(--space-3); }
.gap-4 { gap: var(--space-4); }
.gap-6 { gap: var(--space-6); }

/* Display */
.hidden { display: none; }
.block  { display: block; }
.inline-block { display: inline-block; }

/* Misc */
.leading-relaxed { line-height: 1.7; }
.leading-snug    { line-height: 1.35; }
.leading-tight   { line-height: 1.2; }
.max-w-none      { max-width: none; }


/* ==========================================================================
   24. Docs Catalog Page
   ========================================================================== */

.docs-filter-bar {
  margin-bottom: var(--space-8);
}

.docs-search-input {
  width: 100%;
  padding: var(--space-3) var(--space-4);
  font-size: var(--text-sm);
  font-family: var(--font-body);
  border: 1px solid rgba(0, 0, 0, 0.1);
  border-radius: var(--radius-md);
  background: var(--color-paper);
  color: var(--color-ink);
  outline: none;
  transition: border-color 0.2s;
  margin-bottom: var(--space-3);
}

.docs-search-input:focus {
  border-color: var(--color-wicket-orange);
  box-shadow: 0 0 0 3px var(--color-wicket-orange-glow);
}

.docs-search-input::placeholder {
  color: var(--color-warm-light);
}

.docs-filter-tags {
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-2);
}

.docs-filter-tag {
  padding: var(--space-1) var(--space-3);
  font-size: 0.75rem;
  font-weight: 600;
  font-family: var(--font-body);
  text-transform: uppercase;
  letter-spacing: 0.05em;
  border: 1px solid rgba(0, 0, 0, 0.1);
  border-radius: 2rem;
  background: transparent;
  color: var(--color-warm-mid);
  cursor: pointer;
  transition: all 0.15s;
}

.docs-filter-tag:hover {
  border-color: var(--color-wicket-orange);
  color: var(--color-wicket-orange);
}

.docs-filter-tag.active {
  background: var(--color-wicket-orange);
  border-color: var(--color-wicket-orange);
  color: #ffffff;
}

.docs-section {
  margin-bottom: var(--space-10);
}

.docs-section-heading {
  font-family: var(--font-display);
  font-size: var(--text-xl);
  font-weight: 700;
  color: var(--color-ink);
  margin-bottom: var(--space-1);
  padding-bottom: var(--space-2);
  border-bottom: 2px solid rgba(0, 0, 0, 0.06);
}

.docs-section-description {
  font-size: var(--text-sm);
  color: var(--color-warm-light);
  margin-bottom: var(--space-4);
  margin-top: var(--space-1);
}

.docs-card-grid {
  display: grid;
  grid-template-columns: 1fr;
  gap: var(--space-3);
}

@media (min-width: 640px) {
  .docs-card-grid {
    grid-template-columns: repeat(2, 1fr);
  }
}

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

.docs-card {
  display: block;
  padding: var(--space-4) var(--space-5);
  border: 1px solid rgba(0, 0, 0, 0.08);
  border-radius: var(--radius-lg);
  background: var(--color-paper);
  text-decoration: none;
  transition: var(--transition-all);
}

.docs-card:hover {
  border-color: var(--color-wicket-orange);
  box-shadow: var(--shadow-card-hover);
  transform: translateY(-2px);
}

.docs-card-badge {
  display: inline-block;
  font-size: 0.625rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  padding: 0.125rem 0.5rem;
  border-radius: 2rem;
  margin-bottom: var(--space-2);
}

.docs-card-badge--tutorial {
  background: var(--color-wicket-orange-glow);
  color: var(--color-wicket-orange);
}

.docs-card-badge--howto {
  background: rgba(143, 188, 111, 0.15);
  color: #5a8a3c;
}

.docs-card-badge--reference {
  background: rgba(109, 179, 206, 0.15);
  color: #3a7a9a;
}

.docs-card-badge--explanation {
  background: rgba(180, 160, 210, 0.15);
  color: #7a5aaa;
}

.docs-card-title {
  font-family: var(--font-display);
  font-size: var(--text-base);
  font-weight: 700;
  color: var(--color-ink);
  margin-bottom: var(--space-1);
  line-height: 1.3;
}

.docs-card:hover .docs-card-title {
  color: var(--color-wicket-orange);
}

.docs-card-description {
  font-size: 0.8125rem;
  color: var(--color-warm-mid);
  line-height: 1.5;
  margin: 0;
}

/* Subcategory label shown on how-to cards */
.docs-card-subcategory-label {
  display: inline-block;
  font-size: 0.5625rem;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--color-warm-light);
  margin-bottom: var(--space-1);
  margin-left: var(--space-1);
}


/* ==========================================================================
   25. Docs Catalog — Subcategory Filter Pills
   ========================================================================== */

.docs-filter-subcategories {
  display: none;
  flex-wrap: wrap;
  gap: var(--space-2);
  margin-top: var(--space-3);
}

.docs-filter-subcategories.visible {
  display: flex;
}

.docs-filter-subtag {
  padding: var(--space-0-5) var(--space-2-5);
  font-size: 0.6875rem;
  font-weight: 600;
  font-family: var(--font-body);
  text-transform: uppercase;
  letter-spacing: 0.05em;
  border: 1px solid rgba(0, 0, 0, 0.08);
  border-radius: 2rem;
  background: transparent;
  color: var(--color-warm-mid);
  cursor: pointer;
  transition: all 0.15s;
}

.docs-filter-subtag:hover {
  border-color: var(--color-wicket-orange);
  color: var(--color-wicket-orange);
}

.docs-filter-subtag.active {
  background: var(--color-warm-dark);
  border-color: var(--color-warm-dark);
  color: #ffffff;
}

/* External resources section — always visible regardless of filters */
.docs-external-resources {
  margin-top: var(--space-10);
}


/* ==========================================================================
   26. Docs Sidebar — Mobile Collapse
   ========================================================================== */

/* The sidebar is now a <details> element.
   On mobile it acts as a collapsible; on desktop it's always open
   with the <summary> toggle hidden. */

.docs-sidebar-toggle {
  display: block;
  padding: var(--space-3) var(--space-4);
  font-family: var(--font-body);
  font-size: var(--text-sm);
  font-weight: 600;
  color: var(--color-ink);
  cursor: pointer;
  border-bottom: 1px solid rgba(0, 0, 0, 0.06);
  list-style: none;              /* remove default disclosure triangle */
  -webkit-user-select: none;
  user-select: none;
}

/* Remove the default marker in WebKit/Blink */
.docs-sidebar-toggle::-webkit-details-marker {
  display: none;
}

/* Custom chevron indicator */
.docs-sidebar-toggle::before {
  content: '';
  display: inline-block;
  width: 0.5rem;
  height: 0.5rem;
  border-right: 2px solid var(--color-warm-mid);
  border-bottom: 2px solid var(--color-warm-mid);
  transform: rotate(-45deg);
  margin-right: var(--space-2);
  transition: transform 0.2s;
}

.docs-sidebar[open] > .docs-sidebar-toggle::before {
  transform: rotate(45deg);
}

/* On mobile, start collapsed by removing the open attribute via JS.
   But we want it open by default on desktop (the `open` attr is in HTML). */

@media (max-width: 1023px) {
  .docs-sidebar {
    background-color: var(--color-paper-dim);
    border-bottom: 1px solid rgba(0, 0, 0, 0.06);
  }

  .docs-sidebar > .docs-nav {
    padding: var(--space-4) var(--space-6) var(--space-6);
  }
}

@media (min-width: 1024px) {
  /* Hide the toggle summary on wide screens */
  .docs-sidebar-toggle {
    display: none;
  }

  /* Ensure sidebar is always visible regardless of open state */
  .docs-sidebar,
  .docs-sidebar[open] {
    display: block;
    background-color: var(--color-paper-dim);
    width: 16rem;
    flex-shrink: 0;
    border-bottom: none;
    border-right: 1px solid rgba(0, 0, 0, 0.06);
    padding: var(--space-6);
    position: sticky;
    top: 0;
    max-height: 100vh;
    overflow-y: auto;
  }

  .docs-sidebar > .docs-nav {
    display: block;
  }
}


/* ==========================================================================
   Rouge Syntax Highlighting — Dark Theme
   ========================================================================== */

.highlight {
  background: var(--color-code-bg);
  border-radius: var(--radius-lg);
  border: 1px solid rgba(255, 255, 255, 0.06);
  overflow-x: auto;
  margin: 1.5rem 0;
}

.highlight pre {
  margin: 0;
  padding: 1.5rem;
  background: transparent;
  border: none;
  color: var(--color-code-text);
  font-size: 0.8125rem;
  line-height: 1.8;
}

.highlight code {
  background: none;
  padding: 0;
  border-radius: 0;
  color: inherit;
  font-size: inherit;
}

/* Prevent .prose pre from double-styling inside .highlight */
.prose .highlight pre {
  background: transparent;
  border: none;
  margin: 0;
  padding: 1.5rem;
}

.prose .highlight {
  margin: 1.5rem 0;
}

/* Keywords */
.highlight .k,
.highlight .kd,
.highlight .kn,
.highlight .kp,
.highlight .kr,
.highlight .kc,
.highlight .kv { color: #c49a6c; }

/* Keyword type */
.highlight .kt { color: #d4a07a; }

/* Types / classes / namespaces */
.highlight .nc,
.highlight .nn,
.highlight .no { color: #d4a07a; }

/* Built-in / methods / functions */
.highlight .nf,
.highlight .nb,
.highlight .bp { color: #6db3ce; }

/* Strings */
.highlight .s,
.highlight .s1,
.highlight .s2,
.highlight .se,
.highlight .sh,
.highlight .sx,
.highlight .sr { color: #8fbc6f; }

/* Annotations / decorators */
.highlight .nd,
.highlight .na { color: #b39ddb; }

/* Comments */
.highlight .c,
.highlight .c1,
.highlight .cm,
.highlight .cp,
.highlight .cs,
.highlight .ch { color: rgba(255, 255, 255, 0.35); font-style: italic; }

/* Operators / punctuation */
.highlight .o,
.highlight .p { color: #abb2bf; }

/* Numbers */
.highlight .mi,
.highlight .mf,
.highlight .mh,
.highlight .mo,
.highlight .mb,
.highlight .il { color: #d19a66; }

/* HTML tags */
.highlight .nt { color: #c49a6c; }

/* Variables */
.highlight .nv,
.highlight .vi,
.highlight .vc,
.highlight .vg { color: #d4a07a; }

/* Generic (diff output, etc.) */
.highlight .gd { color: #ce6d6d; }
.highlight .gi { color: #8fbc6f; }
.highlight .ge { font-style: italic; }
.highlight .gs { font-weight: bold; }

/* Error / warning */
.highlight .err { color: #ce6d6d; }

/* Line numbers (if present) */
.highlight .lineno {
  color: rgba(255, 255, 255, 0.2);
  padding-right: 1rem;
  user-select: none;
}


/* ==========================================================================
   Entrance Animations
   ========================================================================== */

/* slideInUp removed — replaced by diagonalRevealFull above */

/* --- Hero diagonal reveal --- */

@keyframes diagonalRevealFull {
  0% {
    clip-path: polygon(0 0, 0 0, 0 0);
  }
  70% {
    clip-path: polygon(0 0, 200% 0, 0 200%);
  }
  100% {
    clip-path: none;
  }
}

/* Hero items: fast diagonal reveal */
.hero-reveal__item {
  animation: diagonalRevealFull 0.5s cubic-bezier(0.22, 0.61, 0.36, 1) both;
  animation-delay: var(--reveal-delay, 0s);
}

/* All homepage sections: diagonal swipe */
.animate-in {
  animation: diagonalRevealFull 0.45s cubic-bezier(0.22, 0.61, 0.36, 1) both;
}

/* --- Sparkle effect on hero title --- */

.hero-sparkle {
  position: relative;
}

.hero-sparkle::before,
.hero-sparkle::after {
  content: '';
  position: absolute;
  border-radius: 50%;
  pointer-events: none;
}

/* Big glowing sparkle on the title */
.hero-sparkle::before {
  width: 5px;
  height: 5px;
  top: 10%;
  right: 5%;
  background: var(--color-wicket-orange-light);
  box-shadow:
    0 0 8px 3px var(--color-wicket-orange-light),
    0 0 24px 6px rgba(255, 122, 82, 0.4);
  animation: sparkle 2.5s ease-in-out 0.6s infinite;
}

/* Second sparkle near the italic emphasis */
.hero-sparkle::after {
  width: 4px;
  height: 4px;
  bottom: 15%;
  right: 20%;
  background: #f5f0ea;
  box-shadow:
    0 0 6px 2px rgba(245, 240, 234, 0.9),
    0 0 16px 4px rgba(245, 240, 234, 0.4);
  animation: sparkle 3s ease-in-out 1.2s infinite;
}

@keyframes sparkle {
  0%, 100% {
    opacity: 0;
    transform: scale(0) rotate(0deg);
  }
  15% {
    opacity: 1;
    transform: scale(1.2) rotate(20deg);
  }
  25% {
    opacity: 0.9;
    transform: scale(0.8) rotate(-10deg);
  }
  40% {
    opacity: 1;
    transform: scale(1.4) rotate(15deg);
  }
  55% {
    opacity: 0;
    transform: scale(0) rotate(-20deg);
  }
}

/* Sparkle field layer 1 — left margin, warm orange */
.hero-reveal::before {
  content: '';
  position: absolute;
  top: 0;
  left: 0;
  width: 100%;
  bottom: 0;
  pointer-events: none;
  z-index: 2;
  background-image:
    /* Left margin sparkles */
    radial-gradient(2.5px 2.5px at 3% 20%, rgba(255, 122, 82, 0.95) 50%, transparent 100%),
    radial-gradient(2px 2px at 8% 45%, rgba(255, 180, 120, 0.8) 50%, transparent 100%),
    radial-gradient(1.5px 1.5px at 5% 70%, rgba(255, 122, 82, 0.7) 50%, transparent 100%),
    radial-gradient(3px 3px at 12% 30%, rgba(255, 160, 100, 0.9) 50%, transparent 100%),
    radial-gradient(1px 1px at 2% 55%, rgba(255, 180, 120, 0.6) 50%, transparent 100%),
    radial-gradient(2px 2px at 10% 85%, rgba(255, 122, 82, 0.75) 50%, transparent 100%),
    radial-gradient(1.5px 1.5px at 7% 10%, rgba(255, 160, 100, 0.65) 50%, transparent 100%),
    /* Right margin sparkles */
    radial-gradient(2.5px 2.5px at 92% 25%, rgba(255, 122, 82, 0.9) 50%, transparent 100%),
    radial-gradient(2px 2px at 97% 50%, rgba(255, 180, 120, 0.85) 50%, transparent 100%),
    radial-gradient(1.5px 1.5px at 88% 75%, rgba(255, 122, 82, 0.7) 50%, transparent 100%),
    radial-gradient(3px 3px at 95% 15%, rgba(255, 160, 100, 0.8) 50%, transparent 100%),
    radial-gradient(1px 1px at 90% 60%, rgba(255, 180, 120, 0.6) 50%, transparent 100%),
    radial-gradient(2px 2px at 85% 40%, rgba(255, 122, 82, 0.75) 50%, transparent 100%),
    radial-gradient(1.5px 1.5px at 98% 80%, rgba(255, 160, 100, 0.7) 50%, transparent 100%);
  animation: sparkleField1 3s ease-in-out 0.4s infinite;
}

/* Sparkle field layer 2 — margins, cool white/cream, offset timing */
.hero-reveal::after {
  content: '';
  position: absolute;
  top: 0;
  left: 0;
  width: 100%;
  bottom: 0;
  pointer-events: none;
  z-index: 2;
  background-image:
    /* Left margin */
    radial-gradient(2px 2px at 6% 35%, rgba(245, 240, 234, 0.85) 50%, transparent 100%),
    radial-gradient(1.5px 1.5px at 2% 60%, rgba(255, 220, 200, 0.7) 50%, transparent 100%),
    radial-gradient(2.5px 2.5px at 11% 15%, rgba(245, 240, 234, 0.75) 50%, transparent 100%),
    radial-gradient(1px 1px at 4% 80%, rgba(255, 220, 200, 0.6) 50%, transparent 100%),
    radial-gradient(2px 2px at 9% 50%, rgba(245, 240, 234, 0.8) 50%, transparent 100%),
    radial-gradient(1.5px 1.5px at 1% 25%, rgba(255, 220, 200, 0.65) 50%, transparent 100%),
    /* Right margin */
    radial-gradient(2px 2px at 93% 30%, rgba(245, 240, 234, 0.8) 50%, transparent 100%),
    radial-gradient(1.5px 1.5px at 86% 55%, rgba(255, 220, 200, 0.75) 50%, transparent 100%),
    radial-gradient(2.5px 2.5px at 98% 70%, rgba(245, 240, 234, 0.7) 50%, transparent 100%),
    radial-gradient(1px 1px at 91% 20%, rgba(255, 220, 200, 0.6) 50%, transparent 100%),
    radial-gradient(2px 2px at 84% 85%, rgba(245, 240, 234, 0.8) 50%, transparent 100%),
    radial-gradient(1.5px 1.5px at 96% 45%, rgba(255, 220, 200, 0.7) 50%, transparent 100%);
  animation: sparkleField2 3.5s ease-in-out 1.5s infinite;
}

@keyframes sparkleField1 {
  0%, 100% { opacity: 0; }
  12% { opacity: 1; }
  30% { opacity: 0.5; }
  45% { opacity: 0.95; }
  60% { opacity: 0.3; }
  75% { opacity: 0; }
}

@keyframes sparkleField2 {
  0%, 100% { opacity: 0; }
  8% { opacity: 0.7; }
  25% { opacity: 1; }
  40% { opacity: 0.4; }
  55% { opacity: 0.85; }
  70% { opacity: 0; }
}

/* Respect reduced motion preferences */
@media (prefers-reduced-motion: reduce) {
  .animate-in,
  .hero-reveal__item,
  .hero-sparkle::before,
  .hero-sparkle::after,
  .hero-reveal::before,
  .hero-reveal::after {
    animation: none;
    clip-path: none;
    opacity: 1;
    transform: none;
  }
}