/* ============================================================
   utilities.css — Helper Classes · Spacing · Display · Text
   MoneyMaths | Mobile-first
   ============================================================ */

/* ── 1. Display ──────────────────────────────────────────── */

.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; }

@media (min-width: 480px) {
  .sm\:d-none  { display: none !important; }
  .sm\:d-block { display: block !important; }
  .sm\:d-flex  { display: flex !important; }
}

@media (min-width: 768px) {
  .md\:d-none  { display: none !important; }
  .md\:d-block { display: block !important; }
  .md\:d-flex  { display: flex !important; }
}

@media (min-width: 1024px) {
  .lg\:d-none  { display: none !important; }
  .lg\:d-block { display: block !important; }
  .lg\:d-flex  { display: flex !important; }
}

/* ── 2. Flexbox Helpers ──────────────────────────────────── */

.flex-row     { flex-direction: row !important; }
.flex-col     { flex-direction: column !important; }
.flex-wrap    { flex-wrap: wrap !important; }
.flex-nowrap  { flex-wrap: nowrap !important; }
.flex-1       { flex: 1 1 0% !important; }
.flex-auto    { flex: 1 1 auto !important; }
.flex-none    { flex: none !important; }
.flex-shrink-0{ flex-shrink: 0 !important; }
.flex-grow-1  { flex-grow: 1 !important; }

.items-start   { align-items: flex-start !important; }
.items-center  { align-items: center !important; }
.items-end     { align-items: flex-end !important; }
.items-stretch { align-items: stretch !important; }

.justify-start   { justify-content: flex-start !important; }
.justify-center  { justify-content: center !important; }
.justify-end     { justify-content: flex-end !important; }
.justify-between { justify-content: space-between !important; }
.justify-around  { justify-content: space-around !important; }

.self-start   { align-self: flex-start !important; }
.self-center  { align-self: center !important; }
.self-end     { align-self: flex-end !important; }
.self-stretch { align-self: stretch !important; }

/* Common combos */
.flex-center  { display: flex !important; align-items: center !important; justify-content: center !important; }
.flex-between { display: flex !important; align-items: center !important; justify-content: space-between !important; }
.flex-start   { display: flex !important; align-items: center !important; justify-content: flex-start !important; }

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

/* ── 3. Spacing — Margin ─────────────────────────────────── */

.m-0  { margin: 0 !important; }
.m-auto { margin: auto !important; }
.mx-auto { margin-inline: auto !important; }
.my-auto { margin-block: auto !important; }

.mt-0  { margin-top: 0 !important; }
.mt-1  { margin-top: var(--space-1) !important; }
.mt-2  { margin-top: var(--space-2) !important; }
.mt-3  { margin-top: var(--space-3) !important; }
.mt-4  { margin-top: var(--space-4) !important; }
.mt-5  { margin-top: var(--space-5) !important; }
.mt-6  { margin-top: var(--space-6) !important; }
.mt-8  { margin-top: var(--space-8) !important; }
.mt-10 { margin-top: var(--space-10) !important; }
.mt-12 { margin-top: var(--space-12) !important; }

.mb-0  { margin-bottom: 0 !important; }
.mb-1  { margin-bottom: var(--space-1) !important; }
.mb-2  { margin-bottom: var(--space-2) !important; }
.mb-3  { margin-bottom: var(--space-3) !important; }
.mb-4  { margin-bottom: var(--space-4) !important; }
.mb-5  { margin-bottom: var(--space-5) !important; }
.mb-6  { margin-bottom: var(--space-6) !important; }
.mb-8  { margin-bottom: var(--space-8) !important; }
.mb-10 { margin-bottom: var(--space-10) !important; }
.mb-12 { margin-bottom: var(--space-12) !important; }

.ml-auto { margin-left: auto !important; }
.mr-auto { margin-right: auto !important; }

/* ── 4. Spacing — Padding ────────────────────────────────── */

.p-0  { padding: 0 !important; }
.p-2  { padding: var(--space-2) !important; }
.p-4  { padding: var(--space-4) !important; }
.p-6  { padding: var(--space-6) !important; }
.p-8  { padding: var(--space-8) !important; }

.px-2 { padding-inline: var(--space-2) !important; }
.px-4 { padding-inline: var(--space-4) !important; }
.px-6 { padding-inline: var(--space-6) !important; }
.px-8 { padding-inline: var(--space-8) !important; }

.py-2 { padding-block: var(--space-2) !important; }
.py-4 { padding-block: var(--space-4) !important; }
.py-6 { padding-block: var(--space-6) !important; }
.py-8 { padding-block: var(--space-8) !important; }

/* ── 5. Typography ───────────────────────────────────────── */

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

.font-regular   { font-weight: var(--weight-regular) !important; }
.font-medium    { font-weight: var(--weight-medium) !important; }
.font-semibold  { font-weight: var(--weight-semibold) !important; }
.font-bold      { font-weight: var(--weight-bold) !important; }
.font-extrabold { font-weight: var(--weight-extrabold) !important; }

.font-display { font-family: var(--font-display) !important; }
.font-body    { font-family: var(--font-body) !important; }
.font-mono    { font-family: var(--font-mono) !important; }

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

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

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

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

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

