/**
 * DriveAI Utilities — utilities.css
 * ===================================
 * Single-purpose helper classes for micro-adjustments.
 * These extend (not replace) Bootstrap's own utility classes.
 * Only add utilities that Bootstrap 5 doesn't already provide.
 *
 * Depends on: design-system.css
 */


/* ============================================================
   SEMANTIC COLOR UTILITIES
   Use these instead of Bootstrap's text-primary / bg-primary
   so they correctly respond to theme switching.
   ============================================================ */

/* Text */
.da-text-primary    { color: var(--text-primary)   !important; }
.da-text-secondary  { color: var(--text-secondary) !important; }
.da-text-muted      { color: var(--text-muted)     !important; }
.da-text-brand      { color: var(--text-brand)     !important; }
.da-text-accent     { color: var(--text-accent)    !important; }
.da-text-success    { color: var(--text-success)   !important; }
.da-text-warning    { color: var(--text-warning)   !important; }
.da-text-danger     { color: var(--text-danger)    !important; }
.da-text-inverse    { color: var(--text-inverse)   !important; }
/* For surfaces that stay ink in EVERY theme (the hero gradient, da-card--brand,
   da-card--diagnostic). --text-inverse flips with the page and belongs on
   --bg-inverse, which flips too; on a fixed-ink surface it went gray-900 on
   gray-900 in dark mode (2026-09-17). --text-on-brand is #fff in all three
   theme blocks. Guarded by tests/test_hero_dark_mode_contrast.py. */
.da-text-on-ink     { color: var(--text-on-brand)  !important; }

/* Backgrounds */
.da-bg-primary      { background-color: var(--bg-primary)       !important; }
.da-bg-secondary    { background-color: var(--bg-secondary)     !important; }
.da-bg-tertiary     { background-color: var(--bg-tertiary)      !important; }
.da-bg-brand        { background-color: var(--bg-brand)         !important; }
.da-bg-brand-subtle { background-color: var(--bg-brand-subtle)  !important; }
.da-bg-success      { background-color: var(--bg-success-subtle)!important; }
.da-bg-warning      { background-color: var(--bg-warning-subtle)!important; }
.da-bg-danger       { background-color: var(--bg-danger-subtle) !important; }

/* Gradient backgrounds */
.da-bg-gradient-brand      { background: var(--gradient-brand)      !important; }
.da-bg-gradient-diagnostic { background: var(--gradient-diagnostic) !important; }
.da-bg-gradient-hero       { background: var(--gradient-hero)       !important; }

/* Borders */
.da-border         { border: 1px solid var(--border-subtle) !important; }
.da-border-default { border-color: var(--border-default)    !important; }
.da-border-brand   { border-color: var(--border-brand)      !important; }


/* ============================================================
   TYPOGRAPHY UTILITIES
   ============================================================ */
.da-font-sans    { font-family: var(--font-sans) !important; }
.da-font-mono    { font-family: var(--font-mono) !important; }

.da-weight-normal  { font-weight: var(--font-normal)   !important; }
.da-weight-medium  { font-weight: var(--font-medium)   !important; }
.da-weight-semi    { font-weight: var(--font-semibold) !important; }
.da-weight-bold    { font-weight: var(--font-bold)     !important; }
.da-weight-extra   { font-weight: var(--font-extrabold)!important; }

.da-text-xs   { font-size: var(--text-xs)  !important; }
.da-text-sm   { font-size: var(--text-sm)  !important; }
.da-text-base { font-size: var(--text-base)!important; }
.da-text-lg   { font-size: var(--text-lg)  !important; }
.da-text-xl   { font-size: var(--text-xl)  !important; }
.da-text-2xl  { font-size: var(--text-2xl) !important; }
.da-text-3xl  { font-size: var(--text-3xl) !important; }

.da-leading-tight   { line-height: var(--leading-tight)   !important; }
.da-leading-normal  { line-height: var(--leading-normal)  !important; }
.da-leading-relaxed { line-height: var(--leading-relaxed) !important; }

.da-tracking-tight   { letter-spacing: var(--tracking-tight)   !important; }
.da-tracking-wide    { letter-spacing: var(--tracking-wide)    !important; }
.da-tracking-widest  { letter-spacing: var(--tracking-widest)  !important; }

