/* ============================================
   UTILITIES
   Small single-purpose helper classes (grid, flex, gap,
   margin/padding, width/height, position, display, border,
   shadow, background, text size/color/weight, overflow,
   responsive visibility). Structural helpers, not design
   decisions — if you're hunting for "why does X look like
   that", the answer is almost never in this file.
   Loaded LAST.
   ============================================ */
/* ============================================
   LAYOUT UTILITIES
   ============================================ */

/* Container */
.container { max-width: 1280px; margin: 0 auto; padding: 0 24px; }

/* Grid base */
.grid { display: grid; gap: 24px; }
.grid-cols-1 { grid-template-columns: 1fr; }
.grid-cols-2 { grid-template-columns: repeat(2, 1fr); }
.grid-cols-3 { grid-template-columns: repeat(3, 1fr); }
.grid-cols-4 { grid-template-columns: repeat(4, 1fr); }
.grid-cols-5 { grid-template-columns: repeat(5, 1fr); }

/* Responsive grids — 1 col mobile, expand at 769px */
.grid-responsive-2,
.grid-responsive-3,
.grid-responsive-4,
.grid-responsive-5,
.grid-responsive-6 {
    display: grid;
    gap: 24px;
    grid-template-columns: 1fr;
}
@media (min-width: 769px) {
    .grid-responsive-2 { grid-template-columns: repeat(2, 1fr); }
    .grid-responsive-3 { grid-template-columns: repeat(3, 1fr); }
    .grid-responsive-4 { grid-template-columns: repeat(4, 1fr); }
    .grid-responsive-5 { grid-template-columns: repeat(5, 1fr); }
    .grid-responsive-6 { grid-template-columns: repeat(6, 1fr); }
}

/* Col span */
.col-span-1 { grid-column: span 1; }
.col-span-2 { grid-column: span 2; }
.col-span-5 { grid-column: span 5; }

/* Flex */
.flex         { display: flex; }
.flex-col     { flex-direction: column; }
.flex-wrap    { flex-wrap: wrap; }
.flex-1       { flex: 1; }
.flex-shrink-0 { flex-shrink: 0; }
.items-center { align-items: center; }
.items-start  { align-items: flex-start; }
.items-end    { align-items: flex-end; }
.justify-between { justify-content: space-between; }
.justify-end     { justify-content: flex-end; }
.justify-center  { justify-content: center; }

/* Gap */
.gap-1 { gap: var(--space-1); }
.gap-2 { gap: var(--space-2); }
.gap-3 { gap: var(--space-3); }
.gap-4 { gap: var(--space-4); }
.gap-5 { gap: var(--space-5); }
.gap-6 { gap: var(--space-6); }

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

/* Space-x */
.space-x-2 > * + * { margin-left: var(--space-2); }
.space-x-3 > * + * { margin-left: var(--space-3); }

/* ============================================
   SPACING UTILITIES
   ============================================ */
.m-0  { margin: 0; }
.mt-0 { margin-top: 0; }    .mb-0 { margin-bottom: 0; }
.mt-half { margin-top: 2px; }
.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-5 { margin-top: var(--space-5); }
.mt-6 { margin-top: var(--space-6); }
.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); }
.ml-1 { margin-left: var(--space-1); }
.ml-2 { margin-left: var(--space-2); }
.ml-3 { margin-left: var(--space-3); }
.mr-1 { margin-right: var(--space-1); }
.mr-2 { margin-right: var(--space-2); }
.mr-3 { margin-right: var(--space-3); }
.mx-auto { margin-left: auto; margin-right: auto; }

.p-0 { padding: 0; }
.p-1 { padding: var(--space-1); }
.p-2 { padding: var(--space-2); }
.p-3 { padding: var(--space-3); }
.p-4 { padding: var(--space-4); }
.p-5 { padding: var(--space-5); }
.p-6 { padding: var(--space-6); }
.px-1 { padding-left: var(--space-1); padding-right: var(--space-1); }
.px-2 { padding-left: var(--space-2); padding-right: var(--space-2); }
.px-3 { padding-left: var(--space-3); padding-right: var(--space-3); }
.px-4 { padding-left: var(--space-4); padding-right: var(--space-4); }
.px-6 { padding-left: var(--space-6); padding-right: var(--space-6); }
.px-8 { padding-left: var(--space-8); padding-right: var(--space-8); }
.py-1 { padding-top: var(--space-1); padding-bottom: var(--space-1); }
.py-2 { padding-top: var(--space-2); padding-bottom: var(--space-2); }
.py-3 { padding-top: var(--space-3); padding-bottom: var(--space-3); }
.py-4 { padding-top: var(--space-4); padding-bottom: var(--space-4); }
.pb-2 { padding-bottom: var(--space-2); }
.pb-3 { padding-bottom: var(--space-3); }
.pt-2 { padding-top: var(--space-2); }

/* ============================================
   SIZE UTILITIES
   ============================================ */