.whitespace-nowrap { white-space: nowrap !important; }
.break-words { overflow-wrap: break-word !important; word-break: break-word !important; }

/* ── 6. Colors ───────────────────────────────────────────── */

.text-primary   { color: var(--color-primary) !important; }
.text-secondary { color: var(--color-text-secondary) !important; }
.text-muted     { color: var(--color-text-muted) !important; }
.text-inverse   { color: var(--color-text-inverse) !important; }
.text-success   { color: var(--color-success) !important; }
.text-warning   { color: var(--color-warning) !important; }
.text-error     { color: var(--color-error) !important; }
.text-accent    { color: var(--color-accent-dark) !important; }

.bg-surface   { background-color: var(--color-surface) !important; }
.bg-primary   { background-color: var(--color-primary) !important; }
.bg-primary-50{ background-color: var(--color-primary-50) !important; }
.bg-accent-50 { background-color: var(--color-accent-50) !important; }
.bg-muted     { background-color: var(--color-border-light) !important; }
.bg-success   { background-color: var(--color-success-bg) !important; }
.bg-error     { background-color: var(--color-error-bg) !important; }
.bg-warning   { background-color: var(--color-warning-bg) !important; }

/* ── 7. Borders ──────────────────────────────────────────── */

.border       { border: 1px solid var(--color-border) !important; }
.border-0     { border: none !important; }
.border-t     { border-top: 1px solid var(--color-border) !important; }
.border-b     { border-bottom: 1px solid var(--color-border) !important; }

.rounded-sm   { border-radius: var(--radius-sm) !important; }
.rounded-md   { border-radius: var(--radius-md) !important; }
.rounded-lg   { border-radius: var(--radius-lg) !important; }
.rounded-xl   { border-radius: var(--radius-xl) !important; }
.rounded-2xl  { border-radius: var(--radius-2xl) !important; }
.rounded-full { border-radius: var(--radius-full) !important; }

/* ── 8. Sizing ───────────────────────────────────────────── */

.w-full  { width: 100% !important; }
.w-auto  { width: auto !important; }
.h-full  { height: 100% !important; }
.h-auto  { height: auto !important; }
.min-w-0 { min-width: 0 !important; }
.max-w-content { max-width: var(--max-width-content) !important; }
.max-w-wide    { max-width: var(--max-width-wide) !important; }

/* ── 9. Position ─────────────────────────────────────────── */

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

.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; }

/* ── 10. Overflow ────────────────────────────────────────── */

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

/* ── 11. Shadows ─────────────────────────────────────────── */

.shadow-none { box-shadow: none !important; }
.shadow-sm   { box-shadow: var(--shadow-sm) !important; }
.shadow-md   { box-shadow: var(--shadow-md) !important; }
.shadow-lg   { box-shadow: var(--shadow-lg) !important; }

/* ── 12. Opacity ─────────────────────────────────────────── */

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

/* ── 13. Cursor ──────────────────────────────────────────── */

.cursor-pointer  { cursor: pointer !important; }
.cursor-default  { cursor: default !important; }
.cursor-not-allowed { cursor: not-allowed !important; }

/* ── 14. User Select ─────────────────────────────────────── */

.select-none { user-select: none !important; }
.select-text { user-select: text !important; }
.select-all  { user-select: all !important; }

/* ── 15. Pointer Events ──────────────────────────────────── */

.pointer-events-none { pointer-events: none !important; }
.pointer-events-auto { pointer-events: auto !important; }

/* ── 16. Accessibility ───────────────────────────────────── */

/* Visually hidden — screen reader only */
.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-width: 0 !important;
}

.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;
}

/* ── 17. Transition Helpers ──────────────────────────────── */

.transition-none { transition: none !important; }
.transition-fast { transition: all var(--transition-fast) !important; }
.transition-base { transition: all var(--transition-base) !important; }
.transition-slow { transition: all var(--transition-slow) !important; }

/* ── 18. Animation ───────────────────────────────────────── */

.animate-spin {
  animation: spin 1s linear infinite;
}

.animate-pulse {
  animation: pulse 2s ease-in-out infinite;
}

.animate-fade-in {
  animation: fade-in var(--transition-slow) ease forwards;
}

.animate-slide-up {
  animation: slide-up var(--transition-slow) ease forwards;
}

@keyframes spin {
  to { transform: rotate(360deg); }
}

@keyframes pulse {
  0%, 100% { opacity: 1; }
  50% { opacity: 0.5; }
}

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

@keyframes slide-up {
  from { opacity: 0; transform: translateY(12px); }
  to   { opacity: 1; transform: translateY(0); }
}

/* ── 19. Number Display Helpers ──────────────────────────── */

/* Tabular nums for aligned money columns */
.num {
  font-family: var(--font-mono);
  font-variant-numeric: tabular-nums;
  font-feature-settings: "tnum";
}

.num--positive { color: var(--color-success); }
.num--negative { color: var(--color-error); }
.num--neutral  { color: var(--color-text-muted); }

/* ── 20. Aspect Ratios ───────────────────────────────────── */

.aspect-square { aspect-ratio: 1 / 1; }
.aspect-video  { aspect-ratio: 16 / 9; }
.aspect-4-3    { aspect-ratio: 4 / 3; }