/**
 * ========================================================
 * UTILITIES.CSS - Helper Classes
 * ========================================================
 *
 * This file contains utility/helper classes for quick styling.
 * These are single-purpose classes that do one thing well.
 *
 * Contents:
 * 1. Display Utilities
 * 2. Text Utilities
 * 3. Spacing Utilities (Margin & Padding)
 * 4. Width & Height Utilities
 * 5. Position Utilities
 * 6. Visibility Utilities
 * 7. Overflow Utilities
 * 8. Cursor Utilities
 * 9. Border Utilities
 * 10. Background Utilities
 *
 * Naming Convention: property-value (e.g., text-center, mt-lg)
 *
 * Dependencies: variables.css
 *
 * ========================================================
 */


/* ========================================================
   1. DISPLAY UTILITIES
   ========================================================
   Control element display behavior
   ======================================================== */

.d-none { display: none !important; }
.d-block { display: block !important; }
.d-inline { display: inline !important; }
.d-inline-block { display: inline-block !important; }
.d-flex { display: flex !important; }
.d-inline-flex { display: inline-flex !important; }
.d-grid { display: grid !important; }


/* ========================================================
   2. TEXT UTILITIES
   ========================================================
   Typography and text formatting helpers
   ======================================================== */

/* Text Alignment */
.text-left { text-align: left !important; }
.text-center { text-align: center !important; }
.text-right { text-align: right !important; }
.text-justify { text-align: justify !important; }

/* Font Weight */
.font-light { font-weight: var(--font-weight-light) !important; }
.font-regular { font-weight: var(--font-weight-regular) !important; }
.font-medium { font-weight: var(--font-weight-medium) !important; }
.font-semibold { font-weight: var(--font-weight-semibold) !important; }
.font-bold { font-weight: var(--font-weight-bold) !important; }

/* Font Style */
.font-italic { font-style: italic !important; }
.font-normal { font-style: normal !important; }

/* Text Transform */
.text-uppercase { text-transform: uppercase !important; }
.text-lowercase { text-transform: lowercase !important; }
.text-capitalize { text-transform: capitalize !important; }
.text-normal-case { text-transform: none !important; }

/* Text Decoration */
.text-underline { text-decoration: underline !important; }
.text-line-through { text-decoration: line-through !important; }
.text-no-underline { text-decoration: none !important; }

/* Text Colors */
.text-primary { color: var(--color-primary) !important; }
.text-secondary { color: var(--color-secondary) !important; }
.text-accent { color: var(--color-accent) !important; }
.text-gold { color: var(--color-gold) !important; }
.text-white { color: var(--color-white) !important; }
.text-black { color: var(--color-near-black) !important; }
.text-charcoal { color: var(--color-charcoal) !important; }
.text-gray { color: var(--color-dark-gray) !important; }
.text-muted { color: var(--color-medium-gray) !important; }
.text-success { color: var(--color-success) !important; }
.text-error { color: var(--color-error) !important; }
.text-warning { color: var(--color-warning) !important; }
.text-info { color: var(--color-info) !important; }

/* Font Sizes */
.text-tiny { font-size: var(--font-size-tiny) !important; }
.text-small { font-size: var(--font-size-small) !important; }
.text-body { font-size: var(--font-size-body) !important; }
.text-lg { font-size: var(--font-size-body-lg) !important; }
.text-h6 { font-size: var(--font-size-h6) !important; }
.text-h5 { font-size: var(--font-size-h5) !important; }
.text-h4 { font-size: var(--font-size-h4) !important; }
.text-h3 { font-size: var(--font-size-h3) !important; }
.text-h2 { font-size: var(--font-size-h2) !important; }
.text-h1 { font-size: var(--font-size-h1) !important; }

/* Line Height */
.leading-tight { line-height: var(--line-height-tight) !important; }
.leading-snug { line-height: var(--line-height-snug) !important; }
.leading-normal { line-height: var(--line-height-normal) !important; }
.leading-loose { line-height: var(--line-height-loose) !important; }

/* Letter Spacing */
.tracking-tight { letter-spacing: var(--letter-spacing-tight) !important; }
.tracking-normal { letter-spacing: var(--letter-spacing-normal) !important; }
.tracking-wide { letter-spacing: var(--letter-spacing-wide) !important; }
.tracking-wider { letter-spacing: var(--letter-spacing-wider) !important; }
.tracking-widest { letter-spacing: var(--letter-spacing-widest) !important; }