.w-full   { width: 100%; }
.w-auto   { width: auto; }
.w-4      { width: 16px; }
.w-5      { width: 20px; }
.w-8      { width: 32px; }
.w-16     { width: 64px; }
.w-64     { width: 256px; }
.w-80     { width: 320px; }
.h-full   { height: 100%; }
.h-4      { height: 16px; }
.h-5      { height: 20px; }
.h-8      { height: 32px; }
.min-h-screen { min-height: 100vh; }
.min-h-600    { min-height: 600px; }
.max-h-80     { max-height: 320px; }
.max-h-96     { max-height: 384px; }
.max-w-md     { max-width: 448px; }
.max-w-7xl    { max-width: 1280px; }

/* ============================================
   POSITION UTILITIES
   ============================================ */
.relative { position: relative; }
.absolute { position: absolute; }
.fixed    { position: fixed; }
.sticky   { position: sticky; }
.top-0    { top: 0; }
.left-0   { left: 0; }
.right-0  { right: 0; }
.inset-0  { top: 0; right: 0; bottom: 0; left: 0; }
.z-10 { z-index: 10; }
.z-20 { z-index: 20; }
.z-30 { z-index: 30; }

/* ============================================
   DISPLAY UTILITIES
   ============================================ */
.hidden       { display: none; }
.block        { display: block; }
.inline       { display: inline; }
.inline-block { display: inline-block; }
.inline-flex  { display: inline-flex; }

/* ============================================
   BORDER UTILITIES
   ============================================ */
.border        { border: 1px solid var(--border-default); }
.border-top    { border-top: 1px solid var(--border-default); }
.border-bottom { border-bottom: 1px solid var(--border-default); }
.border-left   { border-left: 1px solid var(--border-default); }
.border-right  { border-right: 1px solid var(--border-default); }
.border-0      { border: none; }
.rounded       { border-radius: var(--radius-standard); }
.rounded-lg    { border-radius: var(--radius-large); }
.rounded-xl    { border-radius: var(--radius-xl); }
.rounded-full  { border-radius: 9999px; }

/* ============================================
   SHADOW UTILITIES
   ============================================ */
.shadow-sm { box-shadow: var(--shadow-sm); }
.shadow-md { box-shadow: var(--shadow-md); }
.shadow-lg { box-shadow: var(--shadow-lg); }

/* ============================================
   BACKGROUND UTILITIES
   ============================================ */
.bg-white       { background-color: var(--white); }
.bg-page        { background-color: var(--bg-main); }
.bg-hover       { background-color: var(--bg-hover); }
.bg-black-alpha { background-color: rgba(0,0,0,0.4); }
.bg-purple      { background-color: var(--brand-purple); }
.bg-gold        { background-color: var(--brand-gold); }

/* ============================================
   TEXT UTILITIES
   ============================================ */
.text-center  { text-align: center; }
.text-right   { text-align: right; }
.text-left    { text-align: left; }
.text-xs  { font-size: 12px; }
.text-sm  { font-size: 14px; }
.text-lg  { font-size: 18px; }
.text-xl  { font-size: 20px; }
.text-2xl { font-size: 24px; }
.font-light    { font-weight: 300; }
.font-normal   { font-weight: 400; }
.font-medium   { font-weight: 500; }

.font-semibold { font-weight: 600; }
.font-bold     { font-weight: 700; }

.text-purple  { color: var(--brand-purple); }
.text-gold    { color: var(--brand-gold); }
.text-navy    { color: var(--heading-navy); }
.text-slate   { color: var(--body-slate); }
.text-success { color: var(--success-green); }
.text-warning { color: var(--brand-gold); }
.text-danger  { color: var(--danger-red); }
.text-muted   { color: var(--text-muted); }

/* ============================================
   OVERFLOW & MISC UTILITIES
   ============================================ */
.overflow-hidden  { overflow: hidden; }
.overflow-auto    { overflow: auto; }
.overflow-x-auto  { overflow-x: auto; }
.overflow-y-auto  { overflow-y: auto; }
.cursor-pointer     { cursor: pointer; }
.cursor-not-allowed { cursor: not-allowed; }
.list-none    { list-style: none; }
.object-cover { object-fit: cover; }
.transition   { transition: all var(--transition-fast); }
.min-w-4      { min-width: 16px; }

/* Hover utilities */
.hover\:bg-hover:hover    { background-color: var(--bg-hover); }
.hover\:text-purple:hover { color: var(--brand-purple); }

/* ============================================
   RESPONSIVE VISIBILITY
   ============================================ */
@media (max-width: 768px) {
    .hide-mobile { display: none; }
}
@media (min-width: 769px) {
    .hide-desktop { display: none; }
}

/* ============================================
   RESPONSIVE ADJUSTMENTS
   ============================================ */
@media (max-width: 768px) {
    .card { padding: var(--space-4); }
    .stats-card-value { font-size: 24px; }
    .btn, .btn-primary, .btn-secondary { padding: 6px 12px; font-size: 14px; }
    .grid-cols-2,
    .grid-cols-3,
    .grid-cols-4,
    .grid-cols-5 { grid-template-columns: 1fr; }
}