/*
Theme Name:  KTVC Theme
Theme URI:   https://ktvc.ac.ke
Author:      Kipkabus Technical and Vocational College
Author URI:  https://ktvc.ac.ke
Description: A modern, fast, mobile-responsive WordPress theme for Kipkabus Technical and Vocational College (KTVC). Built with classic PHP architecture, SEO best practices, and full plugin compatibility.
Version:     1.0.0
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
License:     GNU General Public License v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Text Domain: ktvc-theme
Tags:        education, college, tvet, responsive, custom-colors, custom-logo, custom-menu, featured-images, full-width-template, post-formats, sticky-post, threaded-comments, translation-ready
*/

/* ==========================================================================
   1. CSS CUSTOM PROPERTIES (Design Tokens)
   ========================================================================== */
:root {
    /* Brand Colors */
    --color-primary:        #780403;
    --color-primary-dark:   #560302;
    --color-primary-light:  #9a0504;
    --color-secondary:      #f1af09;
    --color-secondary-dark: #c98f05;
    --color-secondary-light:#f5c33a;

    /* Neutrals */
    --color-white:          #ffffff;
    --color-off-white:      #f8f8f8;
    --color-light-gray:     #f0f0f0;
    --color-mid-gray:       #d0d0d0;
    --color-text-muted:     #6b7280;
    --color-text:           #1f2937;
    --color-heading:        #111827;
    --color-dark:           #0f172a;

    /* Semantic */
    --color-success:        #16a34a;
    --color-warning:        #d97706;
    --color-danger:         #dc2626;
    --color-info:           #2563eb;

    /* Typography */
    --font-heading:         'Montserrat', 'Segoe UI', system-ui, sans-serif;
    --font-body:            'Open Sans', 'Segoe UI', system-ui, sans-serif;
    --font-mono:            'Courier New', Courier, monospace;

    --text-xs:   0.75rem;    /* 12px */
    --text-sm:   0.875rem;   /* 14px */
    --text-base: 1rem;       /* 16px */
    --text-lg:   1.125rem;   /* 18px */
    --text-xl:   1.25rem;    /* 20px */
    --text-2xl:  1.5rem;     /* 24px */
    --text-3xl:  1.875rem;   /* 30px */
    --text-4xl:  2.25rem;    /* 36px */
    --text-5xl:  3rem;       /* 48px */

    --font-normal: 400;
    --font-medium: 500;
    --font-semi:   600;
    --font-bold:   700;
    --font-black:  900;

    --leading-tight:  1.25;
    --leading-normal: 1.6;
    --leading-loose:  1.8;

    /* Spacing */
    --space-1:  0.25rem;
    --space-2:  0.5rem;
    --space-3:  0.75rem;
    --space-4:  1rem;
    --space-5:  1.25rem;
    --space-6:  1.5rem;
    --space-8:  2rem;
    --space-10: 2.5rem;
    --space-12: 3rem;
    --space-16: 4rem;
    --space-20: 5rem;
    --space-24: 6rem;

    /* Layout */
    --container-sm:  640px;
    --container-md:  768px;
    --container-lg:  1024px;
    --container-xl:  1280px;
    --container-2xl: 1400px;
    --container-pad: 1.25rem;

    /* Borders */
    --radius-sm:   4px;
    --radius-md:   8px;
    --radius-lg:   12px;
    --radius-xl:   16px;
    --radius-full: 9999px;
    --border-width: 1px;
    --border-color: #e5e7eb;

    /* Shadows */
    --shadow-sm:  0 1px 3px rgba(0,0,0,.08), 0 1px 2px rgba(0,0,0,.06);
    --shadow-md:  0 4px 6px rgba(0,0,0,.07), 0 2px 4px rgba(0,0,0,.06);
    --shadow-lg:  0 10px 25px rgba(0,0,0,.1),  0 4px 6px rgba(0,0,0,.05);
    --shadow-xl:  0 20px 40px rgba(0,0,0,.12);
    --shadow-primary: 0 4px 20px rgba(120,4,3,.25);

    /* Transitions */
    --transition-fast:   150ms ease;
    --transition-base:   250ms ease;
    --transition-slow:   400ms ease;

    /* Z-index layers */
    --z-below:    -1;
    --z-base:      0;
    --z-raised:   10;
    --z-dropdown: 100;
    --z-sticky:   200;
    --z-overlay:  300;
    --z-modal:    400;
    --z-toast:    500;

    /* Header */
    --header-topbar-height: 40px;
    --header-main-height:   80px;
    --header-total-height:  120px;
}