/* Word Break */
.break-word { word-break: break-word !important; }
.break-all { word-break: break-all !important; }
.break-normal { word-break: normal !important; }

/* White Space */
.whitespace-normal { white-space: normal !important; }
.whitespace-nowrap { white-space: nowrap !important; }
.whitespace-pre { white-space: pre !important; }
.whitespace-pre-wrap { white-space: pre-wrap !important; }

/* Text Overflow */
.truncate {
    overflow: hidden !important;
    text-overflow: ellipsis !important;
    white-space: nowrap !important;
}

.line-clamp-2 {
    display: -webkit-box !important;
    -webkit-line-clamp: 2 !important;
    -webkit-box-orient: vertical !important;
    overflow: hidden !important;
}

.line-clamp-3 {
    display: -webkit-box !important;
    -webkit-line-clamp: 3 !important;
    -webkit-box-orient: vertical !important;
    overflow: hidden !important;
}


/* ========================================================
   3. SPACING UTILITIES
   ========================================================
   Margin and padding helpers
   ======================================================== */

/* Margin - All Sides */
.m-0 { margin: 0 !important; }
.m-3xs { margin: var(--space-3xs) !important; }
.m-2xs { margin: var(--space-2xs) !important; }
.m-xs { margin: var(--space-xs) !important; }
.m-sm { margin: var(--space-sm) !important; }
.m-md { margin: var(--space-md) !important; }
.m-lg { margin: var(--space-lg) !important; }
.m-xl { margin: var(--space-xl) !important; }
.m-2xl { margin: var(--space-2xl) !important; }
.m-auto { margin: auto !important; }

/* Margin - Top */
.mt-0 { margin-top: 0 !important; }
.mt-3xs { margin-top: var(--space-3xs) !important; }
.mt-2xs { margin-top: var(--space-2xs) !important; }
.mt-xs { margin-top: var(--space-xs) !important; }
.mt-sm { margin-top: var(--space-sm) !important; }
.mt-md { margin-top: var(--space-md) !important; }
.mt-lg { margin-top: var(--space-lg) !important; }
.mt-xl { margin-top: var(--space-xl) !important; }
.mt-2xl { margin-top: var(--space-2xl) !important; }
.mt-3xl { margin-top: var(--space-3xl) !important; }
.mt-auto { margin-top: auto !important; }

/* Margin - Right */
.mr-0 { margin-right: 0 !important; }
.mr-3xs { margin-right: var(--space-3xs) !important; }
.mr-2xs { margin-right: var(--space-2xs) !important; }
.mr-xs { margin-right: var(--space-xs) !important; }
.mr-sm { margin-right: var(--space-sm) !important; }
.mr-md { margin-right: var(--space-md) !important; }
.mr-lg { margin-right: var(--space-lg) !important; }
.mr-xl { margin-right: var(--space-xl) !important; }
.mr-auto { margin-right: auto !important; }

/* Margin - Bottom */
.mb-0 { margin-bottom: 0 !important; }
.mb-3xs { margin-bottom: var(--space-3xs) !important; }
.mb-2xs { margin-bottom: var(--space-2xs) !important; }
.mb-xs { margin-bottom: var(--space-xs) !important; }
.mb-sm { margin-bottom: var(--space-sm) !important; }
.mb-md { margin-bottom: var(--space-md) !important; }
.mb-lg { margin-bottom: var(--space-lg) !important; }
.mb-xl { margin-bottom: var(--space-xl) !important; }
.mb-2xl { margin-bottom: var(--space-2xl) !important; }
.mb-3xl { margin-bottom: var(--space-3xl) !important; }
.mb-auto { margin-bottom: auto !important; }

/* Margin - Left */
.ml-0 { margin-left: 0 !important; }
.ml-3xs { margin-left: var(--space-3xs) !important; }
.ml-2xs { margin-left: var(--space-2xs) !important; }
.ml-xs { margin-left: var(--space-xs) !important; }
.ml-sm { margin-left: var(--space-sm) !important; }
.ml-md { margin-left: var(--space-md) !important; }
.ml-lg { margin-left: var(--space-lg) !important; }
.ml-xl { margin-left: var(--space-xl) !important; }
.ml-auto { margin-left: auto !important; }

