/**
 * BitHub Africa Design System - Brand Tokens
 * Single source of truth for all design values
 *
 * @package BitHub_Archive
 * @since 1.0.0
 */

:root {
    /* =========================================
       OFFICIAL BITHUB AFRICA COLORS
       ========================================= */
    --bh-brown-light: #bd5603;      /* Primary accent - buttons, links, highlights */
    --bh-brown-dark: #4f2506;       /* Deep accent - headers, dark surfaces */
    --bh-pink: #FED09E;             /* Afro Pink - secondary highlights, badges */
    --bh-cream: #fffef8;            /* Light text, light backgrounds */
    --bh-dark: #2a1a0a;             /* Dark backgrounds, body bg */

    /* =========================================
       RGB VALUES FOR RGBA USAGE
       ========================================= */
    --bh-brown-light-rgb: 189, 86, 3;
    --bh-brown-dark-rgb: 79, 37, 6;
    --bh-pink-rgb: 254, 208, 158;
    --bh-cream-rgb: 255, 254, 248;
    --bh-dark-rgb: 42, 26, 10;

    /* =========================================
       SEMANTIC COLOR ALIASES
       ========================================= */
    --color-primary: var(--bh-brown-light);
    --color-secondary: var(--bh-brown-dark);
    --color-accent: var(--bh-pink);
    --color-background: var(--bh-dark);
    --color-surface: rgba(var(--bh-brown-dark-rgb), 0.85);
    --color-text: var(--bh-cream);
    --color-text-muted: rgba(var(--bh-pink-rgb), 0.7);
    --color-border: rgba(var(--bh-pink-rgb), 0.2);

    /* =========================================
       TYPOGRAPHY
       ========================================= */
    --font-primary: 'Plus Jakarta Sans', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
    --font-display: 'Space Grotesk', var(--font-primary);
    --font-mono: 'SF Mono', 'Monaco', 'Consolas', monospace;

    /* Font sizes - using fluid typography */
    --text-xs: clamp(0.75rem, 0.7rem + 0.25vw, 0.875rem);
    --text-sm: clamp(0.875rem, 0.8rem + 0.375vw, 1rem);
    --text-base: clamp(1rem, 0.9rem + 0.5vw, 1.125rem);
    --text-lg: clamp(1.125rem, 1rem + 0.625vw, 1.25rem);
    --text-xl: clamp(1.25rem, 1.1rem + 0.75vw, 1.5rem);
    --text-2xl: clamp(1.5rem, 1.25rem + 1.25vw, 2rem);
    --text-3xl: clamp(1.875rem, 1.5rem + 1.875vw, 2.5rem);
    --text-4xl: clamp(2.25rem, 1.75rem + 2.5vw, 3rem);
    --text-5xl: clamp(3rem, 2rem + 5vw, 4.5rem);

    /* Font weights */
    --font-light: 300;
    --font-normal: 400;
    --font-medium: 500;
    --font-semibold: 600;
    --font-bold: 700;
    --font-extrabold: 800;

    /* Line heights */
    --leading-tight: 1.25;
    --leading-normal: 1.5;
    --leading-relaxed: 1.75;

    /* =========================================
       SPACING SCALE
       ========================================= */
    --space-px: 1px;
    --space-0: 0;
    --space-1: 0.25rem;   /* 4px */
    --space-2: 0.5rem;    /* 8px */
    --space-3: 0.75rem;   /* 12px */
    --space-4: 1rem;      /* 16px */
    --space-5: 1.25rem;   /* 20px */
    --space-6: 1.5rem;    /* 24px */
    --space-8: 2rem;      /* 32px */
    --space-10: 2.5rem;   /* 40px */
    --space-12: 3rem;     /* 48px */
    --space-16: 4rem;     /* 64px */
    --space-20: 5rem;     /* 80px */
    --space-24: 6rem;     /* 96px */
    --space-32: 8rem;     /* 128px */

    /* Semantic spacing */
    --space-xs: var(--space-1);
    --space-sm: var(--space-2);
    --space-md: var(--space-4);
    --space-lg: var(--space-8);
    --space-xl: var(--space-16);
    --space-2xl: var(--space-32);

    /* =========================================
       BORDER RADIUS
       ========================================= */
    --radius-sm: 0.25rem;   /* 4px */
    --radius-md: 0.5rem;    /* 8px */
    --radius-lg: 1rem;      /* 16px */
    --radius-xl: 1.5rem;    /* 24px */
    --radius-2xl: 2rem;     /* 32px */
    --radius-full: 9999px;

    /* =========================================
       GLASSMORPHISM EFFECTS
       ========================================= */
    --glass-bg: rgba(var(--bh-brown-dark-rgb), 0.85);
    --glass-bg-light: rgba(var(--bh-brown-dark-rgb), 0.6);
    --glass-border: rgba(var(--bh-pink-rgb), 0.2);
    --glass-border-hover: rgba(var(--bh-pink-rgb), 0.4);
    --glass-blur: blur(10px);
    --glass-blur-heavy: blur(20px);

    /* =========================================
       SHADOWS
       ========================================= */
    --shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.2);
    --shadow-md: 0 4px 6px rgba(0, 0, 0, 0.25);
    --shadow-lg: 0 10px 25px rgba(0, 0, 0, 0.3);
    --shadow-xl: 0 20px 40px rgba(0, 0, 0, 0.4);
    --shadow-glow: 0 0 30px rgba(var(--bh-brown-light-rgb), 0.3);
    --shadow-glow-lg: 0 0 60px rgba(var(--bh-brown-light-rgb), 0.4);
    --shadow-inner: inset 0 2px 4px rgba(0, 0, 0, 0.2);

    /* =========================================
       TRANSITIONS
       ========================================= */
    --ease-default: cubic-bezier(0.4, 0, 0.2, 1);
    --ease-in: cubic-bezier(0.4, 0, 1, 1);
    --ease-out: cubic-bezier(0, 0, 0.2, 1);
    --ease-bounce: cubic-bezier(0.68, -0.55, 0.265, 1.55);

    --transition-fast: 150ms var(--ease-default);
    --transition-base: 300ms var(--ease-default);
    --transition-slow: 500ms var(--ease-default);
    --transition-slower: 700ms var(--ease-default);

    /* =========================================
       Z-INDEX SCALE
       ========================================= */
    --z-below: -1;
    --z-base: 0;
    --z-above: 1;
    --z-dropdown: 100;
    --z-sticky: 200;
    --z-fixed: 300;
    --z-modal-backdrop: 400;
    --z-modal: 500;
    --z-popover: 600;
    --z-tooltip: 700;
    --z-toast: 800;
    --z-max: 9999;

    /* =========================================
       CONTAINER WIDTHS
       ========================================= */
    --container-sm: 640px;
    --container-md: 768px;
    --container-lg: 1024px;
    --container-xl: 1280px;
    --container-2xl: 1400px;

    /* =========================================
       BREAKPOINTS (for reference in media queries)
       ========================================= */
    /*
     * --bp-xs: 475px   (mobile landscape)
     * --bp-sm: 576px   (small devices)
     * --bp-md: 768px   (tablets)
     * --bp-lg: 1024px  (laptops)
     * --bp-xl: 1280px  (desktops)
     * --bp-2xl: 1536px (large desktops)
     */
}

/* =========================================
   DARK MODE (default for archive site)
   ========================================= */
body,
.bh-dark {
    background-color: var(--color-background);
    color: var(--color-text);
}

/* =========================================
   REDUCED MOTION SUPPORT
   ========================================= */
@media (prefers-reduced-motion: reduce) {
    *,
    *::before,
    *::after {
        animation-duration: 0.01ms !important;
        animation-iteration-count: 1 !important;
        transition-duration: 0.01ms !important;
        scroll-behavior: auto !important;
    }
}

/* =========================================
   COLOR VALIDATION RULES
   =========================================

   ALLOWED COLORS:
   - var(--bh-*) tokens
   - rgba(var(--bh-*-rgb), x) for opacity
   - #000000, #ffffff (pure black/white)
   - transparent, currentColor, inherit

   FORBIDDEN COLORS (Bootstrap/newsup legacy):
   - #E67E22, #F39C12, #D35400 (orange variants)
   - #f8f9fa, #6c757d (Bootstrap grays)
   - #3498db, #9b59b6, #2ecc71 (other Bootstrap)

   AUDIT COMMAND:
   grep -rn "#E67E22\|#F39C12\|#D35400\|#f8f9fa\|#6c757d" ./

   ========================================= */