/* ==========================================================================
   2. MODERN CSS RESET
   ========================================================================== */
*, *::before, *::after {
    box-sizing: border-box;
    margin: 0;
    padding: 0;
}

html {
    font-size: 16px;
    scroll-behavior: smooth;
    -webkit-text-size-adjust: 100%;
    tab-size: 4;
}

body {
    font-family: var(--font-body);
    font-size: var(--text-base);
    font-weight: var(--font-normal);
    line-height: var(--leading-normal);
    color: var(--color-text);
    background-color: var(--color-white);
    -webkit-font-smoothing: antialiased;
    -moz-osx-font-smoothing: grayscale;
    overflow-x: hidden;
}

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

input, button, textarea, select {
    font: inherit;
}

p, h1, h2, h3, h4, h5, h6 {
    overflow-wrap: break-word;
}

h1, h2, h3, h4, h5, h6 {
    font-family: var(--font-heading);
    font-weight: var(--font-bold);
    line-height: var(--leading-tight);
    color: var(--color-heading);
}

a {
    color: var(--color-primary);
    text-decoration: none;
    transition: color var(--transition-fast);
}

a:hover {
    color: var(--color-primary-dark);
}

ul, ol {
    list-style: none;
}

button {
    cursor: pointer;
    border: none;
    background: none;
}

/* ==========================================================================
   3. GOOGLE FONTS IMPORT (self-hosted fallback via @font-face possible later)
   ========================================================================== */
/* Loaded via functions.php wp_enqueue_style */

/* ==========================================================================
   4. LAYOUT UTILITIES
   ========================================================================== */
.container {
    width: 100%;
    max-width: var(--container-2xl);
    margin-inline: auto;
    padding-inline: var(--container-pad);
}

.container--narrow {
    max-width: var(--container-xl);
}

.container--wide {
    max-width: 100%;
    padding-inline: var(--space-8);
}

/* Grid system */
.grid {
    display: grid;
    gap: var(--space-6);
}

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

.flex {
    display: flex;
}

.flex-center {
    display: flex;
    align-items: center;
    justify-content: center;
}

.flex-between {
    display: flex;
    align-items: center;
    justify-content: space-between;
}

/* Section spacing */
.section {
    padding-block: var(--space-20);
}

.section--sm {
    padding-block: var(--space-12);
}

.section--lg {
    padding-block: var(--space-24);
}

/* Section headers */
.section-header {
    text-align: center;
    margin-bottom: var(--space-12);
}

.section-label {
    display: inline-block;
    font-size: var(--text-sm);
    font-weight: var(--font-semi);
    letter-spacing: 0.1em;
    text-transform: uppercase;
    color: var(--color-secondary);
    margin-bottom: var(--space-3);
}

.section-title {
    font-size: var(--text-3xl);
    color: var(--color-heading);
    margin-bottom: var(--space-4);
    position: relative;
}

.section-title::after {
    content: '';
    display: block;
    width: 60px;
    height: 4px;
    background: linear-gradient(90deg, var(--color-primary), var(--color-secondary));
    margin: var(--space-4) auto 0;
    border-radius: var(--radius-full);
}

.section-title--left::after {
    margin-left: 0;
}

.section-desc {
    font-size: var(--text-lg);
    color: var(--color-text-muted);
    max-width: 640px;
    margin-inline: auto;
    line-height: var(--leading-loose);
}

/* Background variants */
.bg-white    { background-color: var(--color-white); }
.bg-light    { background-color: var(--color-off-white); }
.bg-primary  { background-color: var(--color-primary); color: var(--color-white); }
.bg-dark     { background-color: var(--color-dark); color: var(--color-white); }

/* ==========================================================================
   5. TYPOGRAPHY SCALE
   ========================================================================== */
.text-xs   { font-size: var(--text-xs); }
.text-sm   { font-size: var(--text-sm); }
.text-base { font-size: var(--text-base); }
.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); }
.text-5xl  { font-size: var(--text-5xl); }

