/**
 * American Council Design System - Theme & Utility Classes
 * 
 * This file provides a comprehensive set of utility classes for:
 * - Colors (text, background, border)
 * - Spacing (margin, padding, gap)
 * - Typography (font-size, font-weight, line-height)
 * - Layout (display, positioning, sizing)
 * - Responsive modifiers (sm:, md:, lg:, xl:)
 * 
 * Organized with CSS cascade layers for proper specificity management.
 */

@layer utilities {
  /* ===== COLOR UTILITIES ===== */

  /* Gray Scale - Text Colors */
  .text-gray-950 { color: #111111; }
  .text-gray-900 { color: #1f1f1f; }
  .text-gray-800 { color: #333333; }
  .text-gray-700 { color: #4d4d4d; }
  .text-gray-600 { color: #666666; }
  .text-gray-500 { color: #808080; }
  .text-gray-400 { color: #a6a6a6; }
  .text-gray-300 { color: #cfcfcf; }
  .text-gray-200 { color: #e5e5e5; }
  .text-gray-100 { color: #f3f3f3; }
  .text-gray-050 { color: #fafafa; }
  .text-white { color: #ffffff; }

  /* Semantic Text Colors */
  .text-current { color: var(--color-text); }
  .text-muted { color: var(--color-text-muted); }
  .text-heading { color: var(--color-heading); }
  .text-link { color: var(--color-link); }
  .text-link-hover { color: var(--color-link-hover); }

  /* Gray Scale - Background Colors */
  .bg-gray-950 { background-color: #111111; }
  .bg-gray-900 { background-color: #1f1f1f; }
  .bg-gray-800 { background-color: #333333; }
  .bg-gray-700 { background-color: #4d4d4d; }
  .bg-gray-600 { background-color: #666666; }
  .bg-gray-500 { background-color: #808080; }
  .bg-gray-400 { background-color: #a6a6a6; }
  .bg-gray-300 { background-color: #cfcfcf; }
  .bg-gray-200 { background-color: #e5e5e5; }
  .bg-gray-100 { background-color: #f3f3f3; }
  .bg-gray-050 { background-color: #fafafa; }
  .bg-white { background-color: #ffffff; }

  /* Semantic Background Colors */
  .bg-surface { background-color: var(--color-surface); }
  .bg-surface-subtle { background-color: var(--color-surface-subtle); }
  .bg-surface-strong { background-color: var(--color-surface-strong); }

  /* Gray Scale - Border Colors */
  .border-gray-950 { border-color: #111111; }
  .border-gray-900 { border-color: #1f1f1f; }
  .border-gray-800 { border-color: #333333; }
  .border-gray-700 { border-color: #4d4d4d; }
  .border-gray-600 { border-color: #666666; }
  .border-gray-500 { border-color: #808080; }
  .border-gray-400 { border-color: #a6a6a6; }
  .border-gray-300 { border-color: #cfcfcf; }
  .border-gray-200 { border-color: #e5e5e5; }
  .border-gray-100 { border-color: #f3f3f3; }
  .border-gray-050 { border-color: #fafafa; }
  .border-white { border-color: #ffffff; }

  /* Semantic Border Color */
  .border-current { border-color: var(--color-border); }

  /* ===== SPACING UTILITIES ===== */

  /* Margin - All sides */
  .m-2xs { margin: 0.35rem; }
  .m-xs { margin: 0.5rem; }
  .m-sm { margin: 0.75rem; }
  .m-md { margin: 1rem; }
  .m-lg { margin: 1.5rem; }
  .m-xl { margin: 2rem; }
  .m-2xl { margin: 3rem; }
  .m-3xl { margin: 4.5rem; }

  /* Margin - Top */
  .mt-2xs { margin-top: 0.35rem; }
  .mt-xs { margin-top: 0.5rem; }
  .mt-sm { margin-top: 0.75rem; }
  .mt-md { margin-top: 1rem; }
  .mt-lg { margin-top: 1.5rem; }
  .mt-xl { margin-top: 2rem; }
  .mt-2xl { margin-top: 3rem; }
  .mt-3xl { margin-top: 4.5rem; }

  /* Margin - Bottom */
  .mb-2xs { margin-bottom: 0.35rem; }
  .mb-xs { margin-bottom: 0.5rem; }
  .mb-sm { margin-bottom: 0.75rem; }
  .mb-md { margin-bottom: 1rem; }
  .mb-lg { margin-bottom: 1.5rem; }
  .mb-xl { margin-bottom: 2rem; }
  .mb-2xl { margin-bottom: 3rem; }
  .mb-3xl { margin-bottom: 4.5rem; }

  /* Margin - Left/Right (inline) */
  .mx-2xs { margin-left: 0.35rem; margin-right: 0.35rem; }
  .mx-xs { margin-left: 0.5rem; margin-right: 0.5rem; }
  .mx-sm { margin-left: 0.75rem; margin-right: 0.75rem; }
  .mx-md { margin-left: 1rem; margin-right: 1rem; }
  .mx-lg { margin-left: 1.5rem; margin-right: 1.5rem; }
  .mx-xl { margin-left: 2rem; margin-right: 2rem; }
  .mx-2xl { margin-left: 3rem; margin-right: 3rem; }

  /* Padding - All sides */
  .p-2xs { padding: 0.35rem; }
  .p-xs { padding: 0.5rem; }
  .p-sm { padding: 0.75rem; }
  .p-md { padding: 1rem; }
  .p-lg { padding: 1.5rem; }
  .p-xl { padding: 2rem; }
  .p-2xl { padding: 3rem; }
  .p-3xl { padding: 4.5rem; }

  /* Padding - Top */
  .pt-2xs { padding-top: 0.35rem; }
  .pt-xs { padding-top: 0.5rem; }
  .pt-sm { padding-top: 0.75rem; }
  .pt-md { padding-top: 1rem; }
  .pt-lg { padding-top: 1.5rem; }
  .pt-xl { padding-top: 2rem; }
  .pt-2xl { padding-top: 3rem; }
  .pt-3xl { padding-top: 4.5rem; }

  /* Padding - Bottom */
  .pb-2xs { padding-bottom: 0.35rem; }
  .pb-xs { padding-bottom: 0.5rem; }
  .pb-sm { padding-bottom: 0.75rem; }
  .pb-md { padding-bottom: 1rem; }
  .pb-lg { padding-bottom: 1.5rem; }
  .pb-xl { padding-bottom: 2rem; }
  .pb-2xl { padding-bottom: 3rem; }
  .pb-3xl { padding-bottom: 4.5rem; }

  /* Padding - Left/Right (inline) */
  .px-2xs { padding-left: 0.35rem; padding-right: 0.35rem; }
  .px-xs { padding-left: 0.5rem; padding-right: 0.5rem; }
  .px-sm { padding-left: 0.75rem; padding-right: 0.75rem; }
  .px-md { padding-left: 1rem; padding-right: 1rem; }
  .px-lg { padding-left: 1.5rem; padding-right: 1.5rem; }
  .px-xl { padding-left: 2rem; padding-right: 2rem; }
  .px-2xl { padding-left: 3rem; padding-right: 3rem; }

  /* Gap */
  .gap-2xs { gap: 0.35rem; }
  .gap-xs { gap: 0.5rem; }
  .gap-sm { gap: 0.75rem; }
  .gap-md { gap: 1rem; }
  .gap-lg { gap: 1.5rem; }
  .gap-xl { gap: 2rem; }
  .gap-2xl { gap: 3rem; }
  .gap-3xl { gap: 4.5rem; }

  /* ===== TYPOGRAPHY UTILITIES ===== */

  /* Font Family */
  .font-body { font-family: var(--font-body); }
  .font-heading { font-family: var(--font-heading); }

  /* Font Size - Text */
  .text-xs { font-size: var(--text-xs); }
  .text-sm { font-size: var(--text-sm); }
  .text-base { font-size: var(--text-md); }
  .text-lg { font-size: var(--text-lg); }
  .text-xl { font-size: var(--text-xl); }

  /* Font Size - Headings */
  .text-display { font-size: var(--heading-display); }
  .text-h1 { font-size: var(--heading-1); }
  .text-h2 { font-size: var(--heading-2); }
  .text-h3 { font-size: var(--heading-3); }
  .text-h4 { font-size: var(--heading-4); }

  /* Font Weight */
  .font-light { font-weight: 300; }
  .font-normal { font-weight: 400; }
  .font-semibold { font-weight: 600; }
  .font-bold { font-weight: 800; }
  .font-900 { font-weight: 900; }

  /* Line Height */
  .leading-tight { line-height: 1.12; }
  .leading-normal { line-height: 1.65; }

  /* Letter Spacing */
  .tracking-tight { letter-spacing: -0.055em; }
  .tracking-normal { letter-spacing: -0.04em; }
  .tracking-wide { letter-spacing: 0.08em; }
  .tracking-wider { letter-spacing: 0.14em; }

  /* Text Transform */
  .uppercase { text-transform: uppercase; }
  .lowercase { text-transform: lowercase; }
  .capitalize { text-transform: capitalize; }

  /* Text Align */
  .text-left { text-align: left; }
  .text-center { text-align: center; }
  .text-right { text-align: right; }
  .text-justify { text-align: justify; }

  /* ===== SIZING UTILITIES ===== */

  /* Width */
  .w-full { width: 100%; }
  .w-max { width: max-content; }
  .w-min { width: min-content; }
  .w-screen { width: 100vw; }
  .w-container { width: min(calc(100% - 2rem), var(--container)); }
  .w-container-narrow { width: min(calc(100% - 2rem), var(--container-narrow)); }

  /* Max Width */
  .max-w-xs { max-width: 20rem; }
  .max-w-sm { max-width: 24rem; }
  .max-w-md { max-width: 28rem; }
  .max-w-lg { max-width: 32rem; }
  .max-w-xl { max-width: 36rem; }
  .max-w-2xl { max-width: 42rem; }
  .max-w-3xl { max-width: 48rem; }
  .max-w-4xl { max-width: 56rem; }
  .max-w-full { max-width: 100%; }
  .max-w-prose { max-width: 65ch; }

  /* Height */
  .h-full { height: 100%; }
  .h-screen { height: 100vh; }
  .h-auto { height: auto; }

  /* ===== DISPLAY & LAYOUT UTILITIES ===== */

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

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

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

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

  /* Position */
  .static { position: static; }
  .relative { position: relative; }
  .absolute { position: absolute; }
  .fixed { position: fixed; }
  .sticky { position: sticky; }

  /* Inset */
  .inset-0 { top: 0; right: 0; bottom: 0; left: 0; }
  .inset-auto { top: auto; right: auto; bottom: auto; left: auto; }

  /* ===== BORDER & RADIUS UTILITIES ===== */

  /* Border */
  .border { border: 1px solid var(--color-border); }
  .border-none { border: none; }
  .border-t { border-top: 1px solid var(--color-border); }
  .border-r { border-right: 1px solid var(--color-border); }
  .border-b { border-bottom: 1px solid var(--color-border); }
  .border-l { border-left: 1px solid var(--color-border); }

  /* Border Width */
  .border-2 { border-width: 2px; }
  .border-4 { border-width: 4px; }

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

  /* ===== SHADOW UTILITIES ===== */

  .shadow-none { box-shadow: none; }
  .shadow-soft { box-shadow: var(--shadow-soft); }
  .shadow-card { box-shadow: var(--shadow-card); }

  /* ===== OVERFLOW UTILITIES ===== */

  .overflow-hidden { overflow: hidden; }
  .overflow-visible { overflow: visible; }
  .overflow-auto { overflow: auto; }
  .overflow-x-hidden { overflow-x: hidden; }
  .overflow-y-hidden { overflow-y: hidden; }
  .overflow-x-auto { overflow-x: auto; }
  .overflow-y-auto { overflow-y: auto; }

  /* ===== OPACITY UTILITIES ===== */

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

  /* ===== TRANSITION UTILITIES ===== */

  .transition { transition-property: all; transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1); transition-duration: 150ms; }
  .duration-150 { transition-duration: 150ms; }
  .duration-300 { transition-duration: 300ms; }

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

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

  /* ===== RESPONSIVE UTILITIES (Mobile-First) ===== */

  /* Small screens (480px+) */
  @media (min-width: 480px) {
    .sm\:block { display: block; }
    .sm\:flex { display: flex; }
    .sm\:grid { display: grid; }
    .sm\:hidden { display: none; }

    .sm\:text-sm { font-size: var(--text-sm); }
    .sm\:text-base { font-size: var(--text-md); }
    .sm\:text-lg { font-size: var(--text-lg); }
    .sm\:text-xl { font-size: var(--text-xl); }

    .sm\:p-md { padding: 1rem; }
    .sm\:p-lg { padding: 1.5rem; }
    .sm\:gap-lg { gap: 1.5rem; }
  }

  /* Medium screens (768px+) */
  @media (min-width: 768px) {
    .md\:block { display: block; }
    .md\:flex { display: flex; }
    .md\:grid { display: grid; }
    .md\:hidden { display: none; }
    .md\:inline-block { display: inline-block; }

    .md\:flex-row { flex-direction: row; }
    .md\:flex-col { flex-direction: column; }

    .md\:text-base { font-size: var(--text-md); }
    .md\:text-lg { font-size: var(--text-lg); }
    .md\:text-xl { font-size: var(--text-xl); }
    .md\:text-h3 { font-size: var(--heading-3); }
    .md\:text-h2 { font-size: var(--heading-2); }

    .md\:p-lg { padding: 1.5rem; }
    .md\:p-xl { padding: 2rem; }
    .md\:gap-xl { gap: 2rem; }

    .md\:grid-cols-2 { grid-template-columns: repeat(2, minmax(0, 1fr)); }
  }

  /* Large screens (1024px+) */
  @media (min-width: 1024px) {
    .lg\:block { display: block; }
    .lg\:flex { display: flex; }
    .lg\:grid { display: grid; }
    .lg\:hidden { display: none; }

    .lg\:flex-row { flex-direction: row; }
    .lg\:items-center { align-items: center; }

    .lg\:text-lg { font-size: var(--text-lg); }
    .lg\:text-xl { font-size: var(--text-xl); }
    .lg\:text-h2 { font-size: var(--heading-2); }
    .lg\:text-h1 { font-size: var(--heading-1); }

    .lg\:p-xl { padding: 2rem; }
    .lg\:p-2xl { padding: 3rem; }
    .lg\:gap-2xl { gap: 3rem; }

    .lg\:grid-cols-3 { grid-template-columns: repeat(3, minmax(0, 1fr)); }
  }

  /* Extra Large screens (1280px+) */
  @media (min-width: 1280px) {
    .xl\:block { display: block; }
    .xl\:flex { display: flex; }
    .xl\:hidden { display: none; }

    .xl\:text-xl { font-size: var(--text-xl); }
    .xl\:text-h1 { font-size: var(--heading-1); }

    .xl\:p-2xl { padding: 3rem; }
    .xl\:p-3xl { padding: 4.5rem; }
    .xl\:gap-3xl { gap: 4.5rem; }

    .xl\:grid-cols-4 { grid-template-columns: repeat(4, minmax(0, 1fr)); }
  }

  /* ===== UTILITY MODIFIERS ===== */

  /* Hover States */
  .hover\:opacity-75:hover { opacity: 0.75; }
  .hover\:bg-gray-100:hover { background-color: #f3f3f3; }
  .hover\:text-gray-600:hover { color: #666666; }

  /* Focus States */
  .focus\:outline:focus { outline: 3px solid var(--gray-950); outline-offset: 4px; }

  /* ===== COMPOSITION UTILITIES ===== */

  /* Container Queries */
  .container-query { container-type: inline-size; }

  /* Flow (vertical rhythm) */
  .flow > * + * { margin-top: var(--flow-space, var(--space-md)); }

  /* Cluster (flexible wrapping group) */
  .cluster { display: flex; flex-wrap: wrap; align-items: center; gap: var(--cluster-gap, var(--space-md)); }
  .cluster-between { justify-content: space-between; }
  .cluster-center { justify-content: center; }

  /* Stack (vertical list with consistent gap) */
  .stack-lg { display: grid; gap: var(--space-2xl); }
  .stack-xl { display: grid; gap: var(--space-3xl); }

  /* Line clamp */
  .line-clamp-1 { display: -webkit-box; -webkit-line-clamp: 1; -webkit-box-orient: vertical; overflow: hidden; }
  .line-clamp-2 { display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical; overflow: hidden; }
  .line-clamp-3 { display: -webkit-box; -webkit-line-clamp: 3; -webkit-box-orient: vertical; overflow: hidden; }

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