/* Margin - Horizontal (X-axis) */
.mx-0 { margin-left: 0 !important; margin-right: 0 !important; }
.mx-auto { margin-left: auto !important; margin-right: auto !important; }
.mx-sm { margin-left: var(--space-sm) !important; margin-right: var(--space-sm) !important; }
.mx-md { margin-left: var(--space-md) !important; margin-right: var(--space-md) !important; }
.mx-lg { margin-left: var(--space-lg) !important; margin-right: var(--space-lg) !important; }

/* Margin - Vertical (Y-axis) */
.my-0 { margin-top: 0 !important; margin-bottom: 0 !important; }
.my-auto { margin-top: auto !important; margin-bottom: auto !important; }
.my-sm { margin-top: var(--space-sm) !important; margin-bottom: var(--space-sm) !important; }
.my-md { margin-top: var(--space-md) !important; margin-bottom: var(--space-md) !important; }
.my-lg { margin-top: var(--space-lg) !important; margin-bottom: var(--space-lg) !important; }
.my-xl { margin-top: var(--space-xl) !important; margin-bottom: var(--space-xl) !important; }

/* Padding - All Sides */
.p-0 { padding: 0 !important; }
.p-3xs { padding: var(--space-3xs) !important; }
.p-2xs { padding: var(--space-2xs) !important; }
.p-xs { padding: var(--space-xs) !important; }
.p-sm { padding: var(--space-sm) !important; }
.p-md { padding: var(--space-md) !important; }
.p-lg { padding: var(--space-lg) !important; }
.p-xl { padding: var(--space-xl) !important; }
.p-2xl { padding: var(--space-2xl) !important; }

/* Padding - Top */
.pt-0 { padding-top: 0 !important; }
.pt-sm { padding-top: var(--space-sm) !important; }
.pt-md { padding-top: var(--space-md) !important; }
.pt-lg { padding-top: var(--space-lg) !important; }
.pt-xl { padding-top: var(--space-xl) !important; }
.pt-2xl { padding-top: var(--space-2xl) !important; }

/* Padding - Right */
.pr-0 { padding-right: 0 !important; }
.pr-sm { padding-right: var(--space-sm) !important; }
.pr-md { padding-right: var(--space-md) !important; }
.pr-lg { padding-right: var(--space-lg) !important; }
.pr-xl { padding-right: var(--space-xl) !important; }

/* Padding - Bottom */
.pb-0 { padding-bottom: 0 !important; }
.pb-sm { padding-bottom: var(--space-sm) !important; }
.pb-md { padding-bottom: var(--space-md) !important; }
.pb-lg { padding-bottom: var(--space-lg) !important; }
.pb-xl { padding-bottom: var(--space-xl) !important; }
.pb-2xl { padding-bottom: var(--space-2xl) !important; }

/* Padding - Left */
.pl-0 { padding-left: 0 !important; }
.pl-sm { padding-left: var(--space-sm) !important; }
.pl-md { padding-left: var(--space-md) !important; }
.pl-lg { padding-left: var(--space-lg) !important; }
.pl-xl { padding-left: var(--space-xl) !important; }

/* Padding - Horizontal (X-axis) */
.px-0 { padding-left: 0 !important; padding-right: 0 !important; }
.px-sm { padding-left: var(--space-sm) !important; padding-right: var(--space-sm) !important; }
.px-md { padding-left: var(--space-md) !important; padding-right: var(--space-md) !important; }
.px-lg { padding-left: var(--space-lg) !important; padding-right: var(--space-lg) !important; }
.px-xl { padding-left: var(--space-xl) !important; padding-right: var(--space-xl) !important; }

/* Padding - Vertical (Y-axis) */
.py-0 { padding-top: 0 !important; padding-bottom: 0 !important; }
.py-sm { padding-top: var(--space-sm) !important; padding-bottom: var(--space-sm) !important; }
.py-md { padding-top: var(--space-md) !important; padding-bottom: var(--space-md) !important; }
.py-lg { padding-top: var(--space-lg) !important; padding-bottom: var(--space-lg) !important; }
.py-xl { padding-top: var(--space-xl) !important; padding-bottom: var(--space-xl) !important; }
.py-2xl { padding-top: var(--space-2xl) !important; padding-bottom: var(--space-2xl) !important; }