.font-bold   { font-weight: var(--font-bold); }
.font-semi   { font-weight: var(--font-semi); }
.font-medium { font-weight: var(--font-medium); }

.text-primary { color: var(--color-primary); }
.text-secondary { color: var(--color-secondary); }
.text-muted { color: var(--color-text-muted); }
.text-white { color: var(--color-white); }

.text-center { text-align: center; }
.text-left   { text-align: left; }
.text-right  { text-align: right; }

/* ==========================================================================
   6. BUTTONS
   ========================================================================== */
.btn {
    display: inline-flex;
    align-items: center;
    gap: var(--space-2);
    padding: 0.75rem 1.75rem;
    border-radius: var(--radius-md);
    font-family: var(--font-heading);
    font-size: var(--text-sm);
    font-weight: var(--font-semi);
    letter-spacing: 0.02em;
    text-transform: uppercase;
    text-decoration: none;
    border: 2px solid transparent;
    cursor: pointer;
    transition: all var(--transition-base);
    white-space: nowrap;
    line-height: 1;
}

.btn-primary {
    background-color: var(--color-primary);
    color: var(--color-white);
    border-color: var(--color-primary);
}

.btn-primary:hover {
    background-color: var(--color-primary-dark);
    border-color: var(--color-primary-dark);
    color: var(--color-white);
    transform: translateY(-2px);
    box-shadow: var(--shadow-primary);
}

.btn-secondary {
    background-color: var(--color-secondary);
    color: var(--color-dark);
    border-color: var(--color-secondary);
}

.btn-secondary:hover {
    background-color: var(--color-secondary-dark);
    border-color: var(--color-secondary-dark);
    color: var(--color-dark);
    transform: translateY(-2px);
}

.btn-outline {
    background-color: transparent;
    color: var(--color-primary);
    border-color: var(--color-primary);
}

.btn-outline:hover {
    background-color: var(--color-primary);
    color: var(--color-white);
    transform: translateY(-2px);
}

.btn-outline-white {
    background-color: transparent;
    color: var(--color-white);
    border-color: var(--color-white);
}

.btn-outline-white:hover {
    background-color: var(--color-white);
    color: var(--color-primary);
    transform: translateY(-2px);
}

.btn-sm {
    padding: 0.5rem 1.25rem;
    font-size: var(--text-xs);
}

.btn-lg {
    padding: 1rem 2.25rem;
    font-size: var(--text-base);
}

.btn-icon {
    width: 44px;
    height: 44px;
    padding: 0;
    border-radius: var(--radius-md);
    flex-shrink: 0;
    justify-content: center;
}

/* ==========================================================================
   7. CARDS
   ========================================================================== */
.card {
    background: var(--color-white);
    border-radius: var(--radius-lg);
    box-shadow: var(--shadow-sm);
    border: var(--border-width) solid var(--border-color);
    overflow: hidden;
    transition: transform var(--transition-base), box-shadow var(--transition-base);
}

.card:hover {
    transform: translateY(-4px);
    box-shadow: var(--shadow-lg);
}

.card__image {
    width: 100%;
    aspect-ratio: 16 / 9;
    object-fit: cover;
}

.card__body {
    padding: var(--space-6);
}

.card__title {
    font-size: var(--text-xl);
    margin-bottom: var(--space-3);
    color: var(--color-heading);
}

.card__text {
    color: var(--color-text-muted);
    font-size: var(--text-sm);
    line-height: var(--leading-loose);
    margin-bottom: var(--space-4);
}

.card__footer {
    padding: var(--space-4) var(--space-6);
    border-top: var(--border-width) solid var(--border-color);
    background: var(--color-off-white);
}

/* ==========================================================================
   8. BADGES & TAGS
   ========================================================================== */
.badge {
    display: inline-block;
    padding: 0.25em 0.75em;
    border-radius: var(--radius-full);
    font-size: var(--text-xs);
    font-weight: var(--font-semi);
    text-transform: uppercase;
    letter-spacing: 0.05em;
}

.badge-primary   { background: var(--color-primary);   color: var(--color-white); }
.badge-secondary { background: var(--color-secondary); color: var(--color-dark); }
.badge-success   { background: var(--color-success);   color: var(--color-white); }
.badge-light     { background: var(--color-light-gray); color: var(--color-text); }

