/**
 * PYQ Master - Bootstrap Overrides (Canonical)
 * 
 * CSS Contract: This file contains ONLY truly needed overrides for:
 * - Layout: Container widths, section spacing, navbar consistency
 * - Components: Card, button, form control styling
 * - Utilities: Typography, spacing normalization
 * 
 * DO NOT add:
 * - Duplicate Bootstrap functionality (use utility classes instead)
 * - Page-specific styles (use page-specific CSS files)
 * - Mobile-native framework styles (use mobile-specific CSS files)
 * 
 * Version: 1.0.0
 * Last Updated: 2025-01-XX
 */

/* ===================================
   CSS VARIABLES (Design Tokens)
   =================================== */

:root {
    /* Typography */
    --kkg-font-sans: "Inter", "Segoe UI", system-ui, -apple-system, BlinkMacSystemFont, sans-serif;
    --kkg-heading-weight: 600;
    --kkg-body-line-height: 1.65;
    --kkg-heading-line-height: 1.25;
    
    /* Colors */
    --kkg-body-color: #1f2937;
    --kkg-heading-color: #0f172a;
    --kkg-muted-color: #64748b;
    --kkg-border-color: #e2e8f0;
    --kkg-border-soft: rgba(15, 23, 42, 0.08);
    --kkg-surface-bg: #ffffff;
    --kkg-surface-muted: #f8fafc;
    --kkg-card-shadow: 0 0.5rem 1.5rem rgba(15, 23, 42, 0.08);
    
    /* Spacing */
    --kkg-section-gap: clamp(1rem, 2.5vw, 2.25rem);
    --kkg-spacing-unit: 1rem;
    
    /* Bootstrap Variable Overrides */
    --bs-body-font-family: var(--kkg-font-sans);
    --bs-body-color: var(--kkg-body-color);
    --bs-body-bg: var(--kkg-surface-bg);
    --bs-heading-color: var(--kkg-heading-color);
    --bs-border-color: var(--kkg-border-color);
    --bs-border-radius: 0.65rem;
    --bs-border-radius-lg: 0.85rem;
    --bs-border-radius-xl: 1rem;
    --bs-card-bg: var(--kkg-surface-bg);
    --bs-card-border-color: var(--kkg-border-soft);
}

/* UI Safe Mode Variants */
body[data-ui-safe-mode="on"] {
    --bs-btn-padding-y: 0.625rem;
    --bs-btn-padding-x: 1rem;
    --bs-btn-font-weight: 600;
}

body[data-ui-safe-mode="off"] {
    --kkg-card-shadow: 0 0.75rem 2.25rem rgba(15, 23, 42, 0.12);
    --bs-btn-padding-y: 0.7rem;
    --bs-btn-padding-x: 1.15rem;
    --bs-btn-font-weight: 600;
    --bs-border-radius: 0.75rem;
    --bs-border-radius-lg: 1rem;
}

/* Dark Mode Support */
[data-bs-theme="dark"] {
    --kkg-body-color: #adb5bd;
    --kkg-heading-color: #fff;
    --kkg-border-color: #495057;
    --kkg-surface-bg: #212529;
    --kkg-surface-muted: #343a40;
    --bs-body-bg: #212529;
    --bs-body-color: #adb5bd;
    --bs-border-color: #495057;
    --bs-secondary-bg: #343a40;
    --bs-heading-color: #fff;
}

/* ===================================
   TYPOGRAPHY
   =================================== */

body {
    font-family: var(--kkg-font-sans);
    line-height: var(--kkg-body-line-height);
    color: var(--kkg-body-color);
}

h1, .h1,
h2, .h2,
h3, .h3,
h4, .h4,
h5, .h5,
h6, .h6 {
    font-weight: var(--kkg-heading-weight);
    line-height: var(--kkg-heading-line-height);
    color: var(--kkg-heading-color);
    margin-bottom: calc(var(--kkg-spacing-unit) * 0.5);
}

p, .lead {
    margin-bottom: calc(var(--kkg-spacing-unit) * 0.75);
    color: var(--kkg-body-color);
}

/* ===================================
   LAYOUT (Container & Spacing)
   =================================== */

.container,
.container-fluid {
    padding-left: 1.25rem;
    padding-right: 1.25rem;
}

/* Consistent container max-width */
@media (min-width: 992px) {
    .container,
    .container-lg,
    .container-xl,
    .container-xxl {
        max-width: 1140px;
    }
}

/* Section spacing consistency */
section,
.kkg-section,
[data-ds="true"] .section {
    padding-top: var(--kkg-section-gap);
    padding-bottom: var(--kkg-section-gap);
}

.section {
    padding-block: clamp(0.75rem, 2vw, 1.5rem);
    margin-bottom: clamp(0.75rem, 1.5vw, 1.25rem);
}

.section:last-of-type,
.section[data-hide-spacing="true"] {
    margin-bottom: 0;
    padding-bottom: clamp(0.5rem, 1vw, 1rem);
}

.section + .section,
.section + .kkg-section,
.kkg-section + .section {
    margin-top: clamp(0.5rem, 1.5vw, 1rem);
}

hr.section-divider,
hr.divider {
    margin-block: clamp(1rem, 3vw, 2rem);
    max-width: 1200px;
    border-color: var(--kkg-border-soft);
    opacity: 1;
}

/* ===================================
   COMPONENTS (Card, Button, Form)
   =================================== */

/* Cards */
.card {
    border-radius: var(--bs-border-radius-lg);
    border: 1px solid var(--bs-card-border-color);
    box-shadow: var(--kkg-card-shadow);
    background-color: var(--bs-card-bg);
}

.card-header,
.card-footer {
    background: var(--bs-card-bg);
    border-color: var(--kkg-border-soft);
}

/* Buttons */
.btn {
    border-radius: var(--bs-border-radius);
    font-weight: var(--bs-btn-font-weight);
    padding: var(--bs-btn-padding-y) var(--bs-btn-padding-x);
    letter-spacing: 0.01em;
    min-height: 44px; /* Touch target optimization */
}

.btn-primary {
    background-image: linear-gradient(135deg, #2563eb, #3b82f6);
    border: none;
}

.btn-secondary {
    color: var(--kkg-heading-color);
    background-color: #e2e8f0;
    border-color: #cbd5f5;
}

.btn-outline-primary {
    border-width: 2px;
}

/* Forms */
.form-label {
    font-weight: 600;
    color: var(--kkg-heading-color);
}

.form-control,
.form-select {
    border-radius: var(--bs-border-radius);
    border-color: var(--bs-border-color);
    box-shadow: none;
    min-height: 44px; /* Touch target optimization */
    padding: 0.625rem 0.875rem;
}

.form-control:focus,
.form-select:focus {
    border-color: #2563eb;
    box-shadow: 0 0 0 0.2rem rgba(37, 99, 235, 0.15);
}

/* Alerts */
.alert {
    border-radius: var(--bs-border-radius);
}

/* Modals */
.modal-content {
    border-radius: var(--bs-border-radius-lg);
}

/* List Groups */
.list-group-item {
    padding-top: 0.875rem;
    padding-bottom: 0.875rem;
}

/* ===================================
   NAVBAR CONSISTENCY
   =================================== */

.navbar {
    border-bottom: 1px solid var(--kkg-border-soft);
}

[data-bs-theme="dark"] .navbar-dark {
    background-color: var(--bs-dark) !important;
}

/* ===================================
   UTILITIES
   =================================== */

.text-white-75 {
    color: rgba(255, 255, 255, 0.75) !important;
}

