/* ═══════════════════════════════════════════════════════════
   Utilities — مشاورمالی
   کلاس‌های کمکی برای استفاده سریع
   ═══════════════════════════════════════════════════════════ */

/* ═══════════════════════════════════════════════════════
   رنگ متن
   ═══════════════════════════════════════════════════════ */

.text-primary { color: var(--text-primary) !important; }
.text-secondary { color: var(--text-secondary) !important; }
.text-muted { color: var(--text-muted) !important; }
.text-disabled { color: var(--text-disabled) !important; }

.text-brand { color: var(--brand-primary) !important; }
.text-brand-dark { color: var(--brand-primary-dark) !important; }
.text-brand-light { color: var(--brand-primary-light) !important; }

.text-success { color: var(--color-success) !important; }
.text-warning { color: var(--color-warning) !important; }
.text-danger { color: var(--color-danger) !important; }
.text-info { color: var(--color-info) !important; }

.text-white { color: #FFFFFF !important; }
.text-black { color: #000000 !important; }

/* ═══════════════════════════════════════════════════════
   پس‌زمینه
   ═══════════════════════════════════════════════════════ */

.bg-page { background-color: var(--bg-page) !important; }
.bg-surface { background-color: var(--bg-surface) !important; }
.bg-elevated { background-color: var(--bg-elevated) !important; }
.bg-subtle { background-color: var(--bg-subtle) !important; }

.bg-brand { background-color: var(--brand-primary) !important; }
.bg-brand-dark { background-color: var(--brand-primary-dark) !important; }
.bg-brand-light { background-color: var(--brand-primary-light) !important; }

.bg-success { background-color: var(--color-success) !important; }
.bg-warning { background-color: var(--color-warning) !important; }
.bg-danger { background-color: var(--color-danger) !important; }
.bg-info { background-color: var(--color-info) !important; }

/* ═══════════════════════════════════════════════════════
   گرادیان‌ها
   ═══════════════════════════════════════════════════════ */

.bg-gradient-brand { background: var(--gradient-brand) !important; }
.bg-gradient-accent { background: var(--gradient-brand) !important; }
.bg-gradient-success { background: var(--gradient-success) !important; }
.bg-gradient-warning { background: var(--gradient-warning) !important; }
.bg-gradient-danger { background: var(--gradient-danger) !important; }
.bg-gradient-hero { background: var(--gradient-hero) !important; }
.bg-gradient-card { background: var(--gradient-card) !important; }

/* ═══════════════════════════════════════════════════════
   فاصله‌ها — Margin
   ═══════════════════════════════════════════════════════ */

.m-0 { margin: 0 !important; }
.m-1 { margin: var(--space-1) !important; }
.m-2 { margin: var(--space-2) !important; }
.m-3 { margin: var(--space-3) !important; }
.m-4 { margin: var(--space-4) !important; }
.m-6 { margin: var(--space-6) !important; }
.m-8 { margin: var(--space-8) !important; }
.m-auto { margin: 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-6 { margin-top: var(--space-6) !important; }
.mt-8 { margin-top: var(--space-8) !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-6 { margin-bottom: var(--space-6) !important; }
.mb-8 { margin-bottom: var(--space-8) !important; }

.mr-1 { margin-right: var(--space-1) !important; }
.mr-2 { margin-right: var(--space-2) !important; }
.mr-3 { margin-right: var(--space-3) !important; }
.mr-4 { margin-right: var(--space-4) !important; }

.ml-1 { margin-left: var(--space-1) !important; }
.ml-2 { margin-left: var(--space-2) !important; }
.ml-3 { margin-left: var(--space-3) !important; }
.ml-4 { margin-left: var(--space-4) !important; }

/* ═══════════════════════════════════════════════════════
   فاصله‌ها — Padding
   ═══════════════════════════════════════════════════════ */

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

.pt-2 { padding-top: var(--space-2) !important; }
.pt-3 { padding-top: var(--space-3) !important; }
.pt-4 { padding-top: var(--space-4) !important; }
.pt-6 { padding-top: var(--space-6) !important; }

.pb-2 { padding-bottom: var(--space-2) !important; }
.pb-3 { padding-bottom: var(--space-3) !important; }
.pb-4 { padding-bottom: var(--space-4) !important; }
.pb-6 { padding-bottom: var(--space-6) !important; }

.px-4 { padding-left: var(--space-4) !important; padding-right: var(--space-4) !important; }
.py-4 { padding-top: var(--space-4) !important; padding-bottom: var(--space-4) !important; }

/* ═══════════════════════════════════════════════════════
   Flex
   ═══════════════════════════════════════════════════════ */

.flex { display: flex !important; }
.inline-flex { display: inline-flex !important; }
.flex-col { flex-direction: column !important; }
.flex-row { flex-direction: row !important; }
.flex-wrap { flex-wrap: wrap !important; }
.flex-nowrap { flex-wrap: nowrap !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; }

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

.flex-1 { flex: 1 !important; }
.flex-auto { flex: auto !important; }
.flex-none { flex: none !important; }

/* ═══════════════════════════════════════════════════════
   Grid
   ═══════════════════════════════════════════════════════ */

.grid { display: grid !important; }
.grid-cols-1 { grid-template-columns: 1fr !important; }
.grid-cols-2 { grid-template-columns: repeat(2, 1fr) !important; }
.grid-cols-3 { grid-template-columns: repeat(3, 1fr) !important; }
.grid-cols-4 { grid-template-columns: repeat(4, 1fr) !important; }

@media (max-width: 768px) {
    .grid-cols-2,
    .grid-cols-3,
    .grid-cols-4 {
        grid-template-columns: 1fr !important;
    }
}

/* ═══════════════════════════════════════════════════════
   نمایش
   ═══════════════════════════════════════════════════════ */

.hidden { display: none !important; }
.block { display: block !important; }
.inline-block { display: inline-block !important; }
.inline { display: inline !important; }

/* ═══════════════════════════════════════════════════════
   متن — ترازبندی
   ═══════════════════════════════════════════════════════ */

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

/* ═══════════════════════════════════════════════════════
   متن — سایز
   ═══════════════════════════════════════════════════════ */

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

/* ═══════════════════════════════════════════════════════
   متن — وزن
   ═══════════════════════════════════════════════════════ */

.font-light { font-weight: var(--font-weight-light) !important; }
.font-normal { font-weight: var(--font-weight-normal) !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-black { font-weight: var(--font-weight-black) !important; }

/* ═══════════════════════════════════════════════════════
   Border Radius
   ═══════════════════════════════════════════════════════ */

.rounded-none { border-radius: 0 !important; }
.rounded-xs { border-radius: var(--radius-xs) !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-2xl { border-radius: var(--radius-2xl) !important; }
.rounded-full { border-radius: var(--radius-full) !important; }

/* ═══════════════════════════════════════════════════════
   Border
   ═══════════════════════════════════════════════════════ */

.border { border: 1px solid var(--border-default) !important; }
.border-0 { border: none !important; }
.border-brand { border: 1px solid var(--border-brand) !important; }
.border-success { border: 1px solid var(--border-success) !important; }
.border-warning { border: 1px solid var(--border-warning) !important; }
.border-danger { border: 1px solid var(--border-danger) !important; }

/* ═══════════════════════════════════════════════════════
   Shadow
   ═══════════════════════════════════════════════════════ */

.shadow-none { box-shadow: none !important; }
.shadow-xs { box-shadow: var(--shadow-xs) !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; }
.shadow-glow { box-shadow: var(--shadow-glow-brand) !important; }

/* ═══════════════════════════════════════════════════════
   Width & Height
   ═══════════════════════════════════════════════════════ */

.w-full { width: 100% !important; }
.w-auto { width: auto !important; }
.h-full { height: 100% !important; }
.h-auto { height: auto !important; }

.max-w-full { max-width: 100% !important; }
.max-w-sm { max-width: var(--container-sm) !important; }
.max-w-md { max-width: var(--container-md) !important; }
.max-w-lg { max-width: var(--container-lg) !important; }
.max-w-xl { max-width: var(--container-max) !important; }

/* ═══════════════════════════════════════════════════════
   Position
   ═══════════════════════════════════════════════════════ */

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

/* ═══════════════════════════════════════════════════════
   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; }

/* ═══════════════════════════════════════════════════════
   Cursor
   ═══════════════════════════════════════════════════════ */

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

/* ═══════════════════════════════════════════════════════
   Transition
   ═══════════════════════════════════════════════════════ */

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

/* ═══════════════════════════════════════════════════════
   Opacity
   ═══════════════════════════════════════════════════════ */

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


/* ═══════════════════════════════════════════════════════════
   ⭐ on-dark — متن روی پس‌زمینه تیره ثابت
   
   استفاده:
   <div class="on-dark" style="background: #0A192F;">
       <h1>متن خودکار روشن</h1>
       <p>متن خودکار روشن</p>
   </div>
   
   ⚠️ این کلاس فقط برای موارد خاصه (بنر، Mockup، بخش‌های تیره).
   برای Hero از .hero-card و برای CTA از .cta-card استفاده کن.
   ═══════════════════════════════════════════════════════════ */

.on-dark,
.on-dark h1,
.on-dark h2,
.on-dark h3,
.on-dark h4,
.on-dark h5,
.on-dark h6,
.on-dark p,
.on-dark span,
.on-dark li,
.on-dark label,
.on-dark strong,
.on-dark b,
.on-dark small,
.on-dark a,
.on-dark div {
    color: #F8FAFC !important;
}

.on-dark p,
.on-dark small,
.on-dark .text-muted,
.on-dark .text-secondary {
    color: #CBD5E1 !important;
}

.on-dark strong,
.on-dark b {
    color: #FFFFFF !important;
}

.on-dark a:hover {
    color: #22D3EE !important;
}

/* استثنا: badge و btn رنگ خودشون رو نگه دارن */
.on-dark .badge,
.on-dark .btn {
    /* رنگ‌های خودشون */
}