/* ==========================================================================
   9. FORM ELEMENTS
   ========================================================================== */
.form-group {
    margin-bottom: var(--space-5);
}

.form-label {
    display: block;
    font-size: var(--text-sm);
    font-weight: var(--font-semi);
    color: var(--color-heading);
    margin-bottom: var(--space-2);
}

.form-control {
    display: block;
    width: 100%;
    padding: 0.75rem 1rem;
    font-size: var(--text-base);
    font-family: var(--font-body);
    color: var(--color-text);
    background: var(--color-white);
    border: var(--border-width) solid var(--border-color);
    border-radius: var(--radius-md);
    transition: border-color var(--transition-fast), box-shadow var(--transition-fast);
    -webkit-appearance: none;
    appearance: none;
}

.form-control:focus {
    outline: none;
    border-color: var(--color-primary);
    box-shadow: 0 0 0 3px rgba(120,4,3,.12);
}

.form-control::placeholder {
    color: var(--color-text-muted);
    opacity: 0.7;
}

textarea.form-control {
    resize: vertical;
    min-height: 140px;
}

/* ==========================================================================
   10. ALERTS / NOTICES
   ========================================================================== */
.alert {
    padding: var(--space-4) var(--space-6);
    border-radius: var(--radius-md);
    border-left: 4px solid;
    font-size: var(--text-sm);
    margin-bottom: var(--space-5);
}

.alert-info    { background: #eff6ff; border-color: var(--color-info);    color: #1e40af; }
.alert-success { background: #f0fdf4; border-color: var(--color-success); color: #15803d; }
.alert-warning { background: #fffbeb; border-color: var(--color-warning); color: #92400e; }
.alert-danger  { background: #fef2f2; border-color: var(--color-danger);  color: #991b1b; }

/* ==========================================================================
   11. BREADCRUMBS
   ========================================================================== */
.breadcrumbs {
    display: flex;
    align-items: center;
    flex-wrap: wrap;
    gap: var(--space-2);
    font-size: var(--text-sm);
    color: var(--color-text-muted);
    padding-block: var(--space-4);
}

.breadcrumbs a {
    color: var(--color-text-muted);
    transition: color var(--transition-fast);
}

.breadcrumbs a:hover {
    color: var(--color-primary);
}

.breadcrumbs__sep {
    color: var(--color-mid-gray);
}

.breadcrumbs__current {
    color: var(--color-primary);
    font-weight: var(--font-medium);
}

/* ==========================================================================
   12. PAGE HERO (inner pages)
   ========================================================================== */
.page-hero {
    background: linear-gradient(135deg, var(--color-primary) 0%, var(--color-primary-dark) 100%);
    padding-block: var(--space-16);
    text-align: center;
    position: relative;
    overflow: hidden;
}

.page-hero::before {
    content: '';
    position: absolute;
    inset: 0;
    background-image: url('data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100"><circle cx="20" cy="20" r="15" fill="rgba(255,255,255,.03)"/><circle cx="80" cy="80" r="25" fill="rgba(255,255,255,.03)"/><circle cx="80" cy="20" r="10" fill="rgba(255,255,255,.02)"/></svg>');
    background-size: cover;
}

.page-hero__content {
    position: relative;
    z-index: 1;
}

.page-hero__title {
    font-size: var(--text-4xl);
    color: var(--color-white);
    margin-bottom: var(--space-4);
}

.page-hero__subtitle {
    font-size: var(--text-lg);
    color: rgba(255,255,255,.8);
}

/* ==========================================================================
   13. PAGINATION
   ========================================================================== */
.pagination {
    display: flex;
    align-items: center;
    justify-content: center;
    gap: var(--space-2);
    padding-block: var(--space-8);
}

.pagination a,
.pagination span {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    width: 40px;
    height: 40px;
    border-radius: var(--radius-md);
    font-size: var(--text-sm);
    font-weight: var(--font-medium);
    transition: all var(--transition-fast);
    border: var(--border-width) solid var(--border-color);
    color: var(--color-text);
}

.pagination a:hover,
.pagination .current {
    background-color: var(--color-primary);
    border-color: var(--color-primary);
    color: var(--color-white);
}

/* ==========================================================================
   14. SKIP LINK (Accessibility)
   ========================================================================== */
.skip-link {
    position: absolute;
    top: -100px;
    left: var(--space-4);
    padding: var(--space-3) var(--space-6);
    background: var(--color-primary);
    color: var(--color-white);
    border-radius: var(--radius-md);
    font-weight: var(--font-semi);
    z-index: var(--z-toast);
    transition: top var(--transition-fast);
}

.skip-link:focus {
    top: var(--space-4);
    color: var(--color-white);
}

/* ==========================================================================
   15. SCREEN READER ONLY
   ========================================================================== */
.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;
}

/* ==========================================================================
   16. LOADER / LAZY IMAGES
   ========================================================================== */
.lazy {
    opacity: 0;
    transition: opacity var(--transition-slow);
}

.lazy.loaded {
    opacity: 1;
}

img[loading="lazy"] {
    transition: opacity var(--transition-slow);
}

/* ==========================================================================
   17. DIVIDERS
   ========================================================================== */
.divider {
    border: none;
    border-top: var(--border-width) solid var(--border-color);
    margin-block: var(--space-8);
}

.divider--thick {
    border-top-width: 3px;
    border-color: var(--color-primary);
    width: 60px;
}

/* ==========================================================================
   18. BACK TO TOP
   ========================================================================== */
#back-to-top {
    position: fixed;
    bottom: var(--space-8);
    right: var(--space-6);
    width: 48px;
    height: 48px;
    background: var(--color-primary);
    color: var(--color-white);
    border-radius: var(--radius-md);
    display: flex;
    align-items: center;
    justify-content: center;
    font-size: 1.25rem;
    box-shadow: var(--shadow-lg);
    opacity: 0;
    visibility: hidden;
    transform: translateY(10px);
    transition: all var(--transition-base);
    z-index: var(--z-sticky);
    cursor: pointer;
}

#back-to-top.visible {
    opacity: 1;
    visibility: visible;
    transform: translateY(0);
}

#back-to-top:hover {
    background: var(--color-primary-dark);
    transform: translateY(-3px);
}

