/* ==================================================================
   Carvins Utilities — Phase 37 v2.2 Design System
   ==================================================================
   Utility helpers for the v2.2 Carvins redesign. Every selector below
   is scoped under the `.cv-v3` ancestor — utilities are namespaced so
   a bare `.cv-flex` on a legacy page does NOT inherit v3 spacing.
   Legacy v2.0 pages render unchanged (D-02, D-06).

   Tokens consumed from design-system.css (Phase 37 :root#2 block).
   Spacing scale used here matches the actual token range (1..6, 8).
   ================================================================== */


/* --- Display utilities --- */
.cv-v3 .cv-block { display: block; }
.cv-v3 .cv-inline-block { display: inline-block; }
.cv-v3 .cv-inline { display: inline; }
.cv-v3 .cv-flex { display: flex; }
.cv-v3 .cv-inline-flex { display: inline-flex; }
.cv-v3 .cv-grid { display: grid; }
.cv-v3 .cv-hidden { display: none; }


/* --- Flex direction --- */
.cv-v3 .cv-flex-row { flex-direction: row; }
.cv-v3 .cv-flex-col { flex-direction: column; }
.cv-v3 .cv-flex-wrap { flex-wrap: wrap; }
.cv-v3 .cv-flex-nowrap { flex-wrap: nowrap; }


/* --- Align items --- */
.cv-v3 .cv-items-start { align-items: flex-start; }
.cv-v3 .cv-items-center { align-items: center; }
.cv-v3 .cv-items-end { align-items: flex-end; }
.cv-v3 .cv-items-stretch { align-items: stretch; }


/* --- Justify content --- */
.cv-v3 .cv-justify-start { justify-content: flex-start; }
.cv-v3 .cv-justify-center { justify-content: center; }
.cv-v3 .cv-justify-between { justify-content: space-between; }
.cv-v3 .cv-justify-around { justify-content: space-around; }
.cv-v3 .cv-justify-end { justify-content: flex-end; }


/* --- Gap (matches --cc-space-* token scale: 1..6, 8) --- */
.cv-v3 .cv-gap-1 { gap: var(--cc-space-1); }
.cv-v3 .cv-gap-2 { gap: var(--cc-space-2); }
.cv-v3 .cv-gap-3 { gap: var(--cc-space-3); }
.cv-v3 .cv-gap-4 { gap: var(--cc-space-4); }
.cv-v3 .cv-gap-5 { gap: var(--cc-space-5); }
.cv-v3 .cv-gap-6 { gap: var(--cc-space-6); }
.cv-v3 .cv-gap-8 { gap: var(--cc-space-8); }


/* --- Margin top --- */
.cv-v3 .cv-mt-1 { margin-top: var(--cc-space-1); }
.cv-v3 .cv-mt-2 { margin-top: var(--cc-space-2); }
.cv-v3 .cv-mt-3 { margin-top: var(--cc-space-3); }
.cv-v3 .cv-mt-4 { margin-top: var(--cc-space-4); }
.cv-v3 .cv-mt-5 { margin-top: var(--cc-space-5); }
.cv-v3 .cv-mt-6 { margin-top: var(--cc-space-6); }
.cv-v3 .cv-mt-8 { margin-top: var(--cc-space-8); }


/* --- Margin bottom --- */
.cv-v3 .cv-mb-1 { margin-bottom: var(--cc-space-1); }
.cv-v3 .cv-mb-2 { margin-bottom: var(--cc-space-2); }
.cv-v3 .cv-mb-3 { margin-bottom: var(--cc-space-3); }
.cv-v3 .cv-mb-4 { margin-bottom: var(--cc-space-4); }
.cv-v3 .cv-mb-5 { margin-bottom: var(--cc-space-5); }
.cv-v3 .cv-mb-6 { margin-bottom: var(--cc-space-6); }
.cv-v3 .cv-mb-8 { margin-bottom: var(--cc-space-8); }


/* --- Margin horizontal auto --- */
.cv-v3 .cv-mx-auto { margin-left: auto; margin-right: auto; }


/* --- Padding (all sides) --- */
.cv-v3 .cv-p-1 { padding: var(--cc-space-1); }
.cv-v3 .cv-p-2 { padding: var(--cc-space-2); }
.cv-v3 .cv-p-3 { padding: var(--cc-space-3); }
.cv-v3 .cv-p-4 { padding: var(--cc-space-4); }
.cv-v3 .cv-p-5 { padding: var(--cc-space-5); }
.cv-v3 .cv-p-6 { padding: var(--cc-space-6); }
.cv-v3 .cv-p-8 { padding: var(--cc-space-8); }


/* --- Padding horizontal --- */
.cv-v3 .cv-px-1 { padding-left: var(--cc-space-1); padding-right: var(--cc-space-1); }
.cv-v3 .cv-px-2 { padding-left: var(--cc-space-2); padding-right: var(--cc-space-2); }
.cv-v3 .cv-px-3 { padding-left: var(--cc-space-3); padding-right: var(--cc-space-3); }
.cv-v3 .cv-px-4 { padding-left: var(--cc-space-4); padding-right: var(--cc-space-4); }
.cv-v3 .cv-px-5 { padding-left: var(--cc-space-5); padding-right: var(--cc-space-5); }
.cv-v3 .cv-px-6 { padding-left: var(--cc-space-6); padding-right: var(--cc-space-6); }
.cv-v3 .cv-px-8 { padding-left: var(--cc-space-8); padding-right: var(--cc-space-8); }


/* --- Padding vertical --- */
.cv-v3 .cv-py-1 { padding-top: var(--cc-space-1); padding-bottom: var(--cc-space-1); }
.cv-v3 .cv-py-2 { padding-top: var(--cc-space-2); padding-bottom: var(--cc-space-2); }
.cv-v3 .cv-py-3 { padding-top: var(--cc-space-3); padding-bottom: var(--cc-space-3); }
.cv-v3 .cv-py-4 { padding-top: var(--cc-space-4); padding-bottom: var(--cc-space-4); }
.cv-v3 .cv-py-5 { padding-top: var(--cc-space-5); padding-bottom: var(--cc-space-5); }
.cv-v3 .cv-py-6 { padding-top: var(--cc-space-6); padding-bottom: var(--cc-space-6); }
.cv-v3 .cv-py-8 { padding-top: var(--cc-space-8); padding-bottom: var(--cc-space-8); }


/* --- Text alignment --- */
.cv-v3 .cv-text-left { text-align: left; }
.cv-v3 .cv-text-center { text-align: center; }
.cv-v3 .cv-text-right { text-align: right; }


/* --- Visibility / accessibility --- */
.cv-v3 .cv-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;
}


/* --- Responsive helpers (>= 768px) --- */
@media (min-width: 768px) {
  .cv-v3 .cv-md-flex { display: flex; }
  .cv-v3 .cv-md-grid { display: grid; }
  .cv-v3 .cv-md-block { display: block; }
  .cv-v3 .cv-md-hidden { display: none; }
}


/* --- Reduced motion --- */
@media (prefers-reduced-motion: reduce) {
  .cv-v3 *,
  .cv-v3 *::before,
  .cv-v3 *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
    scroll-behavior: auto !important;
  }
}