.da-uppercase { text-transform: uppercase !important; }
.da-capitalize{ text-transform: capitalize !important; }
.da-truncate  {
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}


/* ============================================================
   SPACING UTILITIES (semantic names)
   Use these for section-level spacing, not micro-adjustments.
   ============================================================ */
.da-mt-section  { margin-top: var(--space-12) !important; }
.da-mb-section  { margin-bottom: var(--space-12) !important; }
.da-pt-section  { padding-top: var(--space-12) !important; }
.da-pb-section  { padding-bottom: var(--space-12) !important; }


/* ============================================================
   BORDER RADIUS UTILITIES
   ============================================================ */
.da-rounded-sm  { border-radius: var(--radius-sm)  !important; }
.da-rounded-md  { border-radius: var(--radius-md)  !important; }
.da-rounded-lg  { border-radius: var(--radius-lg)  !important; }
.da-rounded-xl  { border-radius: var(--radius-xl)  !important; }
.da-rounded-2xl { border-radius: var(--radius-2xl) !important; }
.da-rounded-full{ border-radius: var(--radius-full)!important; }


/* ============================================================
   SHADOW UTILITIES
   ============================================================ */
.da-shadow-none { box-shadow: none        !important; }
.da-shadow-xs   { box-shadow: var(--shadow-xs)  !important; }
.da-shadow-sm   { box-shadow: var(--shadow-sm)  !important; }
.da-shadow-md   { box-shadow: var(--shadow-md)  !important; }
.da-shadow-lg   { box-shadow: var(--shadow-lg)  !important; }
.da-shadow-brand{ box-shadow: var(--shadow-brand)!important; }


/* ============================================================
   FOCUS & ACCESSIBILITY
   ============================================================ */
.da-focus-ring:focus-visible {
  outline: none;
  box-shadow: var(--focus-ring) !important;
}

/* Skip-to-content link for keyboard navigation */
.da-skip-link {
  position: absolute;
  top: -100%;
  left: var(--space-4);
  z-index: var(--z-toast);
  background-color: var(--bg-brand);
  color: #ffffff;
  padding: var(--space-2) var(--space-4);
  border-radius: 0 0 var(--radius-md) var(--radius-md);
  font-size: var(--text-sm);
  font-weight: var(--font-semibold);
  text-decoration: none;
  transition: top var(--duration-fast) var(--ease-out);
}

.da-skip-link:focus {
  top: 0;
}

/* Visually hidden — accessible but off-screen */
.da-sr-only {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
  border: 0;
}


/* ============================================================
   ANIMATION UTILITIES
   ============================================================ */
.da-animate-fade-up {
  animation: da-fade-up var(--duration-slower) var(--ease-out) both;
}

.da-animate-fade-in {
  animation: da-fade-in var(--duration-slow) var(--ease-out) both;
}

/* Stagger delays for lists — apply to nth children via JS or manually */
.da-delay-1 { animation-delay: 100ms; }
.da-delay-2 { animation-delay: 200ms; }
.da-delay-3 { animation-delay: 300ms; }
.da-delay-4 { animation-delay: 400ms; }

@keyframes da-fade-up {
  from {
    opacity: 0;
    transform: translateY(24px);
  }
  to {
    opacity: 1;
    transform: translateY(0);
  }
}

@keyframes da-fade-in {
  from { opacity: 0; }
  to   { opacity: 1; }
}

/* Respect prefers-reduced-motion */
@media (prefers-reduced-motion: reduce) {
  .da-animate-fade-up,
  .da-animate-fade-in {
    animation: none;
  }

  .theme-transitioning,
  .theme-transitioning *,
  .theme-transitioning *::before,
  .theme-transitioning *::after {
    transition: none !important;
  }
}


/* ============================================================
   INTERACTIVE UTILITIES
   ============================================================ */
.da-clickable {
  cursor: pointer;
}

.da-no-select {
  user-select: none;
  -webkit-user-select: none;
}

.da-transition {
  transition: var(--transition-all);
}

.da-lift:hover {
  transform: translateY(-2px);
  box-shadow: var(--shadow-md);
}


/* ============================================================
   DISPLAY / VISIBILITY UTILITIES
   ============================================================ */

/* Hide on mobile, show on md+ */
.da-hidden-mobile {
  display: none;
}
@media (min-width: 768px) {
  .da-hidden-mobile {
    display: revert;
  }
}

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