/* ==========================================================================
   19. WORDPRESS CORE CLASSES (required)
   ========================================================================== */
.wp-caption {
    max-width: 100%;
}

.wp-caption-text {
    font-size: var(--text-sm);
    color: var(--color-text-muted);
    margin-top: var(--space-2);
    font-style: italic;
}

.sticky {
    /* WordPress sticky post */
}

.bypostauthor {
    /* WordPress author highlight */
}

.alignleft {
    float: left;
    margin-right: var(--space-6);
    margin-bottom: var(--space-4);
}

.alignright {
    float: right;
    margin-left: var(--space-6);
    margin-bottom: var(--space-4);
}

.aligncenter {
    display: block;
    margin-inline: auto;
}

.alignwide {
    width: calc(100% + var(--space-16));
    max-width: calc(100% + var(--space-16));
    margin-inline: calc(-1 * var(--space-8));
}

.alignfull {
    width: 100vw;
    max-width: 100vw;
    margin-inline: calc(50% - 50vw);
}

/* ==========================================================================
   20. RESPONSIVE BREAKPOINTS
   ========================================================================== */

/* Tablet — 768px and down */
@media (max-width: 768px) {
    :root {
        --text-3xl: 1.5rem;
        --text-4xl: 1.875rem;
        --text-5xl: 2.25rem;
        --space-20: 3.5rem;
        --space-24: 4rem;
        --header-total-height: 70px;
    }

    .grid-2,
    .grid-3,
    .grid-4 {
        grid-template-columns: 1fr;
    }

    .section-title {
        font-size: var(--text-2xl);
    }

    .page-hero__title {
        font-size: var(--text-3xl);
    }
}

/* Mobile — 480px and down */
@media (max-width: 480px) {
    :root {
        --container-pad: 1rem;
        --text-3xl: 1.375rem;
        --text-4xl: 1.625rem;
    }

    .btn {
        padding: 0.65rem 1.25rem;
    }

    .btn-lg {
        padding: 0.85rem 1.75rem;
        font-size: var(--text-sm);
    }
}

/* Desktop override for 2-column grid */
@media (min-width: 769px) and (max-width: 1024px) {
    .grid-3,
    .grid-4 {
        grid-template-columns: repeat(2, 1fr);
    }
}