/* ========================================================
   4. WIDTH & HEIGHT UTILITIES
   ========================================================
   Dimension control helpers
   ======================================================== */

/* Width */
.w-auto { width: auto !important; }
.w-full { width: 100% !important; }
.w-screen { width: 100vw !important; }
.w-min { width: min-content !important; }
.w-max { width: max-content !important; }
.w-fit { width: fit-content !important; }

/* Max Width */
.max-w-none { max-width: none !important; }
.max-w-full { max-width: 100% !important; }
.max-w-prose { max-width: 65ch !important; }
.max-w-narrow { max-width: var(--container-narrow) !important; }
.max-w-container { max-width: var(--container-max) !important; }
.max-w-wide { max-width: var(--container-wide) !important; }

/* Min Width */
.min-w-0 { min-width: 0 !important; }
.min-w-full { min-width: 100% !important; }

/* Height */
.h-auto { height: auto !important; }
.h-full { height: 100% !important; }
.h-screen { height: 100vh !important; }
.h-min { height: min-content !important; }
.h-max { height: max-content !important; }
.h-fit { height: fit-content !important; }

/* Min Height */
.min-h-0 { min-height: 0 !important; }
.min-h-full { min-height: 100% !important; }
.min-h-screen { min-height: 100vh !important; }

/* Max Height */
.max-h-full { max-height: 100% !important; }
.max-h-screen { max-height: 100vh !important; }


/* ========================================================
   5. POSITION UTILITIES
   ========================================================
   Positioning helpers
   ======================================================== */

.relative { position: relative !important; }
.absolute { position: absolute !important; }
.fixed { position: fixed !important; }
.sticky { position: sticky !important; }
.static { position: static !important; }

/* Position shortcuts */
.inset-0 { inset: 0 !important; }
.top-0 { top: 0 !important; }
.right-0 { right: 0 !important; }
.bottom-0 { bottom: 0 !important; }
.left-0 { left: 0 !important; }

/* Z-Index */
.z-0 { z-index: 0 !important; }
.z-10 { z-index: 10 !important; }
.z-20 { z-index: 20 !important; }
.z-30 { z-index: 30 !important; }
.z-40 { z-index: 40 !important; }
.z-50 { z-index: 50 !important; }
.z-auto { z-index: auto !important; }


/* ========================================================
   6. VISIBILITY UTILITIES
   ========================================================
   Show/hide and visibility control
   ======================================================== */

.visible { visibility: visible !important; }
.invisible { visibility: hidden !important; }

.opacity-0 { opacity: 0 !important; }
.opacity-25 { opacity: 0.25 !important; }
.opacity-50 { opacity: 0.5 !important; }
.opacity-75 { opacity: 0.75 !important; }
.opacity-100 { opacity: 1 !important; }

/* Screen reader only - visible to assistive technology */
.sr-only {
    position: absolute !important;
    width: 1px !important;
    height: 1px !important;
    padding: 0 !important;
    margin: -1px !important;
    overflow: hidden !important;
    clip: rect(0, 0, 0, 0) !important;
    white-space: nowrap !important;
    border: 0 !important;
}

/* Undo sr-only */
.not-sr-only {
    position: static !important;
    width: auto !important;
    height: auto !important;
    padding: 0 !important;
    margin: 0 !important;
    overflow: visible !important;
    clip: auto !important;
    white-space: normal !important;
}


/* ========================================================
   7. OVERFLOW UTILITIES
   ========================================================
   Overflow behavior control
   ======================================================== */

.overflow-auto { overflow: auto !important; }
.overflow-hidden { overflow: hidden !important; }
.overflow-visible { overflow: visible !important; }
.overflow-scroll { overflow: scroll !important; }

.overflow-x-auto { overflow-x: auto !important; }
.overflow-x-hidden { overflow-x: hidden !important; }
.overflow-x-scroll { overflow-x: scroll !important; }

.overflow-y-auto { overflow-y: auto !important; }
.overflow-y-hidden { overflow-y: hidden !important; }
.overflow-y-scroll { overflow-y: scroll !important; }


