/* ============================================================
   AMAN BHUTANI DESIGN SYSTEM — SPACING, RADIUS & SHADOW TOKENS
   Base unit: 4px — scale follows named t-shirt sizes
   ============================================================ */

:root {
  /* ── Spacing Scale ────────────────────────────────────── */
  --space-1:  4px;    /* xs — icon gaps, tight inline */
  --space-2:  8px;    /* sm — tag padding, small gaps */
  --space-3:  12px;   /* — badge/pill padding */
  --space-4:  16px;   /* md — form padding, button padding */
  --space-5:  20px;   /* — card body padding (small) */
  --space-6:  24px;   /* lg — card body, section gaps */
  --space-8:  32px;   /* xl — nav padding, grid gaps */
  --space-10: 40px;   /* 2xl — section spacing (tight) */
  --space-12: 48px;   /* — section subtitle margin */
  --space-16: 64px;   /* 3xl — generous section padding */
  --space-20: 80px;   /* 4xl — section vertical rhythm */
  --space-24: 96px;   /* — hero padding bottom */
  --space-32: 128px;  /* 5xl — max section vertical padding */

  /* ── Border Radius ────────────────────────────────────── */
  --radius-xs:   3px;     /* Section labels, tag corners */
  --radius-sm:   6px;     /* Small buttons, form inputs */
  --radius-md:   12px;    /* Cards (small), icon containers, inputs */
  --radius-lg:   20px;    /* Work cards, case study cards, main cards */
  --radius-xl:   32px;    /* Large decorative containers */
  --radius-full: 9999px;  /* Pills, badges, filter buttons, avatar */

  /* ── Shadows ──────────────────────────────────────────── */
  /* Note: card/hover shadows are theme-sensitive (see colors.css) */
  --shadow-sm:     0 1px 2px rgba(0, 0, 0, 0.05);
  --shadow-md:     0 4px 12px rgba(0, 0, 0, 0.08);
  --shadow-lg:     0 8px 24px rgba(0, 0, 0, 0.12);
  --shadow-focus:  0 0 0 3px var(--accent-glow);   /* Focus ring */
  --shadow-glow:   0 4px 12px rgba(26, 86, 219, 0.25); /* Accent glow on CTA */

  /* ── Layout ───────────────────────────────────────────── */
  --max-width:       1200px;
  --max-width-prose: 680px;
  --max-width-narrow: 640px;
  --sidebar-width:   280px;

  /* ── Z-index Scale ────────────────────────────────────── */
  --z-base:       0;     /* @kind other */
  --z-above:      1;     /* @kind other */
  --z-dropdown:   100;   /* @kind other */
  --z-sticky:     500;   /* @kind other */
  --z-nav:        1000;  /* @kind other */
  --z-modal:      5000;  /* @kind other */
  --z-cursor:     10000; /* @kind other */
}

/* ============================================================
   COMPONENT SPACING PATTERNS
   Documented conventions for reusable spacing relationships that
   aren't a single token but a rule about how tokens combine.
   Implemented per-page (see each page's <style> block) since the
   site has no shared stylesheet across pages yet — reproduce the
   rule below verbatim rather than inventing a new gap value.
   ============================================================ */

/* Sub-section label — a badge (.section-label) introducing a block
   WITHIN a section, as distinct from a top-level heading pair
   (.section-label + .section-title), which needs no extra margin.
   Example: "Awards & Recognition", "Certifications", "Career Journey",
   "Speaking & Links" inside the About section on index.html.

   Rule:
   - Gap ABOVE the badge, separating it from the block before it:
     --space-10 (40px), applied as margin-top on the badge itself.
   - Gap BELOW the badge, to the content that follows: comes from
     .section-label's own margin-bottom (--space-4, 16px) — do not
     add a second margin-top on the content wrapper; the two would
     collapse to whichever is larger and mask a future regression.
   - --flush variant (margin-top: 0): for a sub-section badge that
     must sit flush with a sibling column at the same grid row (e.g.
     a two-column layout with align-items:start, where the badge is
     the first element of the second column and must align with the
     first line of the first column). Restore the standard --space-10
     gap once the layout stacks to a single column on mobile — a
     flush top there crowds the badge against whatever preceded it.

   CSS:
     .subsection-label { margin-top: var(--space-10); }
     .subsection-label--flush { margin-top: 0; }
     @media (max-width:768px) {
       .subsection-label--flush { margin-top: var(--space-10); }
     }
   ============================================================ */