/* ========================================================
   8. CURSOR UTILITIES
   ========================================================
   Cursor style helpers
   ======================================================== */

.cursor-auto { cursor: auto !important; }
.cursor-default { cursor: default !important; }
.cursor-pointer { cursor: pointer !important; }
.cursor-wait { cursor: wait !important; }
.cursor-text { cursor: text !important; }
.cursor-move { cursor: move !important; }
.cursor-not-allowed { cursor: not-allowed !important; }
.cursor-grab { cursor: grab !important; }
.cursor-grabbing { cursor: grabbing !important; }

/* Pointer Events */
.pointer-events-none { pointer-events: none !important; }
.pointer-events-auto { pointer-events: auto !important; }

/* User Select */
.select-none { user-select: none !important; }
.select-text { user-select: text !important; }
.select-all { user-select: all !important; }
.select-auto { user-select: auto !important; }


/* ========================================================
   9. BORDER UTILITIES
   ========================================================
   Border styling helpers
   ======================================================== */

/* Border Width */
.border-0 { border-width: 0 !important; }
.border { border-width: 1px !important; border-style: solid !important; }
.border-2 { border-width: 2px !important; border-style: solid !important; }
.border-t { border-top-width: 1px !important; border-top-style: solid !important; }
.border-r { border-right-width: 1px !important; border-right-style: solid !important; }
.border-b { border-bottom-width: 1px !important; border-bottom-style: solid !important; }
.border-l { border-left-width: 1px !important; border-left-style: solid !important; }

/* Border Color */
.border-primary { border-color: var(--color-primary) !important; }
.border-secondary { border-color: var(--color-secondary) !important; }
.border-light { border-color: var(--color-light-gray) !important; }
.border-dark { border-color: var(--color-charcoal) !important; }
.border-white { border-color: var(--color-white) !important; }
.border-transparent { border-color: transparent !important; }

/* Border Radius */
.rounded-none { border-radius: 0 !important; }
.rounded-sm { border-radius: var(--radius-sm) !important; }
.rounded { border-radius: var(--radius-md) !important; }
.rounded-lg { border-radius: var(--radius-lg) !important; }
.rounded-xl { border-radius: var(--radius-xl) !important; }
.rounded-full { border-radius: var(--radius-full) !important; }

/* Border Style */
.border-solid { border-style: solid !important; }
.border-dashed { border-style: dashed !important; }
.border-dotted { border-style: dotted !important; }


/* ========================================================
   10. BACKGROUND UTILITIES
   ========================================================
   Background styling helpers
   ======================================================== */

/* Background Colors */
.bg-transparent { background-color: transparent !important; }
.bg-white { background-color: var(--color-white) !important; }
.bg-cream { background-color: var(--color-secondary) !important; }
.bg-primary { background-color: var(--color-primary) !important; }
.bg-primary-light { background-color: var(--color-primary-light) !important; }
.bg-accent { background-color: var(--color-accent) !important; }
.bg-gold { background-color: var(--color-gold) !important; }
.bg-charcoal { background-color: var(--color-charcoal) !important; }
.bg-black { background-color: var(--color-near-black) !important; }

/* Box Shadow */
.shadow-none { box-shadow: none !important; }
.shadow-sm { box-shadow: var(--shadow-sm) !important; }
.shadow { box-shadow: var(--shadow-md) !important; }
.shadow-lg { box-shadow: var(--shadow-lg) !important; }
.shadow-xl { box-shadow: var(--shadow-xl) !important; }


/* ========================================================
   RESPONSIVE VISIBILITY UTILITIES
   ========================================================
   Show/hide at different breakpoints
   (More responsive utilities in responsive.css)
   ======================================================== */

/* Hide on mobile only */
@media (max-width: 767px) {
    .hide-mobile { display: none !important; }
}

/* Hide on tablet only */
@media (min-width: 768px) and (max-width: 1023px) {
    .hide-tablet { display: none !important; }
}

/* Hide on desktop only */
@media (min-width: 1024px) {
    .hide-desktop { display: none !important; }
}

/* Show only on mobile */
@media (min-width: 768px) {
    .show-mobile-only { display: none !important; }
}

/* Show only on desktop */
@media (max-width: 1023px) {
    .show-desktop-only { display: none !important; }
}